simple-memory-mcp 1.1.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/search-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,eAAO,MAAM,gBAAgB,EAAE,IAqF9B,CAAC"}

package/dist/tools/search-memory/index.js

@@ -0,0 +1,89 @@
+import { execute } from './executor.js';
+import { parseCliArgs } from './cli-parser.js';
+export const searchMemoryTool = {
+    definition: {
+        name: 'search-memory',
+        description: `Search stored memories by content or tags, with optional relationship traversal.
+
+💡 PROACTIVE USAGE: Search memories at the START of conversations or when relevant topics arise to provide personalized, context-aware responses.
+
+When to search:
+• Beginning of new conversation - check for relevant context
+• User asks about their preferences or past decisions
+• Discussing topics that might have stored information
+• Before making recommendations - check what user likes/dislikes
+• When user mentions a person, project, or tool previously discussed
+
+Search silently and incorporate findings naturally into responses.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                hash: {
+                    type: 'string',
+                    description: 'Retrieve a specific memory by its MD5 hash (32 char hex). When provided, ignores all other search parameters.'
+                },
+                query: {
+                    type: 'string',
+                    description: 'Text to search for in memory content using full-text search.'
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of tags to filter results by. Matches memories that have these exact tags.'
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return',
+                    default: 10,
+                    minimum: 1
+                },
+                includeRelated: {
+                    type: 'boolean',
+                    description: 'Include related memories in results (default: false)',
+                    default: false
+                },
+                relationshipDepth: {
+                    type: 'number',
+                    description: 'Depth of relationship traversal when includeRelated is true (default: 1)',
+                    default: 1,
+                    minimum: 1,
+                    maximum: 3
+                },
+                daysAgo: {
+                    type: 'number',
+                    description: 'Filter memories created within the last N days. Example: 7 for last week, 30 for last month.',
+                    minimum: 0
+                },
+                startDate: {
+                    type: 'string',
+                    description: 'Filter memories created on or after this date (ISO 8601 format: YYYY-MM-DD or full ISO string).'
+                },
+                endDate: {
+                    type: 'string',
+                    description: 'Filter memories created on or before this date (ISO 8601 format: YYYY-MM-DD or full ISO string).'
+                },
+                minRelevance: {
+                    type: 'number',
+                    description: 'Minimum relevance score (0-1). Filters results by BM25 ranking. Higher values (e.g., 0.7-0.9) return only highly relevant matches.',
+                    minimum: 0,
+                    maximum: 1
+                },
+                summaryOnly: {
+                    type: 'boolean',
+                    description: 'Return compact summaries instead of full content. Reduces token usage by ~75%. Use hash parameter to retrieve full content.',
+                    default: false
+                },
+                contentPreview: {
+                    type: 'number',
+                    description: 'Number of characters to include in preview when summaryOnly=true (default: 100)',
+                    default: 100,
+                    minimum: 0,
+                    maximum: 500
+                }
+            }
+        }
+    },
+    handler: execute,
+    cliParser: parseCliArgs
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/search-memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;;;;;;;;;;;mEAWkD;QAC/D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+GAA+G;iBAC7H;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,kFAAkF;iBAChG;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;oBAClD,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,CAAC;iBACX;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,sDAAsD;oBACnE,OAAO,EAAE,KAAK;iBACf;gBACD,iBAAiB,EAAE;oBACjB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0EAA0E;oBACvF,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,CAAC;iBACX;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8FAA8F;oBAC3G,OAAO,EAAE,CAAC;iBACX;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iGAAiG;iBAC/G;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kGAAkG;iBAChH;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oIAAoI;oBACjJ,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,CAAC;iBACX;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,6HAA6H;oBAC1I,OAAO,EAAE,KAAK;iBACf;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iFAAiF;oBAC9F,OAAO,EAAE,GAAG;oBACZ,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;iBACb;aACF;SACF;KACF;IACD,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,YAAY;CACxB,CAAC"}

package/dist/tools/store-memory/cli-parser.d.ts

@@ -0,0 +1,2 @@
+export declare function parseCliArgs(args: string[]): any;
+//# sourceMappingURL=cli-parser.d.ts.map

package/dist/tools/store-memory/cli-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.d.ts","sourceRoot":"","sources":["../../../src/tools/store-memory/cli-parser.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAqB1C"}

package/dist/tools/store-memory/cli-parser.js

@@ -0,0 +1,21 @@
+import { parseCommandLineArgs } from '../../utils/cli-parser.js';
+export function parseCliArgs(args) {
+    // PHASE 1: Convert string array to object (shared utility)
+    const rawArgs = parseCommandLineArgs(args);
+    // PHASE 2: Validate and transform (command-specific logic)
+    const result = {
+        autoLink: true // Default to true
+    };
+    if (rawArgs.content)
+        result.content = rawArgs.content;
+    if (rawArgs.tags)
+        result.tags = rawArgs.tags.split(',').map((tag) => tag.trim());
+    if (typeof rawArgs.autoLink !== 'undefined') {
+        result.autoLink = rawArgs.autoLink;
+    }
+    if (rawArgs.relateTo) {
+        result.relateTo = rawArgs.relateTo.split(',').map((tag) => tag.trim());
+    }
+    return result;
+}
+//# sourceMappingURL=cli-parser.js.map

package/dist/tools/store-memory/cli-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.js","sourceRoot":"","sources":["../../../src/tools/store-memory/cli-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,2DAA2D;IAC3D,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE3C,2DAA2D;IAC3D,MAAM,MAAM,GAAQ;QAClB,QAAQ,EAAE,IAAI,CAAC,kBAAkB;KAClC,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACtD,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAI,OAAO,CAAC,IAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAErG,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,QAAQ,GAAI,OAAO,CAAC,QAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/store-memory/executor.d.ts

@@ -0,0 +1,16 @@
+import type { ToolContext } from '../../types/tools.js';
+interface StoreMemoryArgs {
+    content: string;
+    tags?: string[];
+    autoLink?: boolean;
+    relateTo?: string[];
+}
+interface StoreMemoryResult {
+    success: boolean;
+    hash: string;
+    message: string;
+    relationshipsCreated?: number;
+}
+export declare function execute(args: StoreMemoryArgs, context: ToolContext): Promise<StoreMemoryResult>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/store-memory/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/store-memory/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2CrG"}

package/dist/tools/store-memory/executor.js

@@ -0,0 +1,100 @@
+import { debugLog, formatHash } from '../../utils/debug.js';
+export async function execute(args, context) {
+    try {
+        // Validate content
+        if (!args.content || args.content.trim().length === 0) {
+            throw new Error('Content cannot be empty');
+        }
+        // Log content size for large memories
+        const contentSize = args.content.length;
+        if (contentSize > 100000) {
+            debugLog(`Storing large memory: ${contentSize} characters`);
+        }
+        const hash = context.memoryService.store(args.content, args.tags || []);
+        let relationshipsCreated = 0;
+        // Handle automatic relationship creation
+        if (args.autoLink !== false) { // Default to true
+            relationshipsCreated += await createAutoRelationships(hash, args, context);
+        }
+        // Handle explicit relationships
+        if (args.relateTo && args.relateTo.length > 0) {
+            relationshipsCreated += await createExplicitRelationships(hash, args.relateTo, context);
+        }
+        const message = relationshipsCreated > 0
+            ? `Memory stored successfully with hash: ${formatHash(hash)} (${relationshipsCreated} relationships created)`
+            : `Memory stored successfully with hash: ${formatHash(hash)}...`;
+        return {
+            success: true,
+            hash,
+            message,
+            relationshipsCreated
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            hash: '',
+            message: `Failed to store memory: ${error instanceof Error ? error.message : 'Unknown error'}`
+        };
+    }
+}
+/**
+ * Create automatic relationships based on similar tags and content
+ */
+async function createAutoRelationships(hash, args, context) {
+    if (!args.tags || args.tags.length === 0) {
+        return 0;
+    }
+    try {
+        // Find memories with similar tags
+        const similarMemories = context.memoryService.search(undefined, args.tags, 5);
+        // Build array of relationships to create
+        const relationships = similarMemories
+            .filter(memory => memory.hash !== hash) // Don't link to self
+            .filter(memory => {
+            const commonTags = args.tags.filter(tag => memory.tags.includes(tag));
+            return commonTags.length > 0;
+        })
+            .map(memory => ({
+            fromHash: hash,
+            toHash: memory.hash,
+            relationshipType: 'similar'
+        }));
+        // Use bulk insert for better performance
+        if (relationships.length > 0) {
+            return context.memoryService.linkMemoriesBulk(relationships);
+        }
+        return 0;
+    }
+    catch (error) {
+        console.error('Auto-relationship creation failed:', error);
+        return 0;
+    }
+}
+/**
+ * Create explicit relationships based on relateTo tags
+ */
+async function createExplicitRelationships(hash, relateTo, context) {
+    try {
+        // Find memories with the specified tags
+        const relatedMemories = context.memoryService.search(undefined, relateTo, 10);
+        // Build array of relationships to create
+        const relationships = relatedMemories
+            .filter(memory => memory.hash !== hash) // Don't link to self
+            .map(memory => ({
+            fromHash: hash,
+            toHash: memory.hash,
+            relationshipType: 'related'
+        }));
+        // Use bulk insert for better performance
+        if (relationships.length > 0) {
+            return context.memoryService.linkMemoriesBulk(relationships);
+        }
+        return 0;
+    }
+    catch (error) {
+        console.error('Explicit relationship creation failed:', error);
+        return 0;
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/store-memory/executor.js.map

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

package/dist/tools/store-memory/index.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '../../types/tools.js';
+export declare const storeMemoryTool: Tool;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/store-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/store-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,eAAO,MAAM,eAAe,EAAE,IAgE7B,CAAC"}

package/dist/tools/store-memory/index.js

@@ -0,0 +1,68 @@
+import { execute } from './executor.js';
+import { parseCliArgs } from './cli-parser.js';
+export const storeMemoryTool = {
+    definition: {
+        name: 'store-memory',
+        description: `Store a memory with optional tags and automatic relationship detection.
+
+🧠 AUTO-CAPTURE MODE: Use this tool proactively during conversations to capture important information WITHOUT waiting for explicit user requests.
+
+ALWAYS CAPTURE (automatically):
+✓ User preferences, opinions, likes/dislikes ("I prefer X", "I like Y")
+✓ Decisions made during conversation ("Let's go with option A")
+✓ Facts about people mentioned (names, roles, relationships)
+✓ Facts about projects or work (names, status, goals, technologies)
+✓ Learnings, insights, realizations ("I learned that...", "I discovered...")
+✓ Action items, commitments, TODOs ("I need to...", "Remember to...")
+✓ Technical knowledge or discoveries
+✓ User corrections or clarifications about past information
+
+NEVER CAPTURE (skip these):
+✗ Casual greetings, small talk, farewells
+✗ Temporary information (current weather, time, date)
+✗ Purely transactional exchanges
+✗ Simple questions or clarifications
+✗ Sensitive personal data (unless explicitly requested by user)
+
+BEHAVIOR:
+• Store SILENTLY - don't announce "I've saved that to memory"
+• Use clear, descriptive tags for easy retrieval (e.g., "preferences", "decisions", "project-name")
+• Link related memories using autoLink or relateTo parameters
+• Be thoughtful about long-term value - not everything needs storage
+
+EXAMPLE:
+User: "I really prefer TypeScript over JavaScript for its type safety"
+You: [Continue conversation naturally about TypeScript...]
+Background action: store-memory("User prefers TypeScript over JavaScript for type safety", tags: ["preferences", "typescript", "javascript"])`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The content to store in memory'
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional tags to associate with this memory',
+                    default: []
+                },
+                autoLink: {
+                    type: 'boolean',
+                    description: 'Automatically create relationships with similar memories (default: true)',
+                    default: true
+                },
+                relateTo: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags to explicitly link this memory to existing memories with matching tags',
+                    default: []
+                }
+            },
+            required: ['content']
+        }
+    },
+    handler: execute,
+    cliParser: parseCliArgs
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/store-memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/store-memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,UAAU,EAAE;QACV,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8IA8B6H;QAC1I,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,6CAA6C;oBAC1D,OAAO,EAAE,EAAE;iBACZ;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,0EAA0E;oBACvF,OAAO,EAAE,IAAI;iBACd;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,6EAA6E;oBAC1F,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,YAAY;CACxB,CAAC"}

package/dist/tools/sync-memory/cli-parser.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=cli-parser.d.ts.map

package/dist/tools/sync-memory/cli-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.d.ts","sourceRoot":"","sources":["../../../src/tools/sync-memory/cli-parser.ts"],"names":[],"mappings":""}

package/dist/tools/sync-memory/cli-parser.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=cli-parser.js.map

package/dist/tools/sync-memory/cli-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.js","sourceRoot":"","sources":["../../../src/tools/sync-memory/cli-parser.ts"],"names":[],"mappings":""}

package/dist/tools/sync-memory/executor.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/sync-memory/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/sync-memory/executor.ts"],"names":[],"mappings":""}

package/dist/tools/sync-memory/executor.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=executor.js.map

package/dist/tools/sync-memory/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/sync-memory/executor.ts"],"names":[],"mappings":""}

package/dist/tools/sync-memory/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/sync-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/sync-memory/index.ts"],"names":[],"mappings":""}

package/dist/tools/sync-memory/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/tools/sync-memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/sync-memory/index.ts"],"names":[],"mappings":""}

package/dist/tools/update-memory/cli-parser.d.ts

@@ -0,0 +1,2 @@
+export declare function parseCliArgs(args: string[]): any;
+//# sourceMappingURL=cli-parser.d.ts.map

package/dist/tools/update-memory/cli-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.d.ts","sourceRoot":"","sources":["../../../src/tools/update-memory/cli-parser.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAgB1C"}

package/dist/tools/update-memory/cli-parser.js

@@ -0,0 +1,17 @@
+import { parseCommandLineArgs } from '../../utils/cli-parser.js';
+export function parseCliArgs(args) {
+    // PHASE 1: Convert string array to object (shared utility)
+    const rawArgs = parseCommandLineArgs(args);
+    // PHASE 2: Validate and transform (command-specific logic)
+    const result = {};
+    if (rawArgs.hash)
+        result.hash = rawArgs.hash;
+    if (rawArgs.content)
+        result.content = rawArgs.content;
+    // Tags are optional - if provided, they replace existing tags
+    if (rawArgs.tags) {
+        result.tags = rawArgs.tags.split(',').map((tag) => tag.trim());
+    }
+    return result;
+}
+//# sourceMappingURL=cli-parser.js.map

package/dist/tools/update-memory/cli-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.js","sourceRoot":"","sources":["../../../src/tools/update-memory/cli-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,2DAA2D;IAC3D,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE3C,2DAA2D;IAC3D,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7C,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEtD,8DAA8D;IAC9D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,GAAI,OAAO,CAAC,IAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/update-memory/executor.d.ts

@@ -0,0 +1,16 @@
+import type { ToolContext } from '../../types/tools.js';
+interface UpdateMemoryArgs {
+    hash: string;
+    content: string;
+    tags?: string[];
+}
+interface UpdateMemoryResult {
+    success: boolean;
+    oldHash?: string;
+    newHash?: string;
+    message: string;
+    tagsUpdated?: boolean;
+}
+export declare function execute(args: UpdateMemoryArgs, context: ToolContext): Promise<UpdateMemoryResult>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/update-memory/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8DvG"}

package/dist/tools/update-memory/executor.js

@@ -0,0 +1,59 @@
+import { debugLog, formatHash } from '../../utils/debug.js';
+export async function execute(args, context) {
+    try {
+        // Validate inputs
+        if (!args.hash || args.hash.trim().length === 0) {
+            throw new Error('Hash cannot be empty');
+        }
+        if (!args.content || args.content.trim().length === 0) {
+            throw new Error('Content cannot be empty');
+        }
+        // Log content size for large memories
+        const contentSize = args.content.length;
+        if (contentSize > 100000) {
+            debugLog(`Updating with large content: ${contentSize} characters`);
+        }
+        // Check if memory exists before updating
+        const existing = context.memoryService.getByHash(args.hash);
+        if (!existing) {
+            return {
+                success: false,
+                message: `Memory not found with hash: ${formatHash(args.hash)}...`
+            };
+        }
+        // Perform the update
+        const newHash = context.memoryService.update(args.hash, args.content, args.tags);
+        if (!newHash) {
+            return {
+                success: false,
+                message: `Failed to update memory with hash: ${formatHash(args.hash)}...`
+            };
+        }
+        const hashChanged = newHash !== args.hash;
+        const tagsUpdated = args.tags !== undefined;
+        let message = `Memory updated successfully.`;
+        if (hashChanged) {
+            message += ` New hash: ${formatHash(newHash)}...`;
+        }
+        else {
+            message += ` Hash unchanged: ${formatHash(newHash)}...`;
+        }
+        if (tagsUpdated) {
+            message += ` (tags updated)`;
+        }
+        return {
+            success: true,
+            oldHash: args.hash,
+            newHash,
+            message,
+            tagsUpdated
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to update memory: ${error instanceof Error ? error.message : 'Unknown error'}`
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/update-memory/executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgB5D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAsB,EAAE,OAAoB;IACxE,IAAI,CAAC;QACH,kBAAkB;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,sCAAsC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACxC,IAAI,WAAW,GAAG,MAAM,EAAE,CAAC;YACzB,QAAQ,CAAC,gCAAgC,WAAW,aAAa,CAAC,CAAC;QACrE,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,+BAA+B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;aACnE,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,sCAAsC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;aAC1E,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;QAE5C,IAAI,OAAO,GAAG,8BAA8B,CAAC;QAC7C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,cAAc,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,oBAAoB,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1D,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,iBAAiB,CAAC;QAC/B,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,OAAO;YACP,OAAO;YACP,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;SAChG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/update-memory/index.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '../../types/tools.js';
+export declare const updateMemoryTool: Tool;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/update-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,eAAO,MAAM,gBAAgB,EAAE,IA0B9B,CAAC"}

package/dist/tools/update-memory/index.js

@@ -0,0 +1,30 @@
+import { execute } from './executor.js';
+import { parseCliArgs } from './cli-parser.js';
+export const updateMemoryTool = {
+    definition: {
+        name: 'update-memory',
+        description: 'Update an existing memory with new content and/or tags. The hash will change if content changes. If tags are provided, they replace all existing tags; if omitted, existing tags are preserved.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                hash: {
+                    type: 'string',
+                    description: 'The hash of the memory to update'
+                },
+                content: {
+                    type: 'string',
+                    description: 'The new content for the memory'
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New tags to replace existing tags (optional - if omitted, existing tags are preserved)'
+                }
+            },
+            required: ['hash', 'content']
+        }
+    },
+    handler: execute,
+    cliParser: parseCliArgs
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/update-memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iMAAiM;QAC9M,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,wFAAwF;iBACtG;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC9B;KACF;IACD,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,YAAY;CACxB,CAAC"}

package/dist/transports/streamable-http.d.ts

@@ -0,0 +1,38 @@
+/**
+ * StreamableHTTPServerTransport - MCP transport over HTTP
+ *
+ * Implements the MCP Server transport interface using HTTP instead of stdio.
+ * Properly handles the async nature of MCP over synchronous HTTP.
+ */
+import { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+interface HTTPTransportOptions {
+    port?: number;
+    host?: string;
+    timeout?: number;
+}
+export declare class StreamableHTTPServerTransport {
+    private port;
+    private host;
+    private timeout;
+    private httpServer;
+    private pendingResponses;
+    onmessage?: (message: JSONRPCMessage) => void;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    constructor(options?: HTTPTransportOptions);
+    start(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Send a message (response) back to the waiting HTTP request
+     */
+    send(message: JSONRPCMessage): Promise<void>;
+    private handleRequest;
+    private handleMCPRequest;
+    private waitForResponse;
+    private readBody;
+    private parseRequest;
+    private sendJSON;
+    private sendError;
+}
+export default StreamableHTTPServerTransport;
+//# sourceMappingURL=streamable-http.d.ts.map

package/dist/transports/streamable-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http.d.ts","sourceRoot":"","sources":["../../src/transports/streamable-http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,6BAA6B;IACxC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAa;IAG/B,OAAO,CAAC,gBAAgB,CAGnB;IAGL,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;gBAErB,OAAO,GAAE,oBAAyB;IAMxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBpC,aAAa;YA6Bb,gBAAgB;YAiChB,eAAe;YAiCf,QAAQ;IAmBtB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,SAAS;CAOlB;AAED,eAAe,6BAA6B,CAAC"}