@kortyx/runtime 0.11.1 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## [0.14.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.13.0...runtime-v0.14.0) (2026-09-10)
+
+
+### Features
+
+* **runtime:** add shared execution limits and checkpoint continuation ([#163](https://github.com/kortyx-io/kortyx/issues/163)) ([e22232c](https://github.com/kortyx-io/kortyx/commit/e22232c059fae4f7df1bd36423902bd365887942))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/stream bumped to 0.11.0
+    * @kortyx/core bumped to 0.8.0
+    * @kortyx/hooks bumped to 0.21.0
+
+## [0.13.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.12.0...runtime-v0.13.0) (2026-09-10)
+
+
+### Features
+
+* cancel workflow trees and reflect cancellation in Studio ([#161](https://github.com/kortyx-io/kortyx/issues/161)) ([699ad18](https://github.com/kortyx-io/kortyx/commit/699ad18905955c6340c3d85b9fae7f0bffd00a0d))
+* execute and resume workflows without chat transport ([#159](https://github.com/kortyx-io/kortyx/issues/159)) ([6decb17](https://github.com/kortyx-io/kortyx/commit/6decb1714fedc021ac9e125b6ed9f75475ed928a))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/stream bumped to 0.10.0
+    * @kortyx/core bumped to 0.7.0
+    * @kortyx/hooks bumped to 0.20.0
+
+## [0.12.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.11.1...runtime-v0.12.0) (2026-09-09)
+
+
+### Features
+
+* add resumable child workflows and Studio inspection ([#157](https://github.com/kortyx-io/kortyx/issues/157)) ([542ba29](https://github.com/kortyx-io/kortyx/commit/542ba29b3b57217e6e5d98c1b409bbec5ce3261f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/core bumped to 0.6.0
+    * @kortyx/hooks bumped to 0.19.0
+
 ## [0.11.1](https://github.com/kortyx-io/kortyx/compare/runtime-v0.11.0...runtime-v0.11.1) (2026-08-02)
 
 

package/dist/index.d.ts

@@ -1,10 +1,16 @@
-import { BaseCheckpointSaver } from '@langchain/langgraph-checkpoint';
+import { BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph-checkpoint';
+import * as _kortyx_core from '@kortyx/core';
 import { GraphState, WorkflowDefinition, NodeFn, RuntimeEnvelope } from '@kortyx/core';
 import { ReasonTraceAdapter, KortyxTelemetryConfig } from '@kortyx/hooks';
 import { GetProviderFn } from '@kortyx/providers';
 
 declare function getCheckpointer(key: string): BaseCheckpointSaver;
 
+/** A self-contained, JSON snapshot, including pending writes needed for replay. */
+type GraphSnapshotBundle = CheckpointTuple;
+declare function captureGraphSnapshot(saver: BaseCheckpointSaver, threadId: string, checkpointId?: string): Promise<GraphSnapshotBundle | undefined>;
+declare function restoreGraphSnapshot(saver: BaseCheckpointSaver, snapshot: GraphSnapshotBundle, threadId: string): Promise<void>;
+
 type HumanInputKind = "choice" | "multi-choice" | "text";
 interface HumanInputOption {
     id: string;
@@ -26,6 +32,7 @@ interface PendingRequestRecord {
      * Used to resume from the correct interrupt after session rollback.
      */
     graphCheckpointId?: string | undefined;
+    graphSnapshot?: GraphSnapshotBundle;
     workflow: string;
     node: string;
     state?: GraphState;
@@ -43,6 +50,7 @@ interface PendingRequestRecord {
     ttlMs: number;
 }
 interface PendingRequestStore {
+    take?: (token: string) => Promise<PendingRequestRecord | null>;
     save: (rec: PendingRequestRecord) => Promise<void>;
     get: (token: string) => Promise<PendingRequestRecord | null>;
     delete: (token: string) => Promise<void>;
@@ -143,31 +151,42 @@ declare function createRedisFrameworkAdapter(options: CreateRedisFrameworkAdapte
 declare function createFrameworkAdapterFromEnv(env?: Record<string, string | undefined>): FrameworkAdapter;
 
 interface CompiledGraphBase {
-    invoke(state: unknown): Promise<unknown>;
+    invoke(state: unknown, options?: Record<string, unknown>): Promise<unknown>;
     streamEvents(state: GraphState, options?: {
         version?: string;
         configurable?: Record<string, unknown>;
     }): AsyncIterable<unknown> | AsyncGenerator<unknown>;
 }
+type ExecutionControl = {
+    abortSignal?: AbortSignal | undefined;
+    budget?: _kortyx_core.ExecutionBudget | undefined;
+};
 interface GraphExtensions {
+    execution: ExecutionControl;
     name: string;
     config: ExecutionRuntimeConfig;
     resume(state: GraphState, input: unknown): Promise<GraphState>;
     timeTravelTo(state: GraphState, checkpointId: string): Promise<GraphState>;
 }
 interface ExecutionRuntimeConfig {
+    executionRunId?: string | undefined;
+    executionBranchId?: string | undefined;
+    prepareChildTelemetry?: ((workflow: WorkflowDefinition, config: ExecutionRuntimeConfig) => ExecutionRuntimeConfig) | undefined;
+    selectWorkflow?: ((id: string) => Promise<WorkflowDefinition>) | undefined;
+    workflowCallDepth?: number;
+    invocationPath?: string;
     emit?: (event: string, payload: unknown) => void;
     onCheckpoint?: (args: {
         nodeId: string;
         state: GraphState;
     }) => void;
     checkpointer?: BaseCheckpointSaver;
-    reasonTrace?: ReasonTraceAdapter;
-    telemetry?: KortyxTelemetryConfig;
-    getProvider?: GetProviderFn;
+    reasonTrace?: ReasonTraceAdapter | undefined;
+    telemetry?: KortyxTelemetryConfig | undefined;
+    getProvider?: GetProviderFn | undefined;
     [key: string]: unknown;
 }
-declare function createExecutionGraph(workflow: WorkflowDefinition, config: ExecutionRuntimeConfig): Promise<CompiledGraphBase & GraphExtensions>;
+declare function createExecutionGraph(workflow: WorkflowDefinition, config: ExecutionRuntimeConfig, execution?: ExecutionControl): Promise<CompiledGraphBase & GraphExtensions>;
 
 declare function makeResumeToken(): string;
 declare function makeRequestId(prefix?: string): string;
@@ -212,4 +231,4 @@ interface InitialStateArgs<Config = unknown> {
 }
 declare function buildInitialGraphState<Config>({ input, runtime, config, defaultWorkflowId, }: InitialStateArgs<Config>): Promise<GraphState>;
 
-export { type AppendSessionCheckpointArgs, type CheckpointId, type CheckpointSummary, type CreateInMemoryFrameworkAdapterOptions, type CreateRedisFrameworkAdapterOptions, type ExecutionRuntimeConfig, type FileWorkflowRegistryOptions, type ForkSessionCheckpointResult, type FrameworkAdapter, type HumanInputKind, type HumanInputOption, type InitialStateArgs, type PendingRequestRecord, type PendingRequestStore, type RollbackSessionCheckpointResult, type SessionCheckpointRecord, type SessionCheckpointStore, type SessionCheckpointStoreOptions, type WorkflowRegistry, buildInitialGraphState, clearRegisteredNodes, createExecutionGraph, createFileWorkflowRegistry, createFrameworkAdapterFromEnv, createInMemoryFrameworkAdapter, createInMemoryPendingRequestStore, createInMemorySessionCheckpointStore, createInMemoryWorkflowRegistry, createRedisFrameworkAdapter, getCheckpointer, getRegisteredNode, listRegisteredNodes, makeRequestId, makeResumeToken, registerNode, resolveNode };
+export { type AppendSessionCheckpointArgs, type CheckpointId, type CheckpointSummary, type CreateInMemoryFrameworkAdapterOptions, type CreateRedisFrameworkAdapterOptions, type ExecutionControl, type ExecutionRuntimeConfig, type FileWorkflowRegistryOptions, type ForkSessionCheckpointResult, type FrameworkAdapter, type GraphSnapshotBundle, type HumanInputKind, type HumanInputOption, type InitialStateArgs, type PendingRequestRecord, type PendingRequestStore, type RollbackSessionCheckpointResult, type SessionCheckpointRecord, type SessionCheckpointStore, type SessionCheckpointStoreOptions, type WorkflowRegistry, buildInitialGraphState, captureGraphSnapshot, clearRegisteredNodes, createExecutionGraph, createFileWorkflowRegistry, createFrameworkAdapterFromEnv, createInMemoryFrameworkAdapter, createInMemoryPendingRequestStore, createInMemorySessionCheckpointStore, createInMemoryWorkflowRegistry, createRedisFrameworkAdapter, getCheckpointer, getRegisteredNode, listRegisteredNodes, makeRequestId, makeResumeToken, registerNode, resolveNode, restoreGraphSnapshot };