@kortyx/agent 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.5.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.4.1...agent-v0.5.0) (2026-02-17)
+
+
+### Features
+
+* **agent:** strict createAgent and unify useReason streaming ([6725f97](https://github.com/kortyx-io/kortyx/commit/6725f976fc32083fb7d2590f1353d16a99afb46f))
+* **kortyx:** add browser-safe chat streaming adapters ([c7eb98e](https://github.com/kortyx-io/kortyx/commit/c7eb98e06781a708c79f143ba725efb69d35709e))
+* make createAgent strict/declarative and split providers ([1d252f2](https://github.com/kortyx-io/kortyx/commit/1d252f2dcd51622f821715c0fffb13733aeb3cae))
+
+
+### Bug Fixes
+
+* **agent:** remove eager provider registration guard ([8da4059](https://github.com/kortyx-io/kortyx/commit/8da40592d55bb31800a4d85edcd49795ddf09a29))
+* **agent:** simplify stream transformer and interrupt orchestration ([d0b5847](https://github.com/kortyx-io/kortyx/commit/d0b58475e139e070fd9ca1a68b71395642ac32d5))
+
+## [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)
 
 

package/dist/adapters/http-client.d.ts

@@ -0,0 +1,12 @@
+import { type StreamChunk } from "@kortyx/stream/browser";
+import type { ChatMessage } from "../types/chat-message";
+export interface StreamChatFromRouteArgs {
+    endpoint: string;
+    sessionId: string;
+    workflowId?: string | undefined;
+    messages: ChatMessage[];
+    fetchImpl?: typeof fetch;
+    headers?: Record<string, string> | undefined;
+}
+export declare function streamChatFromRoute(args: StreamChatFromRouteArgs): AsyncGenerator<StreamChunk, void, void>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/adapters/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/adapters/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC9C;AAED,wBAAuB,mBAAmB,CACxC,IAAI,EAAE,uBAAuB,GAC5B,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAWzC"}

package/dist/adapters/http-client.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamChatFromRoute = streamChatFromRoute;
+const browser_1 = require("@kortyx/stream/browser");
+async function* streamChatFromRoute(args) {
+    yield* (0, browser_1.streamFromRoute)({
+        endpoint: args.endpoint,
+        ...(args.fetchImpl ? { fetchImpl: args.fetchImpl } : {}),
+        ...(args.headers ? { headers: args.headers } : {}),
+        body: {
+            sessionId: args.sessionId,
+            ...(args.workflowId ? { workflowId: args.workflowId } : {}),
+            messages: args.messages,
+        },
+    });
+}

package/dist/adapters/http.d.ts

@@ -0,0 +1,17 @@
+import type { Agent } from "../chat/create-agent";
+import type { ChatMessage } from "../types/chat-message";
+export type ChatRequestBody = {
+    sessionId: string;
+    workflowId?: string | undefined;
+    messages: ChatMessage[];
+};
+export declare function parseChatRequestBody(value: unknown): ChatRequestBody;
+export declare function processChatRequestBody(args: {
+    agent: Agent;
+    body: ChatRequestBody;
+}): Promise<Response>;
+export declare function createChatRouteHandler(args: {
+    agent: Agent;
+    errorStatus?: number | undefined;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/adapters/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/adapters/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC;AA4BF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAapE;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;CACvB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMpB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAqB1C"}

package/dist/adapters/http.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseChatRequestBody = parseChatRequestBody;
+exports.processChatRequestBody = processChatRequestBody;
+exports.createChatRouteHandler = createChatRouteHandler;
+const zod_1 = require("zod");
+const chatMessageSchema = zod_1.z
+    .object({
+    role: zod_1.z.enum(["user", "assistant", "system"]),
+    content: zod_1.z.string(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional(),
+    id: zod_1.z.string().optional(),
+    timestamp: zod_1.z.number().finite().optional(),
+})
+    .strict();
+const chatRequestBodySchema = zod_1.z
+    .object({
+    sessionId: zod_1.z
+        .string()
+        .transform((value) => value.trim())
+        .refine((value) => value.length > 0, {
+        message: "`sessionId` is required.",
+    }),
+    workflowId: zod_1.z.string().optional(),
+    messages: zod_1.z.array(chatMessageSchema),
+})
+    .strict();
+const toErrorMessage = (error) => error instanceof Error ? error.message : String(error);
+function parseChatRequestBody(value) {
+    const parsed = chatRequestBodySchema.safeParse(value);
+    if (!parsed.success) {
+        throw new Error(parsed.error.issues[0]?.message ?? "Invalid chat request.");
+    }
+    const workflowId = parsed.data.workflowId?.trim();
+    return {
+        sessionId: parsed.data.sessionId,
+        ...(workflowId ? { workflowId } : {}),
+        messages: parsed.data.messages,
+    };
+}
+async function processChatRequestBody(args) {
+    const { agent, body } = args;
+    return agent.processChat(body.messages, {
+        sessionId: body.sessionId,
+        ...(body.workflowId ? { workflowId: body.workflowId } : {}),
+    });
+}
+function createChatRouteHandler(args) {
+    const { agent, errorStatus = 400 } = args;
+    return async function POST(request) {
+        try {
+            const body = parseChatRequestBody(await request.json());
+            return await processChatRequestBody({ agent, body });
+        }
+        catch (error) {
+            return new Response(JSON.stringify({
+                error: toErrorMessage(error),
+            }), {
+                status: errorStatus,
+                headers: {
+                    "content-type": "application/json",
+                },
+            });
+        }
+    };
+}

package/dist/browser.d.ts

@@ -0,0 +1,3 @@
+export type { StreamChatFromRouteArgs } from "./adapters/http-client";
+export { streamChatFromRoute } from "./adapters/http-client";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/browser.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamChatFromRoute = void 0;
+var http_client_1 = require("./adapters/http-client");
+Object.defineProperty(exports, "streamChatFromRoute", { enumerable: true, get: function () { return http_client_1.streamChatFromRoute; } });

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

@@ -1,16 +1,33 @@
-import type { KortyxConfig, WorkflowRegistry } from "@kortyx/runtime";
-import type { SelectWorkflowFn } from "../orchestrator";
+import type { WorkflowDefinition } from "@kortyx/core";
+import { type GetProviderFn } from "@kortyx/providers";
+import type { FrameworkAdapter, WorkflowRegistry } from "@kortyx/runtime";
 import type { ChatMessage } from "../types/chat-message";
-import type { ProcessChatArgs } from "./process-chat";
-export interface CreateAgentArgs<Config extends Record<string, unknown>, Options> extends Omit<ProcessChatArgs<Config, Options>, "messages" | "options" | "selectWorkflow" | "workflowRegistry"> {
+export interface AgentSessionConfig {
+    id?: string | undefined;
+}
+export interface AgentMemoryConfig {
+    enabled?: boolean | undefined;
+    namespace?: string | undefined;
+    ttlMs?: number | undefined;
+}
+export interface AgentProcessOptions {
+    sessionId?: string | undefined;
+    workflowId?: string | undefined;
+    workflow?: string | undefined;
+}
+export interface CreateAgentArgs {
+    getProvider?: GetProviderFn | undefined;
+    workflows?: WorkflowDefinition[];
     workflowsDir?: string;
     workflowRegistry?: WorkflowRegistry;
-    selectWorkflow?: SelectWorkflowFn;
     fallbackWorkflowId?: string;
-    config?: KortyxConfig;
-    configPath?: string;
+    defaultWorkflowId?: string;
+    frameworkAdapter?: FrameworkAdapter;
+    session?: AgentSessionConfig;
+    memory?: AgentMemoryConfig;
+}
+export interface Agent {
+    processChat: (messages: ChatMessage[], options?: AgentProcessOptions) => Promise<Response>;
 }
-export declare function createAgent<Config extends Record<string, unknown>, Options = unknown>(args: CreateAgentArgs<Config, Options>): {
-    processChat: (messages: ChatMessage[], options?: Options) => Promise<Response>;
-};
+export declare function createAgent(args: CreateAgentArgs): Agent;
 //# sourceMappingURL=create-agent.d.ts.map

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,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"}
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../../src/chat/create-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAO1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,CACX,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AA6FD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CA6ExD"}

package/dist/chat/create-agent.js

@@ -2,69 +2,136 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgent = createAgent;
 const node_path_1 = require("node:path");
+const memory_1 = require("@kortyx/memory");
+const providers_1 = require("@kortyx/providers");
 const runtime_1 = require("@kortyx/runtime");
+const zod_1 = require("zod");
 const process_chat_1 = require("./process-chat");
+const agentProcessOptionsSchema = zod_1.z
+    .object({
+    sessionId: zod_1.z.string().optional(),
+    workflowId: zod_1.z.string().optional(),
+    workflow: zod_1.z.string().optional(),
+})
+    .strict();
+const createAgentArgsBaseSchema = zod_1.z
+    .object({
+    getProvider: zod_1.z.unknown().optional(),
+    workflows: zod_1.z.array(zod_1.z.unknown()).optional(),
+    workflowsDir: zod_1.z.string().optional(),
+    workflowRegistry: zod_1.z.unknown().optional(),
+    fallbackWorkflowId: zod_1.z.string().optional(),
+    defaultWorkflowId: zod_1.z.string().optional(),
+    frameworkAdapter: zod_1.z.unknown().optional(),
+    session: zod_1.z
+        .object({
+        id: zod_1.z.string().optional(),
+    })
+        .strict()
+        .optional(),
+    memory: zod_1.z
+        .object({
+        enabled: zod_1.z.boolean().optional(),
+        namespace: zod_1.z.string().optional(),
+        ttlMs: zod_1.z.number().finite().positive().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+const createAgentArgsSchema = createAgentArgsBaseSchema.superRefine((value, ctx) => {
+    if (value.getProvider !== undefined &&
+        typeof value.getProvider !== "function") {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Expected `args.getProvider` to be a function.",
+            path: ["getProvider"],
+        });
+    }
+    const workflowSources = [
+        value.workflows !== undefined,
+        value.workflowsDir !== undefined,
+        value.workflowRegistry !== undefined,
+    ].filter(Boolean).length;
+    if (workflowSources > 1) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Use only one workflow source: `workflows`, `workflowsDir`, or `workflowRegistry`.",
+        });
+    }
+});
+const parseSchema = (schema, value) => {
+    const parsed = schema.safeParse(value);
+    if (parsed.success)
+        return parsed.data;
+    const firstIssue = parsed.error.issues[0];
+    throw new Error(firstIssue?.message ?? "Invalid configuration.");
+};
+const parseCreateAgentArgs = (value) => parseSchema(createAgentArgsSchema, value);
+const parseAgentProcessOptions = (value) => {
+    if (value === undefined)
+        return undefined;
+    return parseSchema(agentProcessOptionsSchema, value);
+};
+const resolveMemoryAdapter = (memory) => {
+    if (memory?.enabled === false)
+        return undefined;
+    return (0, memory_1.createInMemoryAdapter)({
+        namespace: memory?.namespace ?? "kortyx-agent",
+        ttlMs: memory?.ttlMs ?? 1000 * 60 * 60,
+    });
+};
 function createAgent(args) {
-    const { workflowsDir, workflowRegistry, selectWorkflow, fallbackWorkflowId, config, configPath, defaultWorkflowId, frameworkAdapter, ...baseArgs } = args;
-    const resolvedDefaultWorkflowId = defaultWorkflowId ?? config?.fallbackWorkflowId ?? fallbackWorkflowId;
+    const parsedArgs = parseCreateAgentArgs(args);
+    const { getProvider, workflows, workflowsDir, workflowRegistry, fallbackWorkflowId, defaultWorkflowId, frameworkAdapter, session, memory, } = parsedArgs;
+    const resolvedDefaultWorkflowId = defaultWorkflowId ?? fallbackWorkflowId;
     const resolvedFrameworkAdapter = frameworkAdapter ?? (0, runtime_1.createFrameworkAdapterFromEnv)();
+    const defaultSessionId = session?.id ?? "anonymous-session";
+    const memoryAdapter = resolveMemoryAdapter(memory);
+    const resolvedGetProvider = getProvider ?? providers_1.getProvider;
     const resolvedCwd = process.cwd();
     const registryPromise = (async () => {
         if (workflowRegistry)
             return workflowRegistry;
+        if (workflows) {
+            return (0, runtime_1.createInMemoryWorkflowRegistry)(workflows, {
+                fallbackId: fallbackWorkflowId ?? "general-chat",
+            });
+        }
         if (workflowsDir) {
             return (0, runtime_1.createFileWorkflowRegistry)({
                 workflowsDir,
                 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 registryOptions = {
+        const resolvedWorkflowsDir = (0, node_path_1.resolve)(resolvedCwd, "src", "workflows");
+        return (0, runtime_1.createFileWorkflowRegistry)({
             workflowsDir: resolvedWorkflowsDir,
-            fallbackId: loadedConfig?.fallbackWorkflowId ??
-                fallbackWorkflowId ??
-                "general-chat",
-            ...(loadedConfig?.registry?.cache !== undefined
-                ? { cache: loadedConfig.registry.cache }
-                : {}),
-            ...(loadedConfig?.registry?.extensions
-                ? { extensions: loadedConfig.registry.extensions }
-                : {}),
-        };
-        return (0, runtime_1.createFileWorkflowRegistry)(registryOptions);
+            fallbackId: fallbackWorkflowId ?? "general-chat",
+        });
     })();
     return {
         processChat: async (messages, options) => {
-            if (selectWorkflow) {
-                return (0, process_chat_1.processChat)({
-                    ...baseArgs,
-                    ...(resolvedDefaultWorkflowId
-                        ? { defaultWorkflowId: resolvedDefaultWorkflowId }
-                        : {}),
-                    messages,
-                    options,
-                    selectWorkflow,
-                    frameworkAdapter: resolvedFrameworkAdapter,
-                });
-            }
+            const parsedOptions = parseAgentProcessOptions(options);
             const registry = await registryPromise;
             if (!registry) {
-                throw new Error("createAgent requires workflowsDir, workflowRegistry, or selectWorkflow.");
+                throw new Error("createAgent requires workflows, workflowsDir, or workflowRegistry.");
             }
             return (0, process_chat_1.processChat)({
-                ...baseArgs,
                 ...(resolvedDefaultWorkflowId
                     ? { defaultWorkflowId: resolvedDefaultWorkflowId }
                     : {}),
                 messages,
-                options,
+                options: parsedOptions,
                 workflowRegistry: registry,
                 frameworkAdapter: resolvedFrameworkAdapter,
+                getProvider: resolvedGetProvider,
+                ...(memoryAdapter ? { memoryAdapter } : {}),
+                loadRuntimeConfig: (runtimeOptions) => ({
+                    session: {
+                        id: runtimeOptions?.sessionId ?? defaultSessionId,
+                    },
+                }),
             });
         },
     };

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

@@ -4,23 +4,24 @@ 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";
-type InitializeProvidersFn<Config> = (aiConfig: Config extends {
-    ai: infer A;
-} ? A : unknown) => void;
-export interface ProcessChatArgs<Config extends Record<string, unknown>, Options> {
+export interface RuntimeConfig {
+    session?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+export interface ProcessChatArgs<Options> {
     messages: ChatMessage[];
     options?: Options | undefined;
     sessionId?: string;
     defaultWorkflowId?: string;
-    loadRuntimeConfig: (options?: Options) => Config | Promise<Config>;
+    loadRuntimeConfig: (options?: Options) => RuntimeConfig | Promise<RuntimeConfig>;
     selectWorkflow?: SelectWorkflowFn;
     workflowRegistry?: WorkflowRegistry;
     frameworkAdapter?: FrameworkAdapter;
     getProvider: GetProviderFn;
-    initializeProviders?: InitializeProvidersFn<Config>;
     memoryAdapter?: MemoryAdapter;
     applyResumeSelection?: ApplyResumeSelection;
 }
-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 {};
+export declare function processChat<Options = unknown>({ messages, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, frameworkAdapter, getProvider, memoryAdapter, applyResumeSelection, }: ProcessChatArgs<Options>): Promise<Response>;
 //# 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,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"}
+{"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,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe,CAAC,OAAO;IACtC,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,CACjB,OAAO,CAAC,EAAE,OAAO,KACd,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,EAAE,aAAa,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAG,OAAO,EAAE,EACnD,QAAQ,EACR,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqF9C"}

package/dist/chat/process-chat.js

@@ -6,14 +6,8 @@ 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, frameworkAdapter, getProvider, initializeProviders, memoryAdapter, applyResumeSelection, }) {
+async function processChat({ messages, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, frameworkAdapter, getProvider, memoryAdapter, applyResumeSelection, }) {
     const config = await loadRuntimeConfig(options);
-    if (initializeProviders) {
-        const ai = config.ai;
-        initializeProviders((ai && typeof ai === "object" && !Array.isArray(ai)
-            ? ai
-            : {}));
-    }
     const runtimeConfig = {
         ...config,
         getProvider,

package/dist/index.d.ts

@@ -1,4 +1,8 @@
-export type { CreateAgentArgs } from "./chat/create-agent";
+export type { ChatRequestBody } from "./adapters/http";
+export { createChatRouteHandler, parseChatRequestBody, processChatRequestBody, } from "./adapters/http";
+export type { StreamChatFromRouteArgs } from "./adapters/http-client";
+export { streamChatFromRoute } from "./adapters/http-client";
+export type { Agent, AgentMemoryConfig, AgentProcessOptions, AgentSessionConfig, CreateAgentArgs, } from "./chat/create-agent";
 export { createAgent } from "./chat/create-agent";
 export type { ProcessChatArgs } from "./chat/process-chat";
 export { processChat } from "./chat/process-chat";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EACV,oBAAoB,EACpB,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,KAAK,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EACV,oBAAoB,EACpB,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractLatestUserMessage = exports.transformGraphStreamForUI = exports.orchestrateGraphStream = exports.tryPrepareResumeStream = exports.parseResumeMeta = exports.processChat = exports.createAgent = void 0;
+exports.extractLatestUserMessage = exports.transformGraphStreamForUI = exports.orchestrateGraphStream = exports.tryPrepareResumeStream = exports.parseResumeMeta = exports.processChat = exports.createAgent = exports.streamChatFromRoute = exports.processChatRequestBody = exports.parseChatRequestBody = exports.createChatRouteHandler = void 0;
+var http_1 = require("./adapters/http");
+Object.defineProperty(exports, "createChatRouteHandler", { enumerable: true, get: function () { return http_1.createChatRouteHandler; } });
+Object.defineProperty(exports, "parseChatRequestBody", { enumerable: true, get: function () { return http_1.parseChatRequestBody; } });
+Object.defineProperty(exports, "processChatRequestBody", { enumerable: true, get: function () { return http_1.processChatRequestBody; } });
+var http_client_1 = require("./adapters/http-client");
+Object.defineProperty(exports, "streamChatFromRoute", { enumerable: true, get: function () { return http_client_1.streamChatFromRoute; } });
 var create_agent_1 = require("./chat/create-agent");
 Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return create_agent_1.createAgent; } });
 var process_chat_1 = require("./chat/process-chat");

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;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"}
+{"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;AAMD,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,CAgZlD"}

package/dist/orchestrator.js

@@ -10,6 +10,7 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
     let currentGraph = graph;
     let currentState = state;
     let finished = false;
+    const debugEnabled = Boolean(config?.features?.tracing);
     const namespacesUsed = new Set();
     try {
         const sid = config?.session?.id;
@@ -22,7 +23,6 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
         to: null,
         payload: {},
     };
-    const streamedNodes = new Set();
     let lastStatusMsg = "";
     let lastStatusAt = 0;
     let pendingRecordToken = null;
@@ -30,6 +30,70 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
     let wroteHumanInput = false;
     const pendingStore = frameworkAdapter?.pendingRequests;
     const pendingTtlMs = frameworkAdapter?.ttlMs ?? 15 * 60 * 1000;
+    const persistAndEmitInterrupt = async (payload) => {
+        if (activeIsResume || wroteHumanInput)
+            return;
+        const token = (0, runtime_1.makeResumeToken)();
+        const requestId = (0, runtime_1.makeRequestId)("human");
+        pendingRecordToken = token;
+        const input = payload.input ?? {};
+        const optionsList = Array.isArray(input.options) ? input.options : [];
+        const kind = input.kind || (input.multiple ? "multi-choice" : "choice");
+        const isText = kind === "text";
+        const record = {
+            token,
+            requestId,
+            sessionId,
+            runId,
+            workflow: payload.workflow || currentState.currentWorkflow,
+            node: payload.node || "",
+            state: { ...currentState, awaitingHumanInput: true },
+            schema: isText
+                ? {
+                    kind: kind,
+                    multiple: Boolean(input.multiple),
+                    ...(input.question ? { question: input.question } : {}),
+                }
+                : {
+                    kind: kind,
+                    multiple: Boolean(input.multiple),
+                    question: String(input.question || "Please choose an option."),
+                },
+            options: optionsList.map((option) => ({
+                id: String(option.id),
+                label: String(option.label),
+                description: typeof option.description === "string"
+                    ? option.description
+                    : undefined,
+                value: option.value,
+            })),
+            createdAt: Date.now(),
+            ttlMs: pendingTtlMs,
+        };
+        if (pendingStore) {
+            pendingStore.save(record).catch((error) => {
+                console.error("[orchestrator] failed to save pending request", error);
+            });
+        }
+        out.write({
+            type: "interrupt",
+            requestId: record.requestId,
+            resumeToken: record.token,
+            workflow: record.workflow,
+            node: record.node,
+            input: {
+                kind: record.schema.kind,
+                multiple: record.schema.multiple,
+                question: record.schema.question,
+                options: record.options.map((option) => ({
+                    id: option.id,
+                    label: option.label,
+                    description: option.description,
+                })),
+            },
+        });
+        wroteHumanInput = true;
+    };
     const forwardEmit = (event, payload) => {
         if (event === "error") {
             const msg = String(payload?.message ?? "Unexpected error");
@@ -40,6 +104,8 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
             return;
         }
         if (event === "status") {
+            if (!debugEnabled)
+                return;
             const msg = String(payload?.message ?? "");
             const now = Date.now();
             if (msg && msg === lastStatusMsg && now - lastStatusAt < 250)
@@ -54,7 +120,6 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
             if (!node)
                 return;
             out.write({ type: "text-start", node });
-            streamedNodes.add(node);
             return;
         }
         if (event === "text-delta") {
@@ -63,7 +128,6 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
             if (!node || !delta)
                 return;
             out.write({ type: "text-delta", delta, node });
-            streamedNodes.add(node);
             return;
         }
         if (event === "text-end") {
@@ -100,81 +164,15 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
             return;
         }
         if (event === "interrupt") {
-            if (activeIsResume)
-                return;
-            try {
-                const p = payload;
-                console.log(`[orchestrator] interrupt node=${p?.node} workflow=${p?.workflow} options=${Array.isArray(p?.input?.options) ? p.input.options.length : 0}`);
-            }
-            catch { }
             const p = payload;
             const local = {
                 node: p?.node,
                 workflow: p?.workflow,
                 input: p?.input,
             };
-            const token = (0, runtime_1.makeResumeToken)();
-            const requestId = (0, runtime_1.makeRequestId)("human");
-            pendingRecordToken = token;
-            const options = Array.isArray(local.input?.options)
-                ? local.input.options
-                : [];
-            const kind = local.input?.kind ||
-                (local.input?.multiple ? "multi-choice" : "choice");
-            const isText = kind === "text";
-            const record = {
-                token,
-                requestId,
-                sessionId: sessionId,
-                runId,
-                workflow: local.workflow || currentState.currentWorkflow,
-                node: local.node || "",
-                state: { ...currentState, awaitingHumanInput: true },
-                schema: isText
-                    ? {
-                        kind: kind,
-                        multiple: Boolean(local.input?.multiple),
-                        ...(local.input?.question
-                            ? { question: local.input.question }
-                            : {}),
-                    }
-                    : {
-                        kind: kind,
-                        multiple: Boolean(local.input?.multiple),
-                        question: String(local.input?.question || "Please choose an option."),
-                    },
-                options: options.map((o) => ({
-                    id: String(o.id),
-                    label: String(o.label),
-                    description: typeof o.description === "string" ? o.description : undefined,
-                    value: o.value,
-                })),
-                createdAt: Date.now(),
-                ttlMs: pendingTtlMs,
-            };
-            if (pendingStore) {
-                pendingStore.save(record).catch((e) => {
-                    console.error("[orchestrator] failed to save pending request", e);
-                });
-            }
-            out.write({
-                type: "interrupt",
-                requestId: record.requestId,
-                resumeToken: record.token,
-                workflow: record.workflow,
-                node: record.node,
-                input: {
-                    kind: record.schema.kind,
-                    multiple: record.schema.multiple,
-                    question: record.schema.question,
-                    options: record.options.map((o) => ({
-                        id: o.id,
-                        label: o.label,
-                        description: o.description,
-                    })),
-                },
+            void persistAndEmitInterrupt(local).catch((error) => {
+                console.error("[orchestrator] failed to emit interrupt", error);
             });
-            wroteHumanInput = true;
             return;
         }
     };
@@ -188,10 +186,12 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
                 "anonymous-session";
             const checkpointNs = String(currentState.currentWorkflow || "default");
             namespacesUsed.add(checkpointNs);
-            out.write({
-                type: "status",
-                message: `🧵 thread_id=${threadId} run_id=${runId} workflow=${currentState.currentWorkflow}`,
-            });
+            if (debugEnabled) {
+                out.write({
+                    type: "status",
+                    message: `🧵 thread_id=${threadId} run_id=${runId} workflow=${currentState.currentWorkflow}`,
+                });
+            }
             const isResume = Boolean(currentGraph.config?.resume);
             activeIsResume = isResume;
             const resumeUpdate = currentGraph.config?.resumeUpdate;
@@ -210,119 +210,20 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
                     checkpoint_ns: checkpointNs,
                 },
             });
-            try {
+            if (debugEnabled) {
                 out.write({
                     type: "status",
                     message: `▶️ streamEvents invoke: resume=${Boolean(currentGraph.config?.resume)} thread_id=${threadId} run_id=${runId} ns=${String(currentState.currentWorkflow || "default")}`,
                 });
             }
-            catch { }
             const uiStream = (0, transform_graph_stream_for_ui_1.transformGraphStreamForUI)(runtimeStream, {
-                debug: Boolean(config?.features?.tracing),
+                debug: debugEnabled,
+                emitStatus: debugEnabled,
             });
-            let loopTransitionTo = null;
-            let loopTransitionPayload = {};
             for await (const chunk of uiStream) {
                 if (finished)
                     break;
-                const node = chunk.node;
-                if (chunk.type === "interrupt" &&
-                    (!chunk.resumeToken || !chunk.requestId)) {
-                    if (wroteHumanInput) {
-                        continue;
-                    }
-                    const hi = chunk;
-                    const token = (0, runtime_1.makeResumeToken)();
-                    const requestId = (0, runtime_1.makeRequestId)("human");
-                    pendingRecordToken = token;
-                    const options = Array.isArray(hi.input?.options)
-                        ? hi.input.options
-                        : [];
-                    const kind = hi.input?.kind || (hi.input?.multiple ? "multi-choice" : "choice");
-                    const isText = kind === "text";
-                    const record = {
-                        token,
-                        requestId,
-                        sessionId: sessionId,
-                        runId,
-                        workflow: currentState.currentWorkflow,
-                        node: node || "",
-                        state: {
-                            ...currentState,
-                            awaitingHumanInput: true,
-                        },
-                        schema: isText
-                            ? {
-                                kind: kind,
-                                multiple: Boolean(hi.input?.multiple),
-                                ...(hi.input?.question
-                                    ? { question: hi.input.question }
-                                    : {}),
-                            }
-                            : {
-                                kind: kind,
-                                multiple: Boolean(hi.input?.multiple),
-                                question: String(hi.input?.question || "Please choose an option."),
-                            },
-                        options: options.map((o) => ({
-                            id: String(o.id),
-                            label: String(o.label),
-                            description: typeof o.description === "string" ? o.description : undefined,
-                            value: o.value,
-                        })),
-                        createdAt: Date.now(),
-                        ttlMs: pendingTtlMs,
-                    };
-                    if (pendingStore) {
-                        await pendingStore.save(record);
-                    }
-                    out.write({
-                        type: "interrupt",
-                        requestId,
-                        resumeToken: token,
-                        workflow: record.workflow,
-                        node: record.node,
-                        input: {
-                            kind: record.schema.kind,
-                            multiple: record.schema.multiple,
-                            question: record.schema.question,
-                            options: record.options.map((o) => ({
-                                id: o.id,
-                                label: o.label,
-                                description: o.description,
-                            })),
-                        },
-                    });
-                    wroteHumanInput = true;
-                    continue;
-                }
-                if (chunk.type === "text-delta") {
-                    if (typeof chunk.delta === "string" && chunk.delta.length > 60) {
-                        const text = chunk.delta;
-                        for (let i = 0; i < text.length; i += 60) {
-                            out.write({
-                                type: "text-delta",
-                                delta: text.slice(i, i + 60),
-                                node,
-                            });
-                        }
-                        if (node)
-                            streamedNodes.add(node);
-                    }
-                    else {
-                        out.write(chunk);
-                        if (node)
-                            streamedNodes.add(node);
-                    }
-                }
-                else {
-                    out.write(chunk);
-                }
-                if (chunk.type === "transition") {
-                    loopTransitionTo = String(chunk.transitionTo || "");
-                    loopTransitionPayload = chunk.payload ?? {};
-                    break;
-                }
+                out.write(chunk);
                 if (chunk.type === "done") {
                     workflowFinalState = chunk.data ?? null;
                     break;
@@ -330,10 +231,8 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
             }
             if (finished)
                 return;
-            const transitionTo = loopTransitionTo || pending.to;
-            const transitionPayload = Object.keys(loopTransitionPayload).length
-                ? loopTransitionPayload
-                : pending.payload;
+            const transitionTo = pending.to;
+            const transitionPayload = pending.payload;
             pending.to = null;
             pending.payload = {};
             if (transitionTo) {
@@ -363,9 +262,10 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
                 }
                 catch (err) {
                     out.write({
-                        type: "status",
-                        message: `⚠️ Transition failed to '${transitionTo}': ${err instanceof Error ? err.message : String(err)}`,
+                        type: "error",
+                        message: `Transition failed to '${transitionTo}': ${err instanceof Error ? err.message : String(err)}`,
                     });
+                    out.write({ type: "done" });
                     out.end();
                     return;
                 }
@@ -410,7 +310,11 @@ async function orchestrateGraphStream({ sessionId, runId, graph, state, config,
         }
     })().catch((err) => {
         console.error("[error:orchestrateGraphStream]", err);
-        out.write({ type: "status", message: `Error: ${err.message}` });
+        out.write({
+            type: "error",
+            message: err instanceof Error ? err.message : String(err),
+        });
+        out.write({ type: "done" });
         out.end();
     });
     return out;

package/dist/stream/transform-graph-stream-for-ui.d.ts

@@ -2,8 +2,7 @@ import type { StreamChunk } from "@kortyx/stream";
 import type { StreamEvent } from "@langchain/core/tracers/log_stream";
 interface TransformOptions {
     debug?: boolean;
-    visibleNodes?: string[];
-    forwardModelStream?: boolean;
+    emitStatus?: boolean;
 }
 export declare function transformGraphStreamForUI(stream: AsyncIterable<StreamEvent>, options?: TransformOptions): AsyncGenerator<StreamChunk>;
 export {};

package/dist/stream/transform-graph-stream-for-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-graph-stream-for-ui.d.ts","sourceRoot":"","sources":["../../src/stream/transform-graph-stream-for-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AASD,wBAAuB,yBAAyB,CAC9C,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,EAClC,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CAAC,WAAW,CAAC,CAgO7B"}
+{"version":3,"file":"transform-graph-stream-for-ui.d.ts","sourceRoot":"","sources":["../../src/stream/transform-graph-stream-for-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAQD,wBAAuB,yBAAyB,CAC9C,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,EAClC,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CAAC,WAAW,CAAC,CA6D7B"}

package/dist/stream/transform-graph-stream-for-ui.js

@@ -1,32 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transformGraphStreamForUI = transformGraphStreamForUI;
-const utils_1 = require("@kortyx/utils");
 async function* transformGraphStreamForUI(stream, options = {}) {
-    const { debug = false, forwardModelStream = false } = options;
-    let currentNode = null;
-    const streamedTextByNode = new Map();
+    const { debug = false, emitStatus = debug } = options;
     const startedNodes = new Set();
     const endedNodes = new Set();
-    let sawInterrupt = false;
-    function findChoiceSchema(obj) {
-        try {
-            if (!obj || typeof obj !== "object")
-                return null;
-            if (typeof obj.kind === "string" &&
-                (obj.kind === "choice" || obj.kind === "multi-choice") &&
-                Array.isArray(obj.options)) {
-                return obj;
-            }
-            for (const v of Object.values(obj)) {
-                const inner = findChoiceSchema(v);
-                if (inner)
-                    return inner;
-            }
-        }
-        catch { }
-        return null;
-    }
     for await (const event of stream) {
         const { event: type, name, data } = event ?? {};
         if (debug)
@@ -34,7 +12,6 @@ async function* transformGraphStreamForUI(stream, options = {}) {
         switch (type) {
             case "on_chain_start":
                 if (name && !name.startsWith("ChannelWrite")) {
-                    currentNode = name;
                     if (name === "__start__" || name === "__end__")
                         break;
                     if (startedNodes.has(name))
@@ -42,67 +19,8 @@ async function* transformGraphStreamForUI(stream, options = {}) {
                     startedNodes.add(name);
                     if (debug)
                         console.log(`[debug:start] node=${name}`);
-                    yield { type: "status", message: `Processing node: ${name}` };
-                }
-                break;
-            case "on_graph_interrupt": {
-                sawInterrupt = true;
-                if (debug)
-                    console.log(`[debug:on_graph_interrupt]`, JSON.stringify({ name, data }, null, 2));
-                const where = (typeof name === "string" && name) ||
-                    data?.node ||
-                    "unknown";
-                const schema = findChoiceSchema(data);
-                if (schema) {
-                    const isText = schema.kind === "text";
-                    const options = Array.isArray(schema.options)
-                        ? schema.options
-                            .map((o) => ({
-                            id: String(o.id ?? ""),
-                            label: String(o.label ?? ""),
-                            ...(o.description
-                                ? { description: String(o.description) }
-                                : {}),
-                        }))
-                            .filter((o) => o.id && o.label)
-                        : [];
-                    yield {
-                        type: "interrupt",
-                        requestId: "",
-                        resumeToken: "",
-                        node: typeof where === "string" ? where : undefined,
-                        input: {
-                            kind: schema.kind,
-                            multiple: Boolean(schema.multiple),
-                            ...(isText
-                                ? { question: schema.question }
-                                : {
-                                    question: typeof schema.question === "string"
-                                        ? schema.question
-                                        : "Please choose",
-                                }),
-                            ...(options.length > 0 ? { options } : {}),
-                        },
-                    };
-                }
-                else {
-                    yield { type: "status", message: `⏸️ Interrupted at: ${where}` };
-                }
-                break;
-            }
-            case "on_chat_model_stream":
-                if (forwardModelStream && data?.chunk?.content) {
-                    if (currentNode && !streamedTextByNode.get(currentNode)) {
-                        yield { type: "text-start", node: currentNode };
-                        streamedTextByNode.set(currentNode, true);
-                    }
-                    const delta = (0, utils_1.contentToText)(data.chunk.content);
-                    if (delta) {
-                        yield {
-                            type: "text-delta",
-                            delta,
-                            node: currentNode ?? "ai",
-                        };
+                    if (emitStatus) {
+                        yield { type: "status", message: `Processing node: ${name}` };
                     }
                 }
                 break;
@@ -113,79 +31,27 @@ async function* transformGraphStreamForUI(stream, options = {}) {
                     console.log(`[debug:on_chain_end:${nodeName}] output=`, JSON.stringify(output, null, 2));
                 if (!output || nodeName?.startsWith("ChannelWrite"))
                     break;
-                if (nodeName && streamedTextByNode.get(nodeName)) {
-                    yield { type: "text-end", node: nodeName };
-                    streamedTextByNode.delete(nodeName);
-                }
                 if (nodeName !== "__start__" && nodeName !== "__end__") {
                     if (!endedNodes.has(nodeName)) {
-                        yield { type: "status", message: `✅ Completed node: ${nodeName}` };
+                        if (emitStatus) {
+                            yield {
+                                type: "status",
+                                message: `✅ Completed node: ${nodeName}`,
+                            };
+                        }
                         endedNodes.add(nodeName);
                     }
                 }
-                currentNode = null;
                 break;
             }
             case "on_graph_end": {
                 if (debug)
                     console.log(`[debug:on_graph_end]`, JSON.stringify(data, null, 2));
-                const out = data?.output ?? null;
-                const interrupts = out && out.__interrupt__;
-                if (interrupts && Array.isArray(interrupts) && interrupts.length > 0) {
-                    const first = interrupts[0];
-                    const val = first?.value ?? first;
-                    const schema = findChoiceSchema(val);
-                    if (schema && Array.isArray(schema.options)) {
-                        const isText = schema.kind === "text";
-                        const options = Array.isArray(schema.options)
-                            ? schema.options
-                                .map((o) => ({
-                                id: String(o.id ?? ""),
-                                label: String(o.label ?? ""),
-                                ...(o.description
-                                    ? { description: String(o.description) }
-                                    : {}),
-                            }))
-                                .filter((o) => o.id && o.label)
-                            : [];
-                        yield {
-                            type: "interrupt",
-                            requestId: "",
-                            resumeToken: "",
-                            input: {
-                                kind: schema.kind,
-                                multiple: Boolean(schema.multiple),
-                                ...(isText
-                                    ? { question: schema.question }
-                                    : {
-                                        question: typeof schema.question === "string"
-                                            ? schema.question
-                                            : "Please choose",
-                                    }),
-                                ...(options.length > 0 ? { options } : {}),
-                            },
-                        };
-                    }
-                    else {
-                        yield { type: "status", message: "⏸️ Interrupt received" };
-                    }
-                }
-                if (sawInterrupt && debug)
-                    yield { type: "status", message: "🔚 Graph ended after interrupt" };
-                yield { type: "done", data: out };
+                yield { type: "done", data: data?.output ?? null };
                 break;
             }
             default:
-                if (typeof type === "string" && type.includes("interrupt")) {
-                    sawInterrupt = true;
-                    if (debug)
-                        console.log(`[debug:interrupt_like]`, JSON.stringify({ type, name, data }, null, 2));
-                    yield {
-                        type: "status",
-                        message: `⏸️ Interrupt event: ${type} ${name ?? ""}`.trim(),
-                    };
-                }
-                else if (debug) {
+                if (debug) {
                     console.warn(`[debug:unknown_event]`, type);
                 }
                 break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortyx/agent",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": false,
   "description": "Agent composition utilities for Kortyx.",
   "keywords": [
@@ -23,6 +23,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
     }
   },
   "files": [
@@ -46,7 +50,8 @@
     "@kortyx/stream": "workspace:*",
     "@kortyx/utils": "workspace:*",
     "@langchain/core": "^1.0.1",
-    "@langchain/langgraph": "^1.0.1"
+    "@langchain/langgraph": "^1.0.1",
+    "zod": "^3.23.8"
   },
   "devDependencies": {
     "turbo": "^2.5.4",