@kortyx/agent 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.4.1](https://github.com/kortyx-io/kortyx/compare/agent-v0.4.0...agent-v0.4.1) (2026-02-15)
+
+
+### Bug Fixes
+
+* remove kortyx.config support and update docs ([ecb3f8d](https://github.com/kortyx-io/kortyx/commit/ecb3f8d53a017cc84bf8db3e125a6f711f5d4013))
+* remove kortyx.config support and update docs ([aa4a70a](https://github.com/kortyx-io/kortyx/commit/aa4a70a034dfec7bca829793f1729c51be018ae2))
+
+## [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)
 
 

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

@@ -1,4 +1,4 @@
-import type { KortyxConfig, WorkflowRegistry } from "@kortyx/runtime";
+import type { WorkflowRegistry } from "@kortyx/runtime";
 import type { SelectWorkflowFn } from "../orchestrator";
 import type { ChatMessage } from "../types/chat-message";
 import type { ProcessChatArgs } from "./process-chat";
@@ -7,8 +7,6 @@ export interface CreateAgentArgs<Config extends Record<string, unknown>, Options
     workflowRegistry?: WorkflowRegistry;
     selectWorkflow?: SelectWorkflowFn;
     fallbackWorkflowId?: string;
-    config?: KortyxConfig;
-    configPath?: string;
 }
 export declare function createAgent<Config extends Record<string, unknown>, Options = unknown>(args: CreateAgentArgs<Config, Options>): {
     processChat: (messages: ChatMessage[], options?: Options) => Promise<Response>;

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":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,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,EAAoB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAK1E,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;CAC7B;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;4BAkCN,WAAW,EAAE,YAAY,OAAO;EAiCjE"}

package/dist/chat/create-agent.js

@@ -5,7 +5,9 @@ const node_path_1 = require("node:path");
 const runtime_1 = require("@kortyx/runtime");
 const process_chat_1 = require("./process-chat");
 function createAgent(args) {
-    const { workflowsDir, workflowRegistry, selectWorkflow, fallbackWorkflowId, config, configPath, ...baseArgs } = args;
+    const { workflowsDir, workflowRegistry, selectWorkflow, fallbackWorkflowId, defaultWorkflowId, frameworkAdapter, ...baseArgs } = args;
+    const resolvedDefaultWorkflowId = defaultWorkflowId ?? fallbackWorkflowId;
+    const resolvedFrameworkAdapter = frameworkAdapter ?? (0, runtime_1.createFrameworkAdapterFromEnv)();
     const resolvedCwd = process.cwd();
     const registryPromise = (async () => {
         if (workflowRegistry)
@@ -16,23 +18,10 @@ function createAgent(args) {
                 fallbackId: fallbackWorkflowId ?? "general-chat",
             });
         }
-        const loadConfigArgs = {
-            cwd: resolvedCwd,
-            ...(configPath ? { configPath } : {}),
-        };
-        const loadedConfig = config ?? (await (0, runtime_1.loadKortyxConfig)(loadConfigArgs));
-        const resolvedWorkflowsDir = loadedConfig?.workflowsDir ?? (0, node_path_1.resolve)(resolvedCwd, "src", "workflows");
+        const resolvedWorkflowsDir = (0, node_path_1.resolve)(resolvedCwd, "src", "workflows");
         const registryOptions = {
             workflowsDir: resolvedWorkflowsDir,
-            fallbackId: loadedConfig?.fallbackWorkflowId ??
-                fallbackWorkflowId ??
-                "general-chat",
-            ...(loadedConfig?.registry?.cache !== undefined
-                ? { cache: loadedConfig.registry.cache }
-                : {}),
-            ...(loadedConfig?.registry?.extensions
-                ? { extensions: loadedConfig.registry.extensions }
-                : {}),
+            fallbackId: fallbackWorkflowId ?? "general-chat",
         };
         return (0, runtime_1.createFileWorkflowRegistry)(registryOptions);
     })();
@@ -41,9 +30,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 +45,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":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAe/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

@@ -2,15 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.orchestrateGraphStream = orchestrateGraphStream;
 const node_stream_1 = require("node:stream");
-const memory_1 = require("@kortyx/memory");
 const runtime_1 = require("@kortyx/runtime");
 const langgraph_1 = require("@langchain/langgraph");
 const transform_graph_stream_for_ui_1 = require("./stream/transform-graph-stream-for-ui");
-async function orchestrateGraphStream({ sessionId, graph, state, config, saveMemory, selectWorkflow, }) {
+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 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortyx/agent",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "private": false,
   "description": "Agent composition utilities for Kortyx.",
   "keywords": [
@@ -30,15 +30,23 @@
     "README.md",
     "CHANGELOG.md"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "predev": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "lint": "biome check src",
+    "test": "pnpm -s type-check",
+    "type-check": "tsc --noEmit"
+  },
   "dependencies": {
+    "@kortyx/core": "workspace:*",
+    "@kortyx/memory": "workspace:*",
+    "@kortyx/providers": "workspace:*",
+    "@kortyx/runtime": "workspace:*",
+    "@kortyx/stream": "workspace:*",
+    "@kortyx/utils": "workspace:*",
     "@langchain/core": "^1.0.1",
-    "@langchain/langgraph": "^1.0.1",
-    "@kortyx/core": "0.2.3",
-    "@kortyx/memory": "0.2.3",
-    "@kortyx/runtime": "0.3.0",
-    "@kortyx/providers": "0.2.3",
-    "@kortyx/stream": "0.2.3",
-    "@kortyx/utils": "0.2.3"
+    "@langchain/langgraph": "^1.0.1"
   },
   "devDependencies": {
     "turbo": "^2.5.4",
@@ -49,13 +57,5 @@
     "type": "git",
     "url": "https://github.com/kortyx-io/kortyx",
     "directory": "packages/agent"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "predev": "tsc -p tsconfig.build.json",
-    "dev": "tsc --watch",
-    "lint": "biome check src",
-    "test": "pnpm -s type-check",
-    "type-check": "tsc --noEmit"
   }
-}
+}

package/LICENSE

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.