@kortyx/agent 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.22.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.21.0...agent-v0.22.0) (2026-09-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **errors:** public failure messages and default HTTP statuses change; malformed streams fail explicitly, provider error classes are shared, and retry helpers exclude control flow. Existing calls and legacy records remain supported. See the error-contract migration and release notes.
+
+### Features
+
+* **errors:** harden failure contracts across execution and recovery ([#175](https://github.com/kortyx-io/kortyx/issues/175)) ([d231e36](https://github.com/kortyx-io/kortyx/commit/d231e364259a4f23fc3675d8783fde5ba338416e))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/core bumped to 0.9.0
+    * @kortyx/providers bumped to 0.7.0
+    * @kortyx/runtime bumped to 0.17.0
+    * @kortyx/stream bumped to 0.12.0
+    * @kortyx/utils bumped to 0.3.0
+  * devDependencies
+    * @kortyx/hooks bumped to 0.25.0
+    * @kortyx/openai bumped to 0.5.0
+
 ## [0.21.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.20.1...agent-v0.21.0) (2026-09-11)
 
 

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { GetProviderFn } from '@kortyx/providers';
 import { PendingRequestRecord, PendingRequestStore, CheckpointSummary, CheckpointId, SessionCheckpointRecord, RollbackSessionCheckpointResult, ForkSessionCheckpointResult, WorkflowRegistry, FrameworkAdapter, ExecutionRuntimeConfig } from '@kortyx/runtime';
 import { StreamChunk } from '@kortyx/stream';
 import { z } from 'zod';
+import { FailureDescriptor, KortyxError } from '@kortyx/core/errors';
 import * as _kortyx_hooks from '@kortyx/hooks';
 import { KortyxTelemetryConfig, EnsureWorkflowTopologyRequest } from '@kortyx/hooks';
 import { C as ChatMessage } from './browser-wjeg_MwV.js';
@@ -61,10 +62,7 @@ type ExecutionResult<T = Record<string, unknown>> = ExecutionInfo & ({
     reason: string;
 } | {
     status: "failed";
-    error: {
-        code: string;
-        message: string;
-    };
+    error: Pick<FailureDescriptor, "code" | "message"> & Partial<FailureDescriptor>;
 });
 type ExecuteOptions<W extends ExecutableWorkflow> = {
     limits?: ExecutionLimits;
@@ -82,10 +80,9 @@ type ResumeOptions<W extends ExecutableWorkflow> = {
     response: ResumeResponse;
 };
 /** The command was rejected before starting work or claiming an interrupt. */
-declare class ExecutionRequestError extends Error {
-    readonly code: string;
+declare class ExecutionRequestError extends KortyxError {
     name: string;
-    constructor(code: string, message: string);
+    constructor(code: string, message: string, cause?: unknown);
 }
 
 declare const scopeSchema: z.ZodObject<{
@@ -206,6 +203,10 @@ type CheckpointRequestBody = {
     checkpointId: string;
     newSessionId?: string | undefined;
 };
+/** Read an object-shaped API command without exposing parser/input details. */
+declare function readRequestJson(request: Request): Promise<Record<string, unknown>>;
+/** Safe response for custom route handlers. Control flow propagates unchanged. */
+declare function createFailureResponse(error: unknown, status?: number): Response;
 declare function parseChatRequestBody(value: unknown): ChatRequestBody;
 declare function parseCheckpointRequestBody(value: unknown): CheckpointRequestBody;
 declare function handleChatRequestBody(args: {
@@ -342,4 +343,4 @@ declare function transformGraphStreamForUI(stream: AsyncIterable<StreamEvent>, o
 
 declare function extractLatestUserMessage(messages: ChatMessage[]): string;
 
-export { type Agent, type AgentProcessOptions, type AgentProjectTopologyOptions, type ApplyResumeSelection, ChatMessage, type ChatRequestBody, type CheckpointRequestBody, type CompiledGraphLike, type CreateAgentArgs, type ExecutableWorkflow, type ExecuteOptions, type ExecutionInfo, type ExecutionInterrupt, ExecutionRequestError, type ExecutionResult, type InterruptScope, type ListInterruptsOptions, type OrchestrateArgs, type PendingInterrupt, type ResumableInterrupt, type ResumeHandle, type ResumeMeta, type ResumeOptions, type ResumeResponse, type SaveMemoryFn, type SelectWorkflowFn, type StreamChatArgs, createAgent, createChatRouteHandler, createCheckpointRouteHandler, extractLatestUserMessage, handleChatRequestBody, handleCheckpointRequestBody, orchestrateGraphStream, parseChatRequestBody, parseCheckpointRequestBody, parseResumeMeta, projectWorkflowTopology, streamChat, transformGraphStreamForUI, tryPrepareResumeStream };
+export { type Agent, type AgentProcessOptions, type AgentProjectTopologyOptions, type ApplyResumeSelection, ChatMessage, type ChatRequestBody, type CheckpointRequestBody, type CompiledGraphLike, type CreateAgentArgs, type ExecutableWorkflow, type ExecuteOptions, type ExecutionInfo, type ExecutionInterrupt, ExecutionRequestError, type ExecutionResult, type InterruptScope, type ListInterruptsOptions, type OrchestrateArgs, type PendingInterrupt, type ResumableInterrupt, type ResumeHandle, type ResumeMeta, type ResumeOptions, type ResumeResponse, type SaveMemoryFn, type SelectWorkflowFn, type StreamChatArgs, createAgent, createChatRouteHandler, createCheckpointRouteHandler, createFailureResponse, extractLatestUserMessage, handleChatRequestBody, handleCheckpointRequestBody, orchestrateGraphStream, parseChatRequestBody, parseCheckpointRequestBody, parseResumeMeta, projectWorkflowTopology, readRequestJson, streamChat, transformGraphStreamForUI, tryPrepareResumeStream };