@codemation/core 0.13.2 → 0.15.0

package/dist/bootstrap/index.cjs

@@ -1,7 +1,8 @@
-require('../di-LP2qSHkY.cjs');
-require('../contracts-CK0x6w_G.cjs');
-const require_runtime = require('../runtime-_VdHwGkJ.cjs');
-const require_bootstrap = require('../bootstrap-DIv-vloi.cjs');
+require('../di-C6Ubf9o5.cjs');
+require('../workflowTypes-BW6Hhee7.cjs');
+const require_contracts = require('../contracts-7L1wJHdk.cjs');
+const require_runtime = require('../runtime-Due-FOZ2.cjs');
+const require_bootstrap = require('../bootstrap-CTB53rEF.cjs');
 
 exports.AbortControllerFactory = require_bootstrap.AbortControllerFactory;
 exports.CatalogBackedCostTrackingTelemetryFactory = require_runtime.CatalogBackedCostTrackingTelemetryFactory;
@@ -26,10 +27,11 @@ exports.InMemoryWorkflowExecutionRepository = require_bootstrap.InMemoryWorkflow
 exports.InProcessRetryRunner = require_runtime.InProcessRetryRunner;
 exports.InlineDrivingScheduler = require_runtime.InlineDrivingScheduler;
 exports.LocalOnlyScheduler = require_runtime.LocalOnlyScheduler;
+exports.MissingRuntimeParityGuard = require_runtime.MissingRuntimeParityGuard;
 exports.MissingRuntimeTriggerToken = require_runtime.MissingRuntimeTriggerToken;
 exports.NodeExecutor = require_runtime.NodeExecutor;
 exports.NodeInstanceFactory = require_runtime.NodeInstanceFactory;
-exports.PersistedWorkflowTokenRegistry = require_runtime.PersistedWorkflowTokenRegistry;
+exports.PersistedWorkflowTokenRegistry = require_contracts.PersistedWorkflowTokenRegistry;
 exports.RunIntentService = require_runtime.RunIntentService;
 exports.RunPolicySnapshotFactory = require_runtime.RunPolicySnapshotFactory;
 exports.RunSummaryMapper = require_bootstrap.RunSummaryMapper;
@@ -38,6 +40,8 @@ exports.StaticCostCatalog = require_runtime.StaticCostCatalog;
 exports.TestSuiteOrchestrator = require_bootstrap.TestSuiteOrchestrator;
 exports.TestSuiteRunIdFactory = require_bootstrap.TestSuiteRunIdFactory;
 exports.UnavailableBinaryStorage = require_runtime.UnavailableBinaryStorage;
+exports.WorkflowParityMismatchError = require_runtime.WorkflowParityMismatchError;
 exports.WorkflowPolicyErrorServices = require_runtime.WorkflowPolicyErrorServices;
 exports.WorkflowRepositoryWebhookTriggerMatcher = require_runtime.WorkflowRepositoryWebhookTriggerMatcher;
+exports.WorkflowSnapshotCodec = require_contracts.WorkflowSnapshotCodec;
 exports.WorkflowStoragePolicyEvaluator = require_runtime.WorkflowStoragePolicyEvaluator;

package/dist/bootstrap/index.d.cts

@@ -1,14 +1,10 @@
-import { $n as NodeActivationRequest, B as WorkflowExecutionListingRepository, Br as ExecutionTelemetry, C as PersistedWorkflowSnapshotNode, Er as WorkflowRepository, Fr as WebhookTriggerMatcher, Ft as NodeErrorHandler, Gt as NodeSchedulerDecision, H as WorkflowExecutionRepository, Ht as NodeOffloadPolicy, Jt as PersistedRunPolicySnapshot, L as RunSummary, Lr as WebhookTriggerRoutingDiagnostics, Lt as NodeErrorHandlerSpec, Mt as NodeActivationId, N as RunResult, Nt as NodeConfigBase, Pr as WebhookInvocationMatch, Pt as NodeDefinition, Rn as EngineDeps, St as ExecutionMode, Tr as WorkflowNodeInstanceFactory, Tt as Items, Ut as NodeOutputs, V as WorkflowExecutionPruneRepository, W as DependencyContainer, Xi as WorkflowId, Y as TypeToken, Yi as PersistedTokenId, Yr as TelemetryScope, Zn as NodeActivationContinuation, Zt as RunId, b as PersistedRunState, c as EngineRunCounters, cn as WorkflowErrorHandler, ct as EngineExecutionLimitsPolicy, di as CostTrackingTelemetryFactory, dt as RunEventBus, fr as PreparedNodeActivationDispatch, gr as SuspensionRequest, hn as WorkflowStoragePolicyDecisionArgs, ht as TestSuiteRunId, ir as NodeExecutionRequest, j as RunPruneCandidate, jr as HttpMethod, k as RunExecutionOptions, li as CostTrackingTelemetry, ln as WorkflowErrorHandlerSpec, lr as NodeResolver, lt as EngineExecutionLimitsPolicyConfig, mt as TestSuiteRunStatus, on as WorkflowDefinition, or as NodeExecutionScheduler, pi as CostTrackingUsageRecord, pn as WorkflowPolicyRuntimeDefaults, pt as TestCaseRunStatus, qi as NodeId, qt as ParentExecutionRef, st as ENGINE_EXECUTION_LIMITS_DEFAULTS, tr as NodeActivationScheduler, y as PersistedRunSchedulingState, zr as WorkflowActivationPolicy } from "../agentMcpTypes-DGIwk6Ue.cjs";
-import { n as CostCatalogEntry, t as CostCatalog } from "../CostCatalogContract-Dxq1BTyi.cjs";
-import { n as InMemoryLiveWorkflowRepository, r as Engine, t as RunIntentService } from "../RunIntentService-BitgkKaT.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-Csy2evr_.cjs";
-import { a as WorkflowSnapshotCodec, i as EngineWorkflowRunnerService, n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-CqcTWexS.cjs";
+import { $n as NodeActivationContinuation, $t as RunId, B as WorkflowExecutionListingRepository, Bn as EngineDeps, Br as WebhookTriggerRoutingDiagnostics, C as PersistedWorkflowSnapshotNode, Ct as ExecutionMode, Et as Items, Ft as NodeDefinition, H as WorkflowExecutionRepository, Hr as WorkflowActivationPolicy, It as NodeErrorHandler, Jt as ParentExecutionRef, Kt as NodeSchedulerDecision, L as RunSummary, Lr as WebhookInvocationMatch, N as RunResult, Nt as NodeActivationId, Or as WorkflowNodeInstanceFactory, Pr as HttpMethod, Pt as NodeConfigBase, Qi as NodeId, Qr as TelemetryScope, Rr as WebhookTriggerMatcher, Rt as NodeErrorHandlerSpec, Ur as ExecutionTelemetry, Ut as NodeOffloadPolicy, V as WorkflowExecutionPruneRepository, W as DependencyContainer, Wt as NodeOutputs, Y as TypeToken, Yt as PersistedRunPolicySnapshot, _n as WorkflowStoragePolicyDecisionArgs, b as PersistedRunState, c as EngineRunCounters, cn as WorkflowDefinition, cr as NodeExecutionScheduler, ct as ENGINE_EXECUTION_LIMITS_DEFAULTS, dn as WorkflowErrorHandlerSpec, dr as NodeResolver, ea as PersistedTokenId, fi as CostTrackingTelemetry, ft as RunEventBus, gi as CostTrackingUsageRecord, gt as TestSuiteRunId, hn as WorkflowPolicyRuntimeDefaults, ht as TestSuiteRunStatus, j as RunPruneCandidate, k as RunExecutionOptions, kr as WorkflowRepository, lt as EngineExecutionLimitsPolicy, mi as CostTrackingTelemetryFactory, mr as PreparedNodeActivationDispatch, mt as TestCaseRunStatus, or as NodeExecutionRequest, rr as NodeActivationScheduler, ta as WorkflowId, tr as NodeActivationRequest, un as WorkflowErrorHandler, ut as EngineExecutionLimitsPolicyConfig, vr as SuspensionRequest, y as PersistedRunSchedulingState } from "../agentMcpTypes-BHX4RQCC.cjs";
+import { n as CostCatalogEntry, t as CostCatalog } from "../CostCatalogContract-Dwo-ZamG.cjs";
+import { n as InMemoryLiveWorkflowRepository, r as Engine, t as RunIntentService } from "../RunIntentService-DKxuHTUz.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-D2U9azmZ.cjs";
+import { a as WorkflowSnapshotCodec, i as EngineWorkflowRunnerService, n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-BiNasx3G.cjs";
 
 //#region src/orchestration/AbortControllerFactory.d.ts
-/**
- * Mints fresh {@link AbortController}s. Injected (rather than direct `new`) to honor the
- * codebase's no-direct-construction rule and to give tests a seam for substituting a fake.
- */
 declare class AbortControllerFactory {
   create(): AbortController;
 }
@@ -42,6 +38,11 @@ declare class WorkflowPolicyErrorServices {
   resolveWorkflowErrorHandler(spec: WorkflowErrorHandlerSpec | undefined): WorkflowErrorHandler | undefined;
 }
 //#endregion
+//#region src/workflowSnapshots/MissingRuntimeExecutionMarker.d.ts
+declare class MissingRuntimeExecutionMarker {
+  isMarked(config: unknown): boolean;
+}
+//#endregion
 //#region src/execution/CatalogBackedCostTrackingTelemetryFactory.d.ts
 declare class CatalogBackedCostTrackingTelemetryFactory implements CostTrackingTelemetryFactory {
   private readonly costCatalog;
@@ -52,35 +53,13 @@ declare class CatalogBackedCostTrackingTelemetryFactory implements CostTrackingT
 }
 //#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);
+  constructor(workflowExecutionRepository: WorkflowExecutionRepository, humanTaskStore?: HumanTaskStore | undefined, tokenSigner?: HitlResumeTokenSignerSeam | undefined, timeoutScheduler?: HitlTimeoutJobSchedulerSeam | undefined, workspaceId?: string | undefined);
   handle(args: {
     runId: RunId;
     nodeId: NodeId;
@@ -88,14 +67,8 @@ declare class NodeSuspensionHandler {
     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;
@@ -105,17 +78,13 @@ declare class NodeSuspensionHandler {
 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, /** Required for HITL suspension support. When omitted, `SuspensionRequest` throws upward. */
-  suspensionHandler?: NodeSuspensionHandler | undefined, /** Required alongside `suspensionHandler`. */
-  loadRunState?: ((runId: RunId) => Promise<PersistedRunState | undefined>) | undefined);
+  constructor(nodeInstanceFactory: WorkflowNodeInstanceFactory, retryRunner: InProcessRetryRunner, itemExprResolver?: ItemExprResolver, outputBehaviorResolver?: RunnableOutputBehaviorResolver, suspensionHandler?: NodeSuspensionHandler | undefined, loadRunState?: ((runId: RunId) => Promise<PersistedRunState | undefined>) | undefined);
   execute(request: NodeActivationRequest): Promise<NodeOutputs>;
   private assertRequiredCredentialsBound;
   private isCredentialError;
@@ -126,7 +95,6 @@ declare class NodeExecutor {
   private hasExecuteMulti;
   private asMultiFromSingleActivation;
   private executeRunnableActivation;
-  /** Use resolver ctx only when {@link NodeExecutionContext.config} is non-nullish. */
   private pickExecutionContext;
   private resolveInputSchema;
   private assertItemJsonNotTopLevelArray;
@@ -173,14 +141,6 @@ declare class InlineDrivingScheduler implements NodeActivationScheduler {
   private readonly activeDrainPromises;
   constructor(nodeExecutor: NodeExecutor);
   setContinuation(continuation: NodeActivationContinuation): void;
-  /**
-   * Prevents new drain cycles from being scheduled and waits for all currently-running
-   * drains to complete. Call before closing the DB connection or rolling back test transactions
-   * to ensure no in-flight writes hit a closed/rolled-back connection.
-   *
-   * Bounded: only the drains already in-flight at call time are awaited. Runs that keep
-   * re-scheduling will not schedule new work once stopped is set.
-   */
   stop(): Promise<void>;
   prepareDispatch(request: NodeActivationRequest): Promise<PreparedNodeActivationDispatch>;
   private drainRun;
@@ -200,12 +160,6 @@ declare class DefaultDrivingScheduler implements NodeActivationScheduler {
   constructor(offloadPolicy: NodeOffloadPolicy, workerScheduler: NodeExecutionScheduler, inline: InlineDrivingScheduler);
   setContinuation(continuation: NodeActivationContinuation): void;
   prepareDispatch(request: NodeActivationRequest): Promise<PreparedNodeActivationDispatch>;
-  /**
-   * Scheduler precedence is explicit:
-   * 1. run-intent override (`executionOptions.localOnly`)
-   * 2. node-level execution hint / queue policy
-   * 3. container-default scheduler policy fallback
-   */
   private selectScheduler;
   private hasNodeSchedulingPreference;
   private prepareInlineDispatch;
@@ -228,9 +182,6 @@ declare class LocalOnlyScheduler implements NodeExecutionScheduler {
 }
 //#endregion
 //#region src/policies/executionLimits/EngineExecutionLimitsPolicyFactory.d.ts
-/**
- * Builds {@link EngineExecutionLimitsPolicy} by merging {@link ENGINE_EXECUTION_LIMITS_DEFAULTS} with optional `overrides` (e.g. host `runtime.engineExecutionLimits`).
- */
 declare class EngineExecutionLimitsPolicyFactory {
   create(overrides?: Partial<EngineExecutionLimitsPolicyConfig>): EngineExecutionLimitsPolicy;
 }
@@ -271,7 +222,6 @@ declare class InMemoryWorkflowExecutionRepository implements WorkflowExecutionRe
 }
 //#endregion
 //#region src/runStorage/RunSummaryMapper.d.ts
-/** Maps persisted run state to API run summaries for listings. */
 declare class RunSummaryMapper {
   static fromPersistedState(state: PersistedRunState): RunSummary;
 }
@@ -282,30 +232,16 @@ declare class MissingRuntimeFallbacks {
 }
 //#endregion
 //#region src/runtime/EngineFactory.d.ts
-/**
- * {@link EngineDeps} plus optional overrides for workflow-snapshot materialization.
- * Overrides keep default construction in this factory while allowing tests or advanced wiring to inject instances.
- */
 type EngineCompositionDeps = EngineDeps & {
   workflowSnapshotCodec?: WorkflowSnapshotCodec;
   missingRuntimeFallbacks?: MissingRuntimeFallbacks;
-  /** When set, used for run-start, trigger, and continuation limit defaults. */
   executionLimitsPolicy?: EngineExecutionLimitsPolicy;
 };
-/**
- * Composes the {@link Engine} graph from {@link EngineCompositionDeps}. Production wiring usually goes through
- * {@link import("../bootstrap/runtime/EngineRuntimeRegistrar").EngineRuntimeRegistrar}; this factory remains for tests and custom composition.
- * Exported from `@codemation/core/bootstrap` (not the main `@codemation/core` barrel).
- */
 declare class EngineFactory {
   create(deps: EngineCompositionDeps): Engine;
 }
 //#endregion
 //#region src/runtime/WorkflowRepositoryWebhookTriggerMatcher.d.ts
-/**
- * Resolves webhook HTTP routes from the live workflow repository (no trigger setup / registration).
- * Maintains an in-memory index keyed by user-defined endpoint path for O(1) lookups after reload.
- */
 declare class WorkflowRepositoryWebhookTriggerMatcher implements WebhookTriggerMatcher {
   private readonly workflowRepository;
   private readonly workflowActivationPolicy;
@@ -327,20 +263,19 @@ declare class WorkflowRepositoryWebhookTriggerMatcher implements WebhookTriggerM
   private normalizeEndpointPath;
 }
 //#endregion
+//#region src/workflowSnapshots/MissingRuntimeParityGuard.d.ts
+declare class MissingRuntimeParityGuard {
+  private readonly marker;
+  constructor(marker: MissingRuntimeExecutionMarker);
+  assertNone(workflow: WorkflowDefinition, nodeIds?: ReadonlyArray<NodeId>): void;
+}
+//#endregion
 //#region src/orchestration/TestSuiteRunIdFactory.d.ts
-/**
- * Mints unique TestSuiteRun identifiers. Separated from {@link import("../types").RunIdFactory}
- * so suite ids and per-case workflow run ids never alias.
- */
 declare class TestSuiteRunIdFactory {
   makeTestSuiteRunId(): TestSuiteRunId;
 }
 //#endregion
 //#region src/orchestration/TestSuiteOrchestrator.d.ts
-/**
- * Engine-facade subset the orchestrator needs. Kept narrow on purpose so unit tests can
- * substitute a fake without depending on the full Engine wiring.
- */
 interface TestSuiteOrchestratorEngine {
   runWorkflow(wf: WorkflowDefinition, startAt: NodeId, items: Items, parent?: ParentExecutionRef, executionOptions?: RunExecutionOptions): Promise<RunResult>;
   waitForCompletion(runId: RunId): Promise<Extract<RunResult, {
@@ -369,15 +304,6 @@ interface RunTestSuiteArgs {
   readonly concurrency?: number;
   readonly signal?: AbortSignal;
 }
-/**
- * Drives a {@link TestTriggerNodeConfig.generateItems} iterable into one workflow run per item,
- * with bounded concurrency. Pure engine logic — no persistence, no HTTP, no UI. Hosts adapt by
- * subscribing to {@link RunEventBus} and writing rows on `testSuite*` / `testCase*` / `nodeCompleted`.
- *
- * Cancellation: the supplied `AbortSignal` aborts the source iterable (so credentialed pulls bail)
- * and stops scheduling further cases. In-flight cases are awaited; engine-level cancellation of
- * an already-dispatched run is not yet wired (Phase 2).
- */
 declare class TestSuiteOrchestrator {
   private readonly engine;
   private readonly testSuiteRunIdFactory;
@@ -390,17 +316,11 @@ declare class TestSuiteOrchestrator {
   private runOneCase;
   private deriveSuiteStatus;
   private now;
-  /** Defensive label resolver — author-supplied callbacks throw / return non-strings; we tolerate both. */
   private resolveCaseLabel;
   private publish;
 }
 //#endregion
 //#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,
- * and intent-surface wiring so hosts only override the seams they actually replace.
- */
 declare class EngineRuntimeRegistrar {
   register(container: DependencyContainer, options?: EngineRuntimeRegistrationOptions): void;
   private registerAgentMcpIntegration;
@@ -421,13 +341,7 @@ declare class MissingRuntimeTriggerToken {}
 declare class PersistedWorkflowTokenRegistry {
   private readonly tokensById;
   private readonly tokenIdsByToken;
-  /**
-   * Register a token with its package ID. Token ID is inferred as `packageId::tokenName`.
-   */
   register(type: TypeToken<unknown>, packageId: string, persistedNameOverride?: string): PersistedTokenId;
-  /**
-   * Register all decorated runtime types discovered in workflows.
-   */
   registerFromWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
   private registerDecoratedType;
   private registerNestedTypes;
@@ -437,5 +351,17 @@ declare class PersistedWorkflowTokenRegistry {
   resolve(tokenId: PersistedTokenId): TypeToken<unknown> | undefined;
 }
 //#endregion
-export { AbortControllerFactory, type AsyncSleeper, CatalogBackedCostTrackingTelemetryFactory, ConfigDrivenOffloadPolicy, CredentialResolverFactory, DefaultAsyncSleeper, DefaultDrivingScheduler, DefaultExecutionBinaryService, DefaultExecutionContextFactory, ENGINE_EXECUTION_LIMITS_DEFAULTS, Engine, type EngineCompositionDeps, EngineExecutionLimitsPolicy, type EngineExecutionLimitsPolicyConfig, EngineExecutionLimitsPolicyFactory, EngineFactory, EngineRuntimeRegistrar, type EngineRuntimeRegistrationOptions, EngineWorkflowRunnerService, HintOnlyOffloadPolicy, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryWorkflowExecutionRepository, InProcessRetryRunner, InlineDrivingScheduler, LocalOnlyScheduler, MissingRuntimeTriggerToken, NodeExecutor, NodeInstanceFactory, PersistedWorkflowTokenRegistry, RunIntentService, RunPolicySnapshotFactory, RunSummaryMapper, RunTerminalPersistenceCoordinator, type RunTestSuiteArgs, StaticCostCatalog, type TestSuiteCaseOutcome, TestSuiteOrchestrator, type TestSuiteOrchestratorEngine, TestSuiteRunIdFactory, type TestSuiteRunResult, type TriggerRuntimeDiagnosticsProvider, UnavailableBinaryStorage, type WebhookTriggerMatcherProvider, WorkflowPolicyErrorServices, WorkflowRepositoryWebhookTriggerMatcher, WorkflowStoragePolicyEvaluator };
+//#region src/workflowSnapshots/WorkflowParityMismatchError.d.ts
+type MissingRuntimeNodeDetail = {
+  nodeId: NodeId;
+  kind: "node" | "trigger";
+  missingTokenId: string | undefined;
+};
+declare class WorkflowParityMismatchError extends Error {
+  readonly name = "WorkflowParityMismatchError";
+  readonly missingNodes: ReadonlyArray<MissingRuntimeNodeDetail>;
+  constructor(missingNodes: ReadonlyArray<MissingRuntimeNodeDetail>);
+}
+//#endregion
+export { AbortControllerFactory, type AsyncSleeper, CatalogBackedCostTrackingTelemetryFactory, ConfigDrivenOffloadPolicy, CredentialResolverFactory, DefaultAsyncSleeper, DefaultDrivingScheduler, DefaultExecutionBinaryService, DefaultExecutionContextFactory, ENGINE_EXECUTION_LIMITS_DEFAULTS, Engine, type EngineCompositionDeps, EngineExecutionLimitsPolicy, type EngineExecutionLimitsPolicyConfig, EngineExecutionLimitsPolicyFactory, EngineFactory, EngineRuntimeRegistrar, type EngineRuntimeRegistrationOptions, EngineWorkflowRunnerService, HintOnlyOffloadPolicy, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryWorkflowExecutionRepository, InProcessRetryRunner, InlineDrivingScheduler, LocalOnlyScheduler, type MissingRuntimeNodeDetail, MissingRuntimeParityGuard, MissingRuntimeTriggerToken, NodeExecutor, NodeInstanceFactory, PersistedWorkflowTokenRegistry, RunIntentService, RunPolicySnapshotFactory, RunSummaryMapper, RunTerminalPersistenceCoordinator, type RunTestSuiteArgs, StaticCostCatalog, type TestSuiteCaseOutcome, TestSuiteOrchestrator, type TestSuiteOrchestratorEngine, TestSuiteRunIdFactory, type TestSuiteRunResult, type TriggerRuntimeDiagnosticsProvider, UnavailableBinaryStorage, type WebhookTriggerMatcherProvider, WorkflowParityMismatchError, WorkflowPolicyErrorServices, WorkflowRepositoryWebhookTriggerMatcher, WorkflowSnapshotCodec, WorkflowStoragePolicyEvaluator };
 //# sourceMappingURL=index.d.cts.map

package/dist/bootstrap/index.d.ts

@@ -1,15 +1,10 @@
-import { Bn as ENGINE_EXECUTION_LIMITS_DEFAULTS, Cn as DependencyContainer, Hn as EngineExecutionLimitsPolicyConfig, On as TypeToken, Oo as PersistedTokenId, Vn as EngineExecutionLimitsPolicy, zr as WorkflowDefinition } from "../index-rllWL4r-.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-DYpqfu6D.js";
-import { A as WorkflowRepositoryWebhookTriggerMatcher, B as InlineDrivingScheduler, F as InMemoryRunDataFactory, H as StaticCostCatalog, I as InMemoryBinaryStorage, J as InProcessRetryRunner, L as LocalOnlyScheduler, M as EngineFactory, N as RunSummaryMapper, P as InMemoryWorkflowExecutionRepository, Q as AsyncSleeper, R as HintOnlyOffloadPolicy, U as NodeInstanceFactory, V as ConfigDrivenOffloadPolicy, W as NodeExecutor, X as DefaultExecutionContextFactory, Y as CatalogBackedCostTrackingTelemetryFactory, Z as DefaultAsyncSleeper, a as TestSuiteRunResult, an as AbortControllerFactory, et as DefaultExecutionBinaryService, i as TestSuiteOrchestratorEngine, in as CredentialResolverFactory, j as EngineCompositionDeps, n as TestSuiteCaseOutcome, o as TestSuiteRunIdFactory, r as TestSuiteOrchestrator, t as RunTestSuiteArgs, tt as UnavailableBinaryStorage, z as DefaultDrivingScheduler } from "../index-BSQ2LoIh.js";
-import "../ItemsInputNormalizer-BYljnXU0.js";
-import { n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-Cr75cSfL.js";
+import { Jo as PersistedTokenId, Ko as NodeId, Rn as DependencyContainer, Un as TypeToken, ir as EngineExecutionLimitsPolicyConfig, ni as WorkflowDefinition, nr as ENGINE_EXECUTION_LIMITS_DEFAULTS, rr as EngineExecutionLimitsPolicy } from "../index-CRv3_pY3.js";
+import { a as RunPolicySnapshotFactory, c as RunTerminalPersistenceCoordinator, i as WorkflowSnapshotCodec, l as WorkflowStoragePolicyEvaluator, n as InMemoryLiveWorkflowRepository, o as EngineExecutionLimitsPolicyFactory, r as EngineWorkflowRunnerService, s as WorkflowPolicyErrorServices, t as RunIntentService, u as Engine } from "../RunIntentService-DrpKli2k.js";
+import { $ as DefaultExecutionContextFactory, B as LocalOnlyScheduler, F as EngineFactory, G as StaticCostCatalog, H as DefaultDrivingScheduler, I as RunSummaryMapper, K as NodeInstanceFactory, L as InMemoryWorkflowExecutionRepository, N as WorkflowRepositoryWebhookTriggerMatcher, P as EngineCompositionDeps, Q as CatalogBackedCostTrackingTelemetryFactory, R as InMemoryRunDataFactory, U as InlineDrivingScheduler, V as HintOnlyOffloadPolicy, W as ConfigDrivenOffloadPolicy, Z as InProcessRetryRunner, a as TestSuiteRunResult, cn as AbortControllerFactory, et as DefaultAsyncSleeper, i as TestSuiteOrchestratorEngine, it as UnavailableBinaryStorage, n as TestSuiteCaseOutcome, o as TestSuiteRunIdFactory, q as NodeExecutor, r as TestSuiteOrchestrator, rt as DefaultExecutionBinaryService, s as MissingRuntimeParityGuard, sn as CredentialResolverFactory, t as RunTestSuiteArgs, tt as AsyncSleeper, z as InMemoryBinaryStorage } from "../index-mnLS0iQl.js";
+import "../ItemsInputNormalizer-D2vrMrX1.js";
+import { n as TriggerRuntimeDiagnosticsProvider, r as WebhookTriggerMatcherProvider, t as EngineRuntimeRegistrationOptions } from "../EngineRuntimeRegistration.types-Dq4ucrdo.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,
- * and intent-surface wiring so hosts only override the seams they actually replace.
- */
 declare class EngineRuntimeRegistrar {
   register(container: DependencyContainer, options?: EngineRuntimeRegistrationOptions): void;
   private registerAgentMcpIntegration;
@@ -30,13 +25,7 @@ declare class MissingRuntimeTriggerToken {}
 declare class PersistedWorkflowTokenRegistry {
   private readonly tokensById;
   private readonly tokenIdsByToken;
-  /**
-   * Register a token with its package ID. Token ID is inferred as `packageId::tokenName`.
-   */
   register(type: TypeToken<unknown>, packageId: string, persistedNameOverride?: string): PersistedTokenId;
-  /**
-   * Register all decorated runtime types discovered in workflows.
-   */
   registerFromWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
   private registerDecoratedType;
   private registerNestedTypes;
@@ -46,5 +35,17 @@ declare class PersistedWorkflowTokenRegistry {
   resolve(tokenId: PersistedTokenId): TypeToken<unknown> | undefined;
 }
 //#endregion
-export { AbortControllerFactory, type AsyncSleeper, CatalogBackedCostTrackingTelemetryFactory, ConfigDrivenOffloadPolicy, CredentialResolverFactory, DefaultAsyncSleeper, DefaultDrivingScheduler, DefaultExecutionBinaryService, DefaultExecutionContextFactory, ENGINE_EXECUTION_LIMITS_DEFAULTS, Engine, type EngineCompositionDeps, EngineExecutionLimitsPolicy, type EngineExecutionLimitsPolicyConfig, EngineExecutionLimitsPolicyFactory, EngineFactory, EngineRuntimeRegistrar, type EngineRuntimeRegistrationOptions, EngineWorkflowRunnerService, HintOnlyOffloadPolicy, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryWorkflowExecutionRepository, InProcessRetryRunner, InlineDrivingScheduler, LocalOnlyScheduler, MissingRuntimeTriggerToken, NodeExecutor, NodeInstanceFactory, PersistedWorkflowTokenRegistry, RunIntentService, RunPolicySnapshotFactory, RunSummaryMapper, RunTerminalPersistenceCoordinator, type RunTestSuiteArgs, StaticCostCatalog, type TestSuiteCaseOutcome, TestSuiteOrchestrator, type TestSuiteOrchestratorEngine, TestSuiteRunIdFactory, type TestSuiteRunResult, type TriggerRuntimeDiagnosticsProvider, UnavailableBinaryStorage, type WebhookTriggerMatcherProvider, WorkflowPolicyErrorServices, WorkflowRepositoryWebhookTriggerMatcher, WorkflowStoragePolicyEvaluator };
+//#region src/workflowSnapshots/WorkflowParityMismatchError.d.ts
+type MissingRuntimeNodeDetail = {
+  nodeId: NodeId;
+  kind: "node" | "trigger";
+  missingTokenId: string | undefined;
+};
+declare class WorkflowParityMismatchError extends Error {
+  readonly name = "WorkflowParityMismatchError";
+  readonly missingNodes: ReadonlyArray<MissingRuntimeNodeDetail>;
+  constructor(missingNodes: ReadonlyArray<MissingRuntimeNodeDetail>);
+}
+//#endregion
+export { AbortControllerFactory, type AsyncSleeper, CatalogBackedCostTrackingTelemetryFactory, ConfigDrivenOffloadPolicy, CredentialResolverFactory, DefaultAsyncSleeper, DefaultDrivingScheduler, DefaultExecutionBinaryService, DefaultExecutionContextFactory, ENGINE_EXECUTION_LIMITS_DEFAULTS, Engine, type EngineCompositionDeps, EngineExecutionLimitsPolicy, type EngineExecutionLimitsPolicyConfig, EngineExecutionLimitsPolicyFactory, EngineFactory, EngineRuntimeRegistrar, type EngineRuntimeRegistrationOptions, EngineWorkflowRunnerService, HintOnlyOffloadPolicy, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryWorkflowExecutionRepository, InProcessRetryRunner, InlineDrivingScheduler, LocalOnlyScheduler, type MissingRuntimeNodeDetail, MissingRuntimeParityGuard, MissingRuntimeTriggerToken, NodeExecutor, NodeInstanceFactory, PersistedWorkflowTokenRegistry, RunIntentService, RunPolicySnapshotFactory, RunSummaryMapper, RunTerminalPersistenceCoordinator, type RunTestSuiteArgs, StaticCostCatalog, type TestSuiteCaseOutcome, TestSuiteOrchestrator, type TestSuiteOrchestratorEngine, TestSuiteRunIdFactory, type TestSuiteRunResult, type TriggerRuntimeDiagnosticsProvider, UnavailableBinaryStorage, type WebhookTriggerMatcherProvider, WorkflowParityMismatchError, WorkflowPolicyErrorServices, WorkflowRepositoryWebhookTriggerMatcher, WorkflowSnapshotCodec, WorkflowStoragePolicyEvaluator };
 //# sourceMappingURL=index.d.ts.map

package/dist/bootstrap/index.js

@@ -1,6 +1,7 @@
-import "../di-tom0pM2h.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-CWPdvJpC.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-Bkd-Nfbn.js";
+import "../workflowTypes-DZtBTmKf.js";
+import "../di-Cjiil7U-.js";
+import { a as WorkflowSnapshotCodec, o as PersistedWorkflowTokenRegistry } from "../contracts-CjJ5CZ7N.js";
+import { A as WorkflowParityMismatchError, 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, k as MissingRuntimeParityGuard, 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-CBFDpmiz.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-DmqKheCI.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 };
+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, MissingRuntimeParityGuard, MissingRuntimeTriggerToken, NodeExecutor, NodeInstanceFactory, PersistedWorkflowTokenRegistry, RunIntentService, RunPolicySnapshotFactory, RunSummaryMapper, RunTerminalPersistenceCoordinator, StaticCostCatalog, TestSuiteOrchestrator, TestSuiteRunIdFactory, UnavailableBinaryStorage, WorkflowParityMismatchError, WorkflowPolicyErrorServices, WorkflowRepositoryWebhookTriggerMatcher, WorkflowSnapshotCodec, WorkflowStoragePolicyEvaluator };

package/dist/{bootstrap-DIv-vloi.cjs → bootstrap-CTB53rEF.cjs}

@@ -1,17 +1,15 @@
-const require_di = require('./di-LP2qSHkY.cjs');
-const require_contracts = require('./contracts-CK0x6w_G.cjs');
-const require_runtime = require('./runtime-_VdHwGkJ.cjs');
-let zod = require("zod");
-zod = require_di.__toESM(zod);
+const require_di = require('./di-C6Ubf9o5.cjs');
+const require_workflowTypes = require('./workflowTypes-BW6Hhee7.cjs');
+const require_contracts = require('./contracts-7L1wJHdk.cjs');
+const require_runtime = require('./runtime-Due-FOZ2.cjs');
 let node_crypto = require("node:crypto");
 node_crypto = require_di.__toESM(node_crypto);
+let zod = require("zod");
+zod = require_di.__toESM(zod);
 let tsyringe = require("tsyringe");
 tsyringe = require_di.__toESM(tsyringe);
 
 //#region src/policies/executionLimits/EngineExecutionLimitsPolicyFactory.ts
-/**
-* Builds {@link EngineExecutionLimitsPolicy} by merging {@link ENGINE_EXECUTION_LIMITS_DEFAULTS} with optional `overrides` (e.g. host `runtime.engineExecutionLimits`).
-*/
 var EngineExecutionLimitsPolicyFactory = class {
 	create(overrides) {
 		return new require_runtime.EngineExecutionLimitsPolicy({
@@ -23,7 +21,6 @@ var EngineExecutionLimitsPolicyFactory = class {
 
 //#endregion
 //#region src/runStorage/RunSummaryMapper.ts
-/** Maps persisted run state to API run summaries for listings. */
 var RunSummaryMapper = class {
 	static fromPersistedState(state) {
 		return {
@@ -31,7 +28,7 @@ var RunSummaryMapper = class {
 			workflowId: state.workflowId,
 			startedAt: state.startedAt,
 			status: state.status,
-			finishedAt: require_di.RunFinishedAtFactory.resolveIso(state),
+			finishedAt: require_workflowTypes.RunFinishedAtFactory.resolveIso(state),
 			parent: state.parent,
 			executionOptions: state.executionOptions
 		};
@@ -91,7 +88,7 @@ var InMemoryWorkflowExecutionRepository = class {
 		const out = [];
 		for (const s of this.runs.values()) {
 			if (s.status !== "completed" && s.status !== "failed") continue;
-			const finishedAt = require_di.RunFinishedAtFactory.resolveIso(s);
+			const finishedAt = require_workflowTypes.RunFinishedAtFactory.resolveIso(s);
 			const retentionSeconds = s.policySnapshot?.retentionSeconds ?? args.defaultRetentionSeconds;
 			const cutoffIso = (/* @__PURE__ */ new Date(new Date(args.nowIso).getTime() - retentionSeconds * 1e3)).toISOString();
 			if (!finishedAt || finishedAt >= cutoffIso) continue;
@@ -109,10 +106,6 @@ var InMemoryWorkflowExecutionRepository = class {
 
 //#endregion
 //#region src/orchestration/AbortControllerFactory.ts
-/**
-* Mints fresh {@link AbortController}s. Injected (rather than direct `new`) to honor the
-* codebase's no-direct-construction rule and to give tests a seam for substituting a fake.
-*/
 var AbortControllerFactory = class {
 	create() {
 		return new AbortController();
@@ -122,15 +115,6 @@ var AbortControllerFactory = class {
 //#endregion
 //#region src/orchestration/TestSuiteOrchestrator.ts
 const DEFAULT_CONCURRENCY = 4;
-/**
-* Drives a {@link TestTriggerNodeConfig.generateItems} iterable into one workflow run per item,
-* with bounded concurrency. Pure engine logic — no persistence, no HTTP, no UI. Hosts adapt by
-* subscribing to {@link RunEventBus} and writing rows on `testSuite*` / `testCase*` / `nodeCompleted`.
-*
-* Cancellation: the supplied `AbortSignal` aborts the source iterable (so credentialed pulls bail)
-* and stops scheduling further cases. In-flight cases are awaited; engine-level cancellation of
-* an already-dispatched run is not yet wired (Phase 2).
-*/
 var TestSuiteOrchestrator = class {
 	constructor(engine, testSuiteRunIdFactory, credentialResolverFactory, abortControllerFactory, eventBus, currentDate = () => /* @__PURE__ */ new Date()) {
 		this.engine = engine;
@@ -307,7 +291,6 @@ var TestSuiteOrchestrator = class {
 	now() {
 		return this.currentDate().toISOString();
 	}
-	/** Defensive label resolver — author-supplied callbacks throw / return non-strings; we tolerate both. */
 	resolveCaseLabel(config, item) {
 		if (typeof config.caseLabel !== "function") return void 0;
 		try {
@@ -327,10 +310,6 @@ var TestSuiteOrchestrator = class {
 
 //#endregion
 //#region src/orchestration/TestSuiteRunIdFactory.ts
-/**
-* Mints unique TestSuiteRun identifiers. Separated from {@link import("../types").RunIdFactory}
-* so suite ids and per-case workflow run ids never alias.
-*/
 var TestSuiteRunIdFactory = class {
 	makeTestSuiteRunId() {
 		return `tsr_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
@@ -339,26 +318,6 @@ var TestSuiteRunIdFactory = class {
 
 //#endregion
 //#region src/execution/NodeSuspensionHandler.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.
-*/
 var NodeSuspensionHandler = class {
 	constructor(workflowExecutionRepository, humanTaskStore, tokenSigner, timeoutScheduler, workspaceId) {
 		this.workflowExecutionRepository = workflowExecutionRepository;
@@ -464,11 +423,6 @@ var NodeSuspensionHandler = class {
 		await this.workflowExecutionRepository.save(updatedState);
 		throw new require_runtime.RunSuspendedError(args.runId, taskId);
 	}
-	/**
-	* Parse a duration string into milliseconds.
-	* Accepts ISO 8601 durations ("PT24H", "PT30M") and shorthand ("24h", "30m", "1d").
-	* Throws for unrecognised formats.
-	*/
 	parseDurationMs(duration) {
 		const shorthand = /^(\d+(?:\.\d+)?)(s|m|h|d)$/i.exec(duration);
 		if (shorthand) return parseFloat(shorthand[1]) * {
@@ -508,11 +462,6 @@ var InlineDrivingSchedulerFactory = class {
 
 //#endregion
 //#region src/bootstrap/runtime/EngineRuntimeRegistrar.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,
-* and intent-surface wiring so hosts only override the seams they actually replace.
-*/
 var EngineRuntimeRegistrar = class {
 	register(container, options) {
 		this.registerSupportFactories(container);
@@ -672,4 +621,4 @@ Object.defineProperty(exports, 'TestSuiteRunIdFactory', {
     return TestSuiteRunIdFactory;
   }
 });
-//# sourceMappingURL=bootstrap-DIv-vloi.cjs.map
+//# sourceMappingURL=bootstrap-CTB53rEF.cjs.map