@kortyx/agent 0.2.2 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.4.0](https://github.com/kortyx-io/Kortyx/compare/agent-v0.3.0...agent-v0.4.0) (2026-02-07)
+
+
+### Features
+
+* **runtime:** framework persistence adapter ([8383ad2](https://github.com/kortyx-io/Kortyx/commit/8383ad2d73754ccf4daf33e414e15c3ce44df8cb))
+
+
+### Bug Fixes
+
+* **agent:** remove explicit any in chat flow ([fcd701c](https://github.com/kortyx-io/Kortyx/commit/fcd701cfb6cb5f037900bbf0b396230603d16877))
+
+## [0.3.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.2.2...agent-v0.3.0) (2026-01-25)
+
+
+### Features
+
+* add new example project ([dae4ad0](https://github.com/kortyx-io/kortyx/commit/dae4ad00f2e987ecb71f863bfc776ea7e19e2430))
+
+
+### Bug Fixes
+
+* package scripts and dist ([0ed75d3](https://github.com/kortyx-io/kortyx/commit/0ed75d362230a5eddc83b269d14cb787fbf84fb8))
+
 ## [0.2.2](https://github.com/kortyx-io/kortyx/compare/agent-v0.2.1...agent-v0.2.2) (2026-01-22)
 
 

package/README.md

@@ -0,0 +1,20 @@
+# @kortyx/agent
+
+Agent composition utilities for Kortyx.
+
+## Install
+
+```bash
+npm install @kortyx/agent
+```
+
+## Documentation
+
+This repo is under active development. For the latest package list and links, see the monorepo README:
+
+- `README.md`
+
+## License
+
+Apache-2.0
+

package/dist/chat/create-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../../src/chat/create-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,CACP,SAAQ,IAAI,CACV,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,kBAAkB,CAC/D;IACD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAG,OAAO,EACjB,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;4BA6CN,WAAW,EAAE,YAAY,OAAO;EAyBjE"}
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../../src/chat/create-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EACZ,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,CACP,SAAQ,IAAI,CACV,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,kBAAkB,CAC/D;IACD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAG,OAAO,EACjB,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;4BAoDN,WAAW,EAAE,YAAY,OAAO;EAiCjE"}

package/dist/chat/create-agent.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgent = createAgent;
+const node_path_1 = require("node:path");
 const runtime_1 = require("@kortyx/runtime");
-const path_1 = require("path");
 const process_chat_1 = require("./process-chat");
 function createAgent(args) {
-    const { workflowsDir, workflowRegistry, selectWorkflow, fallbackWorkflowId, config, configPath, ...baseArgs } = args;
+    const { workflowsDir, workflowRegistry, selectWorkflow, fallbackWorkflowId, config, configPath, defaultWorkflowId, frameworkAdapter, ...baseArgs } = args;
+    const resolvedDefaultWorkflowId = defaultWorkflowId ?? config?.fallbackWorkflowId ?? fallbackWorkflowId;
+    const resolvedFrameworkAdapter = frameworkAdapter ?? (0, runtime_1.createFrameworkAdapterFromEnv)();
     const resolvedCwd = process.cwd();
     const registryPromise = (async () => {
         if (workflowRegistry)
@@ -21,7 +23,7 @@ function createAgent(args) {
             ...(configPath ? { configPath } : {}),
         };
         const loadedConfig = config ?? (await (0, runtime_1.loadKortyxConfig)(loadConfigArgs));
-        const resolvedWorkflowsDir = loadedConfig?.workflowsDir ?? (0, path_1.resolve)(resolvedCwd, "src", "workflows");
+        const resolvedWorkflowsDir = loadedConfig?.workflowsDir ?? (0, node_path_1.resolve)(resolvedCwd, "src", "workflows");
         const registryOptions = {
             workflowsDir: resolvedWorkflowsDir,
             fallbackId: loadedConfig?.fallbackWorkflowId ??
@@ -41,9 +43,13 @@ function createAgent(args) {
             if (selectWorkflow) {
                 return (0, process_chat_1.processChat)({
                     ...baseArgs,
+                    ...(resolvedDefaultWorkflowId
+                        ? { defaultWorkflowId: resolvedDefaultWorkflowId }
+                        : {}),
                     messages,
                     options,
                     selectWorkflow,
+                    frameworkAdapter: resolvedFrameworkAdapter,
                 });
             }
             const registry = await registryPromise;
@@ -52,9 +58,13 @@ function createAgent(args) {
             }
             return (0, process_chat_1.processChat)({
                 ...baseArgs,
+                ...(resolvedDefaultWorkflowId
+                    ? { defaultWorkflowId: resolvedDefaultWorkflowId }
+                    : {}),
                 messages,
                 options,
                 workflowRegistry: registry,
+                frameworkAdapter: resolvedFrameworkAdapter,
             });
         },
     };

package/dist/chat/process-chat.d.ts

@@ -1,6 +1,6 @@
 import type { MemoryAdapter } from "@kortyx/memory";
 import type { GetProviderFn } from "@kortyx/providers";
-import type { WorkflowRegistry } from "@kortyx/runtime";
+import type { FrameworkAdapter, WorkflowRegistry } from "@kortyx/runtime";
 import type { ApplyResumeSelection } from "../interrupt/resume-handler";
 import type { SelectWorkflowFn } from "../orchestrator";
 import type { ChatMessage } from "../types/chat-message";
@@ -15,11 +15,12 @@ export interface ProcessChatArgs<Config extends Record<string, unknown>, Options
     loadRuntimeConfig: (options?: Options) => Config | Promise<Config>;
     selectWorkflow?: SelectWorkflowFn;
     workflowRegistry?: WorkflowRegistry;
+    frameworkAdapter?: FrameworkAdapter;
     getProvider: GetProviderFn;
     initializeProviders?: InitializeProvidersFn<Config>;
-    memoryAdapter: MemoryAdapter;
+    memoryAdapter?: MemoryAdapter;
     applyResumeSelection?: ApplyResumeSelection;
 }
-export declare function processChat<Config extends Record<string, unknown>, Options = unknown>({ messages, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, getProvider, initializeProviders, memoryAdapter, applyResumeSelection, }: ProcessChatArgs<Config, Options>): Promise<Response>;
+export declare function processChat<Config extends Record<string, unknown>, Options = unknown>({ messages, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, frameworkAdapter, getProvider, initializeProviders, memoryAdapter, applyResumeSelection, }: ProcessChatArgs<Config, Options>): Promise<Response>;
 export {};
 //# sourceMappingURL=process-chat.d.ts.map

package/dist/chat/process-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-chat.d.ts","sourceRoot":"","sources":["../../src/chat/process-chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,KAAK,qBAAqB,CAAC,MAAM,IAAI,CACnC,QAAQ,EAAE,MAAM,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,KACnD,IAAI,CAAC;AAEV,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO;IAEP,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,EAAE,aAAa,CAAC;IAC3B,mBAAmB,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpD,aAAa,EAAE,aAAa,CAAC;IAC7B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,wBAAsB,WAAW,CAC/B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAG,OAAO,EACjB,EACA,QAAQ,EACR,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkFtD"}
+{"version":3,"file":"process-chat.d.ts","sourceRoot":"","sources":["../../src/chat/process-chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAO1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,KAAK,qBAAqB,CAAC,MAAM,IAAI,CACnC,QAAQ,EAAE,MAAM,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,KACnD,IAAI,CAAC;AAEV,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO;IAEP,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,EAAE,aAAa,CAAC;IAC3B,mBAAmB,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,wBAAsB,WAAW,CAC/B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAG,OAAO,EACjB,EACA,QAAQ,EACR,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyGtD"}

package/dist/chat/process-chat.js

@@ -6,15 +6,21 @@ const stream_1 = require("@kortyx/stream");
 const resume_handler_1 = require("../interrupt/resume-handler");
 const orchestrator_1 = require("../orchestrator");
 const extract_latest_message_1 = require("../utils/extract-latest-message");
-async function processChat({ messages, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, getProvider, initializeProviders, memoryAdapter, applyResumeSelection, }) {
+async function processChat({ messages, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, frameworkAdapter, getProvider, initializeProviders, memoryAdapter, applyResumeSelection, }) {
     const config = await loadRuntimeConfig(options);
     if (initializeProviders) {
-        initializeProviders(config?.ai);
+        const ai = config.ai;
+        initializeProviders((ai && typeof ai === "object" && !Array.isArray(ai)
+            ? ai
+            : {}));
     }
     const runtimeConfig = {
         ...config,
         getProvider,
         ...(memoryAdapter ? { memoryAdapter } : {}),
+        ...(frameworkAdapter
+            ? { checkpointer: frameworkAdapter.checkpointer }
+            : {}),
     };
     const workflowSelector = selectWorkflow ??
         (workflowRegistry ? (id) => workflowRegistry.select(id) : null);
@@ -27,43 +33,61 @@ async function processChat({ messages, options, sessionId, defaultWorkflowId, lo
     const last = messages[messages.length - 1];
     const input = (0, extract_latest_message_1.extractLatestUserMessage)(messages);
     const previousMessages = messages.slice(0, -1);
-    const storedState = await memoryAdapter.load(resolvedSessionId);
     const memory = {
-        ...(storedState?.memory ?? {}),
-        ...(previousMessages.length > 0 && {
-            conversationMessages: previousMessages,
-        }),
+        ...(previousMessages.length > 0
+            ? { conversationMessages: previousMessages }
+            : {}),
     };
+    const isResumeRequest = Boolean((0, resume_handler_1.parseResumeMeta)(last));
+    const requestedWorkflowId = (() => {
+        if (!options)
+            return undefined;
+        if (typeof options !== "object")
+            return undefined;
+        const record = options;
+        const wfId = record.workflowId;
+        if (typeof wfId === "string")
+            return wfId;
+        const wf = record.workflow;
+        if (typeof wf === "string")
+            return wf;
+        return undefined;
+    })();
+    if (!isResumeRequest && requestedWorkflowId) {
+        if (requestedWorkflowId.trim() === "")
+            delete memory.currentWorkflow;
+        else
+            memory.currentWorkflow = requestedWorkflowId;
+    }
     const baseState = await (0, runtime_1.buildInitialGraphState)({
         input,
         config: runtimeConfig,
         memory,
         ...(defaultWorkflowId ? { defaultWorkflowId } : {}),
     });
-    const saveMemory = async (activeSessionId, state) => {
-        await memoryAdapter.save(activeSessionId, state);
-    };
     const resumeStream = await (0, resume_handler_1.tryPrepareResumeStream)({
         lastMessage: last,
         sessionId: resolvedSessionId,
         config: runtimeConfig,
-        saveMemory,
         selectWorkflow: workflowSelector,
+        ...(frameworkAdapter ? { frameworkAdapter } : {}),
         ...(defaultWorkflowId ? { defaultWorkflowId } : {}),
         ...(applyResumeSelection ? { applyResumeSelection } : {}),
     });
     if (resumeStream)
         return (0, stream_1.createStreamResponse)(resumeStream);
+    const runId = (0, runtime_1.makeRequestId)("run");
     const currentWorkflow = baseState.currentWorkflow;
     const selectedWorkflow = await workflowSelector(currentWorkflow);
     const graph = await (0, runtime_1.createLangGraph)(selectedWorkflow, runtimeConfig);
     const orchestratedStream = await (0, orchestrator_1.orchestrateGraphStream)({
         sessionId: resolvedSessionId,
+        runId,
         graph,
         state: { ...baseState, currentWorkflow },
         config: runtimeConfig,
-        saveMemory,
         selectWorkflow: workflowSelector,
+        ...(frameworkAdapter ? { frameworkAdapter } : {}),
     });
     return (0, stream_1.createStreamResponse)(orchestratedStream);
 }

package/dist/interrupt/resume-handler.d.ts

@@ -1,6 +1,6 @@
-import { type PendingRequestRecord } from "@kortyx/memory";
+import type { FrameworkAdapter, PendingRequestRecord } from "@kortyx/runtime";
 import type { StreamChunk } from "@kortyx/stream";
-import type { SaveMemoryFn, SelectWorkflowFn } from "../orchestrator";
+import type { SelectWorkflowFn } from "../orchestrator";
 import type { ChatMessage } from "../types/chat-message";
 export interface ResumeMeta {
     token: string;
@@ -17,11 +17,11 @@ interface TryResumeArgs {
     lastMessage: ChatMessage | undefined;
     sessionId: string;
     config: Record<string, unknown>;
-    saveMemory?: SaveMemoryFn;
     selectWorkflow: SelectWorkflowFn;
     defaultWorkflowId?: string;
     applyResumeSelection?: ApplyResumeSelection;
+    frameworkAdapter?: FrameworkAdapter;
 }
-export declare function tryPrepareResumeStream({ lastMessage, sessionId, config, saveMemory, selectWorkflow, defaultWorkflowId, applyResumeSelection, }: TryResumeArgs): Promise<AsyncIterable<StreamChunk> | null>;
+export declare function tryPrepareResumeStream({ lastMessage, sessionId, config, selectWorkflow, defaultWorkflowId, applyResumeSelection, frameworkAdapter, }: TryResumeArgs): Promise<AsyncIterable<StreamChunk> | null>;
 export {};
 //# sourceMappingURL=resume-handler.d.ts.map

package/dist/interrupt/resume-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resume-handler.d.ts","sourceRoot":"","sources":["../../src/interrupt/resume-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAEjD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,GAAG,SAAS,GAC3B,UAAU,GAAG,IAAI,CAmBnB;AAED,UAAU,aAAa;IACrB,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,cAAc,EAAE,gBAAgB,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,WAAW,EACX,SAAS,EACT,MAAM,EACN,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAgF5D"}
+{"version":3,"file":"resume-handler.d.ts","sourceRoot":"","sources":["../../src/interrupt/resume-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EAErB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAKjD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,GAAG,SAAS,GAC3B,UAAU,GAAG,IAAI,CAuBnB;AAED,UAAU,aAAa;IACrB,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,EAAE,gBAAgB,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GACjB,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CA6F5D"}

package/dist/interrupt/resume-handler.js

@@ -2,42 +2,48 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseResumeMeta = parseResumeMeta;
 exports.tryPrepareResumeStream = tryPrepareResumeStream;
-const memory_1 = require("@kortyx/memory");
 const runtime_1 = require("@kortyx/runtime");
 const orchestrator_1 = require("../orchestrator");
+const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 function parseResumeMeta(msg) {
     if (!msg || !msg.metadata)
         return null;
-    const raw = msg.metadata?.resume;
-    if (!raw)
+    const raw = msg.metadata.resume;
+    if (!isRecord(raw))
         return null;
     const token = typeof raw.token === "string" ? raw.token : "";
     const requestId = typeof raw.requestId === "string" ? raw.requestId : "";
-    const cancel = Boolean(raw.cancel);
+    const cancel = raw.cancel === true;
     let selected = [];
-    if (typeof raw.selected === "string")
-        selected = [raw.selected];
-    else if (Array.isArray(raw.selected))
-        selected = raw.selected.map((x) => String(x));
-    else if (raw?.choice?.id)
-        selected = [String(raw.choice.id)];
-    else if (Array.isArray(raw?.choices))
-        selected = raw.choices.map((c) => String(c.id));
+    const rawSelected = raw.selected;
+    if (typeof rawSelected === "string")
+        selected = [rawSelected];
+    else if (Array.isArray(rawSelected))
+        selected = rawSelected.map(String);
+    else if (isRecord(raw.choice) && typeof raw.choice.id === "string")
+        selected = [raw.choice.id];
+    else if (Array.isArray(raw.choices))
+        selected = raw.choices
+            .map((c) => (isRecord(c) ? c.id : undefined))
+            .filter((id) => typeof id === "string");
     if (!token || !requestId)
         return null;
     return { token, requestId, selected, cancel };
 }
-async function tryPrepareResumeStream({ lastMessage, sessionId, config, saveMemory, selectWorkflow, defaultWorkflowId, applyResumeSelection, }) {
+async function tryPrepareResumeStream({ lastMessage, sessionId, config, selectWorkflow, defaultWorkflowId, applyResumeSelection, frameworkAdapter, }) {
     const meta = parseResumeMeta(lastMessage);
     if (!meta)
         return null;
-    const pending = (0, memory_1.getPendingRequest)(meta.token);
+    const store = frameworkAdapter?.pendingRequests;
+    if (!store)
+        return null;
+    const pending = await store.get(meta.token);
     if (!pending || pending.requestId !== meta.requestId) {
         console.log(`[resume] pending not found or mismatched. token=${meta.token} requestId=${meta.requestId}`);
         return null;
     }
     if (meta.cancel) {
-        (0, memory_1.deletePendingRequest)(pending.token);
+        await store.delete(pending.token);
         return null;
     }
     console.log(`[resume] token=${meta.token} requestId=${meta.requestId} selected=${JSON.stringify(meta.selected)} sessionId=${sessionId}`);
@@ -46,33 +52,41 @@ async function tryPrepareResumeStream({ lastMessage, sessionId, config, saveMemo
         : meta.selected?.length
             ? { coordinates: String(meta.selected[0]) }
             : {};
-    const resumeDataPatch = resumeData && typeof resumeData === "object" ? resumeData : {};
+    const resumeDataPatch = isRecord(resumeData) ? resumeData : {};
+    const pendingData = isRecord(pending.state?.data) ? pending.state?.data : {};
+    const workflowId = typeof pending.workflow === "string" && pending.workflow.trim()
+        ? pending.workflow
+        : typeof defaultWorkflowId === "string" && defaultWorkflowId.trim()
+            ? defaultWorkflowId
+            : "job-search";
     const resumedState = {
         input: "",
         lastNode: "__start__",
-        currentWorkflow: pending.workflow ||
-            defaultWorkflowId ||
-            "job-search",
-        config: config,
+        currentWorkflow: workflowId,
+        config,
+        memory: {},
         conversationHistory: [],
         awaitingHumanInput: false,
         data: {
-            ...(pending.state?.data ?? {}),
+            ...pendingData,
             ...resumeDataPatch,
         },
     };
     const wf = await selectWorkflow(resumedState.currentWorkflow);
-    const resumeValue = meta.selected?.length
-        ? String(meta.selected[0])
-        : undefined;
+    const resumeValue = meta.selected?.length && pending.schema.kind === "multi-choice"
+        ? meta.selected.map((x) => String(x))
+        : meta.selected?.length
+            ? String(meta.selected[0])
+            : undefined;
     const resumedGraph = await (0, runtime_1.createLangGraph)(wf, {
         ...config,
         resume: true,
         ...(resumeValue !== undefined ? { resumeValue } : {}),
     });
-    (0, memory_1.deletePendingRequest)(pending.token);
+    await store.delete(pending.token);
     const args = {
         sessionId,
+        runId: pending.runId,
         graph: resumedGraph,
         state: resumedState,
         config: {
@@ -81,9 +95,8 @@ async function tryPrepareResumeStream({ lastMessage, sessionId, config, saveMemo
             ...(resumeValue !== undefined ? { resumeValue } : {}),
         },
         selectWorkflow,
+        ...(frameworkAdapter ? { frameworkAdapter } : {}),
     };
-    if (saveMemory)
-        args.saveMemory = saveMemory;
     const stream = await (0, orchestrator_1.orchestrateGraphStream)(args);
     return stream;
 }

package/dist/orchestrator.d.ts

@@ -1,5 +1,6 @@
 import type { GraphState, WorkflowDefinition } from "@kortyx/core";
-export type SelectWorkflowFn = (workflowId: string) => Promise<WorkflowDefinition<any, any>>;
+import { type FrameworkAdapter } from "@kortyx/runtime";
+export type SelectWorkflowFn = (workflowId: string) => Promise<WorkflowDefinition>;
 export type SaveMemoryFn = (sessionId: string, state: GraphState) => Promise<void>;
 export interface CompiledGraphLike {
     config?: Record<string, unknown>;
@@ -10,11 +11,12 @@ export interface CompiledGraphLike {
 }
 export interface OrchestrateArgs {
     sessionId?: string;
+    runId: string;
     graph: CompiledGraphLike;
     state: GraphState;
     config: Record<string, unknown>;
-    saveMemory?: SaveMemoryFn;
     selectWorkflow: SelectWorkflowFn;
+    frameworkAdapter?: FrameworkAdapter;
 }
-export declare function orchestrateGraphStream({ sessionId, graph, state, config, saveMemory, selectWorkflow, }: OrchestrateArgs): Promise<NodeJS.ReadableStream>;
+export declare function orchestrateGraphStream({ sessionId, runId, graph, state, config, selectWorkflow, frameworkAdapter, }: OrchestrateArgs): Promise<NodeJS.ReadableStream>;
 //# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAgB/E,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,CACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,CACZ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KACnE,aAAa,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,cAAc,EAAE,gBAAgB,CAAC;CAClC;AAQD,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,KAAK,EACL,KAAK,EACL,MAAM,EACN,UAAU,EACV,cAAc,GACf,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CA4dlD"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAC/E,OAAO,EAEL,KAAK,gBAAgB,EAKtB,MAAM,iBAAiB,CAAC;AAKzB,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEjC,MAAM,MAAM,YAAY,GAAG,CACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,CACZ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KACnE,aAAa,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,EAAE,gBAAgB,CAAC;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAQD,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,KAAK,EACL,KAAK,EACL,KAAK,EACL,MAAM,EACN,cAAc,EACd,gBAAgB,GACjB,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAkgBlD"}

package/dist/orchestrator.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.orchestrateGraphStream = orchestrateGraphStream;
-const memory_1 = require("@kortyx/memory");
+const node_stream_1 = require("node:stream");
 const runtime_1 = require("@kortyx/runtime");
 const langgraph_1 = require("@langchain/langgraph");
-const stream_1 = require("stream");
 const transform_graph_stream_for_ui_1 = require("./stream/transform-graph-stream-for-ui");
-async function orchestrateGraphStream({ sessionId, graph, state, config, saveMemory, selectWorkflow, }) {
-    const out = new stream_1.PassThrough({ objectMode: true });
+async function orchestrateGraphStream({ sessionId, runId, graph, state, config, selectWorkflow, frameworkAdapter, }) {
+    const out = new node_stream_1.PassThrough({ objectMode: true });
     let currentGraph = graph;
     let currentState = state;
     let finished = false;
+    const namespacesUsed = new Set();
     try {
         const sid = config?.session?.id;
         if (sid && typeof sid === "string") {
@@ -28,6 +28,8 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
     let pendingRecordToken = null;
     let activeIsResume = false;
     let wroteHumanInput = false;
+    const pendingStore = frameworkAdapter?.pendingRequests;
+    const pendingTtlMs = frameworkAdapter?.ttlMs ?? 15 * 60 * 1000;
     const forwardEmit = (event, payload) => {
         if (event === "error") {
             const msg = String(payload?.message ?? "Unexpected error");
@@ -124,6 +126,7 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                 token,
                 requestId,
                 sessionId: sessionId,
+                runId,
                 workflow: local.workflow || currentState.currentWorkflow,
                 node: local.node || "",
                 state: { ...currentState, awaitingHumanInput: true },
@@ -147,9 +150,13 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                     value: o.value,
                 })),
                 createdAt: Date.now(),
-                ttlMs: 15 * 60 * 1000,
+                ttlMs: pendingTtlMs,
             };
-            (0, memory_1.savePendingRequest)(record);
+            if (pendingStore) {
+                pendingStore.save(record).catch((e) => {
+                    console.error("[orchestrator] failed to save pending request", e);
+                });
+            }
             out.write({
                 type: "interrupt",
                 requestId: record.requestId,
@@ -179,9 +186,11 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
             const threadId = currentGraph.config?.session?.id ||
                 sessionId ||
                 "anonymous-session";
+            const checkpointNs = String(currentState.currentWorkflow || "default");
+            namespacesUsed.add(checkpointNs);
             out.write({
                 type: "status",
-                message: `🧵 thread_id=${threadId} workflow=${currentState.currentWorkflow}`,
+                message: `🧵 thread_id=${threadId} run_id=${runId} workflow=${currentState.currentWorkflow}`,
             });
             const isResume = Boolean(currentGraph.config?.resume);
             activeIsResume = isResume;
@@ -197,14 +206,14 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
             const runtimeStream = currentGraph.streamEvents(invokeState, {
                 version: "v2",
                 configurable: {
-                    thread_id: threadId,
-                    checkpoint_ns: String(currentState.currentWorkflow || "default"),
+                    thread_id: runId,
+                    checkpoint_ns: checkpointNs,
                 },
             });
             try {
                 out.write({
                     type: "status",
-                    message: `▶️ streamEvents invoke: resume=${Boolean(currentGraph.config?.resume)} thread_id=${threadId} ns=${String(currentState.currentWorkflow || "default")}`,
+                    message: `▶️ streamEvents invoke: resume=${Boolean(currentGraph.config?.resume)} thread_id=${threadId} run_id=${runId} ns=${String(currentState.currentWorkflow || "default")}`,
                 });
             }
             catch { }
@@ -235,6 +244,7 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                         token,
                         requestId,
                         sessionId: sessionId,
+                        runId,
                         workflow: currentState.currentWorkflow,
                         node: node || "",
                         state: {
@@ -261,9 +271,11 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                             value: o.value,
                         })),
                         createdAt: Date.now(),
-                        ttlMs: 15 * 60 * 1000,
+                        ttlMs: pendingTtlMs,
                     };
-                    (0, memory_1.savePendingRequest)(record);
+                    if (pendingStore) {
+                        await pendingStore.save(record);
+                    }
                     out.write({
                         type: "interrupt",
                         requestId,
@@ -306,9 +318,6 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                 else {
                     out.write(chunk);
                 }
-                if (saveMemory && sessionId && chunk.type !== "status") {
-                    await saveMemory(sessionId, { ...currentState });
-                }
                 if (chunk.type === "transition") {
                     loopTransitionTo = String(chunk.transitionTo || "");
                     loopTransitionPayload = chunk.payload ?? {};
@@ -338,10 +347,9 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                         ...(workflowFinalState?.data ?? currentState.data ?? {}),
                         ...(transitionPayload ?? {}),
                     };
-                    const newInput = typeof transitionPayload?.rawInput ===
-                        "string"
-                        ? transitionPayload
-                            .rawInput
+                    const rawInputFromPayload = transitionPayload?.rawInput;
+                    const newInput = typeof rawInputFromPayload === "string"
+                        ? rawInputFromPayload
                         : currentState.input;
                     currentState = {
                         ...currentState,
@@ -350,9 +358,6 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
                         data: mergedData,
                         ui: {},
                     };
-                    if (saveMemory && sessionId) {
-                        await saveMemory(sessionId, currentState);
-                    }
                     currentGraph = nextGraph;
                     continue;
                 }
@@ -367,9 +372,30 @@ async function orchestrateGraphStream({ sessionId, graph, state, config, saveMem
             }
             if (workflowFinalState) {
                 if (workflowFinalState && pendingRecordToken) {
-                    (0, memory_1.updatePendingRequest)(pendingRecordToken, {
-                        state: workflowFinalState,
-                    });
+                    if (pendingStore) {
+                        await pendingStore.update(pendingRecordToken, {
+                            state: workflowFinalState,
+                        });
+                    }
+                }
+                const shouldKeepFrameworkState = Boolean(pendingRecordToken) ||
+                    Boolean(workflowFinalState?.awaitingHumanInput);
+                if (!shouldKeepFrameworkState) {
+                    try {
+                        if (frameworkAdapter?.cleanupRun) {
+                            await frameworkAdapter.cleanupRun(runId, Array.from(namespacesUsed));
+                        }
+                        else {
+                            const cp = currentGraph.config
+                                ?.checkpointer;
+                            if (cp?.deleteThread) {
+                                await cp.deleteThread(runId);
+                            }
+                        }
+                    }
+                    catch (e) {
+                        console.error("[orchestrator] framework cleanup failed", e);
+                    }
                 }
                 finished = true;
                 out.write({ type: "done", data: workflowFinalState });