@codemation/core 0.6.0 → 0.8.0

package/dist/testing.cjs

@@ -1,6 +1,6 @@
-const require_runtime = require('./runtime-DVBwxFvX.cjs');
-const require_workflowActivationPolicy = require('./workflowActivationPolicy-6V3OJD3N.cjs');
-const require_bootstrap = require('./bootstrap-DVL2ue5v.cjs');
+const require_runtime = require('./runtime-Dvo2ru5A.cjs');
+const require_InMemoryRunEventBusRegistry = require('./InMemoryRunEventBusRegistry-B0_C4OnP.cjs');
+const require_bootstrap = require('./bootstrap-BaN6hZ5I.cjs');
 let tsyringe = require("tsyringe");
 tsyringe = require_runtime.__toESM(tsyringe);
 
@@ -223,7 +223,7 @@ var RegistrarEngineTestKitFactory = class {
 		const makeRunId = options.makeRunId ?? runIdGen.asFn();
 		const makeActivationId = options.makeActivationId ?? activationIdGen.asFn();
 		const credentialSessions = options.credentialSessions ?? new RejectingCredentialSessionService();
-		const eventBus = options.eventBus ?? new require_workflowActivationPolicy.InMemoryRunEventBus();
+		const eventBus = options.eventBus ?? new require_InMemoryRunEventBusRegistry.InMemoryRunEventBus();
 		const triggerSetupStateRepository = options.triggerSetupStateRepository ?? new InMemoryTriggerSetupStateRepository();
 		const liveWorkflowRepository = new require_runtime.InMemoryLiveWorkflowRepository();
 		const runDataFactory = options.runDataFactory ?? new require_runtime.InMemoryRunDataFactory();
@@ -247,7 +247,7 @@ var RegistrarEngineTestKitFactory = class {
 		dependencyContainer.registerInstance(require_runtime.CoreTokens.ExecutionContextFactory, executionContextFactory);
 		dependencyContainer.registerInstance(require_runtime.CoreTokens.RunEventBus, eventBus);
 		dependencyContainer.registerInstance(require_runtime.CoreTokens.PersistedWorkflowTokenRegistry, new require_runtime.PersistedWorkflowTokenRegistry());
-		dependencyContainer.registerInstance(require_runtime.CoreTokens.WorkflowActivationPolicy, new require_workflowActivationPolicy.AllWorkflowsActiveWorkflowActivationPolicy());
+		dependencyContainer.registerInstance(require_runtime.CoreTokens.WorkflowActivationPolicy, new require_runtime.AllWorkflowsActiveWorkflowActivationPolicy());
 		if (options.executionLimitsPolicy !== void 0) dependencyContainer.registerInstance(require_runtime.CoreTokens.EngineExecutionLimitsPolicy, options.executionLimitsPolicy);
 		new require_bootstrap.EngineRuntimeRegistrar().register(dependencyContainer, options.registrarOptions ?? {});
 		const engine = dependencyContainer.resolve(require_runtime.Engine);
@@ -316,7 +316,7 @@ var WorkflowTestKitRunNodeWorkflowFactory = class {
 		const workflowId = args.workflowId ?? defaultInlineWorkflowId;
 		const workflowName = args.workflowName ?? defaultInlineWorkflowName;
 		const trigger = new WorkflowTestHarnessManualTriggerConfig("WorkflowTestKit trigger", "workflowkit.harness.trigger");
-		return new require_workflowActivationPolicy.WorkflowBuilder({
+		return new require_InMemoryRunEventBusRegistry.WorkflowBuilder({
 			id: workflowId,
 			name: workflowName
 		}).trigger(trigger).then(args.node).build();

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","names":["name: string","inputSchema: ZodType<TIn>","runOne: (args: {\n      input: TIn;\n      item: Item<TIn>;\n      itemIndex: number;\n      items: Items<TIn>;\n      ctx: NodeExecutionContext<ItemHarnessNodeConfig<TIn, TOut>>;\n    }) => TOut | Promise<TOut>","opts: Readonly<{\n      id?: string;\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","emitPorts","name: string","id?: string","emitPorts","InMemoryWorkflowExecutionRepository","HintOnlyOffloadPolicy","InMemoryRunEventBus","InMemoryLiveWorkflowRepository","InMemoryRunDataFactory","DefaultExecutionContextFactory","tsyringeContainer","DefaultDrivingScheduler","InlineDrivingScheduler","NodeExecutor","NodeInstanceFactory","InProcessRetryRunner","DefaultAsyncSleeper","CoreTokens","PersistedWorkflowTokenRegistry","AllWorkflowsActiveWorkflowActivationPolicy","EngineRuntimeRegistrar","Engine","RunIntentService","runToCompletion: RegistrarEngineTestKitHandle[\"runToCompletion\"]","runIntentStartToCompletion: RegistrarEngineTestKitHandle[\"runIntentStartToCompletion\"]","WorkflowBuilder"],"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/SwitchHarnessNode.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, RunnableNode, RunnableNodeExecuteArgs } 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 RunnableNode<ItemHarnessNodeConfig<any, any>> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  async execute(args: RunnableNodeExecuteArgs<ItemHarnessNodeConfig<any, any>>): Promise<unknown> {\n    return await args.ctx.config.runOne({\n      input: args.input as never,\n      item: args.item as 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, 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 * then {@link ItemHarnessNode.execute} per item.\n */\nexport class ItemHarnessNodeConfig<TIn = unknown, TOut = unknown> implements RunnableNodeConfig<TIn, TOut> {\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<TIn>;\n      itemIndex: number;\n      items: Items<TIn>;\n      ctx: NodeExecutionContext<ItemHarnessNodeConfig<TIn, TOut>>;\n    }) => TOut | Promise<TOut>,\n    public readonly opts: Readonly<{\n      id?: string;\n    }> = {},\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 { Item, NodeId, RunnableNode, RunnableNodeConfig, RunnableNodeExecuteArgs, WorkflowId } from \"../types\";\nimport { emitPorts } from \"../contracts/emitPorts\";\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  readonly workflowId: WorkflowId;\n  readonly startAt: NodeId | undefined;\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    this.workflowId = args.workflowId;\n    this.startAt = args.startAt;\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\nexport class SubWorkflowRunnerNode implements RunnableNode<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(args: RunnableNodeExecuteArgs<SubWorkflowRunnerConfig<any, any>>): Promise<unknown> {\n    const current = args.item as Item;\n    const result = await this.workflows.runById({\n      workflowId: args.ctx.config.workflowId,\n      startAt: args.ctx.config.startAt,\n      items: [current],\n      parent: {\n        runId: args.ctx.runId,\n        workflowId: args.ctx.workflowId,\n        nodeId: args.ctx.nodeId,\n        subworkflowDepth: args.ctx.subworkflowDepth,\n        engineMaxNodeActivations: args.ctx.engineMaxNodeActivations,\n        engineMaxSubworkflowDepth: args.ctx.engineMaxSubworkflowDepth,\n      },\n    });\n    if (result.status !== \"completed\") {\n      throw new Error(`Subworkflow ${args.ctx.config.workflowId} did not complete (status=${result.status})`);\n    }\n    return emitPorts({ main: result.outputs });\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 { TypeToken } from \"../di\";\nimport type {\n  Item,\n  Items,\n  NodeExecutionContext,\n  RunnableNode,\n  RunnableNodeConfig,\n  RunnableNodeExecuteArgs,\n} from \"../types\";\nimport { emitPorts } from \"../contracts/emitPorts\";\n\nexport class SwitchHarnessNode implements RunnableNode<SwitchHarnessNodeConfig<any>> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [] as const;\n\n  async execute(args: RunnableNodeExecuteArgs<SwitchHarnessNodeConfig<any>>): Promise<unknown> {\n    const key = await Promise.resolve(\n      args.ctx.config.cfg.resolveCaseKey(args.item as Item, args.itemIndex, args.items, args.ctx),\n    );\n    const { cases, defaultCase } = args.ctx.config.cfg;\n    const port = cases.includes(key) ? key : defaultCase;\n    return emitPorts({\n      [port]: [args.item],\n    });\n  }\n}\n\nexport class SwitchHarnessNodeConfig<TInputJson = unknown> implements RunnableNodeConfig<TInputJson, TInputJson> {\n  readonly kind = \"node\" as const;\n  readonly type: TypeToken<unknown> = SwitchHarnessNode;\n  readonly declaredOutputPorts: ReadonlyArray<string>;\n\n  constructor(\n    public readonly name: string,\n    public readonly cfg: Readonly<{\n      cases: readonly string[];\n      defaultCase: string;\n      resolveCaseKey: (\n        item: Item<TInputJson>,\n        index: number,\n        items: Items<TInputJson>,\n        ctx: NodeExecutionContext<SwitchHarnessNodeConfig<TInputJson>>,\n      ) => string | Promise<string>;\n    }>,\n    public readonly opts: Readonly<{ id?: string }> = {},\n  ) {\n    this.declaredOutputPorts = [...new Set([...cfg.cases, cfg.defaultCase])].sort();\n  }\n\n  get id(): string | undefined {\n    return this.opts.id;\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\";\nimport { SwitchHarnessNode } from \"./SwitchHarnessNode\";\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(SwitchHarnessNode, new SwitchHarnessNode());\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.cjs","names":["name: string","inputSchema: ZodType<TIn>","runOne: (args: {\n      input: TIn;\n      item: Item<TIn>;\n      itemIndex: number;\n      items: Items<TIn>;\n      ctx: NodeExecutionContext<ItemHarnessNodeConfig<TIn, TOut>>;\n    }) => TOut | Promise<TOut>","opts: Readonly<{\n      id?: string;\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","emitPorts","name: string","id?: string","emitPorts","InMemoryWorkflowExecutionRepository","HintOnlyOffloadPolicy","InMemoryRunEventBus","InMemoryLiveWorkflowRepository","InMemoryRunDataFactory","DefaultExecutionContextFactory","tsyringeContainer","DefaultDrivingScheduler","InlineDrivingScheduler","NodeExecutor","NodeInstanceFactory","InProcessRetryRunner","DefaultAsyncSleeper","CoreTokens","PersistedWorkflowTokenRegistry","AllWorkflowsActiveWorkflowActivationPolicy","EngineRuntimeRegistrar","Engine","RunIntentService","runToCompletion: RegistrarEngineTestKitHandle[\"runToCompletion\"]","runIntentStartToCompletion: RegistrarEngineTestKitHandle[\"runIntentStartToCompletion\"]","WorkflowBuilder"],"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/SwitchHarnessNode.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, RunnableNode, RunnableNodeExecuteArgs } 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 RunnableNode<ItemHarnessNodeConfig<any, any>> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [\"main\"] as const;\n\n  async execute(args: RunnableNodeExecuteArgs<ItemHarnessNodeConfig<any, any>>): Promise<unknown> {\n    return await args.ctx.config.runOne({\n      input: args.input as never,\n      item: args.item as 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, 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 * then {@link ItemHarnessNode.execute} per item.\n */\nexport class ItemHarnessNodeConfig<TIn = unknown, TOut = unknown> implements RunnableNodeConfig<TIn, TOut> {\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<TIn>;\n      itemIndex: number;\n      items: Items<TIn>;\n      ctx: NodeExecutionContext<ItemHarnessNodeConfig<TIn, TOut>>;\n    }) => TOut | Promise<TOut>,\n    public readonly opts: Readonly<{\n      id?: string;\n    }> = {},\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 { Item, NodeId, RunnableNode, RunnableNodeConfig, RunnableNodeExecuteArgs, WorkflowId } from \"../types\";\nimport { emitPorts } from \"../contracts/emitPorts\";\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  readonly workflowId: WorkflowId;\n  readonly startAt: NodeId | undefined;\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    this.workflowId = args.workflowId;\n    this.startAt = args.startAt;\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\nexport class SubWorkflowRunnerNode implements RunnableNode<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(args: RunnableNodeExecuteArgs<SubWorkflowRunnerConfig<any, any>>): Promise<unknown> {\n    const current = args.item as Item;\n    const result = await this.workflows.runById({\n      workflowId: args.ctx.config.workflowId,\n      startAt: args.ctx.config.startAt,\n      items: [current],\n      parent: {\n        runId: args.ctx.runId,\n        workflowId: args.ctx.workflowId,\n        nodeId: args.ctx.nodeId,\n        subworkflowDepth: args.ctx.subworkflowDepth,\n        engineMaxNodeActivations: args.ctx.engineMaxNodeActivations,\n        engineMaxSubworkflowDepth: args.ctx.engineMaxSubworkflowDepth,\n      },\n    });\n    if (result.status !== \"completed\") {\n      throw new Error(`Subworkflow ${args.ctx.config.workflowId} did not complete (status=${result.status})`);\n    }\n    return emitPorts({ main: result.outputs });\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 { TypeToken } from \"../di\";\nimport type {\n  Item,\n  Items,\n  NodeExecutionContext,\n  RunnableNode,\n  RunnableNodeConfig,\n  RunnableNodeExecuteArgs,\n} from \"../types\";\nimport { emitPorts } from \"../contracts/emitPorts\";\n\nexport class SwitchHarnessNode implements RunnableNode<SwitchHarnessNodeConfig<any>> {\n  readonly kind = \"node\" as const;\n  readonly outputPorts = [] as const;\n\n  async execute(args: RunnableNodeExecuteArgs<SwitchHarnessNodeConfig<any>>): Promise<unknown> {\n    const key = await Promise.resolve(\n      args.ctx.config.cfg.resolveCaseKey(args.item as Item, args.itemIndex, args.items, args.ctx),\n    );\n    const { cases, defaultCase } = args.ctx.config.cfg;\n    const port = cases.includes(key) ? key : defaultCase;\n    return emitPorts({\n      [port]: [args.item],\n    });\n  }\n}\n\nexport class SwitchHarnessNodeConfig<TInputJson = unknown> implements RunnableNodeConfig<TInputJson, TInputJson> {\n  readonly kind = \"node\" as const;\n  readonly type: TypeToken<unknown> = SwitchHarnessNode;\n  readonly declaredOutputPorts: ReadonlyArray<string>;\n\n  constructor(\n    public readonly name: string,\n    public readonly cfg: Readonly<{\n      cases: readonly string[];\n      defaultCase: string;\n      resolveCaseKey: (\n        item: Item<TInputJson>,\n        index: number,\n        items: Items<TInputJson>,\n        ctx: NodeExecutionContext<SwitchHarnessNodeConfig<TInputJson>>,\n      ) => string | Promise<string>;\n    }>,\n    public readonly opts: Readonly<{ id?: string }> = {},\n  ) {\n    this.declaredOutputPorts = [...new Set([...cfg.cases, cfg.defaultCase])].sort();\n  }\n\n  get id(): string | undefined {\n    return this.opts.id;\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\";\nimport { SwitchHarnessNode } from \"./SwitchHarnessNode\";\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(SwitchHarnessNode, new SwitchHarnessNode());\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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"}

package/dist/testing.d.cts

@@ -1,5 +1,5 @@
-import { $n as WorkflowExecutionRepository, Bt as NodeExecutionRequest, E as NodeId, Er as Container, Gn as RunResult, Gr as EngineExecutionLimitsPolicy, Ht as NodeExecutionScheduler, J as WorkflowDefinition, Jr as RunEventBus, Jt as RunnableNode, L as RunDataFactory, Mr as TypeToken, O as NodeOffloadPolicy, P as ParentExecutionRef, Qt as TriggerNode, V as RunnableNodeConfig, W as TriggerNodeConfig, Yt as RunnableNodeExecuteArgs, en as TriggerSetupContext, et as WorkflowId, f as Items, k as NodeOutputs, kt as ExecutionContextFactory, n as InMemoryLiveWorkflowRepository, nn as TriggerSetupStateRepository, r as Engine, sn as WorkflowRunnerService, t as RunIntentService, u as Item, vr as CredentialSessionService, zt as NodeExecutionContext } from "./RunIntentService-B1Y3v1H6.cjs";
-import { a as WorkflowSnapshotCodec, n as EngineRuntimeRegistrationOptions, t as EngineWorkflowRunnerService } from "./EngineWorkflowRunnerService-Bf88QtwB.cjs";
+import { A as NodeOutputs, E as NodeId, F as ParentExecutionRef, G as TriggerNodeConfig, H as RunnableNodeConfig, Ht as NodeExecutionRequest, Jr as CredentialSessionService, R as RunDataFactory, Vt as NodeExecutionContext, Wt as NodeExecutionScheduler, Xt as RunnableNode, Y as WorkflowDefinition, Zt as RunnableNodeExecuteArgs, ci as TypeToken, en as TriggerNode, f as Items, in as TriggerSetupStateRepository, jt as ExecutionContextFactory, k as NodeOffloadPolicy, ln as WorkflowRunnerService, n as InMemoryLiveWorkflowRepository, ni as Container, nn as TriggerSetupContext, qn as RunResult, r as Engine, t as RunIntentService, tr as WorkflowExecutionRepository, tt as WorkflowId, u as Item, wi as RunEventBus, xi as EngineExecutionLimitsPolicy } from "./RunIntentService-S-1lW-gS.cjs";
+import { a as WorkflowSnapshotCodec, n as EngineRuntimeRegistrationOptions, t as EngineWorkflowRunnerService } from "./EngineWorkflowRunnerService-DzOCa1BW.cjs";
 import { DependencyContainer, InjectionToken } from "tsyringe";
 import { ZodType } from "zod";
 

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-import { $i as RunEventBus, $n as RunnableNode, $t as WorkflowDefinition, Ci as CredentialSessionService, Gn as NodeExecutionRequest, Ht as RunDataFactory, Kt as RunnableNodeConfig, Li as TypeToken, Nt as NodeOffloadPolicy, Pn as ExecutionContextFactory, Pt as NodeOutputs, Wn as NodeExecutionContext, Xi as EngineExecutionLimitsPolicy, Xr as RunResult, Yt as TriggerNodeConfig, _t as Items, an as WorkflowId, ar as TriggerSetupContext, er as RunnableNodeExecuteArgs, fr as WorkflowRunnerService, ht as Item, ii as WorkflowExecutionRepository, ji as Container, jt as NodeId, l as WorkflowSnapshotCodec, n as InMemoryLiveWorkflowRepository, qn as NodeExecutionScheduler, r as EngineWorkflowRunnerService, rr as TriggerNode, sr as TriggerSetupStateRepository, t as RunIntentService, u as Engine, zt as ParentExecutionRef } from "./RunIntentService-BDiodxhf.js";
-import { t as EngineRuntimeRegistrationOptions } from "./EngineRuntimeRegistration.types-Dm129RJ6.js";
+import { $n as NodeExecutionContext, Ht as NodeOutputs, Ia as RunEventBus, Na as EngineExecutionLimitsPolicy, Rt as NodeId, St as Item, Un as ExecutionContextFactory, Vt as NodeOffloadPolicy, Xt as RunDataFactory, ai as RunResult, ba as TypeToken, cr as RunnableNode, en as RunnableNodeConfig, er as NodeExecutionRequest, fr as TriggerNode, gr as TriggerSetupStateRepository, l as WorkflowSnapshotCodec, lr as RunnableNodeExecuteArgs, ma as Container, mr as TriggerSetupContext, n as InMemoryLiveWorkflowRepository, nr as NodeExecutionScheduler, oa as CredentialSessionService, pi as WorkflowExecutionRepository, pn as WorkflowId, qt as ParentExecutionRef, r as EngineWorkflowRunnerService, rn as TriggerNodeConfig, sn as WorkflowDefinition, t as RunIntentService, u as Engine, wt as Items, xr as WorkflowRunnerService } from "./RunIntentService-BqhmdoA1.js";
+import { t as EngineRuntimeRegistrationOptions } from "./EngineRuntimeRegistration.types-BP6tsaNP.js";
 import { DependencyContainer, InjectionToken } from "tsyringe";
 import { ZodType } from "zod";
 

package/dist/testing.js

@@ -1,6 +1,6 @@
-import { A as NodeExecutor, B as DefaultAsyncSleeper, D as PersistedWorkflowTokenRegistry, E as WorkflowSnapshotCodec, P as emitPorts, R as InProcessRetryRunner, T as NodeInstanceFactory, _t as CoreTokens, a as InMemoryLiveWorkflowRepository, b as HintOnlyOffloadPolicy, d as InMemoryRunDataFactory, i as RunIntentService, l as Engine, x as DefaultDrivingScheduler, y as InlineDrivingScheduler, z as DefaultExecutionContextFactory } from "./runtime-7Xh9z3dw.js";
-import { n as InMemoryRunEventBus, r as WorkflowBuilder, t as AllWorkflowsActiveWorkflowActivationPolicy } from "./workflowActivationPolicy-Td9HTOuD.js";
-import { n as InMemoryWorkflowExecutionRepository, t as EngineRuntimeRegistrar } from "./bootstrap-DdeiJ8cd.js";
+import { A as NodeExecutor, D as PersistedWorkflowTokenRegistry, E as WorkflowSnapshotCodec, F as InProcessRetryRunner, L as DefaultExecutionContextFactory, R as AllWorkflowsActiveWorkflowActivationPolicy, Rt as CoreTokens, T as NodeInstanceFactory, a as InMemoryLiveWorkflowRepository, b as DefaultDrivingScheduler, i as RunIntentService, it as emitPorts, l as Engine, st as DefaultAsyncSleeper, u as InMemoryRunDataFactory, v as InlineDrivingScheduler, y as HintOnlyOffloadPolicy } from "./runtime-DUW6tIJ1.js";
+import { n as WorkflowBuilder, t as InMemoryRunEventBus } from "./InMemoryRunEventBusRegistry-C2U83Hmv.js";
+import { n as InMemoryWorkflowExecutionRepository, t as EngineRuntimeRegistrar } from "./bootstrap-d_BMaDT4.js";
 import { container } from "tsyringe";
 
 //#region src/testing/RejectingCredentialSessionService.ts

package/package.json

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

package/src/ai/AgentConfigInspectorFactory.ts

@@ -1,5 +1,5 @@
 import type { NodeConfigBase } from "../types";
-import { isItemValue } from "../contracts/itemValue";
+import { isItemExpr } from "../contracts/itemExpr";
 import type { AgentNodeConfig } from "./AiHost";
 
 export class AgentConfigInspector {
@@ -18,7 +18,7 @@ export class AgentConfigInspector {
       return messages.length > 0;
     }
     if (typeof messages === "object") {
-      if (isItemValue(messages)) {
+      if (isItemExpr(messages)) {
         return true;
       }
       const o = messages as { prompt?: unknown; buildMessages?: unknown };

package/src/ai/AgentMessageConfigNormalizerFactory.ts

@@ -1,4 +1,4 @@
-import { isItemValue } from "../contracts/itemValue";
+import { isItemExpr } from "../contracts/itemExpr";
 
 import type {
   AgentMessageBuildArgs,
@@ -69,9 +69,9 @@ export class AgentMessageConfigNormalizer {
     config: AgentMessageConfig<TInputJson>,
     args: AgentMessageBuildArgs<TInputJson>,
   ): ReadonlyArray<AgentMessageDto> {
-    if (isItemValue(config)) {
+    if (isItemExpr(config)) {
       throw new Error(
-        "AIAgent messages wrapped in itemValue(...) must be resolved by the engine before prompt normalization.",
+        "AIAgent messages wrapped in itemExpr(...) must be resolved by the engine before prompt normalization.",
       );
     }
     if (Array.isArray(config)) {

package/src/ai/AiHost.ts

@@ -1,7 +1,7 @@
 import type { TypeToken } from "../di";
 
 import type { CredentialRequirement } from "../contracts/credentialTypes";
-import type { ItemValue } from "../contracts/itemValue";
+import type { Expr } from "../contracts/params";
 
 import type {
   Item,
@@ -92,7 +92,7 @@ export type AgentMessageLine<TInputJson = unknown> = AgentMessageDto | AgentMess
  * Use the object form only when you need `buildMessages` to append messages after optional `prompt` lines.
  */
 export type AgentMessageConfig<TInputJson = unknown> =
-  | ItemValue<ReadonlyArray<AgentMessageLine<TInputJson>>, TInputJson>
+  | Expr<ReadonlyArray<AgentMessageLine<TInputJson>>, TInputJson>
   | ReadonlyArray<AgentMessageLine<TInputJson>>
   | {
       readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson>>;
@@ -136,6 +136,8 @@ export type AgentToolCallPlanner<_TNodeConfig = unknown> = (
 export interface ChatModelConfig {
   readonly type: TypeToken<ChatModelFactory<ChatModelConfig>>;
   readonly name: string;
+  readonly provider?: string;
+  readonly modelName?: string;
   readonly presentation?: AgentCanvasPresentation;
   getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
 }

package/src/ai/CallableToolConfig.ts

@@ -1,7 +1,7 @@
 import type { CredentialRequirement } from "../contracts/credentialTypes";
 import type { TypeToken } from "../di";
 import type { AgentCanvasPresentation, ToolConfig, ToolExecuteArgs, ZodSchemaAny } from "./AiHost";
-import type { input as ZodInput, output as ZodOutput } from "zod";
+import { ZodError, type input as ZodInput, type output as ZodOutput } from "zod";
 
 import { CallableToolKindToken } from "./CallableToolKindToken";
 
@@ -71,7 +71,7 @@ export class CallableToolConfig<
   async executeTool(
     args: ToolExecuteArgs<CallableToolConfig<TInputSchema, TOutputSchema>, ZodInput<TInputSchema>>,
   ): Promise<ZodOutput<TOutputSchema>> {
-    const parsedInput = this.inputSchemaValue.parse(args.input) as ZodInput<TInputSchema>;
+    const parsedInput = this.parseInput(args.input);
     const raw = await Promise.resolve(
       this.executeHandler({
         ...args,
@@ -79,6 +79,31 @@ export class CallableToolConfig<
         input: parsedInput,
       }),
     );
-    return this.outputSchemaValue.parse(raw) as ZodOutput<TOutputSchema>;
+    return this.parseOutput(raw);
+  }
+
+  private parseInput(input: unknown): ZodInput<TInputSchema> {
+    try {
+      return this.inputSchemaValue.parse(input) as ZodInput<TInputSchema>;
+    } catch (error) {
+      throw this.decorateValidationError(error, "input");
+    }
+  }
+
+  private parseOutput(output: unknown): ZodOutput<TOutputSchema> {
+    try {
+      return this.outputSchemaValue.parse(output) as ZodOutput<TOutputSchema>;
+    } catch (error) {
+      throw this.decorateValidationError(error, "output");
+    }
+  }
+
+  private decorateValidationError(error: unknown, stage: "input" | "output"): Error {
+    if (error instanceof ZodError) {
+      (error as ZodError & { codemationToolValidationStage?: "input" | "output" }).codemationToolValidationStage =
+        stage;
+      return error;
+    }
+    return error instanceof Error ? error : new Error(String(error));
   }
 }

package/src/authoring/defineNode.types.ts

@@ -4,6 +4,7 @@ import type {
   CredentialRequirement,
   CredentialTypeId,
 } from "../contracts/credentialTypes";
+import type { ParamDeep } from "../contracts/params";
 import type { RunnableNode, RunnableNodeExecuteArgs, NodeExecutionContext } from "../contracts/runtimeTypes";
 import type { Item, Items, RunnableNodeConfig } from "../contracts/workflowTypes";
 import type { TypeToken } from "../di";
@@ -67,6 +68,11 @@ export type DefineNodeExecuteArgs<TConfig extends CredentialJsonRecord, TInputJs
   ctx: NodeExecutionContext<RunnableNodeConfig<TInputJson, unknown> & Readonly<{ config: TConfig }>>;
 }>;
 
+export type DefinedNodeConfigInput<TConfigResolved extends CredentialJsonRecord, TItemJson> = ParamDeep<
+  TConfigResolved,
+  TItemJson
+>;
+
 export interface DefinedNode<
   TKey extends string,
   TConfig extends CredentialJsonRecord,
@@ -78,7 +84,11 @@ export interface DefinedNode<
   readonly key: TKey;
   readonly title: string;
   readonly description?: string;
-  create(config: TConfig, name?: string, id?: string): RunnableNodeConfig<TInputJson, TOutputJson>;
+  create<TConfigItemJson = TInputJson>(
+    config: DefinedNodeConfigInput<TConfig, TConfigItemJson>,
+    name?: string,
+    id?: string,
+  ): RunnableNodeConfig<TInputJson, TOutputJson>;
   register(context: { registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>): void }): void;
 }
 
@@ -252,9 +262,13 @@ export function defineNode<
 
     constructor(
       public readonly name: string,
-      public readonly config: TConfig,
+      config: DefinedNodeConfigInput<TConfig, unknown>,
       public readonly id?: string,
-    ) {}
+    ) {
+      this.config = config as unknown as TConfig;
+    }
+
+    public readonly config: TConfig;
 
     getCredentialRequirements(): ReadonlyArray<CredentialRequirement> {
       return credentialRequirements;
@@ -266,8 +280,12 @@ export function defineNode<
     key: options.key,
     title: options.title,
     description: options.description,
-    create(config, name = options.title, id) {
-      return new DefinedRunnableNodeConfig(name, config, id);
+    create<TConfigItemJson = TInputJson>(
+      config: DefinedNodeConfigInput<TConfig, TConfigItemJson>,
+      name = options.title,
+      id?: string,
+    ) {
+      return new DefinedRunnableNodeConfig(name, config as DefinedNodeConfigInput<TConfig, unknown>, id);
     },
     register(context) {
       context.registerNode(DefinedNodeRuntime);
@@ -327,9 +345,13 @@ export function defineBatchNode<
 
     constructor(
       public readonly name: string,
-      public readonly config: TConfig,
+      config: DefinedNodeConfigInput<TConfig, unknown>,
       public readonly id?: string,
-    ) {}
+    ) {
+      this.config = config as unknown as TConfig;
+    }
+
+    public readonly config: TConfig;
 
     getCredentialRequirements(): ReadonlyArray<CredentialRequirement> {
       return credentialRequirements;
@@ -341,8 +363,12 @@ export function defineBatchNode<
     key: options.key,
     title: options.title,
     description: options.description,
-    create(config, name = options.title, id) {
-      return new DefinedRunnableNodeConfig(name, config, id);
+    create<TConfigItemJson = TInputJson>(
+      config: DefinedNodeConfigInput<TConfig, TConfigItemJson>,
+      name = options.title,
+      id?: string,
+    ) {
+      return new DefinedRunnableNodeConfig(name, config as DefinedNodeConfigInput<TConfig, unknown>, id);
     },
     register(context) {
       context.registerNode(DefinedNodeRuntime);

package/src/authoring/index.ts

@@ -1,6 +1,7 @@
 export { DefinedNodeRegistry } from "./DefinedNodeRegistry";
 export type {
   DefinedNode,
+  DefinedNodeConfigInput,
   DefinedNodeCredentialAccessors,
   DefinedNodeCredentialBinding,
   DefinedNodeCredentialBindings,

package/src/bootstrap/index.ts

@@ -26,7 +26,12 @@ export {
   WorkflowRepositoryWebhookTriggerMatcher,
 } from "../runtime";
 export { DefaultExecutionBinaryService, UnavailableBinaryStorage } from "../binaries";
-export { DefaultExecutionContextFactory, CredentialResolverFactory } from "../execution";
+export {
+  CatalogBackedCostTrackingTelemetryFactory,
+  CredentialResolverFactory,
+  DefaultExecutionContextFactory,
+  StaticCostCatalog,
+} from "../execution";
 export {
   InMemoryBinaryStorage,
   InMemoryRunDataFactory,

package/src/bootstrap/runtime/EngineRuntimeRegistrar.ts

@@ -4,7 +4,7 @@ import { EngineExecutionLimitsPolicyFactory } from "../../policies/executionLimi
 import {
   DefaultAsyncSleeper,
   InProcessRetryRunnerFactory,
-  ItemValueResolver,
+  ItemExprResolver,
   NodeExecutor,
   NodeExecutorFactory,
   NodeInstanceFactoryFactory,
@@ -41,8 +41,8 @@ export class EngineRuntimeRegistrar {
   }
 
   private registerSupportFactories(container: DependencyContainer): void {
-    if (!container.isRegistered(ItemValueResolver, true)) {
-      container.registerSingleton(ItemValueResolver, ItemValueResolver);
+    if (!container.isRegistered(ItemExprResolver, true)) {
+      container.registerSingleton(ItemExprResolver, ItemExprResolver);
     }
     if (!container.isRegistered(NodeOutputNormalizer, true)) {
       container.registerSingleton(NodeOutputNormalizer, NodeOutputNormalizer);
@@ -163,6 +163,7 @@ export class EngineRuntimeRegistrar {
           tokenRegistry: tokenRegistryLike,
           workflowNodeInstanceFactory,
           executionLimitsPolicy: dependencyContainer.resolve(CoreTokens.EngineExecutionLimitsPolicy),
+          workflowPolicyRuntimeDefaults: options?.workflowPolicyRuntimeDefaults,
           triggerRuntimeDiagnostics,
         });
       }),

package/src/bootstrap/runtime/EngineRuntimeRegistration.types.ts

@@ -2,6 +2,7 @@ import type { DependencyContainer } from "../../di";
 import type { WebhookTriggerMatcher } from "../../types";
 import type { WebhookTriggerRoutingDiagnostics } from "../../contracts/webhookTypes";
 import type { TriggerRuntimeDiagnostics } from "../../contracts/runtimeTypes";
+import type { WorkflowPolicyRuntimeDefaults } from "../../contracts/workflowTypes";
 import type { EngineExecutionLimitsPolicyConfig } from "../../policies/executionLimits/EngineExecutionLimitsPolicy";
 
 /**
@@ -40,4 +41,6 @@ export interface EngineRuntimeRegistrationOptions {
   webhookTriggerMatcherProvider?: WebhookTriggerMatcherProvider;
   /** Overrides default trigger diagnostics (undefined when omitted). */
   triggerRuntimeDiagnosticsProvider?: TriggerRuntimeDiagnosticsProvider;
+  /** Runtime retention/storage defaults used when workflows omit prune/storage policy fields. */
+  workflowPolicyRuntimeDefaults?: WorkflowPolicyRuntimeDefaults;
 }

package/src/contracts/CodemationTelemetryAttributeNames.ts

@@ -0,0 +1,12 @@
+export class CodemationTelemetryAttributeNames {
+  static readonly workflowId = "codemation.workflow.id";
+  static readonly runId = "codemation.run.id";
+  static readonly nodeId = "codemation.node.id";
+  static readonly activationId = "codemation.activation.id";
+  static readonly nodeType = "codemation.node.type";
+  static readonly nodeRole = "codemation.node.role";
+  static readonly workflowFolder = "codemation.workflow.folder";
+  static readonly connectionInvocationId = "codemation.connection.invocation_id";
+  static readonly toolName = "codemation.tool.name";
+  static readonly traceParentRunId = "codemation.parent.run.id";
+}

package/src/contracts/CodemationTelemetryMetricNames.ts

@@ -0,0 +1,7 @@
+export class CodemationTelemetryMetricNames {
+  static readonly agentTurns = "codemation.ai.turns";
+  static readonly agentToolCalls = "codemation.ai.tool_calls";
+  static readonly gmailMessagesEmitted = "codemation.gmail.messages_emitted";
+  static readonly gmailAttachments = "codemation.gmail.attachments";
+  static readonly gmailAttachmentBytes = "codemation.gmail.attachment_bytes";
+}

package/src/contracts/CostCatalogContract.ts

@@ -0,0 +1,16 @@
+import type { CostTrackingUsageRecord } from "./CostTrackingTelemetryContract";
+
+export interface CostCatalogEntry {
+  readonly component: CostTrackingUsageRecord["component"];
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly pricePerUnitMinor: number;
+}
+
+export interface CostCatalog {
+  findEntry(args: CostTrackingUsageRecord): CostCatalogEntry | undefined;
+}

package/src/contracts/CostTrackingTelemetryContract.ts

@@ -0,0 +1,47 @@
+import type { ExecutionTelemetry } from "./telemetryTypes";
+import type { TelemetryAttributes, TelemetryScope } from "./telemetryTypes";
+
+export type CostTrackingComponent = "chat" | "ocr" | "rag";
+
+export const CostTrackingTelemetryMetricNames = {
+  usage: "codemation.cost.usage",
+  estimatedCost: "codemation.cost.estimated",
+} as const;
+
+export const CostTrackingTelemetryAttributeNames = {
+  component: "cost.component",
+  provider: "cost.provider",
+  operation: "cost.operation",
+  pricingKey: "cost.pricing_key",
+  usageUnit: "cost.usage_unit",
+  currency: "cost.currency",
+  currencyScale: "cost.currency_scale",
+  estimateKind: "cost.estimate_kind",
+} as const;
+
+export interface CostTrackingUsageRecord {
+  readonly component: CostTrackingComponent;
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly quantity: number;
+  readonly modelName?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+
+export interface CostTrackingPriceQuote {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedAmountMinor: number;
+  readonly estimateKind: "catalog";
+}
+
+export interface CostTrackingTelemetry {
+  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
+  forScope(scope: TelemetryScope): CostTrackingTelemetry;
+}
+
+export interface CostTrackingTelemetryFactory {
+  create(args: Readonly<{ telemetry: ExecutionTelemetry }>): CostTrackingTelemetry;
+}

package/src/contracts/GenAiTelemetryAttributeNames.ts

@@ -0,0 +1,10 @@
+export class GenAiTelemetryAttributeNames {
+  static readonly operationName = "gen_ai.operation.name";
+  static readonly requestModel = "gen_ai.request.model";
+  static readonly usageInputTokens = "gen_ai.usage.input_tokens";
+  static readonly usageOutputTokens = "gen_ai.usage.output_tokens";
+  static readonly usageTotalTokens = "gen_ai.usage.total_tokens";
+  static readonly usageCacheReadInputTokens = "gen_ai.usage.cache_read.input_tokens";
+  static readonly usageCacheCreationInputTokens = "gen_ai.usage.cache_creation.input_tokens";
+  static readonly usageReasoningTokens = "codemation.gen_ai.usage.reasoning_tokens";
+}