ai-memory-layer 2.0.1 → 3.0.0

package/dist/integrations/middleware.js

@@ -1,5 +1,6 @@
 import { formatContextForPrompt } from '../core/formatter.js';
 export function wrapWithMemory(handler, memory, options = {}) {
+    let cachedContext = null;
     return async (messages) => {
         const lastMessage = [...messages].reverse().find((message) => message.role === 'user') ?? messages.at(-1);
         if (!lastMessage) {
@@ -9,7 +10,16 @@ export function wrapWithMemory(handler, memory, options = {}) {
         let nextMessages = messages;
         if (options.injectContext ?? true) {
             const query = (options.relevanceFromLastMessage ?? true) ? lastMessage.content : undefined;
-            const context = await memory.getContext(query);
+            let context;
+            if (options.snapshotMode) {
+                if (cachedContext == null) {
+                    cachedContext = await memory.getContext(query);
+                }
+                context = cachedContext;
+            }
+            else {
+                context = await memory.getContext(query);
+            }
             const memoryMessage = {
                 role: 'system',
                 content: formatContextForPrompt(context, { includeCitations: true }),

package/dist/integrations/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/integrations/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAiB9D,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,MAAqB,EACrB,UAAmC,EAAE;IAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1G,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE9D,IAAI,YAAY,GAAG,QAAQ,CAAC;QAC5B,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,wBAAwB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3F,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,aAAa,GAAG;gBACpB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;aACrE,CAAC;YACF,YAAY;gBACV,OAAO,CAAC,eAAe,KAAK,SAAS;oBACnC,CAAC,CAAC,CAAC,aAAa,EAAE,GAAG,QAAQ,CAAC;oBAC9B,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/integrations/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAwB9D,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,MAAqB,EACrB,UAAmC,EAAE;IAErC,IAAI,aAAa,GAAyB,IAAI,CAAC;IAE/C,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1G,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE9D,IAAI,YAAY,GAAG,QAAQ,CAAC;QAC5B,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,wBAAwB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3F,IAAI,OAAsB,CAAC;YAC3B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;oBAC1B,aAAa,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACjD,CAAC;gBACD,OAAO,GAAG,aAAa,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,aAAa,GAAG;gBACpB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;aACrE,CAAC;YACF,YAAY;gBACV,OAAO,CAAC,eAAe,KAAK,SAAS;oBACnC,CAAC,CAAC,CAAC,aAAa,EAAE,GAAG,QAAQ,CAAC;oBAC9B,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/integrations/openai-tools.d.ts

@@ -1,3 +1,4 @@
+import type { MemoryManager } from '../core/manager.js';
 import type { MemoryRuntime } from '../core/runtime.js';
 interface OpenAIFunctionTool {
     type: 'function';
@@ -7,14 +8,14 @@ interface OpenAIFunctionTool {
         parameters: Record<string, unknown>;
     };
 }
-export declare function createOpenAIMemoryTools(runtime: MemoryRuntime): {
+export declare function createOpenAIMemoryTools(runtime: MemoryRuntime, manager?: MemoryManager): {
     tools: OpenAIFunctionTool[];
-    invokeTool(name: string, args: Record<string, unknown>): Promise<{
+    invokeTool(name: string, args: Record<string, unknown>): Promise<import("../contracts/types.js").EpisodeSummary | import("../contracts/types.js").ReflectResult | import("../contracts/types.js").EpisodeSummary[] | import("../contracts/cognitive.js").CognitiveSearchResult | {
         bootstrap: import("../index.js").SessionBootstrap;
         bootstrapPrompt: string;
     } | {
-        exchange: Awaited<ReturnType<import("../index.js").MemoryManager["processExchange"]>>;
-        trackedWorkItems: import("../index.js").WorkItem[];
+        exchange: Awaited<ReturnType<MemoryManager["processExchange"]>>;
+        trackedWorkItems: import("../contracts/types.js").WorkItem[];
     }>;
 };
 export type { OpenAIFunctionTool };

package/dist/integrations/openai-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-tools.d.ts","sourceRoot":"","sources":["../../src/integrations/openai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,UAAU,kBAAkB;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAgDD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa;;qBAGnC,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EAsB/D;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"openai-tools.d.ts","sourceRoot":"","sources":["../../src/integrations/openai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,UAAU,kBAAkB;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAsLD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa;;qBAQ5D,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EA+D/D;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/integrations/openai-tools.js

@@ -1,3 +1,13 @@
+function parseTimeRangeArg(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const obj = raw;
+    const start_at = typeof obj.start_at === 'number' ? obj.start_at : undefined;
+    const end_at = typeof obj.end_at === 'number' ? obj.end_at : undefined;
+    if (start_at === undefined && end_at === undefined)
+        return undefined;
+    return { start_at, end_at };
+}
 const OPENAI_MEMORY_TOOLS = [
     {
         type: 'function',
@@ -43,9 +53,131 @@ const OPENAI_MEMORY_TOOLS = [
         },
     },
 ];
-export function createOpenAIMemoryTools(runtime) {
+const OPENAI_EPISODIC_TOOLS = [
+    {
+        type: 'function',
+        function: {
+            name: 'memory_search_episodes',
+            description: 'Search episodic memory for past session activity. Returns structured episode summaries grouped by session.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Natural-language search query.' },
+                    detailLevel: {
+                        type: 'string',
+                        enum: ['abstract', 'overview', 'full'],
+                        description: 'Amount of detail: abstract (objective+outcomes), overview (+actions), full (+artifacts+excerpts). Defaults to overview.',
+                    },
+                    limit: { type: 'number', description: 'Max episodes to return.' },
+                    timeRange: {
+                        type: 'object',
+                        description: 'Restrict episodes to a time window (unix seconds).',
+                        properties: {
+                            start_at: { type: 'number', description: 'Inclusive lower bound (unix seconds).' },
+                            end_at: { type: 'number', description: 'Inclusive upper bound (unix seconds).' },
+                        },
+                    },
+                },
+                required: ['query'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'memory_summarize_episode',
+            description: 'Produce a structured recap of a specific session at the requested detail level.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    sessionId: { type: 'string', description: 'The session to summarize.' },
+                    detailLevel: {
+                        type: 'string',
+                        enum: ['abstract', 'overview', 'full'],
+                        description: 'Detail level for the recap. Defaults to overview.',
+                    },
+                },
+                required: ['sessionId'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'memory_reflect',
+            description: 'Synthesize a cross-memory reflection that combines episodic and declarative knowledge with source attribution.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'The question or topic to reflect on.' },
+                    detailLevel: {
+                        type: 'string',
+                        enum: ['abstract', 'overview', 'full'],
+                        description: 'Detail level for episode summaries in the reflection.',
+                    },
+                    includeEpisodic: {
+                        type: 'boolean',
+                        description: 'Include episodic memory in reflection. Defaults to true.',
+                    },
+                    includeDeclarative: {
+                        type: 'boolean',
+                        description: 'Include declarative knowledge in reflection. Defaults to true.',
+                    },
+                    limit: { type: 'number', description: 'Max source items to consider.' },
+                    timeRange: {
+                        type: 'object',
+                        description: 'Restrict evidence to a time window (unix seconds).',
+                        properties: {
+                            start_at: { type: 'number' },
+                            end_at: { type: 'number' },
+                        },
+                    },
+                },
+                required: ['query'],
+            },
+        },
+    },
+];
+const OPENAI_COGNITIVE_TOOLS = [
+    {
+        type: 'function',
+        function: {
+            name: 'memory_search_cognitive',
+            description: 'Search memory using the cognitive taxonomy (episodic, semantic, procedural, working). Returns results grouped by cognitive type.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Natural-language search query.' },
+                    types: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['episodic', 'semantic', 'procedural', 'working'],
+                        },
+                        description: 'Cognitive memory types to include. Defaults to all.',
+                    },
+                    limit: { type: 'number', description: 'Max results to return.' },
+                    minimumTrustScore: {
+                        type: 'number',
+                        description: 'Minimum trust score threshold (0-1).',
+                    },
+                    activeOnly: {
+                        type: 'boolean',
+                        description: 'Only return active memories. Defaults to true.',
+                    },
+                },
+                required: ['query'],
+            },
+        },
+    },
+];
+export function createOpenAIMemoryTools(runtime, manager) {
+    const tools = [
+        ...OPENAI_MEMORY_TOOLS,
+        ...(manager ? [...OPENAI_EPISODIC_TOOLS, ...OPENAI_COGNITIVE_TOOLS] : []),
+    ];
     return {
-        tools: OPENAI_MEMORY_TOOLS,
+        tools,
         async invokeTool(name, args) {
             if (name === 'memory_start_session') {
                 return runtime.startSession(typeof args.relevanceQuery === 'string' ? args.relevanceQuery : undefined);
@@ -62,6 +194,42 @@ export function createOpenAIMemoryTools(runtime) {
                     assistantOutput: String(args.assistantOutput ?? ''),
                 });
             }
+            if (manager) {
+                if (name === 'memory_search_episodes') {
+                    return manager.searchEpisodes({
+                        query: String(args.query ?? ''),
+                        detailLevel: args.detailLevel ?? undefined,
+                        limit: typeof args.limit === 'number' ? args.limit : undefined,
+                        timeRange: parseTimeRangeArg(args.timeRange),
+                    });
+                }
+                if (name === 'memory_summarize_episode') {
+                    return manager.summarizeEpisode(String(args.sessionId ?? ''), {
+                        detailLevel: args.detailLevel ?? undefined,
+                    });
+                }
+                if (name === 'memory_reflect') {
+                    return manager.reflect({
+                        query: String(args.query ?? ''),
+                        detailLevel: args.detailLevel ?? undefined,
+                        includeEpisodic: typeof args.includeEpisodic === 'boolean' ? args.includeEpisodic : undefined,
+                        includeDeclarative: typeof args.includeDeclarative === 'boolean' ? args.includeDeclarative : undefined,
+                        limit: typeof args.limit === 'number' ? args.limit : undefined,
+                        timeRange: parseTimeRangeArg(args.timeRange),
+                    });
+                }
+                if (name === 'memory_search_cognitive') {
+                    return manager.searchCognitive({
+                        query: String(args.query ?? ''),
+                        types: Array.isArray(args.types)
+                            ? args.types
+                            : undefined,
+                        limit: typeof args.limit === 'number' ? args.limit : undefined,
+                        minimumTrustScore: typeof args.minimumTrustScore === 'number' ? args.minimumTrustScore : undefined,
+                        activeOnly: typeof args.activeOnly === 'boolean' ? args.activeOnly : undefined,
+                    });
+                }
+            }
             throw new Error(`Unknown OpenAI memory tool '${name}'`);
         },
     };

package/dist/integrations/openai-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-tools.js","sourceRoot":"","sources":["../../src/integrations/openai-tools.ts"],"names":[],"mappings":"AAWA,MAAM,mBAAmB,GAAyB;IAChD;QACE,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,qDAAqD;YAClE,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACnC;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,kDAAkD;YAC/D,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACnC;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;SACF;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,6DAA6D;YAC1E,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACpC;gBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC;aAC3C;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,OAAsB;IAC5D,OAAO;QACL,KAAK,EAAE,mBAAmB;QAC1B,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,IAA6B;YAC1D,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAC,YAAY,CACzB,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAC1E,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACnC,OAAO,OAAO,CAAC,eAAe,CAAC;oBAC7B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC/B,cAAc,EACZ,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;iBAC5E,CAAC,CAAC;YACL,CAAC;YACD,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC,cAAc,CAAC;oBAC5B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;oBACvC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;iBACpD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"openai-tools.js","sourceRoot":"","sources":["../../src/integrations/openai-tools.ts"],"names":[],"mappings":"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"}

package/dist/integrations/vercel-ai.d.ts

@@ -10,6 +10,12 @@ export interface VercelAIWrapOptions {
     mapInput?: (input: string | BeforeModelCallInput) => BeforeModelCallInput;
     mapOutput?: (result: unknown) => string;
     actors?: AfterModelCallInput['actors'];
+    /**
+     * When true, ensure a session snapshot is captured on first use so subsequent
+     * `beforeModelCall` calls read from the frozen cache. Requires the underlying
+     * runtime to be constructed with `snapshotMode: true`.
+     */
+    snapshotMode?: boolean;
 }
 export declare function prepareVercelAIInput(runtime: MemoryRuntime, input: string | BeforeModelCallInput): Promise<VercelAIPreparedInput>;
 export declare function wrapVercelAIModel<TInput extends string | BeforeModelCallInput, TResult>(runtime: MemoryRuntime, modelCall: (prepared: VercelAIPreparedInput) => Promise<TResult>, options?: VercelAIWrapOptions): (input: TInput) => Promise<{

package/dist/integrations/vercel-ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,KAAK,oBAAoB,CAAC;IAC1E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IACxC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAiBD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,oBAAoB,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,oBAAoB,EAAE,OAAO,EACrF,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,EAChE,OAAO,GAAE,mBAAwB,GAChC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAcvE"}
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,KAAK,oBAAoB,CAAC;IAC1E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IACxC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAiBD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,oBAAoB,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,oBAAoB,EAAE,OAAO,EACrF,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,EAChE,OAAO,GAAE,mBAAwB,GAChC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBvE"}

package/dist/integrations/vercel-ai.js

@@ -26,6 +26,10 @@ export async function prepareVercelAIInput(runtime, input) {
 export function wrapVercelAIModel(runtime, modelCall, options = {}) {
     return async (input) => {
         const runtimeInput = options.mapInput ? options.mapInput(input) : input;
+        if (options.snapshotMode && runtime.getSnapshot() == null) {
+            const relevanceQuery = typeof runtimeInput === 'string' ? undefined : runtimeInput.relevanceQuery;
+            await runtime.refreshSnapshot(relevanceQuery);
+        }
         const prepared = await prepareVercelAIInput(runtime, runtimeInput);
         const result = await modelCall(prepared);
         const responseText = options.mapOutput ? options.mapOutput(result) : toTextResult(result);

package/dist/integrations/vercel-ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"vercel-ai.js","sourceRoot":"","sources":["../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAaA,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,aAAa,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACtE,OAAO,MAAM,CAAC,WAAW,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAsB,EACtB,KAAoC;IAEpC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACtE,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,eAAe;QAChC,QAAQ,EAAE;YACR,GAAG,QAAQ,CAAC,QAAQ;YACpB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE;SACzC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAsB,EACtB,SAAgE,EAChE,UAA+B,EAAE;IAEjC,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,aAAa,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;QAC3F,MAAM,OAAO,CAAC,cAAc,CAAC;YAC3B,SAAS,EAAE,aAAa;YACxB,eAAe,EAAE,YAAY;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"vercel-ai.js","sourceRoot":"","sources":["../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAmBA,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,aAAa,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACtE,OAAO,MAAM,CAAC,WAAW,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAsB,EACtB,KAAoC;IAEpC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACtE,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,eAAe;QAChC,QAAQ,EAAE;YACR,GAAG,QAAQ,CAAC,QAAQ;YACpB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE;SACzC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAsB,EACtB,SAAgE,EAChE,UAA+B,EAAE;IAEjC,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;YAC1D,MAAM,cAAc,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC;YAClG,MAAM,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,aAAa,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;QAC3F,MAAM,OAAO,CAAC,cAAc,CAAC;YAC3B,SAAS,EAAE,aAAa;YACxB,eAAe,EAAE,YAAY;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/http-server.d.ts

@@ -35,6 +35,14 @@ export interface HttpServerConfig {
     qualityTier?: CreateMemoryOptions['qualityTier'];
     /** Cross-scope retrieval level for hosted managers. */
     crossScopeLevel?: ScopeLevel;
+    /** Auto-detect workspace from git remote or cwd when no scope provided. */
+    autoDetectWorkspace?: boolean;
+    /** Structured generation client for episodic recall, playbooks, and reflect. */
+    structuredClient?: CreateMemoryOptions['structuredClient'];
+    /** Default event cap for diff/reporting endpoints. Defaults to 5000. */
+    defaultDiffMaxEvents?: number;
+    /** Hard maximum event cap for diff/reporting endpoints. Defaults to 20000. */
+    maxDiffMaxEvents?: number;
 }
 /**
  * Creates and starts an HTTP server exposing memory operations as a REST API.

package/dist/server/http-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/server/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6C,MAAM,MAAM,CAAC;AAC/E,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAO7F,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,uBAAuB;IACvB,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,sBAAsB;IACtB,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,cAAc;IACd,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD,mCAAmC;IACnC,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD,uDAAuD;IACvD,eAAe,CAAC,EAAE,UAAU,CAAC;CAC9B;AAgPD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAAC;IAC5E,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC,CAuhBD"}
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/server/http-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA6C,MAAM,MAAM,CAAC;AAC/E,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAaxD,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AA2B7F,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,uBAAuB;IACvB,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,sBAAsB;IACtB,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,cAAc;IACd,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD,mCAAmC;IACnC,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD,uDAAuD;IACvD,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IAC3D,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAifD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAAC;IAC5E,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC,CA20CD"}