@namzu/sdk 42.0.2 → 44.0.0

package/dist/tools/memory/read.js

@@ -1,12 +1,15 @@
 import { z } from 'zod';
-import { asMemoryId } from '../../utils/id.js';
+import { MEMORY_VERIFY_NOTICE, describeMemoryAge, memoryLinkNames, } from '../../store/memory/links.js';
 import { defineTool } from '../defineTool.js';
+import { allMemoryEntries, resolveMemoryReference } from './resolve.js';
 export function buildReadMemoryTool(store) {
     return defineTool({
         name: 'read_memory',
-        description: 'Read the full content of a specific memory by its ID.',
+        description: 'Read the full content of a specific memory by its ID or its name. For a text or Markdown memory the result ends with how old the memory is and resolves any [[name]] links it contains.',
         inputSchema: z.object({
-            id: z.string().describe('Opaque memory ID returned by a memory search or save'),
+            id: z
+                .string()
+                .describe('Opaque memory ID returned by a memory search or save, or the memory name from the index'),
         }),
         category: 'analysis',
         permissions: [],
@@ -14,9 +17,28 @@ export function buildReadMemoryTool(store) {
         destructive: false,
         concurrencySafe: true,
         async execute({ id }) {
-            // Validate model-authored input before using it as a store key.
-            const memoryId = asMemoryId(id);
-            const content = await store.get(memoryId);
+            // Validate model-authored input before using it as a store key. A name
+            // is resolved through the store's own listing, never used as a key.
+            const reference = await resolveMemoryReference(store, id);
+            if (!reference.found) {
+                return {
+                    success: false,
+                    output: `No memory is named ${id}.`,
+                    error: `Memory ${id} not found`,
+                };
+            }
+            const memoryId = reference.id;
+            let entries = reference.entries;
+            let entry;
+            let content;
+            if (store.getRecord) {
+                const record = await store.getRecord(memoryId);
+                entry = record?.entry;
+                content = record?.content;
+            }
+            else {
+                content = await store.get(memoryId);
+            }
             if (!content) {
                 return {
                     success: false,
@@ -24,13 +46,44 @@ export function buildReadMemoryTool(store) {
                     error: `Memory ${id} not found`,
                 };
             }
+            const notes = [];
+            if (entry) {
+                const age = describeMemoryAge(entry.updatedAt);
+                notes.push(`Last updated ${new Date(entry.updatedAt).toISOString().slice(0, 10)} (${age})${entry.type ? `; type ${entry.type}` : ''}${entry.status === 'archived' ? '; archived' : ''}.`);
+                if (age !== 'today')
+                    notes.push(MEMORY_VERIFY_NOTICE);
+            }
+            const links = memoryLinkNames(content.content);
+            const resolved = [];
+            if (links.length > 0) {
+                entries ??= await allMemoryEntries(store);
+                notes.push('Linked memories:');
+                for (const name of links) {
+                    const target = entries.find((candidate) => candidate.name === name);
+                    resolved.push({
+                        name,
+                        ...(target ? { id: target.id } : {}),
+                        ...(target ? { description: target.description ?? target.summary } : {}),
+                    });
+                    notes.push(target
+                        ? `- [[${name}]] → ${target.id}${target.status === 'archived' ? ' (archived)' : ''} — ${target.description ?? target.summary}`
+                        : `- [[${name}]] → no memory has this name`);
+                }
+            }
+            // A JSON body stays exactly the stored text, parseable as it was
+            // before these notes existed; its age and links are in `data`.
+            const annotate = notes.length > 0 && content.format !== 'json';
             return {
                 success: true,
-                output: content.content,
+                output: annotate ? `${content.content}\n\n---\n${notes.join('\n')}` : content.content,
                 data: {
                     id: content.id,
                     format: content.format,
                     metadata: content.metadata,
+                    ...(entry?.name !== undefined ? { name: entry.name } : {}),
+                    ...(entry?.type !== undefined ? { type: entry.type } : {}),
+                    ...(entry ? { updatedAt: entry.updatedAt } : {}),
+                    ...(resolved.length > 0 ? { links: resolved } : {}),
                 },
             };
         },

package/dist/tools/memory/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/tools/memory/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACrD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;SAC/E,CAAC;QACF,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE;YACnB,gEAAgE;YAChE,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;YAC/B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAEzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,UAAU,EAAE,aAAa;oBACjC,KAAK,EAAE,UAAU,EAAE,YAAY;iBAC/B,CAAA;YACF,CAAC;YAED,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,OAAO;gBACvB,IAAI,EAAE;oBACL,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC1B;aACD,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/tools/memory/read.ts"],"names":[],"mappings":"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"}

package/dist/tools/memory/resolve.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryId } from '../../types/ids/index.js';
+import type { MemoryIndexEntry, MemoryStore } from '../../types/memory/index.js';
+/** Every record, archived included, for resolving names. One store read. */
+export declare function allMemoryEntries(store: MemoryStore): Promise<readonly MemoryIndexEntry[]>;
+export type MemoryReference = {
+    readonly found: true;
+    readonly id: MemoryId;
+    /** The listing read to resolve a name, reused by a caller that needs it. */
+    readonly entries?: readonly MemoryIndexEntry[];
+} | {
+    readonly found: false;
+    readonly name: string;
+};
+/**
+ * What a model-authored `id` refers to: a UUID is taken as an id, a memory
+ * name — what the prompt's index shows — is looked up through the store's own
+ * listing, never used as a key. Anything else goes through `asMemoryId`, which
+ * refuses it.
+ */
+export declare function resolveMemoryReference(store: MemoryStore, reference: string): Promise<MemoryReference>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/tools/memory/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAGhF,4EAA4E;AAC5E,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAE/F;AAED,MAAM,MAAM,eAAe,GACxB;IACA,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAC7C,GACD;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

package/dist/tools/memory/resolve.js

@@ -0,0 +1,23 @@
+import { isMemoryName } from '../../store/memory/naming.js';
+import { asMemoryId, isEntityId } from '../../utils/id.js';
+/** Every record, archived included, for resolving names. One store read. */
+export async function allMemoryEntries(store) {
+    return (await store.list({})).entries;
+}
+/**
+ * What a model-authored `id` refers to: a UUID is taken as an id, a memory
+ * name — what the prompt's index shows — is looked up through the store's own
+ * listing, never used as a key. Anything else goes through `asMemoryId`, which
+ * refuses it.
+ */
+export async function resolveMemoryReference(store, reference) {
+    if (isEntityId(reference, 'memory'))
+        return { found: true, id: asMemoryId(reference) };
+    if (isMemoryName(reference)) {
+        const entries = await allMemoryEntries(store);
+        const named = entries.find((entry) => entry.name === reference);
+        return named ? { found: true, id: named.id, entries } : { found: false, name: reference };
+    }
+    return { found: true, id: asMemoryId(reference) };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/tools/memory/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/tools/memory/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE1D,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAkB;IACxD,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;AACtC,CAAC;AAWD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,KAAkB,EAClB,SAAiB;IAEjB,IAAI,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAA;IACtF,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;QAC/D,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IAC1F,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAA;AAClD,CAAC"}

package/dist/tools/memory/save.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/save.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAoCtE"}
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/save.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAI/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAqEtE"}

package/dist/tools/memory/save.js

@@ -1,37 +1,76 @@
 import { z } from 'zod';
+import { MemoryContentRejectedError, MemoryNameConflictError } from '../../store/memory/naming.js';
+import { AGENT_MEMORY_SOURCE } from '../../store/memory/origin.js';
 import { defineTool } from '../defineTool.js';
+import { memoryFieldsSchema } from './fields.js';
 export function buildSaveMemoryTool(store) {
     return defineTool({
         name: 'save_memory',
-        description: 'Save a new historical claim for future reference. Include the actual useful fact and its evidence in the summary and content. For corrections to an existing record use update_memory instead of creating contradictory duplicates.',
+        description: [
+            'Save a new memory for future sessions: something true now that a later session could not work out from the code, the git history or the files themselves. Do not save what those already say.',
+            'Choose a type: user (who the user is and how they like to work), feedback (a rule the user gave about how to work), project (a fact or decision about the work), reference (where to look for something).',
+            'For feedback and project memories, write the rule or fact first, then a line starting "Why:" and a line starting "How to apply:".',
+            'Link a related memory by writing [[its-name]] in the content.',
+            'If a memory on this already exists, use update_memory instead: a name another memory holds is refused.',
+        ].join(' '),
         inputSchema: z.object({
             title: z.string().min(1).describe('Short descriptive title'),
             summary: z.string().min(1).describe('Brief summary (1-2 sentences)'),
             content: z.string().min(1).describe('Full content to store'),
             tags: z.array(z.string()).optional().describe('Tags for categorization'),
+            ...memoryFieldsSchema,
         }),
         category: 'custom',
         permissions: [],
         readOnly: false,
         destructive: false,
         concurrencySafe: true,
-        async execute({ title, summary, content, tags }, context) {
-            const { entry } = await store.create({
-                title,
-                summary,
-                content,
-                tags,
-                metadata: { source: 'agent-memory', runId: context.runId },
-            });
-            return {
-                success: true,
-                output: `Memory saved: ${entry.id} — "${title}"`,
-                data: {
-                    id: entry.id,
-                    title: entry.title,
-                    tags: entry.tags,
-                },
-            };
+        async execute({ title, summary, content, tags, name, description, type }, context) {
+            try {
+                const { entry } = await store.create({
+                    title,
+                    summary,
+                    content,
+                    tags,
+                    ...(name !== undefined ? { name } : {}),
+                    ...(description !== undefined ? { description } : {}),
+                    ...(type !== undefined ? { type } : {}),
+                    metadata: {
+                        source: AGENT_MEMORY_SOURCE,
+                        sessionId: context.sessionId,
+                        turnId: context.turnId,
+                    },
+                });
+                return {
+                    success: true,
+                    output: `Memory saved: ${entry.id} — "${title}"${entry.name ? ` as ${entry.name}` : ''}`,
+                    data: {
+                        id: entry.id,
+                        title: entry.title,
+                        tags: entry.tags,
+                        ...(entry.name !== undefined ? { name: entry.name } : {}),
+                        ...(entry.type !== undefined ? { type: entry.type } : {}),
+                    },
+                };
+            }
+            catch (error) {
+                if (error instanceof MemoryContentRejectedError) {
+                    return {
+                        success: false,
+                        output: error.message,
+                        error: 'Memory content rejected',
+                        data: { reason: error.reason },
+                    };
+                }
+                if (!(error instanceof MemoryNameConflictError))
+                    throw error;
+                return {
+                    success: false,
+                    output: `A memory named "${error.memoryName}" already exists (${error.existingId}). Read it with read_memory and correct it with update_memory instead of saving a duplicate.`,
+                    error: 'Memory name already exists',
+                    data: { existingId: error.existingId, name: error.memoryName },
+                };
+            }
         },
     });
 }

package/dist/tools/memory/save.js.map

@@ -1 +1 @@
-{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/tools/memory/save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACrD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,qOAAqO;QACtO,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC5D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SACxE,CAAC;QACF,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO;YACvD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;gBACpC,KAAK;gBACL,OAAO;gBACP,OAAO;gBACP,IAAI;gBACJ,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;aAC1D,CAAC,CAAA;YAEF,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iBAAiB,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG;gBAChD,IAAI,EAAE;oBACL,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;iBAChB;aACD,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/tools/memory/save.ts"],"names":[],"mappings":"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"}

package/dist/tools/memory/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,WAAW,EAGX,WAAW,EACX,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA4D/D,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAExE;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAE7E"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,WAAW,EAGX,WAAW,EACX,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA+D/D,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAExE;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAE7E"}

package/dist/tools/memory/search.js

@@ -1,9 +1,10 @@
 import { z } from 'zod';
+import { describeMemoryAge } from '../../store/memory/links.js';
 import { defineTool } from '../defineTool.js';
 function defineSearchMemoryTool(search) {
     return defineTool({
         name: 'search_memory',
-        description: 'Search active stored memories by relevant words or tags. The built-in store ranks matches in titles, summaries and full content. Returns titles and summaries; use read_memory for evidence. Set status to archived to inspect obsolete records.',
+        description: 'Search active stored memories by relevant words or tags. The built-in store ranks matches in names, titles, descriptions, summaries and full content. Returns the title, name, type, age and description of each match; use read_memory for evidence. Set status to archived to inspect obsolete records.',
         inputSchema: z.object({
             query: z.string().optional().describe('Relevant words or identifiers to search'),
             tags: z.array(z.string()).optional().describe('Filter by tags (all must match)'),
@@ -30,7 +31,13 @@ function defineSearchMemoryTool(search) {
                     data: { entries: [], totalCount: 0 },
                 };
             }
-            const lines = result.entries.map((e, i) => `${i + 1}. [${e.id}] ${e.title} — ${e.summary}${e.tags.length > 0 ? ` [${e.tags.join(', ')}]` : ''}`);
+            const now = Date.now();
+            const lines = result.entries.map((e, i) => {
+                const kind = [e.name, e.type, describeMemoryAge(e.updatedAt, now)]
+                    .filter(Boolean)
+                    .join(', ');
+                return `${i + 1}. [${e.id}] ${e.title} (${kind}) — ${e.description ?? e.summary}${e.tags.length > 0 ? ` [${e.tags.join(', ')}]` : ''}`;
+            });
             const output = result.totalCount > result.entries.length
                 ? `Found ${result.totalCount} memories (showing ${result.entries.length}):\n${lines.join('\n')}`
                 : `Found ${result.totalCount} memories:\n${lines.join('\n')}`;

package/dist/tools/memory/search.js.map

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

package/dist/tools/memory/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/update.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAI/D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CA2CxE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK/D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CA6ExE"}

package/dist/tools/memory/update.js

@@ -1,17 +1,22 @@
 import { z } from 'zod';
-import { asMemoryId } from '../../utils/id.js';
+import { MemoryContentRejectedError, MemoryNameConflictError } from '../../store/memory/naming.js';
 import { defineTool } from '../defineTool.js';
+import { memoryFieldsSchema } from './fields.js';
+import { resolveMemoryReference } from './resolve.js';
 export function buildUpdateMemoryTool(store) {
     return defineTool({
         name: 'update_memory',
-        description: 'Correct an existing memory in place, or archive an obsolete claim so it is no longer recalled. Use the ID from search_memory; current evidence should determine corrections.',
+        description: 'Correct an existing memory in place, or archive an obsolete claim so it is no longer recalled. Prefer this to saving a second memory about the same thing. Identify it by the ID from search_memory or by its name from the memory index; current evidence should determine corrections.',
         inputSchema: z.object({
-            id: z.string().describe('Memory ID to correct or archive'),
+            id: z
+                .string()
+                .describe('Memory ID, or the memory name from the index, to correct or archive'),
             title: z.string().min(1).optional(),
             summary: z.string().min(1).optional(),
             content: z.string().min(1).optional(),
             tags: z.array(z.string()).optional(),
             status: z.enum(['active', 'archived']).optional(),
+            ...memoryFieldsSchema,
         }),
         category: 'custom',
         permissions: [],
@@ -26,10 +31,39 @@ export function buildUpdateMemoryTool(store) {
                     error: 'No memory update supplied',
                 };
             }
-            const memoryId = asMemoryId(id);
+            const reference = await resolveMemoryReference(store, id);
+            if (!reference.found) {
+                return {
+                    success: false,
+                    output: `No memory is named ${id}. Find it with search_memory, or save it with save_memory if it does not exist.`,
+                    error: 'Memory not found',
+                };
+            }
+            const memoryId = reference.id;
             // Patch only requested fields in one store operation. A read/merge of
             // provenance here would overwrite metadata from a concurrent writer.
-            const entry = await store.update(memoryId, updates);
+            let entry;
+            try {
+                entry = await store.update(memoryId, updates);
+            }
+            catch (error) {
+                if (error instanceof MemoryContentRejectedError) {
+                    return {
+                        success: false,
+                        output: error.message,
+                        error: 'Memory content rejected',
+                        data: { reason: error.reason },
+                    };
+                }
+                if (!(error instanceof MemoryNameConflictError))
+                    throw error;
+                return {
+                    success: false,
+                    output: `Another memory is already named "${error.memoryName}" (${error.existingId}). Choose a different name, or update that memory instead.`,
+                    error: 'Memory name already exists',
+                    data: { existingId: error.existingId, name: error.memoryName },
+                };
+            }
             if (!entry)
                 return {
                     success: false,
@@ -38,8 +72,12 @@ export function buildUpdateMemoryTool(store) {
                 };
             return {
                 success: true,
-                output: `Memory updated: ${id} — ${entry.title} (${entry.status}).`,
-                data: { id, status: entry.status },
+                output: `Memory updated: ${memoryId}${entry.name ? ` (${entry.name})` : ''} — ${entry.title} (${entry.status}).`,
+                data: {
+                    id: memoryId,
+                    status: entry.status,
+                    ...(entry.name ? { name: entry.name } : {}),
+                },
             };
         },
     });

package/dist/tools/memory/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/memory/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACvD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,eAAe;QACrB,WAAW,EACV,8KAA8K;QAC/K,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACrC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjD,CAAC;QACF,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE;YAC/B,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;gBAClE,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,2CAA2C;oBACnD,KAAK,EAAE,2BAA2B;iBAClC,CAAA;YACF,CAAC;YACD,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;YAC/B,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACnD,IAAI,CAAC,KAAK;gBACT,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,UAAU,EAAE,oBAAoB;oBACxC,KAAK,EAAE,kBAAkB;iBACzB,CAAA;YACF,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,mBAAmB,EAAE,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,IAAI;gBACnE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;aAClC,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/memory/update.ts"],"names":[],"mappings":"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"}

package/dist/tools/paths.d.ts

@@ -15,16 +15,42 @@
  * exact about the boundary.
  */
 export declare function resolveWithin(root: string, candidate: string | undefined): string;
-/** True when `candidate` resolves inside `root`. */
+/**
+ * What a refusal says after naming the path: where the tools DO reach, and
+ * how that is widened.
+ *
+ * It used to end at "Tools may only reach inside X", which reads as a wall.
+ * It is not one: a host can add a directory to the session, and a host that
+ * reviews such paths (`QueryParams.outsideRootAccess: 'review'`) turns them
+ * into an approval request before the tool ever runs, so a model that meets
+ * this text is in a turn where that did not happen. Told only "may only", a
+ * model either rewords the path forever or tells the user the file cannot be
+ * read at all; told the route, it asks for the directory.
+ */
+export declare const OUTSIDE_ROOTS_GUIDANCE: (reach: string) => string;
 /**
  * The directories a tool may reach: the working directory first, then any
- * the host added for the session (`/add-dir`). Relative paths resolve
- * against the first; an absolute path is accepted inside any.
+ * the host added for the session (`/add-dir`), then any path a review
+ * approved for THIS call (`ToolContext.approvedPaths`). Relative paths
+ * resolve against the first; an absolute path is accepted inside any.
  */
 export declare function toolRoots(context: {
     readonly workingDirectory: string;
     readonly additionalDirectories?: readonly string[];
+    readonly approvedPaths?: readonly string[];
 }): readonly string[];
+/**
+ * The absolute path `candidate` names when it lies outside every root, or
+ * `undefined` when a tool would accept it as it stands.
+ *
+ * Decided with {@link resolveWithinAnyReal} — the resolver the file tools
+ * run — so the review and the execution cannot disagree about which side of
+ * the boundary a path is on, symlinks included. The returned path is the
+ * lexical one, which is what {@link toolRoots} is then handed: a link inside
+ * the working directory that points outside is approved under the name the
+ * reviewer saw.
+ */
+export declare function pathOutsideRoots(roots: readonly string[], candidate: string | undefined): Promise<string | undefined>;
 /** `resolveWithin` over several roots. See `toolRoots` for the order. */
 export declare function resolveWithinAny(roots: readonly string[], candidate: string | undefined): string;
 /** `resolveWithinReal` over several roots: the first that contains the path, links followed. */

package/dist/tools/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAejF;AAED,oDAAoD;AACpD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClD,GAAG,SAAS,MAAM,EAAE,CAEpB;AAWD,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAchG;AAED,gGAAgG;AAChG,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,MAAM,CAAC,CAqCjB"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAejF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAC6L,CAAA;AAEpP;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C,GAAG,SAAS,MAAM,EAAE,CAMpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAWD,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAchG;AAED,gGAAgG;AAChG,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,MAAM,CAAC,CA0BjB"}