@researchcomputer/agents-sdk 0.1.0

package/dist/mcp/client.js.map

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

package/dist/mcp/schema-convert.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaConversionResult } from '../types.js';
+export declare function jsonSchemaToTypeBox(jsonSchema: Record<string, any>): SchemaConversionResult;
+//# sourceMappingURL=schema-convert.d.ts.map

package/dist/mcp/schema-convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-convert.d.ts","sourceRoot":"","sources":["../../src/mcp/schema-convert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,sBAAsB,CAQ3F"}

package/dist/mcp/schema-convert.js

@@ -0,0 +1,73 @@
+import { Type } from '@sinclair/typebox';
+export function jsonSchemaToTypeBox(jsonSchema) {
+    const warnings = [];
+    const schema = convert(jsonSchema, warnings);
+    return {
+        schema,
+        isExact: warnings.length === 0,
+        warnings,
+    };
+}
+function convert(schema, warnings) {
+    if (!schema || typeof schema !== 'object') {
+        warnings.push('Missing or invalid schema');
+        return Type.Any();
+    }
+    // Check for unsupported combinators
+    for (const key of ['oneOf', 'allOf', 'anyOf', '$ref']) {
+        if (key in schema) {
+            warnings.push(`Unsupported keyword: ${key}`);
+            return withDescription(Type.Any(), schema.description);
+        }
+    }
+    const type = schema.type;
+    // Implicit object: no type but has properties
+    if (!type && schema.properties) {
+        return convertObject(schema, warnings);
+    }
+    if (!type) {
+        warnings.push('Unknown or missing type');
+        return withDescription(Type.Any(), schema.description);
+    }
+    switch (type) {
+        case 'string':
+            if (schema.enum && Array.isArray(schema.enum)) {
+                return withDescription(Type.Union(schema.enum.map((v) => Type.Literal(v))), schema.description);
+            }
+            return withDescription(Type.String(), schema.description);
+        case 'number':
+        case 'integer':
+            return withDescription(Type.Number(), schema.description);
+        case 'boolean':
+            return withDescription(Type.Boolean(), schema.description);
+        case 'null':
+            return withDescription(Type.Null(), schema.description);
+        case 'array':
+            if (schema.items) {
+                return withDescription(Type.Array(convert(schema.items, warnings)), schema.description);
+            }
+            return withDescription(Type.Array(Type.Any()), schema.description);
+        case 'object':
+            return convertObject(schema, warnings);
+        default:
+            warnings.push(`Unknown type: ${type}`);
+            return withDescription(Type.Any(), schema.description);
+    }
+}
+function convertObject(schema, warnings) {
+    const properties = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const props = {};
+    for (const [key, value] of Object.entries(properties)) {
+        const converted = convert(value, warnings);
+        props[key] = required.has(key) ? converted : Type.Optional(converted);
+    }
+    return withDescription(Type.Object(props), schema.description);
+}
+function withDescription(schema, description) {
+    if (description) {
+        return { ...schema, description };
+    }
+    return schema;
+}
+//# sourceMappingURL=schema-convert.js.map

package/dist/mcp/schema-convert.js.map

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

package/dist/mcp/schema-convert.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-convert.test.d.ts.map

package/dist/mcp/schema-convert.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-convert.test.d.ts","sourceRoot":"","sources":["../../src/mcp/schema-convert.test.ts"],"names":[],"mappings":""}

package/dist/mcp/schema-convert.test.js

@@ -0,0 +1,95 @@
+import { describe, it, expect } from 'vitest';
+import { jsonSchemaToTypeBox } from './schema-convert.js';
+import { Value } from '@sinclair/typebox/value';
+describe('jsonSchemaToTypeBox', () => {
+    it('converts a simple object schema', () => {
+        const result = jsonSchemaToTypeBox({
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'The name' },
+                age: { type: 'number' },
+            },
+            required: ['name'],
+        });
+        expect(result.isExact).toBe(true);
+        expect(result.warnings).toHaveLength(0);
+        // Validate data against the converted schema
+        expect(Value.Check(result.schema, { name: 'Alice', age: 30 })).toBe(true);
+        expect(Value.Check(result.schema, { name: 'Bob' })).toBe(true);
+        expect(Value.Check(result.schema, { age: 30 })).toBe(false); // name is required
+    });
+    it('converts boolean and array types', () => {
+        const result = jsonSchemaToTypeBox({
+            type: 'object',
+            properties: {
+                active: { type: 'boolean' },
+                tags: { type: 'array', items: { type: 'string' } },
+            },
+        });
+        expect(result.isExact).toBe(true);
+        expect(Value.Check(result.schema, { active: true, tags: ['a', 'b'] })).toBe(true);
+        expect(Value.Check(result.schema, { tags: [123] })).toBe(false);
+    });
+    it('converts string enums', () => {
+        const result = jsonSchemaToTypeBox({
+            type: 'object',
+            properties: {
+                status: { type: 'string', enum: ['open', 'closed'] },
+            },
+            required: ['status'],
+        });
+        expect(result.isExact).toBe(true);
+        expect(Value.Check(result.schema, { status: 'open' })).toBe(true);
+        expect(Value.Check(result.schema, { status: 'invalid' })).toBe(false);
+    });
+    it('falls back to Any for unsupported keywords', () => {
+        const result = jsonSchemaToTypeBox({
+            type: 'object',
+            properties: {
+                data: { oneOf: [{ type: 'string' }, { type: 'number' }] },
+            },
+        });
+        expect(result.isExact).toBe(false);
+        expect(result.warnings.length).toBeGreaterThan(0);
+        expect(result.warnings[0]).toContain('oneOf');
+    });
+    it('handles empty schema', () => {
+        const result = jsonSchemaToTypeBox({});
+        expect(result.isExact).toBe(false);
+        expect(result.warnings.length).toBeGreaterThan(0);
+    });
+    it('handles null type', () => {
+        const result = jsonSchemaToTypeBox({ type: 'null' });
+        expect(result.isExact).toBe(true);
+        expect(Value.Check(result.schema, null)).toBe(true);
+    });
+    it('handles implicit object (no type but has properties)', () => {
+        const result = jsonSchemaToTypeBox({
+            properties: {
+                foo: { type: 'string' },
+            },
+            required: ['foo'],
+        });
+        expect(result.isExact).toBe(true);
+        expect(Value.Check(result.schema, { foo: 'bar' })).toBe(true);
+        expect(Value.Check(result.schema, {})).toBe(false);
+    });
+    it('preserves description in schema options', () => {
+        const result = jsonSchemaToTypeBox({
+            type: 'string',
+            description: 'A greeting message',
+        });
+        expect(result.schema.description).toBe('A greeting message');
+    });
+    it('handles integer type', () => {
+        const result = jsonSchemaToTypeBox({ type: 'integer' });
+        expect(result.isExact).toBe(true);
+        expect(Value.Check(result.schema, 42)).toBe(true);
+    });
+    it('falls back to Any for $ref', () => {
+        const result = jsonSchemaToTypeBox({ $ref: '#/definitions/Foo' });
+        expect(result.isExact).toBe(false);
+        expect(result.warnings[0]).toContain('$ref');
+    });
+});
+//# sourceMappingURL=schema-convert.test.js.map

package/dist/mcp/schema-convert.test.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,14 @@
+import type { SdkTool } from '../types.js';
+export interface McpToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, any>;
+}
+export type CallToolFn = (name: string, args: Record<string, unknown>) => Promise<{
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+}>;
+export declare function wrapMcpTool(serverName: string, mcpTool: McpToolDefinition, callTool: CallToolFn): SdkTool;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAEvI,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,UAAU,GACnB,OAAO,CAsBT"}

package/dist/mcp/tools.js

@@ -0,0 +1,23 @@
+import { jsonSchemaToTypeBox } from './schema-convert.js';
+export function wrapMcpTool(serverName, mcpTool, callTool) {
+    const { schema } = jsonSchemaToTypeBox(mcpTool.inputSchema ?? {});
+    return {
+        name: `mcp__${serverName}__${mcpTool.name}`,
+        label: `MCP: ${serverName}/${mcpTool.name}`,
+        description: mcpTool.description ?? `MCP tool: ${mcpTool.name}`,
+        parameters: schema,
+        capabilities: ['mcp:call'],
+        async execute(_toolCallId, args) {
+            const result = await callTool(mcpTool.name, (args ?? {}));
+            const text = result.content
+                .filter((c) => c.type === 'text' && c.text)
+                .map((c) => c.text)
+                .join('\n');
+            return {
+                content: [{ type: 'text', text: text || 'Tool executed successfully.' }],
+                details: {},
+            };
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAU1D,MAAM,UAAU,WAAW,CACzB,UAAkB,EAClB,OAA0B,EAC1B,QAAoB;IAEpB,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,QAAQ,UAAU,KAAK,OAAO,CAAC,IAAI,EAAE;QAC3C,KAAK,EAAE,QAAQ,UAAU,IAAI,OAAO,CAAC,IAAI,EAAE;QAC3C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,aAAa,OAAO,CAAC,IAAI,EAAE;QAC/D,UAAU,EAAE,MAAM;QAClB,YAAY,EAAE,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,IAAa;YAC9C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;YACrF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO;iBACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC;iBAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,IAAI,6BAA6B,EAAE,CAAC;gBACjF,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.test.d.ts.map

package/dist/mcp/tools.test.d.ts.map

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

package/dist/mcp/tools.test.js

@@ -0,0 +1,45 @@
+import { describe, it, expect, vi } from 'vitest';
+import { wrapMcpTool } from './tools.js';
+describe('wrapMcpTool', () => {
+    it('creates a tool with correct naming convention', () => {
+        const callTool = vi.fn();
+        const tool = wrapMcpTool('myserver', { name: 'doStuff', description: 'Does stuff' }, callTool);
+        expect(tool.name).toBe('mcp__myserver__doStuff');
+        expect(tool.description).toBe('Does stuff');
+        expect(tool.capabilities).toEqual(['mcp:call']);
+        expect(tool.label).toBe('MCP: myserver/doStuff');
+    });
+    it('calls callTool with the original tool name and args', async () => {
+        const callTool = vi.fn().mockResolvedValue({
+            content: [{ type: 'text', text: 'result here' }],
+        });
+        const tool = wrapMcpTool('srv', { name: 'myTool' }, callTool);
+        const result = await tool.execute('call-1', { key: 'value' });
+        expect(callTool).toHaveBeenCalledWith('myTool', { key: 'value' });
+        expect(result.content[0]).toEqual({ type: 'text', text: 'result here' });
+    });
+    it('handles empty content response', async () => {
+        const callTool = vi.fn().mockResolvedValue({ content: [] });
+        const tool = wrapMcpTool('srv', { name: 'empty' }, callTool);
+        const result = await tool.execute('call-2', {});
+        expect(result.content[0]).toEqual({ type: 'text', text: 'Tool executed successfully.' });
+    });
+    it('converts input schema to TypeBox parameters', () => {
+        const callTool = vi.fn();
+        const tool = wrapMcpTool('srv', {
+            name: 'typed',
+            inputSchema: {
+                type: 'object',
+                properties: { query: { type: 'string' } },
+                required: ['query'],
+            },
+        }, callTool);
+        expect(tool.parameters).toBeDefined();
+    });
+    it('provides default description when none given', () => {
+        const callTool = vi.fn();
+        const tool = wrapMcpTool('srv', { name: 'noDesc' }, callTool);
+        expect(tool.description).toBe('MCP tool: noDesc');
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/mcp/tools.test.js.map

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

package/dist/memory/memory.d.ts

@@ -0,0 +1,3 @@
+import type { MemoryManager } from '../types.js';
+export declare function createMemoryManager(): MemoryManager;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/memory/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAU,aAAa,EAAmB,MAAM,aAAa,CAAC;AAuC1E,wBAAgB,mBAAmB,IAAI,aAAa,CAkGnD"}

package/dist/memory/memory.js

@@ -0,0 +1,130 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+function parseMemoryFile(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return null;
+    const frontmatter = match[1];
+    const body = match[2].trim();
+    const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    const typeMatch = frontmatter.match(/^type:\s*(.+)$/m);
+    if (!nameMatch || !descMatch || !typeMatch)
+        return null;
+    return {
+        name: nameMatch[1].trim(),
+        description: descMatch[1].trim(),
+        type: typeMatch[1].trim(),
+        content: body,
+    };
+}
+function serializeMemory(memory) {
+    return `---\nname: ${memory.name}\ndescription: ${memory.description}\ntype: ${memory.type}\n---\n\n${memory.content}\n`;
+}
+function sanitizeFilename(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function tokenize(text) {
+    return text.toLowerCase().split(/\W+/).filter(t => t.length > 0);
+}
+export function createMemoryManager() {
+    return {
+        async load(dir) {
+            let entries;
+            try {
+                entries = await fs.readdir(dir);
+            }
+            catch {
+                return [];
+            }
+            const memories = [];
+            for (const entry of entries) {
+                if (!entry.endsWith('.md'))
+                    continue;
+                const content = await fs.readFile(path.join(dir, entry), 'utf-8');
+                const memory = parseMemoryFile(content);
+                if (memory)
+                    memories.push(memory);
+            }
+            return memories;
+        },
+        async save(dir, memory) {
+            await fs.mkdir(dir, { recursive: true });
+            const filename = sanitizeFilename(memory.name) + '.md';
+            await fs.writeFile(path.join(dir, filename), serializeMemory(memory), 'utf-8');
+        },
+        async remove(dir, name) {
+            const filename = sanitizeFilename(name) + '.md';
+            try {
+                await fs.unlink(path.join(dir, filename));
+            }
+            catch {
+                // ignore if file doesn't exist
+            }
+        },
+        retrieve(memories, context) {
+            const maxItems = context.maxItems ?? 10;
+            const maxTokens = context.maxTokens ?? Infinity;
+            const queryTerms = tokenize(context.query);
+            // Empty query: return all memories up to limits (most recent first)
+            if (queryTerms.length === 0) {
+                const results = [];
+                let tokenBudget = 0;
+                for (let i = 0; i < memories.length; i++) {
+                    if (results.length >= maxItems)
+                        break;
+                    const itemTokens = Math.ceil(memories[i].content.length / 4);
+                    if (tokenBudget + itemTokens > maxTokens)
+                        break;
+                    tokenBudget += itemTokens;
+                    results.push({ memory: memories[i], relevanceScore: 1, source: 'memory', updatedAt: Date.now() - i });
+                }
+                return results;
+            }
+            const scored = memories.map((memory, index) => {
+                const docText = memory.description + ' ' + memory.content;
+                const docTokens = tokenize(docText);
+                const wordCount = docTokens.length || 1;
+                let score = 0;
+                for (const term of queryTerms) {
+                    let count = 0;
+                    for (const token of docTokens) {
+                        if (token === term)
+                            count++;
+                    }
+                    score += count / wordCount;
+                }
+                return {
+                    memory,
+                    relevanceScore: score,
+                    source: 'memory',
+                    updatedAt: Date.now() - index, // recency tiebreaker
+                };
+            });
+            scored.sort((a, b) => {
+                if (b.relevanceScore !== a.relevanceScore)
+                    return b.relevanceScore - a.relevanceScore;
+                return b.updatedAt - a.updatedAt;
+            });
+            const results = [];
+            let tokenBudget = 0;
+            for (const item of scored) {
+                if (item.relevanceScore === 0)
+                    break;
+                if (results.length >= maxItems)
+                    break;
+                const itemTokens = Math.ceil(item.memory.content.length / 4); // rough estimate
+                if (tokenBudget + itemTokens > maxTokens)
+                    break;
+                tokenBudget += itemTokens;
+                results.push(item);
+            }
+            return results;
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory/memory.js.map

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

package/dist/memory/memory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory.test.d.ts.map

package/dist/memory/memory.test.d.ts.map

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

package/dist/memory/memory.test.js

@@ -0,0 +1,94 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { createMemoryManager } from './memory.js';
+describe('MemoryManager', () => {
+    let tmpDir;
+    const manager = createMemoryManager();
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'memory-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    const sampleMemory = {
+        name: 'test-memory',
+        description: 'A test memory for unit testing',
+        type: 'user',
+        content: 'This is the memory content about TypeScript testing.',
+    };
+    describe('save and load roundtrip', () => {
+        it('saves and loads a memory correctly', async () => {
+            await manager.save(tmpDir, sampleMemory);
+            const loaded = await manager.load(tmpDir);
+            expect(loaded).toHaveLength(1);
+            expect(loaded[0]).toEqual(sampleMemory);
+        });
+        it('saves multiple memories', async () => {
+            await manager.save(tmpDir, sampleMemory);
+            await manager.save(tmpDir, { ...sampleMemory, name: 'second', description: 'Second memory', content: 'Other content' });
+            const loaded = await manager.load(tmpDir);
+            expect(loaded).toHaveLength(2);
+        });
+        it('sanitizes filenames with special characters', async () => {
+            const mem = { ...sampleMemory, name: 'My Memory! @#$%' };
+            await manager.save(tmpDir, mem);
+            const files = await fs.readdir(tmpDir);
+            expect(files[0]).toBe('my-memory.md');
+            const loaded = await manager.load(tmpDir);
+            expect(loaded[0].name).toBe('My Memory! @#$%');
+        });
+        it('creates directory if it does not exist', async () => {
+            const subdir = path.join(tmpDir, 'nested', 'dir');
+            await manager.save(subdir, sampleMemory);
+            const loaded = await manager.load(subdir);
+            expect(loaded).toHaveLength(1);
+        });
+        it('returns empty array for non-existent directory', async () => {
+            const loaded = await manager.load(path.join(tmpDir, 'nonexistent'));
+            expect(loaded).toEqual([]);
+        });
+    });
+    describe('remove', () => {
+        it('removes a saved memory', async () => {
+            await manager.save(tmpDir, sampleMemory);
+            await manager.remove(tmpDir, sampleMemory.name);
+            const loaded = await manager.load(tmpDir);
+            expect(loaded).toHaveLength(0);
+        });
+        it('does not throw when removing non-existent memory', async () => {
+            await expect(manager.remove(tmpDir, 'nonexistent')).resolves.not.toThrow();
+        });
+    });
+    describe('retrieve', () => {
+        const memories = [
+            { name: 'typescript', description: 'TypeScript patterns', type: 'reference', content: 'TypeScript uses strict typing and interfaces for code quality.' },
+            { name: 'python', description: 'Python patterns', type: 'reference', content: 'Python uses dynamic typing and duck typing for flexibility.' },
+            { name: 'testing', description: 'Testing best practices', type: 'project', content: 'Testing with vitest requires describe and it blocks.' },
+        ];
+        it('returns memories matching query keywords', () => {
+            const results = manager.retrieve(memories, { query: 'TypeScript typing' });
+            expect(results.length).toBeGreaterThan(0);
+            expect(results[0].memory.name).toBe('typescript');
+        });
+        it('returns empty array for no matching query', () => {
+            const results = manager.retrieve(memories, { query: 'zzzznoMatch' });
+            expect(results).toHaveLength(0);
+        });
+        it('respects maxItems', () => {
+            const results = manager.retrieve(memories, { query: 'typing', maxItems: 1 });
+            expect(results).toHaveLength(1);
+        });
+        it('respects maxTokens budget', () => {
+            const results = manager.retrieve(memories, { query: 'typing', maxTokens: 5 });
+            expect(results.length).toBeLessThanOrEqual(1);
+        });
+        it('returns all memories for empty query', () => {
+            const results = manager.retrieve(memories, { query: '' });
+            expect(results).toHaveLength(3);
+            expect(results[0].relevanceScore).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=memory.test.js.map

package/dist/memory/memory.test.js.map

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

package/dist/middleware/hooks.d.ts

@@ -0,0 +1,18 @@
+import type { AgentToolResult } from '@mariozechner/pi-agent-core';
+import type { HookHandler, HookEvent, HookContext, RunContext } from '../types.js';
+/**
+ * Run all matching PreToolUse hooks, chaining updated args through each hook.
+ * Returns the final (possibly modified) args.
+ */
+export declare function runPreToolUseHooks(hooks: HookHandler[], toolName: string, args: unknown, runContext: RunContext): Promise<unknown>;
+/**
+ * Run all matching PostToolUse hooks, chaining updated results through each hook.
+ * Returns the final (possibly modified) tool result.
+ */
+export declare function runPostToolUseHooks(hooks: HookHandler[], toolName: string, toolResult: AgentToolResult<any>, runContext: RunContext): Promise<AgentToolResult<any>>;
+/**
+ * Run all matching lifecycle hooks (SessionStart, SessionEnd, Stop, etc.).
+ * Lifecycle hooks ignore the matcher field.
+ */
+export declare function runLifecycleHooks(hooks: HookHandler[], event: HookEvent, runContext: RunContext, extra?: Partial<Pick<HookContext, 'agentName' | 'messages'>>): Promise<void>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/middleware/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/middleware/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWnF;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,EAChC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAoB/B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAAC,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,CAYf"}