@kortyx/runtime 0.3.0 → 0.4.0

package/dist/framework/redis/redis-client.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRedisClient = createRedisClient;
+const node_net_1 = require("node:net");
+const node_tls_1 = require("node:tls");
+const encodeBulk = (s) => {
+    const b = Buffer.from(s, "utf8");
+    return Buffer.concat([
+        Buffer.from(`$${b.length}\r\n`),
+        b,
+        Buffer.from("\r\n"),
+    ]);
+};
+const encodeCommand = (cmd, args) => {
+    const parts = [cmd, ...args];
+    const bufs = [Buffer.from(`*${parts.length}\r\n`)];
+    for (const p of parts)
+        bufs.push(encodeBulk(p));
+    return Buffer.concat(bufs);
+};
+function readLine(buf, start) {
+    const idx = buf.indexOf("\r\n", start);
+    if (idx === -1)
+        return null;
+    return { line: buf.slice(start, idx).toString("utf8"), next: idx + 2 };
+}
+function parseReply(buf, start) {
+    if (start >= buf.length)
+        return null;
+    const byte = buf[start];
+    if (byte === undefined)
+        return null;
+    const prefix = String.fromCharCode(byte);
+    if (prefix === "+" || prefix === "-" || prefix === ":") {
+        const line = readLine(buf, start + 1);
+        if (!line)
+            return null;
+        if (prefix === "+")
+            return { value: line.line, next: line.next };
+        if (prefix === ":")
+            return { value: Number.parseInt(line.line, 10), next: line.next };
+        return { value: { type: "error", message: line.line }, next: line.next };
+    }
+    if (prefix === "$") {
+        const line = readLine(buf, start + 1);
+        if (!line)
+            return null;
+        const len = Number.parseInt(line.line, 10);
+        if (len === -1)
+            return { value: null, next: line.next };
+        const end = line.next + len;
+        if (end + 2 > buf.length)
+            return null;
+        const data = buf.slice(line.next, end).toString("utf8");
+        return { value: data, next: end + 2 };
+    }
+    if (prefix === "*") {
+        const line = readLine(buf, start + 1);
+        if (!line)
+            return null;
+        const count = Number.parseInt(line.line, 10);
+        if (count === -1)
+            return { value: null, next: line.next };
+        const items = [];
+        let cursor = line.next;
+        for (let i = 0; i < count; i++) {
+            const parsed = parseReply(buf, cursor);
+            if (!parsed)
+                return null;
+            items.push(parsed.value);
+            cursor = parsed.next;
+        }
+        return { value: items, next: cursor };
+    }
+    return {
+        value: { type: "error", message: `Unknown RESP prefix: ${prefix}` },
+        next: buf.length,
+    };
+}
+function createRedisClient(options) {
+    const resolvedOptions = {
+        connectTimeoutMs: options.connectTimeoutMs ?? 5_000,
+        url: options.url,
+    };
+    let socket = null;
+    let buffer = Buffer.alloc(0);
+    const inflight = [];
+    let connecting = null;
+    let ready = false;
+    const drainReplies = () => {
+        while (inflight.length) {
+            const parsed = parseReply(buffer, 0);
+            if (!parsed)
+                return;
+            const waiter = inflight.shift();
+            buffer = buffer.slice(parsed.next);
+            waiter.resolve(parsed.value);
+        }
+    };
+    const send = (cmd, args = []) => {
+        if (!socket)
+            return Promise.reject(new Error("Redis socket not available"));
+        const payload = encodeCommand(cmd, args);
+        return new Promise((resolve, reject) => {
+            inflight.push({ resolve, reject });
+            socket.write(payload);
+        });
+    };
+    const ensureConnected = async () => {
+        if (ready)
+            return;
+        if (connecting)
+            return connecting;
+        connecting = (async () => {
+            const u = new URL(resolvedOptions.url);
+            const isTls = u.protocol === "rediss:";
+            const host = u.hostname || "127.0.0.1";
+            const port = u.port ? Number(u.port) : isTls ? 6380 : 6379;
+            const password = u.password ? decodeURIComponent(u.password) : "";
+            const db = u.pathname && u.pathname !== "/" ? Number(u.pathname.slice(1)) : 0;
+            const s = isTls
+                ? (0, node_tls_1.connect)({ host, port, servername: host })
+                : (0, node_net_1.connect)({ host, port });
+            socket = s;
+            s.setNoDelay(true);
+            s.setKeepAlive(true);
+            s.on("data", (chunk) => {
+                buffer = Buffer.concat([buffer, chunk]);
+                drainReplies();
+            });
+            s.on("error", (err) => {
+                ready = false;
+                while (inflight.length)
+                    inflight.shift().reject(err);
+            });
+            s.on("close", () => {
+                ready = false;
+                while (inflight.length)
+                    inflight.shift().reject(new Error("Redis socket closed"));
+            });
+            await new Promise((resolve, reject) => {
+                const timer = setTimeout(() => reject(new Error("Redis connect timeout")), resolvedOptions.connectTimeoutMs);
+                const onConnect = () => {
+                    clearTimeout(timer);
+                    resolve();
+                };
+                s.once("connect", onConnect);
+                s.once?.("secureConnect", onConnect);
+                s.once("error", (e) => {
+                    clearTimeout(timer);
+                    reject(e);
+                });
+            });
+            if (password) {
+                const r = await send("AUTH", [password]);
+                if (typeof r === "object" && r && r.type === "error") {
+                    throw new Error(`Redis AUTH failed: ${r.message}`);
+                }
+            }
+            if (db && Number.isFinite(db) && db > 0) {
+                const r = await send("SELECT", [String(db)]);
+                if (typeof r === "object" && r && r.type === "error") {
+                    throw new Error(`Redis SELECT failed: ${r.message}`);
+                }
+            }
+            ready = true;
+        })();
+        try {
+            await connecting;
+        }
+        finally {
+            connecting = null;
+        }
+    };
+    return {
+        async command(cmd, args = []) {
+            await ensureConnected();
+            return send(cmd, args);
+        },
+    };
+}

package/dist/framework/redis/redis-store.d.ts

@@ -0,0 +1,20 @@
+export type RedisFrameworkStoreOptions = {
+    url: string;
+    prefix?: string;
+};
+export type FrameworkTtl = {
+    ttlMs: number;
+};
+export type RedisFrameworkStore = {
+    get: (key: string) => Promise<string | null>;
+    set: (key: string, value: string, ttlMs: number) => Promise<void>;
+    del: (key: string) => Promise<void>;
+    hset: (key: string, field: string, value: string) => Promise<void>;
+    hsetnx: (key: string, field: string, value: string) => Promise<number>;
+    hgetall: (key: string) => Promise<Record<string, string>>;
+    expire: (key: string, ttlMs: number) => Promise<void>;
+    scanKeys: (prefix: string) => Promise<string[]>;
+    delRaw: (keys: string[]) => Promise<void>;
+};
+export declare function createRedisFrameworkStore(options: RedisFrameworkStoreOptions): RedisFrameworkStore;
+//# sourceMappingURL=redis-store.d.ts.map

package/dist/framework/redis/redis-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../../src/framework/redis/redis-store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC;AAMF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAwGrB"}

package/dist/framework/redis/redis-store.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRedisFrameworkStore = createRedisFrameworkStore;
+const redis_client_1 = require("./redis-client");
+const isRedisError = (r) => Boolean(r) && typeof r === "object" && r.type === "error";
+function createRedisFrameworkStore(options) {
+    const client = (0, redis_client_1.createRedisClient)({ url: options.url });
+    const prefix = options.prefix ?? "kortyx:fw:";
+    const k = (key) => `${prefix}${key}`;
+    return {
+        async get(key) {
+            const r = await client.command("GET", [k(key)]);
+            if (r === null)
+                return null;
+            if (typeof r === "string")
+                return r;
+            if (isRedisError(r)) {
+                throw new Error(`Redis GET error: ${r.message}`);
+            }
+            return null;
+        },
+        async set(key, value, ttlMs) {
+            const args = [k(key), value, "PX", String(Math.max(1, ttlMs))];
+            const r = await client.command("SET", args);
+            if (isRedisError(r)) {
+                throw new Error(`Redis SET error: ${r.message}`);
+            }
+        },
+        async del(key) {
+            const r = await client.command("DEL", [k(key)]);
+            if (isRedisError(r)) {
+                throw new Error(`Redis DEL error: ${r.message}`);
+            }
+        },
+        async hset(key, field, value) {
+            const r = await client.command("HSET", [k(key), field, value]);
+            if (isRedisError(r)) {
+                throw new Error(`Redis HSET error: ${r.message}`);
+            }
+        },
+        async hsetnx(key, field, value) {
+            const r = await client.command("HSETNX", [k(key), field, value]);
+            if (isRedisError(r)) {
+                throw new Error(`Redis HSETNX error: ${r.message}`);
+            }
+            return typeof r === "number" ? r : 0;
+        },
+        async hgetall(key) {
+            const r = await client.command("HGETALL", [k(key)]);
+            if (isRedisError(r)) {
+                throw new Error(`Redis HGETALL error: ${r.message}`);
+            }
+            if (!Array.isArray(r))
+                return {};
+            const out = {};
+            for (let i = 0; i < r.length; i += 2) {
+                const kk = r[i];
+                const v = r[i + 1];
+                if (typeof kk === "string" && typeof v === "string")
+                    out[kk] = v;
+            }
+            return out;
+        },
+        async expire(key, ttlMs) {
+            const r = await client.command("PEXPIRE", [
+                k(key),
+                String(Math.max(1, ttlMs)),
+            ]);
+            if (isRedisError(r)) {
+                throw new Error(`Redis PEXPIRE error: ${r.message}`);
+            }
+        },
+        async scanKeys(prefixKey) {
+            const fullPrefix = k(prefixKey);
+            let cursor = "0";
+            const keys = [];
+            do {
+                const r = await client.command("SCAN", [
+                    cursor,
+                    "MATCH",
+                    `${fullPrefix}*`,
+                    "COUNT",
+                    "200",
+                ]);
+                if (!Array.isArray(r) || r.length < 2)
+                    break;
+                cursor = typeof r[0] === "string" ? r[0] : "0";
+                const batch = r[1];
+                if (Array.isArray(batch)) {
+                    for (const key of batch) {
+                        if (typeof key === "string")
+                            keys.push(key);
+                    }
+                }
+            } while (cursor !== "0");
+            return keys;
+        },
+        async delRaw(keys) {
+            if (keys.length === 0)
+                return;
+            const r = await client.command("DEL", keys);
+            if (isRedisError(r)) {
+                throw new Error(`Redis DEL error: ${r.message}`);
+            }
+        },
+    };
+}

package/dist/graph/create-langgraph.d.ts

@@ -1,6 +1,7 @@
-import type { Edge, GraphState, NodeMap, WorkflowDefinition } from "@kortyx/core";
+import type { GraphState, WorkflowDefinition } from "@kortyx/core";
 import type { MemoryAdapter } from "@kortyx/memory";
 import type { GetProviderFn } from "@kortyx/providers";
+import type { BaseCheckpointSaver } from "@langchain/langgraph-checkpoint";
 export interface GraphRuntimeConfig {
     emit?: (event: string, payload: unknown) => void;
     onCheckpoint?: (args: {
@@ -8,8 +9,9 @@ export interface GraphRuntimeConfig {
         state: GraphState;
     }) => void;
     memoryAdapter?: MemoryAdapter;
+    checkpointer?: BaseCheckpointSaver;
     getProvider?: GetProviderFn;
     [key: string]: unknown;
 }
-export declare function createLangGraph<const N extends NodeMap, const E extends readonly Edge<(keyof N & string) | "__start__", (keyof N & string) | "__end__">[]>(workflow: WorkflowDefinition<N, E>, config: GraphRuntimeConfig): Promise<any>;
+export declare function createLangGraph(workflow: WorkflowDefinition, config: GraphRuntimeConfig): Promise<any>;
 //# sourceMappingURL=create-langgraph.d.ts.map

package/dist/graph/create-langgraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-langgraph.d.ts","sourceRoot":"","sources":["../../src/graph/create-langgraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,IAAI,EACJ,UAAU,EAGV,OAAO,EAEP,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUvD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,aAAa,CAAC,EAAE,aAAa,CAAC;IAK9B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,eAAe,CACnC,KAAK,CAAC,CAAC,SAAS,OAAO,EACvB,KAAK,CAAC,CAAC,SAAS,SAAS,IAAI,CAC3B,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,WAAW,EAChC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,SAAS,CAC/B,EAAE,EACH,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,gBA4Y/D"}
+{"version":3,"file":"create-langgraph.d.ts","sourceRoot":"","sources":["../../src/graph/create-langgraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAIV,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAI3E,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAKnC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,kBAAkB,gBA2b3B"}

package/dist/graph/create-langgraph.js

@@ -6,6 +6,7 @@ const utils_1 = require("@kortyx/utils");
 const messages_1 = require("@langchain/core/messages");
 const langgraph_1 = require("@langchain/langgraph");
 const checkpointer_1 = require("../checkpointer");
+const node_loader_1 = require("../node-loader");
 async function createLangGraph(workflow, config) {
     const StateAnnotation = langgraph_1.Annotation.Root({
         input: (langgraph_1.Annotation),
@@ -31,14 +32,44 @@ async function createLangGraph(workflow, config) {
     });
     const builder = new langgraph_1.StateGraph(StateAnnotation);
     const edgeApi = builder;
-    const workflowName = workflow.name;
+    const workflowName = workflow.id;
     const runtimeConfig = config;
     if (!runtimeConfig.emit) {
         runtimeConfig.emit = () => { };
     }
-    const nodesMap = workflow.nodes;
-    for (const [nodeId, node] of Object.entries(nodesMap)) {
-        const nodeConfig = node.config ?? {};
+    const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+    const toRecordInput = (value) => {
+        if (isRecord(value))
+            return value;
+        if (value === undefined)
+            return {};
+        return { rawInput: value };
+    };
+    const buildNodeConfig = (params, nodeBehavior) => {
+        const model = isRecord(params?.model) ? params.model : undefined;
+        const tool = isRecord(params?.tool) ? params.tool : undefined;
+        const behaviorFromParams = isRecord(params?.behavior)
+            ? params.behavior
+            : undefined;
+        const behavior = {
+            ...(behaviorFromParams ?? {}),
+            ...(nodeBehavior ?? {}),
+        };
+        const options = params ?? undefined;
+        return {
+            ...(model ? { model } : {}),
+            ...(tool ? { tool } : {}),
+            ...(Object.keys(behavior).length > 0 ? { behavior } : {}),
+            ...(options ? { options } : {}),
+        };
+    };
+    for (const [nodeId, nodeDef] of Object.entries(workflow.nodes ?? {})) {
+        const resolvedRun = await (0, node_loader_1.resolveNodeHandler)({
+            run: nodeDef.run,
+            workflow,
+        });
+        const nodeParams = (nodeDef.params ?? undefined);
+        const nodeConfig = buildNodeConfig(nodeParams, (nodeDef.behavior ?? undefined));
         const behavior = nodeConfig.behavior ?? {};
         builder.addNode(nodeId, async (state) => {
             const ctx = {
@@ -108,23 +139,10 @@ async function createLangGraph(workflow, config) {
                         ...(args.system ? [new messages_1.SystemMessage(args.system)] : []),
                         new messages_1.HumanMessage(args.user ?? ""),
                     ];
-                    const minChars = args.stream?.minChars ?? 24;
-                    const flushMs = args.stream?.flushMs ?? 100;
-                    const segmentChars = args.stream?.segmentChars ?? 60;
                     let final = "";
-                    let buffer = "";
-                    let timer = null;
                     const t0 = Date.now();
                     let seenFirst = false;
                     const isSilent = false;
-                    const flush = () => {
-                        if (!buffer)
-                            return;
-                        if (!isSilent)
-                            ctx.emit("text-delta", { node: nodeId, delta: buffer });
-                        buffer = "";
-                        timer = null;
-                    };
                     if (!isSilent)
                         ctx.emit("text-start", { node: nodeId });
                     const stream = await model.stream(messages);
@@ -141,20 +159,9 @@ async function createLangGraph(workflow, config) {
                             });
                         }
                         final += part;
-                        for (let i = 0; i < part.length; i += segmentChars) {
-                            const seg = part.slice(i, i + segmentChars);
-                            buffer += seg;
-                            if (buffer.length >= minChars) {
-                                flush();
-                            }
-                            else if (!timer) {
-                                timer = setTimeout(flush, flushMs);
-                            }
-                        }
+                        if (!isSilent)
+                            ctx.emit("text-delta", { node: nodeId, delta: part });
                     }
-                    if (timer)
-                        clearTimeout(timer);
-                    flush();
                     if (!isSilent)
                         ctx.emit("text-end", { node: nodeId });
                     const t1 = Date.now();
@@ -173,12 +180,19 @@ async function createLangGraph(workflow, config) {
             let attempt = 0;
             let nodeResult;
             let hookMemoryUpdates = null;
+            let retryHookMemory = null;
             while (attempt < maxAttempts) {
                 try {
                     attempt++;
+                    const attemptState = retryHookMemory && typeof retryHookMemory === "object"
+                        ? {
+                            ...state,
+                            memory: (0, utils_1.deepMergeWithArrayOverwrite)((state.memory ?? {}), retryHookMemory),
+                        }
+                        : state;
                     const hookContext = {
                         node: ctx,
-                        state,
+                        state: attemptState,
                         ...(runtimeConfig.getProvider
                             ? { getProvider: runtimeConfig.getProvider }
                             : {}),
@@ -186,12 +200,19 @@ async function createLangGraph(workflow, config) {
                             ? { memoryAdapter: runtimeConfig.memoryAdapter }
                             : {}),
                     };
-                    const hookRun = await (0, hooks_1.runWithHookContext)(hookContext, () => node.run(state, ctx));
+                    const hookRun = await (0, hooks_1.runWithHookContext)(hookContext, async () => resolvedRun({
+                        input: state.input,
+                        params: (nodeParams ?? {}),
+                    }));
                     nodeResult = hookRun.result;
                     hookMemoryUpdates = hookRun.memoryUpdates;
                     break;
                 }
                 catch (err) {
+                    const patch = err?.__kortyxMemoryUpdates;
+                    if (patch && typeof patch === "object") {
+                        retryHookMemory = (0, utils_1.deepMergeWithArrayOverwrite)((retryHookMemory ?? {}), patch);
+                    }
                     const hasMore = attempt < maxAttempts;
                     const delayMs = behavior.retry?.delayMs ?? 0;
                     if (hasMore && delayMs > 0) {
@@ -226,6 +247,7 @@ async function createLangGraph(workflow, config) {
             if (typeof res.intent === "string")
                 updates.lastIntent = res.intent;
             if (res.data && typeof res.data === "object") {
+                updates.input = (0, utils_1.deepMergeWithArrayOverwrite)(toRecordInput(state.input), res.data);
                 updates.data = (0, utils_1.deepMergeWithArrayOverwrite)((state.data ?? {}), res.data);
             }
             if (res.infra?.memory && typeof res.infra.memory === "object") {
@@ -295,10 +317,10 @@ async function createLangGraph(workflow, config) {
         }, mapping);
     }
     const sessionId = config?.session?.id ?? "__default__";
-    const checkpointer = (0, checkpointer_1.getCheckpointer)(sessionId);
+    const checkpointer = config.checkpointer ?? (0, checkpointer_1.getCheckpointer)(sessionId);
     const graph = builder.compile({ checkpointer });
     const runtimeGraph = graph;
-    runtimeGraph.name = workflow.name;
+    runtimeGraph.name = workflow.id;
     runtimeGraph.config = config;
     runtimeGraph.resume = async (state, input) => {
         const resumed = { ...state, input, awaitingHumanInput: false };

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 export * from "./checkpointer";
 export * from "./config/load-kortyx-config";
+export * from "./framework/adapter";
+export * from "./framework/pending-requests";
 export * from "./graph/create-langgraph";
 export * from "./interrupt/tokens";
+export * from "./node-registry";
 export * from "./registry/file-registry";
+export * from "./registry/in-memory-registry";
 export * from "./registry/interface";
 export * from "./state/build-initial-state";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -16,8 +16,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./checkpointer"), exports);
 __exportStar(require("./config/load-kortyx-config"), exports);
+__exportStar(require("./framework/adapter"), exports);
+__exportStar(require("./framework/pending-requests"), exports);
 __exportStar(require("./graph/create-langgraph"), exports);
 __exportStar(require("./interrupt/tokens"), exports);
+__exportStar(require("./node-registry"), exports);
 __exportStar(require("./registry/file-registry"), exports);
+__exportStar(require("./registry/in-memory-registry"), exports);
 __exportStar(require("./registry/interface"), exports);
 __exportStar(require("./state/build-initial-state"), exports);

package/dist/node-loader.d.ts

@@ -0,0 +1,7 @@
+import type { NodeFn, WorkflowDefinition } from "@kortyx/core";
+export declare function resolveNodeHandler(args: {
+    run: string | NodeFn;
+    workflow?: WorkflowDefinition;
+    cwd?: string;
+}): Promise<NodeFn>;
+//# sourceMappingURL=node-loader.d.ts.map

package/dist/node-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-loader.d.ts","sourceRoot":"","sources":["../src/node-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAsD/D,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BlB"}

package/dist/node-loader.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNodeHandler = resolveNodeHandler;
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const node_registry_1 = require("./node-registry");
+const dynamicImport = new Function("specifier", "return import(specifier)");
+function looksLikePath(specifier) {
+    if (specifier.startsWith("file:"))
+        return true;
+    if (specifier.startsWith("./") || specifier.startsWith("../"))
+        return true;
+    if (specifier.startsWith("/"))
+        return true;
+    return specifier.includes("/");
+}
+function getWorkflowBaseDir(workflow, cwd) {
+    const meta = workflow?.metadata;
+    const filePath = meta?.__filePath;
+    if (typeof filePath === "string" && filePath.length > 0) {
+        return (0, node_path_1.dirname)(filePath);
+    }
+    return cwd;
+}
+function pickNodeExport(mod, exportName) {
+    if (exportName) {
+        const candidate = mod[exportName];
+        if (typeof candidate === "function")
+            return candidate;
+        throw new Error(`Node export "${exportName}" not found or not a function.`);
+    }
+    const defaultExport = mod.default;
+    if (typeof defaultExport === "function")
+        return defaultExport;
+    const fnExports = Object.entries(mod).filter(([, v]) => typeof v === "function");
+    if (fnExports.length === 1)
+        return fnExports[0][1];
+    const names = fnExports.map(([k]) => k).sort();
+    throw new Error(`Node module must export a default function or exactly one named function (found: ${names.join(", ") || "none"}).`);
+}
+async function resolveNodeHandler(args) {
+    const { run, workflow } = args;
+    const cwd = args.cwd ?? process.cwd();
+    if (typeof run === "function")
+        return run;
+    if (looksLikePath(run)) {
+        const [moduleRef, exportName] = run.split("#", 2);
+        const baseDir = getWorkflowBaseDir(workflow, cwd);
+        const specifier = moduleRef.startsWith("file:")
+            ? moduleRef
+            : (0, node_path_1.isAbsolute)(moduleRef)
+                ? (0, node_url_1.pathToFileURL)(moduleRef).href
+                : (0, node_url_1.pathToFileURL)((0, node_path_1.resolve)(baseDir, moduleRef)).href;
+        const mod = await dynamicImport(specifier);
+        return pickNodeExport(mod, exportName);
+    }
+    return (0, node_registry_1.resolveNode)(run);
+}

package/dist/node-registry.d.ts

@@ -0,0 +1,7 @@
+import type { NodeFn } from "@kortyx/core";
+export declare function registerNode(id: string, fn: NodeFn): void;
+export declare function getRegisteredNode(id: string): NodeFn | null;
+export declare function listRegisteredNodes(): string[];
+export declare function clearRegisteredNodes(): void;
+export declare function resolveNode(id: string): NodeFn;
+//# sourceMappingURL=node-registry.d.ts.map

package/dist/node-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-registry.d.ts","sourceRoot":"","sources":["../src/node-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ9C"}

package/dist/node-registry.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNode = registerNode;
+exports.getRegisteredNode = getRegisteredNode;
+exports.listRegisteredNodes = listRegisteredNodes;
+exports.clearRegisteredNodes = clearRegisteredNodes;
+exports.resolveNode = resolveNode;
+const registry = new Map();
+function registerNode(id, fn) {
+    registry.set(id, fn);
+}
+function getRegisteredNode(id) {
+    return registry.get(id) ?? null;
+}
+function listRegisteredNodes() {
+    return [...registry.keys()].sort();
+}
+function clearRegisteredNodes() {
+    registry.clear();
+}
+function resolveNode(id) {
+    const fn = registry.get(id);
+    if (!fn) {
+        throw new Error(`Node '${id}' is not registered. Call registerNode('${id}', fn) before running workflows that reference it.`);
+    }
+    return fn;
+}

package/dist/registry/file-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-registry.d.ts","sourceRoot":"","sources":["../../src/registry/file-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAeD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CAgGlB"}
+{"version":3,"file":"file-registry.d.ts","sourceRoot":"","sources":["../../src/registry/file-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AA0BD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CAgHlB"}