@j0hanz/memory-mcp 1.1.0 → 1.2.0

package/dist/lib/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAwEA,wBAAgB,gBAAgB,IAAI,MAAM,CA+BzC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC"}

package/dist/lib/instructions.js

@@ -1,96 +1,10 @@
-import { getToolContracts } from './tool-contracts.js';
-const SHARED_CONSTRAINTS = [
-    'Idempotence: `store_memory` and `store_memories` return `created: false` if content+tags already exist.',
-    'Atomic Transactions: `store_memories` and `delete_memories` roll back entirely on unexpected errors.',
-    'Hash Changes: `update_memory` changes the hash when content or tags change. Relationships survive via CASCADE.',
-    'FTS Search Limits: Query terms matched individually (all-OR logic). Phrase operators and negation not supported.',
-    'Recall Limits: BFS traversal is bounded by env vars (RECALL_MAX_FRONTIER_SIZE, RECALL_MAX_EDGE_ROWS, RECALL_MAX_VISITED_NODES). Returns `aborted: true` with partial results when limits are hit.',
-];
-const ERROR_CODES = [
-    '| Code | Meaning |',
-    '| --- | --- |',
-    '| `E_NOT_FOUND` | Hash or relationship does not exist |',
-    '| `E_CONFLICT` | `update_memory` target content+tags already maps to an existing hash |',
-    '| `E_CANCELLED` | Request was cancelled |',
-    '| `E_UNKNOWN` | Unexpected internal error — retry once |',
-];
-const DATA_MODEL = `
-### Memory
-- \`hash\` — SHA-256 of \`(content + sorted tags)\`; deterministic; changes when content or tags change
-- \`content\` — Text; 1–100,000 chars
-- \`tags\` — Array; 1–100 tags; each 1–50 chars, no whitespace; minimum 1 required
-- \`memory_type\` — \`general\` | \`fact\` | \`plan\` | \`decision\` | \`reflection\` | \`lesson\` | \`error\` | \`gradient\` (default \`general\`)
-- \`importance\` — Integer 0–10 (default 0; 10 = critical)
-- \`created_at\`, \`updated_at\` — ISO 8601 timestamps
-
-### Relationship
-- Directed edge: \`from_hash -[relation_type]-> to_hash\`
-- \`relation_type\` — Free-form string, 1–50 chars, no whitespace
-- Suggested types: \`related_to\`, \`causes\`, \`depends_on\`, \`parent_of\`, \`child_of\`, \`supersedes\`, \`contradicts\`, \`supports\`, \`references\`
-- Both endpoints must exist before creating a relationship
-- Cascade-deleted when either endpoint memory is deleted
-- Cascade-updated when either endpoint hash changes (ON UPDATE CASCADE)
-`;
-const WORKFLOWS = `
-### Store and Link
-\`\`\`
-store_memories({ items: [...] })         → { items[].hash, succeeded, failed }
-create_relationship({ from_hash, to_hash, relation_type })  × N
-\`\`\`
-
-### Search and Read
-\`\`\`
-search_memories({ query, limit })        → { memories[], nextCursor }
-# or, for relationship navigation:
-recall({ query, depth: 1 })             → { memories[], graph[] }
-\`\`\`
-
-### Fill Context Window
-\`\`\`
-retrieve_context({ query, token_budget: 4000, strategy: 'relevance' })
-  → { memories[], estimated_tokens, truncated }
-\`\`\`
-
-### Update a Memory
-\`\`\`
-update_memory({ hash, content })         → { old_hash, new_hash }
-# Existing relationships auto-update to new_hash via CASCADE
-\`\`\`
-
-### Batch Delete
-\`\`\`
-delete_memories({ hashes: [...] })       → { items[].{ hash, deleted }, succeeded, failed }
-# deleted: false means hash not found — not an error
-\`\`\`
-`;
+import { buildServerInstructions } from '../resources/instructions.js';
 let cachedInstructions;
 export function loadInstructions() {
     if (cachedInstructions !== undefined) {
         return cachedInstructions;
     }
-    const contracts = getToolContracts();
-    const toolRows = contracts.map((c) => {
-        return `| \`${c.name}\` | ${c.description.split('.')[0] ?? ''} |`;
-    });
-    cachedInstructions = [
-        '# Memory MCP — Usage Guide',
-        '## Tool Routing',
-        '| Tool | Purpose |',
-        '| --- | --- |',
-        ...toolRows,
-        '',
-        '## Shared Constraints',
-        SHARED_CONSTRAINTS.map((c) => `- ${c}`).join('\n'),
-        '## Error Codes',
-        ERROR_CODES.join('\n'),
-        '## Data Model',
-        DATA_MODEL,
-        '## Common Workflows',
-        WORKFLOWS,
-        '## Resources',
-        '- `internal://instructions` — This document. Read for tool routing, error codes, and workflows.',
-        '- `memory://memories/{hash}` — Fetch a single memory by URI with hash auto-completion.',
-    ].join('\n\n');
+    cachedInstructions = buildServerInstructions();
     return cachedInstructions;
 }
 //# sourceMappingURL=instructions.js.map

package/dist/lib/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,kBAAkB,GAAG;IACzB,yGAAyG;IACzG,sGAAsG;IACtG,gHAAgH;IAChH,kHAAkH;IAClH,mMAAmM;CACpM,CAAC;AAEF,MAAM,WAAW,GAAG;IAClB,oBAAoB;IACpB,eAAe;IACf,yDAAyD;IACzD,yFAAyF;IACzF,2CAA2C;IAC3C,0DAA0D;CAC3D,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;CAgBlB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjB,CAAC;AAEF,IAAI,kBAAsC,CAAC;AAE3C,MAAM,UAAU,gBAAgB;IAC9B,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnC,OAAO,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,kBAAkB,GAAG;QACnB,4BAA4B;QAC5B,iBAAiB;QACjB,oBAAoB;QACpB,eAAe;QACf,GAAG,QAAQ;QACX,EAAE;QACF,uBAAuB;QACvB,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAClD,gBAAgB;QAChB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QACtB,eAAe;QACf,UAAU;QACV,qBAAqB;QACrB,SAAS;QACT,cAAc;QACd,iGAAiG;QACjG,wFAAwF;KACzF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,IAAI,kBAAsC,CAAC;AAE3C,MAAM,UAAU,gBAAgB;IAC9B,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,kBAAkB,GAAG,uBAAuB,EAAE,CAAC;IAC/C,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/lib/tool-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-contracts.d.ts","sourceRoot":"","sources":["../../src/lib/tool-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,QAAQ,CAAC;AAgChC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,WAAW,EAAE;QACX,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,YAAY,EAsHxC,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM1D"}
+{"version":3,"file":"tool-contracts.d.ts","sourceRoot":"","sources":["../../src/lib/tool-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,QAAQ,CAAC;AAgChC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,WAAW,EAAE;QACX,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,YAAY,EA6KxC,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM1D"}

package/dist/lib/tool-contracts.js

@@ -8,7 +8,12 @@ export const TOOL_CONTRACTS = [
         description: 'Store a single memory with content, tags, and optional type/importance. Returns the SHA-256 hash. Idempotent — storing the same content+tags returns the existing hash with `created: false`. For storing multiple memories at once, prefer `store_memories`.',
         inputSchema: StoreMemoryInputSchema,
         outputSchema: StoreResultSchema,
-        annotations: { idempotentHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'store_memories',
@@ -16,7 +21,12 @@ export const TOOL_CONTRACTS = [
         description: 'Store up to 50 memories atomically. Each item is independently idempotent — same content+tags returns existing hash with `created: false`. Returns per-item results. Transaction rolls back entirely on unexpected error.',
         inputSchema: StoreMemoriesInputSchema,
         outputSchema: BatchResultSchema,
-        annotations: { idempotentHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'get_memory',
@@ -24,7 +34,11 @@ export const TOOL_CONTRACTS = [
         description: 'Retrieve a single memory by its exact SHA-256 hash. Returns the full memory object or E_NOT_FOUND. Use `search_memories` or `recall` when you do not know the exact hash.',
         inputSchema: GetMemoryInputSchema,
         outputSchema: MemoryResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'search_memories',
@@ -32,7 +46,11 @@ export const TOOL_CONTRACTS = [
         description: 'Full-text search over memory content and tags using FTS5. Returns ranked results with cursor pagination. Query terms are individually matched (all-OR logic; FTS5 phrase operators and negation are not supported). Use `recall` when you need to follow relationships between memories after the search.',
         inputSchema: SearchMemoriesInputSchema,
         outputSchema: SearchResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'retrieve_context',
@@ -40,7 +58,11 @@ export const TOOL_CONTRACTS = [
         description: 'FTS search with automatic token-budget management. Returns relevance-ranked memories totalling at most `token_budget` tokens. `strategy` controls sort: `relevance` (FTS rank, default), `importance` (highest first), or `recency` (newest first). Returns `truncated: true` when budget was reached before all candidates were included.',
         inputSchema: RetrieveContextInputSchema,
         outputSchema: RetrieveContextResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'recall',
@@ -48,7 +70,11 @@ export const TOOL_CONTRACTS = [
         description: 'Search for memories and explore their connections (knowledge graph). FTS search then BFS graph traversal up to `depth` hops. Returns all discovered memories and edges. Use when exploring memory relationships or understanding context. Emits progress per hop. Returns `aborted: true` with partial results when safety limits are hit (env: RECALL_MAX_FRONTIER_SIZE, RECALL_MAX_EDGE_ROWS, RECALL_MAX_VISITED_NODES).',
         inputSchema: RecallInputSchema,
         outputSchema: RecallResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'update_memory',
@@ -56,7 +82,11 @@ export const TOOL_CONTRACTS = [
         description: 'Replace the content (and optionally tags) of an existing memory. Returns both old and new SHA-256 hashes, since content changes alter the hash. Returns E_NOT_FOUND if the memory does not exist; E_CONFLICT if the new content+tags already maps to an existing hash.',
         inputSchema: UpdateMemoryInputSchema,
         outputSchema: UpdateResultSchema,
-        annotations: { destructiveHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'delete_memory',
@@ -64,7 +94,11 @@ export const TOOL_CONTRACTS = [
         description: 'Delete a single memory by its SHA-256 hash. Cascade-deletes all relationships involving it. Returns E_NOT_FOUND if the hash does not exist.',
         inputSchema: DeleteMemoryInputSchema,
         outputSchema: DeleteResultSchema,
-        annotations: { destructiveHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'delete_memories',
@@ -72,7 +106,11 @@ export const TOOL_CONTRACTS = [
         description: 'Delete up to 50 memories atomically. Cascade-deletes all relationships for each hash. Per-item `deleted: false` means the hash was not found — not an error, the batch still succeeds. Transaction rolls back entirely on unexpected error.',
         inputSchema: DeleteMemoriesInputSchema,
         outputSchema: BatchResultSchema,
-        annotations: { destructiveHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'create_relationship',
@@ -80,7 +118,12 @@ export const TOOL_CONTRACTS = [
         description: 'Create a directed labeled edge between two memories. Idempotent — re-creating an existing relationship is a no-op and returns `created: false`. Both endpoint memories must already exist, otherwise returns E_NOT_FOUND for the missing endpoint.',
         inputSchema: CreateRelationshipInputSchema,
         outputSchema: CreateRelationshipResultSchema,
-        annotations: { idempotentHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'delete_relationship',
@@ -88,7 +131,11 @@ export const TOOL_CONTRACTS = [
         description: 'Remove a single directed relationship edge between two memories. All three fields (from_hash, to_hash, relation_type) must match exactly. Returns E_NOT_FOUND if the exact relationship does not exist.',
         inputSchema: DeleteRelationshipInputSchema,
         outputSchema: DeleteRelationshipResultSchema,
-        annotations: { destructiveHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'get_relationships',
@@ -96,7 +143,11 @@ export const TOOL_CONTRACTS = [
         description: 'Retrieve all relationships for a memory, with the related memory inlined. Filter by direction (outgoing | incoming | both). Returns E_NOT_FOUND if the source memory does not exist.',
         inputSchema: GetRelationshipsInputSchema,
         outputSchema: RelationshipResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_stats',
@@ -104,7 +155,11 @@ export const TOOL_CONTRACTS = [
         description: 'Return aggregate statistics: total memories, total relationships, oldest/newest timestamps, average importance, and per-type counts. No input required.',
         inputSchema: MemoryStatsInputSchema,
         outputSchema: StatsResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
     },
 ];
 export function getToolContracts() {

package/dist/lib/tool-contracts.js.map

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

package/dist/lib/tool-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/lib/tool-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAoCzE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,cAAc,CAEhB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,cAAc,CAEhB"}
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/lib/tool-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAyBzE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,cAAc,CAKhB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,cAAc,CAKhB"}

package/dist/lib/tool-response.js

@@ -7,17 +7,16 @@ function createStructuredError(code, message) {
         error: { code, message },
     };
 }
-function buildResponse(structured, isError = false) {
+export function createToolResponse(payload) {
     return {
-        content: [toTextContent(structured)],
-        structuredContent: structured,
-        ...(isError ? { isError: true } : {}),
+        content: [toTextContent(payload)],
+        structuredContent: payload,
     };
 }
-export function createToolResponse(payload) {
-    return buildResponse(payload);
-}
 export function createErrorResponse(code, message) {
-    return buildResponse(createStructuredError(code, message), true);
+    return {
+        content: [toTextContent(createStructuredError(code, message))],
+        isError: true,
+    };
 }
 //# sourceMappingURL=tool-response.js.map

package/dist/lib/tool-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../src/lib/tool-response.ts"],"names":[],"mappings":"AAWA,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,UAAmC,EACnC,OAAO,GAAG,KAAK;IAEf,OAAO;QACL,OAAO,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACpC,iBAAiB,EAAE,UAAU;QAC7B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAgC;IAEhC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAAe;IAEf,OAAO,aAAa,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../src/lib/tool-response.ts"],"names":[],"mappings":"AAWA,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAgC;IAEhC,OAAO;QACL,OAAO,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACjC,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,OAAO,EAAE,CAAC,aAAa,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA8C9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CA2DzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2E9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAkJzE"}

package/dist/resources/index.js

@@ -4,9 +4,20 @@ import { createHashCompletionCallback } from '../completions/index.js';
 import { loadInstructions } from '../lib/instructions.js';
 import { SELECT_MEMORY_BY_HASH_SQL } from '../lib/sql.js';
 import { parseMemoryRow } from '../lib/types.js';
+import { buildServerConfig } from './server-config.js';
+import { buildToolCatalog } from './tool-catalog.js';
+import { getToolInfo, getToolNames } from './tool-info.js';
+import { buildWorkflowGuide } from './workflows.js';
 const HASH_REGEX = /^[a-f0-9]{64}$/;
 const INSTRUCTIONS_URI = 'internal://instructions';
+const TOOL_CATALOG_URI = 'internal://tool-catalog';
+const TOOL_INFO_URI_TEMPLATE = 'internal://tool-info/{toolName}';
+const WORKFLOWS_URI = 'internal://workflows';
+const SERVER_CONFIG_URI = 'internal://server-config';
 const MEMORY_RESOURCE_URI_TEMPLATE = 'memory://memories/{hash}';
+function createMarkdownContent(uri, text) {
+    return { uri, mimeType: 'text/markdown', text };
+}
 function createJsonContent(uri, payload) {
     return {
         uri,
@@ -25,22 +36,76 @@ function getSingleVariable(value) {
 function readMemoryByHash(db, hash) {
     return db.prepareOnce(SELECT_MEMORY_BY_HASH_SQL).get(hash);
 }
+// --- Pre-computed static content ---
 const INSTRUCTIONS_CONTENT = loadInstructions();
+const TOOL_CATALOG_CONTENT = buildToolCatalog();
+const WORKFLOW_GUIDE_CONTENT = buildWorkflowGuide();
+const SERVER_CONFIG_CONTENT = buildServerConfig();
+// --- Registration ---
 export function registerAllResources(server, db) {
+    // internal://instructions
     server.registerResource('instructions', INSTRUCTIONS_URI, {
         title: 'Memory Instructions',
         description: 'Complete usage guide: tool inventory, routing decisions, error codes, data model, and workflow patterns. Read this first.',
         mimeType: 'text/markdown',
         annotations: { audience: ['assistant'], priority: 0.9 },
+    }, () => ({
+        contents: [createMarkdownContent(INSTRUCTIONS_URI, INSTRUCTIONS_CONTENT)],
+    }));
+    // internal://tool-catalog
+    server.registerResource('tool-catalog', TOOL_CATALOG_URI, {
+        title: 'Tool Catalog',
+        description: 'Tool reference table, optional parameter matrix, and cross-tool data flow.',
+        mimeType: 'text/markdown',
+        annotations: { audience: ['assistant'], priority: 0.7 },
+    }, () => ({
+        contents: [createMarkdownContent(TOOL_CATALOG_URI, TOOL_CATALOG_CONTENT)],
+    }));
+    // internal://tool-info/{toolName}
+    server.registerResource('tool-info', new ResourceTemplate(TOOL_INFO_URI_TEMPLATE, {
+        list: undefined,
+        complete: {
+            toolName: (value) => getToolNames().filter((n) => n.startsWith(value)),
+        },
+    }), {
+        title: 'Tool Info',
+        description: 'Per-tool detail: parameters, behavior, and output shape. Supports toolName auto-completion.',
+        mimeType: 'text/markdown',
+        annotations: { audience: ['assistant'], priority: 0.6 },
+    }, (uri, variables) => {
+        const toolName = getSingleVariable(variables['toolName']);
+        if (!toolName) {
+            throw new McpError(ErrorCode.InvalidParams, 'Missing toolName parameter');
+        }
+        const info = getToolInfo(toolName);
+        if (!info) {
+            throw new McpError(ErrorCode.InvalidParams, `Unknown tool: ${toolName}`);
+        }
+        return {
+            contents: [createMarkdownContent(uri.href, info)],
+        };
+    });
+    // internal://workflows
+    server.registerResource('workflows', WORKFLOWS_URI, {
+        title: 'Workflow Guide',
+        description: 'Recommended multi-step workflow sequences with guardrails and tool reference.',
+        mimeType: 'text/markdown',
+        annotations: { audience: ['assistant'], priority: 0.7 },
+    }, () => ({
+        contents: [createMarkdownContent(WORKFLOWS_URI, WORKFLOW_GUIDE_CONTENT)],
+    }));
+    // internal://server-config
+    server.registerResource('server-config', SERVER_CONFIG_URI, {
+        title: 'Server Configuration',
+        description: 'Runtime configuration, environment variables, capabilities, and data limits.',
+        mimeType: 'text/markdown',
+        annotations: { audience: ['user', 'assistant'], priority: 0.5 },
     }, () => ({
         contents: [
-            {
-                uri: INSTRUCTIONS_URI,
-                mimeType: 'text/markdown',
-                text: INSTRUCTIONS_CONTENT,
-            },
+            createMarkdownContent(SERVER_CONFIG_URI, SERVER_CONFIG_CONTENT),
         ],
     }));
+    // memory://memories/{hash}
     const hashCompletion = createHashCompletionCallback(db);
     server.registerResource('memory', new ResourceTemplate(MEMORY_RESOURCE_URI_TEMPLATE, {
         list: undefined,

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,GAAG,gBAAgB,CAAC;AACpC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AACnD,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AAQhE,SAAS,iBAAiB,CAAC,GAAW,EAAE,OAAgB;IACtD,OAAO;QACL,GAAG;QACH,QAAQ,EAAE,kBAAkB;QAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,GAAW,EACX,KAAa,EACb,IAAa;IAEb,OAAO;QACL,QAAQ,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAoC;IAEpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACjD,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAW,EAAE,IAAY;IACjD,OAAO,EAAE,CAAC,WAAW,CAAY,yBAAyB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,oBAAoB,GAAG,gBAAgB,EAAE,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,EAAW;IACjE,MAAM,CAAC,gBAAgB,CACrB,cAAc,EACd,gBAAgB,EAChB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,2HAA2H;QAC7H,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE;KACxD,EACD,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,gBAAgB;gBACrB,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,oBAAoB;aAC3B;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,cAAc,GAAG,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAExD,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EACR,IAAI,gBAAgB,CAAC,4BAA4B,EAAE;QACjD,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;KACnC,CAAC,EACF;QACE,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,kIAAkI;QACpI,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE;KACxD,EACD,CAAC,GAAQ,EAAE,SAAoB,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,iDAAiD,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAEvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,2BAA2B,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;SAC7D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/instructions.d.ts

@@ -0,0 +1,2 @@
+export declare function buildServerInstructions(): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/resources/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/resources/instructions.ts"],"names":[],"mappings":"AAsFA,wBAAgB,uBAAuB,IAAI,MAAM,CA0BhD"}

package/dist/resources/instructions.js

@@ -0,0 +1,106 @@
+import { getToolContracts } from '../lib/tool-contracts.js';
+import { getSharedConstraints } from './tool-info.js';
+const PROMPTS_INVENTORY = ['- `get-help` — Return full usage instructions.'];
+const RESOURCES_INVENTORY = [
+    '- `internal://instructions` — This document. Read for tool routing, error codes, and workflows.',
+    '- `internal://tool-catalog` — Tool reference table, optional parameter matrix, and cross-tool data flow.',
+    '- `internal://tool-info/{toolName}` — Per-tool detail: parameters, behavior, and output shape.',
+    '- `internal://workflows` — Recommended multi-step workflow sequences.',
+    '- `internal://server-config` — Runtime configuration, limits, and capabilities.',
+    '- `memory://memories/{hash}` — Fetch a single memory by URI with hash auto-completion.',
+];
+const ERROR_CODES = [
+    '| Code | Meaning |',
+    '| --- | --- |',
+    '| `E_NOT_FOUND` | Hash or relationship does not exist |',
+    '| `E_CONFLICT` | `update_memory` target content+tags already maps to an existing hash |',
+    '| `E_CANCELLED` | Request was cancelled |',
+    '| `E_UNKNOWN` | Unexpected internal error — retry once |',
+];
+const DATA_MODEL = `### Memory
+- \`hash\` — SHA-256 of \`(content + sorted tags)\`; deterministic; changes when content or tags change
+- \`content\` — Text; 1–100,000 chars
+- \`tags\` — Array; 1–100 tags; each 1–50 chars, no whitespace; minimum 1 required
+- \`memory_type\` — \`general\` | \`fact\` | \`plan\` | \`decision\` | \`reflection\` | \`lesson\` | \`error\` | \`gradient\` (default \`general\`)
+- \`importance\` — Integer 0–10 (default 0; 10 = critical)
+- \`created_at\`, \`updated_at\` — ISO 8601 timestamps
+
+### Relationship
+- Directed edge: \`from_hash -[relation_type]-> to_hash\`
+- \`relation_type\` — Free-form string, 1–50 chars, no whitespace
+- Suggested types: \`related_to\`, \`causes\`, \`depends_on\`, \`parent_of\`, \`child_of\`, \`supersedes\`, \`contradicts\`, \`supports\`, \`references\`
+- Both endpoints must exist before creating a relationship
+- Cascade-deleted when either endpoint memory is deleted
+- Cascade-updated when either endpoint hash changes (ON UPDATE CASCADE)`;
+const WORKFLOWS = `### Store and Link
+\`\`\`
+store_memories({ items: [...] })         → { items[].hash, succeeded, failed }
+create_relationship({ from_hash, to_hash, relation_type })  × N
+\`\`\`
+
+### Search and Read
+\`\`\`
+search_memories({ query, limit })        → { memories[], nextCursor }
+# or, for relationship navigation:
+recall({ query, depth: 1 })             → { memories[], graph[] }
+\`\`\`
+
+### Fill Context Window
+\`\`\`
+retrieve_context({ query, token_budget: 4000, strategy: 'relevance' })
+  → { memories[], estimated_tokens, truncated }
+\`\`\`
+
+### Update a Memory
+\`\`\`
+update_memory({ hash, content })         → { old_hash, new_hash }
+# Existing relationships auto-update to new_hash via CASCADE
+\`\`\`
+
+### Batch Delete
+\`\`\`
+delete_memories({ hashes: [...] })       → { items[].{ hash, deleted }, succeeded, failed }
+# deleted: false means hash not found — not an error
+\`\`\``;
+function buildToolRouting() {
+    const contracts = getToolContracts();
+    const rows = contracts.map((c) => {
+        const purpose = c.description.split('.')[0] ?? '';
+        return `| \`${c.name}\` | ${purpose} |`;
+    });
+    return [
+        '## Tool Routing',
+        '',
+        '| Tool | Purpose |',
+        '| --- | --- |',
+        ...rows,
+    ].join('\n');
+}
+export function buildServerInstructions() {
+    return [
+        '# Memory MCP — Usage Guide',
+        '',
+        buildToolRouting(),
+        '',
+        '## Shared Constraints',
+        getSharedConstraints()
+            .map((c) => `- ${c}`)
+            .join('\n'),
+        '',
+        '## Error Codes',
+        ERROR_CODES.join('\n'),
+        '',
+        '## Data Model',
+        DATA_MODEL,
+        '',
+        '## Common Workflows',
+        WORKFLOWS,
+        '',
+        '## Prompts',
+        PROMPTS_INVENTORY.join('\n'),
+        '',
+        '## Resources',
+        RESOURCES_INVENTORY.join('\n'),
+    ].join('\n');
+}
+//# sourceMappingURL=instructions.js.map

package/dist/resources/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/resources/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,iBAAiB,GAAG,CAAC,gDAAgD,CAAC,CAAC;AAE7E,MAAM,mBAAmB,GAAG;IAC1B,iGAAiG;IACjG,0GAA0G;IAC1G,gGAAgG;IAChG,uEAAuE;IACvE,iFAAiF;IACjF,wFAAwF;CACzF,CAAC;AAEF,MAAM,WAAW,GAAG;IAClB,oBAAoB;IACpB,eAAe;IACf,yDAAyD;IACzD,yFAAyF;IACzF,2CAA2C;IAC3C,0DAA0D;CAC3D,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;;;;;;;wEAcqD,CAAC;AAEzE,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BX,CAAC;AAER,SAAS,gBAAgB;IACvB,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,CAAC,IAAI,QAAQ,OAAO,IAAI,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,iBAAiB;QACjB,EAAE;QACF,oBAAoB;QACpB,eAAe;QACf,GAAG,IAAI;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,gBAAgB,EAAE;QAClB,EAAE;QACF,uBAAuB;QACvB,oBAAoB,EAAE;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC;QACb,EAAE;QACF,gBAAgB;QAChB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QACtB,EAAE;QACF,eAAe;QACf,UAAU;QACV,EAAE;QACF,qBAAqB;QACrB,SAAS;QACT,EAAE;QACF,YAAY;QACZ,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,EAAE;QACF,cAAc;QACd,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/resources/server-config.d.ts

@@ -0,0 +1,2 @@
+export declare function buildServerConfig(): string;
+//# sourceMappingURL=server-config.d.ts.map

package/dist/resources/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/resources/server-config.ts"],"names":[],"mappings":"AAgDA,wBAAgB,iBAAiB,IAAI,MAAM,CA8B1C"}