@codemation/core 0.2.1 → 0.2.3

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":["prefix: string","makeRunIdValue: () => string","makeActivationIdValue: () => string","name: string","args: Readonly<{\n      workflowId: WorkflowId;\n      startAt?: NodeId;\n      id?: string;\n      execution?: Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }>;\n    }>","workflows: WorkflowRunnerService","out: Item[]","name: string","id?: string","container","tsyringeContainer","runToCompletion: RegistrarEngineTestKitHandle[\"runToCompletion\"]","runIntentStartToCompletion: RegistrarEngineTestKitHandle[\"runIntentStartToCompletion\"]"],"sources":["../src/testing/RejectingCredentialSessionService.ts","../src/testing/CapturingScheduler.ts","../src/testing/PrefixedSequentialIdGenerator.ts","../src/testing/EngineTestKitRunIdFactory.ts","../src/testing/InMemoryTriggerSetupStateRepository.ts","../src/testing/SubWorkflowRunnerTestNode.ts","../src/testing/WorkflowTestHarnessManualTrigger.ts","../src/testing/RegistrarEngineTestKitFactory.ts","../src/testing/WorkflowTestKitNodeRegistrationContextFactory.ts","../src/testing/WorkflowTestKitRunNodeWorkflowFactory.ts","../src/testing/WorkflowTestKitBuilder.ts"],"sourcesContent":["import type { CredentialSessionService } from \"../contracts/credentialTypes\";\n\n/**\n * Test harness default: rejects any credential lookup so missing bindings fail loudly.\n * Prefer registering a real {@link CredentialSessionService} in integration scenarios.\n */\nexport class RejectingCredentialSessionService implements CredentialSessionService {\n  async getSession<TSession = unknown>(\n    args: Readonly<{ workflowId: string; nodeId: string; slotKey: string }>,\n  ): Promise<TSession> {\n    throw new Error(\n      `Credential sessions are unavailable for workflow ${args.workflowId} node ${args.nodeId} slot \"${args.slotKey}\". Register a real CredentialSessionService implementation before executing workflows.`,\n    );\n  }\n}\n","import type { NodeExecutionRequest, NodeExecutionScheduler } from \"../types\";\n\n/**\n * Test scheduler that records enqueue requests without executing a real queue.\n */\nexport class CapturingScheduler implements NodeExecutionScheduler {\n  lastRequest: NodeExecutionRequest | undefined;\n  requests: NodeExecutionRequest[] = [];\n\n  async enqueue(request: NodeExecutionRequest): Promise<{ receiptId: string }> {\n    this.lastRequest = request;\n    this.requests.push(request);\n    return { receiptId: `receipt_${this.requests.length}` };\n  }\n}\n","/**\n * Deterministic `run_1`, `act_1`-style ids for test harness factories.\n */\nexport class PrefixedSequentialIdGenerator {\n  private n = 0;\n\n  constructor(private readonly prefix: string) {}\n\n  next(): string {\n    this.n += 1;\n    return `${this.prefix}${this.n}`;\n  }\n\n  asFn(): () => string {\n    return () => this.next();\n  }\n}\n","import type { RunIdFactory } from \"../types\";\n\n/**\n * @internal Test harness id factory shared by registrar kit wiring.\n */\nexport class EngineTestKitRunIdFactory implements RunIdFactory {\n  private runCounter = 0;\n  private activationCounter = 0;\n\n  constructor(\n    private readonly makeRunIdValue: () => string,\n    private readonly makeActivationIdValue: () => string,\n  ) {}\n\n  makeRunId(): string {\n    this.runCounter += 1;\n    return this.makeRunIdValue();\n  }\n\n  makeActivationId(): string {\n    this.activationCounter += 1;\n    return this.makeActivationIdValue();\n  }\n}\n","import type { PersistedTriggerSetupState, TriggerSetupStateRepository } from \"../types\";\n\nexport class InMemoryTriggerSetupStateRepository implements TriggerSetupStateRepository {\n  private readonly statesByKey = new Map<string, PersistedTriggerSetupState>();\n\n  async load(trigger: { workflowId: string; nodeId: string }): Promise<PersistedTriggerSetupState | undefined> {\n    return this.statesByKey.get(this.toKey(trigger));\n  }\n\n  async save(state: PersistedTriggerSetupState): Promise<void> {\n    this.statesByKey.set(this.toKey(state.trigger), state);\n  }\n\n  async delete(trigger: { workflowId: string; nodeId: string }): Promise<void> {\n    this.statesByKey.delete(this.toKey(trigger));\n  }\n\n  private toKey(trigger: { workflowId: string; nodeId: string }): string {\n    return `${trigger.workflowId}:${trigger.nodeId}`;\n  }\n}\n","/* eslint-disable codemation/single-class-per-file -- Runnable config and implementation share a TypeToken pairing. */\nimport type { WorkflowRunnerService } from \"../contracts/runtimeTypes\";\nimport type { TypeToken } from \"../di\";\nimport type {\n  Item,\n  Items,\n  NodeExecutionContext,\n  NodeId,\n  NodeOutputs,\n  Node,\n  RunnableNodeConfig,\n  WorkflowId,\n} from \"../types\";\n\n/**\n * Test harness subworkflow runner (mirrors integration patterns; lives under {@link \"@codemation/core/testing\"}).\n */\nexport class SubWorkflowRunnerConfig<TInputJson = unknown, TOutputJson = unknown> implements RunnableNodeConfig<\n  TInputJson,\n  TOutputJson\n> {\n  readonly kind = \"node\" as const;\n  readonly type: TypeToken<unknown> = SubWorkflowRunnerNode;\n\n  constructor(\n    public readonly name: string,\n    public readonly args: Readonly<{\n      workflowId: WorkflowId;\n      startAt?: NodeId;\n      id?: string;\n      execution?: Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }>;\n    }>,\n  ) {}\n\n  get id(): string | undefined {\n    return this.args.id;\n  }\n\n  get execution(): Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }> | undefined {\n    return this.args.execution;\n  }\n\n  get workflowId(): WorkflowId {\n    return this.args.workflowId;\n  }\n\n  get startAt(): NodeId | undefined {\n    return this.args.startAt;\n  }\n}\n\nexport class SubWorkflowRunnerNode implements Node<SubWorkflowRunnerConfig<any, any>> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  constructor(private readonly workflows: WorkflowRunnerService) {}\n\n  async execute(items: Items, ctx: NodeExecutionContext<SubWorkflowRunnerConfig<any, any>>): Promise<NodeOutputs> {\n    const out: Item[] = [];\n    for (let i = 0; i < items.length; i++) {\n      const current = items[i]!;\n      const result = await this.workflows.runById({\n        workflowId: ctx.config.workflowId,\n        startAt: ctx.config.startAt,\n        items: [current],\n        parent: {\n          runId: ctx.runId,\n          workflowId: ctx.workflowId,\n          nodeId: ctx.nodeId,\n          subworkflowDepth: ctx.subworkflowDepth,\n          engineMaxNodeActivations: ctx.engineMaxNodeActivations,\n          engineMaxSubworkflowDepth: ctx.engineMaxSubworkflowDepth,\n        },\n      });\n      if (result.status !== \"completed\") {\n        throw new Error(`Subworkflow ${ctx.config.workflowId} did not complete (status=${result.status})`);\n      }\n      out.push(...result.outputs);\n    }\n\n    return { main: out };\n  }\n}\n","/* eslint-disable codemation/single-class-per-file -- Trigger config and implementation share a TypeToken pairing. */\nimport type { TypeToken } from \"../di\";\nimport type {\n  Items,\n  NodeExecutionContext,\n  NodeOutputs,\n  TriggerNode,\n  TriggerNodeConfig,\n  TriggerSetupContext,\n} from \"../types\";\n\n/**\n * Minimal pass-through manual trigger for {@link WorkflowTestKit.runNode}; emits input items unchanged.\n */\nexport class WorkflowTestHarnessManualTriggerConfig implements TriggerNodeConfig<unknown> {\n  readonly kind = \"trigger\" as const;\n  readonly type: TypeToken<unknown> = WorkflowTestHarnessManualTriggerNode;\n\n  constructor(\n    public readonly name: string,\n    public readonly id?: string,\n  ) {}\n}\n\nexport class WorkflowTestHarnessManualTriggerNode implements TriggerNode<WorkflowTestHarnessManualTriggerConfig> {\n  readonly kind = \"trigger\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  async setup(_ctx: TriggerSetupContext<WorkflowTestHarnessManualTriggerConfig>): Promise<undefined> {\n    return undefined;\n  }\n\n  async execute(\n    items: Items,\n    _ctx: NodeExecutionContext<WorkflowTestHarnessManualTriggerConfig>,\n  ): Promise<NodeOutputs> {\n    return { main: items };\n  }\n}\n","import type { DependencyContainer, InjectionToken } from \"tsyringe\";\nimport { container as tsyringeContainer } from \"tsyringe\";\n\nimport type { WorkflowRunnerService } from \"../contracts/runtimeTypes\";\nimport { CoreTokens } from \"../di\";\nimport { InMemoryRunEventBus } from \"../events/InMemoryRunEventBusRegistry\";\nimport { AllWorkflowsActiveWorkflowActivationPolicy } from \"../contracts/workflowActivationPolicy\";\nimport { RunIntentService } from \"../runtime/RunIntentService\";\nimport {\n  DefaultDrivingScheduler,\n  DefaultAsyncSleeper,\n  DefaultExecutionContextFactory,\n  Engine,\n  EngineRuntimeRegistrar,\n  EngineWorkflowRunnerService,\n  HintOnlyOffloadPolicy,\n  InProcessRetryRunner,\n  InMemoryRunDataFactory,\n  InMemoryWorkflowExecutionRepository,\n  InlineDrivingScheduler,\n  NodeExecutor,\n  NodeInstanceFactory,\n  PersistedWorkflowTokenRegistry,\n} from \"../bootstrap/index\";\nimport { InMemoryLiveWorkflowRepository } from \"../runtime/InMemoryLiveWorkflowRepository\";\nimport { EngineTestKitRunIdFactory } from \"./EngineTestKitRunIdFactory\";\nimport { InMemoryTriggerSetupStateRepository } from \"./InMemoryTriggerSetupStateRepository\";\nimport { RejectingCredentialSessionService } from \"./RejectingCredentialSessionService\";\nimport { CapturingScheduler } from \"./CapturingScheduler\";\nimport { PrefixedSequentialIdGenerator } from \"./PrefixedSequentialIdGenerator\";\nimport type { RegistrarEngineTestKitHandle, RegistrarEngineTestKitOptions } from \"./RegistrarEngineTestKit.types\";\nimport { SubWorkflowRunnerNode } from \"./SubWorkflowRunnerTestNode\";\nimport { WorkflowTestHarnessManualTriggerNode } from \"./WorkflowTestHarnessManualTrigger\";\n\nexport class RegistrarEngineTestKitFactory {\n  static create(options: RegistrarEngineTestKitOptions = {}): RegistrarEngineTestKitHandle {\n    const runStore = options.runStore ?? new InMemoryWorkflowExecutionRepository();\n    const scheduler = options.scheduler ?? new CapturingScheduler();\n    const offloadPolicy = options.offloadPolicy ?? new HintOnlyOffloadPolicy();\n    const runIdGen = new PrefixedSequentialIdGenerator(\"run_\");\n    const activationIdGen = new PrefixedSequentialIdGenerator(\"act_\");\n    const makeRunId = options.makeRunId ?? runIdGen.asFn();\n    const makeActivationId = options.makeActivationId ?? activationIdGen.asFn();\n    const credentialSessions = options.credentialSessions ?? new RejectingCredentialSessionService();\n    const eventBus = options.eventBus ?? new InMemoryRunEventBus();\n    const triggerSetupStateRepository =\n      options.triggerSetupStateRepository ?? new InMemoryTriggerSetupStateRepository();\n    const liveWorkflowRepository = new InMemoryLiveWorkflowRepository();\n    const runDataFactory = options.runDataFactory ?? new InMemoryRunDataFactory();\n    const executionContextFactory = options.executionContextFactory ?? new DefaultExecutionContextFactory();\n    const container = options.container ?? tsyringeContainer.createChildContainer();\n    const dependencyContainer = container as DependencyContainer;\n    const nodeResolver = container;\n    const nodeExecutor = new NodeExecutor(\n      new NodeInstanceFactory(nodeResolver),\n      new InProcessRetryRunner(new DefaultAsyncSleeper()),\n    );\n    const activationScheduler = new DefaultDrivingScheduler(\n      offloadPolicy,\n      scheduler,\n      new InlineDrivingScheduler(nodeExecutor),\n    );\n\n    for (const [token, value] of options.providers ?? new Map<InjectionToken<unknown>, unknown>()) {\n      dependencyContainer.registerInstance(token, value);\n    }\n\n    dependencyContainer.registerInstance(CoreTokens.CredentialSessionService, credentialSessions);\n    dependencyContainer.registerInstance(CoreTokens.LiveWorkflowRepository, liveWorkflowRepository);\n    dependencyContainer.registerInstance(CoreTokens.WorkflowRepository, liveWorkflowRepository);\n    dependencyContainer.registerInstance(CoreTokens.NodeResolver, nodeResolver);\n    dependencyContainer.registerInstance(\n      CoreTokens.RunIdFactory,\n      new EngineTestKitRunIdFactory(makeRunId, makeActivationId),\n    );\n    dependencyContainer.registerInstance(\n      CoreTokens.ActivationIdFactory,\n      new EngineTestKitRunIdFactory(makeRunId, makeActivationId),\n    );\n    dependencyContainer.registerInstance(CoreTokens.WebhookBasePath, options.webhookBasePath ?? \"/webhooks\");\n    dependencyContainer.registerInstance(CoreTokens.WorkflowExecutionRepository, runStore);\n    dependencyContainer.registerInstance(CoreTokens.TriggerSetupStateRepository, triggerSetupStateRepository);\n    dependencyContainer.registerInstance(CoreTokens.NodeActivationScheduler, activationScheduler);\n    dependencyContainer.registerInstance(CoreTokens.RunDataFactory, runDataFactory);\n    dependencyContainer.registerInstance(CoreTokens.ExecutionContextFactory, executionContextFactory);\n    dependencyContainer.registerInstance(CoreTokens.RunEventBus, eventBus);\n    dependencyContainer.registerInstance(\n      CoreTokens.PersistedWorkflowTokenRegistry,\n      new PersistedWorkflowTokenRegistry(),\n    );\n    dependencyContainer.registerInstance(\n      CoreTokens.WorkflowActivationPolicy,\n      new AllWorkflowsActiveWorkflowActivationPolicy(),\n    );\n\n    if (options.executionLimitsPolicy !== undefined) {\n      dependencyContainer.registerInstance(CoreTokens.EngineExecutionLimitsPolicy, options.executionLimitsPolicy);\n    }\n\n    new EngineRuntimeRegistrar().register(dependencyContainer, options.registrarOptions ?? {});\n\n    const engine = dependencyContainer.resolve(Engine);\n    const runIntent = dependencyContainer.resolve(RunIntentService);\n    const workflowRunner =\n      options.workflowRunner ??\n      (dependencyContainer.resolve(CoreTokens.WorkflowRunnerService) as EngineWorkflowRunnerService);\n    dependencyContainer.registerInstance(\n      SubWorkflowRunnerNode,\n      new SubWorkflowRunnerNode(workflowRunner as WorkflowRunnerService),\n    );\n    dependencyContainer.registerInstance(\n      WorkflowTestHarnessManualTriggerNode,\n      new WorkflowTestHarnessManualTriggerNode(),\n    );\n\n    const start = async (workflows: ReadonlyArray<import(\"../types\").WorkflowDefinition>): Promise<void> => {\n      await engine.start([...workflows]);\n    };\n\n    const runToCompletion: RegistrarEngineTestKitHandle[\"runToCompletion\"] = async (args) => {\n      const r0 = await engine.runWorkflow(args.wf, args.startAt, args.items, args.parent);\n      if (r0.status !== \"pending\") return r0;\n      return await engine.waitForCompletion(r0.runId);\n    };\n\n    const runIntentStartToCompletion: RegistrarEngineTestKitHandle[\"runIntentStartToCompletion\"] = async (args) => {\n      const r0 = await runIntent.startWorkflow({\n        workflow: args.wf,\n        startAt: args.startAt,\n        items: args.items,\n        parent: args.parent,\n      });\n      if (r0.status !== \"pending\") return r0;\n      return await engine.waitForCompletion(r0.runId);\n    };\n\n    return {\n      engine,\n      runIntent,\n      liveWorkflowRepository,\n      runStore,\n      triggerSetupStateRepository,\n      scheduler: scheduler as CapturingScheduler | import(\"../types\").NodeExecutionScheduler,\n      offloadPolicy,\n      workflowRunner,\n      dependencyContainer,\n      start,\n      runToCompletion,\n      runIntentStartToCompletion,\n      makeRunId,\n      makeActivationId,\n    };\n  }\n}\n","import type { DependencyContainer } from \"tsyringe\";\n\nimport type { TypeToken } from \"../di\";\n\nimport type { DefinedNodeRegistrationContext } from \"./WorkflowTestKit.types\";\n\nexport class WorkflowTestKitNodeRegistrationContextFactory {\n  create(dependencyContainer: DependencyContainer): DefinedNodeRegistrationContext {\n    return {\n      registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>) {\n        dependencyContainer.register(token, {\n          useClass: (implementation ?? token) as never,\n        });\n      },\n    };\n  }\n}\n","import type { RunnableNodeConfig, WorkflowDefinition, WorkflowId } from \"../types\";\nimport { WorkflowBuilder } from \"../workflow/dsl/WorkflowBuilder\";\n\nimport { WorkflowTestHarnessManualTriggerConfig } from \"./WorkflowTestHarnessManualTrigger\";\n\nconst defaultInlineWorkflowId = \"codemation.testing.workflowkit.inline\" as WorkflowId;\nconst defaultInlineWorkflowName = \"WorkflowTestKit inline\";\n\n/**\n * Builds the minimal trigger → runnable workflow used by {@link import(\"./WorkflowTestKit\").WorkflowTestKit.runNode}.\n */\nexport class WorkflowTestKitRunNodeWorkflowFactory {\n  build(args: { node: RunnableNodeConfig; workflowId?: WorkflowId; workflowName?: string }): WorkflowDefinition {\n    const workflowId = args.workflowId ?? defaultInlineWorkflowId;\n    const workflowName = args.workflowName ?? defaultInlineWorkflowName;\n    const trigger = new WorkflowTestHarnessManualTriggerConfig(\n      \"WorkflowTestKit trigger\",\n      \"workflowkit.harness.trigger\",\n    );\n    return new WorkflowBuilder({ id: workflowId, name: workflowName }).trigger(trigger).then(args.node).build();\n  }\n\n  defaultStartNodeId(): string {\n    return \"workflowkit.harness.trigger\";\n  }\n}\n","import type { DependencyContainer } from \"tsyringe\";\n\nimport type { Items, NodeId, RunnableNodeConfig, RunResult, WorkflowDefinition, WorkflowId } from \"../types\";\n\nimport { RegistrarEngineTestKitFactory } from \"./RegistrarEngineTestKitFactory\";\nimport type { EngineTestKitOptions, RegistrarEngineTestKitHandle } from \"./RegistrarEngineTestKit.types\";\nimport { WorkflowTestKitNodeRegistrationContextFactory } from \"./WorkflowTestKitNodeRegistrationContextFactory\";\nimport type { DefinedNodeRegistration } from \"./WorkflowTestKit.types\";\nimport { WorkflowTestKitRunNodeWorkflowFactory } from \"./WorkflowTestKitRunNodeWorkflowFactory\";\n\nexport type { DefinedNodeRegistration, DefinedNodeRegistrationContext } from \"./WorkflowTestKit.types\";\n\nexport type WorkflowTestKitOptions = EngineTestKitOptions;\n\nexport class WorkflowTestKit {\n  private readonly handle: RegistrarEngineTestKitHandle;\n  private readonly runNodeWorkflowFactory = new WorkflowTestKitRunNodeWorkflowFactory();\n  private readonly nodeRegistrationContextFactory = new WorkflowTestKitNodeRegistrationContextFactory();\n\n  constructor(options: WorkflowTestKitOptions = {}) {\n    this.handle = RegistrarEngineTestKitFactory.create(options);\n  }\n\n  get dependencyContainer(): DependencyContainer {\n    return this.handle.dependencyContainer;\n  }\n\n  get engine(): RegistrarEngineTestKitHandle[\"engine\"] {\n    return this.handle.engine;\n  }\n\n  get workflowRunner(): RegistrarEngineTestKitHandle[\"workflowRunner\"] {\n    return this.handle.workflowRunner;\n  }\n\n  get liveWorkflowRepository(): RegistrarEngineTestKitHandle[\"liveWorkflowRepository\"] {\n    return this.handle.liveWorkflowRepository;\n  }\n\n  get runStore(): RegistrarEngineTestKitHandle[\"runStore\"] {\n    return this.handle.runStore;\n  }\n\n  /**\n   * Registers {@link import(\"../authoring/defineNode.types\").DefinedNode} implementations on the same DI container used by the engine\n   * (same pattern as `plugin.register({ registerNode })` in the host).\n   */\n  registerDefinedNodes(definitions: ReadonlyArray<DefinedNodeRegistration>): void {\n    const ctx = this.nodeRegistrationContextFactory.create(this.handle.dependencyContainer);\n    for (const def of definitions) {\n      def.register(ctx);\n    }\n  }\n\n  async run(args: { workflow: WorkflowDefinition; items: Items; startAt?: NodeId }): Promise<RunResult> {\n    await this.handle.start([args.workflow]);\n    return await this.handle.workflowRunner.runById({\n      workflowId: args.workflow.id,\n      startAt: args.startAt,\n      items: args.items,\n    });\n  }\n\n  async runNode(args: {\n    node: RunnableNodeConfig;\n    items: Items;\n    workflowId?: WorkflowId;\n    workflowName?: string;\n  }): Promise<RunResult> {\n    const wf = this.runNodeWorkflowFactory.build(args);\n    return await this.run({\n      workflow: wf,\n      items: args.items,\n      startAt: this.runNodeWorkflowFactory.defaultStartNodeId(),\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"testing.js","names":["name: string","inputSchema: ZodType<TIn>","runOne: (args: {\n      input: TIn;\n      item: Item<TWire>;\n      itemIndex: number;\n      items: Items<TWire>;\n      ctx: NodeExecutionContext<ItemHarnessNodeConfig<TIn, TOut, TWire>>;\n    }) => TOut | Promise<TOut>","opts: Readonly<{\n      id?: string;\n      mapInput?: ItemInputMapper<TWire, TIn>;\n    }>","prefix: string","makeRunIdValue: () => string","makeActivationIdValue: () => string","name: string","args: Readonly<{\n      workflowId: WorkflowId;\n      startAt?: NodeId;\n      id?: string;\n      execution?: Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }>;\n    }>","workflows: WorkflowRunnerService","out: Item[]","name: string","id?: string","container","tsyringeContainer","runToCompletion: RegistrarEngineTestKitHandle[\"runToCompletion\"]","runIntentStartToCompletion: RegistrarEngineTestKitHandle[\"runIntentStartToCompletion\"]"],"sources":["../src/testing/RejectingCredentialSessionService.ts","../src/testing/ItemHarnessNode.ts","../src/testing/ItemHarnessNodeConfig.ts","../src/testing/CapturingScheduler.ts","../src/testing/PrefixedSequentialIdGenerator.ts","../src/testing/EngineTestKitRunIdFactory.ts","../src/testing/InMemoryTriggerSetupStateRepository.ts","../src/testing/SubWorkflowRunnerTestNode.ts","../src/testing/WorkflowTestHarnessManualTrigger.ts","../src/testing/RegistrarEngineTestKitFactory.ts","../src/testing/WorkflowTestKitNodeRegistrationContextFactory.ts","../src/testing/WorkflowTestKitRunNodeWorkflowFactory.ts","../src/testing/WorkflowTestKitBuilder.ts"],"sourcesContent":["import type { CredentialSessionService } from \"../contracts/credentialTypes\";\n\n/**\n * Test harness default: rejects any credential lookup so missing bindings fail loudly.\n * Prefer registering a real {@link CredentialSessionService} in integration scenarios.\n */\nexport class RejectingCredentialSessionService implements CredentialSessionService {\n  async getSession<TSession = unknown>(\n    args: Readonly<{ workflowId: string; nodeId: string; slotKey: string }>,\n  ): Promise<TSession> {\n    throw new Error(\n      `Credential sessions are unavailable for workflow ${args.workflowId} node ${args.nodeId} slot \"${args.slotKey}\". Register a real CredentialSessionService implementation before executing workflows.`,\n    );\n  }\n}\n","import type { Item, ItemNode, Items, NodeExecutionContext } from \"../types\";\n\nimport type { ItemHarnessNodeConfig } from \"./ItemHarnessNodeConfig\";\n\n/**\n * Item-mode harness node for engine tests (see {@link ItemHarnessNodeConfig}).\n */\nexport class ItemHarnessNode implements ItemNode<ItemHarnessNodeConfig<any, any, any>, unknown, unknown> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  async executeOne(args: {\n    input: unknown;\n    item: Item;\n    itemIndex: number;\n    items: Items;\n    ctx: NodeExecutionContext<ItemHarnessNodeConfig<any, any, any>>;\n  }): Promise<unknown> {\n    return await args.ctx.config.runOne({\n      input: args.input as never,\n      item: args.item,\n      itemIndex: args.itemIndex,\n      items: args.items,\n      ctx: args.ctx,\n    });\n  }\n}\n","import type { ZodType } from \"zod\";\n\nimport type { TypeToken } from \"../di\";\nimport type { Item, ItemInputMapper, Items, NodeExecutionContext, RunnableNodeConfig } from \"../types\";\n\nimport { ItemHarnessNode } from \"./ItemHarnessNode\";\n\n/**\n * Item-mode harness node config for engine tests: engine applies {@link RunnableNodeConfig.inputSchema} +\n * optional {@link RunnableNodeConfig.mapInput}, then {@link ItemHarnessNode.executeOne} per item.\n */\nexport class ItemHarnessNodeConfig<TIn = unknown, TOut = unknown, TWire = TIn> implements RunnableNodeConfig<\n  TIn,\n  TOut,\n  TWire\n> {\n  readonly kind = \"node\" as const;\n  readonly type: TypeToken<unknown> = ItemHarnessNode;\n\n  constructor(\n    public readonly name: string,\n    public readonly inputSchema: ZodType<TIn>,\n    public readonly runOne: (args: {\n      input: TIn;\n      item: Item<TWire>;\n      itemIndex: number;\n      items: Items<TWire>;\n      ctx: NodeExecutionContext<ItemHarnessNodeConfig<TIn, TOut, TWire>>;\n    }) => TOut | Promise<TOut>,\n    public readonly opts: Readonly<{\n      id?: string;\n      mapInput?: ItemInputMapper<TWire, TIn>;\n    }> = {},\n  ) {}\n\n  get mapInput(): ItemInputMapper<TWire, TIn> | undefined {\n    return this.opts.mapInput;\n  }\n\n  get id(): string | undefined {\n    return this.opts.id;\n  }\n}\n","import type { NodeExecutionRequest, NodeExecutionScheduler } from \"../types\";\n\n/**\n * Test scheduler that records enqueue requests without executing a real queue.\n */\nexport class CapturingScheduler implements NodeExecutionScheduler {\n  lastRequest: NodeExecutionRequest | undefined;\n  requests: NodeExecutionRequest[] = [];\n\n  async enqueue(request: NodeExecutionRequest): Promise<{ receiptId: string }> {\n    this.lastRequest = request;\n    this.requests.push(request);\n    return { receiptId: `receipt_${this.requests.length}` };\n  }\n}\n","/**\n * Deterministic `run_1`, `act_1`-style ids for test harness factories.\n */\nexport class PrefixedSequentialIdGenerator {\n  private n = 0;\n\n  constructor(private readonly prefix: string) {}\n\n  next(): string {\n    this.n += 1;\n    return `${this.prefix}${this.n}`;\n  }\n\n  asFn(): () => string {\n    return () => this.next();\n  }\n}\n","import type { RunIdFactory } from \"../types\";\n\n/**\n * @internal Test harness id factory shared by registrar kit wiring.\n */\nexport class EngineTestKitRunIdFactory implements RunIdFactory {\n  private runCounter = 0;\n  private activationCounter = 0;\n\n  constructor(\n    private readonly makeRunIdValue: () => string,\n    private readonly makeActivationIdValue: () => string,\n  ) {}\n\n  makeRunId(): string {\n    this.runCounter += 1;\n    return this.makeRunIdValue();\n  }\n\n  makeActivationId(): string {\n    this.activationCounter += 1;\n    return this.makeActivationIdValue();\n  }\n}\n","import type { PersistedTriggerSetupState, TriggerSetupStateRepository } from \"../types\";\n\nexport class InMemoryTriggerSetupStateRepository implements TriggerSetupStateRepository {\n  private readonly statesByKey = new Map<string, PersistedTriggerSetupState>();\n\n  async load(trigger: { workflowId: string; nodeId: string }): Promise<PersistedTriggerSetupState | undefined> {\n    return this.statesByKey.get(this.toKey(trigger));\n  }\n\n  async save(state: PersistedTriggerSetupState): Promise<void> {\n    this.statesByKey.set(this.toKey(state.trigger), state);\n  }\n\n  async delete(trigger: { workflowId: string; nodeId: string }): Promise<void> {\n    this.statesByKey.delete(this.toKey(trigger));\n  }\n\n  private toKey(trigger: { workflowId: string; nodeId: string }): string {\n    return `${trigger.workflowId}:${trigger.nodeId}`;\n  }\n}\n","/* eslint-disable codemation/single-class-per-file -- Runnable config and implementation share a TypeToken pairing. */\nimport type { WorkflowRunnerService } from \"../contracts/runtimeTypes\";\nimport type { TypeToken } from \"../di\";\nimport type {\n  Item,\n  Items,\n  NodeExecutionContext,\n  NodeId,\n  NodeOutputs,\n  Node,\n  RunnableNodeConfig,\n  WorkflowId,\n} from \"../types\";\n\n/**\n * Test harness subworkflow runner (mirrors integration patterns; lives under {@link \"@codemation/core/testing\"}).\n */\nexport class SubWorkflowRunnerConfig<TInputJson = unknown, TOutputJson = unknown> implements RunnableNodeConfig<\n  TInputJson,\n  TOutputJson\n> {\n  readonly kind = \"node\" as const;\n  readonly type: TypeToken<unknown> = SubWorkflowRunnerNode;\n\n  constructor(\n    public readonly name: string,\n    public readonly args: Readonly<{\n      workflowId: WorkflowId;\n      startAt?: NodeId;\n      id?: string;\n      execution?: Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }>;\n    }>,\n  ) {}\n\n  get id(): string | undefined {\n    return this.args.id;\n  }\n\n  get execution(): Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }> | undefined {\n    return this.args.execution;\n  }\n\n  get workflowId(): WorkflowId {\n    return this.args.workflowId;\n  }\n\n  get startAt(): NodeId | undefined {\n    return this.args.startAt;\n  }\n}\n\nexport class SubWorkflowRunnerNode implements Node<SubWorkflowRunnerConfig<any, any>> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  constructor(private readonly workflows: WorkflowRunnerService) {}\n\n  async execute(items: Items, ctx: NodeExecutionContext<SubWorkflowRunnerConfig<any, any>>): Promise<NodeOutputs> {\n    const out: Item[] = [];\n    for (let i = 0; i < items.length; i++) {\n      const current = items[i]!;\n      const result = await this.workflows.runById({\n        workflowId: ctx.config.workflowId,\n        startAt: ctx.config.startAt,\n        items: [current],\n        parent: {\n          runId: ctx.runId,\n          workflowId: ctx.workflowId,\n          nodeId: ctx.nodeId,\n          subworkflowDepth: ctx.subworkflowDepth,\n          engineMaxNodeActivations: ctx.engineMaxNodeActivations,\n          engineMaxSubworkflowDepth: ctx.engineMaxSubworkflowDepth,\n        },\n      });\n      if (result.status !== \"completed\") {\n        throw new Error(`Subworkflow ${ctx.config.workflowId} did not complete (status=${result.status})`);\n      }\n      out.push(...result.outputs);\n    }\n\n    return { main: out };\n  }\n}\n","/* eslint-disable codemation/single-class-per-file -- Trigger config and implementation share a TypeToken pairing. */\nimport type { TypeToken } from \"../di\";\nimport type {\n  Items,\n  NodeExecutionContext,\n  NodeOutputs,\n  TriggerNode,\n  TriggerNodeConfig,\n  TriggerSetupContext,\n} from \"../types\";\n\n/**\n * Minimal pass-through manual trigger for {@link WorkflowTestKit.runNode}; emits input items unchanged.\n */\nexport class WorkflowTestHarnessManualTriggerConfig implements TriggerNodeConfig<unknown> {\n  readonly kind = \"trigger\" as const;\n  readonly type: TypeToken<unknown> = WorkflowTestHarnessManualTriggerNode;\n\n  constructor(\n    public readonly name: string,\n    public readonly id?: string,\n  ) {}\n}\n\nexport class WorkflowTestHarnessManualTriggerNode implements TriggerNode<WorkflowTestHarnessManualTriggerConfig> {\n  readonly kind = \"trigger\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  async setup(_ctx: TriggerSetupContext<WorkflowTestHarnessManualTriggerConfig>): Promise<undefined> {\n    return undefined;\n  }\n\n  async execute(\n    items: Items,\n    _ctx: NodeExecutionContext<WorkflowTestHarnessManualTriggerConfig>,\n  ): Promise<NodeOutputs> {\n    return { main: items };\n  }\n}\n","import type { DependencyContainer, InjectionToken } from \"tsyringe\";\nimport { container as tsyringeContainer } from \"tsyringe\";\n\nimport type { WorkflowRunnerService } from \"../contracts/runtimeTypes\";\nimport { CoreTokens } from \"../di\";\nimport { InMemoryRunEventBus } from \"../events/InMemoryRunEventBusRegistry\";\nimport { AllWorkflowsActiveWorkflowActivationPolicy } from \"../contracts/workflowActivationPolicy\";\nimport { RunIntentService } from \"../runtime/RunIntentService\";\nimport {\n  DefaultDrivingScheduler,\n  DefaultAsyncSleeper,\n  DefaultExecutionContextFactory,\n  Engine,\n  EngineRuntimeRegistrar,\n  EngineWorkflowRunnerService,\n  HintOnlyOffloadPolicy,\n  InProcessRetryRunner,\n  InMemoryRunDataFactory,\n  InMemoryWorkflowExecutionRepository,\n  InlineDrivingScheduler,\n  NodeExecutor,\n  NodeInstanceFactory,\n  PersistedWorkflowTokenRegistry,\n} from \"../bootstrap/index\";\nimport { InMemoryLiveWorkflowRepository } from \"../runtime/InMemoryLiveWorkflowRepository\";\nimport { EngineTestKitRunIdFactory } from \"./EngineTestKitRunIdFactory\";\nimport { InMemoryTriggerSetupStateRepository } from \"./InMemoryTriggerSetupStateRepository\";\nimport { RejectingCredentialSessionService } from \"./RejectingCredentialSessionService\";\nimport { CapturingScheduler } from \"./CapturingScheduler\";\nimport { PrefixedSequentialIdGenerator } from \"./PrefixedSequentialIdGenerator\";\nimport type { RegistrarEngineTestKitHandle, RegistrarEngineTestKitOptions } from \"./RegistrarEngineTestKit.types\";\nimport { ItemHarnessNode } from \"./ItemHarnessNode\";\nimport { SubWorkflowRunnerNode } from \"./SubWorkflowRunnerTestNode\";\nimport { WorkflowTestHarnessManualTriggerNode } from \"./WorkflowTestHarnessManualTrigger\";\n\nexport class RegistrarEngineTestKitFactory {\n  static create(options: RegistrarEngineTestKitOptions = {}): RegistrarEngineTestKitHandle {\n    const runStore = options.runStore ?? new InMemoryWorkflowExecutionRepository();\n    const scheduler = options.scheduler ?? new CapturingScheduler();\n    const offloadPolicy = options.offloadPolicy ?? new HintOnlyOffloadPolicy();\n    const runIdGen = new PrefixedSequentialIdGenerator(\"run_\");\n    const activationIdGen = new PrefixedSequentialIdGenerator(\"act_\");\n    const makeRunId = options.makeRunId ?? runIdGen.asFn();\n    const makeActivationId = options.makeActivationId ?? activationIdGen.asFn();\n    const credentialSessions = options.credentialSessions ?? new RejectingCredentialSessionService();\n    const eventBus = options.eventBus ?? new InMemoryRunEventBus();\n    const triggerSetupStateRepository =\n      options.triggerSetupStateRepository ?? new InMemoryTriggerSetupStateRepository();\n    const liveWorkflowRepository = new InMemoryLiveWorkflowRepository();\n    const runDataFactory = options.runDataFactory ?? new InMemoryRunDataFactory();\n    const executionContextFactory = options.executionContextFactory ?? new DefaultExecutionContextFactory();\n    const container = options.container ?? tsyringeContainer.createChildContainer();\n    const dependencyContainer = container as DependencyContainer;\n    const nodeResolver = container;\n    const nodeExecutor = new NodeExecutor(\n      new NodeInstanceFactory(nodeResolver),\n      new InProcessRetryRunner(new DefaultAsyncSleeper()),\n    );\n    const activationScheduler = new DefaultDrivingScheduler(\n      offloadPolicy,\n      scheduler,\n      new InlineDrivingScheduler(nodeExecutor),\n    );\n\n    for (const [token, value] of options.providers ?? new Map<InjectionToken<unknown>, unknown>()) {\n      dependencyContainer.registerInstance(token, value);\n    }\n\n    dependencyContainer.registerInstance(CoreTokens.CredentialSessionService, credentialSessions);\n    dependencyContainer.registerInstance(CoreTokens.LiveWorkflowRepository, liveWorkflowRepository);\n    dependencyContainer.registerInstance(CoreTokens.WorkflowRepository, liveWorkflowRepository);\n    dependencyContainer.registerInstance(CoreTokens.NodeResolver, nodeResolver);\n    dependencyContainer.registerInstance(\n      CoreTokens.RunIdFactory,\n      new EngineTestKitRunIdFactory(makeRunId, makeActivationId),\n    );\n    dependencyContainer.registerInstance(\n      CoreTokens.ActivationIdFactory,\n      new EngineTestKitRunIdFactory(makeRunId, makeActivationId),\n    );\n    dependencyContainer.registerInstance(CoreTokens.WebhookBasePath, options.webhookBasePath ?? \"/webhooks\");\n    dependencyContainer.registerInstance(CoreTokens.WorkflowExecutionRepository, runStore);\n    dependencyContainer.registerInstance(CoreTokens.TriggerSetupStateRepository, triggerSetupStateRepository);\n    dependencyContainer.registerInstance(CoreTokens.NodeActivationScheduler, activationScheduler);\n    dependencyContainer.registerInstance(CoreTokens.RunDataFactory, runDataFactory);\n    dependencyContainer.registerInstance(CoreTokens.ExecutionContextFactory, executionContextFactory);\n    dependencyContainer.registerInstance(CoreTokens.RunEventBus, eventBus);\n    dependencyContainer.registerInstance(\n      CoreTokens.PersistedWorkflowTokenRegistry,\n      new PersistedWorkflowTokenRegistry(),\n    );\n    dependencyContainer.registerInstance(\n      CoreTokens.WorkflowActivationPolicy,\n      new AllWorkflowsActiveWorkflowActivationPolicy(),\n    );\n\n    if (options.executionLimitsPolicy !== undefined) {\n      dependencyContainer.registerInstance(CoreTokens.EngineExecutionLimitsPolicy, options.executionLimitsPolicy);\n    }\n\n    new EngineRuntimeRegistrar().register(dependencyContainer, options.registrarOptions ?? {});\n\n    const engine = dependencyContainer.resolve(Engine);\n    const runIntent = dependencyContainer.resolve(RunIntentService);\n    const workflowRunner =\n      options.workflowRunner ??\n      (dependencyContainer.resolve(CoreTokens.WorkflowRunnerService) as EngineWorkflowRunnerService);\n    dependencyContainer.registerInstance(\n      SubWorkflowRunnerNode,\n      new SubWorkflowRunnerNode(workflowRunner as WorkflowRunnerService),\n    );\n    dependencyContainer.registerInstance(ItemHarnessNode, new ItemHarnessNode());\n    dependencyContainer.registerInstance(\n      WorkflowTestHarnessManualTriggerNode,\n      new WorkflowTestHarnessManualTriggerNode(),\n    );\n\n    const start = async (workflows: ReadonlyArray<import(\"../types\").WorkflowDefinition>): Promise<void> => {\n      await engine.start([...workflows]);\n    };\n\n    const runToCompletion: RegistrarEngineTestKitHandle[\"runToCompletion\"] = async (args) => {\n      const r0 = await engine.runWorkflow(args.wf, args.startAt, args.items, args.parent);\n      if (r0.status !== \"pending\") return r0;\n      return await engine.waitForCompletion(r0.runId);\n    };\n\n    const runIntentStartToCompletion: RegistrarEngineTestKitHandle[\"runIntentStartToCompletion\"] = async (args) => {\n      const r0 = await runIntent.startWorkflow({\n        workflow: args.wf,\n        startAt: args.startAt,\n        items: args.items,\n        parent: args.parent,\n      });\n      if (r0.status !== \"pending\") return r0;\n      return await engine.waitForCompletion(r0.runId);\n    };\n\n    return {\n      engine,\n      runIntent,\n      liveWorkflowRepository,\n      runStore,\n      triggerSetupStateRepository,\n      scheduler: scheduler as CapturingScheduler | import(\"../types\").NodeExecutionScheduler,\n      offloadPolicy,\n      workflowRunner,\n      dependencyContainer,\n      start,\n      runToCompletion,\n      runIntentStartToCompletion,\n      makeRunId,\n      makeActivationId,\n    };\n  }\n}\n","import type { DependencyContainer } from \"tsyringe\";\n\nimport type { TypeToken } from \"../di\";\n\nimport type { DefinedNodeRegistrationContext } from \"./WorkflowTestKit.types\";\n\nexport class WorkflowTestKitNodeRegistrationContextFactory {\n  create(dependencyContainer: DependencyContainer): DefinedNodeRegistrationContext {\n    return {\n      registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>) {\n        dependencyContainer.register(token, {\n          useClass: (implementation ?? token) as never,\n        });\n      },\n    };\n  }\n}\n","import type { RunnableNodeConfig, WorkflowDefinition, WorkflowId } from \"../types\";\nimport { WorkflowBuilder } from \"../workflow/dsl/WorkflowBuilder\";\n\nimport { WorkflowTestHarnessManualTriggerConfig } from \"./WorkflowTestHarnessManualTrigger\";\n\nconst defaultInlineWorkflowId = \"codemation.testing.workflowkit.inline\" as WorkflowId;\nconst defaultInlineWorkflowName = \"WorkflowTestKit inline\";\n\n/**\n * Builds the minimal trigger → runnable workflow used by {@link import(\"./WorkflowTestKit\").WorkflowTestKit.runNode}.\n */\nexport class WorkflowTestKitRunNodeWorkflowFactory {\n  build(args: { node: RunnableNodeConfig; workflowId?: WorkflowId; workflowName?: string }): WorkflowDefinition {\n    const workflowId = args.workflowId ?? defaultInlineWorkflowId;\n    const workflowName = args.workflowName ?? defaultInlineWorkflowName;\n    const trigger = new WorkflowTestHarnessManualTriggerConfig(\n      \"WorkflowTestKit trigger\",\n      \"workflowkit.harness.trigger\",\n    );\n    return new WorkflowBuilder({ id: workflowId, name: workflowName }).trigger(trigger).then(args.node).build();\n  }\n\n  defaultStartNodeId(): string {\n    return \"workflowkit.harness.trigger\";\n  }\n}\n","import type { DependencyContainer } from \"tsyringe\";\n\nimport type { Items, NodeId, RunnableNodeConfig, RunResult, WorkflowDefinition, WorkflowId } from \"../types\";\n\nimport { RegistrarEngineTestKitFactory } from \"./RegistrarEngineTestKitFactory\";\nimport type { EngineTestKitOptions, RegistrarEngineTestKitHandle } from \"./RegistrarEngineTestKit.types\";\nimport { WorkflowTestKitNodeRegistrationContextFactory } from \"./WorkflowTestKitNodeRegistrationContextFactory\";\nimport type { DefinedNodeRegistration } from \"./WorkflowTestKit.types\";\nimport { WorkflowTestKitRunNodeWorkflowFactory } from \"./WorkflowTestKitRunNodeWorkflowFactory\";\n\nexport type { DefinedNodeRegistration, DefinedNodeRegistrationContext } from \"./WorkflowTestKit.types\";\n\nexport type WorkflowTestKitOptions = EngineTestKitOptions;\n\nexport class WorkflowTestKit {\n  private readonly handle: RegistrarEngineTestKitHandle;\n  private readonly runNodeWorkflowFactory = new WorkflowTestKitRunNodeWorkflowFactory();\n  private readonly nodeRegistrationContextFactory = new WorkflowTestKitNodeRegistrationContextFactory();\n\n  constructor(options: WorkflowTestKitOptions = {}) {\n    this.handle = RegistrarEngineTestKitFactory.create(options);\n  }\n\n  get dependencyContainer(): DependencyContainer {\n    return this.handle.dependencyContainer;\n  }\n\n  get engine(): RegistrarEngineTestKitHandle[\"engine\"] {\n    return this.handle.engine;\n  }\n\n  get workflowRunner(): RegistrarEngineTestKitHandle[\"workflowRunner\"] {\n    return this.handle.workflowRunner;\n  }\n\n  get liveWorkflowRepository(): RegistrarEngineTestKitHandle[\"liveWorkflowRepository\"] {\n    return this.handle.liveWorkflowRepository;\n  }\n\n  get runStore(): RegistrarEngineTestKitHandle[\"runStore\"] {\n    return this.handle.runStore;\n  }\n\n  /**\n   * Registers {@link import(\"../authoring/defineNode.types\").DefinedNode} implementations on the same DI container used by the engine\n   * (same pattern as `plugin.register({ registerNode })` in the host).\n   */\n  registerDefinedNodes(definitions: ReadonlyArray<DefinedNodeRegistration>): void {\n    const ctx = this.nodeRegistrationContextFactory.create(this.handle.dependencyContainer);\n    for (const def of definitions) {\n      def.register(ctx);\n    }\n  }\n\n  async run(args: { workflow: WorkflowDefinition; items: Items; startAt?: NodeId }): Promise<RunResult> {\n    await this.handle.start([args.workflow]);\n    return await this.handle.workflowRunner.runById({\n      workflowId: args.workflow.id,\n      startAt: args.startAt,\n      items: args.items,\n    });\n  }\n\n  async runNode(args: {\n    node: RunnableNodeConfig;\n    items: Items;\n    workflowId?: WorkflowId;\n    workflowName?: string;\n  }): Promise<RunResult> {\n    const wf = this.runNodeWorkflowFactory.build(args);\n    return await this.run({\n      workflow: wf,\n      items: args.items,\n      startAt: this.runNodeWorkflowFactory.defaultStartNodeId(),\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;AAMA,IAAa,oCAAb,MAAmF;CACjF,MAAM,WACJ,MACmB;AACnB,QAAM,IAAI,MACR,oDAAoD,KAAK,WAAW,QAAQ,KAAK,OAAO,SAAS,KAAK,QAAQ,wFAC/G;;;;;;;;;ACLL,IAAa,kBAAb,MAAyG;CACvG,AAAS,OAAO;CAChB,AAAS,cAAc,CAAC,OAAO;CAE/B,MAAM,WAAW,MAMI;AACnB,SAAO,MAAM,KAAK,IAAI,OAAO,OAAO;GAClC,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,KAAK,KAAK;GACX,CAAC;;;;;;;;;;ACbN,IAAa,wBAAb,MAIE;CACA,AAAS,OAAO;CAChB,AAAS,OAA2B;CAEpC,YACE,AAAgBA,MAChB,AAAgBC,aAChB,AAAgBC,QAOhB,AAAgBC,OAGX,EAAE,EACP;EAbgB;EACA;EACA;EAOA;;CAMlB,IAAI,WAAoD;AACtD,SAAO,KAAK,KAAK;;CAGnB,IAAI,KAAyB;AAC3B,SAAO,KAAK,KAAK;;;;;;;;;ACnCrB,IAAa,qBAAb,MAAkE;CAChE;CACA,WAAmC,EAAE;CAErC,MAAM,QAAQ,SAA+D;AAC3E,OAAK,cAAc;AACnB,OAAK,SAAS,KAAK,QAAQ;AAC3B,SAAO,EAAE,WAAW,WAAW,KAAK,SAAS,UAAU;;;;;;;;;ACT3D,IAAa,gCAAb,MAA2C;CACzC,AAAQ,IAAI;CAEZ,YAAY,AAAiBC,QAAgB;EAAhB;;CAE7B,OAAe;AACb,OAAK,KAAK;AACV,SAAO,GAAG,KAAK,SAAS,KAAK;;CAG/B,OAAqB;AACnB,eAAa,KAAK,MAAM;;;;;;;;;ACT5B,IAAa,4BAAb,MAA+D;CAC7D,AAAQ,aAAa;CACrB,AAAQ,oBAAoB;CAE5B,YACE,AAAiBC,gBACjB,AAAiBC,uBACjB;EAFiB;EACA;;CAGnB,YAAoB;AAClB,OAAK,cAAc;AACnB,SAAO,KAAK,gBAAgB;;CAG9B,mBAA2B;AACzB,OAAK,qBAAqB;AAC1B,SAAO,KAAK,uBAAuB;;;;;;ACnBvC,IAAa,sCAAb,MAAwF;CACtF,AAAiB,8BAAc,IAAI,KAAyC;CAE5E,MAAM,KAAK,SAAkG;AAC3G,SAAO,KAAK,YAAY,IAAI,KAAK,MAAM,QAAQ,CAAC;;CAGlD,MAAM,KAAK,OAAkD;AAC3D,OAAK,YAAY,IAAI,KAAK,MAAM,MAAM,QAAQ,EAAE,MAAM;;CAGxD,MAAM,OAAO,SAAgE;AAC3E,OAAK,YAAY,OAAO,KAAK,MAAM,QAAQ,CAAC;;CAG9C,AAAQ,MAAM,SAAyD;AACrE,SAAO,GAAG,QAAQ,WAAW,GAAG,QAAQ;;;;;;;;;ACD5C,IAAa,0BAAb,MAGE;CACA,AAAS,OAAO;CAChB,AAAS,OAA2B;CAEpC,YACE,AAAgBC,MAChB,AAAgBC,MAMhB;EAPgB;EACA;;CAQlB,IAAI,KAAyB;AAC3B,SAAO,KAAK,KAAK;;CAGnB,IAAI,YAAiF;AACnF,SAAO,KAAK,KAAK;;CAGnB,IAAI,aAAyB;AAC3B,SAAO,KAAK,KAAK;;CAGnB,IAAI,UAA8B;AAChC,SAAO,KAAK,KAAK;;;AAIrB,IAAa,wBAAb,MAAsF;CACpF,AAAS,OAAO;CAChB,AAAS,cAAc,CAAC,OAAO;CAE/B,YAAY,AAAiBC,WAAkC;EAAlC;;CAE7B,MAAM,QAAQ,OAAc,KAAoF;EAC9G,MAAMC,MAAc,EAAE;AACtB,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACrC,MAAM,UAAU,MAAM;GACtB,MAAM,SAAS,MAAM,KAAK,UAAU,QAAQ;IAC1C,YAAY,IAAI,OAAO;IACvB,SAAS,IAAI,OAAO;IACpB,OAAO,CAAC,QAAQ;IAChB,QAAQ;KACN,OAAO,IAAI;KACX,YAAY,IAAI;KAChB,QAAQ,IAAI;KACZ,kBAAkB,IAAI;KACtB,0BAA0B,IAAI;KAC9B,2BAA2B,IAAI;KAChC;IACF,CAAC;AACF,OAAI,OAAO,WAAW,YACpB,OAAM,IAAI,MAAM,eAAe,IAAI,OAAO,WAAW,4BAA4B,OAAO,OAAO,GAAG;AAEpG,OAAI,KAAK,GAAG,OAAO,QAAQ;;AAG7B,SAAO,EAAE,MAAM,KAAK;;;;;;;;;AClExB,IAAa,yCAAb,MAA0F;CACxF,AAAS,OAAO;CAChB,AAAS,OAA2B;CAEpC,YACE,AAAgBC,MAChB,AAAgBC,IAChB;EAFgB;EACA;;;AAIpB,IAAa,uCAAb,MAAiH;CAC/G,AAAS,OAAO;CAChB,AAAS,cAAc,CAAC,OAAO;CAE/B,MAAM,MAAM,MAAuF;CAInG,MAAM,QACJ,OACA,MACsB;AACtB,SAAO,EAAE,MAAM,OAAO;;;;;;ACD1B,IAAa,gCAAb,MAA2C;CACzC,OAAO,OAAO,UAAyC,EAAE,EAAgC;EACvF,MAAM,WAAW,QAAQ,YAAY,IAAI,qCAAqC;EAC9E,MAAM,YAAY,QAAQ,aAAa,IAAI,oBAAoB;EAC/D,MAAM,gBAAgB,QAAQ,iBAAiB,IAAI,uBAAuB;EAC1E,MAAM,WAAW,IAAI,8BAA8B,OAAO;EAC1D,MAAM,kBAAkB,IAAI,8BAA8B,OAAO;EACjE,MAAM,YAAY,QAAQ,aAAa,SAAS,MAAM;EACtD,MAAM,mBAAmB,QAAQ,oBAAoB,gBAAgB,MAAM;EAC3E,MAAM,qBAAqB,QAAQ,sBAAsB,IAAI,mCAAmC;EAChG,MAAM,WAAW,QAAQ,YAAY,IAAI,qBAAqB;EAC9D,MAAM,8BACJ,QAAQ,+BAA+B,IAAI,qCAAqC;EAClF,MAAM,yBAAyB,IAAI,gCAAgC;EACnE,MAAM,iBAAiB,QAAQ,kBAAkB,IAAI,wBAAwB;EAC7E,MAAM,0BAA0B,QAAQ,2BAA2B,IAAI,gCAAgC;EACvG,MAAMC,cAAY,QAAQ,aAAaC,UAAkB,sBAAsB;EAC/E,MAAM,sBAAsBD;EAC5B,MAAM,eAAeA;EAKrB,MAAM,sBAAsB,IAAI,wBAC9B,eACA,WACA,IAAI,uBAPe,IAAI,aACvB,IAAI,oBAAoB,aAAa,EACrC,IAAI,qBAAqB,IAAI,qBAAqB,CAAC,CACpD,CAIyC,CACzC;AAED,OAAK,MAAM,CAAC,OAAO,UAAU,QAAQ,6BAAa,IAAI,KAAuC,CAC3F,qBAAoB,iBAAiB,OAAO,MAAM;AAGpD,sBAAoB,iBAAiB,WAAW,0BAA0B,mBAAmB;AAC7F,sBAAoB,iBAAiB,WAAW,wBAAwB,uBAAuB;AAC/F,sBAAoB,iBAAiB,WAAW,oBAAoB,uBAAuB;AAC3F,sBAAoB,iBAAiB,WAAW,cAAc,aAAa;AAC3E,sBAAoB,iBAClB,WAAW,cACX,IAAI,0BAA0B,WAAW,iBAAiB,CAC3D;AACD,sBAAoB,iBAClB,WAAW,qBACX,IAAI,0BAA0B,WAAW,iBAAiB,CAC3D;AACD,sBAAoB,iBAAiB,WAAW,iBAAiB,QAAQ,mBAAmB,YAAY;AACxG,sBAAoB,iBAAiB,WAAW,6BAA6B,SAAS;AACtF,sBAAoB,iBAAiB,WAAW,6BAA6B,4BAA4B;AACzG,sBAAoB,iBAAiB,WAAW,yBAAyB,oBAAoB;AAC7F,sBAAoB,iBAAiB,WAAW,gBAAgB,eAAe;AAC/E,sBAAoB,iBAAiB,WAAW,yBAAyB,wBAAwB;AACjG,sBAAoB,iBAAiB,WAAW,aAAa,SAAS;AACtE,sBAAoB,iBAClB,WAAW,gCACX,IAAI,gCAAgC,CACrC;AACD,sBAAoB,iBAClB,WAAW,0BACX,IAAI,4CAA4C,CACjD;AAED,MAAI,QAAQ,0BAA0B,OACpC,qBAAoB,iBAAiB,WAAW,6BAA6B,QAAQ,sBAAsB;AAG7G,MAAI,wBAAwB,CAAC,SAAS,qBAAqB,QAAQ,oBAAoB,EAAE,CAAC;EAE1F,MAAM,SAAS,oBAAoB,QAAQ,OAAO;EAClD,MAAM,YAAY,oBAAoB,QAAQ,iBAAiB;EAC/D,MAAM,iBACJ,QAAQ,kBACP,oBAAoB,QAAQ,WAAW,sBAAsB;AAChE,sBAAoB,iBAClB,uBACA,IAAI,sBAAsB,eAAwC,CACnE;AACD,sBAAoB,iBAAiB,iBAAiB,IAAI,iBAAiB,CAAC;AAC5E,sBAAoB,iBAClB,sCACA,IAAI,sCAAsC,CAC3C;EAED,MAAM,QAAQ,OAAO,cAAmF;AACtG,SAAM,OAAO,MAAM,CAAC,GAAG,UAAU,CAAC;;EAGpC,MAAME,kBAAmE,OAAO,SAAS;GACvF,MAAM,KAAK,MAAM,OAAO,YAAY,KAAK,IAAI,KAAK,SAAS,KAAK,OAAO,KAAK,OAAO;AACnF,OAAI,GAAG,WAAW,UAAW,QAAO;AACpC,UAAO,MAAM,OAAO,kBAAkB,GAAG,MAAM;;EAGjD,MAAMC,6BAAyF,OAAO,SAAS;GAC7G,MAAM,KAAK,MAAM,UAAU,cAAc;IACvC,UAAU,KAAK;IACf,SAAS,KAAK;IACd,OAAO,KAAK;IACZ,QAAQ,KAAK;IACd,CAAC;AACF,OAAI,GAAG,WAAW,UAAW,QAAO;AACpC,UAAO,MAAM,OAAO,kBAAkB,GAAG,MAAM;;AAGjD,SAAO;GACL;GACA;GACA;GACA;GACA;GACW;GACX;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD;;;;;;ACnJL,IAAa,gDAAb,MAA2D;CACzD,OAAO,qBAA0E;AAC/E,SAAO,EACL,aAAqB,OAA0B,gBAAoC;AACjF,uBAAoB,SAAS,OAAO,EAClC,UAAW,kBAAkB,OAC9B,CAAC;KAEL;;;;;;ACTL,MAAM,0BAA0B;AAChC,MAAM,4BAA4B;;;;AAKlC,IAAa,wCAAb,MAAmD;CACjD,MAAM,MAAwG;EAC5G,MAAM,aAAa,KAAK,cAAc;EACtC,MAAM,eAAe,KAAK,gBAAgB;EAC1C,MAAM,UAAU,IAAI,uCAClB,2BACA,8BACD;AACD,SAAO,IAAI,gBAAgB;GAAE,IAAI;GAAY,MAAM;GAAc,CAAC,CAAC,QAAQ,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO;;CAG7G,qBAA6B;AAC3B,SAAO;;;;;;ACTX,IAAa,kBAAb,MAA6B;CAC3B,AAAiB;CACjB,AAAiB,yBAAyB,IAAI,uCAAuC;CACrF,AAAiB,iCAAiC,IAAI,+CAA+C;CAErG,YAAY,UAAkC,EAAE,EAAE;AAChD,OAAK,SAAS,8BAA8B,OAAO,QAAQ;;CAG7D,IAAI,sBAA2C;AAC7C,SAAO,KAAK,OAAO;;CAGrB,IAAI,SAAiD;AACnD,SAAO,KAAK,OAAO;;CAGrB,IAAI,iBAAiE;AACnE,SAAO,KAAK,OAAO;;CAGrB,IAAI,yBAAiF;AACnF,SAAO,KAAK,OAAO;;CAGrB,IAAI,WAAqD;AACvD,SAAO,KAAK,OAAO;;;;;;CAOrB,qBAAqB,aAA2D;EAC9E,MAAM,MAAM,KAAK,+BAA+B,OAAO,KAAK,OAAO,oBAAoB;AACvF,OAAK,MAAM,OAAO,YAChB,KAAI,SAAS,IAAI;;CAIrB,MAAM,IAAI,MAA4F;AACpG,QAAM,KAAK,OAAO,MAAM,CAAC,KAAK,SAAS,CAAC;AACxC,SAAO,MAAM,KAAK,OAAO,eAAe,QAAQ;GAC9C,YAAY,KAAK,SAAS;GAC1B,SAAS,KAAK;GACd,OAAO,KAAK;GACb,CAAC;;CAGJ,MAAM,QAAQ,MAKS;EACrB,MAAM,KAAK,KAAK,uBAAuB,MAAM,KAAK;AAClD,SAAO,MAAM,KAAK,IAAI;GACpB,UAAU;GACV,OAAO,KAAK;GACZ,SAAS,KAAK,uBAAuB,oBAAoB;GAC1D,CAAC"}

package/dist/workflowActivationPolicy-B8HzTk3o.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflowActivationPolicy-B8HzTk3o.js","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts","../src/contracts/workflowActivationPolicy.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"main\");\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflowActivationPolicy-B8HzTk3o.js","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts","../src/contracts/workflowActivationPolicy.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TInputJson, TOutputJson, TConfig extends RunnableNodeConfig<TInputJson, TOutputJson, TCurrentJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"main\");\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}

package/dist/workflowActivationPolicy-BzyzXLa_.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflowActivationPolicy-BzyzXLa_.cjs","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts","../src/contracts/workflowActivationPolicy.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"main\");\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflowActivationPolicy-BzyzXLa_.cjs","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts","../src/contracts/workflowActivationPolicy.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TInputJson, TOutputJson, TConfig extends RunnableNodeConfig<TInputJson, TOutputJson, TCurrentJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"main\");\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemation/core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "publishConfig": {
     "access": "public"
   },

package/src/ai/AgentMessageConfigNormalizerFactory.ts

@@ -3,10 +3,27 @@ import type {
   AgentMessageConfig,
   AgentMessageDto,
   AgentMessageLine,
+  AgentMessageRole,
   AgentNodeConfig,
 } from "./AiHost";
 
 export class AgentMessageConfigNormalizer {
+  /**
+   * Prefer {@code input.messages} when present (ItemNode / engine-mapped payloads); otherwise resolve from
+   * {@link AgentNodeConfig.messages} templates.
+   */
+  static resolveFromInputOrConfig<TInputJson, TOutputJson>(
+    input: unknown,
+    config: AgentNodeConfig<TInputJson, TOutputJson>,
+    args: AgentMessageBuildArgs<TInputJson>,
+  ): ReadonlyArray<AgentMessageDto> {
+    const fromInput = this.tryMessagesFromStructuredInput(input);
+    if (fromInput.length > 0) {
+      return fromInput;
+    }
+    return this.normalize(config, args);
+  }
+
   static normalize<TInputJson, TOutputJson>(
     config: AgentNodeConfig<TInputJson, TOutputJson>,
     args: AgentMessageBuildArgs<TInputJson>,
@@ -20,6 +37,32 @@ export class AgentMessageConfigNormalizer {
     );
   }
 
+  private static tryMessagesFromStructuredInput(input: unknown): ReadonlyArray<AgentMessageDto> {
+    if (!input || typeof input !== "object") {
+      return [];
+    }
+    const raw = (input as { messages?: unknown }).messages;
+    if (!Array.isArray(raw) || raw.length === 0) {
+      return [];
+    }
+    const out: AgentMessageDto[] = [];
+    for (const m of raw) {
+      if (!m || typeof m !== "object") {
+        continue;
+      }
+      const role = (m as { role?: unknown }).role;
+      const content = (m as { content?: unknown }).content;
+      if (role !== "system" && role !== "user" && role !== "assistant") {
+        continue;
+      }
+      if (typeof content !== "string") {
+        continue;
+      }
+      out.push({ role: role as AgentMessageRole, content });
+    }
+    return out;
+  }
+
   private static normalizeRichMessages<TInputJson>(
     config: AgentMessageConfig<TInputJson>,
     args: AgentMessageBuildArgs<TInputJson>,

package/src/ai/AgentToolFactory.ts

@@ -5,7 +5,7 @@ import { NodeBackedToolConfig } from "./NodeBackedToolConfig";
 
 class AgentToolFactoryImpl {
   asTool<
-    TNodeConfig extends RunnableNodeConfig<any, any>,
+    TNodeConfig extends RunnableNodeConfig<any, any, any>,
     TInputSchema extends ZodSchemaAny,
     TOutputSchema extends ZodSchemaAny,
   >(
@@ -20,7 +20,7 @@ class AgentToolFactoryImpl {
   }
 
   private withDefaultAgentInputMapper<
-    TNodeConfig extends RunnableNodeConfig<any, any>,
+    TNodeConfig extends RunnableNodeConfig<any, any, any>,
     TInputSchema extends ZodSchemaAny,
     TOutputSchema extends ZodSchemaAny,
   >(

package/src/ai/AiHost.ts

@@ -150,7 +150,7 @@ export interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelCon
 }
 
 export type NodeBackedToolInputMapperArgs<
-  TNodeConfig extends RunnableNodeConfig<any, any>,
+  TNodeConfig extends RunnableNodeConfig<any, any, any>,
   TToolInput = unknown,
 > = Readonly<{
   input: TToolInput;
@@ -162,7 +162,7 @@ export type NodeBackedToolInputMapperArgs<
 }>;
 
 export type NodeBackedToolOutputMapperArgs<
-  TNodeConfig extends RunnableNodeConfig<any, any>,
+  TNodeConfig extends RunnableNodeConfig<any, any, any>,
   TToolInput = unknown,
 > = Readonly<{
   input: TToolInput;
@@ -174,18 +174,18 @@ export type NodeBackedToolOutputMapperArgs<
   outputs: NodeOutputs;
 }>;
 
-export type NodeBackedToolInputMapper<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = (
+export type NodeBackedToolInputMapper<TNodeConfig extends RunnableNodeConfig<any, any, any>, TToolInput = unknown> = (
   args: NodeBackedToolInputMapperArgs<TNodeConfig, TToolInput>,
 ) => Item<RunnableNodeInputJson<TNodeConfig>> | RunnableNodeInputJson<TNodeConfig>;
 
 export type NodeBackedToolOutputMapper<
-  TNodeConfig extends RunnableNodeConfig<any, any>,
+  TNodeConfig extends RunnableNodeConfig<any, any, any>,
   TToolInput = unknown,
   TToolOutput = unknown,
 > = (args: NodeBackedToolOutputMapperArgs<TNodeConfig, TToolInput>) => TToolOutput;
 
 export type NodeBackedToolConfigOptions<
-  TNodeConfig extends RunnableNodeConfig<any, any>,
+  TNodeConfig extends RunnableNodeConfig<any, any, any>,
   TInputSchema extends ZodSchemaAny,
   TOutputSchema extends ZodSchemaAny,
 > = Readonly<{
@@ -197,10 +197,11 @@ export type NodeBackedToolConfigOptions<
   mapOutput?: NodeBackedToolOutputMapper<TNodeConfig, ZodInput<TInputSchema>, ZodOutput<TOutputSchema>>;
 }>;
 
-export interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends RunnableNodeConfig<
-  TInputJson,
-  TOutputJson
-> {
+export interface AgentNodeConfig<
+  TInputJson = unknown,
+  TOutputJson = unknown,
+  TWireJson = TInputJson,
+> extends RunnableNodeConfig<TInputJson, TOutputJson, TWireJson> {
   readonly messages: AgentMessageConfig<TInputJson>;
   readonly chatModel: ChatModelConfig;
   readonly tools?: ReadonlyArray<ToolConfig>;

package/src/ai/NodeBackedToolConfig.ts

@@ -14,7 +14,7 @@ import type {
 } from "./AiHost";
 
 export class NodeBackedToolConfig<
-  TNodeConfig extends RunnableNodeConfig<any, any>,
+  TNodeConfig extends RunnableNodeConfig<any, any, any>,
   TInputSchema extends ZodSchemaAny,
   TOutputSchema extends ZodSchemaAny,
 > implements ToolConfig {

package/src/authoring/defineNode.types.ts

@@ -145,7 +145,7 @@ const definedNodeCredentialRequirementFactory = {
 const definedNodeCredentialAccessorFactory = {
   create<TBindings extends DefinedNodeCredentialBindings | undefined>(
     bindings: TBindings,
-    ctx: NodeExecutionContext<RunnableNodeConfig<any, any>>,
+    ctx: NodeExecutionContext<RunnableNodeConfig<any, any, any>>,
   ): DefinedNodeCredentialAccessors<TBindings> {
     if (!bindings) {
       return {} as DefinedNodeCredentialAccessors<TBindings>;

package/src/contracts/runtimeTypes.ts

@@ -13,6 +13,8 @@ import type {
 } from "./runTypes";
 import type { WorkflowActivationPolicy } from "./workflowActivationPolicy";
 import type { TriggerInstanceId, WebhookTriggerMatcher } from "./webhookTypes";
+import type { ZodType } from "zod";
+
 import type {
   ActivationIdFactory,
   BinaryAttachment,
@@ -225,6 +227,30 @@ export interface Node<TConfig extends NodeConfigBase = NodeConfigBase> {
   execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
 }
 
+/**
+ * Single-input runnable node with per-item execution on `main` only (1→1 default).
+ * Engine applies {@link RunnableNodeConfig.mapInput} (if any) + `inputSchema.parse` before `executeOne`.
+ */
+export interface ItemNode<
+  TConfig extends NodeConfigBase = NodeConfigBase,
+  TInputJson = unknown,
+  TOutputJson = unknown,
+> {
+  readonly kind: "node";
+  readonly outputPorts: readonly ["main"];
+  /** When omitted, engine uses {@link RunnableNodeConfig.inputSchema} or `z.unknown()`. */
+  readonly inputSchema?: ZodType<TInputJson>;
+  executeOne(
+    args: Readonly<{
+      input: TInputJson;
+      item: Item;
+      itemIndex: number;
+      items: Items;
+      ctx: NodeExecutionContext<TConfig>;
+    }>,
+  ): Promise<TOutputJson> | TOutputJson;
+}
+
 export interface MultiInputNode<TConfig extends NodeConfigBase = NodeConfigBase> {
   kind: "node";
   outputPorts: ReadonlyArray<OutputPortKey>;

package/src/contracts/workflowTypes.ts

@@ -1,3 +1,5 @@
+import type { ZodType } from "zod";
+
 import type { TypeToken } from "../di";
 import type { CredentialRequirement } from "./credentialTypes";
 import type { RetryPolicySpec } from "./retryPolicySpec.types";
@@ -84,12 +86,69 @@ export interface NodeConfigBase {
 
 export declare const runnableNodeInputType: unique symbol;
 export declare const runnableNodeOutputType: unique symbol;
+/** Phantom: JSON shape on the wire from upstream before {@link RunnableNodeConfig.mapInput}. */
+export declare const runnableNodeWireType: unique symbol;
 export declare const triggerNodeOutputType: unique symbol;
 
-export interface RunnableNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends NodeConfigBase {
+/**
+ * Read-only execution slice passed to {@link RunnableNodeConfig.mapInput} (aligned with the engine’s
+ * node execution context for `runId`, `data`, etc.). Use **`ctx.data`** to read **any completed** upstream
+ * node’s outputs in this run (e.g. `ctx.data.getOutputItems(nodeIdA, "main")` while mapping at D), not only
+ * the immediate predecessor’s {@link ItemInputMapperArgs.item}.
+ */
+export interface ItemInputMapperContext {
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  /** Node whose activation is being prepared (the consumer of `mapInput`). */
+  readonly nodeId: NodeId;
+  readonly activationId: NodeActivationId;
+  readonly parent?: ParentExecutionRef;
+  readonly data: RunDataSnapshot;
+}
+
+/**
+ * Arguments for optional per-item input mapping applied by the engine before Zod validation.
+ */
+export interface ItemInputMapperArgs<TWireJson = unknown> {
+  readonly item: Item<TWireJson>;
+  readonly itemIndex: number;
+  readonly items: Items<TWireJson>;
+  readonly ctx: ItemInputMapperContext;
+}
+
+/**
+ * Per-item mapper before Zod validation. Uses a **bivariant** method signature so concrete
+ * `ItemInputMapper<SpecificWire, TIn>` remains assignable to `RunnableNodeConfig` fields typed as
+ * `ItemInputMapper<unknown, unknown>` (same pattern as React-style callbacks).
+ */
+export type ItemInputMapper<TWireJson = unknown, TInputJson = unknown> = {
+  bivarianceHack(args: ItemInputMapperArgs<TWireJson>): TInputJson | Promise<TInputJson>;
+}["bivarianceHack"];
+
+/**
+ * Runnable node: **`TInputJson`** is the payload after `mapInput` (if any) + Zod validation — what {@link ItemNode}
+ * `executeOne` receives. **`TOutputJson`** is emitted `item.json` on outputs. **`TWireJson`** is `item.json` from
+ * upstream **before** `mapInput`; it defaults to **`TInputJson`** when there is no mapper or wire differs from execute input.
+ */
+export interface RunnableNodeConfig<
+  TInputJson = unknown,
+  TOutputJson = unknown,
+  TWireJson = TInputJson,
+> extends NodeConfigBase {
   readonly kind: "node";
   readonly [runnableNodeInputType]?: TInputJson;
   readonly [runnableNodeOutputType]?: TOutputJson;
+  readonly [runnableNodeWireType]?: TWireJson;
+  /**
+   * Optional Zod input contract for {@link ItemNode} when not set on the node class.
+   * Resolution order: node instance `inputSchema`, then config `inputSchema`, then `z.unknown()`.
+   */
+  readonly inputSchema?: ZodType<TInputJson>;
+  /**
+   * Optional per-item mapper: engine applies it before validating against the node’s `inputSchema`.
+   * When omitted, the engine validates `item.json` directly.
+   */
+  readonly mapInput?: ItemInputMapper<TWireJson, TInputJson>;
 }
 
 export declare const triggerNodeSetupStateType: unique symbol;
@@ -103,11 +162,14 @@ export interface TriggerNodeConfig<
   readonly [triggerNodeSetupStateType]?: TSetupState;
 }
 
-export type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> =
-  TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;
+export type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any, any>> =
+  TConfig extends RunnableNodeConfig<infer TInputJson, any, any> ? TInputJson : never;
+
+export type RunnableNodeWireJson<TConfig extends RunnableNodeConfig<any, any, any>> =
+  TConfig extends RunnableNodeConfig<any, any, infer TWireJson> ? TWireJson : never;
 
-export type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> =
-  TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;
+export type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any, any>> =
+  TConfig extends RunnableNodeConfig<any, infer TOutputJson, any> ? TOutputJson : never;
 
 export type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> =
   TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;