@codemation/core 1.0.0 → 2.0.0

package/dist/testing.cjs

@@ -1,6 +1,6 @@
-const require_runtime = require('./runtime-DWKfb0BI.cjs');
-const require_InMemoryRunEventBusRegistry = require('./InMemoryRunEventBusRegistry-B0_C4OnP.cjs');
-const require_bootstrap = require('./bootstrap-BfZE19lK.cjs');
+const require_runtime = require('./runtime-DKXJwTNv.cjs');
+const require_InMemoryRunEventBusRegistry = require('./InMemoryRunEventBusRegistry-VM3OWnHo.cjs');
+const require_bootstrap = require('./bootstrap-Cm5ruQxx.cjs');
 let tsyringe = require("tsyringe");
 tsyringe = require_runtime.__toESM(tsyringe);
 
@@ -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_InMemoryRunEventBusRegistry.WorkflowBuilder({
+		return new require_runtime.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.registerSingleton(token as never, (implementation ?? token) as never);\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.registerSingleton(token as never, (implementation ?? token) as never);\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 { 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 { Ci as EngineExecutionLimitsPolicy, D as NodeOffloadPolicy, Ei as RunEventBus, Et as ExecutionContextFactory, Fi as NodeId, G as WorkflowDefinition, It as NodeExecutionContext, Jr as RunResult, Kt as RunnableNode, Lt as NodeExecutionRequest, M as ParentExecutionRef, O as NodeOutputs, P as RunDataFactory, Qt as TriggerSetupContext, R as RunnableNodeConfig, Ri as WorkflowId, V as TriggerNodeConfig, Xt as TriggerNode, an as WorkflowRunnerService, d as Items, dr as CredentialSessionService, en as TriggerSetupStateRepository, ii as Container, l as Item, n as InMemoryLiveWorkflowRepository, qt as RunnableNodeExecuteArgs, r as Engine, ri as WorkflowExecutionRepository, t as RunIntentService, ui as TypeToken, zt as NodeExecutionScheduler } from "./RunIntentService-siBSjaaY.cjs";
+import { a as WorkflowSnapshotCodec, i as EngineWorkflowRunnerService, t as EngineRuntimeRegistrationOptions } from "./EngineRuntimeRegistration.types-pB3FnzqR.cjs";
 import { DependencyContainer, InjectionToken } from "tsyringe";
 import { ZodType } from "zod";
 

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-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 { Aa as TypeToken, Ca as WorkflowExecutionRepository, Jt as NodeOutputs, Ka as RunEventBus, Kn as ExecutionContextFactory, Qt as ParentExecutionRef, Tr as WorkflowRunnerService, Ua as EngineExecutionLimitsPolicy, ar as NodeExecutionScheduler, br as TriggerSetupStateRepository, dn as WorkflowDefinition, en as RunDataFactory, fr as RunnableNode, gr as TriggerNode, i as WorkflowSnapshotCodec, in as RunnableNodeConfig, io as WorkflowId, ji as CredentialSessionService, jt as Items, kt as Item, ma as RunResult, n as InMemoryLiveWorkflowRepository, nr as NodeExecutionContext, pr as RunnableNodeExecuteArgs, qt as NodeOffloadPolicy, r as EngineWorkflowRunnerService, rr as NodeExecutionRequest, sn as TriggerNodeConfig, t as RunIntentService, to as NodeId, u as Engine, vr as TriggerSetupContext, wa as Container } from "./RunIntentService-BE9CAkbf.js";
+import { t as EngineRuntimeRegistrationOptions } from "./EngineRuntimeRegistration.types-D1fyApMI.js";
 import { DependencyContainer, InjectionToken } from "tsyringe";
 import { ZodType } from "zod";
 

package/dist/testing.js

@@ -1,6 +1,6 @@
-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-u6O644ST.js";
-import { n as WorkflowBuilder, t as InMemoryRunEventBus } from "./InMemoryRunEventBusRegistry-C2U83Hmv.js";
-import { n as InMemoryWorkflowExecutionRepository, t as EngineRuntimeRegistrar } from "./bootstrap-jqh1kCNI.js";
+import { A as PersistedWorkflowTokenRegistry, B as DefaultExecutionContextFactory, C as DefaultDrivingScheduler, Ct as WorkflowBuilder, K as AllWorkflowsActiveWorkflowActivationPolicy, N as NodeExecutor, O as NodeInstanceFactory, R as InProcessRetryRunner, S as HintOnlyOffloadPolicy, a as InMemoryLiveWorkflowRepository, en as CoreTokens, i as RunIntentService, k as WorkflowSnapshotCodec, l as Engine, p as InMemoryRunDataFactory, st as emitPorts, ut as DefaultAsyncSleeper, x as InlineDrivingScheduler } from "./runtime-BGNbRnqs.js";
+import { t as InMemoryRunEventBus } from "./InMemoryRunEventBusRegistry-sM4z4n_i.js";
+import { a as InMemoryWorkflowExecutionRepository, t as EngineRuntimeRegistrar } from "./bootstrap-D3r505ko.js";
 import { container } from "tsyringe";
 
 //#region src/testing/RejectingCredentialSessionService.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemation/core",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -30,6 +30,10 @@
       "types": "./src/browser.ts",
       "import": "./src/browser.ts"
     },
+    "./contracts": {
+      "types": "./src/contracts.ts",
+      "import": "./src/contracts.ts"
+    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "development": {
@@ -68,6 +72,7 @@
     "build": "tsdown",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "eslint .",
-    "test": "pnpm build && vitest run"
+    "test": "pnpm build && vitest run",
+    "test:unit": "vitest run"
   }
 }

package/src/ai/AiHost.ts

@@ -37,6 +37,15 @@ export type ToolExecuteArgs<TConfig extends ToolConfig = ToolConfig, TInput = un
   item: Item;
   itemIndex: number;
   items: Items;
+  /**
+   * Optional sub-agent boundary hooks: when present, the live `agent.tool.call` span and the
+   * planned tool-call invocationId are forwarded so node-backed runtimes can re-root their child
+   * execution scope. Plain function tools may safely ignore these hooks.
+   */
+  hooks?: Readonly<{
+    parentSpan?: import("../contracts/telemetryTypes").TelemetrySpanScope;
+    parentInvocationId?: import("../contracts/runTypes").ConnectionInvocationId;
+  }>;
 }>;
 
 export interface Tool<

package/src/authoring/DefinedCollectionRegistry.ts

@@ -0,0 +1,17 @@
+import type { CollectionDefinition } from "./defineCollection.types";
+
+export class DefinedCollectionRegistry {
+  private static readonly definitions = new Map<string, CollectionDefinition>();
+
+  static register(definition: CollectionDefinition): void {
+    this.definitions.set(definition.name, definition);
+  }
+
+  static resolve(name: string): CollectionDefinition | undefined {
+    return this.definitions.get(name);
+  }
+
+  static list(): ReadonlyArray<CollectionDefinition> {
+    return Array.from(this.definitions.values());
+  }
+}

package/src/authoring/defineCollection.types.ts

@@ -0,0 +1,181 @@
+import { DefinedCollectionRegistry } from "./DefinedCollectionRegistry";
+
+export type CollectionFieldType = "text" | "int" | "bigint" | "double" | "bool" | "timestamptz" | "jsonb" | "uuid";
+
+export interface CollectionColumnBuilder {
+  notNull(): CollectionColumnBuilder;
+  default(value: unknown): CollectionColumnBuilder;
+  readonly _type: CollectionFieldType;
+  readonly _nullable: boolean;
+  readonly _default?: unknown;
+}
+
+class CollectionColumnBuilderImpl implements CollectionColumnBuilder {
+  _nullable: boolean;
+  _default?: unknown;
+
+  constructor(readonly _type: CollectionFieldType) {
+    this._nullable = true;
+  }
+
+  notNull(): CollectionColumnBuilder {
+    this._nullable = false;
+    return this;
+  }
+
+  default(value: unknown): CollectionColumnBuilder {
+    this._default = value;
+    this._nullable = false;
+    return this;
+  }
+}
+
+export const c = {
+  text(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("text");
+  },
+  int(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("int");
+  },
+  bigint(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("bigint");
+  },
+  double(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("double");
+  },
+  bool(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("bool");
+  },
+  timestamptz(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("timestamptz");
+  },
+  jsonb(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("jsonb");
+  },
+  uuid(): CollectionColumnBuilder {
+    return new CollectionColumnBuilderImpl("uuid");
+  },
+} as const;
+
+export interface CollectionFieldDefinition {
+  readonly type: CollectionFieldType;
+  readonly nullable: boolean;
+  readonly default?: unknown;
+}
+
+export interface CollectionIndexDefinition {
+  readonly on: ReadonlyArray<string>;
+  readonly unique?: boolean;
+}
+
+export interface CollectionDefinition {
+  readonly name: string;
+  readonly fields: Readonly<Record<string, CollectionFieldDefinition>>;
+  readonly indexes: ReadonlyArray<CollectionIndexDefinition>;
+}
+
+export interface DefinedCollection<TDefinition extends CollectionDefinition = CollectionDefinition> {
+  readonly kind: "defined-collection";
+  readonly definition: TDefinition;
+  register(context: { registerCollection(d: CollectionDefinition): void }): void;
+}
+
+/**
+ * Validates that a name follows the required pattern: lowercase + underscores, starts with letter.
+ */
+function validateCollectionName(name: string): void {
+  const pattern = /^[a-z][a-z0-9_]*$/;
+  if (!pattern.test(name)) {
+    throw new Error(
+      `Collection name "${name}" must start with a lowercase letter and contain only lowercase letters, digits, and underscores.`,
+    );
+  }
+}
+
+/**
+ * Validates that all field names follow the required pattern.
+ */
+function validateFieldNames(fields: Record<string, CollectionFieldDefinition>): void {
+  const pattern = /^[a-z][a-z0-9_]*$/;
+  const reserved = ["id", "created_at", "updated_at"];
+
+  for (const fieldName of Object.keys(fields)) {
+    if (reserved.includes(fieldName)) {
+      throw new Error(`Field name "${fieldName}" is reserved for internal use.`);
+    }
+    if (!pattern.test(fieldName)) {
+      throw new Error(
+        `Field name "${fieldName}" must start with a lowercase letter and contain only lowercase letters, digits, and underscores.`,
+      );
+    }
+  }
+}
+
+/**
+ * Validates that all indexed fields exist in the declared fields.
+ */
+function validateIndexes(indexes: ReadonlyArray<CollectionIndexDefinition>, fieldNames: Set<string>): void {
+  for (const index of indexes) {
+    for (const fieldName of index.on) {
+      if (!fieldNames.has(fieldName)) {
+        throw new Error(`Index references non-existent field "${fieldName}".`);
+      }
+    }
+  }
+}
+
+export interface DefineCollectionOptions {
+  readonly name: string;
+  readonly fields: Record<string, CollectionColumnBuilder>;
+  readonly indexes?: ReadonlyArray<CollectionIndexDefinition>;
+}
+
+export function defineCollection<TName extends string>(
+  options: DefineCollectionOptions & { name: TName },
+): DefinedCollection<
+  CollectionDefinition & {
+    name: TName;
+  }
+> {
+  validateCollectionName(options.name);
+
+  // Convert the column builders to field definitions
+  const fields: Record<string, CollectionFieldDefinition> = {};
+  for (const [fieldName, builder] of Object.entries(options.fields)) {
+    const columnBuilder = builder as CollectionColumnBuilder;
+    fields[fieldName] = {
+      type: columnBuilder._type,
+      nullable: columnBuilder._nullable,
+      default: columnBuilder._default,
+    };
+  }
+
+  validateFieldNames(fields);
+
+  const fieldNames = new Set(Object.keys(fields));
+  const indexes = options.indexes ?? [];
+  validateIndexes(indexes, fieldNames);
+
+  const definition: CollectionDefinition = {
+    name: options.name,
+    fields,
+    indexes,
+  };
+
+  // Register immediately (mirror defineNode behavior)
+  DefinedCollectionRegistry.register(definition);
+
+  const result: DefinedCollection = {
+    kind: "defined-collection",
+    definition,
+    register(context: { registerCollection(d: CollectionDefinition): void }) {
+      context.registerCollection(definition);
+    },
+  };
+
+  return result as DefinedCollection<
+    CollectionDefinition & {
+      name: TName;
+    }
+  >;
+}