kortyx 0.14.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## [0.17.0](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.16.0...kortyx-v0.17.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/agent bumped to 0.18.0
+    * @kortyx/cli bumped to 0.5.2
+    * @kortyx/core bumped to 0.8.0
+    * @kortyx/hooks bumped to 0.21.0
+    * @kortyx/runtime bumped to 0.14.0
+    * @kortyx/stream bumped to 0.11.0
+
+## [0.16.0](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.15.0...kortyx-v0.16.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/agent bumped to 0.17.0
+    * @kortyx/cli bumped to 0.5.1
+    * @kortyx/core bumped to 0.7.0
+    * @kortyx/hooks bumped to 0.20.0
+    * @kortyx/runtime bumped to 0.13.0
+    * @kortyx/stream bumped to 0.10.0
+
+## [0.15.0](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.14.1...kortyx-v0.15.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/agent bumped to 0.16.0
+    * @kortyx/cli bumped to 0.5.0
+    * @kortyx/core bumped to 0.6.0
+    * @kortyx/hooks bumped to 0.19.0
+    * @kortyx/runtime bumped to 0.12.0
+
+## [0.14.1](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.14.0...kortyx-v0.14.1) (2026-08-31)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/cli bumped to 0.4.0
+
 ## [0.14.0](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.13.0...kortyx-v0.14.0) (2026-08-02)
 
 

package/README.md

@@ -247,7 +247,7 @@ const agent = createAgent({ workflows, telemetry });
 
 Delivery is best-effort and non-blocking: events receive idempotent IDs, are batched in a bounded in-memory queue, and transient network/429/5xx failures retry with exponential backoff and jitter. Use `telemetry.flush()` during graceful shutdown; inspect `getDroppedEventCount()` and `getPermanentDeliveryFailureCount()` for delivery health. Prompt and output content is excluded by default. Enable only the sides you intend to persist with `captureContent: true` or `{ input: true, output: true }`.
 
-`interrupt.expired` is intentionally API-derived from the durable `expiresAt` sent in `interrupt.created`; the SDK does not run an unreliable local TTL timer. `run.cancelled` remains reserved until Kortyx exposes a real cancellation operation. A client disconnect is not a cancellation event.
+`interrupt.expired` is intentionally API-derived from the durable `expiresAt` sent in `interrupt.created`; the SDK does not run an unreliable local TTL timer. `run.cancelled` records aborted active executions. Forward `request.signal` in custom routes; `createChatRouteHandler` forwards it automatically. Children, models and tools inherit the live signal. Use `useAbortSignal()` for custom node I/O.
 
 Interrupt telemetry keeps structural fields (`kind`, `interactionMode`,
 `optionCount`, `schemaId`, and `schemaVersion`) even when content capture is

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { Agent, AgentProcessOptions, ChatRequestBody, CheckpointRequestBody, CreateAgentArgs, StreamChatFromRouteArgs, createAgent, createChatRouteHandler, createCheckpointRouteHandler, handleChatRequestBody, handleCheckpointRequestBody, parseChatRequestBody, parseCheckpointRequestBody, streamChatFromRoute } from '@kortyx/agent';
-export { GraphState, NodeConfig, NodeContext, NodeFn, NodeHandler, NodeResult, RuntimeEnvelope, WorkflowDefinition, WorkflowId, defineWorkflow, loadWorkflow, validateWorkflow } from '@kortyx/core';
-export { EnsureWorkflowTopologyRequest, EnsureWorkflowTopologyResponse, KortyxTelemetryConfig, KortyxTelemetryContentCapture, KortyxTelemetryCorrelation, KortyxTelemetryEvent, KortyxTelemetryEventType, KortyxTelemetryPrompt, KortyxTelemetryReporter, KortyxTelemetryService, KortyxTraceAdapter, KortyxTraceMetadata, UseInterruptArgs, UseReasonArgs, UseReasonResult, UseReasonStep, UseReasonToolExecution, UseStructuredDataArgs, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useWorkflowState } from '@kortyx/hooks';
+export { Agent, AgentProcessOptions, ChatRequestBody, CheckpointRequestBody, CreateAgentArgs, ExecutableWorkflow, ExecuteOptions, ExecutionInfo, ExecutionInterrupt, ExecutionRequestError, ExecutionResult, ResumeHandle, ResumeOptions, ResumeResponse, StreamChatFromRouteArgs, createAgent, createChatRouteHandler, createCheckpointRouteHandler, handleChatRequestBody, handleCheckpointRequestBody, parseChatRequestBody, parseCheckpointRequestBody, streamChatFromRoute } from '@kortyx/agent';
+export { ExecutionLimit, ExecutionLimitReached, ExecutionLimits, GraphState, NodeConfig, NodeContext, NodeFn, NodeHandler, NodeResult, RuntimeEnvelope, WorkflowDefinition, WorkflowId, defineWorkflow, loadWorkflow, validateWorkflow } from '@kortyx/core';
+export { EnsureWorkflowTopologyRequest, EnsureWorkflowTopologyResponse, KortyxTelemetryConfig, KortyxTelemetryContentCapture, KortyxTelemetryCorrelation, KortyxTelemetryEvent, KortyxTelemetryEventType, KortyxTelemetryPrompt, KortyxTelemetryReporter, KortyxTelemetryService, KortyxTraceAdapter, KortyxTraceMetadata, UseInterruptArgs, UseReasonArgs, UseReasonResult, UseReasonStep, UseReasonToolExecution, UseStructuredDataArgs, WorkflowCallError, createWorkflowHooks, useAbortSignal, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useWorkflow, useWorkflowState } from '@kortyx/hooks';
 export { CreateMCPClientArgs, MCPClient, McpToolsArgs, McpTransportConfig, createMCPClient } from '@kortyx/mcp';
 export * from '@kortyx/providers';
 export { WorkflowRegistry, clearRegisteredNodes, createFileWorkflowRegistry, createFrameworkAdapterFromEnv, createInMemoryFrameworkAdapter, createInMemoryWorkflowRegistry, createRedisFrameworkAdapter, getRegisteredNode, listRegisteredNodes, registerNode } from '@kortyx/runtime';

package/dist/index.js

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ExecutionRequestError: () => import_agent.ExecutionRequestError,
+  WorkflowCallError: () => import_hooks.WorkflowCallError,
   applyStructuredChunk: () => import_stream.applyStructuredChunk,
   clearRegisteredNodes: () => import_runtime.clearRegisteredNodes,
   collectBufferedStream: () => import_stream.collectBufferedStream,
@@ -36,6 +38,7 @@ __export(index_exports, {
   createRedisFrameworkAdapter: () => import_runtime.createRedisFrameworkAdapter,
   createStreamResponse: () => import_stream.createStreamResponse,
   createStructuredStreamAccumulator: () => import_stream.createStructuredStreamAccumulator,
+  createWorkflowHooks: () => import_hooks.createWorkflowHooks,
   defineWorkflow: () => import_core.defineWorkflow,
   getRegisteredNode: () => import_runtime.getRegisteredNode,
   handleChatRequestBody: () => import_agent.handleChatRequestBody,
@@ -50,11 +53,13 @@ __export(index_exports, {
   streamChatFromRoute: () => import_agent.streamChatFromRoute,
   summarizeStreamChunks: () => import_stream.summarizeStreamChunks,
   toSSE: () => import_stream.toSSE,
+  useAbortSignal: () => import_hooks.useAbortSignal,
   useInterrupt: () => import_hooks.useInterrupt,
   useNodeState: () => import_hooks.useNodeState,
   useReason: () => import_hooks.useReason,
   useRuntimeContext: () => import_hooks.useRuntimeContext,
   useStructuredData: () => import_hooks.useStructuredData,
+  useWorkflow: () => import_hooks.useWorkflow,
   useWorkflowState: () => import_hooks.useWorkflowState,
   validateWorkflow: () => import_core.validateWorkflow
 });
@@ -68,6 +73,8 @@ var import_runtime = require("@kortyx/runtime");
 var import_stream = require("@kortyx/stream");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ExecutionRequestError,
+  WorkflowCallError,
   applyStructuredChunk,
   clearRegisteredNodes,
   collectBufferedStream,
@@ -84,6 +91,7 @@ var import_stream = require("@kortyx/stream");
   createRedisFrameworkAdapter,
   createStreamResponse,
   createStructuredStreamAccumulator,
+  createWorkflowHooks,
   defineWorkflow,
   getRegisteredNode,
   handleChatRequestBody,
@@ -98,11 +106,13 @@ var import_stream = require("@kortyx/stream");
   streamChatFromRoute,
   summarizeStreamChunks,
   toSSE,
+  useAbortSignal,
   useInterrupt,
   useNodeState,
   useReason,
   useRuntimeContext,
   useStructuredData,
+  useWorkflow,
   useWorkflowState,
   validateWorkflow,
   ...require("@kortyx/providers")

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// release-test: 2026-01-22\n// Public DX surface for the Kortyx framework.\n\nexport type {\n  Agent,\n  AgentProcessOptions,\n  ChatRequestBody,\n  CheckpointRequestBody,\n  CreateAgentArgs,\n  StreamChatFromRouteArgs,\n} from \"@kortyx/agent\";\nexport {\n  createAgent,\n  createChatRouteHandler,\n  createCheckpointRouteHandler,\n  handleChatRequestBody,\n  handleCheckpointRequestBody,\n  parseChatRequestBody,\n  parseCheckpointRequestBody,\n  streamChatFromRoute,\n} from \"@kortyx/agent\";\nexport type {\n  GraphState,\n  NodeConfig,\n  NodeContext,\n  NodeFn,\n  NodeHandler,\n  NodeResult,\n  RuntimeEnvelope,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"@kortyx/core\";\nexport { defineWorkflow, loadWorkflow, validateWorkflow } from \"@kortyx/core\";\nexport type {\n  EnsureWorkflowTopologyRequest,\n  EnsureWorkflowTopologyResponse,\n  KortyxTelemetryConfig,\n  KortyxTelemetryContentCapture,\n  KortyxTelemetryCorrelation,\n  KortyxTelemetryEvent,\n  KortyxTelemetryEventType,\n  KortyxTelemetryPrompt,\n  KortyxTelemetryReporter,\n  KortyxTelemetryService,\n  KortyxTraceAdapter,\n  KortyxTraceMetadata,\n  UseInterruptArgs,\n  UseReasonArgs,\n  UseReasonResult,\n  UseReasonStep,\n  UseReasonToolExecution,\n  UseStructuredDataArgs,\n} from \"@kortyx/hooks\";\nexport {\n  useInterrupt,\n  useNodeState,\n  useReason,\n  useRuntimeContext,\n  useStructuredData,\n  useWorkflowState,\n} from \"@kortyx/hooks\";\nexport type {\n  CreateMCPClientArgs,\n  MCPClient,\n  McpToolsArgs,\n  McpTransportConfig,\n} from \"@kortyx/mcp\";\nexport { createMCPClient } from \"@kortyx/mcp\";\nexport * from \"@kortyx/providers\";\nexport type { WorkflowRegistry } from \"@kortyx/runtime\";\nexport {\n  clearRegisteredNodes,\n  createFileWorkflowRegistry,\n  createFrameworkAdapterFromEnv,\n  createInMemoryFrameworkAdapter,\n  createInMemoryWorkflowRegistry,\n  createRedisFrameworkAdapter,\n  getRegisteredNode,\n  listRegisteredNodes,\n  registerNode,\n} from \"@kortyx/runtime\";\nexport type {\n  BufferedStreamResult,\n  ConsumeStreamHandlers,\n  StreamChunk,\n  StructuredDataChunk,\n  StructuredStreamAccumulator,\n  StructuredStreamState,\n} from \"@kortyx/stream\";\nexport {\n  applyStructuredChunk,\n  collectBufferedStream,\n  collectStream,\n  consumeStream,\n  createStreamResponse,\n  createStructuredStreamAccumulator,\n  readStream,\n  reduceStructuredChunks,\n  summarizeStreamChunks,\n  toSSE,\n} from \"@kortyx/stream\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,mBASO;AAYP,kBAA+D;AAqB/D,mBAOO;AAOP,iBAAgC;AAChC,0BAAc,8BApEd;AAsEA,qBAUO;AASP,oBAWO;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// release-test: 2026-01-22\n// Public DX surface for the Kortyx framework.\n\nexport type {\n  Agent,\n  AgentProcessOptions,\n  ChatRequestBody,\n  CheckpointRequestBody,\n  CreateAgentArgs,\n  ExecutableWorkflow,\n  ExecuteOptions,\n  ExecutionInfo,\n  ExecutionInterrupt,\n  ExecutionResult,\n  ResumeHandle,\n  ResumeOptions,\n  ResumeResponse,\n  StreamChatFromRouteArgs,\n} from \"@kortyx/agent\";\nexport {\n  createAgent,\n  createChatRouteHandler,\n  createCheckpointRouteHandler,\n  ExecutionRequestError,\n  handleChatRequestBody,\n  handleCheckpointRequestBody,\n  parseChatRequestBody,\n  parseCheckpointRequestBody,\n  streamChatFromRoute,\n} from \"@kortyx/agent\";\nexport type {\n  ExecutionLimit,\n  ExecutionLimitReached,\n  ExecutionLimits,\n  GraphState,\n  NodeConfig,\n  NodeContext,\n  NodeFn,\n  NodeHandler,\n  NodeResult,\n  RuntimeEnvelope,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"@kortyx/core\";\nexport { defineWorkflow, loadWorkflow, validateWorkflow } from \"@kortyx/core\";\nexport type {\n  EnsureWorkflowTopologyRequest,\n  EnsureWorkflowTopologyResponse,\n  KortyxTelemetryConfig,\n  KortyxTelemetryContentCapture,\n  KortyxTelemetryCorrelation,\n  KortyxTelemetryEvent,\n  KortyxTelemetryEventType,\n  KortyxTelemetryPrompt,\n  KortyxTelemetryReporter,\n  KortyxTelemetryService,\n  KortyxTraceAdapter,\n  KortyxTraceMetadata,\n  UseInterruptArgs,\n  UseReasonArgs,\n  UseReasonResult,\n  UseReasonStep,\n  UseReasonToolExecution,\n  UseStructuredDataArgs,\n} from \"@kortyx/hooks\";\nexport {\n  createWorkflowHooks,\n  useAbortSignal,\n  useInterrupt,\n  useNodeState,\n  useReason,\n  useRuntimeContext,\n  useStructuredData,\n  useWorkflow,\n  useWorkflowState,\n  WorkflowCallError,\n} from \"@kortyx/hooks\";\nexport type {\n  CreateMCPClientArgs,\n  MCPClient,\n  McpToolsArgs,\n  McpTransportConfig,\n} from \"@kortyx/mcp\";\nexport { createMCPClient } from \"@kortyx/mcp\";\nexport * from \"@kortyx/providers\";\nexport type { WorkflowRegistry } from \"@kortyx/runtime\";\nexport {\n  clearRegisteredNodes,\n  createFileWorkflowRegistry,\n  createFrameworkAdapterFromEnv,\n  createInMemoryFrameworkAdapter,\n  createInMemoryWorkflowRegistry,\n  createRedisFrameworkAdapter,\n  getRegisteredNode,\n  listRegisteredNodes,\n  registerNode,\n} from \"@kortyx/runtime\";\nexport type {\n  BufferedStreamResult,\n  ConsumeStreamHandlers,\n  StreamChunk,\n  StructuredDataChunk,\n  StructuredStreamAccumulator,\n  StructuredStreamState,\n} from \"@kortyx/stream\";\nexport {\n  applyStructuredChunk,\n  collectBufferedStream,\n  collectStream,\n  consumeStream,\n  createStreamResponse,\n  createStructuredStreamAccumulator,\n  readStream,\n  reduceStructuredChunks,\n  summarizeStreamChunks,\n  toSSE,\n} from \"@kortyx/stream\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,mBAUO;AAeP,kBAA+D;AAqB/D,mBAWO;AAOP,iBAAgC;AAChC,0BAAc,8BApFd;AAsFA,qBAUO;AASP,oBAWO;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kortyx",
-  "version": "0.14.0",
+  "version": "0.17.0",
   "private": false,
   "description": "TypeScript framework for production AI agents with explicit workflows, provider-agnostic models, streaming, interrupts, and runtime persistence.",
   "keywords": [
@@ -43,14 +43,14 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@kortyx/agent": "0.15.0",
-    "@kortyx/cli": "0.3.0",
-    "@kortyx/hooks": "0.18.0",
-    "@kortyx/core": "0.5.3",
+    "@kortyx/cli": "0.5.2",
+    "@kortyx/agent": "0.18.0",
+    "@kortyx/core": "0.8.0",
+    "@kortyx/hooks": "0.21.0",
     "@kortyx/mcp": "0.2.0",
     "@kortyx/providers": "0.5.0",
-    "@kortyx/stream": "0.9.0",
-    "@kortyx/runtime": "0.11.1",
+    "@kortyx/runtime": "0.14.0",
+    "@kortyx/stream": "0.11.0",
     "@kortyx/utils": "0.2.6"
   },
   "devDependencies": {