@amodalai/runtime 0.3.16 → 0.3.18

package/dist/src/session/session-builder.test.js

@@ -18,6 +18,7 @@
  */
 import { describe, it, expect, vi } from 'vitest';
 import { buildSessionComponents, PRESENT_TOOL_NAME, STOP_EXECUTION_TOOL_NAME } from './session-builder.js';
+import { MEMORY_TOOL_NAME } from '../tools/memory-tool.js';
 import { createLogger } from '../logger.js';
 const logger = createLogger({ component: 'test:session-builder' });
 // ---------------------------------------------------------------------------
@@ -309,6 +310,86 @@ describe('buildSessionComponents', () => {
             expect(result).toEqual({ widget: 'entity-card', data: { name: 'Test' }, rendered: true });
         });
     });
+    describe('agent memory', () => {
+        function makeMemoryBundle(memoryConfig) {
+            return makeBundle({
+                config: {
+                    name: 'test-agent',
+                    version: '1.0.0',
+                    description: 'A test agent',
+                    models: { main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' } },
+                    memory: memoryConfig,
+                },
+            });
+        }
+        // Minimal mock db — just needs to exist for tool registration
+        const mockMemoryDb = {};
+        it('registers update_memory when memory enabled and editableBy is any', () => {
+            const bundle = makeMemoryBundle({ enabled: true, editableBy: 'any' });
+            const components = buildSessionComponents(makeOpts({ bundle, memoryDb: mockMemoryDb }));
+            expect(components.toolRegistry.names()).toContain(MEMORY_TOOL_NAME);
+        });
+        it('registers update_memory when memory enabled with default editableBy', () => {
+            const bundle = makeMemoryBundle({ enabled: true });
+            const components = buildSessionComponents(makeOpts({ bundle, memoryDb: mockMemoryDb }));
+            expect(components.toolRegistry.names()).toContain(MEMORY_TOOL_NAME);
+        });
+        it('does NOT register update_memory when editableBy is none', () => {
+            const bundle = makeMemoryBundle({ enabled: true, editableBy: 'none' });
+            const components = buildSessionComponents(makeOpts({ bundle, memoryDb: mockMemoryDb }));
+            expect(components.toolRegistry.names()).not.toContain(MEMORY_TOOL_NAME);
+        });
+        it('does NOT register update_memory when editableBy is admin and session is not admin', () => {
+            const bundle = makeMemoryBundle({ enabled: true, editableBy: 'admin' });
+            const components = buildSessionComponents(makeOpts({ bundle, memoryDb: mockMemoryDb }));
+            expect(components.toolRegistry.names()).not.toContain(MEMORY_TOOL_NAME);
+        });
+        it('registers update_memory when editableBy is admin and session is admin', () => {
+            const bundle = makeMemoryBundle({ enabled: true, editableBy: 'admin' });
+            const components = buildSessionComponents(makeOpts({
+                bundle,
+                memoryDb: mockMemoryDb,
+                sessionType: 'admin',
+            }));
+            expect(components.toolRegistry.names()).toContain(MEMORY_TOOL_NAME);
+        });
+        it('does NOT register update_memory when memory not enabled', () => {
+            const bundle = makeMemoryBundle({ enabled: false });
+            const components = buildSessionComponents(makeOpts({ bundle, memoryDb: mockMemoryDb }));
+            expect(components.toolRegistry.names()).not.toContain(MEMORY_TOOL_NAME);
+        });
+        it('does NOT register update_memory when no memoryDb provided', () => {
+            const bundle = makeMemoryBundle({ enabled: true });
+            const components = buildSessionComponents(makeOpts({ bundle }));
+            expect(components.toolRegistry.names()).not.toContain(MEMORY_TOOL_NAME);
+        });
+        it('includes memory content in system prompt when provided', () => {
+            const bundle = makeMemoryBundle({ enabled: true });
+            const components = buildSessionComponents(makeOpts({
+                bundle,
+                memoryDb: mockMemoryDb,
+                memoryContent: 'User prefers dark mode.',
+            }));
+            expect(components.systemPrompt).toContain('User prefers dark mode.');
+        });
+        it('includes memory instructions when memory is editable', () => {
+            const bundle = makeMemoryBundle({ enabled: true });
+            const components = buildSessionComponents(makeOpts({
+                bundle,
+                memoryDb: mockMemoryDb,
+            }));
+            expect(components.systemPrompt).toContain('## Memory Instructions');
+            expect(components.systemPrompt).toContain('memory tool');
+        });
+        it('does NOT include memory instructions when editableBy is none', () => {
+            const bundle = makeMemoryBundle({ enabled: true, editableBy: 'none' });
+            const components = buildSessionComponents(makeOpts({
+                bundle,
+                memoryDb: mockMemoryDb,
+            }));
+            expect(components.systemPrompt).not.toContain('## Memory Instructions');
+        });
+    });
     describe('tool context factory', () => {
         it('factory produces ToolContext with correct session info', () => {
             const components = buildSessionComponents(makeOpts({

package/dist/src/session/session-builder.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-builder.test.js","sourceRoot":"","sources":["../../../src/session/session-builder.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAC,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAC,sBAAsB,EAAE,iBAAiB,EAAE,wBAAwB,EAAC,MAAM,sBAAsB,CAAC;AAIzG,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,GAAG,YAAY,CAAC,EAAC,SAAS,EAAE,sBAAsB,EAAC,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,gEAAgE;AAChE,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAyC,EAAE,EAAE,CAAC,CAAC;QACpE,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACzD,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;KACjE,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO;QACL,IAAI;QACJ,IAAI,EAAE;YACJ,QAAQ,EAAE,MAAe;YACzB,OAAO,EAAE,eAAe,IAAI,MAAM;YAClC,IAAI,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAC;SAC7C;QACD,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,YAAY,EAAE,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAC;gBACvC,aAAa,EAAE,EAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAC;aAChD;SACF;QACD,OAAO,EAAE;YACP,EAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAC;YAC1E,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAC;SAC7E;QACD,QAAQ,EAAE,gBAAgB;QAC1B,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,mBAAmB,GAAG,IAAI;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,qBAAqB;YAC1B,MAAM,EAAE;gBACN,OAAO,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC;gBACzB,OAAO,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC;gBACzB,MAAM,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC;aACzB;SACF;QACD,QAAQ,EAAE,mBAAmB;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,yBAAyB;QACtC,OAAO,EAAE,8BAA8B;QACvC,IAAI,EAAE,2CAA2C;QACjD,QAAQ,EAAE,4BAA4B;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,6BAA6B;QACnC,QAAQ,EAAE,4BAA4B;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc;IACrB,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,cAAc;QAC3B,UAAU,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAC,KAAK,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC,EAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAC;QACxF,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,CAAC,gBAAgB,CAAC;QACvB,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE,oBAAoB;QAC9B,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;QACrB,kBAAkB,EAAE,KAAK;QACzB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,YAAY;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,SAAgC;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IACxD,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEpD,OAAO;QACL,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,cAAc;YAC3B,MAAM,EAAE;gBACN,IAAI,EAAE,EAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,0BAA0B,EAAC;aACjE;SACF;QACD,WAAW;QACX,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAC;QAC3D,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;QACrB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO;QACL,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAC,OAAO,EAAE,CAAC,EAAC,CAAC;QAC5C,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;QACZ,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;QACf,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;QAChB,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;QACnB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,SAAkD;IAClE,OAAO;QACL,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,gBAAgB,EAAE;QAChC,UAAU,EAAE,IAAI;QAChB,MAAM;QACN,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEtD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC/D,oDAAoD;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAE9C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,EAAC,WAAW,EAAE,IAAI,GAAG,EAAE,EAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,MAAM,GAAG,UAAU,CAAC,EAAC,KAAK,EAAE,CAAC,cAAc,EAAE,CAAC,EAAC,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,EAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAC,CAAC;YACpC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAC,CAAC,CAAC,CAAC;YAEtF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,MAAM,MAAM,GAAG,UAAU,CAAC,EAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,EAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAC,CAAC;YACpC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAC,CAAC,CAAC,CAAC;YAEtF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,MAAM,GAAG,UAAU,CAAC,EAAC,KAAK,EAAE,CAAC,cAAc,EAAE,CAAC,EAAC,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC;YAE9D,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,UAAU,GAAG;gBACjB,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;oBAC1C;wBACE,IAAI,EAAE,mBAAmB;wBACzB,WAAW,EAAE,QAAQ;wBACrB,UAAU,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAC;wBAC5C,UAAU,EAAE,YAAY;wBACxB,YAAY,EAAE,OAAO;qBACtB;iBACF,CAAC;gBACF,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;aAClB,CAAC;YACF,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAC,UAAU,EAAE,UAAmB,EAAC,CAAC,CAAC,CAAC;YAEvF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,YAAY,GAAsB;gBACtC,WAAW,EAAE,0BAA0B;gBACvC,MAAM,EAAE,CAAC,EAAC,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC;gBACrH,SAAS,EAAE,CAAC,EAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC;aACzG,CAAC;YAEF,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC;gBACjD,WAAW,EAAE,OAAO;gBACpB,YAAY;aACb,CAAC,CAAC,CAAC;YAEJ,uCAAuC;YACvC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YAChE,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC9D,gCAAgC;YAChC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC;gBACjD,WAAW,EAAE,EAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAC;aACnD,CAAC,CAAC,CAAC;YAEJ,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YACjC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAE3B,MAAM,MAAM,GAAG,MAAM,IAAK,CAAC,OAAO,CAChC,EAAC,MAAM,EAAE,eAAe,EAAC,EACzB,EAAW,CACZ,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAC,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAE3B,MAAM,MAAM,GAAG,MAAM,IAAK,CAAC,OAAO,CAChC,EAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,EAAC,IAAI,EAAE,MAAM,EAAC,EAAC,EAC7C,EAAW,CACZ,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,EAAC,IAAI,EAAE,MAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC;gBACjD,SAAS,EAAE,UAAU;aACtB,CAAC,CAAC,CAAC;YAEJ,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"session-builder.test.js","sourceRoot":"","sources":["../../../src/session/session-builder.test.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/memory-tool.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
+import type { ToolDefinition } from './types.js';
+import type { Logger } from '../logger.js';
+export declare const MEMORY_TOOL_NAME = "memory";
+export declare const UPDATE_MEMORY_TOOL_NAME = "memory";
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    category: string | null;
+    createdAt: Date;
+}
+/**
+ * Load all memory entries for an appId, ordered by creation time.
+ * Returns an empty array if no entries exist.
+ */
+export declare function loadMemoryEntries(db: NodePgDatabase<Record<string, unknown>>, appId: string): Promise<MemoryEntry[]>;
+/**
+ * Format memory entries as a string for system prompt injection.
+ * Returns empty string if no entries.
+ */
+export declare function formatMemoryForPrompt(entries: MemoryEntry[]): string;
+export declare function loadMemoryContent(db: NodePgDatabase<Record<string, unknown>>, appId?: string): Promise<string>;
+export interface CreateMemoryToolOptions {
+    db: NodePgDatabase<Record<string, unknown>>;
+    logger: Logger;
+    appId: string;
+    maxEntries?: number;
+    maxTotalChars?: number;
+}
+/**
+ * Create the memory tool definition with add/remove/list/search actions.
+ */
+export declare function createMemoryTool(opts: CreateMemoryToolOptions): ToolDefinition;

package/dist/src/tools/memory-tool.js

@@ -0,0 +1,258 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Built-in memory tool — per-instance persistent memory with entry-level operations.
+ *
+ * Supports add, remove, list, and search actions. Each memory entry is stored
+ * as a separate row in the agent_memory_entries table, scoped by appId.
+ */
+import { z } from 'zod';
+import { eq, and, sql } from 'drizzle-orm';
+import { agentMemoryEntries } from '@amodalai/db';
+import { StoreError } from '../errors.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const MEMORY_TOOL_NAME = 'memory';
+/** Timeout for memory database operations. */
+const MEMORY_DB_TIMEOUT_MS = 5_000;
+// Keep the old name for backward compat during migration
+export const UPDATE_MEMORY_TOOL_NAME = MEMORY_TOOL_NAME;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Race a promise against a timeout signal so a hung DB doesn't block forever. */
+function withDbTimeout(promise, label) {
+    const signal = AbortSignal.timeout(MEMORY_DB_TIMEOUT_MS);
+    return new Promise((resolve, reject) => {
+        signal.addEventListener('abort', () => {
+            reject(new StoreError(`Memory DB operation timed out: ${label}`, {
+                store: 'agent_memory_entries',
+                operation: label,
+                context: { timeoutMs: MEMORY_DB_TIMEOUT_MS },
+            }));
+        });
+        promise.then(resolve, reject);
+    });
+}
+// ---------------------------------------------------------------------------
+// Memory read helper (used by session builder to inject into prompt)
+// ---------------------------------------------------------------------------
+/**
+ * Load all memory entries for an appId, ordered by creation time.
+ * Returns an empty array if no entries exist.
+ */
+export async function loadMemoryEntries(db, appId) {
+    const rows = await withDbTimeout(db
+        .select({
+        id: agentMemoryEntries.id,
+        content: agentMemoryEntries.content,
+        category: agentMemoryEntries.category,
+        createdAt: agentMemoryEntries.createdAt,
+    })
+        .from(agentMemoryEntries)
+        .where(eq(agentMemoryEntries.appId, appId))
+        .orderBy(agentMemoryEntries.createdAt), 'load_entries');
+    return rows;
+}
+/**
+ * Format memory entries as a string for system prompt injection.
+ * Returns empty string if no entries.
+ */
+export function formatMemoryForPrompt(entries) {
+    if (entries.length === 0)
+        return '';
+    return entries
+        .map((e, i) => `${String(i + 1)}. ${e.content} [id: ${e.id.slice(0, 8)}]`)
+        .join('\n');
+}
+// Backward-compat: loadMemoryContent that returns a string (used by Phase 1 callers)
+export async function loadMemoryContent(db, appId = 'local') {
+    const entries = await loadMemoryEntries(db, appId);
+    return formatMemoryForPrompt(entries);
+}
+/**
+ * Create the memory tool definition with add/remove/list/search actions.
+ */
+export function createMemoryTool(opts) {
+    const { db, logger, appId, maxEntries = 50, maxTotalChars = 8000 } = opts;
+    return {
+        description: 'Manage persistent memory. Use "add" to save a fact, "remove" to delete by ID, ' +
+            '"list" to see all entries, "search" to find entries by keyword.',
+        parameters: z.object({
+            action: z.enum(['add', 'remove', 'list', 'search']).describe('The action to perform on memory.'),
+            content: z.string().optional().describe('The memory content to save. Required for "add".'),
+            entry_id: z.string().optional().describe('The entry ID to remove. Required for "remove". Use the short ID shown in brackets.'),
+            query: z.string().optional().describe('Search query for finding entries. Required for "search".'),
+        }),
+        readOnly: false,
+        metadata: { category: 'system' },
+        async execute(params, _ctx) {
+            const startMs = Date.now();
+            try {
+                switch (params.action) {
+                    case 'add':
+                        return await handleAdd(db, logger, appId, params.content, maxEntries, maxTotalChars, startMs);
+                    case 'remove':
+                        return await handleRemove(db, logger, appId, params.entry_id, startMs);
+                    case 'list':
+                        return await handleList(db, logger, appId, startMs);
+                    case 'search':
+                        return await handleSearch(db, logger, appId, params.query, startMs);
+                    default:
+                        throw new StoreError(`Unknown memory action: ${params.action}`, {
+                            store: 'agent_memory_entries',
+                            operation: 'unknown',
+                            context: { action: params.action },
+                        });
+                }
+            }
+            catch (err) {
+                if (err instanceof StoreError)
+                    throw err;
+                const durationMs = Date.now() - startMs;
+                logger.error('memory_operation_failed', {
+                    action: params.action,
+                    durationMs,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                throw new StoreError(`Memory ${params.action} failed`, {
+                    store: 'agent_memory_entries',
+                    operation: params.action,
+                    cause: err,
+                    context: { appId },
+                });
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Action handlers
+// ---------------------------------------------------------------------------
+async function handleAdd(db, logger, appId, content, maxEntries, maxTotalChars, startMs) {
+    if (!content || content.trim().length === 0) {
+        throw new StoreError('Content is required for add action', {
+            store: 'agent_memory_entries',
+            operation: 'add',
+            context: { appId },
+        });
+    }
+    // Check budget
+    const existing = await withDbTimeout(db
+        .select({
+        id: agentMemoryEntries.id,
+        content: agentMemoryEntries.content,
+    })
+        .from(agentMemoryEntries)
+        .where(eq(agentMemoryEntries.appId, appId)), 'budget_check');
+    if (existing.length >= maxEntries) {
+        return {
+            error: 'budget_exceeded',
+            message: `Memory is full (${String(existing.length)}/${String(maxEntries)} entries). Remove stale entries before adding new ones.`,
+            entries: existing.length,
+            maxEntries,
+        };
+    }
+    const totalChars = existing.reduce((sum, e) => sum + e.content.length, 0);
+    if (totalChars + content.length > maxTotalChars) {
+        return {
+            error: 'budget_exceeded',
+            message: `Memory content budget exceeded (${String(totalChars + content.length)}/${String(maxTotalChars)} chars). Remove stale entries before adding new ones.`,
+            currentChars: totalChars,
+            maxTotalChars,
+        };
+    }
+    // Insert
+    const [inserted] = await withDbTimeout(db
+        .insert(agentMemoryEntries)
+        .values({ appId, content: content.trim() })
+        .returning({
+        id: agentMemoryEntries.id,
+        content: agentMemoryEntries.content,
+        createdAt: agentMemoryEntries.createdAt,
+    }), 'add');
+    const durationMs = Date.now() - startMs;
+    logger.info('memory_entry_added', { appId, entryId: inserted.id, contentLength: content.length, durationMs });
+    // Return the full updated list so the LLM has mid-session visibility
+    const allEntries = await loadMemoryEntries(db, appId);
+    return {
+        added: { id: inserted.id, content: inserted.content },
+        entries: allEntries.map((e, i) => ({ index: i + 1, id: e.id.slice(0, 8), content: e.content })),
+        totalEntries: allEntries.length,
+    };
+}
+async function handleRemove(db, logger, appId, entryId, startMs) {
+    if (!entryId || entryId.trim().length === 0) {
+        throw new StoreError('entry_id is required for remove action', {
+            store: 'agent_memory_entries',
+            operation: 'remove',
+            context: { appId },
+        });
+    }
+    // Support both short IDs (first 8 chars) and full UUIDs
+    const idPattern = entryId.trim();
+    const deleted = await withDbTimeout(db
+        .delete(agentMemoryEntries)
+        .where(and(eq(agentMemoryEntries.appId, appId), sql `${agentMemoryEntries.id}::text LIKE ${idPattern + '%'}`))
+        .returning({ id: agentMemoryEntries.id, content: agentMemoryEntries.content }), 'remove');
+    const durationMs = Date.now() - startMs;
+    if (deleted.length === 0) {
+        logger.info('memory_entry_not_found', { appId, entryId: idPattern, durationMs });
+        return { removed: false, message: `No entry found matching ID "${idPattern}".` };
+    }
+    logger.info('memory_entry_removed', { appId, entryId: deleted[0].id, durationMs });
+    const allEntries = await loadMemoryEntries(db, appId);
+    return {
+        removed: true,
+        deletedEntry: { id: deleted[0].id, content: deleted[0].content },
+        entries: allEntries.map((e, i) => ({ index: i + 1, id: e.id.slice(0, 8), content: e.content })),
+        totalEntries: allEntries.length,
+    };
+}
+async function handleList(db, logger, appId, startMs) {
+    const entries = await loadMemoryEntries(db, appId);
+    const durationMs = Date.now() - startMs;
+    logger.info('memory_listed', { appId, entryCount: entries.length, durationMs });
+    if (entries.length === 0) {
+        return { entries: [], message: 'No memories saved yet.' };
+    }
+    return {
+        entries: entries.map((e, i) => ({ index: i + 1, id: e.id.slice(0, 8), content: e.content, category: e.category })),
+        totalEntries: entries.length,
+    };
+}
+async function handleSearch(db, logger, appId, query, startMs) {
+    if (!query || query.trim().length === 0) {
+        throw new StoreError('query is required for search action', {
+            store: 'agent_memory_entries',
+            operation: 'search',
+            context: { appId },
+        });
+    }
+    // Use plainto_tsquery for safe user input (no syntax errors from special chars)
+    const results = await withDbTimeout(db
+        .select({
+        id: agentMemoryEntries.id,
+        content: agentMemoryEntries.content,
+        category: agentMemoryEntries.category,
+        createdAt: agentMemoryEntries.createdAt,
+        rank: sql `ts_rank(to_tsvector('english', ${agentMemoryEntries.content}), plainto_tsquery('english', ${query.trim()}))`,
+    })
+        .from(agentMemoryEntries)
+        .where(and(eq(agentMemoryEntries.appId, appId), sql `to_tsvector('english', ${agentMemoryEntries.content}) @@ plainto_tsquery('english', ${query.trim()})`))
+        .orderBy(sql `ts_rank(to_tsvector('english', ${agentMemoryEntries.content}), plainto_tsquery('english', ${query.trim()})) DESC`)
+        .limit(10), 'search');
+    const durationMs = Date.now() - startMs;
+    logger.info('memory_searched', { appId, query: query.trim(), resultCount: results.length, durationMs });
+    if (results.length === 0) {
+        return { results: [], message: `No memories found matching "${query.trim()}".` };
+    }
+    return {
+        results: results.map((r) => ({ id: r.id.slice(0, 8), content: r.content, category: r.category })),
+        totalResults: results.length,
+    };
+}
+//# sourceMappingURL=memory-tool.js.map

package/dist/src/tools/memory-tool.js.map

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

package/dist/src/tools/memory-tool.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/tools/memory-tool.test.js

@@ -0,0 +1,155 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Tests for the memory tool with entry-level operations.
+ *
+ * Covers:
+ * 1. formatMemoryForPrompt — renders entries as numbered list
+ * 2. createMemoryTool — tool metadata, validation errors for each action
+ * 3. Integration tests for add/remove/list/search run in the smoke test (requires Postgres)
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { formatMemoryForPrompt, createMemoryTool, MEMORY_TOOL_NAME, UPDATE_MEMORY_TOOL_NAME, } from './memory-tool.js';
+import { StoreError } from '../errors.js';
+// ---------------------------------------------------------------------------
+// Mocks
+// ---------------------------------------------------------------------------
+function createMockLogger() {
+    return {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+        child: vi.fn(),
+    };
+}
+// Minimal mock that throws on any DB operation — used to test validation-only paths
+function createThrowingDb() {
+    const thrower = () => { throw new Error('unexpected DB call'); };
+    return {
+        select: thrower,
+        insert: thrower,
+        delete: thrower,
+    };
+}
+const mockCtx = {
+    request: vi.fn(),
+    store: vi.fn(),
+    env: vi.fn(),
+    log: vi.fn(),
+    signal: AbortSignal.timeout(5000),
+    sessionId: 'test-session',
+};
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('MEMORY_TOOL_NAME', () => {
+    it('is "memory"', () => {
+        expect(MEMORY_TOOL_NAME).toBe('memory');
+    });
+    it('UPDATE_MEMORY_TOOL_NAME is backward-compat alias', () => {
+        expect(UPDATE_MEMORY_TOOL_NAME).toBe(MEMORY_TOOL_NAME);
+    });
+});
+describe('formatMemoryForPrompt', () => {
+    it('formats entries as numbered list with short IDs', () => {
+        const entries = [
+            { id: 'abcdef12-3456-7890-abcd-ef1234567890', content: 'User prefers dark mode', category: null, createdAt: new Date() },
+            { id: '12345678-abcd-ef12-3456-7890abcdef12', content: 'User is a dentist', category: null, createdAt: new Date() },
+        ];
+        const result = formatMemoryForPrompt(entries);
+        expect(result).toBe('1. User prefers dark mode [id: abcdef12]\n' +
+            '2. User is a dentist [id: 12345678]');
+    });
+    it('returns empty string for empty entries', () => {
+        expect(formatMemoryForPrompt([])).toBe('');
+    });
+    it('handles single entry', () => {
+        const entries = [
+            { id: 'aaa11111-2222-3333-4444-555566667777', content: 'Likes TypeScript', category: null, createdAt: new Date() },
+        ];
+        expect(formatMemoryForPrompt(entries)).toBe('1. Likes TypeScript [id: aaa11111]');
+    });
+});
+describe('createMemoryTool', () => {
+    it('returns a tool definition with correct metadata', () => {
+        const tool = createMemoryTool({
+            db: createThrowingDb(),
+            logger: createMockLogger(),
+            appId: 'test',
+        });
+        expect(tool.description).toContain('persistent memory');
+        expect(tool.description).toContain('add');
+        expect(tool.description).toContain('remove');
+        expect(tool.description).toContain('list');
+        expect(tool.description).toContain('search');
+        expect(tool.readOnly).toBe(false);
+        expect(tool.metadata).toEqual({ category: 'system' });
+    });
+    describe('add action — validation', () => {
+        it('rejects empty content', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'add', content: '' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+        it('rejects missing content', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'add' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+        it('rejects whitespace-only content', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'add', content: '   ' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+    });
+    describe('remove action — validation', () => {
+        it('rejects missing entry_id', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'remove' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+        it('rejects empty entry_id', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'remove', entry_id: '' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+    });
+    describe('search action — validation', () => {
+        it('rejects empty query', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'search', query: '' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+        it('rejects missing query', async () => {
+            const tool = createMemoryTool({
+                db: createThrowingDb(),
+                logger: createMockLogger(),
+                appId: 'test',
+            });
+            await expect(tool.execute({ action: 'search' }, mockCtx)).rejects.toThrow(StoreError);
+        });
+    });
+});
+//# sourceMappingURL=memory-tool.test.js.map

package/dist/src/tools/memory-tool.test.js.map

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