@codemation/core 0.11.0 → 0.12.0

package/dist/{RunIntentService-MUHJ1bhO.d.cts → agentMcpTypes-DUmniLOY.d.cts}

@@ -189,6 +189,19 @@ type CredentialInstanceRecord<TPublicConfig extends CredentialJsonRecord = Crede
   setupStatus: CredentialSetupStatus;
   createdAt: string;
   updatedAt: string;
+  /**
+   * Pointer to where the credential material bytes live. For OSS / standalone
+   * rows this is `{source: "local", ref: instanceId}` and the bytes co-locate
+   * with the row in the workspace DB. For managed-mode rows this is
+   * `{source: "control-plane", ref: <cp_id>}` and the bytes live at CP.
+   *
+   * The seam is read through `CredentialMaterialProvider`. See
+   * `docs/design/credentials-oauth-unification.md` ("Material provider seam").
+   */
+  material: Readonly<{
+    source: "local" | "control-plane";
+    ref: string;
+  }>;
 }>;
 /**
  * Arguments passed to `CredentialType.createSession` and `CredentialType.test`.
@@ -396,6 +409,16 @@ declare class CodemationTelemetryAttributeNames {
   static readonly mcpServerId = "mcp.server_id";
   /** MCP tool name on spans created for callTool invocations. */
   static readonly mcpToolName = "mcp.tool_name";
+  /** Terminal node-execution status (e.g. `"hitl-approved"`, `"hitl-rejected"`) on HITL outcome spans. */
+  static readonly nodeExecutionStatus = "codemation.node.execution_status";
+  /** Populated on run-halted spans; discriminates the halt reason (e.g. `"hitl-rejected"`). */
+  static readonly runHaltReason = "codemation.run.halt_reason";
+  /** Human task ID on `hitl.task.*` span events. */
+  static readonly hitlTaskId = "codemation.hitl.task_id";
+  /** HITL channel name (e.g. `"inbox"`, `"control-plane-inbox"`) on `hitl.task.*` span events. */
+  static readonly hitlChannel = "codemation.hitl.channel";
+  /** Decision outcome (e.g. `"approved"`, `"rejected"`) on `hitl.task.decided` span events. */
+  static readonly hitlDecisionStatus = "codemation.hitl.decision_status";
 }
 //#endregion
 //#region src/contracts/GenAiTelemetryAttributeNames.d.ts
@@ -572,6 +595,100 @@ interface WebhookTriggerMatcher {
 }
 //#endregion
 //#region src/contracts/runtimeTypes.d.ts
+/** Opaque unique identifier for a single HumanTask instance. */
+type HumanTaskId = string;
+/**
+ * Duration string — ISO 8601 duration ("PT24H") or shorthand ("24h").
+ * Parsed by the timeout job; stored as-is in the suspension record.
+ */
+type Duration = string;
+/**
+ * Minimal handle handed to the `deliver` callback so it can route to the correct
+ * inbox channel.
+ */
+interface HumanTaskHandle {
+  readonly taskId: HumanTaskId;
+  readonly runId: string;
+  readonly nodeId: string;
+  readonly expiresAt: Date;
+  /** TODO: real signed URL; placeholder empty string for now. */
+  readonly resumeUrl: string;
+  /**
+   * Arbitrary JSON metadata copied from `SuspensionRequest.request.metadata` at suspension time.
+   * Used by the agent runtime to round-trip the `agentCheckpoint` back to the
+   * resumed node via `ctx.resumeContext.task.metadata`.
+   */
+  readonly metadata?: Readonly<Record<string, JsonValue>>;
+}
+/** Human-readable description surface shown to the reviewer. */
+interface HumanTaskSubject {
+  readonly title: string;
+  readonly summary: string;
+  readonly attributes?: JsonValue;
+}
+/** Identity of the person who made a decision on the task. */
+interface HumanTaskActor {
+  readonly actorId: string;
+  readonly displayName?: string;
+}
+/**
+ * Resume context injected into `NodeExecutionContext` when the engine re-activates
+ * a previously suspended node. `defineHumanApprovalNode` wraps this with parsed
+ * `TDecision`; at the engine layer `decision.value` is `unknown`.
+ */
+interface ResumeContext {
+  readonly decision: Readonly<{
+    kind: "decided";
+    value: unknown;
+    actor: HumanTaskActor;
+    decidedAt: Date;
+  }> | Readonly<{
+    kind: "timed_out";
+    at: Date;
+  }> | Readonly<{
+    kind: "auto_accepted";
+    at: Date;
+  }>;
+  readonly delivery: JsonValue;
+  readonly task: HumanTaskHandle;
+}
+/**
+ * Thrown by a node's `execute()` to request durable suspension of the current item.
+ * The engine catches this, persists the suspension entry, calls `deliver`, and
+ * continues to the next item (per-item semantics).
+ *
+ * @example
+ * ```ts
+ * throw new SuspensionRequest({
+ *   decisionSchema: z.object({ approved: z.boolean() }),
+ *   timeout: "PT24H",
+ *   onTimeout: "halt",
+ *   subject: { title: "Approve invoice", summary: "Invoice #1234 needs approval" },
+ *   deliver: async (handle) => {
+ *     await notifySlack(handle);
+ *     return { channel: "slack", ts: "..." };
+ *   },
+ * });
+ * ```
+ */
+declare class SuspensionRequest<TDecision = unknown, TDelivery extends JsonValue = JsonValue> extends Error {
+  readonly request: Readonly<{
+    decisionSchema: ZodType<TDecision>;
+    timeout: Duration;
+    onTimeout: "halt" | "auto-accept";
+    subject: HumanTaskSubject;
+    metadata?: Readonly<Record<string, JsonValue>>;
+    deliver: (handle: HumanTaskHandle) => Promise<TDelivery>;
+  }>;
+  constructor(request: Readonly<{
+    decisionSchema: ZodType<TDecision>;
+    timeout: Duration;
+    onTimeout: "halt" | "auto-accept";
+    subject: HumanTaskSubject;
+    metadata?: Readonly<Record<string, JsonValue>>;
+    deliver: (handle: HumanTaskHandle) => Promise<TDelivery>;
+  }>);
+}
 interface WorkflowRunnerService {
   runById(args: {
     workflowId: WorkflowId;
@@ -705,6 +822,14 @@ interface ExecutionContext {
    * Collections registered in the codemation config, keyed by collection name.
    */
   readonly collections?: CollectionsContext;
+  /**
+   * Resolve a DI token from the host container.
+   * Allows nodes to reach host-side services (e.g. `InboxChannelResolverToken`)
+   * without importing host code. Wired by `DefaultExecutionContextFactory`; throws
+   * a clear error when no resolver is configured (e.g. in unit tests that don't
+   * set up the full container).
+   */
+  resolve<T>(token: TypeToken<T>): T;
 }
 interface ExecutionContextFactory {
   create(args: {
@@ -728,6 +853,11 @@ interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase>
   config: TConfig;
   telemetry: NodeExecutionTelemetry;
   binary: NodeBinaryAttachmentService;
+  /**
+   * Present when this node activation is a HITL resume.
+   * The node checks `ctx.resumeContext !== undefined` and takes the resume branch.
+   */
+  resumeContext?: ResumeContext;
 }
 interface PollingTriggerHandle {
   /**
@@ -1634,7 +1764,7 @@ interface RunQueueEntry {
     received: Readonly<Record<InputPortKey, Items>>;
   }>;
 }
-type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
+type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped" | "hitl-approved" | "hitl-rejected" | "hitl-timeout" | "hitl-auto-accepted" | "hitl-cancelled";
 interface NodeExecutionError {
   message: string;
   name?: string;
@@ -1742,7 +1872,9 @@ interface ExecutionFrontierPlan {
   clearedNodeIds: ReadonlyArray<NodeId>;
   preservedPinnedNodeIds: ReadonlyArray<NodeId>;
 }
-type RunStatus = "running" | "pending" | "completed" | "failed";
+type RunStatus = "running" | "pending" | "completed" | "failed" | "suspended" | "halted";
+/** Reason a run transitioned to {@link RunStatus} `"halted"`. */
+type RunHaltReason = "hitl-rejected" | "hitl-timeout" | "hitl-cancelled";
 interface RunSummary {
   runId: RunId;
   workflowId: WorkflowId;
@@ -1776,6 +1908,35 @@ interface PersistedRunSchedulingState {
   pending?: PendingNodeExecution;
   queue: RunQueueEntry[];
 }
+/** One persisted suspension entry per suspended item. */
+interface PersistedSuspensionEntry {
+  /** Opaque task identifier (UUID v4). */
+  readonly taskId: string;
+  readonly nodeId: NodeId;
+  readonly activationId: NodeActivationId;
+  readonly itemIndex: number;
+  /** SHA-256 hex digest of the decision schema JSON (for schema-drift detection). */
+  readonly decisionSchemaHash: string;
+  /** Serialized return value from `SuspensionRequest.deliver` (stored on the HumanTask row). */
+  readonly deliveryRef: JsonValue;
+  /** ISO timestamp when the task expires. */
+  readonly timeoutAt: string;
+  readonly onTimeout: "halt" | "auto-accept";
+}
+/**
+ * When a node is re-activated after suspension, the engine writes the resume context here
+ * so `NodeExecutionRequestHandlerService` can splice `resumeContext` into ctx.
+ * Cleared once the re-activation is consumed.
+ */
+interface PendingResumeEntry {
+  readonly activationId: NodeActivationId;
+  readonly nodeId: NodeId;
+  /**
+   * Typed as `unknown` here to avoid a circular import between runTypes ↔ runtimeTypes.
+   * `NodeExecutionRequestHandlerService` casts this to `ResumeContext` from runtimeTypes.
+   */
+  readonly resumeContext: unknown;
+}
 interface PersistedRunState {
   runId: RunId;
   workflowId: WorkflowId;
@@ -1794,12 +1955,24 @@ interface PersistedRunState {
   /** Successful node completions so far (for activation budget). */
   engineCounters?: EngineRunCounters;
   status: RunStatus;
+  /** Populated when `status === "halted"` to discriminate why the run was halted. */
+  reason?: RunHaltReason;
   pending?: PendingNodeExecution;
   queue: RunQueueEntry[];
   outputsByNode: Record<NodeId, NodeOutputs>;
   nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
   /** Append-only history of connection invocations (LLM/tool) nested under owning nodes. */
   connectionInvocations?: ReadonlyArray<ConnectionInvocationRecord>;
+  /**
+   * One entry per outstanding HITL suspension (per-item).
+   * Present and non-empty iff `status === "suspended"`.
+   */
+  suspension?: ReadonlyArray<PersistedSuspensionEntry>;
+  /**
+   * Written by `resumeRun()` so `NodeExecutionRequestHandlerService` can splice `resumeContext`
+   * into the ctx when re-executing the suspended node. Cleared once consumed.
+   */
+  pendingResume?: PendingResumeEntry;
 }
 interface WorkflowExecutionRepository {
   createRun(args: {
@@ -1859,6 +2032,12 @@ type RunResult = {
   error: {
     message: string;
   };
+} | {
+  runId: RunId;
+  workflowId: WorkflowId;
+  startedAt: string;
+  status: "halted";
+  reason: RunHaltReason;
 };
 type WebhookRunResult = Readonly<{
   runId: RunId;
@@ -1946,207 +2125,5 @@ interface AgentMcpIntegration {
   }): Promise<AgentMcpToolMap>;
 }
 //#endregion
-//#region src/orchestration/Engine.d.ts
-interface EngineTriggerRuntime {
-  startTriggers(): Promise<void>;
-  stop(): Promise<void>;
-  syncWorkflowTriggersForActivation(workflowId: WorkflowId): Promise<void>;
-  createTriggerTestItems(args: {
-    workflow: WorkflowDefinition;
-    nodeId: NodeId;
-  }): Promise<Items | undefined>;
-}
-interface EngineRunStartService {
-  runWorkflow(wf: WorkflowDefinition, startAt: NodeId, items: Items, parent?: ParentExecutionRef, executionOptions?: RunExecutionOptions, persistedStateOverrides?: Readonly<{
-    workflowSnapshot?: NonNullable<Awaited<ReturnType<WorkflowExecutionRepository["load"]>>>["workflowSnapshot"];
-    mutableState?: NonNullable<Awaited<ReturnType<WorkflowExecutionRepository["load"]>>>["mutableState"];
-  }>): Promise<RunResult>;
-  runWorkflowFromState(request: CurrentStateExecutionRequest): Promise<RunResult>;
-}
-interface EngineRunContinuationService {
-  markNodeRunning(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    inputsByPort: NodeInputsByPort;
-  }): Promise<void>;
-  resumeFromNodeResult(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    outputs: NodeOutputs;
-  }): Promise<RunResult>;
-  resumeFromNodeError(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    error: Error;
-  }): Promise<RunResult>;
-  resumeFromStepResult(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    outputs: NodeOutputs;
-  }): Promise<RunResult>;
-  resumeFromStepError(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    error: Error;
-  }): Promise<RunResult>;
-  waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
-  }>>;
-  waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
-}
-interface EngineNodeExecutionRequestHandler {
-  handleNodeExecutionRequest(request: NodeExecutionRequest): Promise<void>;
-}
-interface EngineFacadeDeps {
-  liveWorkflowRepository: LiveWorkflowRepository;
-  tokenRegistry: PersistedWorkflowTokenRegistryLike;
-  webhookTriggerMatcher: WebhookTriggerMatcher;
-  workflowSnapshotResolver: WorkflowSnapshotResolver;
-  triggerRuntime: EngineTriggerRuntime;
-  runStartService: EngineRunStartService;
-  runContinuationService: EngineRunContinuationService;
-  nodeExecutionRequestHandler: EngineNodeExecutionRequestHandler;
-}
-/**
- * Runtime facade for orchestration, continuation, triggers, and webhook routing.
- * Prefer {@link import("../intents/RunIntentService").RunIntentService} for host/HTTP invocation boundaries.
- * The class token is exported from `@codemation/core/bootstrap` (not the main `@codemation/core` barrel).
- */
-declare class Engine implements NodeActivationContinuation, NodeExecutionRequestHandler {
-  private readonly deps;
-  constructor(deps: EngineFacadeDeps);
-  loadWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
-  getTokenRegistry(): EngineFacadeDeps["tokenRegistry"];
-  resolveWorkflowSnapshot(args: {
-    workflowId: WorkflowId;
-    workflowSnapshot?: NonNullable<Awaited<ReturnType<WorkflowExecutionRepository["load"]>>>["workflowSnapshot"];
-  }): WorkflowDefinition | undefined;
-  startTriggers(): Promise<void>;
-  syncWorkflowTriggersForActivation(workflowId: WorkflowId): Promise<void>;
-  start(workflows: WorkflowDefinition[]): Promise<void>;
-  stop(): Promise<void>;
-  resolveWebhookTrigger(args: {
-    endpointPath: string;
-    method: HttpMethod;
-  }): WebhookTriggerResolution;
-  createTriggerTestItems(args: {
-    workflow: WorkflowDefinition;
-    nodeId: NodeId;
-  }): Promise<Items | undefined>;
-  runWorkflow(wf: WorkflowDefinition, startAt: NodeId, items: Items, parent?: ParentExecutionRef, executionOptions?: RunExecutionOptions, persistedStateOverrides?: Readonly<{
-    workflowSnapshot?: NonNullable<Awaited<ReturnType<WorkflowExecutionRepository["load"]>>>["workflowSnapshot"];
-    mutableState?: NonNullable<Awaited<ReturnType<WorkflowExecutionRepository["load"]>>>["mutableState"];
-  }>): Promise<RunResult>;
-  runWorkflowFromState(request: CurrentStateExecutionRequest): Promise<RunResult>;
-  markNodeRunning(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    inputsByPort: NodeInputsByPort;
-  }): Promise<void>;
-  resumeFromNodeResult(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    outputs: NodeOutputs;
-  }): Promise<RunResult>;
-  resumeFromNodeError(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    error: Error;
-  }): Promise<RunResult>;
-  resumeFromStepResult(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    outputs: NodeOutputs;
-  }): Promise<RunResult>;
-  resumeFromStepError(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    error: Error;
-  }): Promise<RunResult>;
-  waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
-  }>>;
-  waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
-  handleNodeExecutionRequest(request: NodeExecutionRequest): Promise<void>;
-}
-//#endregion
-//#region src/runtime/InMemoryLiveWorkflowRepository.d.ts
-declare class InMemoryLiveWorkflowRepository implements LiveWorkflowRepository {
-  private readonly workflowsById;
-  setWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
-  list(): ReadonlyArray<WorkflowDefinition>;
-  get(workflowId: WorkflowId): WorkflowDefinition | undefined;
-}
-//#endregion
-//#region src/runtime/RunIntentService.d.ts
-type StartWorkflowIntent = {
-  workflow: WorkflowDefinition;
-  startAt?: string;
-  items: Items;
-  synthesizeTriggerItems?: boolean;
-  parent?: CurrentStateExecutionRequest["parent"];
-  executionOptions?: RunExecutionOptions;
-  workflowSnapshot?: CurrentStateExecutionRequest["workflowSnapshot"];
-  mutableState?: CurrentStateExecutionRequest["mutableState"];
-  currentState?: RunCurrentState;
-  stopCondition?: RunStopCondition;
-  reset?: CurrentStateExecutionRequest["reset"];
-};
-type RerunFromNodeIntent = {
-  workflow: WorkflowDefinition;
-  nodeId: NodeId;
-  currentState: RunCurrentState;
-  items?: Items;
-  synthesizeTriggerItems?: boolean;
-  parent?: CurrentStateExecutionRequest["parent"];
-  executionOptions?: RunExecutionOptions;
-  workflowSnapshot?: CurrentStateExecutionRequest["workflowSnapshot"];
-  mutableState?: CurrentStateExecutionRequest["mutableState"];
-};
-type MatchedWebhookRunIntent = {
-  endpointPath: string;
-  method: HttpMethod;
-  requestItem: Items[number];
-};
-type WebhookMatchRunIntent = {
-  match: WebhookInvocationMatch;
-  requestItem: Items[number];
-};
-declare class RunIntentService {
-  private readonly engine;
-  private readonly workflowRepository;
-  constructor(engine: Engine, workflowRepository: WorkflowRepository);
-  startWorkflow(args: StartWorkflowIntent): Promise<RunResult>;
-  rerunFromNode(args: RerunFromNodeIntent): Promise<RunResult>;
-  private resolveStartWorkflowItems;
-  private resolveRerunItems;
-  private resolveStartWorkflowTriggerNodeId;
-  private resolveRerunTriggerNodeId;
-  private firstTriggerNodeId;
-  private isTriggerNode;
-  private hasNonEmptyItems;
-  resolveWebhookTrigger(args: {
-    endpointPath: string;
-    method: HttpMethod;
-  }): WebhookTriggerResolution;
-  runMatchedWebhook(args: MatchedWebhookRunIntent): Promise<WebhookRunResult>;
-  runWebhookMatch(args: WebhookMatchRunIntent): Promise<WebhookRunResult>;
-  /**
-   * Webhook-triggered runs always force inline execution first.
-   * This is the highest-precedence scheduler override: it wins over node hints and container defaults.
-   */
-  private createWebhookExecutionOptions;
-}
-//#endregion
-export { injectAll as $, NodeExecutionRequestHandler as $n, CostTrackingComponent as $r, RunnableNodeConfig as $t, RunExecutionOptions as A, CredentialTypeId as Ai, BinaryBody as An, AllWorkflowsActiveWorkflowActivationPolicy as Ar, JsonValue as At, WorkflowExecutionListingRepository as B, OutputPortKey as Bi, ExecutionContext as Bn, TelemetryMetricRecord as Br, NodeIterationId as Bt, PersistedWorkflowSnapshot as C, CredentialRequirement as Ci, triggerNodeOutputType as Cn, HttpMethod as Cr, Item as Ct, RunCompletionNotifier as D, CredentialSetupStatus as Di, NoneRetryPolicySpec as Dn, WebhookTriggerMatcher as Dr, JsonNonArray as Dt, PinnedNodeOutputsByPort as E, CredentialSessionService as Ei, FixedRetryPolicySpec as En, WebhookInvocationMatch as Er, JsonArray as Et, RunStatus as F, PollingTriggerLogger as Fi, BinaryStorageWriteResult as Fn, TelemetryArtifactAttachment as Fr, NodeErrorHandler as Ft, Disposable as G, NodeActivationContinuation as Gn, CodemationTelemetryMetricNames as Gr, NodeSchedulerDecision as Gt, WorkflowExecutionRepository as H, WorkflowId as Hi, ItemNode as Hn, TelemetrySpanEnd as Hr, NodeOffloadPolicy as Ht, RunStopCondition as I, PollingTriggerDedupWindow as Ii, EngineDeps as In, TelemetryArtifactReference as Ir, NodeErrorHandlerArgs as It, RegistrationOptions as J, NodeActivationRequestBase as Jn, NoOpExecutionTelemetryFactory as Jr, PersistedRunPolicySnapshot as Jt, InjectionToken$1 as K, NodeActivationReceipt as Kn, GenAiTelemetryAttributeNames as Kr, PairedItemRef as Kt, RunSummary as L, InputPortKey as Li, EngineHost as Ln, TelemetryAttributePrimitive as Lr, NodeErrorHandlerSpec as Lt, RunQueueEntry as M, CredentialUnboundError as Mi, BinaryStorageReadResult as Mn, ExecutionTelemetry as Mr, NodeActivationId as Mt, RunResult as N, OAuth2ProviderFromPublicConfig as Ni, BinaryStorageStatResult as Nn, ExecutionTelemetryFactory as Nr, NodeConfigBase as Nt, RunCurrentState as O, CredentialType as Oi, RetryPolicySpec as On, WebhookTriggerResolution as Or, JsonObject as Ot, RunStateResetRequest as P, NoOpPollingTriggerLogger as Pi, BinaryStorageWriteRequest as Pn, NodeExecutionTelemetry as Pr, NodeDefinition as Pt, inject as Q, NodeExecutionRequest as Qn, NoOpTelemetryArtifactReference as Qr, RunIdFactory as Qt, RunTestContext as R, NodeConnectionName as Ri, ExecutableTriggerNode as Rn, TelemetryAttributes as Rr, NodeIdRef as Rt, PersistedRunState as S, CredentialOAuth2ScopesFromPublicConfig as Si, runnableNodeOutputType as Sn, WorkflowSnapshotResolver as Sr, ExecutionMode as St, PersistedWorkflowTokenRegistryLike as T, CredentialSessionFactoryArgs as Ti, ExponentialRetryPolicySpec as Tn, WebhookControlSignal as Tr, Items as Tt, Container as U, LiveWorkflowRepository as Un, TelemetrySpanEventRecord as Ur, NodeOutputs as Ut, WorkflowExecutionPruneRepository as V, PersistedTokenId as Vi, ExecutionContextFactory as Vn, TelemetryScope as Vr, NodeKind as Vt, DependencyContainer$1 as W, MultiInputNode as Wn, TelemetrySpanScope as Wr, NodeRef as Wt, container as X, NodeBinaryAttachmentService as Xn, NoOpNodeExecutionTelemetry as Xr, RunDataSnapshot as Xt, TypeToken as Y, NodeActivationScheduler as Yn, NoOpExecutionTelemetry as Yr, RunDataFactory as Yt, delay as Z, NodeExecutionContext as Zn, NoOpTelemetrySpanScope as Zr, RunId as Zt, PendingNodeExecution as _, CredentialInstanceId as _i, WorkflowStoragePolicyResolver as _n, WorkflowNodeInstanceFactory as _r, TestTriggerSetupContext as _t, AgentMcpToolMap as a, CostTrackingUsageRecord as ai, UpstreamRefPlaceholder as an, PollingTriggerHandle as ar, singleton as at, PersistedRunControlState as b, CredentialMaterialSourceKind as bi, nodeRef as bn, WorkflowRunnerService as br, BinaryPreviewKind as bt, ConnectionInvocationId as c, AnyCredentialType as ci, WorkflowErrorHandler as cn, RunnableNodeExecuteArgs as cr, EngineExecutionLimitsPolicy as ct, EngineRunCounters as d, CredentialBinding as di, WorkflowGraphFactory as dn, TriggerNode as dr, RunEventBus as dt, CostTrackingPriceQuote as ei, RunnableNodeInputJson as en, NodeExecutionScheduler as er, injectable as et, ExecutionFrontierPlan as f, CredentialBindingKey as fi, WorkflowNodeConnection as fn, TriggerRuntimeDiagnostics as fr, RunEventSubscription as ft, NodeInputsByPort as g, CredentialHealthTester as gi, WorkflowStoragePolicyMode as gn, TriggerTestItemsContext as gr, TestTriggerNodeConfig as gt, NodeExecutionStatus as h, CredentialHealthStatus as hi, WorkflowStoragePolicyDecisionArgs as hn, TriggerSetupStateRepository as hr, TestSuiteRunId as ht, AgentMcpIntegration as i, CostTrackingTelemetryMetricNames as ii, TriggerNodeSetupState as in, PersistedTriggerSetupState as ir, registry as it, RunPruneCandidate as j, CredentialTypeRegistry as ji, BinaryStorage as jn, WorkflowActivationPolicy as jr, MutableRunData as jt, RunEventPublisherDeps as k, CredentialTypeDefinition as ki, BinaryAttachmentCreateRequest as kn, WebhookTriggerRoutingDiagnostics as kr, JsonPrimitive as kt, ConnectionInvocationRecord as l, CredentialAdvancedSectionPresentation as li, WorkflowErrorHandlerSpec as ln, TestableTriggerNode as lr, EngineExecutionLimitsPolicyConfig as lt, NodeExecutionSnapshot as m, CredentialHealth as mi, WorkflowPrunePolicySpec as mn, TriggerSetupStateFor as mr, TestSuiteRunStatus as mt, InMemoryLiveWorkflowRepository as n, CostTrackingTelemetryAttributeNames as ni, TriggerNodeConfig as nn, NodeExecutor as nr, instancePerContainerCachingFactory as nt, NeedsReconsentEvent as o, CollectionStore as oi, WorkflowDefinition as on, PreparedNodeActivationDispatch as or, CoreTokens as ot, NodeExecutionError as p, CredentialFieldSchema as pi, WorkflowPolicyRuntimeDefaults as pn, TriggerSetupContext as pr, TestCaseRunStatus as pt, Lifecycle as q, NodeActivationRequest as qn, CodemationTelemetryAttributeNames as qr, ParentExecutionRef as qt, Engine as r, CostTrackingTelemetryFactory as ri, TriggerNodeOutputJson as rn, NodeResolver as rr, predicateAwareClassFactory as rt, ConnectionInvocationAppendArgs as s, CollectionsContext as si, WorkflowErrorContext as sn, RunnableNode as sr, ENGINE_EXECUTION_LIMITS_DEFAULTS as st, RunIntentService as t, CostTrackingTelemetry as ti, RunnableNodeOutputJson as tn, NodeExecutionStatePublisher as tr, instanceCachingFactory as tt, CurrentStateExecutionRequest as u, CredentialAuthDefinition as ui, WorkflowGraph as un, TriggerCleanupHandle as ur, RunEvent as ut, PersistedMutableNodeState as v, CredentialInstanceRecord as vi, WorkflowStoragePolicySpec as vn, WorkflowRepository as vr, ActivationIdFactory as vt, PersistedWorkflowSnapshotNode as w, CredentialSessionFactory as wi, triggerNodeSetupStateType as wn, TriggerInstanceId as wr, ItemBinary as wt, PersistedRunSchedulingState as x, CredentialOAuth2AuthDefinition as xi, runnableNodeInputType as xn, WorkflowSnapshotFactory as xr, Edge as xt, PersistedMutableRunState as y, CredentialJsonRecord as yi, branchRef as yn, WorkflowRunnerResolver as yr, BinaryAttachment as yt, WebhookRunResult as z, NodeId as zi, ExecutionBinaryService as zn, TelemetryChildSpanStart as zr, NodeInspectorSummaryRow as zt };
-//# sourceMappingURL=RunIntentService-MUHJ1bhO.d.cts.map
+export { injectAll as $, NodeActivationRequestBase as $n, GenAiTelemetryAttributeNames as $r, RunnableNodeConfig as $t, RunHaltReason as A, CredentialRequirement as Ai, BinaryBody as An, HttpMethod as Ar, JsonValue as At, WorkflowExecutionListingRepository as B, OAuth2ProviderFromPublicConfig as Bi, ExecutionBinaryService as Bn, ExecutionTelemetryFactory as Br, NodeIterationId as Bt, PersistedWorkflowSnapshotNode as C, CredentialHealthTester as Ci, triggerNodeOutputType as Cn, TriggerTestItemsContext as Cr, Item as Ct, RunCurrentState as D, CredentialMaterialSourceKind as Di, NoneRetryPolicySpec as Dn, WorkflowRunnerService as Dr, JsonNonArray as Dt, RunCompletionNotifier as E, CredentialJsonRecord as Ei, FixedRetryPolicySpec as En, WorkflowRunnerResolver as Er, JsonArray as Et, RunStatus as F, CredentialType as Fi, BinaryStorageWriteResult as Fn, WebhookTriggerResolution as Fr, NodeErrorHandler as Ft, Disposable as G, NodeConnectionName as Gi, HumanTaskId as Gn, TelemetryAttributes as Gr, NodeSchedulerDecision as Gt, WorkflowExecutionRepository as H, PollingTriggerLogger as Hi, ExecutionContextFactory as Hn, TelemetryArtifactAttachment as Hr, NodeOffloadPolicy as Ht, RunStopCondition as I, CredentialTypeDefinition as Ii, Duration as In, WebhookTriggerRoutingDiagnostics as Ir, NodeErrorHandlerArgs as It, RegistrationOptions as J, PersistedTokenId as Ji, LiveWorkflowRepository as Jn, TelemetryScope as Jr, PersistedRunPolicySnapshot as Jt, InjectionToken$1 as K, NodeId as Ki, HumanTaskSubject as Kn, TelemetryChildSpanStart as Kr, PairedItemRef as Kt, RunSummary as L, CredentialTypeId as Li, EngineDeps as Ln, AllWorkflowsActiveWorkflowActivationPolicy as Lr, NodeErrorHandlerSpec as Lt, RunQueueEntry as M, CredentialSessionFactoryArgs as Mi, BinaryStorageReadResult as Mn, WebhookControlSignal as Mr, NodeActivationId as Mt, RunResult as N, CredentialSessionService as Ni, BinaryStorageStatResult as Nn, WebhookInvocationMatch as Nr, NodeConfigBase as Nt, RunEventPublisherDeps as O, CredentialOAuth2AuthDefinition as Oi, RetryPolicySpec as On, WorkflowSnapshotFactory as Or, JsonObject as Ot, RunStateResetRequest as P, CredentialSetupStatus as Pi, BinaryStorageWriteRequest as Pn, WebhookTriggerMatcher as Pr, NodeDefinition as Pt, inject as Q, NodeActivationRequest as Qn, CodemationTelemetryMetricNames as Qr, RunIdFactory as Qt, RunTestContext as R, CredentialTypeRegistry as Ri, EngineHost as Rn, WorkflowActivationPolicy as Rr, NodeIdRef as Rt, PersistedWorkflowSnapshot as S, CredentialHealthStatus as Si, runnableNodeOutputType as Sn, TriggerSetupStateRepository as Sr, ExecutionMode as St, PinnedNodeOutputsByPort as T, CredentialInstanceRecord as Ti, ExponentialRetryPolicySpec as Tn, WorkflowRepository as Tr, Items as Tt, Container as U, PollingTriggerDedupWindow as Ui, HumanTaskActor as Un, TelemetryArtifactReference as Ur, NodeOutputs as Ut, WorkflowExecutionPruneRepository as V, NoOpPollingTriggerLogger as Vi, ExecutionContext as Vn, NodeExecutionTelemetry as Vr, NodeKind as Vt, DependencyContainer$1 as W, InputPortKey as Wi, HumanTaskHandle as Wn, TelemetryAttributePrimitive as Wr, NodeRef as Wt, container as X, NodeActivationContinuation as Xn, TelemetrySpanEventRecord as Xr, RunDataSnapshot as Xt, TypeToken as Y, WorkflowId as Yi, MultiInputNode as Yn, TelemetrySpanEnd as Yr, RunDataFactory as Yt, delay as Z, NodeActivationReceipt as Zn, TelemetrySpanScope as Zr, RunId as Zt, PersistedMutableRunState as _, CredentialAuthDefinition as _i, WorkflowStoragePolicyResolver as _n, TriggerCleanupHandle as _r, TestTriggerSetupContext as _t, ConnectionInvocationId as a, NoOpTelemetryArtifactReference as ai, UpstreamRefPlaceholder as an, NodeExecutionScheduler as ar, singleton as at, PersistedRunState as b, CredentialFieldSchema as bi, nodeRef as bn, TriggerSetupContext as br, BinaryPreviewKind as bt, EngineRunCounters as c, CostTrackingTelemetry as ci, WorkflowErrorHandler as cn, NodeResolver as cr, EngineExecutionLimitsPolicy as ct, NodeExecutionSnapshot as d, CostTrackingTelemetryMetricNames as di, WorkflowGraphFactory as dn, PreparedNodeActivationDispatch as dr, RunEventBus as dt, CodemationTelemetryAttributeNames as ei, RunnableNodeInputJson as en, NodeActivationScheduler as er, injectable as et, NodeExecutionStatus as f, CostTrackingUsageRecord as fi, WorkflowNodeConnection as fn, ResumeContext as fr, RunEventSubscription as ft, PersistedMutableNodeState as g, CredentialAdvancedSectionPresentation as gi, WorkflowStoragePolicyMode as gn, TestableTriggerNode as gr, TestTriggerNodeConfig as gt, PendingResumeEntry as h, AnyCredentialType as hi, WorkflowStoragePolicyDecisionArgs as hn, SuspensionRequest as hr, TestSuiteRunId as ht, ConnectionInvocationAppendArgs as i, NoOpTelemetrySpanScope as ii, TriggerNodeSetupState as in, NodeExecutionRequestHandler as ir, registry as it, RunPruneCandidate as j, CredentialSessionFactory as ji, BinaryStorage as jn, TriggerInstanceId as jr, MutableRunData as jt, RunExecutionOptions as k, CredentialOAuth2ScopesFromPublicConfig as ki, BinaryAttachmentCreateRequest as kn, WorkflowSnapshotResolver as kr, JsonPrimitive as kt, ExecutionFrontierPlan as l, CostTrackingTelemetryAttributeNames as li, WorkflowErrorHandlerSpec as ln, PersistedTriggerSetupState as lr, EngineExecutionLimitsPolicyConfig as lt, PendingNodeExecution as m, CollectionsContext as mi, WorkflowPrunePolicySpec as mn, RunnableNodeExecuteArgs as mr, TestSuiteRunStatus as mt, AgentMcpToolMap as n, NoOpExecutionTelemetry as ni, TriggerNodeConfig as nn, NodeExecutionContext as nr, instancePerContainerCachingFactory as nt, ConnectionInvocationRecord as o, CostTrackingComponent as oi, WorkflowDefinition as on, NodeExecutionStatePublisher as or, CoreTokens as ot, NodeInputsByPort as p, CollectionStore as pi, WorkflowPolicyRuntimeDefaults as pn, RunnableNode as pr, TestCaseRunStatus as pt, Lifecycle as q, OutputPortKey as qi, ItemNode as qn, TelemetryMetricRecord as qr, ParentExecutionRef as qt, NeedsReconsentEvent as r, NoOpNodeExecutionTelemetry as ri, TriggerNodeOutputJson as rn, NodeExecutionRequest as rr, predicateAwareClassFactory as rt, CurrentStateExecutionRequest as s, CostTrackingPriceQuote as si, WorkflowErrorContext as sn, NodeExecutor as sr, ENGINE_EXECUTION_LIMITS_DEFAULTS as st, AgentMcpIntegration as t, NoOpExecutionTelemetryFactory as ti, RunnableNodeOutputJson as tn, NodeBinaryAttachmentService as tr, instanceCachingFactory as tt, NodeExecutionError as u, CostTrackingTelemetryFactory as ui, WorkflowGraph as un, PollingTriggerHandle as ur, RunEvent as ut, PersistedRunControlState as v, CredentialBinding as vi, WorkflowStoragePolicySpec as vn, TriggerNode as vr, ActivationIdFactory as vt, PersistedWorkflowTokenRegistryLike as w, CredentialInstanceId as wi, triggerNodeSetupStateType as wn, WorkflowNodeInstanceFactory as wr, ItemBinary as wt, PersistedSuspensionEntry as x, CredentialHealth as xi, runnableNodeInputType as xn, TriggerSetupStateFor as xr, Edge as xt, PersistedRunSchedulingState as y, CredentialBindingKey as yi, branchRef as yn, TriggerRuntimeDiagnostics as yr, BinaryAttachment as yt, WebhookRunResult as z, CredentialUnboundError as zi, ExecutableTriggerNode as zn, ExecutionTelemetry as zr, NodeInspectorSummaryRow as zt };
+//# sourceMappingURL=agentMcpTypes-DUmniLOY.d.cts.map

package/dist/bootstrap/index.cjs

@@ -1,5 +1,7 @@
-const require_runtime = require('../runtime-vH0EeZzH.cjs');
-const require_bootstrap = require('../bootstrap-dVmpU1ju.cjs');
+require('../di-tO6R7VJV.cjs');
+require('../contracts-CK0x6w_G.cjs');
+const require_runtime = require('../runtime-CyW9c9XM.cjs');
+const require_bootstrap = require('../bootstrap-D460dCgS.cjs');
 
 exports.AbortControllerFactory = require_bootstrap.AbortControllerFactory;
 exports.CatalogBackedCostTrackingTelemetryFactory = require_runtime.CatalogBackedCostTrackingTelemetryFactory;

package/dist/bootstrap/index.d.cts

@@ -1,6 +1,8 @@
-import { A as RunExecutionOptions, B as WorkflowExecutionListingRepository, Cr as HttpMethod, Dr as WebhookTriggerMatcher, Er as WebhookInvocationMatch, Ft as NodeErrorHandler, Gn as NodeActivationContinuation, Gt as NodeSchedulerDecision, H as WorkflowExecutionRepository, Hi as WorkflowId, Ht as NodeOffloadPolicy, In as EngineDeps, Jt as PersistedRunPolicySnapshot, L as RunSummary, Lt as NodeErrorHandlerSpec, Mr as ExecutionTelemetry, N as RunResult, Nt as NodeConfigBase, Pt as NodeDefinition, Qn as NodeExecutionRequest, S as PersistedRunState, St as ExecutionMode, Tt as Items, Ut as NodeOutputs, V as WorkflowExecutionPruneRepository, Vi as PersistedTokenId, W as DependencyContainer, Y as TypeToken, Yn as NodeActivationScheduler, Zt as RunId, _r as WorkflowNodeInstanceFactory, ai as CostTrackingUsageRecord, cn as WorkflowErrorHandler, ct as EngineExecutionLimitsPolicy, d as EngineRunCounters, dt as RunEventBus, er as NodeExecutionScheduler, hn as WorkflowStoragePolicyDecisionArgs, ht as TestSuiteRunId, j as RunPruneCandidate, jr as WorkflowActivationPolicy, kr as WebhookTriggerRoutingDiagnostics, ln as WorkflowErrorHandlerSpec, lt as EngineExecutionLimitsPolicyConfig, mt as TestSuiteRunStatus, n as InMemoryLiveWorkflowRepository, on as WorkflowDefinition, or as PreparedNodeActivationDispatch, pn as WorkflowPolicyRuntimeDefaults, pt as TestCaseRunStatus, qn as NodeActivationRequest, qt as ParentExecutionRef, r as Engine, ri as CostTrackingTelemetryFactory, rr as NodeResolver, st as ENGINE_EXECUTION_LIMITS_DEFAULTS, t as RunIntentService, ti as CostTrackingTelemetry, vr as WorkflowRepository, w as PersistedWorkflowSnapshotNode, x as PersistedRunSchedulingState, zi as NodeId } from "../RunIntentService-MUHJ1bhO.cjs";
-import { a as ItemExprResolver, c as DefaultAsyncSleeper, d as UnavailableBinaryStorage, f as CredentialResolverFactory, i as RunnableOutputBehaviorResolver, l as AsyncSleeper, m as CostCatalogEntry, n as InMemoryBinaryStorage, o as InProcessRetryRunner, p as CostCatalog, s as DefaultExecutionContextFactory, t as InMemoryRunDataFactory, u as DefaultExecutionBinaryService } from "../InMemoryRunDataFactory-hmkh0lzR.cjs";
-import { a as WorkflowSnapshotCodec, i as EngineWorkflowRunnerService, n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-MPYWsEM0.cjs";
+import { Ar as HttpMethod, B as WorkflowExecutionListingRepository, C as PersistedWorkflowSnapshotNode, Ft as NodeErrorHandler, Gt as NodeSchedulerDecision, H as WorkflowExecutionRepository, Ht as NodeOffloadPolicy, Ir as WebhookTriggerRoutingDiagnostics, Ji as PersistedTokenId, Jr as TelemetryScope, Jt as PersistedRunPolicySnapshot, Ki as NodeId, L as RunSummary, Ln as EngineDeps, Lt as NodeErrorHandlerSpec, Mt as NodeActivationId, N as RunResult, Nr as WebhookInvocationMatch, Nt as NodeConfigBase, Pr as WebhookTriggerMatcher, Pt as NodeDefinition, Qn as NodeActivationRequest, Rr as WorkflowActivationPolicy, St as ExecutionMode, Tr as WorkflowRepository, Tt as Items, Ut as NodeOutputs, V as WorkflowExecutionPruneRepository, W as DependencyContainer, Xn as NodeActivationContinuation, Y as TypeToken, Yi as WorkflowId, Zt as RunId, ar as NodeExecutionScheduler, b as PersistedRunState, c as EngineRunCounters, ci as CostTrackingTelemetry, cn as WorkflowErrorHandler, cr as NodeResolver, ct as EngineExecutionLimitsPolicy, dr as PreparedNodeActivationDispatch, dt as RunEventBus, er as NodeActivationScheduler, fi as CostTrackingUsageRecord, hn as WorkflowStoragePolicyDecisionArgs, hr as SuspensionRequest, ht as TestSuiteRunId, j as RunPruneCandidate, k as RunExecutionOptions, ln as WorkflowErrorHandlerSpec, lt as EngineExecutionLimitsPolicyConfig, mt as TestSuiteRunStatus, on as WorkflowDefinition, pn as WorkflowPolicyRuntimeDefaults, pt as TestCaseRunStatus, qt as ParentExecutionRef, rr as NodeExecutionRequest, st as ENGINE_EXECUTION_LIMITS_DEFAULTS, ui as CostTrackingTelemetryFactory, wr as WorkflowNodeInstanceFactory, y as PersistedRunSchedulingState, zr as ExecutionTelemetry } from "../agentMcpTypes-DUmniLOY.cjs";
+import { n as CostCatalogEntry, t as CostCatalog } from "../CostCatalogContract-DD7fQ4FF.cjs";
+import { n as InMemoryLiveWorkflowRepository, r as Engine, t as RunIntentService } from "../RunIntentService-CWMMrAP4.cjs";
+import { a as ItemExprResolver, c as DefaultAsyncSleeper, d as UnavailableBinaryStorage, f as HitlResumeTokenSignerSeam, i as RunnableOutputBehaviorResolver, l as AsyncSleeper, m as HitlTimeoutJobSchedulerSeam, n as InMemoryBinaryStorage, o as InProcessRetryRunner, s as DefaultExecutionContextFactory, t as InMemoryRunDataFactory, u as DefaultExecutionBinaryService, x as CredentialResolverFactory, y as HumanTaskStore } from "../InMemoryRunDataFactory-qMiYjhCK.cjs";
+import { a as WorkflowSnapshotCodec, i as EngineWorkflowRunnerService, n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-DTV5_7Jw.cjs";
 
 //#region src/orchestration/AbortControllerFactory.d.ts
 /**
@@ -49,15 +51,71 @@ declare class CatalogBackedCostTrackingTelemetryFactory implements CostTrackingT
   }>): CostTrackingTelemetry;
 }
 //#endregion
+//#region src/execution/NodeSuspensionHandler.d.ts
+/**
+ * Handles per-item `SuspensionRequest` catches in the engine's item execution loop.
+ *
+ * Responsibilities:
+ * 1. Generate a `taskId` (UUID v4).
+ * 2. Persist a `HumanTask` row via `HumanTaskStore.create`.
+ * 3. Sign a resume URL via `HitlResumeTokenSigner.sign`.
+ * 4. Enqueue a delayed BullMQ timeout job via `HitlTimeoutJobScheduler.enqueue`.
+ * 5. Build a `HumanTaskHandle` and call `deliver`.
+ * 6. Append a `PersistedSuspensionEntry` to the run state and flip status to `"suspended"`.
+ * 7. Persist via `WorkflowExecutionRepository.save`.
+ * 8. Throw `RunSuspendedError` so the caller can exit cleanly.
+ *
+ * If `deliver` throws, the error propagates up to `NodeExecutionRequestHandlerService`
+ * which routes it through `resumeFromNodeError` → run status becomes `"failed"`.
+ *
+ * `humanTaskStore`, `tokenSigner`, and `timeoutScheduler` are optional —
+ * when not registered (e.g. in unit tests), the handler still suspends the run but
+ * skips persistence, token signing, and job scheduling.
+ */
+declare class NodeSuspensionHandler {
+  private readonly workflowExecutionRepository;
+  private readonly humanTaskStore?;
+  private readonly tokenSigner?;
+  private readonly timeoutScheduler?;
+  /** Workspace ID to stamp on HumanTaskRecord in managed mode (T7 security fix). Null in non-managed mode. */
+  private readonly workspaceId?;
+  constructor(workflowExecutionRepository: WorkflowExecutionRepository, humanTaskStore?: HumanTaskStore | undefined, tokenSigner?: HitlResumeTokenSignerSeam | undefined, timeoutScheduler?: HitlTimeoutJobSchedulerSeam | undefined, /** Workspace ID to stamp on HumanTaskRecord in managed mode (T7 security fix). Null in non-managed mode. */
+  workspaceId?: string | undefined);
+  handle(args: {
+    runId: RunId;
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+    itemIndex: number;
+    suspensionRequest: SuspensionRequest;
+    state: PersistedRunState;
+    /** Telemetry scope of the node's per-item span. Used to emit `hitl.task.*` span events. */
+    telemetry?: TelemetryScope;
+  }): Promise<never>;
+  /**
+   * Parse a duration string into milliseconds.
+   * Accepts ISO 8601 durations ("PT24H", "PT30M") and shorthand ("24h", "30m", "1d").
+   * Throws for unrecognised formats.
+   */
+  private parseDurationMs;
+  private hashSchema;
+  private schemaToJson;
+}
+//#endregion
 //#region src/execution/NodeExecutor.d.ts
 declare class NodeExecutor {
   private readonly nodeInstanceFactory;
   private readonly retryRunner;
+  /** Required for HITL suspension support. When omitted, `SuspensionRequest` throws upward. */
+  private readonly suspensionHandler?;
+  /** Required alongside `suspensionHandler`. */
+  private readonly loadRunState?;
   private readonly fanInMerger;
   private readonly outputNormalizer;
   private readonly itemExprResolver;
   private readonly outputBehaviorResolver;
-  constructor(nodeInstanceFactory: WorkflowNodeInstanceFactory, retryRunner: InProcessRetryRunner, itemExprResolver?: ItemExprResolver, outputBehaviorResolver?: RunnableOutputBehaviorResolver);
+  constructor(nodeInstanceFactory: WorkflowNodeInstanceFactory, retryRunner: InProcessRetryRunner, itemExprResolver?: ItemExprResolver, outputBehaviorResolver?: RunnableOutputBehaviorResolver, /** Required for HITL suspension support. When omitted, `SuspensionRequest` throws upward. */
+  suspensionHandler?: NodeSuspensionHandler | undefined, /** Required alongside `suspensionHandler`. */
+  loadRunState?: ((runId: RunId) => Promise<PersistedRunState | undefined>) | undefined);
   execute(request: NodeActivationRequest): Promise<NodeOutputs>;
   private assertRequiredCredentialsBound;
   private isCredentialError;
@@ -275,7 +333,7 @@ declare class TestSuiteRunIdFactory {
 interface TestSuiteOrchestratorEngine {
   runWorkflow(wf: WorkflowDefinition, startAt: NodeId, items: Items, parent?: ParentExecutionRef, executionOptions?: RunExecutionOptions): Promise<RunResult>;
   waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
+    status: "completed" | "failed" | "halted";
   }>>;
 }
 interface TestSuiteCaseOutcome {

package/dist/bootstrap/index.d.ts

@@ -1,9 +1,10 @@
-import { Ar as WorkflowDefinition, Mn as EngineExecutionLimitsPolicy, Nn as EngineExecutionLimitsPolicyConfig, a as RunPolicySnapshotFactory, c as RunTerminalPersistenceCoordinator, do as PersistedTokenId, jn as ENGINE_EXECUTION_LIMITS_DEFAULTS, l as WorkflowStoragePolicyEvaluator, mn as DependencyContainer, n as InMemoryLiveWorkflowRepository, o as EngineExecutionLimitsPolicyFactory, r as EngineWorkflowRunnerService, s as WorkflowPolicyErrorServices, t as RunIntentService, u as Engine, yn as TypeToken } from "../RunIntentService-BrEq6Jm6.js";
-import { A as ConfigDrivenOffloadPolicy, B as DefaultAsyncSleeper, C as InMemoryWorkflowExecutionRepository, D as HintOnlyOffloadPolicy, E as LocalOnlyScheduler, Fn as CredentialResolverFactory, In as AbortControllerFactory, L as InProcessRetryRunner, M as NodeInstanceFactory, N as NodeExecutor, O as DefaultDrivingScheduler, R as CatalogBackedCostTrackingTelemetryFactory, S as RunSummaryMapper, T as InMemoryBinaryStorage, U as DefaultExecutionBinaryService, V as AsyncSleeper, W as UnavailableBinaryStorage, a as TestSuiteRunResult, b as EngineCompositionDeps, i as TestSuiteOrchestratorEngine, j as StaticCostCatalog, k as InlineDrivingScheduler, n as TestSuiteCaseOutcome, o as TestSuiteRunIdFactory, r as TestSuiteOrchestrator, t as RunTestSuiteArgs, w as InMemoryRunDataFactory, x as EngineFactory, y as WorkflowRepositoryWebhookTriggerMatcher, z as DefaultExecutionContextFactory } from "../index-Bes88mxT.js";
-import { n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-BZ_1XWAJ.js";
+import { Bn as ENGINE_EXECUTION_LIMITS_DEFAULTS, Cn as DependencyContainer, Do as PersistedTokenId, Hn as EngineExecutionLimitsPolicyConfig, On as TypeToken, Vn as EngineExecutionLimitsPolicy, zr as WorkflowDefinition } from "../index-CSKKuK60.js";
+import { a as RunPolicySnapshotFactory, c as RunTerminalPersistenceCoordinator, l as WorkflowStoragePolicyEvaluator, n as InMemoryLiveWorkflowRepository, o as EngineExecutionLimitsPolicyFactory, r as EngineWorkflowRunnerService, s as WorkflowPolicyErrorServices, t as RunIntentService, u as Engine } from "../RunIntentService-BOSGwmqn.js";
+import { A as InMemoryWorkflowExecutionRepository, B as NodeExecutor, D as EngineCompositionDeps, E as WorkflowRepositoryWebhookTriggerMatcher, F as DefaultDrivingScheduler, G as CatalogBackedCostTrackingTelemetryFactory, I as InlineDrivingScheduler, J as AsyncSleeper, K as DefaultExecutionContextFactory, L as ConfigDrivenOffloadPolicy, M as InMemoryBinaryStorage, N as LocalOnlyScheduler, O as EngineFactory, P as HintOnlyOffloadPolicy, R as StaticCostCatalog, W as InProcessRetryRunner, X as DefaultExecutionBinaryService, Z as UnavailableBinaryStorage, a as TestSuiteRunResult, en as CredentialResolverFactory, i as TestSuiteOrchestratorEngine, j as InMemoryRunDataFactory, k as RunSummaryMapper, n as TestSuiteCaseOutcome, o as TestSuiteRunIdFactory, q as DefaultAsyncSleeper, r as TestSuiteOrchestrator, t as RunTestSuiteArgs, tn as AbortControllerFactory, z as NodeInstanceFactory } from "../index-BZDhEQ6W.js";
+import "../ItemsInputNormalizer-C09a7iFP.js";
+import { n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-Dl92Hdoi.js";
 
 //#region src/bootstrap/runtime/EngineRuntimeRegistrar.d.ts
-
 /**
  * Container-first entry: call on a host/test container **after** workflow, run, node, and credential
  * ports are registered. The registrar owns the default inline scheduler, engine binding,

package/dist/bootstrap/index.js

@@ -1,4 +1,6 @@
-import { A as PersistedWorkflowTokenRegistry, B as DefaultExecutionContextFactory, C as DefaultDrivingScheduler, E as StaticCostCatalog, N as NodeExecutor, O as NodeInstanceFactory, R as InProcessRetryRunner, S as HintOnlyOffloadPolicy, T as RunPolicySnapshotFactory, _ as RunTerminalPersistenceCoordinator, a as InMemoryLiveWorkflowRepository, b as LocalOnlyScheduler, c as EngineFactory, dt as DefaultAsyncSleeper, ft as CredentialResolverFactory, g as WorkflowPolicyErrorServices, gt as UnavailableBinaryStorage, h as WorkflowStoragePolicyEvaluator, ht as DefaultExecutionBinaryService, i as RunIntentService, j as MissingRuntimeTriggerToken, l as Engine, m as InMemoryBinaryStorage, n as WorkflowRepositoryWebhookTriggerMatcher, p as InMemoryRunDataFactory, s as EngineWorkflowRunnerService, v as ENGINE_EXECUTION_LIMITS_DEFAULTS, w as ConfigDrivenOffloadPolicy, x as InlineDrivingScheduler, y as EngineExecutionLimitsPolicy, z as CatalogBackedCostTrackingTelemetryFactory } from "../runtime-Duf3ClPw.js";
-import { a as InMemoryWorkflowExecutionRepository, i as AbortControllerFactory, n as TestSuiteRunIdFactory, o as RunSummaryMapper, r as TestSuiteOrchestrator, s as EngineExecutionLimitsPolicyFactory, t as EngineRuntimeRegistrar } from "../bootstrap-Dgzsjoj7.js";
+import "../di-DdsgWfVy.js";
+import "../contracts-DXdfTdpW.js";
+import { A as PersistedWorkflowTokenRegistry, B as CatalogBackedCostTrackingTelemetryFactory, C as DefaultDrivingScheduler, E as StaticCostCatalog, N as NodeExecutor, O as NodeInstanceFactory, S as HintOnlyOffloadPolicy, T as RunPolicySnapshotFactory, V as DefaultExecutionContextFactory, _ as RunTerminalPersistenceCoordinator, a as InMemoryLiveWorkflowRepository, b as LocalOnlyScheduler, c as EngineFactory, ct as CredentialResolverFactory, dt as DefaultExecutionBinaryService, ft as UnavailableBinaryStorage, g as WorkflowPolicyErrorServices, h as WorkflowStoragePolicyEvaluator, i as RunIntentService, j as MissingRuntimeTriggerToken, l as Engine, m as InMemoryBinaryStorage, n as WorkflowRepositoryWebhookTriggerMatcher, p as InMemoryRunDataFactory, s as EngineWorkflowRunnerService, st as DefaultAsyncSleeper, v as ENGINE_EXECUTION_LIMITS_DEFAULTS, w as ConfigDrivenOffloadPolicy, x as InlineDrivingScheduler, y as EngineExecutionLimitsPolicy, z as InProcessRetryRunner } from "../runtime-BPZgnZ9G.js";
+import { a as InMemoryWorkflowExecutionRepository, i as AbortControllerFactory, n as TestSuiteRunIdFactory, o as RunSummaryMapper, r as TestSuiteOrchestrator, s as EngineExecutionLimitsPolicyFactory, t as EngineRuntimeRegistrar } from "../bootstrap-CKTMMNmL.js";
 
 export { AbortControllerFactory, CatalogBackedCostTrackingTelemetryFactory, ConfigDrivenOffloadPolicy, CredentialResolverFactory, DefaultAsyncSleeper, DefaultDrivingScheduler, DefaultExecutionBinaryService, DefaultExecutionContextFactory, ENGINE_EXECUTION_LIMITS_DEFAULTS, Engine, EngineExecutionLimitsPolicy, EngineExecutionLimitsPolicyFactory, EngineFactory, EngineRuntimeRegistrar, EngineWorkflowRunnerService, HintOnlyOffloadPolicy, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryWorkflowExecutionRepository, InProcessRetryRunner, InlineDrivingScheduler, LocalOnlyScheduler, MissingRuntimeTriggerToken, NodeExecutor, NodeInstanceFactory, PersistedWorkflowTokenRegistry, RunIntentService, RunPolicySnapshotFactory, RunSummaryMapper, RunTerminalPersistenceCoordinator, StaticCostCatalog, TestSuiteOrchestrator, TestSuiteRunIdFactory, UnavailableBinaryStorage, WorkflowPolicyErrorServices, WorkflowRepositoryWebhookTriggerMatcher, WorkflowStoragePolicyEvaluator };