@j0hanz/memory-mcp 1.0.1 → 1.2.0

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"}

package/dist/resources/server-config.js

@@ -0,0 +1,72 @@
+const ENV_VARS = [
+    {
+        name: 'MEMORY_DB_PATH',
+        default: 'memory.db',
+        range: '—',
+        purpose: 'SQLite database file path',
+    },
+    {
+        name: 'RECALL_MAX_FRONTIER_SIZE',
+        default: '1000',
+        range: '100–50000',
+        purpose: 'Maximum BFS frontier size per hop',
+    },
+    {
+        name: 'RECALL_MAX_EDGE_ROWS',
+        default: '5000',
+        range: '100–50000',
+        purpose: 'Maximum edge rows fetched per traversal',
+    },
+    {
+        name: 'RECALL_MAX_VISITED_NODES',
+        default: '5000',
+        range: '100–50000',
+        purpose: 'Maximum visited nodes during BFS traversal',
+    },
+];
+const DATA_LIMITS = [
+    { dimension: 'Content length', range: '1–100,000 chars' },
+    { dimension: 'Tags per memory', range: '1–100 tags' },
+    { dimension: 'Tag length', range: '1–50 chars, no whitespace' },
+    { dimension: 'Batch size', range: '1–50 items' },
+    { dimension: 'Search results per page', range: '1–100 (default 20)' },
+    { dimension: 'Recall depth', range: '0–3 hops' },
+    { dimension: 'Token budget', range: '100–200,000' },
+    { dimension: 'Hash format', range: 'SHA-256, 64 hex chars' },
+    { dimension: 'Relation type', range: '1–50 chars, no whitespace' },
+    { dimension: 'Importance', range: '0–10 (integer)' },
+];
+const CAPABILITIES = [
+    { capability: 'tools', status: 'enabled' },
+    { capability: 'resources', status: 'enabled (subscribe supported)' },
+    { capability: 'prompts', status: 'enabled' },
+    { capability: 'completions', status: 'enabled' },
+    { capability: 'logging', status: 'enabled' },
+];
+export function buildServerConfig() {
+    const envRows = ENV_VARS.map((v) => `| \`${v.name}\` | ${v.default} | ${v.range} | ${v.purpose} |`);
+    const limitRows = DATA_LIMITS.map((l) => `| ${l.dimension} | ${l.range} |`);
+    const capRows = CAPABILITIES.map((c) => `| ${c.capability} | ${c.status} |`);
+    return [
+        '# Server Configuration',
+        '',
+        '## Environment Variables',
+        '',
+        '| Variable | Default | Range | Purpose |',
+        '|----------|---------|-------|---------|',
+        ...envRows,
+        '',
+        '## Capabilities',
+        '',
+        '| Capability | Status |',
+        '|------------|--------|',
+        ...capRows,
+        '',
+        '## Data Limits',
+        '',
+        '| Dimension | Range |',
+        '|-----------|-------|',
+        ...limitRows,
+    ].join('\n');
+}
+//# sourceMappingURL=server-config.js.map

package/dist/resources/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/resources/server-config.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG;IACf;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,2BAA2B;KACrC;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,mCAAmC;KAC7C;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,yCAAyC;KACnD;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,4CAA4C;KACtD;CACO,CAAC;AAEX,MAAM,WAAW,GAAG;IAClB,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE;IACzD,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,EAAE;IACrD,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,2BAA2B,EAAE;IAC/D,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAChD,EAAE,SAAS,EAAE,yBAAyB,EAAE,KAAK,EAAE,oBAAoB,EAAE;IACrE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE;IAChD,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE;IACnD,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,uBAAuB,EAAE;IAC5D,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,2BAA2B,EAAE;IAClE,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE;CAC5C,CAAC;AAEX,MAAM,YAAY,GAAG;IACnB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE;IAC1C,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,+BAA+B,EAAE;IACpE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;IAC5C,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;IAChD,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;CACpC,CAAC;AAEX,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CACtE,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAE5E,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IAE7E,OAAO;QACL,wBAAwB;QACxB,EAAE;QACF,0BAA0B;QAC1B,EAAE;QACF,0CAA0C;QAC1C,0CAA0C;QAC1C,GAAG,OAAO;QACV,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,yBAAyB;QACzB,yBAAyB;QACzB,GAAG,OAAO;QACV,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,uBAAuB;QACvB,uBAAuB;QACvB,GAAG,SAAS;KACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/resources/tool-catalog.d.ts

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

package/dist/resources/tool-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/resources/tool-catalog.ts"],"names":[],"mappings":"AA0DA,wBAAgB,gBAAgB,IAAI,MAAM,CAwBzC"}

package/dist/resources/tool-catalog.js

@@ -0,0 +1,64 @@
+import { z } from 'zod/v4';
+import { getToolContracts } from '../lib/tool-contracts.js';
+import { buildCoreContextPack } from './tool-info.js';
+function extractJsonSchema(schema) {
+    try {
+        return z.toJSONSchema(schema);
+    }
+    catch {
+        return {};
+    }
+}
+function extractOptionalParams(toolName, schema) {
+    const jsonSchema = extractJsonSchema(schema);
+    const properties = (jsonSchema['properties'] ?? {});
+    const requiredFields = new Set(Array.isArray(jsonSchema['required'])
+        ? jsonSchema['required']
+        : []);
+    const rows = [];
+    for (const [name, prop] of Object.entries(properties).sort(([a], [b]) => a.localeCompare(b))) {
+        if (requiredFields.has(name))
+            continue;
+        const desc = typeof prop['description'] === 'string' ? prop['description'] : '';
+        const rawDefault = prop['default'];
+        const defaultVal = rawDefault !== undefined ? JSON.stringify(rawDefault) : '—';
+        rows.push(`| \`${toolName}\` | \`${name}\` | ${defaultVal} | ${desc} |`);
+    }
+    return rows;
+}
+const CROSS_TOOL_DATA_FLOW = `## Cross-Tool Data Flow
+
+\`\`\`
+store_memory.hash ──→ get_memory.hash
+store_memory.hash ──→ create_relationship.from_hash / to_hash
+store_memory.hash ──→ update_memory.hash
+store_memory.hash ──→ delete_memory.hash
+store_memories.items[].hash ──→ get_memory.hash
+search_memories.memories[].hash ──→ get_memory.hash
+search_memories.nextCursor ──→ search_memories.cursor
+recall.memories[].hash ──→ get_memory.hash
+recall.nextCursor ──→ recall.cursor
+update_memory.new_hash ──→ get_memory.hash
+get_relationships.relationships[].linked_hash ──→ get_memory.hash
+\`\`\``;
+export function buildToolCatalog() {
+    const contracts = getToolContracts();
+    const optionalRows = contracts.flatMap((c) => extractOptionalParams(c.name, c.inputSchema));
+    const optionalParamSection = optionalRows.length > 0
+        ? [
+            '## Optional Parameter Matrix',
+            '',
+            '| Tool | Parameter | Default | Purpose |',
+            '|------|-----------|---------|---------|',
+            ...optionalRows,
+        ].join('\n')
+        : '';
+    return [
+        buildCoreContextPack(),
+        '',
+        optionalParamSection,
+        '',
+        CROSS_TOOL_DATA_FLOW,
+    ].join('\n');
+}
+//# sourceMappingURL=tool-catalog.js.map

package/dist/resources/tool-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog.js","sourceRoot":"","sources":["../../src/resources/tool-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAItD,SAAS,iBAAiB,CAAC,MAAiB;IAC1C,IAAI,CAAC;QACH,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,CAAqB,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAgB,EAAE,MAAiB;IAChE,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,CAGjD,CAAC;IACF,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC,CAAE,UAAU,CAAC,UAAU,CAAc;QACtC,CAAC,CAAC,EAAE,CACP,CAAC;IAEF,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACtE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CACnB,EAAE,CAAC;QACF,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,MAAM,IAAI,GACR,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,UAAU,GACd,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,QAAQ,UAAU,IAAI,QAAQ,UAAU,MAAM,IAAI,IAAI,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;OActB,CAAC;AAER,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,qBAAqB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAC7C,CAAC;IAEF,MAAM,oBAAoB,GACxB,YAAY,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC;YACE,8BAA8B;YAC9B,EAAE;YACF,0CAA0C;YAC1C,0CAA0C;YAC1C,GAAG,YAAY;SAChB,CAAC,IAAI,CAAC,IAAI,CAAC;QACd,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,oBAAoB,EAAE;QACtB,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/resources/tool-info.d.ts

@@ -0,0 +1,5 @@
+export declare function getSharedConstraints(): readonly string[];
+export declare function buildCoreContextPack(): string;
+export declare function getToolInfo(name: string): string | undefined;
+export declare function getToolNames(): string[];
+//# sourceMappingURL=tool-info.d.ts.map

package/dist/resources/tool-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-info.d.ts","sourceRoot":"","sources":["../../src/resources/tool-info.ts"],"names":[],"mappings":"AAcA,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD;AA4BD,wBAAgB,oBAAoB,IAAI,MAAM,CAgB7C;AAiED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwC5D;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAIvC"}

package/dist/resources/tool-info.js

@@ -0,0 +1,129 @@
+import { z } from 'zod/v4';
+import { getToolContracts } from '../lib/tool-contracts.js';
+// --- Shared Constraints (Single Source of Truth) ---
+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.',
+];
+export function getSharedConstraints() {
+    return SHARED_CONSTRAINTS;
+}
+function formatBehavior(annotations) {
+    const hints = [];
+    if (annotations.readOnlyHint === true)
+        hints.push('read-only');
+    if (annotations.destructiveHint === true)
+        hints.push('destructive');
+    if (annotations.idempotentHint === true)
+        hints.push('idempotent');
+    return hints.join(', ') || '—';
+}
+function toEntry(contract) {
+    return {
+        name: contract.name,
+        purpose: contract.description.split('.')[0] ?? '',
+        behavior: formatBehavior(contract.annotations),
+    };
+}
+export function buildCoreContextPack() {
+    const contracts = getToolContracts();
+    const entries = contracts
+        .map(toEntry)
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const rows = entries.map((e) => `| \`${e.name}\` | ${e.purpose} | ${e.behavior} |`);
+    return [
+        '# Core Context Pack',
+        '',
+        '| Tool | Purpose | Behavior |',
+        '|------|---------|----------|',
+        ...rows,
+    ].join('\n');
+}
+// --- Per-Tool Info ---
+function extractJsonSchema(schema) {
+    try {
+        return z.toJSONSchema(schema);
+    }
+    catch {
+        return {};
+    }
+}
+function formatParamConstraints(prop) {
+    const parts = [];
+    if (typeof prop['minimum'] === 'number')
+        parts.push(`min: ${prop['minimum']}`);
+    if (typeof prop['maximum'] === 'number')
+        parts.push(`max: ${prop['maximum']}`);
+    if (typeof prop['minLength'] === 'number')
+        parts.push(`minLength: ${prop['minLength']}`);
+    if (typeof prop['maxLength'] === 'number')
+        parts.push(`maxLength: ${prop['maxLength']}`);
+    if (typeof prop['minItems'] === 'number')
+        parts.push(`minItems: ${prop['minItems']}`);
+    if (typeof prop['maxItems'] === 'number')
+        parts.push(`maxItems: ${prop['maxItems']}`);
+    if (Array.isArray(prop['enum']))
+        parts.push(`enum: ${prop['enum'].join(' | ')}`);
+    return parts.length > 0 ? `; ${parts.join(', ')}` : '';
+}
+function formatParam(name, prop, required) {
+    const type = typeof prop['type'] === 'string' ? prop['type'] : 'unknown';
+    const desc = typeof prop['description'] === 'string' ? prop['description'] : '';
+    const constraints = formatParamConstraints(prop);
+    return `- \`${name}\` (${type}, ${required ? 'required' : 'optional'}${constraints}) — ${desc}`;
+}
+function formatOutputShape(schema) {
+    const jsonSchema = extractJsonSchema(schema);
+    const properties = jsonSchema['properties'];
+    if (!properties)
+        return '{}';
+    const requiredFields = new Set(Array.isArray(jsonSchema['required'])
+        ? jsonSchema['required']
+        : []);
+    const parts = Object.entries(properties).map(([key, prop]) => {
+        const isArray = prop['type'] === 'array';
+        const isOptional = !requiredFields.has(key);
+        return `${key}${isArray ? '[]' : ''}${isOptional ? '?' : ''}`;
+    });
+    return `{${parts.join(', ')}}`;
+}
+export function getToolInfo(name) {
+    const contract = getToolContracts().find((c) => c.name === name);
+    if (!contract)
+        return undefined;
+    const inputSchema = extractJsonSchema(contract.inputSchema);
+    const properties = (inputSchema['properties'] ?? {});
+    const requiredFields = new Set(Array.isArray(inputSchema['required'])
+        ? inputSchema['required']
+        : []);
+    const paramLines = Object.entries(properties)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([pName, pSchema]) => formatParam(pName, pSchema, requiredFields.has(pName)));
+    const behaviorLine = formatBehavior(contract.annotations);
+    const outputShape = formatOutputShape(contract.outputSchema);
+    return [
+        `# \`${contract.name}\``,
+        '',
+        `**${contract.title}**`,
+        '',
+        contract.description,
+        '',
+        '## Parameters',
+        paramLines.length > 0 ? paramLines.join('\n') : '_No parameters._',
+        '',
+        '## Behavior',
+        behaviorLine,
+        '',
+        '## Output Shape',
+        `\`${outputShape}\``,
+    ].join('\n');
+}
+export function getToolNames() {
+    return getToolContracts()
+        .map((c) => c.name)
+        .sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=tool-info.js.map

package/dist/resources/tool-info.js.map

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

package/dist/resources/workflows.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/resources/workflows.ts"],"names":[],"mappings":"AA0CA,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C"}

package/dist/resources/workflows.js

@@ -0,0 +1,55 @@
+import { getSharedConstraints } from './tool-info.js';
+const WORKFLOW_TRACKS = `## Workflow A: Store and Link
+
+1. \`store_memories({ items: [...] })\` → \`{ items[].hash, succeeded, failed }\`
+2. \`create_relationship({ from_hash, to_hash, relation_type })\` × N
+
+> Constraint: Both endpoint memories must exist before creating a relationship.
+
+## Workflow B: Search and Read
+
+1. \`search_memories({ query, limit })\` → \`{ memories[], nextCursor }\`
+2. \`get_memory({ hash })\` for full detail on a specific result
+
+> Or use \`recall({ query, depth: 1 })\` → \`{ memories[], graph[] }\` to follow relationships.
+
+## Workflow C: Fill Context Window
+
+1. \`retrieve_context({ query, token_budget: 4000, strategy: 'relevance' })\` → \`{ memories[], estimated_tokens, truncated }\`
+
+> Use \`strategy\` to control sort: \`relevance\` (FTS rank), \`importance\` (highest first), or \`recency\` (newest first).
+
+## Workflow D: Update a Memory
+
+1. \`update_memory({ hash, content })\` → \`{ old_hash, new_hash }\`
+
+> Existing relationships auto-update to new_hash via CASCADE.
+> Returns E_CONFLICT if the new content+tags already maps to an existing hash.
+
+## Workflow E: Batch Delete
+
+1. \`delete_memories({ hashes: [...] })\` → \`{ items[].{ hash, deleted }, succeeded, failed }\`
+
+> \`deleted: false\` means hash not found — not an error, the batch still succeeds.
+
+## Workflow F: Explore Graph
+
+1. \`recall({ query, depth: 2 })\` → \`{ memories[], graph[], depth_reached, aborted }\`
+2. \`get_relationships({ hash, direction: 'both' })\` for a specific memory's edges
+
+> BFS traversal emits progress per hop. Use \`depth: 0\` to skip traversal.`;
+export function buildWorkflowGuide() {
+    return [
+        '# Workflow Reference',
+        '',
+        WORKFLOW_TRACKS,
+        '',
+        '## Shared Constraints',
+        getSharedConstraints()
+            .map((c) => `- ${c}`)
+            .join('\n'),
+        '',
+        '> See `internal://tool-catalog` for complete tool reference and cross-tool data flow.',
+    ].join('\n');
+}
+//# sourceMappingURL=workflows.js.map

package/dist/resources/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/resources/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAsCoD,CAAC;AAE7E,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,sBAAsB;QACtB,EAAE;QACF,eAAe;QACf,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,uFAAuF;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/schemas/inputs.d.ts

@@ -101,9 +101,9 @@ export declare const RetrieveContextInputSchema: z.ZodObject<{
     query: z.ZodString;
     token_budget: z.ZodPrefault<z.ZodOptional<z.ZodInt>>;
     strategy: z.ZodPrefault<z.ZodOptional<z.ZodEnum<{
-        relevance: "relevance";
         importance: "importance";
         recency: "recency";
+        relevance: "relevance";
     }>>>;
 }, z.core.$strict>;
 export declare const GetRelationshipsInputSchema: z.ZodObject<{

package/dist/schemas/inputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/schemas/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,WAAW,aAMkB,CAAC;AA2C3C,eAAO,MAAM,wBAAwB,iIAU3B,CAAC;AA2CX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;kBAEjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;kBAErC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;kBAMnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;kBAE/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;kBAIlC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;kBAElC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;kBAMpC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;kBAiBpC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;kBAsB5B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;kBAgBrC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;kBAOtC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;kBAMxC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;kBAMxC,CAAC;AAEH,eAAO,MAAM,sBAAsB,iCAAqB,CAAC"}
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/schemas/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,WAAW,aAMkB,CAAC;AA2C3C,eAAO,MAAM,wBAAwB,iIAU3B,CAAC;AA2CX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;kBAIa,CAAC;AAEjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;kBAIgB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;kBAQwB,CAAC;AAE9D,eAAO,MAAM,oBAAoB;;kBAI0B,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;kBAMgB,CAAC;AAErD,eAAO,MAAM,uBAAuB;;kBAIqB,CAAC;AAE1D,eAAO,MAAM,yBAAyB;;kBAQwB,CAAC;AAE/D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;kBAmB4B,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;kBA0B6C,CAAC;AAE5E,eAAO,MAAM,0BAA0B;;;;;;;;kBAoB0B,CAAC;AAElE,eAAO,MAAM,2BAA2B;;;;;;;kBAS+B,CAAC;AAExE,eAAO,MAAM,6BAA6B;;;;kBAQoC,CAAC;AAE/E,eAAO,MAAM,6BAA6B;;;;kBAQoC,CAAC;AAE/E,eAAO,MAAM,sBAAsB,iCAEkB,CAAC"}

package/dist/schemas/inputs.js

@@ -80,38 +80,53 @@ const STORE_MEMORY_SHAPE = {
     memory_type: MEMORY_TYPE_SCHEMA.optional(),
     importance: IMPORTANCE_SCHEMA.optional().prefault(0),
 };
-export const StoreMemoryInputSchema = z.strictObject({
+export const StoreMemoryInputSchema = z
+    .strictObject({
     ...STORE_MEMORY_SHAPE,
-});
-export const StoreMemoryItemInputSchema = z.strictObject({
+})
+    .describe('Input for storing a single memory');
+export const StoreMemoryItemInputSchema = z
+    .strictObject({
     ...STORE_MEMORY_SHAPE,
-});
-export const StoreMemoriesInputSchema = z.strictObject({
+})
+    .describe('A single memory item to store in a batch');
+export const StoreMemoriesInputSchema = z
+    .strictObject({
     items: z
         .array(StoreMemoryItemInputSchema)
         .min(1, { error: 'At least one item is required' })
         .max(50, { error: 'Maximum 50 items per batch' })
         .describe('Memories to store (1-50 items)'),
-});
-export const GetMemoryInputSchema = z.strictObject({
+})
+    .describe('Input for storing multiple memories atomically');
+export const GetMemoryInputSchema = z
+    .strictObject({
     hash: HASH_SCHEMA,
-});
-export const UpdateMemoryInputSchema = z.strictObject({
+})
+    .describe('Input for retrieving a single memory by hash');
+export const UpdateMemoryInputSchema = z
+    .strictObject({
     hash: HASH_SCHEMA,
     content: CONTENT_SCHEMA,
     tags: TAGS_ARRAY_SCHEMA.optional(),
-});
-export const DeleteMemoryInputSchema = z.strictObject({
+})
+    .describe('Input for updating an existing memory');
+export const DeleteMemoryInputSchema = z
+    .strictObject({
     hash: HASH_SCHEMA,
-});
-export const DeleteMemoriesInputSchema = z.strictObject({
+})
+    .describe('Input for deleting a single memory by hash');
+export const DeleteMemoriesInputSchema = z
+    .strictObject({
     hashes: z
         .array(HASH_SCHEMA)
         .min(1, { error: 'At least one hash is required' })
         .max(50, { error: 'Maximum 50 hashes per batch' })
         .describe('Hashes of memories to delete (1-50 hashes)'),
-});
-export const SearchMemoriesInputSchema = z.strictObject({
+})
+    .describe('Input for deleting multiple memories atomically');
+export const SearchMemoriesInputSchema = z
+    .strictObject({
     query: SEARCH_QUERY_SCHEMA.describe('Search query (searches content and tags)'),
     limit: z
         .int()
@@ -124,8 +139,10 @@ export const SearchMemoriesInputSchema = z.strictObject({
     min_importance: describeImportanceFilter(SEARCH_MIN_IMPORTANCE_DESCRIPTION),
     max_importance: describeImportanceFilter(SEARCH_MAX_IMPORTANCE_DESCRIPTION),
     memory_type: MEMORY_TYPE_SCHEMA.optional().describe(SEARCH_MEMORY_TYPE_DESCRIPTION),
-});
-export const RecallInputSchema = z.strictObject({
+})
+    .describe('Input for searching memories using full-text search');
+export const RecallInputSchema = z
+    .strictObject({
     query: SEARCH_QUERY_SCHEMA.describe('Search query to find initial memories'),
     depth: z
         .int()
@@ -145,8 +162,10 @@ export const RecallInputSchema = z.strictObject({
     min_importance: describeImportanceFilter(RECALL_MIN_IMPORTANCE_DESCRIPTION),
     max_importance: describeImportanceFilter(RECALL_MAX_IMPORTANCE_DESCRIPTION),
     memory_type: MEMORY_TYPE_SCHEMA.optional().describe(RECALL_MEMORY_TYPE_DESCRIPTION),
-});
-export const RetrieveContextInputSchema = z.strictObject({
+})
+    .describe('Input for exploring memory relationships via graph traversal');
+export const RetrieveContextInputSchema = z
+    .strictObject({
     query: SEARCH_QUERY_SCHEMA.describe('Search query to find relevant memories'),
     token_budget: z
         .int()
@@ -160,24 +179,33 @@ export const RetrieveContextInputSchema = z.strictObject({
         .optional()
         .prefault('relevance')
         .describe('Sort strategy: relevance (FTS rank, default), importance (highest first), recency (newest first)'),
-});
-export const GetRelationshipsInputSchema = z.strictObject({
+})
+    .describe('Input for retrieving context within a token budget');
+export const GetRelationshipsInputSchema = z
+    .strictObject({
     hash: HASH_SCHEMA,
     direction: z
         .enum(['outgoing', 'incoming', 'both'])
         .optional()
         .prefault('both')
         .describe('Direction of relationships to retrieve'),
-});
-export const CreateRelationshipInputSchema = z.strictObject({
+})
+    .describe('Input for retrieving relationships for a specific memory');
+export const CreateRelationshipInputSchema = z
+    .strictObject({
     from_hash: HASH_SCHEMA.describe('Source memory hash'),
     to_hash: HASH_SCHEMA.describe('Target memory hash'),
     relation_type: RELATION_TYPE_SCHEMA.describe('Type of relationship (e.g. related_to, causes, depends_on)'),
-});
-export const DeleteRelationshipInputSchema = z.strictObject({
+})
+    .describe('Input for creating a directed relationship between two memories');
+export const DeleteRelationshipInputSchema = z
+    .strictObject({
     from_hash: HASH_SCHEMA.describe('Source memory hash'),
     to_hash: HASH_SCHEMA.describe('Target memory hash'),
     relation_type: RELATION_TYPE_SCHEMA.describe('Type of relationship to delete'),
-});
-export const MemoryStatsInputSchema = z.strictObject({});
+})
+    .describe('Input for deleting a specific relationship between two memories');
+export const MemoryStatsInputSchema = z
+    .strictObject({})
+    .describe('Input for retrieving memory statistics');
 //# sourceMappingURL=inputs.js.map