@codemation/core 0.11.1 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @codemation/core
 
+## 0.12.0
+
+### Minor Changes
+
+- [#167](https://github.com/MadeRelevant/codemation/pull/167) [`3044474`](https://github.com/MadeRelevant/codemation/commit/3044474495525490735510ff74500b53761284b6) Thanks [@cblokland90](https://github.com/cblokland90)! - feat(hitl): Human-in-the-Loop — engine suspend/resume, inbox approval node + channels (local + control-plane), agent-as-tool, decision/timeout handling, inbox decision UX (toast + node status icons + "waiting for approval"), plus the consolidated dev/canvas/host fixes shipped alongside.
+
 ## 0.11.1
 
 ### Patch Changes

package/dist/{CostCatalogContract-DZgcUBE4.d.cts → CostCatalogContract-DD7fQ4FF.d.cts}

@@ -1,4 +1,4 @@
-import { ni as CostTrackingUsageRecord } from "./agentMcpTypes-ZiNbNsEi.cjs";
+import { fi as CostTrackingUsageRecord } from "./agentMcpTypes-DUmniLOY.cjs";
 
 //#region src/contracts/CostCatalogContract.d.ts
 interface CostCatalogEntry {
@@ -16,4 +16,4 @@ interface CostCatalog {
 }
 //#endregion
 export { CostCatalogEntry as n, CostCatalog as t };
-//# sourceMappingURL=CostCatalogContract-DZgcUBE4.d.cts.map
+//# sourceMappingURL=CostCatalogContract-DD7fQ4FF.d.cts.map

package/dist/{EngineRuntimeRegistration.types-Cggm5GVY.d.cts → EngineRuntimeRegistration.types-DTV5_7Jw.d.cts}

@@ -1,5 +1,5 @@
-import { A as RunResult, At as NodeConfigBase, Er as WebhookTriggerRoutingDiagnostics, Ii as NodeId, S as PersistedWorkflowTokenRegistryLike, St as Items, V as DependencyContainer, Wt as ParentExecutionRef, b as PersistedWorkflowSnapshot, hr as WorkflowRepository, lr as TriggerRuntimeDiagnostics, ot as EngineExecutionLimitsPolicyConfig, rn as WorkflowDefinition, un as WorkflowPolicyRuntimeDefaults, wr as WebhookTriggerMatcher, x as PersistedWorkflowSnapshotNode, zi as WorkflowId } from "./agentMcpTypes-ZiNbNsEi.cjs";
-import { r as Engine } from "./RunIntentService-CEF-sFfI.cjs";
+import { C as PersistedWorkflowSnapshotNode, Ir as WebhookTriggerRoutingDiagnostics, Ki as NodeId, N as RunResult, Nt as NodeConfigBase, Pr as WebhookTriggerMatcher, S as PersistedWorkflowSnapshot, Tr as WorkflowRepository, Tt as Items, W as DependencyContainer, Yi as WorkflowId, lt as EngineExecutionLimitsPolicyConfig, on as WorkflowDefinition, pn as WorkflowPolicyRuntimeDefaults, qt as ParentExecutionRef, w as PersistedWorkflowTokenRegistryLike, yr as TriggerRuntimeDiagnostics } from "./agentMcpTypes-DUmniLOY.cjs";
+import { r as Engine } from "./RunIntentService-CWMMrAP4.cjs";
 
 //#region src/workflowSnapshots/WorkflowSnapshotCodec.d.ts
 declare class WorkflowSnapshotCodec {
@@ -78,4 +78,4 @@ interface EngineRuntimeRegistrationOptions {
 }
 //#endregion
 export { WorkflowSnapshotCodec as a, EngineWorkflowRunnerService as i, TriggerRuntimeDiagnosticsProvider as n, WebhookTriggerMatcherProvider as r, EngineRuntimeRegistrationOptions as t };
-//# sourceMappingURL=EngineRuntimeRegistration.types-Cggm5GVY.d.cts.map
+//# sourceMappingURL=EngineRuntimeRegistration.types-DTV5_7Jw.d.cts.map

package/dist/{EngineRuntimeRegistration.types-BQbS9_gs.d.ts → EngineRuntimeRegistration.types-Dl92Hdoi.d.ts}

@@ -1,4 +1,4 @@
-import { Cn as EngineExecutionLimitsPolicyConfig, Dr as WorkflowPolicyRuntimeDefaults, Ei as TriggerRuntimeDiagnostics, Ui as WebhookTriggerRoutingDiagnostics, Vi as WebhookTriggerMatcher, in as DependencyContainer } from "./index-zWGtEhrf.js";
+import { Cn as DependencyContainer, Hn as EngineExecutionLimitsPolicyConfig, Kr as WorkflowPolicyRuntimeDefaults, Qi as TriggerRuntimeDiagnostics, ha as WebhookTriggerRoutingDiagnostics, pa as WebhookTriggerMatcher } from "./index-CSKKuK60.js";
 
 //#region src/bootstrap/runtime/EngineRuntimeRegistration.types.d.ts
 
@@ -41,4 +41,4 @@ interface EngineRuntimeRegistrationOptions {
 }
 //#endregion
 export { TriggerRuntimeDiagnosticsProvider as n, WebhookTriggerMatcherProvider as r, EngineRuntimeRegistrationOptions as t };
-//# sourceMappingURL=EngineRuntimeRegistration.types-BQbS9_gs.d.ts.map
+//# sourceMappingURL=EngineRuntimeRegistration.types-Dl92Hdoi.d.ts.map

package/dist/InMemoryRunDataFactory-qMiYjhCK.d.cts

@@ -0,0 +1,202 @@
+import { $t as RunnableNodeConfig, An as BinaryBody, At as JsonValue, Bn as ExecutionBinaryService, Br as ExecutionTelemetryFactory, Ct as Item, Fn as BinaryStorageWriteResult, Hn as ExecutionContextFactory, Jt as PersistedRunPolicySnapshot, Ki as NodeId, Kn as HumanTaskSubject, Mn as BinaryStorageReadResult, Mt as NodeActivationId, Ni as CredentialSessionService, Nn as BinaryStorageStatResult, On as RetryPolicySpec, R as RunTestContext, Un as HumanTaskActor, Ut as NodeOutputs, Vn as ExecutionContext, Xt as RunDataSnapshot, Y as TypeToken, Yi as WorkflowId, Yt as RunDataFactory, Zt as RunId, cr as NodeResolver, jn as BinaryStorage, jt as MutableRunData, mi as CollectionsContext, nr as NodeExecutionContext, or as NodeExecutionStatePublisher, qt as ParentExecutionRef, tr as NodeBinaryAttachmentService, ui as CostTrackingTelemetryFactory, yt as BinaryAttachment } from "./agentMcpTypes-DUmniLOY.cjs";
+
+//#region src/execution/CredentialResolverFactory.d.ts
+declare class CredentialResolverFactory {
+  private readonly credentialSessions;
+  constructor(credentialSessions: CredentialSessionService);
+  create(workflowId: WorkflowId, nodeId: NodeId, config?: NodeExecutionContext["config"]): NodeExecutionContext["getCredential"];
+}
+//#endregion
+//#region src/contracts/humanTaskStoreTypes.d.ts
+type HumanTaskStatus = "pending" | "decided" | "timed_out" | "auto_accepted" | "cancelled";
+/** Persisted record for a single HITL task instance. */
+interface HumanTaskRecord {
+  readonly id: string;
+  readonly runId: string;
+  readonly workflowId: string;
+  readonly workspaceId?: string;
+  readonly nodeId: string;
+  readonly activationId: string;
+  readonly itemIndex: number;
+  readonly status: HumanTaskStatus;
+  readonly channel: string;
+  readonly subject: HumanTaskSubject;
+  readonly metadata: Record<string, JsonValue>;
+  readonly decisionSchemaJson: string;
+  readonly decisionSchemaHash: string;
+  readonly onTimeout: "halt" | "auto-accept";
+  readonly deliveryRef?: JsonValue;
+  readonly decision?: JsonValue;
+  readonly decidedAt?: Date;
+  readonly decidedBy?: HumanTaskActor;
+  readonly resumeTokenHash: string;
+  readonly expiresAt: Date;
+  readonly createdAt: Date;
+}
+interface HumanTaskStore {
+  create(record: HumanTaskRecord): Promise<void>;
+  findById(taskId: string): Promise<HumanTaskRecord | undefined>;
+  findByResumeTokenHash(tokenHash: string): Promise<HumanTaskRecord | undefined>;
+  findPendingForWorkspace(workspaceId: string): Promise<ReadonlyArray<HumanTaskRecord>>;
+  /** Returns all pending tasks regardless of workspace. Used by the local dev inbox (non-managed mode). */
+  findAllPending(): Promise<ReadonlyArray<HumanTaskRecord>>;
+  markDecided(args: {
+    taskId: string;
+    decision: JsonValue;
+    decidedBy: HumanTaskActor;
+    decidedAt: Date;
+  }): Promise<void>;
+  markTimedOut(taskId: string): Promise<void>;
+  markAutoAccepted(taskId: string): Promise<void>;
+  markCancelled(taskId: string): Promise<void>;
+  cancelPendingForRun(runId: string): Promise<void>;
+}
+declare const HumanTaskStoreToken: TypeToken<HumanTaskStore | undefined>;
+//#endregion
+//#region src/contracts/hitlSeamTypes.d.ts
+/**
+ * Seam interfaces for HITL collaborators that are implemented in `@codemation/host`
+ * and injected into `NodeSuspensionHandler` at runtime. Core defines the interface only —
+ * no HTTP, vendor SDK, or Prisma dependencies here.
+ */
+/** Signs and hashes a HITL resume token. Core only needs the sign and hash operations. */
+interface HitlResumeTokenSignerSeam {
+  sign(args: {
+    taskId: string;
+    expiresAt: Date;
+    schemaHash: string;
+  }): string;
+  hashToken(token: string): string;
+}
+/** Schedules a delayed BullMQ job that drives the timeout path. */
+interface HitlTimeoutJobSchedulerSeam {
+  enqueueTimeoutJob(args: {
+    taskId: string;
+    expiresAt: Date;
+  }): Promise<void>;
+}
+declare const HitlResumeTokenSignerToken: TypeToken<HitlResumeTokenSignerSeam | undefined>;
+declare const HitlTimeoutJobSchedulerToken: TypeToken<HitlTimeoutJobSchedulerSeam | undefined>;
+/**
+ * Optional workspace ID injected into NodeSuspensionHandler in managed mode (T7 security fix).
+ * Allows the handler to stamp the workspaceId on each HumanTaskRecord so HitlCallbackHandler
+ * can assert workspace identity independently of the HMAC middleware.
+ * Not registered in non-managed mode; NodeSuspensionHandler defaults to null.
+ */
+declare const HitlWorkspaceIdToken: TypeToken<string | undefined>;
+//#endregion
+//#region src/binaries/UnavailableBinaryStorage.d.ts
+declare class UnavailableBinaryStorage implements BinaryStorage {
+  readonly driverName = "unavailable";
+  write(): Promise<never>;
+  openReadStream(): Promise<undefined>;
+  stat(): Promise<{
+    exists: false;
+  }>;
+  delete(): Promise<void>;
+  deleteMany(): Promise<void>;
+  listByPrefix(): Promise<ReadonlyArray<string>>;
+}
+//#endregion
+//#region src/binaries/DefaultExecutionBinaryServiceFactory.d.ts
+declare class DefaultExecutionBinaryService implements ExecutionBinaryService {
+  private readonly storage;
+  private readonly workflowId;
+  private readonly runId;
+  private readonly now;
+  constructor(storage: BinaryStorage, workflowId: WorkflowId, runId: RunId, now: () => Date);
+  forNode(args: {
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+  }): NodeBinaryAttachmentService;
+  openReadStream(attachment: BinaryAttachment): Promise<BinaryStorageReadResult | undefined>;
+}
+//#endregion
+//#region src/execution/asyncSleeper.types.d.ts
+interface AsyncSleeper {
+  sleep(ms: number): Promise<void>;
+}
+//#endregion
+//#region src/execution/DefaultAsyncSleeper.d.ts
+declare class DefaultAsyncSleeper implements AsyncSleeper {
+  sleep(ms: number): Promise<void>;
+}
+//#endregion
+//#region src/execution/DefaultExecutionContextFactory.d.ts
+declare class DefaultExecutionContextFactory implements ExecutionContextFactory {
+  private readonly binaryStorage;
+  private readonly telemetryFactory;
+  private readonly costTrackingFactory;
+  private readonly currentDate;
+  private readonly collections?;
+  private readonly nodeResolver?;
+  private readonly telemetryDecoratorFactory;
+  constructor(binaryStorage?: BinaryStorage, telemetryFactory?: ExecutionTelemetryFactory, costTrackingFactory?: CostTrackingTelemetryFactory, currentDate?: () => Date, collections?: CollectionsContext | undefined, nodeResolver?: NodeResolver | undefined);
+  create(args: {
+    runId: RunId;
+    workflowId: WorkflowId;
+    parent?: ParentExecutionRef;
+    policySnapshot?: PersistedRunPolicySnapshot;
+    subworkflowDepth: number;
+    engineMaxNodeActivations: number;
+    engineMaxSubworkflowDepth: number;
+    data: RunDataSnapshot;
+    nodeState?: NodeExecutionStatePublisher;
+    telemetry?: ExecutionContext["telemetry"];
+    getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
+    testContext?: RunTestContext;
+  }): ExecutionContext;
+}
+//#endregion
+//#region src/execution/InProcessRetryRunner.d.ts
+declare class InProcessRetryRunner {
+  private readonly sleeper;
+  constructor(sleeper: AsyncSleeper);
+  run<T>(policy: RetryPolicySpec | undefined, work: () => Promise<T>, shouldRetry?: (error: unknown) => boolean, warn?: (message: string) => void): Promise<T>;
+  private static delayAfterFailureMs;
+  private static normalizePolicy;
+  private static clampMaxAttempts;
+  private static assertPositiveInt;
+  private static assertNonNegativeFinite;
+  private static assertMultiplier;
+}
+//#endregion
+//#region src/execution/ItemExprResolver.d.ts
+/**
+ * Resolves {@link import("../contracts/itemExpr").ItemExpr} leaves on runnable config before {@link RunnableNode.execute}.
+ */
+declare class ItemExprResolver {
+  resolveConfigForItem<TConfig extends RunnableNodeConfig<any, any>>(ctx: NodeExecutionContext<TConfig>, item: Item, itemIndex: number, items: ReadonlyArray<Item>): Promise<NodeExecutionContext<TConfig>>;
+}
+//#endregion
+//#region src/execution/RunnableOutputBehaviorResolver.d.ts
+type RunnableOutputBehavior = Readonly<{
+  keepBinaries: boolean;
+}>;
+declare class RunnableOutputBehaviorResolver {
+  resolve(config: RunnableNodeConfig): RunnableOutputBehavior;
+  private isKeepBinariesEnabled;
+}
+//#endregion
+//#region src/runStorage/InMemoryBinaryStorageRegistry.d.ts
+declare class InMemoryBinaryStorage implements BinaryStorage {
+  readonly driverName = "memory";
+  private readonly values;
+  write(args: {
+    storageKey: string;
+    body: BinaryBody;
+  }): Promise<BinaryStorageWriteResult>;
+  openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
+  stat(storageKey: string): Promise<BinaryStorageStatResult>;
+  delete(storageKey: string): Promise<void>;
+  deleteMany(storageKeys: ReadonlyArray<string>): Promise<void>;
+  listByPrefix(prefix: string): Promise<ReadonlyArray<string>>;
+}
+//#endregion
+//#region src/runStorage/InMemoryRunDataFactory.d.ts
+declare class InMemoryRunDataFactory implements RunDataFactory {
+  create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;
+}
+//#endregion
+export { HumanTaskRecord as _, ItemExprResolver as a, HumanTaskStoreToken as b, DefaultAsyncSleeper as c, UnavailableBinaryStorage as d, HitlResumeTokenSignerSeam as f, HitlWorkspaceIdToken as g, HitlTimeoutJobSchedulerToken as h, RunnableOutputBehaviorResolver as i, AsyncSleeper as l, HitlTimeoutJobSchedulerSeam as m, InMemoryBinaryStorage as n, InProcessRetryRunner as o, HitlResumeTokenSignerToken as p, RunnableOutputBehavior as r, DefaultExecutionContextFactory as s, InMemoryRunDataFactory as t, DefaultExecutionBinaryService as u, HumanTaskStatus as v, CredentialResolverFactory as x, HumanTaskStore as y };
+//# sourceMappingURL=InMemoryRunDataFactory-qMiYjhCK.d.cts.map

package/dist/{ItemsInputNormalizer-D-MH8MBs.js → ItemsInputNormalizer-BhuxvZh5.js}

@@ -1,4 +1,4 @@
-import { a as injectable } from "./di-0Wop7z1y.js";
+import { a as injectable } from "./di-DdsgWfVy.js";
 
 //#region \0@oxc-project+runtime@0.95.0/helpers/decorate.js
 function __decorate(decorators, target, key, desc) {
@@ -33,4 +33,4 @@ ItemsInputNormalizer = __decorate([injectable()], ItemsInputNormalizer);
 
 //#endregion
 export { ItemsInputNormalizer as t };
-//# sourceMappingURL=ItemsInputNormalizer-D-MH8MBs.js.map
+//# sourceMappingURL=ItemsInputNormalizer-BhuxvZh5.js.map

package/dist/{ItemsInputNormalizer-D-MH8MBs.js.map → ItemsInputNormalizer-BhuxvZh5.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ItemsInputNormalizer-D-MH8MBs.js","names":["ItemsInputNormalizer"],"sources":["../src/serialization/ItemsInputNormalizer.ts"],"sourcesContent":["import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\n\n/**\n * Normalizes external inputs into the engine's canonical `Items` shape.\n * Used at host and builder boundaries where callers may provide either a raw value,\n * a single item-like object, or an array of item-like values.\n */\n@injectable()\nexport class ItemsInputNormalizer {\n  normalize(raw: unknown): Items {\n    if (raw === undefined || raw === null) {\n      return [];\n    }\n    if (Array.isArray(raw)) {\n      return raw.map((value) => this.normalizeItem(value));\n    }\n    return [this.normalizeItem(raw)];\n  }\n\n  private normalizeItem(raw: unknown): Item {\n    if (!this.isItem(raw)) {\n      return { json: raw };\n    }\n    return {\n      json: raw.json,\n      ...(raw.binary === undefined ? {} : { binary: raw.binary }),\n      ...(raw.meta === undefined ? {} : { meta: raw.meta }),\n      ...(raw.paired === undefined ? {} : { paired: raw.paired }),\n    };\n  }\n\n  private isItem(raw: unknown): raw is Item {\n    return typeof raw === \"object\" && raw !== null && Object.prototype.hasOwnProperty.call(raw, \"json\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;AASO,iCAAMA,uBAAqB;CAChC,UAAU,KAAqB;AAC7B,MAAI,QAAQ,UAAa,QAAQ,KAC/B,QAAO,EAAE;AAEX,MAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,UAAU,KAAK,cAAc,MAAM,CAAC;AAEtD,SAAO,CAAC,KAAK,cAAc,IAAI,CAAC;;CAGlC,AAAQ,cAAc,KAAoB;AACxC,MAAI,CAAC,KAAK,OAAO,IAAI,CACnB,QAAO,EAAE,MAAM,KAAK;AAEtB,SAAO;GACL,MAAM,IAAI;GACV,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC1D,GAAI,IAAI,SAAS,SAAY,EAAE,GAAG,EAAE,MAAM,IAAI,MAAM;GACpD,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC3D;;CAGH,AAAQ,OAAO,KAA2B;AACxC,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;;;mCAzBtG,YAAY"}
+{"version":3,"file":"ItemsInputNormalizer-BhuxvZh5.js","names":["ItemsInputNormalizer"],"sources":["../src/serialization/ItemsInputNormalizer.ts"],"sourcesContent":["import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\n\n/**\n * Normalizes external inputs into the engine's canonical `Items` shape.\n * Used at host and builder boundaries where callers may provide either a raw value,\n * a single item-like object, or an array of item-like values.\n */\n@injectable()\nexport class ItemsInputNormalizer {\n  normalize(raw: unknown): Items {\n    if (raw === undefined || raw === null) {\n      return [];\n    }\n    if (Array.isArray(raw)) {\n      return raw.map((value) => this.normalizeItem(value));\n    }\n    return [this.normalizeItem(raw)];\n  }\n\n  private normalizeItem(raw: unknown): Item {\n    if (!this.isItem(raw)) {\n      return { json: raw };\n    }\n    return {\n      json: raw.json,\n      ...(raw.binary === undefined ? {} : { binary: raw.binary }),\n      ...(raw.meta === undefined ? {} : { meta: raw.meta }),\n      ...(raw.paired === undefined ? {} : { paired: raw.paired }),\n    };\n  }\n\n  private isItem(raw: unknown): raw is Item {\n    return typeof raw === \"object\" && raw !== null && Object.prototype.hasOwnProperty.call(raw, \"json\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;AASO,iCAAMA,uBAAqB;CAChC,UAAU,KAAqB;AAC7B,MAAI,QAAQ,UAAa,QAAQ,KAC/B,QAAO,EAAE;AAEX,MAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,UAAU,KAAK,cAAc,MAAM,CAAC;AAEtD,SAAO,CAAC,KAAK,cAAc,IAAI,CAAC;;CAGlC,AAAQ,cAAc,KAAoB;AACxC,MAAI,CAAC,KAAK,OAAO,IAAI,CACnB,QAAO,EAAE,MAAM,KAAK;AAEtB,SAAO;GACL,MAAM,IAAI;GACV,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC1D,GAAI,IAAI,SAAS,SAAY,EAAE,GAAG,EAAE,MAAM,IAAI,MAAM;GACpD,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC3D;;CAGH,AAAQ,OAAO,KAA2B;AACxC,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;;;mCAzBtG,YAAY"}

package/dist/{ItemsInputNormalizer-_Mfcd3YU.d.ts → ItemsInputNormalizer-C09a7iFP.d.ts}

@@ -1,4 +1,4 @@
-import { $a as NodeId, La as CredentialRequirement, Ln as Item, Qa as NodeConnectionName, St as ConnectionInvocationId, Wn as JsonValue, di as NodeExecutionContext, et as Expr, ia as TelemetrySpanScope, j as McpServerDeclaration, ln as TypeToken, mr as RunnableNodeInputJson, pr as RunnableNodeConfig, qn as NodeConfigBase, rr as NodeOutputs, zn as Items } from "./index-zWGtEhrf.js";
+import { Aa as TelemetrySpanScope, Fi as NodeExecutionContext, Mr as RunnableNodeConfig, Nr as RunnableNodeInputJson, On as TypeToken, Rt as ConnectionInvocationId, Sr as NodeOutputs, To as NodeId, fr as NodeConfigBase, gt as Expr, ir as Items, lo as CredentialRequirement, lr as JsonValue, nr as Item, q as McpServerDeclaration, wo as NodeConnectionName } from "./index-CSKKuK60.js";
 import { ZodType, input, output } from "zod";
 
 //#region src/ai/NodeBackedToolConfig.d.ts
@@ -318,4 +318,4 @@ declare class ItemsInputNormalizer {
 }
 //#endregion
 export { ChatModelFactory as A, ZodSchemaAny as B, AgentToolDefinition as C, ChatLanguageModel as D, AgentTurnLimitBehavior as E, NodeBackedToolOutputMapperArgs as F, CallableToolFactory as G, AgentMessageConfigNormalizer as H, StructuredOutputOptions as I, CallableToolExecuteHandler as J, CallableToolConfig as K, Tool as L, NodeBackedToolInputMapper as M, NodeBackedToolInputMapperArgs as N, ChatLanguageModelCallOptions as O, NodeBackedToolOutputMapper as P, ToolConfig as R, AgentToolCallPlanner as S, AgentToolToken as T, AgentToolFactory as U, AgentConfigInspector as V, CallableToolKindToken as W, NodeBackedToolConfig as Y, AgentMessageTemplateContent as _, AgentConnectionNodeRole as a, AgentTool as b, AgentCanvasPresentation as c, AgentMessageBuildArgs as d, AgentMessageConfig as f, AgentMessageTemplate as g, AgentMessageRole as h, AgentConnectionNodeDescriptor as i, NodeBackedToolConfigOptions as j, ChatModelConfig as k, AgentGuardrailConfig as l, AgentMessageLine as m, AgentConnectionCredentialSource as n, McpServerResolver as o, AgentMessageDto as p, CallableToolConfigOptions as q, AgentConnectionNodeCollector as r, AgentAttachmentRole as s, ItemsInputNormalizer as t, AgentGuardrailDefaults as u, AgentModelInvocationOptions as v, AgentToolExecuteArgs as w, AgentToolCall as x, AgentNodeConfig as y, ToolExecuteArgs as z };
-//# sourceMappingURL=ItemsInputNormalizer-_Mfcd3YU.d.ts.map
+//# sourceMappingURL=ItemsInputNormalizer-C09a7iFP.d.ts.map

package/dist/{ItemsInputNormalizer-C_dpn76M.d.cts → ItemsInputNormalizer-DLaD6rTl.d.cts}

@@ -1,5 +1,5 @@
-import { At as NodeConfigBase, Bt as NodeOutputs, Dt as JsonValue, Fi as NodeConnectionName, Ii as NodeId, Jn as NodeExecutionContext, K as TypeToken, St as Items, Vr as TelemetrySpanScope, Xt as RunnableNodeConfig, Zt as RunnableNodeInputJson, a as ConnectionInvocationId, bi as CredentialRequirement, bt as Item, y as PersistedRunState } from "./agentMcpTypes-ZiNbNsEi.cjs";
-import { t as Expr } from "./params-B5SENSzZ.cjs";
+import { $t as RunnableNodeConfig, Ai as CredentialRequirement, At as JsonValue, Ct as Item, Gi as NodeConnectionName, Ki as NodeId, Nt as NodeConfigBase, Tt as Items, Ut as NodeOutputs, Y as TypeToken, Zr as TelemetrySpanScope, a as ConnectionInvocationId, b as PersistedRunState, en as RunnableNodeInputJson, nr as NodeExecutionContext } from "./agentMcpTypes-DUmniLOY.cjs";
+import { t as Expr } from "./params-DqRvku2h.cjs";
 import { ZodType, input, output } from "zod";
 
 //#region src/contracts/mcpTypes.d.ts
@@ -404,4 +404,4 @@ declare class ItemsInputNormalizer {
 }
 //#endregion
 export { McpServerDeclaration as $, ChatModelFactory as A, ZodSchemaAny as B, AgentToolDefinition as C, ChatLanguageModel as D, AgentTurnLimitBehavior as E, NodeBackedToolOutputMapperArgs as F, CallableToolFactory as G, AgentMessageConfigNormalizer as H, StructuredOutputOptions as I, CallableToolExecuteHandler as J, CallableToolConfig as K, Tool as L, NodeBackedToolInputMapper as M, NodeBackedToolInputMapperArgs as N, ChatLanguageModelCallOptions as O, NodeBackedToolOutputMapper as P, RunFinishedAtFactory as Q, ToolConfig as R, AgentToolCallPlanner as S, AgentToolToken as T, AgentToolFactory as U, AgentConfigInspector as V, CallableToolKindToken as W, NodeIterationIdFactory as X, NodeBackedToolConfig as Y, ConnectionNodeIdFactory as Z, AgentMessageTemplateContent as _, AgentConnectionNodeRole as a, AgentTool as b, AgentCanvasPresentation as c, AgentMessageBuildArgs as d, McpServerTransport as et, AgentMessageConfig as f, AgentMessageTemplate as g, AgentMessageRole as h, AgentConnectionNodeDescriptor as i, NodeBackedToolConfigOptions as j, ChatModelConfig as k, AgentGuardrailConfig as l, AgentMessageLine as m, AgentConnectionCredentialSource as n, McpServerResolver as o, AgentMessageDto as p, CallableToolConfigOptions as q, AgentConnectionNodeCollector as r, AgentAttachmentRole as s, ItemsInputNormalizer as t, AgentGuardrailDefaults as u, AgentModelInvocationOptions as v, AgentToolExecuteArgs as w, AgentToolCall as x, AgentNodeConfig as y, ToolExecuteArgs as z };
-//# sourceMappingURL=ItemsInputNormalizer-C_dpn76M.d.cts.map
+//# sourceMappingURL=ItemsInputNormalizer-DLaD6rTl.d.cts.map

package/dist/{ItemsInputNormalizer-CwdOhSAK.cjs → ItemsInputNormalizer-Div-fb6a.cjs}

@@ -1,4 +1,4 @@
-const require_di = require('./di-BlEKdoZS.cjs');
+const require_di = require('./di-tO6R7VJV.cjs');
 let tsyringe = require("tsyringe");
 tsyringe = require_di.__toESM(tsyringe);
 
@@ -40,4 +40,4 @@ Object.defineProperty(exports, 'ItemsInputNormalizer', {
     return ItemsInputNormalizer;
   }
 });
-//# sourceMappingURL=ItemsInputNormalizer-CwdOhSAK.cjs.map
+//# sourceMappingURL=ItemsInputNormalizer-Div-fb6a.cjs.map

package/dist/{ItemsInputNormalizer-CwdOhSAK.cjs.map → ItemsInputNormalizer-Div-fb6a.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ItemsInputNormalizer-CwdOhSAK.cjs","names":["ItemsInputNormalizer"],"sources":["../src/serialization/ItemsInputNormalizer.ts"],"sourcesContent":["import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\n\n/**\n * Normalizes external inputs into the engine's canonical `Items` shape.\n * Used at host and builder boundaries where callers may provide either a raw value,\n * a single item-like object, or an array of item-like values.\n */\n@injectable()\nexport class ItemsInputNormalizer {\n  normalize(raw: unknown): Items {\n    if (raw === undefined || raw === null) {\n      return [];\n    }\n    if (Array.isArray(raw)) {\n      return raw.map((value) => this.normalizeItem(value));\n    }\n    return [this.normalizeItem(raw)];\n  }\n\n  private normalizeItem(raw: unknown): Item {\n    if (!this.isItem(raw)) {\n      return { json: raw };\n    }\n    return {\n      json: raw.json,\n      ...(raw.binary === undefined ? {} : { binary: raw.binary }),\n      ...(raw.meta === undefined ? {} : { meta: raw.meta }),\n      ...(raw.paired === undefined ? {} : { paired: raw.paired }),\n    };\n  }\n\n  private isItem(raw: unknown): raw is Item {\n    return typeof raw === \"object\" && raw !== null && Object.prototype.hasOwnProperty.call(raw, \"json\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AASO,iCAAMA,uBAAqB;CAChC,UAAU,KAAqB;AAC7B,MAAI,QAAQ,UAAa,QAAQ,KAC/B,QAAO,EAAE;AAEX,MAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,UAAU,KAAK,cAAc,MAAM,CAAC;AAEtD,SAAO,CAAC,KAAK,cAAc,IAAI,CAAC;;CAGlC,AAAQ,cAAc,KAAoB;AACxC,MAAI,CAAC,KAAK,OAAO,IAAI,CACnB,QAAO,EAAE,MAAM,KAAK;AAEtB,SAAO;GACL,MAAM,IAAI;GACV,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC1D,GAAI,IAAI,SAAS,SAAY,EAAE,GAAG,EAAE,MAAM,IAAI,MAAM;GACpD,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC3D;;CAGH,AAAQ,OAAO,KAA2B;AACxC,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;;;6DAzB1F"}
+{"version":3,"file":"ItemsInputNormalizer-Div-fb6a.cjs","names":["ItemsInputNormalizer"],"sources":["../src/serialization/ItemsInputNormalizer.ts"],"sourcesContent":["import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\n\n/**\n * Normalizes external inputs into the engine's canonical `Items` shape.\n * Used at host and builder boundaries where callers may provide either a raw value,\n * a single item-like object, or an array of item-like values.\n */\n@injectable()\nexport class ItemsInputNormalizer {\n  normalize(raw: unknown): Items {\n    if (raw === undefined || raw === null) {\n      return [];\n    }\n    if (Array.isArray(raw)) {\n      return raw.map((value) => this.normalizeItem(value));\n    }\n    return [this.normalizeItem(raw)];\n  }\n\n  private normalizeItem(raw: unknown): Item {\n    if (!this.isItem(raw)) {\n      return { json: raw };\n    }\n    return {\n      json: raw.json,\n      ...(raw.binary === undefined ? {} : { binary: raw.binary }),\n      ...(raw.meta === undefined ? {} : { meta: raw.meta }),\n      ...(raw.paired === undefined ? {} : { paired: raw.paired }),\n    };\n  }\n\n  private isItem(raw: unknown): raw is Item {\n    return typeof raw === \"object\" && raw !== null && Object.prototype.hasOwnProperty.call(raw, \"json\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AASO,iCAAMA,uBAAqB;CAChC,UAAU,KAAqB;AAC7B,MAAI,QAAQ,UAAa,QAAQ,KAC/B,QAAO,EAAE;AAEX,MAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,UAAU,KAAK,cAAc,MAAM,CAAC;AAEtD,SAAO,CAAC,KAAK,cAAc,IAAI,CAAC;;CAGlC,AAAQ,cAAc,KAAoB;AACxC,MAAI,CAAC,KAAK,OAAO,IAAI,CACnB,QAAO,EAAE,MAAM,KAAK;AAEtB,SAAO;GACL,MAAM,IAAI;GACV,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC1D,GAAI,IAAI,SAAS,SAAY,EAAE,GAAG,EAAE,MAAM,IAAI,MAAM;GACpD,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC3D;;CAGH,AAAQ,OAAO,KAA2B;AACxC,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;;;6DAzB1F"}

package/dist/{RunIntentService-BVur7x9n.d.ts → RunIntentService-BOSGwmqn.d.ts}

@@ -1,4 +1,4 @@
-import { $a as NodeId, $t as WebhookRunResult, At as NodeInputsByPort, Bi as WebhookInvocationMatch, Cn as EngineExecutionLimitsPolicyConfig, Cr as WorkflowErrorHandlerSpec, Dr as WorkflowPolicyRuntimeDefaults, Hi as WebhookTriggerResolution, Ht as RunCurrentState, Ii as WorkflowSnapshotResolver, It as PersistedRunState, Kn as NodeActivationId, Li as HttpMethod, Lt as PersistedWorkflowSnapshot, Mi as WorkflowRepository, Rt as PersistedWorkflowSnapshotNode, Sn as EngineExecutionLimitsPolicy, Sr as WorkflowErrorHandler, Vi as WebhookTriggerMatcher, Wt as RunExecutionOptions, Xt as RunStopCondition, Yn as NodeErrorHandler, Zn as NodeErrorHandlerSpec, _i as NodeResolver, ai as NodeActivationContinuation, br as WorkflowDefinition, cr as PersistedRunPolicySnapshot, dr as RunId, fi as NodeExecutionRequest, kr as WorkflowStoragePolicyDecisionArgs, nn as WorkflowExecutionRepository, no as WorkflowId, pi as NodeExecutionRequestHandler, qn as NodeConfigBase, qt as RunResult, ri as LiveWorkflowRepository, rr as NodeOutputs, sr as ParentExecutionRef, wt as CurrentStateExecutionRequest, zn as Items, zt as PersistedWorkflowTokenRegistryLike } from "./index-zWGtEhrf.js";
+import { $t as PersistedRunState, Ar as RunId, Bt as CurrentStateExecutionRequest, Di as LiveWorkflowRepository, Dr as PersistedRunPolicySnapshot, Er as ParentExecutionRef, Gi as ResumeContext, Hn as EngineExecutionLimitsPolicyConfig, Hr as WorkflowErrorHandlerSpec, Ii as NodeExecutionRequest, Jr as WorkflowStoragePolicyDecisionArgs, Kr as WorkflowPolicyRuntimeDefaults, Kt as NodeInputsByPort, Li as NodeExecutionRequestHandler, Oo as WorkflowId, Sr as NodeOutputs, To as NodeId, Vi as NodeResolver, Vn as EngineExecutionLimitsPolicy, Vr as WorkflowErrorHandler, ca as WorkflowSnapshotResolver, cn as RunExecutionOptions, dr as NodeActivationId, fa as WebhookInvocationMatch, fn as RunResult, fr as NodeConfigBase, gr as NodeErrorHandlerSpec, hn as RunStopCondition, ia as WorkflowRepository, ir as Items, ki as NodeActivationContinuation, la as HttpMethod, ma as WebhookTriggerResolution, mr as NodeErrorHandler, nn as PersistedWorkflowSnapshotNode, on as RunCurrentState, pa as WebhookTriggerMatcher, rn as PersistedWorkflowTokenRegistryLike, tn as PersistedWorkflowSnapshot, vn as WebhookRunResult, xn as WorkflowExecutionRepository, zr as WorkflowDefinition } from "./index-CSKKuK60.js";
 
 //#region src/orchestration/Engine.d.ts
 interface EngineTriggerRuntime {
@@ -49,9 +49,14 @@ interface EngineRunContinuationService {
     error: Error;
   }): Promise<RunResult>;
   waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
+    status: "completed" | "failed" | "halted";
   }>>;
   waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
+  resumeRun(args: {
+    runId: RunId;
+    taskId: string;
+    resumeContext: ResumeContext;
+  }): Promise<RunResult>;
 }
 interface EngineNodeExecutionRequestHandler {
   handleNodeExecutionRequest(request: NodeExecutionRequest): Promise<void>;
@@ -128,9 +133,18 @@ declare class Engine implements NodeActivationContinuation, NodeExecutionRequest
     error: Error;
   }): Promise<RunResult>;
   waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
+    status: "completed" | "failed" | "halted";
   }>>;
   waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
+  /**
+   * Re-activate a suspended run item with a human decision (HITL).
+   * The HTTP resume endpoint calls this; this method exposes the engine primitive.
+   */
+  resumeRun(args: {
+    runId: RunId;
+    taskId: string;
+    resumeContext: ResumeContext;
+  }): Promise<RunResult>;
   handleNodeExecutionRequest(request: NodeExecutionRequest): Promise<void>;
 }
 //#endregion
@@ -282,4 +296,4 @@ declare class RunIntentService {
 }
 //#endregion
 export { RunPolicySnapshotFactory as a, RunTerminalPersistenceCoordinator as c, WorkflowSnapshotCodec as i, WorkflowStoragePolicyEvaluator as l, InMemoryLiveWorkflowRepository as n, EngineExecutionLimitsPolicyFactory as o, EngineWorkflowRunnerService as r, WorkflowPolicyErrorServices as s, RunIntentService as t, Engine as u };
-//# sourceMappingURL=RunIntentService-BVur7x9n.d.ts.map
+//# sourceMappingURL=RunIntentService-BOSGwmqn.d.ts.map

package/dist/{RunIntentService-CEF-sFfI.d.cts → RunIntentService-CWMMrAP4.d.cts}

@@ -1,4 +1,4 @@
-import { A as RunResult, Bn as LiveWorkflowRepository, Bt as NodeOutputs, Cr as WebhookInvocationMatch, D as RunExecutionOptions, Hn as NodeActivationContinuation, I as WebhookRunResult, Ii as NodeId, Jt as RunId, N as RunStopCondition, S as PersistedWorkflowTokenRegistryLike, St as Items, T as RunCurrentState, Tr as WebhookTriggerResolution, Wt as ParentExecutionRef, Xn as NodeExecutionRequestHandler, Yn as NodeExecutionRequest, br as HttpMethod, hr as WorkflowRepository, kt as NodeActivationId, p as NodeInputsByPort, rn as WorkflowDefinition, s as CurrentStateExecutionRequest, wr as WebhookTriggerMatcher, yr as WorkflowSnapshotResolver, z as WorkflowExecutionRepository, zi as WorkflowId } from "./agentMcpTypes-ZiNbNsEi.cjs";
+import { Ar as HttpMethod, D as RunCurrentState, Fr as WebhookTriggerResolution, H as WorkflowExecutionRepository, I as RunStopCondition, Jn as LiveWorkflowRepository, Ki as NodeId, Mt as NodeActivationId, N as RunResult, Nr as WebhookInvocationMatch, Pr as WebhookTriggerMatcher, Tr as WorkflowRepository, Tt as Items, Ut as NodeOutputs, Xn as NodeActivationContinuation, Yi as WorkflowId, Zt as RunId, fr as ResumeContext, ir as NodeExecutionRequestHandler, k as RunExecutionOptions, kr as WorkflowSnapshotResolver, on as WorkflowDefinition, p as NodeInputsByPort, qt as ParentExecutionRef, rr as NodeExecutionRequest, s as CurrentStateExecutionRequest, w as PersistedWorkflowTokenRegistryLike, z as WebhookRunResult } from "./agentMcpTypes-DUmniLOY.cjs";
 
 //#region src/orchestration/Engine.d.ts
 interface EngineTriggerRuntime {
@@ -49,9 +49,14 @@ interface EngineRunContinuationService {
     error: Error;
   }): Promise<RunResult>;
   waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
+    status: "completed" | "failed" | "halted";
   }>>;
   waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
+  resumeRun(args: {
+    runId: RunId;
+    taskId: string;
+    resumeContext: ResumeContext;
+  }): Promise<RunResult>;
 }
 interface EngineNodeExecutionRequestHandler {
   handleNodeExecutionRequest(request: NodeExecutionRequest): Promise<void>;
@@ -128,9 +133,18 @@ declare class Engine implements NodeActivationContinuation, NodeExecutionRequest
     error: Error;
   }): Promise<RunResult>;
   waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
-    status: "completed" | "failed";
+    status: "completed" | "failed" | "halted";
   }>>;
   waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
+  /**
+   * Re-activate a suspended run item with a human decision (HITL).
+   * The HTTP resume endpoint calls this; this method exposes the engine primitive.
+   */
+  resumeRun(args: {
+    runId: RunId;
+    taskId: string;
+    resumeContext: ResumeContext;
+  }): Promise<RunResult>;
   handleNodeExecutionRequest(request: NodeExecutionRequest): Promise<void>;
 }
 //#endregion
@@ -203,4 +217,4 @@ declare class RunIntentService {
 }
 //#endregion
 export { InMemoryLiveWorkflowRepository as n, Engine as r, RunIntentService as t };
-//# sourceMappingURL=RunIntentService-CEF-sFfI.d.cts.map
+//# sourceMappingURL=RunIntentService-CWMMrAP4.d.cts.map