@astragenie/astramemory-local 0.7.2

package/dist/mcp/server.js

@@ -0,0 +1,553 @@
+/**
+ * MCP server instance for astramemory-local.
+ *
+ * Exposes 15 tools over the Streamable HTTP transport (POST /mcp):
+ *   - search_memory      — hybrid FTS + vector search
+ *   - recall_memory      — top-K semantic recall (alias of search with k default 5)
+ *   - remember           — direct memory insert
+ *   - get_health         — daemon health probe
+ *   - why_memory         — provenance receipt (evidence, session, transcript ref)
+ *   - session_digest     — per-session "what I learned" summary (derived at read time)
+ *   - invalidate_memory  — lifecycle: mark a memory invalid (ADR-002 memory_events log)
+ *   - supersede_memory   — lifecycle: replace one memory with another
+ *   - promote_memory     — lifecycle: upward-only scope promotion (ADR-009)
+ *   - restore_memory     — lifecycle: un-archive a memory archived by the W4.4 TTL policy (FEAT-416)
+ *   - memory_history     — lifecycle: full event log for a memory (supersession chain)
+ *   - mark_memory_used   — ADR-010 explicit recall-used signal for a served memory
+ *   - erase_memory       — erasure v1 (ADR-006): hard-delete + tombstone
+ *   - list_consolidation_proposals / resolve_consolidation_proposal — stage-9 propose-only queue (ADR-004)
+ *
+ * No HTTP self-calls: all tools call the internal service layer directly.
+ * Auth is enforced at the Fastify route level via the existing preHandler.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { createHash } from 'node:crypto';
+import { MemoryRepo } from '../storage/memories.js';
+import { MemoryEventRepo, MemoryNotFoundError, MemoryConflictError, InvalidScopeTransitionError, } from '../storage/memory-events.js';
+import { SqliteVecStore } from '../vector/sqlite-vec.js';
+import { recordRecallServed, recordRecallUsed } from '../storage/usefulness.js';
+import { search } from '../search/search.js';
+import { clampScores } from '../server/lib/score-contract.js';
+import { defaultConfig } from '../config/config.js';
+import { childLogger } from '../log/logger.js';
+import { PKG_VERSION } from '../server/lib/wire-meta.js';
+import { redactIfEnabled } from '../redact/index.js';
+import { recordRedactionEvents } from '../storage/redaction-log.js';
+import { ProposalRepo, ProposalNotFoundError, ProposalAlreadyResolvedError, } from '../consolidate/proposals.js';
+/**
+ * Build and return a configured McpServer instance.
+ * Caller is responsible for connecting it to a transport.
+ */
+export function buildMcpServer(deps) {
+    const { db, embed } = deps;
+    const cfg = deps.config ?? defaultConfig();
+    const weights = cfg.search;
+    const server = new McpServer({ name: 'astramemory-local', version: PKG_VERSION }, { capabilities: { tools: {} } });
+    // ---- search_memory -------------------------------------------------------
+    server.registerTool('search_memory', {
+        description: 'Hybrid FTS + vector search over stored memories. Returns ranked hits.',
+        inputSchema: z.object({
+            query: z.string().min(1).describe('Search query text'),
+            limit: z.number().int().positive().max(100).default(10).describe('Max results'),
+            type: z
+                .array(z.enum(['decision', 'fact', 'lesson', 'command', 'todo', 'note', 'event']))
+                .optional()
+                .describe('Filter by memory type'),
+            repo: z.string().optional().describe('Filter by repo name'),
+            project: z.union([z.string(), z.array(z.string())]).optional().describe('Filter by project name(s) — string or list (OR)'),
+            agent: z.union([z.string(), z.array(z.string())]).optional().describe('Filter by provenance agent/agent_type — string or list (OR)'),
+            entity: z.string().optional().describe('Filter to memories linked to this entity (FEAT-402)'),
+            since: z
+                .number()
+                .optional()
+                .describe('Epoch-ms lower bound on created_at'),
+        }),
+    }, async (args) => {
+        const filters = {};
+        if (args.type)
+            filters.type = args.type;
+        if (args.repo)
+            filters.repo = args.repo;
+        if (args.project)
+            filters.project = args.project;
+        if (args.agent)
+            filters.agent = args.agent;
+        if (args.entity)
+            filters.entity = args.entity;
+        if (args.since !== undefined)
+            filters.since = args.since;
+        const hits = await search(args.query, filters, args.limit ?? 10, {
+            db,
+            embed,
+            weights,
+        });
+        // ADR-010: recall-usefulness capture — measure only, does not feed ranking (v1).
+        recordRecallServed(db, {
+            query: args.query,
+            atomIds: hits.map(h => h.id),
+            scores: hits.map(h => h.score),
+            surface: 'mcp',
+            mode: 'search',
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ hits: clampScores(hits, 'mcp search_memory') }),
+                },
+            ],
+        };
+    });
+    // ---- recall_memory -------------------------------------------------------
+    server.registerTool('recall_memory', {
+        description: 'Top-K semantic recall over stored memories. Alias of search_memory with k default 5.',
+        inputSchema: z.object({
+            query: z.string().min(1).describe('Query text for semantic recall'),
+            k: z.number().int().positive().max(100).default(5).describe('Number of results'),
+            type: z
+                .array(z.enum(['decision', 'fact', 'lesson', 'command', 'todo', 'note', 'event']))
+                .optional()
+                .describe('Filter by memory type'),
+            repo: z.string().optional().describe('Filter by repo name'),
+            project: z.union([z.string(), z.array(z.string())]).optional().describe('Filter by project name(s) — string or list (OR)'),
+            agent: z.union([z.string(), z.array(z.string())]).optional().describe('Filter by provenance agent/agent_type — string or list (OR)'),
+            entity: z.string().optional().describe('Filter to memories linked to this entity (FEAT-402)'),
+            since: z
+                .number()
+                .optional()
+                .describe('Epoch-ms lower bound on created_at'),
+        }),
+    }, async (args) => {
+        const filters = {};
+        if (args.type)
+            filters.type = args.type;
+        if (args.repo)
+            filters.repo = args.repo;
+        if (args.project)
+            filters.project = args.project;
+        if (args.agent)
+            filters.agent = args.agent;
+        if (args.entity)
+            filters.entity = args.entity;
+        if (args.since !== undefined)
+            filters.since = args.since;
+        const hits = await search(args.query, filters, args.k ?? 5, {
+            db,
+            embed,
+            weights,
+        });
+        // ADR-010: recall-usefulness capture — measure only, does not feed ranking (v1).
+        recordRecallServed(db, {
+            query: args.query,
+            atomIds: hits.map(h => h.id),
+            scores: hits.map(h => h.score),
+            surface: 'mcp',
+            mode: 'recall',
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ hits: clampScores(hits, 'mcp recall_memory') }),
+                },
+            ],
+        };
+    });
+    // ---- remember ------------------------------------------------------------
+    server.registerTool('remember', {
+        description: 'Directly insert a memory into the store, bypassing the distillation pipeline.',
+        inputSchema: z.object({
+            text: z.string().min(1).describe('Memory text to store'),
+            type: z
+                .enum(['decision', 'fact', 'lesson', 'command', 'todo', 'note', 'event'])
+                .describe('Memory type'),
+            metadata: z
+                .object({
+                repo: z.string().optional(),
+                project: z.string().optional(),
+                branch: z.string().optional(),
+                agent: z.string().optional(),
+                importance: z.number().min(0).max(1).optional(),
+                confidence: z.number().min(0).max(1).optional(),
+            })
+                .optional()
+                .describe('Optional metadata fields'),
+        }),
+    }, async (args) => {
+        const { type, metadata } = args;
+        // Stage-0 secret redaction (SEC-3/5, OQ-2) — same choke point as
+        // POST /remember, applied before persistence AND before the embed call.
+        const { text, events: redactionEvents } = redactIfEnabled(args.text, cfg);
+        recordRedactionEvents(db, redactionEvents, null);
+        const hash = createHash('sha256').update(text).digest('hex').slice(0, 32);
+        const repo = new MemoryRepo(db);
+        const events = new MemoryEventRepo(db);
+        const { id } = repo.insertWithCreateEvent({
+            type,
+            text,
+            normalized_text: text.toLowerCase(),
+            repo: metadata?.repo ?? null,
+            project: metadata?.project ?? null,
+            branch: metadata?.branch ?? null,
+            agent: metadata?.agent ?? null,
+            session_id: null,
+            hash,
+            source_hash: null,
+            importance: metadata?.importance ?? 0.5,
+            confidence: metadata?.confidence ?? 0.5,
+            embedding_provider: embed.name,
+            embedding_model: embed.model,
+            embedding_dim: embed.dim,
+        }, events);
+        // Embed + upsert into vec store (non-fatal on failure)
+        try {
+            const vecs = await embed.embed([text]);
+            const vecStore = new SqliteVecStore(db, embed.dim);
+            if (!vecs[0])
+                throw new Error('embed provider returned empty result');
+            await vecStore.upsert(id, vecs[0]);
+        }
+        catch (err) {
+            childLogger({}).warn({
+                error_message: err instanceof Error ? err.message : String(err),
+                id,
+            }, 'mcp remember: embed/vec upsert failed');
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ id, ok: true }),
+                },
+            ],
+        };
+    });
+    // ---- get_health ----------------------------------------------------------
+    server.registerTool('get_health', {
+        description: 'Returns daemon health status and version.',
+        inputSchema: z.object({}),
+    }, async () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ ok: true, version: PKG_VERSION }),
+                },
+            ],
+        };
+    });
+    // ---- why_memory ----------------------------------------------------------
+    server.registerTool('why_memory', {
+        description: 'Provenance receipt for a memory: evidence excerpt, source session, transcript ref. Answers: why do I remember this?',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id'),
+        }),
+    }, async (args) => {
+        const memRepo = new MemoryRepo(db);
+        const memory = memRepo.get(args.id);
+        if (!memory) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                isError: true,
+            };
+        }
+        let session = null;
+        if (memory.session_id) {
+            session = db
+                .prepare('SELECT id, repo, branch, agent, started_at FROM sessions WHERE id = ?')
+                .get(memory.session_id) ?? null;
+        }
+        const receipt = {
+            id: memory.id, type: memory.type, text: memory.text,
+            importance: memory.importance, confidence: memory.confidence,
+            evidence: memory.evidence, session,
+            transcript_ref: memory.source_hash, created_at: memory.created_at,
+            history: new MemoryEventRepo(db).listForAtom(args.id),
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(receipt) }] };
+    });
+    // ---- session_digest ------------------------------------------------------
+    server.registerTool('session_digest', {
+        description: 'What I learned this session: per-type counts + texts of memories formed. Defaults to the latest session.',
+        inputSchema: z.object({
+            session_id: z.string().optional().describe('Session id; defaults to most recent session'),
+        }),
+    }, async (args) => {
+        let sessionId = args.session_id;
+        if (!sessionId) {
+            const latest = db
+                .prepare('SELECT id FROM sessions ORDER BY started_at DESC LIMIT 1')
+                .get();
+            if (!latest) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'no sessions recorded' }) }],
+                    isError: true,
+                };
+            }
+            sessionId = latest.id;
+        }
+        const activeJob = db.prepare(`
+        SELECT id FROM jobs
+        WHERE kind = 'distill' AND state IN ('pending', 'running')
+          AND json_extract(payload_json, '$.session_id') = ?
+        LIMIT 1
+      `).get(sessionId);
+        const rows = db.prepare('SELECT id, type, text FROM memories WHERE session_id = ? ORDER BY created_at ASC').all(sessionId);
+        const counts = {};
+        for (const r of rows)
+            counts[r.type] = (counts[r.type] ?? 0) + 1;
+        const digest = {
+            session_id: sessionId,
+            status: activeJob ? 'pending' : 'ready',
+            counts,
+            memories: rows,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(digest) }] };
+    });
+    // ---- invalidate_memory ----------------------------------------------------
+    server.registerTool('invalidate_memory', {
+        description: 'Mark a memory invalid (soft delete). Appends an invalidate event to the memory_events log.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id to invalidate'),
+            reason: z.string().optional().describe('Optional reason for invalidation'),
+        }),
+    }, async (args) => {
+        const events = new MemoryEventRepo(db);
+        try {
+            events.invalidate(args.id, args.reason);
+            return { content: [{ type: 'text', text: JSON.stringify({ ok: true, id: args.id }) }] };
+        }
+        catch (err) {
+            if (err instanceof MemoryNotFoundError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            if (err instanceof MemoryConflictError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'already invalid', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    // ---- supersede_memory ------------------------------------------------------
+    server.registerTool('supersede_memory', {
+        description: 'Replace an old memory with a new one: invalidates old_id and links it to new_id via the memory_events log.',
+        inputSchema: z.object({
+            old_id: z.string().min(1).describe('Memory id being superseded'),
+            new_id: z.string().min(1).describe('Memory id that replaces old_id'),
+        }),
+    }, async (args) => {
+        const events = new MemoryEventRepo(db);
+        try {
+            events.supersede(args.old_id, args.new_id);
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify({ ok: true, old_id: args.old_id, new_id: args.new_id }) },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof MemoryNotFoundError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: err.atomId }) }],
+                    isError: true,
+                };
+            }
+            if (err instanceof MemoryConflictError) {
+                if (err.message.includes('must be valid to supersede')) {
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ error: 'invalid new_id', new_id: args.new_id }) }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'already invalid', id: args.old_id }) }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    // ---- promote_memory ---------------------------------------------------------
+    server.registerTool('promote_memory', {
+        description: 'Promote a memory\'s scope upward — personal -> team -> org (ADR-009). Downward/same-scope requests error.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id to promote'),
+            scope: z.enum(['team', 'org']).describe('Target scope; must be upward from the memory\'s current scope'),
+        }),
+    }, async (args) => {
+        const events = new MemoryEventRepo(db);
+        try {
+            events.promoteScope(args.id, args.scope);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ ok: true, id: args.id, scope: args.scope }) }],
+            };
+        }
+        catch (err) {
+            if (err instanceof MemoryNotFoundError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            if (err instanceof InvalidScopeTransitionError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: err.message, id: args.id }) }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    // ---- restore_memory ---------------------------------------------------------
+    server.registerTool('restore_memory', {
+        description: 'Un-archive a memory previously archived by the W4.4 TTL policy or a manual archive event. Appends a restore event to the memory_events log.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id to restore'),
+        }),
+    }, async (args) => {
+        const events = new MemoryEventRepo(db);
+        try {
+            events.restore(args.id);
+            return { content: [{ type: 'text', text: JSON.stringify({ ok: true, id: args.id }) }] };
+        }
+        catch (err) {
+            if (err instanceof MemoryNotFoundError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            if (err instanceof MemoryConflictError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not archived', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    // ---- memory_history -----------------------------------------------------
+    server.registerTool('memory_history', {
+        description: 'Full memory_events log for a memory, in append order — the supersession/invalidation/promotion chain.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id'),
+        }),
+    }, async (args) => {
+        const memRepo = new MemoryRepo(db);
+        const memory = memRepo.get(args.id);
+        if (!memory) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                isError: true,
+            };
+        }
+        const events = new MemoryEventRepo(db).listForAtom(args.id);
+        return { content: [{ type: 'text', text: JSON.stringify({ id: args.id, events }) }] };
+    });
+    // ---- mark_memory_used -----------------------------------------------------
+    server.registerTool('mark_memory_used', {
+        description: 'ADR-010 explicit recall-used signal: tell astramemory a previously-served memory actually ' +
+            'mattered in this turn. This is the explicit feedback channel — heuristic client-side ' +
+            'detection (content referenced in a later turn) is separate adapter work, out of scope here. ' +
+            'v1: feeds the recall-usefulness rate on doctor/dashboard/health only, does not affect ranking.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id that was useful'),
+            note: z.string().optional().describe('Optional free-text note (not persisted — reserved for future use)'),
+        }),
+    }, async (args) => {
+        const memRepo = new MemoryRepo(db);
+        const memory = memRepo.get(args.id);
+        if (!memory) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                isError: true,
+            };
+        }
+        recordRecallUsed(db, { atomId: args.id, surface: 'mcp', signal: 'explicit' });
+        return { content: [{ type: 'text', text: JSON.stringify({ ok: true, id: args.id }) }] };
+    });
+    // ---- erase_memory ---------------------------------------------------------
+    server.registerTool('erase_memory', {
+        description: 'Erasure v1 (ADR-006): PERMANENTLY hard-delete a memory (text unrecoverable) leaving only a ' +
+            'tombstone event. The tombstone blocks re-distillation from resurrecting it and ships to the ' +
+            'cloud ledger for team/org-scoped memories. Prefer invalidate_memory unless deletion is required.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Memory id to erase'),
+            reason: z.string().optional().describe('Why (recorded in the tombstone payload, counts only)'),
+        }),
+    }, async (args) => {
+        const eventsRepo = new MemoryEventRepo(db);
+        try {
+            eventsRepo.erase(args.id, args.reason);
+            return { content: [{ type: 'text', text: JSON.stringify({ ok: true, id: args.id }) }] };
+        }
+        catch (err) {
+            if (err instanceof MemoryNotFoundError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    // ---- list_consolidation_proposals ----------------------------------------
+    server.registerTool('list_consolidation_proposals', {
+        description: 'Pending (or resolved) consolidation proposals from the stage-9 pass (ADR-004): borderline ' +
+            'near-duplicate pairs awaiting an explicit merge/keep decision. Nothing is changed until a ' +
+            'proposal is resolved via resolve_consolidation_proposal.',
+        inputSchema: z.object({
+            status: z.enum(['pending', 'accepted', 'rejected']).default('pending').describe('Filter by status'),
+        }),
+    }, async (args) => {
+        const proposals = new ProposalRepo(db).list(args.status);
+        const memRepo = new MemoryRepo(db);
+        const enriched = proposals.map(p => ({
+            ...p,
+            winner_text: memRepo.get(p.winner_id)?.text ?? null,
+            loser_text: memRepo.get(p.loser_id)?.text ?? null,
+        }));
+        return { content: [{ type: 'text', text: JSON.stringify({ proposals: enriched }) }] };
+    });
+    // ---- resolve_consolidation_proposal ---------------------------------------
+    server.registerTool('resolve_consolidation_proposal', {
+        description: 'Accept or reject a pending consolidation proposal. Accept executes the non-destructive ' +
+            'merge-as-supersede (loser kept as superseded, winner gains derived_from lineage); reject ' +
+            'keeps both memories untouched.',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('Proposal id'),
+            action: z.enum(['accept', 'reject']).describe('Resolution'),
+        }),
+    }, async (args) => {
+        const repo = new ProposalRepo(db);
+        try {
+            const resolved = args.action === 'accept' ? repo.accept(args.id) : repo.reject(args.id);
+            return { content: [{ type: 'text', text: JSON.stringify({ ok: true, proposal: resolved }) }] };
+        }
+        catch (err) {
+            if (err instanceof ProposalNotFoundError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'not found', id: args.id }) }],
+                    isError: true,
+                };
+            }
+            if (err instanceof ProposalAlreadyResolvedError ||
+                err instanceof MemoryNotFoundError ||
+                err instanceof MemoryConflictError) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: err.message, id: args.id }) }],
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/memory-tool/adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Anthropic memory-tool backend adapter (ADR-007 Wave 4a, migration-map 4a).
+ *
+ * Anthropic's client-side memory tool (docs.claude.com memory-tool) expects
+ * the HARNESS to execute file-like commands (view/create/str_replace/insert/
+ * delete/rename) against a virtual `/memories` filesystem. This module maps
+ * those commands onto astramem memories so any Claude app using the memory
+ * tool can be backed by the daemon — see docs/memory-tool-adapter.md for the
+ * full command-mapping table and limitations.
+ *
+ * Virtual filesystem shape:
+ *   /memories                    -> directory listing of "<type>.md" files
+ *   /memories/<type>.md          -> markdown bullet list of current valid
+ *                                    memories of that type, one line per
+ *                                    memory: "- [<id>] <text>"
+ *   /memories/<type>.md/<id>     -> addresses a single memory (delete only)
+ *
+ * `<type>` must be one of the MemoryType enum values (decision, fact,
+ * lesson, command, todo, note, event). For create/insert, an unrecognized
+ * type slug in the path falls back to 'note' rather than erroring — the
+ * model may invent filenames the harness has never seen before.
+ *
+ * Design rulings (binding, see dispatch prompt for Wave 4a):
+ *   - create/insert: file_text/insert_text becomes ONE memory's text (no
+ *     bullet parsing — parsing markdown bullets back into memories is lossy
+ *     and was explicitly rejected). Redacted via redactIfEnabled, inserted
+ *     via MemoryRepo.insertWithCreateEvent (mirrors POST /remember), but
+ *     WITHOUT embedding metadata — embedding is not required synchronously,
+ *     the memory is FTS-searchable immediately and vec-indexed on reembed.
+ *   - str_replace: finds the single valid memory of that type whose text
+ *     contains old_str, then supersedes it (insert new + MemoryEventRepo
+ *     .supersede) rather than mutating the row in place — every memory
+ *     write goes through the ADR-002 event log.
+ *   - delete: whole-file (`/memories/<type>.md`) erases every current
+ *     memory of that type; per-id (`/memories/<type>.md/<id>`) erases just
+ *     that one. Both use MemoryEventRepo.erase (hard delete + tombstone
+ *     event, ADR-006 W5) — never a soft invalidate.
+ *   - rename: NOT supported v1 (a "rename" would mean changing an atom's
+ *     type, which isn't modeled) — always returns an error result.
+ *   - Unknown paths/commands never throw; they return { error }.
+ */
+import type { DB } from '../storage/db.js';
+import type { Config } from '../config/config.js';
+export type MemoryToolCommandName = 'view' | 'create' | 'str_replace' | 'insert' | 'delete' | 'rename';
+/**
+ * Loose input shape — mirrors the fields Anthropic's memory tool sends per
+ * command (see docs/memory-tool-adapter.md § command mapping). Fields not
+ * relevant to a given command are simply ignored.
+ */
+export interface MemoryToolCommand {
+    command: MemoryToolCommandName | string;
+    path: string;
+    view_range?: [number, number];
+    file_text?: string;
+    old_str?: string;
+    new_str?: string;
+    insert_line?: number;
+    insert_text?: string;
+    old_path?: string;
+    new_path?: string;
+}
+export type MemoryToolResult = {
+    content: string;
+} | {
+    error: string;
+};
+/**
+ * Maps one Anthropic memory-tool command onto astramem memories. Never
+ * throws — every failure path (bad path, unknown command, storage error)
+ * comes back as { error } so the caller can relay it straight into a
+ * tool_result without its own try/catch.
+ */
+export declare function handleMemoryToolCommand(db: DB, config: Config, cmd: MemoryToolCommand): MemoryToolResult;