@kortyx/runtime 0.4.1 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.5.1](https://github.com/kortyx-io/kortyx/compare/runtime-v0.5.0...runtime-v0.5.1) (2026-02-17)
+
+
+### Bug Fixes
+
+* **build:** align package tsconfig with shared lib baseline ([48d2b57](https://github.com/kortyx-io/kortyx/commit/48d2b5765fefbb5fcbbe548e749e7b5f51b450b9))
+* **build:** wire tsup for publishable packages ([e7b1b5c](https://github.com/kortyx-io/kortyx/commit/e7b1b5c28af55becffc137233dd92d8953d7cb8e))
+* **dev:** restore tsc watch flow for local workspace ([4305823](https://github.com/kortyx-io/kortyx/commit/430582372cad466bf28af554042aa11bdb8bf027))
+
+## [0.5.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.4.1...runtime-v0.5.0) (2026-02-17)
+
+
+### Features
+
+* **agent:** strict createAgent and unify useReason streaming ([6725f97](https://github.com/kortyx-io/kortyx/commit/6725f976fc32083fb7d2590f1353d16a99afb46f))
+
+
+### Bug Fixes
+
+* **hooks:** move reason engine to internal subpath export ([b82f2f2](https://github.com/kortyx-io/kortyx/commit/b82f2f2a93067f91dd010334486eb0f3a3a547b8))
+
 ## [0.4.1](https://github.com/kortyx-io/kortyx/compare/runtime-v0.4.0...runtime-v0.4.1) (2026-02-15)
 
 

package/dist/index.d.ts

@@ -1,11 +1,127 @@
-export * from "./checkpointer";
-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
+import { BaseCheckpointSaver } from '@langchain/langgraph-checkpoint';
+import { GraphState, WorkflowDefinition, NodeFn, MemoryEnvelope } from '@kortyx/core';
+import { MemoryAdapter } from '@kortyx/memory';
+import { GetProviderFn } from '@kortyx/providers';
+
+declare function getCheckpointer(key: string): BaseCheckpointSaver;
+
+type HumanInputKind = "choice" | "multi-choice" | "text";
+interface HumanInputOption {
+    id: string;
+    label: string;
+    description?: string;
+    value?: unknown;
+}
+interface PendingRequestRecord {
+    token: string;
+    requestId: string;
+    sessionId?: string | undefined;
+    /**
+     * Framework run identifier used by the checkpointer (thread_id).
+     * This must be stable across interrupt/resume, but should not be reused for new messages.
+     */
+    runId: string;
+    workflow: string;
+    node: string;
+    state?: GraphState;
+    schema: {
+        kind: HumanInputKind;
+        multiple: boolean;
+        question?: string;
+    };
+    options: HumanInputOption[];
+    createdAt: number;
+    ttlMs: number;
+}
+interface PendingRequestStore {
+    save: (rec: PendingRequestRecord) => Promise<void>;
+    get: (token: string) => Promise<PendingRequestRecord | null>;
+    delete: (token: string) => Promise<void>;
+    update: (token: string, patch: Partial<PendingRequestRecord>) => Promise<void>;
+}
+declare function createInMemoryPendingRequestStore(): PendingRequestStore;
+
+type FrameworkAdapter = {
+    kind: "memory" | "redis";
+    pendingRequests: PendingRequestStore;
+    checkpointer: BaseCheckpointSaver;
+    ttlMs: number;
+    /**
+     * Best-effort cleanup for ephemeral framework state for a single run.
+     * Called when a workflow completes without pausing for an interrupt.
+     */
+    cleanupRun?: (runId: string, namespaces: string[]) => Promise<void>;
+};
+type CreateInMemoryFrameworkAdapterOptions = {
+    ttlMs?: number;
+};
+declare function createInMemoryFrameworkAdapter(options?: CreateInMemoryFrameworkAdapterOptions): FrameworkAdapter;
+type CreateRedisFrameworkAdapterOptions = {
+    url: string;
+    ttlMs?: number;
+    prefix?: string;
+};
+declare function createRedisFrameworkAdapter(options: CreateRedisFrameworkAdapterOptions): FrameworkAdapter;
+declare function createFrameworkAdapterFromEnv(env?: Record<string, string | undefined>): FrameworkAdapter;
+
+interface GraphRuntimeConfig {
+    emit?: (event: string, payload: unknown) => void;
+    onCheckpoint?: (args: {
+        nodeId: string;
+        state: GraphState;
+    }) => void;
+    memoryAdapter?: MemoryAdapter;
+    checkpointer?: BaseCheckpointSaver;
+    /**
+     * Provider factory used by ctx.speak to obtain a streaming model.
+     * Use @kortyx/providers or implement your own GetProviderFn.
+     */
+    getProvider?: GetProviderFn;
+    [key: string]: unknown;
+}
+declare function createLangGraph(workflow: WorkflowDefinition, config: GraphRuntimeConfig): Promise<any>;
+
+declare function makeResumeToken(): string;
+declare function makeRequestId(prefix?: string): string;
+
+declare function registerNode(id: string, fn: NodeFn): void;
+declare function getRegisteredNode(id: string): NodeFn | null;
+declare function listRegisteredNodes(): string[];
+declare function clearRegisteredNodes(): void;
+declare function resolveNode(id: string): NodeFn;
+
+type AnyWorkflow = WorkflowDefinition;
+interface WorkflowRegistry {
+    list: () => Promise<AnyWorkflow[]>;
+    get: (id: string) => Promise<AnyWorkflow | null>;
+    select: (id: string, options?: {
+        fallbackId?: string;
+    }) => Promise<AnyWorkflow>;
+    refresh?: () => Promise<void>;
+}
+
+interface FileWorkflowRegistryOptions {
+    workflowsDir: string;
+    fallbackId?: string;
+    cache?: boolean;
+    extensions?: string[];
+}
+declare function createFileWorkflowRegistry(options: FileWorkflowRegistryOptions): WorkflowRegistry;
+
+declare function createInMemoryWorkflowRegistry(workflows: WorkflowDefinition[], options?: {
+    fallbackId?: string;
+}): WorkflowRegistry;
+
+/**
+ * Prepares the initial runtime graph state from chat context, memory, and runtime config.
+ * This stays deliberately generic in the config type so apps can shape it.
+ */
+interface InitialStateArgs<Config = unknown> {
+    input: unknown;
+    memory: MemoryEnvelope;
+    config: Config;
+    defaultWorkflowId?: string;
+}
+declare function buildInitialGraphState<Config>({ input, memory, config, defaultWorkflowId, }: InitialStateArgs<Config>): Promise<GraphState>;
+
+export { type CreateInMemoryFrameworkAdapterOptions, type CreateRedisFrameworkAdapterOptions, type FileWorkflowRegistryOptions, type FrameworkAdapter, type GraphRuntimeConfig, type HumanInputKind, type HumanInputOption, type InitialStateArgs, type PendingRequestRecord, type PendingRequestStore, type WorkflowRegistry, buildInitialGraphState, clearRegisteredNodes, createFileWorkflowRegistry, createFrameworkAdapterFromEnv, createInMemoryFrameworkAdapter, createInMemoryPendingRequestStore, createInMemoryWorkflowRegistry, createLangGraph, createRedisFrameworkAdapter, getCheckpointer, getRegisteredNode, listRegisteredNodes, makeRequestId, makeResumeToken, registerNode, resolveNode };