Files
Skald-Circle/agents
dguiducci a847dda88f feat(memory): dual-pool memory namespace, FTS search, and prompt injection
Add a virtual memory namespace backed by SQLite, surfaced through the
fs-tools, with private (per-user) and shared (system) stores.

Storage
- `memory_docs` owner table + external-content FTS5 index with sync triggers.
- `db/memory_docs.rs` accessor: get / upsert / list / search (bm25+snippet) / delete.

Routing (tools/fs)
- `classify_memory` splits paths on the raw first component; `..` clamps inside
  the store, never escaping to disk.
- read/write/list/edit/insert/replace/search_file route `user-memory/` to the
  owner pool and `shared-memory/` to the system pool (a singleton captured in
  `register_all`); every other path stays on disk. Each tool extracts a pure
  transform shared between its disk and memory paths.
- New `memory_search` tool over the FTS index (scope private/shared/all),
  with a sanitised FTS5 query. grep_files stays disk-only.

Approval
- `user-memory/*` allow (read+write); `shared-memory/*` reads allow,
  writes require approval so the agent can't silently push one person's data
  into shared memory. `memory_search` allowed via a path-less rule.
- migrate away the old `memory/*` and blanket `shared-memory/*` rows.

Prompt injection
- `MessageBuilder::load_inject_memory` reads `user-memory/` (owner pool) and
  `shared-memory/` (system pool) inject entries from SQLite; disk paths
  unchanged. The system pool is threaded ChatSessionManager -> handler ->
  MessageBuilder.
- main and project-coordinator inject `user-memory/index.md` +
  `shared-memory/index.md`; common/memory.md rewritten for the two stores.
2026-07-11 02:11:00 +01:00
..
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00
2026-07-10 15:02:09 +01:00

Agent icons — style guide

Each agent in the agents/ directory can have an icon/avatar declared in the "icon" field of its meta.json. The backend serves the file via GET /api/agents/{id}/icon.

Visual style

Icons were generated with xAI Grok Imagine in a concept art / character design style:

  • Style: illustrated, not photorealistic, not flat vector, not anime
  • Technique: bold brushstrokes, rich colours, depth, video game concept art quality (Overwatch / Arcane / Hades)
  • Format: portrait (vertical rectangle)
  • Background: medium-bright, not dark, no neon
  • Subject: a character / living being representing the agent's role, with contextual elements (tools, holograms, symbols)
  • Palette: varies per agent, generally warm with one dominant colour

Base prompt template

Stylized character portrait of an AI agent called "{NAME}".
Concept art style with bold brushstrokes and rich colors.
{character description and surrounding visual elements}
{dominant colours}
Illustrated character design, not photorealistic, not flat vector, not anime.
Video game concept art quality.
Portrait format, vertical.
High detail, expressive.

Per-agent reference

Agent Subject Palette
Architect Visionary with floating architectural blueprints and geometry Blue & teal
Engineer Technician/cyborg with holographic tools, gears, circuits Amber & steel blue
Explorer Curious analyst with magnifying glass, floating code and data trails Deep blue & gold
Researcher Scientist with smart glasses, floating documents, magnifier Purple & teal
Main Assistant Central charismatic leader with luminous geometric shapes Purple & gold
TIC Mysterious figure with multiple eyes, radar, data nodes Dark purple & cyan
Tinker Clever craftsperson with multitool, gears, repair tools Orange & steel grey
Worker Practical person with futuristic toolbelt and mechanical elements Orange & steel grey
Blueprint Scholarly figure with floating scrolls and glowing quills writing words in mid-air, luminous documents orbiting Deep indigo & burnished gold
Tech Lead Confident strategist at a holographic kanban board, task cards floating mid-air, sub-agents visible in the background Warm amber & deep teal
Project Coordinator Central orchestrator with glowing connected nodes, satellite sub-agents orbiting, holographic project maps and branching task flows Teal & warm gold

Adding a new agent icon

  1. Generate the image using the prompt template above
  2. Save it as agents/{agent_id}/icon.png
  3. Add "icon": "icon.png" to the agent's meta.json
  4. No code changes needed — the backend serves whatever file path is declared in the manifest