@kortyx/hooks 0.23.1 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [0.25.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.24.0...hooks-v0.25.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
+
+## [0.24.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.23.1...hooks-v0.24.0) (2026-09-11)
+
+
+### Features
+
+* **hooks:** support durable parallel child workflows ([#171](https://github.com/kortyx-io/kortyx/issues/171)) ([fdf2d56](https://github.com/kortyx-io/kortyx/commit/fdf2d564d88e921988e8f3e20da9fe0c30bbcdf9))
+
 ## [0.23.1](https://github.com/kortyx-io/kortyx/compare/hooks-v0.23.0...hooks-v0.23.1) (2026-09-11)
 
 

package/README.md

@@ -78,6 +78,19 @@ string ids. Register the same definitions with the agent.
 Calls need stable ids. A child interrupt pauses the chain; resuming replays
 the enclosing node and reuses saved child results. Keep effects before calls
 idempotent. Fork/rollback retain nested checkpoints; use Redis for persistence
-across server restarts. Concurrent calls are unsupported.
+across server restarts. Join concurrent children with `parallel`:
+
+```ts
+const [first, second] = await parallel([
+  useWorkflow({ id: "first", workflow: researchWorkflow, input: { topic: "AI" } }),
+  useWorkflow({ id: "second", workflow: researchWorkflow, input: { topic: "Robotics" } }),
+]);
+```
+
+The tuple follows input order. The join preserves all siblings before pausing and
+presents waiting questions individually through the parent handle. Terminal group
+failures throw `ParallelError`, whose `results` exposes each settled outcome.
+Await groups sequentially within one node; children may contain nested groups.
+Native `Promise.all` calls and parallel graph edges remain unsupported.
 
 See [the execution and replay contract](../../docs/design-specs/child-workflows.md).

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as _kortyx_core from '@kortyx/core';
 import { WorkflowDefinition, TokenUsage, InterruptInput, GraphState, NodeConfig, InterruptResult } from '@kortyx/core';
 import { K as KortyxTelemetryConfig, R as ReasonTraceAdapter, a as KortyxTraceMetadata, b as KortyxTelemetryEventType } from './tracing-BI6YKHSf.js';
 export { E as EnsureWorkflowTopologyRequest, c as EnsureWorkflowTopologyResponse, d as KortyxTelemetryContentCapture, e as KortyxTelemetryCorrelation, f as KortyxTelemetryEvent, g as KortyxTelemetryPrompt, h as KortyxTelemetryReporter, i as KortyxTelemetryService, j as KortyxTraceAdapter, k as ReasonTraceAttributes, l as ReasonTraceSpan, m as ReasonTraceSpanEndArgs, n as ReasonTraceSpanStartArgs } from './tracing-BI6YKHSf.js';
+import { FailureDescriptor, KortyxError } from '@kortyx/core/errors';
 import { z } from 'zod';
 import { ProviderModelRef, KortyxReasoningOptions, KortyxResponseFormat, KortyxExecutableTool, KortyxUsage, KortyxFinishReason, KortyxProviderMetadata, KortyxWarning, KortyxToolCall, KortyxToolResult } from '@kortyx/providers';
 import '@kortyx/telemetry-contracts';
@@ -13,6 +14,19 @@ type CompleteResponseOptions = {
 /** Finish client delivery, leaving the node and workflow execution running. */
 declare function completeResponse(options?: CompleteResponseOptions): Promise<void>;
 
+/** All siblings have settled; results retain the order passed to parallel(). */
+declare class ParallelError extends AggregateError {
+    readonly results: readonly PromiseSettledResult<unknown>[];
+    readonly code = "PARALLEL_FAILED";
+    readonly failure: FailureDescriptor;
+    toJSON(): FailureDescriptor;
+    constructor(results: readonly PromiseSettledResult<unknown>[]);
+}
+/** Join concurrent child calls, preserving their snapshots before suspending. */
+declare function parallel<const T extends readonly unknown[]>(values: T): Promise<{
+    -readonly [K in keyof T]: Awaited<T[K]>;
+}>;
+
 type WorkflowCallOutcome = {
     status: "completed";
     data: Record<string, unknown>;
@@ -33,9 +47,9 @@ type WorkflowCallService = (args: {
     response?: string | string[] | undefined;
     callerNodeExecutionId?: string | undefined;
 }) => Promise<WorkflowCallOutcome>;
-declare class WorkflowCallError extends Error {
+declare class WorkflowCallError extends KortyxError {
     readonly workflow: string;
-    constructor(workflow: string, message: string);
+    constructor(workflow: string, message: string, cause?: unknown, failure?: FailureDescriptor);
 }
 declare function workflowCallFingerprint(value: unknown): string;
 type SchematizedWorkflow = WorkflowDefinition & {
@@ -236,4 +250,4 @@ declare function useWorkflowState<T>(key: string, ...rest: [] | [T]): [T, StateS
 /** Best effort lifecycle facts. Engine snapshots and interrupt tokens never leave the runtime. */
 declare function emitWorkflowCall(telemetry: KortyxTelemetryConfig | undefined, type: KortyxTelemetryEventType, payload: Record<string, unknown>): void;
 
-export { type CompleteResponseOptions, type HookRuntimeContext, KortyxTelemetryConfig, KortyxTelemetryEventType, KortyxTraceMetadata, ReasonTraceAdapter, type UseInterruptArgs, type UseReasonArgs, type UseReasonResult, type UseReasonStep, type UseReasonToolExecution, type UseStructuredDataArgs, WorkflowCallError, type WorkflowCallOutcome, type WorkflowCallService, completeResponse, createWorkflowHooks, emitWorkflowCall, runWithHookContext, useAbortSignal, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useWorkflow, useWorkflowState, workflowCallFingerprint };
+export { type CompleteResponseOptions, type HookRuntimeContext, KortyxTelemetryConfig, KortyxTelemetryEventType, KortyxTraceMetadata, ParallelError, ReasonTraceAdapter, type UseInterruptArgs, type UseReasonArgs, type UseReasonResult, type UseReasonStep, type UseReasonToolExecution, type UseStructuredDataArgs, WorkflowCallError, type WorkflowCallOutcome, type WorkflowCallService, completeResponse, createWorkflowHooks, emitWorkflowCall, parallel, runWithHookContext, useAbortSignal, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useWorkflow, useWorkflowState, workflowCallFingerprint };