@kortyx/runtime 0.20.1 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.21.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.20.1...runtime-v0.21.0) (2026-09-21)
+
+
+### Features
+
+* **hooks:** add model-driven interrupt contracts to useReason ([#224](https://github.com/kortyx-io/kortyx/issues/224)) ([e0147d5](https://github.com/kortyx-io/kortyx/commit/e0147d5234ca38d450d452af924b242f8cbdeb16))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/stream bumped to 0.13.0
+    * @kortyx/core bumped to 0.10.0
+    * @kortyx/hooks bumped to 0.28.0
+    * @kortyx/providers bumped to 0.8.1
+    * @kortyx/utils bumped to 0.3.1
+
 ## [0.20.1](https://github.com/kortyx-io/kortyx/compare/runtime-v0.20.0...runtime-v0.20.1) (2026-09-21)
 
 

package/dist/index.d.ts

@@ -38,7 +38,7 @@ 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";
+type HumanInputKind = "choice" | "multi-choice" | "text" | "custom";
 interface HumanInputOption {
     id: string;
     label: string;
@@ -72,6 +72,8 @@ interface PendingRequestRecord {
         id?: string;
         schemaId?: string;
         schemaVersion?: string;
+        contract?: string;
+        request?: unknown;
         meta?: Record<string, unknown>;
     };
     options: HumanInputOption[];

package/dist/index.js

@@ -3278,14 +3278,23 @@ async function createExecutionGraph(workflow, config, execution = {}) {
           (0, import_core3.throwIfExecutionAborted)(execution.abortSignal);
           if (execution.budget) (0, import_core3.assertExecutionBudget)(execution.budget);
           const { kind, question } = interruptConfig;
-          const isMulti = kind === "multi-choice" || interruptConfig.kind !== "text" && interruptConfig.multiple === true;
+          const isCustom = kind === "custom";
+          const isMulti = kind === "multi-choice" || interruptConfig.kind === "choice" && interruptConfig.multiple === true;
           const sharedInterruptFields = {
             ...typeof interruptConfig.id === "string" && interruptConfig.id.length > 0 ? { id: interruptConfig.id } : {},
             ...typeof interruptConfig.schemaId === "string" && interruptConfig.schemaId.length > 0 ? { schemaId: interruptConfig.schemaId } : {},
             ...typeof interruptConfig.schemaVersion === "string" && interruptConfig.schemaVersion.length > 0 ? { schemaVersion: interruptConfig.schemaVersion } : {},
             ...interruptConfig.meta && typeof interruptConfig.meta === "object" && !Array.isArray(interruptConfig.meta) ? { meta: interruptConfig.meta } : {}
           };
-          const payload = interruptConfig.kind === "text" ? {
+          const payload = isCustom ? {
+            kind: "custom",
+            request: interruptConfig.request,
+            ...question ? { question } : {},
+            ...interruptConfig.contract ? { contract: interruptConfig.contract } : {},
+            schemaId: interruptConfig.schemaId,
+            schemaVersion: interruptConfig.schemaVersion,
+            ...sharedInterruptFields
+          } : interruptConfig.kind === "text" ? {
             kind: "text",
             ...question ? { question } : {},
             ...sharedInterruptFields
@@ -3309,6 +3318,7 @@ async function createExecutionGraph(workflow, config, execution = {}) {
               });
             throw error;
           }
+          if (isCustom) return resumed;
           if (isMulti) {
             if (Array.isArray(resumed)) {
               return resumed.map(