@n8n/agents 0.8.1 → 0.9.1

package/dist/runtime/mcp-connection.js

@@ -1,13 +1,58 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.McpConnection = void 0;
-const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
-const sse_js_1 = require("@modelcontextprotocol/sdk/client/sse.js");
-const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
-const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const mcp_tool_resolver_1 = require("./mcp-tool-resolver");
 const tool_1 = require("../sdk/tool");
+let mcpSdkPromise;
+async function loadMcpSdk() {
+    mcpSdkPromise ??= Promise.all([
+        Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/client/index.js'))),
+        Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/client/sse.js'))),
+        Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/client/stdio.js'))),
+        Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/client/streamableHttp.js'))),
+        Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/types.js'))),
+    ]).then(([{ Client }, { SSEClientTransport }, { StdioClientTransport }, { StreamableHTTPClientTransport }, { CallToolResultSchema },]) => ({
+        Client,
+        SSEClientTransport,
+        StdioClientTransport,
+        StreamableHTTPClientTransport,
+        CallToolResultSchema,
+    }));
+    return await mcpSdkPromise;
+}
 class McpConnection {
     constructor(config, requireToolApproval = false) {
         this.connectionPromise = undefined;
@@ -15,13 +60,14 @@ class McpConnection {
         this.closed = false;
         this.config = config;
         this.shouldRequireToolApproval = requireToolApproval;
-        this.client = new index_js_1.Client({ name: '@n8n/agents', version: '0.1.0' }, { capabilities: {} });
     }
     async connect() {
         if (this.connectionPromise !== undefined) {
             return await this.connectionPromise;
         }
-        this.connectionPromise = this.connectWithTransport(this.createTransport(this.config));
+        const sdk = await loadMcpSdk();
+        this.client = new sdk.Client({ name: '@n8n/agents', version: '0.1.0' }, { capabilities: {} });
+        this.connectionPromise = this.connectWithTransport(this.createTransport(this.config, sdk));
         try {
             await this.connectionPromise;
         }
@@ -31,9 +77,12 @@ class McpConnection {
         }
     }
     async connectWithTransport(transport) {
+        if (!this.client)
+            throw new Error('MCP client not initialized; connect() must be called first');
+        const client = this.client;
         const timeoutMs = this.config.connectionTimeoutMs;
         if (timeoutMs === undefined) {
-            await this.client.connect(transport);
+            await client.connect(transport);
             return;
         }
         if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
@@ -42,7 +91,7 @@ class McpConnection {
         let timeoutId;
         try {
             await Promise.race([
-                this.client.connect(transport),
+                client.connect(transport),
                 new Promise((_, reject) => {
                     timeoutId = setTimeout(() => {
                         reject(new Error(`MCP server "${this.config.name}": connection timed out after ${timeoutMs}ms`));
@@ -51,7 +100,7 @@ class McpConnection {
             ]);
         }
         catch (error) {
-            await this.client.close().catch(() => { });
+            await client.close().catch(() => { });
             throw error;
         }
         finally {
@@ -60,6 +109,8 @@ class McpConnection {
         }
     }
     async listTools() {
+        if (!this.client)
+            throw new Error('MCP client not initialized; connect() must be called first');
         const result = await this.client.listTools();
         const resolver = new mcp_tool_resolver_1.McpToolResolver();
         const tools = resolver.resolve(this, result.tools);
@@ -83,7 +134,10 @@ class McpConnection {
         return false;
     }
     async callTool(name, args) {
-        const result = await this.client.callTool({ name, arguments: args }, types_js_1.CallToolResultSchema);
+        if (!this.client)
+            throw new Error('MCP client not initialized; connect() must be called first');
+        const { CallToolResultSchema } = await loadMcpSdk();
+        const result = await this.client.callTool({ name, arguments: args }, CallToolResultSchema);
         return result;
     }
     async disconnect() {
@@ -99,7 +153,8 @@ class McpConnection {
     async doDisconnect() {
         if (this.closed)
             return;
-        await this.client.close();
+        if (this.client)
+            await this.client.close();
         this.connectionPromise = undefined;
         this.closed = true;
     }
@@ -110,9 +165,9 @@ class McpConnection {
         const { requireApproval } = this.config;
         return (requireApproval === true || (Array.isArray(requireApproval) && requireApproval.length > 0));
     }
-    createTransport(config) {
+    createTransport(config, sdk) {
         if (config.command) {
-            return new stdio_js_1.StdioClientTransport({
+            return new sdk.StdioClientTransport({
                 command: config.command,
                 args: config.args,
                 env: config.env,
@@ -124,9 +179,9 @@ class McpConnection {
                 ? { headers: config.headers }
                 : undefined;
             if (config.transport === 'streamableHttp') {
-                return new streamableHttp_js_1.StreamableHTTPClientTransport(url, { requestInit });
+                return new sdk.StreamableHTTPClientTransport(url, { requestInit });
             }
-            return new sse_js_1.SSEClientTransport(url, { requestInit });
+            return new sdk.SSEClientTransport(url, { requestInit });
         }
         throw new Error(`MCP server "${config.name}": provide either "url" or "command"`);
     }

package/dist/runtime/mcp-connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-connection.js","sourceRoot":"","sources":["../../src/runtime/mcp-connection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-connection.js","sourceRoot":"","sources":["../../src/runtime/mcp-connection.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,2DAAsD;AACtD,sCAAkD;AAelD,IAAI,aAAgD,CAAC;AAOrD,KAAK,UAAU,UAAU;IACxB,aAAa,KAAK,OAAO,CAAC,GAAG,CAAC;0DACtB,2CAA2C;0DAC3C,yCAAyC;0DACzC,2CAA2C;0DAC3C,oDAAoD;0DACpD,oCAAoC;KAC3C,CAAC,CAAC,IAAI,CACN,CAAC,CACA,EAAE,MAAM,EAAE,EACV,EAAE,kBAAkB,EAAE,EACtB,EAAE,oBAAoB,EAAE,EACxB,EAAE,6BAA6B,EAAE,EACjC,EAAE,oBAAoB,EAAE,EACxB,EAAE,EAAE,CAAC,CAAC;QACN,MAAM;QACN,kBAAkB;QAClB,oBAAoB;QACpB,6BAA6B;QAC7B,oBAAoB;KACpB,CAAC,CACF,CAAC;IACF,OAAO,MAAM,aAAa,CAAC;AAC5B,CAAC;AAGD,MAAa,aAAa;IAWzB,YAAY,MAAuB,EAAE,mBAAmB,GAAG,KAAK;QAJxD,sBAAiB,GAA8B,SAAS,CAAC;QACzD,sBAAiB,GAA8B,SAAS,CAAC;QACzD,WAAM,GAAG,KAAK,CAAC;QAGtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,yBAAyB,GAAG,mBAAmB,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC;QACrC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,iBAAiB,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;YACnC,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,oBAAoB,CACjC,SAAoF;QAEpF,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAClD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACd,eAAe,IAAI,CAAC,MAAM,CAAC,IAAI,yDAAyD,CACxF,CAAC;QACH,CAAC;QACD,IAAI,SAAoD,CAAC;QACzD,IAAI,CAAC;YACJ,MAAM,OAAO,CAAC,IAAI,CAAC;gBAClB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;gBACzB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAChC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC3B,MAAM,CACL,IAAI,KAAK,CACR,eAAe,IAAI,CAAC,MAAM,CAAC,IAAI,iCAAiC,SAAS,IAAI,CAC7E,CACD,CAAC;oBACH,CAAC,EAAE,SAAS,CAAC,CAAC;gBACf,CAAC,CAAC;aACF,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,IAAI,SAAS,KAAK,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAGD,KAAK,CAAC,SAAS;QACd,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,mCAAe,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtB,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAA,0BAAmB,EAAC,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CACpD,CAAC;IACH,CAAC;IAUO,aAAa,CAAC,IAAe;QACpC,IAAI,IAAI,CAAC,yBAAyB;YAAE,OAAO,IAAI,CAAC;QAEhD,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,IAAI,eAAe,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE1C,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;YACtC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAChD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBAChC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACb,OAAO,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA6B;QACzD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChG,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAC3F,OAAO,MAA2B,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,IAAI,CAAC,iBAAiB;YAAE,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;QACjC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YACjC,IAAI,IAAI,CAAC,iBAAiB,KAAK,OAAO;gBAAE,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QAC5E,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY;QACzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC3C,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IACzB,CAAC;IAMD,gBAAgB;QACf,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,OAAO,CACN,eAAe,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAC1F,CAAC;IACH,CAAC;IAEO,eAAe,CACtB,MAAuB,EACvB,GAAiB;QAEjB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC;gBACnC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG,EAAE,MAAM,CAAC,GAAG;aACf,CAAC,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,WAAW,GAA4B,MAAM,CAAC,OAAO;gBAC1D,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;gBAC7B,CAAC,CAAC,SAAS,CAAC;YAEb,IAAI,MAAM,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;gBAC3C,OAAO,IAAI,GAAG,CAAC,6BAA6B,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YACpE,CAAC;YAED,OAAO,IAAI,GAAG,CAAC,kBAAkB,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,sCAAsC,CAAC,CAAC;IACnF,CAAC;CACD;AAxKD,sCAwKC"}

package/dist/runtime/memory-lifecycle.d.ts

@@ -0,0 +1,34 @@
+export type MemoryLifecycleStatus = 'active' | 'superseded' | 'dropped';
+export interface MemoryLifecycleState {
+    status: MemoryLifecycleStatus;
+    supersededBy: string | null;
+}
+export declare function activeLifecycleState(): {
+    status: 'active';
+    supersededBy: null;
+};
+export declare function droppedLifecycleState(): {
+    status: 'dropped';
+    supersededBy: null;
+};
+export declare function supersededLifecycleState(supersededBy: string): {
+    status: 'superseded';
+    supersededBy: string;
+};
+export declare function markLifecycleActive(entry: MemoryLifecycleState): void;
+export declare function markLifecycleDropped(entry: MemoryLifecycleState): void;
+export declare function markLifecycleSuperseded(entry: MemoryLifecycleState, supersededBy: string): void;
+export declare function uniqueStrings(values: Iterable<string>): string[];
+export declare function normalizeFlatReflectionActions<TInput extends {
+    supersedes: string[];
+}, TOutput extends {
+    supersedes: string[];
+}>(opts: {
+    activeIds: Iterable<string>;
+    drop: string[];
+    merge: TInput[];
+    normalizeMerge: (entry: TInput, supersedes: string[]) => TOutput | null;
+}): {
+    drop: string[];
+    merge: TOutput[];
+};

package/dist/runtime/memory-lifecycle.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activeLifecycleState = activeLifecycleState;
+exports.droppedLifecycleState = droppedLifecycleState;
+exports.supersededLifecycleState = supersededLifecycleState;
+exports.markLifecycleActive = markLifecycleActive;
+exports.markLifecycleDropped = markLifecycleDropped;
+exports.markLifecycleSuperseded = markLifecycleSuperseded;
+exports.uniqueStrings = uniqueStrings;
+exports.normalizeFlatReflectionActions = normalizeFlatReflectionActions;
+function activeLifecycleState() {
+    return { status: 'active', supersededBy: null };
+}
+function droppedLifecycleState() {
+    return { status: 'dropped', supersededBy: null };
+}
+function supersededLifecycleState(supersededBy) {
+    return { status: 'superseded', supersededBy };
+}
+function markLifecycleActive(entry) {
+    entry.status = 'active';
+    entry.supersededBy = null;
+}
+function markLifecycleDropped(entry) {
+    entry.status = 'dropped';
+    entry.supersededBy = null;
+}
+function markLifecycleSuperseded(entry, supersededBy) {
+    entry.status = 'superseded';
+    entry.supersededBy = supersededBy;
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const unique = [];
+    for (const value of values) {
+        if (seen.has(value))
+            continue;
+        seen.add(value);
+        unique.push(value);
+    }
+    return unique;
+}
+function normalizeFlatReflectionActions(opts) {
+    const activeIds = new Set(opts.activeIds);
+    const claimedIds = new Set();
+    const merge = [];
+    for (const item of opts.merge) {
+        const supersedes = uniqueStrings(item.supersedes).filter((id) => activeIds.has(id) && !claimedIds.has(id));
+        if (supersedes.length === 0)
+            continue;
+        const normalized = opts.normalizeMerge(item, supersedes);
+        if (!normalized)
+            continue;
+        for (const id of supersedes)
+            claimedIds.add(id);
+        merge.push(normalized);
+    }
+    return {
+        drop: uniqueStrings(opts.drop).filter((id) => activeIds.has(id) && !claimedIds.has(id)),
+        merge,
+    };
+}
+//# sourceMappingURL=memory-lifecycle.js.map

package/dist/runtime/memory-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lifecycle.js","sourceRoot":"","sources":["../../src/runtime/memory-lifecycle.ts"],"names":[],"mappings":";;AAOA,oDAEC;AAED,sDAEC;AAED,4DAKC;AAED,kDAGC;AAED,oDAGC;AAED,0DAGC;AAED,sCASC;AAED,wEA8BC;AAvED,SAAgB,oBAAoB;IACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,SAAgB,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAgB,wBAAwB,CAAC,YAAoB;IAI5D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC/C,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAA2B;IAC9D,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IACxB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAA2B;IAC/D,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,SAAgB,uBAAuB,CAAC,KAA2B,EAAE,YAAoB;IACxF,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IAC5B,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC;AACnC,CAAC;AAED,SAAgB,aAAa,CAAC,MAAwB;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAgB,8BAA8B,CAG5C,IAKD;IACA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CACvD,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAChD,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,KAAK,MAAM,EAAE,IAAI,UAAU;YAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IAED,OAAO;QACN,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,KAAK;KACL,CAAC;AACH,CAAC"}

package/dist/runtime/memory-store.d.ts

@@ -1,13 +1,18 @@
-import type { BuiltMemory, MemoryDescriptor, Thread } from '../types';
+import type { BuiltEpisodicMemoryStore, BuiltMemory, EpisodicMemoryMethods, MemoryDescriptor, Thread } from '../types';
 import type { AgentDbMessage } from '../types/sdk/message';
 import type { ObservationCursor } from '../types/sdk/observation';
-import type { BuiltObservationLogStore, BuiltObservationLogTaskLockStore, NewObservationLogEntry, ObservationLogEntry, ObservationLogReadOptions, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScope, ObservationLogScopeKind, ObservationLogTaskKind, ObservationLogTaskLockHandle } from '../types/sdk/observation-log';
-export declare class InMemoryMemory implements BuiltMemory, BuiltObservationLogStore, BuiltObservationLogTaskLockStore {
+import type { BuiltObservationLogStore, BuiltObservationLogTaskLockStore, NewObservationLogEntry, ObservationLogEntry, ObservationLogReadOptions, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScope, ObservationLogTaskKind, ObservationLogTaskLockHandle } from '../types/sdk/observation-log';
+export declare class InMemoryMemory implements BuiltMemory, BuiltObservationLogStore, BuiltObservationLogTaskLockStore, BuiltEpisodicMemoryStore {
     private threads;
     private messagesByThread;
     private observationLogByScope;
     private cursorsByScope;
     private locksByScope;
+    private episodicMemory;
+    private episodicMemorySources;
+    private episodicMemoryCursorsByScope;
+    private episodicMemoryLocksByResource;
+    readonly episodic: EpisodicMemoryMethods;
     getThread(threadId: string): Promise<Thread | null>;
     saveThread(thread: Omit<Thread, 'createdAt' | 'updatedAt'>): Promise<Thread>;
     deleteThread(threadId: string): Promise<void>;
@@ -32,21 +37,31 @@ export declare class InMemoryMemory implements BuiltMemory, BuiltObservationLogS
     dropObservationLogEntries(ids: string[]): Promise<void>;
     supersedeObservationLogEntries(ids: string[], supersededBy: string): Promise<void>;
     applyObservationLogReflection(scope: ObservationLogScope, reflection: ObservationLogReflection): Promise<ObservationLogReflectionResult>;
-    getMessagesForScope(scopeKind: ObservationLogScopeKind, scopeId: string, opts?: {
+    getMessagesForObservationScope(observationScopeId: string, opts?: {
         since?: {
             sinceCreatedAt: Date;
             sinceMessageId: string;
         };
-        resourceId?: string;
     }): Promise<AgentDbMessage[]>;
-    getCursor(scopeKind: ObservationLogScopeKind, scopeId: string): Promise<ObservationCursor | null>;
+    getCursor(observationScopeId: string): Promise<ObservationCursor | null>;
     setCursor(cursor: ObservationCursor): Promise<void>;
-    acquireObservationLogTaskLock(scopeKind: ObservationLogScopeKind, scopeId: string, taskKind: ObservationLogTaskKind, opts: {
+    acquireObservationLogTaskLock(observationScopeId: string, taskKind: ObservationLogTaskKind, opts: {
         ttlMs: number;
         holderId: string;
     }): Promise<ObservationLogTaskLockHandle | null>;
     private acquireScopeLock;
     releaseObservationLogTaskLock(handle: ObservationLogTaskLockHandle): Promise<void>;
     private releaseScopeLock;
+    private saveEpisodicMemoryEntries;
+    private saveEpisodicMemoryEntrySources;
+    private saveEpisodicMemoryEntryWithSources;
+    private searchEpisodicMemoryEntries;
+    private supersedeEpisodicMemoryEntries;
+    private getEpisodicMemoryEntrySources;
+    private applyEpisodicMemoryReflection;
+    private getEpisodicMemoryCursor;
+    private setEpisodicMemoryCursor;
+    private acquireEpisodicMemoryTaskLock;
+    private releaseEpisodicMemoryTaskLock;
 }
 export declare function saveMessagesToThread(memory: BuiltMemory, threadId: string, resourceId: string, messages: AgentDbMessage[]): Promise<void>;