@kortyx/hooks 0.17.1 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.19.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.18.0...hooks-v0.19.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/telemetry-contracts bumped to 0.3.0
+
+## [0.18.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.17.1...hooks-v0.18.0) (2026-08-02)
+
+
+### Features
+
+* **studio:** release self-hosted observability preview ([4e9d3fd](https://github.com/kortyx-io/kortyx/commit/4e9d3fdbc7233f9b1de94ca1afe6dbae9cc9157f))
+* **studio:** release self-hosted observability preview ([#139](https://github.com/kortyx-io/kortyx/issues/139)) ([4e9d3fd](https://github.com/kortyx-io/kortyx/commit/4e9d3fdbc7233f9b1de94ca1afe6dbae9cc9157f))
+* **telemetry:** add persisted studio read models ([cebb06b](https://github.com/kortyx-io/kortyx/commit/cebb06bb74ccd4422e263f0ff4efa0fee5a16240))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/telemetry-contracts bumped to 0.2.0
+
 ## [0.17.1](https://github.com/kortyx-io/kortyx/compare/hooks-v0.17.0...hooks-v0.17.1) (2026-05-28)
 
 

package/LICENSE

@@ -1,10 +1,18 @@
+Copyright 2026 Kortyx contributors
+
+Portions of this software are licensed as follows:
+
+- All content that resides under the `apps/studio/` directory of this repository is licensed under the license defined in `apps/studio/LICENSE.md`.
+- All content that resides under a `plugins/*/` directory of this repository is licensed under the license defined in that plugin's `LICENSE.md`.
+- All third party components incorporated into the Kortyx software are licensed under the original license provided by the owner of the applicable component.
+- Content outside of the above mentioned directories or restrictions is available under the Apache License, Version 2.0, as defined below.
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
 
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
+  TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+  1.  Definitions.
 
       "License" shall mean the terms and conditions for use, reproduction,
       and distribution as defined by Sections 1 through 9 of this document.
@@ -63,14 +71,14 @@
       on behalf of whom a Contribution has been received by Licensor and
       subsequently incorporated within the Work.
 
-   2. Grant of Copyright License. Subject to the terms and conditions of
+  2.  Grant of Copyright License. Subject to the terms and conditions of
       this License, each Contributor hereby grants to You a perpetual,
       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
       copyright license to reproduce, prepare Derivative Works of,
       publicly display, publicly perform, sublicense, and distribute the
       Work and such Derivative Works in Source or Object form.
 
-   3. Grant of Patent License. Subject to the terms and conditions of
+  3.  Grant of Patent License. Subject to the terms and conditions of
       this License, each Contributor hereby grants to You a perpetual,
       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
       (except as stated in this section) patent license to make, have made,
@@ -86,39 +94,39 @@
       granted to You under this License for that Work shall terminate
       as of the date such litigation is filed.
 
-   4. Redistribution. You may reproduce and distribute copies of the
+  4.  Redistribution. You may reproduce and distribute copies of the
       Work or Derivative Works thereof in any medium, with or without
       modifications, and in Source or Object form, provided that You
       meet the following conditions:
 
       (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
+      Derivative Works a copy of this License; and
 
       (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
+      stating that You changed the files; and
 
       (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
+      that You distribute, all copyright, patent, trademark, and
+      attribution notices from the Source form of the Work,
+      excluding those notices that do not pertain to any part of
+      the Derivative Works; and
 
       (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
+      distribution, then any Derivative Works that You distribute must
+      include a readable copy of the attribution notices contained
+      within such NOTICE file, excluding those notices that do not
+      pertain to any part of the Derivative Works, in at least one
+      of the following places: within a NOTICE text file distributed
+      as part of the Derivative Works; within the Source form or
+      documentation, if provided along with the Derivative Works; or,
+      within a display generated by the Derivative Works, if and
+      wherever such third-party notices normally appear. The contents
+      of the NOTICE file are for informational purposes only and
+      do not modify the License. You may add Your own attribution
+      notices within Derivative Works that You distribute, alongside
+      or as an addendum to the NOTICE text from the Work, provided
+      that such additional attribution notices cannot be construed
+      as modifying the License.
 
       You may add Your own copyright statement to Your modifications and
       may provide additional or different license terms and conditions
@@ -127,7 +135,7 @@
       reproduction, and distribution of the Work otherwise complies with
       the conditions stated in this License.
 
-   5. Submission of Contributions. Unless You explicitly state otherwise,
+  5.  Submission of Contributions. Unless You explicitly state otherwise,
       any Contribution intentionally submitted for inclusion in the Work
       by You to the Licensor shall be under the terms and conditions of
       this License, without any additional terms or conditions.
@@ -135,12 +143,12 @@
       the terms of any separate license agreement you may have executed
       with Licensor regarding such Contributions.
 
-   6. Trademarks. This License does not grant permission to use the trade
+  6.  Trademarks. This License does not grant permission to use the trade
       names, trademarks, service marks, or product names of the Licensor,
       except as required for reasonable and customary use in describing the
       origin of the Work and reproducing the content of the NOTICE file.
 
-   7. Disclaimer of Warranty. Unless required by applicable law or
+  7.  Disclaimer of Warranty. Unless required by applicable law or
       agreed to in writing, Licensor provides the Work (and each
       Contributor provides its Contributions) on an "AS IS" BASIS,
       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
@@ -150,7 +158,7 @@
       appropriateness of using or redistributing the Work and assume any
       risks associated with Your exercise of permissions under this License.
 
-   8. Limitation of Liability. In no event and under no legal theory,
+  8.  Limitation of Liability. In no event and under no legal theory,
       whether in tort (including negligence), contract, or otherwise,
       unless required by applicable law (such as deliberate and grossly
       negligent acts) or agreed to in writing, shall any Contributor be
@@ -162,7 +170,7 @@
       other commercial damages or losses), even if such Contributor
       has been advised of the possibility of such damages.
 
-   9. Accepting Warranty or Additional Liability. While redistributing
+  9.  Accepting Warranty or Additional Liability. While redistributing
       the Work or Derivative Works thereof, You may choose to offer,
       and charge a fee for, acceptance of support, warranty, indemnity,
       or other liability obligations and/or rights consistent with this
@@ -173,9 +181,9 @@
       incurred by, or claims asserted against, such Contributor by reason
       of your accepting any such warranty or additional liability.
 
-   END OF TERMS AND CONDITIONS
+  END OF TERMS AND CONDITIONS
 
-   APPENDIX: How to apply the Apache License to your work.
+  APPENDIX: How to apply the Apache License to your work.
 
       To apply the Apache License to your work, attach the following
       boilerplate notice, with the fields enclosed by brackets "[]"
@@ -186,16 +194,16 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+  Copyright [yyyy] [name of copyright owner]
 
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
 
        http://www.apache.org/licenses/LICENSE-2.0
 
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.

package/README.md

@@ -53,3 +53,31 @@ Workarounds:
 ## License
 
 Apache-2.0. See [LICENSE](https://github.com/kortyx-io/kortyx/blob/main/LICENSE).
+
+
+## Child workflows
+
+Call a registered workflow from a node or custom hook and continue with its
+result:
+
+```ts
+const result = await useWorkflow({
+  id: "research",
+  workflow: researchWorkflow,
+  input: { topic: "AI agents" },
+});
+return { data: { summary: result.data.summary } };
+```
+
+The child defines `inputSchema` and `outputSchema` on `defineWorkflow`.
+Inputs and returned data are inferred from those schemas and validated at
+runtime. The result is the child's accumulated data parsed by its output
+schema. Use `createWorkflowHooks({ research: researchWorkflow })` for typed
+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.
+
+See [the execution and replay contract](../../docs/design-specs/child-workflows.md).

package/dist/index.d.ts

@@ -1,7 +1,63 @@
-import { NodeConfig, InterruptInput, InterruptResult, GraphState } from '@kortyx/core';
-import { R as ReasonTraceAdapter, K as KortyxTraceMetadata } from './tracing-DhjgeiDS.js';
-export { a as KortyxTelemetryConfig, b as KortyxTelemetryContentCapture, c as KortyxTelemetryPrompt, d as KortyxTraceAdapter, e as ReasonTraceAttributes, f as ReasonTraceSpan, g as ReasonTraceSpanEndArgs, h as ReasonTraceSpanStartArgs } from './tracing-DhjgeiDS.js';
+import { WorkflowDefinition, TokenUsage, InterruptInput, NodeConfig, InterruptResult, GraphState } 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 { z } from 'zod';
 import { ProviderModelRef, KortyxReasoningOptions, KortyxResponseFormat, KortyxExecutableTool, KortyxUsage, KortyxFinishReason, KortyxProviderMetadata, KortyxWarning, KortyxToolCall, KortyxToolResult } from '@kortyx/providers';
+import '@kortyx/telemetry-contracts';
+
+type WorkflowCallOutcome = {
+    status: "completed";
+    data: Record<string, unknown>;
+    usage?: TokenUsage | undefined;
+} | {
+    status: "interrupted";
+    request: InterruptInput;
+    snapshot: unknown;
+};
+type WorkflowCallService = (args: {
+    id: string;
+    workflow: string;
+    input: unknown;
+    snapshot?: unknown;
+    definition?: WorkflowDefinition | undefined;
+    invocationId: string;
+    response?: string | string[] | undefined;
+    callerNodeExecutionId?: string | undefined;
+}) => Promise<WorkflowCallOutcome>;
+declare class WorkflowCallError extends Error {
+    readonly workflow: string;
+    constructor(workflow: string, message: string);
+}
+declare function workflowCallFingerprint(value: unknown): string;
+type SchematizedWorkflow = WorkflowDefinition & {
+    inputSchema: z.ZodType;
+    outputSchema: z.ZodType<Record<string, unknown>>;
+};
+/** Bind string workflow ids to the same definitions registered with the agent. */
+declare function createWorkflowHooks<const W extends Record<string, SchematizedWorkflow>>(workflows: W): {
+    useWorkflow: <K extends keyof W & string>(args: {
+        id: string;
+        workflow: K;
+        input: z.input<W[K]["inputSchema"]>;
+    }) => Promise<{
+        data: z.output<W[K]["outputSchema"]>;
+    }>;
+};
+/** Typed references avoid caller-supplied result type assertions. */
+declare function useWorkflow<W extends SchematizedWorkflow>(args: {
+    id: string;
+    workflow: W;
+    input: z.input<W["inputSchema"]>;
+}): Promise<{
+    data: z.output<W["outputSchema"]>;
+}>;
+declare function useWorkflow(args: {
+    id: string;
+    workflow: string;
+    input: unknown;
+}): Promise<{
+    data: Record<string, unknown>;
+}>;
 
 type HookNodeRuntimeContext = {
     graph: {
@@ -11,6 +67,8 @@ type HookNodeRuntimeContext = {
     config: NodeConfig;
     emit: (event: string, payload: unknown) => void;
     awaitInterrupt: (args: InterruptInput) => InterruptResult;
+    callWorkflow?: WorkflowCallService;
+    workflowCallTelemetry?: KortyxTelemetryConfig | undefined;
 };
 type HookRuntimeContext = {
     node: HookNodeRuntimeContext;
@@ -160,4 +218,7 @@ declare function useRuntimeContext<TContext extends Record<string, unknown> = Re
 declare function useNodeState<T>(initialValue: T): [T, StateSetter<T>];
 declare function useWorkflowState<T>(key: string, ...rest: [] | [T]): [T, StateSetter<T>];
 
-export { type HookRuntimeContext, KortyxTraceMetadata, ReasonTraceAdapter, type UseInterruptArgs, type UseReasonArgs, type UseReasonResult, type UseReasonStep, type UseReasonToolExecution, type UseStructuredDataArgs, runWithHookContext, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useWorkflowState };
+/** 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 HookRuntimeContext, KortyxTelemetryConfig, KortyxTelemetryEventType, KortyxTraceMetadata, ReasonTraceAdapter, type UseInterruptArgs, type UseReasonArgs, type UseReasonResult, type UseReasonStep, type UseReasonToolExecution, type UseStructuredDataArgs, WorkflowCallError, type WorkflowCallOutcome, type WorkflowCallService, createWorkflowHooks, emitWorkflowCall, runWithHookContext, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useWorkflow, useWorkflowState, workflowCallFingerprint };

package/dist/index.js

@@ -19,13 +19,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  WorkflowCallError: () => WorkflowCallError,
+  createWorkflowHooks: () => createWorkflowHooks,
+  emitWorkflowCall: () => emitWorkflowCall,
   runWithHookContext: () => runWithHookContext,
   useInterrupt: () => useInterrupt,
   useNodeState: () => useNodeState,
   useReason: () => useReason2,
   useRuntimeContext: () => useRuntimeContext,
   useStructuredData: () => useStructuredData,
-  useWorkflowState: () => useWorkflowState
+  useWorkflow: () => useWorkflow,
+  useWorkflowState: () => useWorkflowState,
+  workflowCallFingerprint: () => workflowCallFingerprint
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -78,6 +83,8 @@ var createInternalContext = (ctx) => {
   const currentNodeState = storedNodeId && storedNodeId === nodeId ? normalizeNodeState(storedState) : { byIndex: [], byKey: {} };
   return {
     ...ctx,
+    workflowCallActive: false,
+    workflowCallIds: /* @__PURE__ */ new Set(),
     nodeStateIndex: 0,
     reasonCallIndex: 0,
     currentNodeState,
@@ -151,6 +158,12 @@ async function runWithHookContext(ctx, fn) {
   try {
     const result = await storage.run(internal, fn);
     cleanupCompletedReasonCheckpoints(internal);
+    for (const key of Object.keys(internal.currentNodeState.byKey)) {
+      if (key.startsWith("__useWorkflow:") || key === "__useWorkflowActivation") {
+        internal.currentNodeState.byKey[key] = null;
+        internal.stateDirty = true;
+      }
+    }
     return { result, runtimeUpdates: buildRuntimeStateUpdates(internal) };
   } catch (err) {
     const runtimeUpdates = buildRuntimeStateUpdates(internal);
@@ -248,7 +261,10 @@ var awaitInterruptInternal = (args) => {
     ...typeof args.id === "string" && args.id.length > 0 ? { id: args.id } : {},
     meta: {
       ...userMeta,
-      __kortyxResumeStatePatch: resumeStatePatch
+      __kortyxResumeStatePatch: {
+        ...resumeStatePatch,
+        ...ctx.tokenUsage ? { tokenUsage: ctx.tokenUsage } : {}
+      }
     }
   };
   const raw = ctx.node.awaitInterrupt(enrichedRequest);
@@ -424,6 +440,17 @@ async function runReasonEngine(args) {
       input: args.telemetry?.input ?? messages
     }
   });
+  const modelRequestStartedAt = Date.now();
+  let firstTextTokenAt;
+  let lastTextTokenAt;
+  const generationTimingAttributes = () => firstTextTokenAt === void 0 || lastTextTokenAt === void 0 ? {} : {
+    ttftMs: Math.max(0, firstTextTokenAt - modelRequestStartedAt),
+    streamDurationMs: Math.max(0, lastTextTokenAt - firstTextTokenAt),
+    timeToLastTokenMs: Math.max(
+      0,
+      lastTextTokenAt - modelRequestStartedAt
+    )
+  };
   const endTrace = (span, result) => {
     span?.end?.({
       ...result.usage !== void 0 ? { usage: result.usage } : {},
@@ -431,7 +458,8 @@ async function runReasonEngine(args) {
       ...result.providerMetadata !== void 0 ? { providerMetadata: result.providerMetadata } : {},
       ...result.warnings !== void 0 ? { warnings: result.warnings } : {},
       attributes: {
-        textLength: result.text.length
+        textLength: result.text.length,
+        ...generationTimingAttributes()
       },
       telemetry: {
         ...args.telemetry ?? {},
@@ -466,6 +494,9 @@ async function runReasonEngine(args) {
         switch (chunk.type) {
           case "text-delta": {
             if (chunk.delta.length === 0) break;
+            const tokenAt = Date.now();
+            firstTextTokenAt ??= tokenAt;
+            lastTextTokenAt = tokenAt;
             final += chunk.delta;
             args.onTextChunk?.(chunk.delta);
             if (chunk.raw !== void 0) {
@@ -1709,6 +1740,11 @@ var runReasonToolLoop = async (args) => {
           tool.name,
           false
         );
+        traceSpan?.addEvent?.("useReason.tool-call.start", {
+          stepIndex,
+          tool: tool.name,
+          toolCallId: toolCall.id
+        });
         if (shouldEmitTool) {
           emitToolEvent("tool-call-start", {
             tool: tool.name,
@@ -2311,14 +2347,243 @@ function useWorkflowState(key, ...rest) {
   };
   return [getValue(), setValue];
 }
+
+// src/workflow.ts
+var import_node_crypto5 = require("crypto");
+
+// src/workflow-telemetry.ts
+var import_node_crypto4 = require("crypto");
+function emitWorkflowCall(telemetry, type, payload) {
+  const base = telemetry?.correlation;
+  if (!telemetry?.reporter || !telemetry.environment || !telemetry.service || !base?.runId || !base.workflowId)
+    return;
+  try {
+    const active = telemetry.trace?.getActiveContext?.();
+    void Promise.resolve(
+      telemetry.reporter.emit([
+        {
+          schemaVersion: 1,
+          eventId: (0, import_node_crypto4.randomUUID)(),
+          occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+          environment: telemetry.environment,
+          service: telemetry.service,
+          correlation: {
+            ...base,
+            runId: base.runId,
+            workflowId: base.workflowId,
+            ...active
+          },
+          type,
+          payload
+        }
+      ])
+    ).catch(() => {
+    });
+  } catch {
+  }
+}
+function workflowCallContent(telemetry, side, value) {
+  const policy = telemetry?.captureContent;
+  if (!(policy === true || policy && typeof policy === "object" && policy[side]))
+    return {};
+  const serialized = JSON.stringify(value);
+  return serialized && Buffer.byteLength(serialized, "utf8") <= 16384 ? { [side]: JSON.parse(serialized) } : { [`${side}Omitted`]: "Content exceeds 16 KiB" };
+}
+
+// src/workflow.ts
+var WorkflowCallError = class extends Error {
+  constructor(workflow, message) {
+    super(`Workflow '${workflow}': ${message}`);
+    this.workflow = workflow;
+    this.name = "WorkflowCallError";
+  }
+  workflow;
+};
+function workflowCallFingerprint(value) {
+  const seen = /* @__PURE__ */ new Set();
+  const canonical = (v) => {
+    if (v === null || typeof v === "string" || typeof v === "boolean") return v;
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+    if (typeof v !== "object" || !v || seen.has(v)) {
+      throw new Error("Workflow input and output must be JSON serializable.");
+    }
+    if (!Array.isArray(v) && Object.getPrototypeOf(v) !== Object.prototype) {
+      throw new Error(
+        "Workflow input and output must contain plain JSON objects."
+      );
+    }
+    seen.add(v);
+    const result = Array.isArray(v) ? v.map(canonical) : Object.fromEntries(
+      Object.keys(v).sort().map((key) => [
+        key,
+        canonical(v[key])
+      ])
+    );
+    seen.delete(v);
+    return result;
+  };
+  return JSON.stringify(canonical(value));
+}
+function createWorkflowHooks(workflows) {
+  return {
+    useWorkflow: (args) => {
+      const workflow = workflows[args.workflow];
+      if (!workflow || workflow.id !== args.workflow)
+        throw new Error("Workflow registry keys must match definition ids.");
+      return useWorkflow({ ...args, workflow });
+    }
+  };
+}
+async function useWorkflow(args) {
+  const ctx = getHookContext();
+  const service = ctx.node.callWorkflow;
+  if (!service)
+    throw new Error("useWorkflow requires an agent workflow registry.");
+  if (!args.id.trim())
+    throw new Error("useWorkflow requires a stable, nonempty id.");
+  if (ctx.workflowCallActive)
+    throw new Error(
+      "Concurrent workflow calls are not supported; await each call."
+    );
+  if (ctx.workflowCallIds.has(args.id))
+    throw new Error(
+      `Duplicate workflow call id '${args.id}' in one node activation.`
+    );
+  if (ctx.workflowCallIds.size >= 64)
+    throw new Error(
+      "A node may call at most 64 child workflows per activation."
+    );
+  ctx.workflowCallIds.add(args.id);
+  const definition = typeof args.workflow === "string" ? void 0 : args.workflow;
+  const workflow = definition?.id ?? args.workflow;
+  const input = args.input;
+  const fingerprint = workflowCallFingerprint({
+    workflow,
+    input,
+    version: definition?.version ?? null
+  });
+  const key = `__useWorkflow:${args.id}`;
+  let record = ctx.currentNodeState.byKey[key];
+  if (record && record.fingerprint !== fingerprint)
+    throw new WorkflowCallError(
+      workflow,
+      "call input or target changed during replay"
+    );
+  record ??= {
+    fingerprint,
+    invocationId: (0, import_node_crypto5.randomUUID)(),
+    status: "running",
+    interrupts: []
+  };
+  ctx.currentNodeState.byKey[key] = record;
+  ctx.stateDirty = true;
+  ctx.workflowCallActive = true;
+  const telemetry = ctx.node.workflowCallTelemetry;
+  const activationKey = "__useWorkflowActivation";
+  ctx.currentNodeState.byKey[activationKey] ??= (0, import_node_crypto5.randomUUID)();
+  const callerNodeExecutionId = ctx.currentNodeState.byKey[activationKey];
+  const metadata = {
+    invocationId: record.invocationId,
+    parentInvocationId: telemetry?.correlation?.invocationId ?? null,
+    branchId: telemetry?.correlation?.branchId ?? telemetry?.correlation?.runId ?? "unknown",
+    callId: args.id,
+    callerNodeId: ctx.node.graph.node,
+    callerNodeExecutionId,
+    sourceWorkflowId: ctx.node.graph.name,
+    targetWorkflowId: workflow,
+    targetVersion: definition?.version ?? null
+  };
+  record.telemetry = metadata;
+  const report = (status, content = {}) => {
+    record.sequence = (record.sequence ?? 0) + 1;
+    emitWorkflowCall(telemetry, `workflow.call.${status}`, {
+      ...metadata,
+      sequence: record.sequence,
+      ...content
+    });
+  };
+  const cached = record.status === "completed";
+  try {
+    for (const interruption of record.interrupts) {
+      interruption.response = await awaitInterruptInternal({
+        request: interruption.request,
+        ...interruption.request.meta ? { meta: interruption.request.meta } : {}
+      });
+    }
+    if (record.status === "failed")
+      throw new WorkflowCallError(workflow, record.error ?? "child failed");
+    while (record.status !== "completed") {
+      let outcome;
+      try {
+        report(
+          record.snapshot ? "resumed" : "started",
+          workflowCallContent(telemetry, "input", input)
+        );
+        outcome = await service({
+          callerNodeExecutionId,
+          id: args.id,
+          workflow,
+          input,
+          definition,
+          invocationId: record.invocationId,
+          ...record.snapshot ? { snapshot: record.snapshot } : {},
+          ...record.interrupts.length ? { response: record.interrupts.at(-1)?.response } : {}
+        });
+      } catch (error) {
+        record.status = "failed";
+        record.error = error instanceof Error ? error.message : String(error);
+        report("failed", { error: "Child workflow failed" });
+        throw new WorkflowCallError(workflow, record.error);
+      }
+      if (outcome.status === "completed") {
+        record.data = outcome.data;
+        accumulateTokenUsage(outcome.usage);
+        workflowCallFingerprint(record.data);
+        record.status = "completed";
+        delete record.snapshot;
+        report(
+          "completed",
+          workflowCallContent(telemetry, "output", record.data)
+        );
+      } else {
+        record.status = "interrupted";
+        record.snapshot = outcome.snapshot;
+        report("suspended", {
+          leaf: outcome.request.meta?.workflowCall ?? null
+        });
+        const interruption = {
+          request: outcome.request
+        };
+        record.interrupts.push(interruption);
+        interruption.response = await awaitInterruptInternal({
+          request: interruption.request,
+          ...interruption.request.meta ? { meta: interruption.request.meta } : {}
+        });
+      }
+    }
+    if (cached)
+      report("reused", workflowCallContent(telemetry, "output", record.data));
+    const data = record.data ?? {};
+    return {
+      data: JSON.parse(JSON.stringify(data))
+    };
+  } finally {
+    ctx.workflowCallActive = false;
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  WorkflowCallError,
+  createWorkflowHooks,
+  emitWorkflowCall,
   runWithHookContext,
   useInterrupt,
   useNodeState,
   useReason,
   useRuntimeContext,
   useStructuredData,
-  useWorkflowState
+  useWorkflow,
+  useWorkflowState,
+  workflowCallFingerprint
 });
 //# sourceMappingURL=index.js.map