@axlsdk/testing 0.19.0 → 0.20.0

package/README.md

@@ -116,9 +116,22 @@ const runtime = new AxlTestRuntime();
 runtime.register(myWorkflow);
 
 // Mock the LLM
-runtime.mockProvider('openai', MockProvider.sequence([
-  { content: '42' },
-]));
+runtime.mockProvider(
+  'openai',
+  MockProvider.sequence([
+    {
+      content: '',
+      tool_calls: [
+        {
+          id: 'call-calculator',
+          type: 'function',
+          function: { name: 'calculator', arguments: '{"expression":"2+2"}' },
+        },
+      ],
+    },
+    { content: '42' },
+  ]),
+);
 
 // Mock tools
 runtime.mockTool('calculator', async ({ expression }) => ({ result: 4 }));
@@ -126,13 +139,23 @@ runtime.mockTool('calculator', async ({ expression }) => ({ result: 4 }));
 // Execute
 const result = await runtime.execute('my-workflow', { question: 'What is 2+2?' });
 
-// Inspect recorded calls
-expect(runtime.agentCalls()).toHaveLength(1);
-expect(runtime.toolCalls()).toHaveLength(1);
+// Inspect recorded calls. Every accepted call has a terminal v2 outcome.
+expect(runtime.agentCalls()).toHaveLength(2); // tool request + final provider turn
+const [call] = runtime.toolCalls('calculator');
+if (call.outcome.status !== 'succeeded') {
+  throw new Error(`Expected calculator to succeed, got ${call.outcome.status}`);
+}
+expect(call.outcome.result).toEqual({ result: 4 });
 expect(runtime.totalCost()).toBe(0);
 expect(runtime.unpriced()).toBe(false); // true if any call used an unpriced model → totalCost() is a lower bound
 ```
 
+Recorded tool calls also carry `executionId`, `askId`, and `callId` for exact
+correlation. Failed, denied, and pre-result cancelled outcomes intentionally do
+not expose a top-level `result`; narrow `outcome.status` first. Configured mocks
+bypass the local schema, approval, retry, hooks, and real handler, while still
+using the configured tool's `sensitive` and `toModelOutput` policies.
+
 For testing human-in-the-loop flows:
 
 ```typescript
@@ -146,7 +169,7 @@ const runtime = new AxlTestRuntime({
 ```typescript
 import { AxlTestRuntime } from '@axlsdk/testing';
 
-// Verbose trace mode — populates agent_call_end.data.messages
+// Verbose trace mode — populates agent_call_start.data.messages
 const runtime = new AxlTestRuntime({
   config: { trace: { level: 'full' } },
 });

package/dist/index.cjs

@@ -235,6 +235,15 @@ var import_axl = require("@axlsdk/axl");
 function generateExecutionId() {
   return `test-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
 }
+function preserveDrainCause(error, cause) {
+  if (cause === void 0 || cause === error || "cause" in error) return error;
+  Object.defineProperty(error, "cause", {
+    configurable: true,
+    enumerable: false,
+    value: cause
+  });
+  return error;
+}
 var AxlTestRuntime = class {
   workflows = /* @__PURE__ */ new Map();
   mockProviders = /* @__PURE__ */ new Map();
@@ -306,6 +315,7 @@ var AxlTestRuntime = class {
       // Thread `events` config so tests can exercise the queue cap and
       // overflow policy on `ctx.events`. Mirrors the production runtime.
       eventStreamOptions: options?.events,
+      branchDrainTimeoutMs: options?.branchDrainTimeoutMs,
       // Production runtime threads this (see `runtime.ts:594` in
       // `execute()` and `:765` in `stream()`). `emitEvent` auto-stamps
       // `event.workflow` from it, so consumers grouping by workflow
@@ -324,9 +334,17 @@ var AxlTestRuntime = class {
           type: event.type,
           data: event.data
         });
-        if (event.type === "tool_call_end" && event.data) {
-          const { args, result } = event.data;
-          this._toolCalls.push({ name: event.tool, args, result });
+        if (event.type === "tool_call_end") {
+          const { args, requestedTool, outcome } = event.data;
+          this._toolCalls.push({
+            name: event.tool,
+            executionId: event.executionId,
+            askId: event.askId,
+            callId: event.callId,
+            args,
+            ...requestedTool !== void 0 ? { requestedTool } : {},
+            outcome
+          });
         }
         this._totalCost += (0, import_axl.eventCostContribution)(event);
         if ((0, import_axl.isUnpricedLeaf)(event)) this._unpriced = true;
@@ -355,23 +373,33 @@ var AxlTestRuntime = class {
     ctx._emitWorkflowStart(validated);
     try {
       const result = await workflow.handler(ctx);
+      const observation = await ctx._drainBranchWork();
       if (workflow.outputSchema) workflow.outputSchema.parse(result);
       ctx._emitWorkflowEnd({
         status: "completed",
         duration: Date.now() - startedAt,
-        result
+        result,
+        observation
       });
       if (this.recordPath) await this._writeRecording();
       return result;
     } catch (err) {
-      const aborted = typeof err === "object" && err !== null && err.name === "AbortError";
+      let workflowError = err;
+      let observation = { complete: true };
+      try {
+        observation = await ctx._drainBranchWork();
+      } catch (drainError) {
+        workflowError = drainError instanceof Error ? preserveDrainCause(drainError, workflowError) : drainError;
+      }
+      const aborted = typeof workflowError === "object" && workflowError !== null && workflowError.name === "AbortError";
       ctx._emitWorkflowEnd({
         status: "failed",
         duration: Date.now() - startedAt,
-        error: err instanceof Error ? err.message : String(err),
-        ...aborted ? { aborted: true } : {}
+        error: workflowError instanceof Error ? workflowError.message : String(workflowError),
+        ...aborted ? { aborted: true } : {},
+        observation
       });
-      throw err;
+      throw workflowError;
     }
   }
   toolCalls(name) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/mock-provider.ts","../src/mock-tool.ts","../src/test-runtime.ts"],"sourcesContent":["export { AxlTestRuntime } from './test-runtime.js';\nexport type { RecordedToolCall, RecordedAgentCall, RecordedStep } from './test-runtime.js';\nexport { MockProvider } from './mock-provider.js';\nexport { MockTool } from './mock-tool.js';\n","import { readFileSync } from 'node:fs';\nimport { z } from 'zod';\nimport type {\n  ChatMessage,\n  ChatOptions,\n  ToolCallMessage,\n  ProviderResponse,\n  StreamChunk,\n  Provider,\n} from '@axlsdk/axl';\n\nfunction randomAlphanumeric(length: number): string {\n  const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * chars.length)];\n  }\n  return result;\n}\n\nfunction generateFromSchema(schema: unknown): unknown {\n  if (schema instanceof z.ZodString) return randomAlphanumeric(8 + Math.floor(Math.random() * 13));\n  if (schema instanceof z.ZodNumber) {\n    const min = Number.isFinite(schema.minValue) ? schema.minValue! : 0;\n    const max = Number.isFinite(schema.maxValue) ? schema.maxValue! : 100;\n    return min + Math.random() * (max - min);\n  }\n  if (schema instanceof z.ZodBoolean) return Math.random() < 0.5;\n  if (schema instanceof z.ZodArray) {\n    const count = 1 + Math.floor(Math.random() * 3);\n    return Array.from({ length: count }, () => generateFromSchema(schema.element));\n  }\n  if (schema instanceof z.ZodObject) {\n    const obj: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(schema.shape)) obj[key] = generateFromSchema(value);\n    return obj;\n  }\n  if (schema instanceof z.ZodOptional) {\n    if (Math.random() < 0.5) return undefined;\n    return generateFromSchema(schema.unwrap());\n  }\n  if (schema instanceof z.ZodDefault) return schema.parse(undefined);\n  if (schema instanceof z.ZodEnum) {\n    const values = schema.options;\n    return values.length > 0 ? values[Math.floor(Math.random() * values.length)] : '';\n  }\n  if (schema instanceof z.ZodLiteral) return [...schema.values][0];\n  if (schema instanceof z.ZodNullable) return null;\n  if (schema instanceof z.ZodUnion) {\n    const options = schema.options;\n    return generateFromSchema(options[Math.floor(Math.random() * options.length)]);\n  }\n  return {};\n}\n\nexport class MockProvider implements Provider {\n  readonly name = 'mock';\n  private _calls: { messages: ChatMessage[]; options: ChatOptions }[] = [];\n  /** Per-call optional chunk arrays, set by `sequence()` / `chunked()` so\n   *  `stream()` can yield one `text_delta` per chunk. Per-call indexed\n   *  alongside the response sequence. */\n  private chunkSequence?: Array<string[] | undefined>;\n  /** Optional ms delay between successive chunks during `stream()`. Useful\n   *  for dev fixtures that need to demonstrate streaming UX visually\n   *  (without a delay, mock chunks fire synchronously and complete in\n   *  microseconds — invisible to a human watching). Default 0 keeps\n   *  every existing test fast.\n   *\n   *  Set via `provider.chunkDelayMs = 50` after construction. Not part of\n   *  any factory's surface to keep the test API minimal. */\n  chunkDelayMs = 0;\n\n  private constructor(\n    private responseFn: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) => ProviderResponse | Promise<ProviderResponse>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async chat(messages: ChatMessage[], options: ChatOptions): Promise<ProviderResponse> {\n    this._calls.push({ messages, options });\n    return await this.responseFn(messages, this._calls.length - 1);\n  }\n\n  async *stream(messages: ChatMessage[], options: ChatOptions): AsyncGenerator<StreamChunk> {\n    const callIndex = this._calls.length;\n    const response = await this.chat(messages, options);\n    const chunks = this.chunkSequence?.[callIndex];\n    if (chunks && chunks.length > 0) {\n      // Sanity guard — if a caller passes chunks AND content, they MUST\n      // match. Otherwise tests pass while the real prod content silently\n      // diverges from what the streaming path observes.\n      const joined = chunks.join('');\n      if (joined !== response.content) {\n        throw new Error(\n          `MockProvider.stream: chunks.join('') !== content. ` +\n            `chunks=\"${joined}\" content=\"${response.content}\"`,\n        );\n      }\n      for (let i = 0; i < chunks.length; i++) {\n        yield { type: 'text_delta', content: chunks[i] };\n        if (this.chunkDelayMs > 0 && i < chunks.length - 1) {\n          await new Promise((resolve) => setTimeout(resolve, this.chunkDelayMs));\n        }\n      }\n    } else if (response.content) {\n      yield { type: 'text_delta', content: response.content };\n    }\n    if (response.tool_calls) {\n      for (const tc of response.tool_calls) {\n        yield {\n          type: 'tool_call_delta',\n          id: tc.id,\n          name: tc.function.name,\n          arguments: tc.function.arguments,\n        };\n      }\n    }\n    yield { type: 'done', usage: response.usage, providerMetadata: response.providerMetadata };\n  }\n\n  static sequence(\n    responses: Array<{\n      content: string;\n      tool_calls?: ToolCallMessage[];\n      providerMetadata?: Record<string, unknown>;\n      usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n      cost?: number;\n      /** When set, `stream()` yields one `text_delta` per entry instead\n       *  of one big delta with the full content. Use to exercise\n       *  partial-JSON parsing, structural-boundary throttling, and\n       *  cross-attempt token retention in tests. Must satisfy\n       *  `chunks.join('') === content`. */\n      chunks?: string[];\n    }>,\n  ): MockProvider {\n    const provider = new MockProvider((_messages, callIndex) => {\n      if (callIndex >= responses.length) {\n        throw new Error(\n          `MockProvider.sequence: no response for call index ${callIndex}. Only ${responses.length} responses defined.`,\n        );\n      }\n      const resp = responses[callIndex];\n      return {\n        content: resp.content,\n        tool_calls: resp.tool_calls,\n        providerMetadata: resp.providerMetadata,\n        usage: resp.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: resp.cost ?? 0,\n      };\n    });\n    provider.chunkSequence = responses.map((r) => r.chunks);\n    return provider;\n  }\n\n  /**\n   * Convenience: build a `sequence()` from plain content strings, splitting\n   * each one into fixed-size chunks for the streaming path. Default\n   * `chunkSize` is 4 chars (≈1 token).\n   */\n  static chunked(contents: string[], chunkSize = 4): MockProvider {\n    const responses = contents.map((content) => {\n      const chunks: string[] = [];\n      for (let i = 0; i < content.length; i += chunkSize) {\n        chunks.push(content.slice(i, i + chunkSize));\n      }\n      return { content, chunks };\n    });\n    return MockProvider.sequence(responses);\n  }\n\n  static echo(): MockProvider {\n    return new MockProvider((messages) => {\n      const lastUser = [...messages].reverse().find((m) => m.role === 'user');\n      return {\n        content: lastUser?.content ?? '',\n        usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: 0,\n      };\n    });\n  }\n\n  static json(schema: unknown): MockProvider {\n    return new MockProvider(() => ({\n      content: JSON.stringify(generateFromSchema(schema)),\n      usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n      cost: 0,\n    }));\n  }\n\n  static replay(source: string | ProviderResponse[]): MockProvider {\n    const data =\n      typeof source === 'string'\n        ? (JSON.parse(readFileSync(source, 'utf-8')) as ProviderResponse[])\n        : source;\n    return new MockProvider((_messages, callIndex) => {\n      if (callIndex >= data.length) {\n        throw new Error(`MockProvider.replay: no recorded response for call index ${callIndex}`);\n      }\n      return data[callIndex];\n    });\n  }\n\n  static fn(\n    handler: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) =>\n      | {\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }\n      | Promise<{\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }>,\n  ): MockProvider {\n    return new MockProvider(async (messages, callIndex) => {\n      const result = await handler(messages, callIndex);\n      return {\n        ...result,\n        usage: result.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: result.cost ?? 0,\n      };\n    });\n  }\n}\n","export class MockTool {\n  private _calls: { input: unknown }[] = [];\n\n  constructor(\n    readonly name: string,\n    private handler: (input: unknown) => unknown | Promise<unknown>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async execute(input: unknown): Promise<unknown> {\n    this._calls.push({ input });\n    return this.handler(input);\n  }\n\n  static create(name: string, handler: (input: unknown) => unknown | Promise<unknown>): MockTool {\n    return new MockTool(name, handler);\n  }\n}\n","import { MockProvider } from './mock-provider.js';\nimport { MockTool } from './mock-tool.js';\nimport type {\n  AxlEvent,\n  AwaitHumanOptions,\n  HumanDecision,\n  ProviderResponse,\n  AgentCallInfo,\n  AxlConfig,\n  AnyWorkflow,\n} from '@axlsdk/axl';\nimport {\n  WorkflowContext,\n  MemoryStore,\n  ProviderRegistry,\n  eventCostContribution,\n  isUnpricedLeaf,\n} from '@axlsdk/axl';\nimport type { EventStreamOptions, WorkflowContextInit } from '@axlsdk/axl';\n\n// `AnyWorkflow` is a re-exported alias for `Workflow<any, any>` — see\n// the JSDoc on `AnyWorkflow` in `@axlsdk/axl/workflow.ts`. The bivariant\n// `any` is load-bearing for satisfying narrowly-typed handlers (e.g., a\n// `Workflow<TInput=MsgType>` whose handler takes `WorkflowContext<MsgType>`).\n\nexport type RecordedToolCall = { name: string; args: unknown; result: unknown };\nexport type RecordedAgentCall = Partial<AgentCallInfo> &\n  Pick<AgentCallInfo, 'agent' | 'prompt' | 'response'>;\nexport type RecordedStep = { step: number; type: string; data: unknown };\n\nfunction generateExecutionId(): string {\n  return `test-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport type AxlTestRuntimeOptions = {\n  record?: string;\n  humanDecisions?: (options: AwaitHumanOptions) => HumanDecision;\n  /** AxlConfig for the test runtime. Controls trace level/redact, context management, etc.\n   *  Defaults to `{}`. Set `{ trace: { level: 'full' } }` to verify verbose-mode snapshots\n   *  in tests, or `{ trace: { redact: true } }` to verify redaction policy in tests. */\n  config?: AxlConfig;\n};\n\nexport class AxlTestRuntime {\n  private workflows = new Map<string, AnyWorkflow>();\n  private mockProviders = new Map<string, MockProvider>();\n  private mockToolMap = new Map<string, MockTool>();\n  private _toolCalls: RecordedToolCall[] = [];\n  private _agentCalls: RecordedAgentCall[] = [];\n  private _steps: RecordedStep[] = [];\n  private _traceLog: AxlEvent[] = [];\n  private _totalCost = 0;\n  private _unpriced = false;\n  private _stepCounter = 0;\n  private recordPath?: string;\n  private recorded: ProviderResponse[] = [];\n  private _executionId: string = generateExecutionId();\n  private _humanDecisionHandler?: (options: AwaitHumanOptions) => HumanDecision;\n  private _config: AxlConfig;\n\n  constructor(options?: AxlTestRuntimeOptions) {\n    this.recordPath = options?.record;\n    this._humanDecisionHandler = options?.humanDecisions;\n    this._config = options?.config ?? {};\n  }\n\n  register(workflow: AnyWorkflow): void {\n    this.workflows.set(workflow.name, workflow);\n  }\n\n  mockProvider(name: string, provider: MockProvider): void {\n    this.mockProviders.set(name, provider);\n  }\n\n  mockTool<TInput = unknown>(\n    name: string,\n    handler: (input: TInput) => unknown | Promise<unknown>,\n  ): void {\n    // The MockTool registry is type-erased (`(input: unknown) => unknown`)\n    // because the runtime can't statically know each tool's input shape; tests\n    // opt in to a typed input via the generic, and we cast on storage.\n    this.mockToolMap.set(name, MockTool.create(name, handler as (input: unknown) => unknown));\n  }\n\n  async execute(\n    workflowName: string,\n    input: unknown,\n    options?: { metadata?: Record<string, unknown>; events?: EventStreamOptions },\n  ): Promise<unknown> {\n    const workflow = this.workflows.get(workflowName);\n    if (!workflow) throw new Error(`Workflow \"${workflowName}\" not registered`);\n\n    // Reset state between executions\n    this._toolCalls = [];\n    this._agentCalls = [];\n    this._steps = [];\n    this._traceLog = [];\n    this._totalCost = 0;\n    this._unpriced = false;\n    this._stepCounter = 0;\n    this.recorded = [];\n    this._executionId = generateExecutionId();\n\n    const validated = workflow.inputSchema.parse(input);\n\n    // Build ProviderRegistry from registered mock providers\n    const registry = new ProviderRegistry();\n    registry.clearFactories(); // Remove built-in factories; only use explicit mocks\n    for (const [name, provider] of this.mockProviders) {\n      registry.registerInstance(name, provider);\n    }\n    // Fallback resolution: 'default' key or single-provider\n    const defaultProvider = this.mockProviders.get('default');\n    if (defaultProvider) {\n      registry.setFallback(defaultProvider);\n    } else if (this.mockProviders.size === 1) {\n      const onlyProvider = this.mockProviders.values().next().value!;\n      registry.setFallback(onlyProvider);\n    }\n\n    // Build toolOverrides from mockToolMap\n    const toolOverrides = new Map<string, (args: unknown) => Promise<unknown>>();\n    for (const [name, mockTool] of this.mockToolMap) {\n      toolOverrides.set(name, async (args: unknown) => {\n        return mockTool.execute(args);\n      });\n    }\n\n    // Previously `_recordStep('workflow_start', ...)` was called here with\n    // raw `{ workflow, input }` data, AND `ctx._emitWorkflowStart` below\n    // pushed through the onTrace handler (which also bumps `_stepCounter`\n    // and appends to `_steps`). Result: two entries in `steps()` per\n    // workflow_start, with the first bypassing `config.trace.redact`.\n    // The `_recordStep` call is removed — onTrace is the single source\n    // of truth for `_steps`, matching the behavior of every other event\n    // type in the test runtime. Reviewer architecture §5.\n\n    const init: WorkflowContextInit = {\n      input: validated,\n      executionId: this._executionId,\n      metadata: options?.metadata,\n      // Thread the constructor-provided config so tests can exercise\n      // trace.level === 'full' and trace.redact behavior end-to-end.\n      config: this._config,\n      // Thread `events` config so tests can exercise the queue cap and\n      // overflow policy on `ctx.events`. Mirrors the production runtime.\n      eventStreamOptions: options?.events,\n      // Production runtime threads this (see `runtime.ts:594` in\n      // `execute()` and `:765` in `stream()`). `emitEvent` auto-stamps\n      // `event.workflow` from it, so consumers grouping by workflow\n      // (Cost Dashboard `byWorkflow`, `trackExecution.metadata.workflows`,\n      // any eval runner) see the same attribution in tests and prod.\n      workflowName,\n      providerRegistry: registry,\n      stateStore: new MemoryStore(),\n      toolOverrides: toolOverrides.size > 0 ? toolOverrides : undefined,\n      awaitHumanHandler: this._humanDecisionHandler\n        ? (opts: AwaitHumanOptions) => this._humanDecisionHandler!(opts)\n        : undefined,\n      onTrace: (event: AxlEvent) => {\n        this._traceLog.push(event);\n        this._stepCounter++;\n        this._steps.push({\n          step: this._stepCounter,\n          type: event.type,\n          data: (event as { data?: unknown }).data,\n        });\n\n        if (event.type === 'tool_call_end' && event.data) {\n          const { args, result } = event.data as { args: unknown; result: unknown };\n          // `tool: string` is required on `tool_call_end`; narrowing makes it non-null.\n          this._toolCalls.push({ name: event.tool, args, result });\n        }\n\n        // Single-source-of-truth cost accumulator. Skips ask_end\n        // rollups (decision 10) and guards NaN/Infinity.\n        this._totalCost += eventCostContribution(event);\n        // Honest aggregate: one unpriced leaf makes `totalCost()` a lower bound.\n        if (isUnpricedLeaf(event)) this._unpriced = true;\n\n        // Track provider responses for recording\n        if (event.type === 'agent_call_end' && event.data) {\n          const { response } = event.data as { prompt?: string; response?: string };\n          if (response !== undefined) {\n            this.recorded.push({\n              content: response,\n              usage: event.tokens\n                ? {\n                    prompt_tokens: event.tokens.input ?? 0,\n                    completion_tokens: event.tokens.output ?? 0,\n                    total_tokens:\n                      (event.tokens.input ?? 0) +\n                      (event.tokens.output ?? 0) +\n                      (event.tokens.reasoning ?? 0),\n                    ...(event.tokens.reasoning !== undefined\n                      ? { reasoning_tokens: event.tokens.reasoning }\n                      : {}),\n                  }\n                : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },\n              ...(event.cost !== undefined ? { cost: event.cost } : {}),\n            });\n          }\n        }\n      },\n      onAgentCallComplete: (call: AgentCallInfo) => {\n        this._agentCalls.push(call);\n      },\n    };\n\n    const ctx = new WorkflowContext(init);\n\n    // Emit workflow_start through the same pipeline production uses,\n    // AFTER ctx exists so `emitEvent`'s redact/step/timestamp handling\n    // applies. Previously emitted via `_pushTrace` which bypassed\n    // redaction — `config: { trace: { redact: true } }` on the test\n    // runtime would scrub intermediate events but leak `input`/`result`\n    // through the synthesized workflow_start/end.\n    const startedAt = Date.now();\n    ctx._emitWorkflowStart(validated);\n    try {\n      const result = await workflow.handler(ctx);\n\n      // Validate output schema if defined\n      if (workflow.outputSchema) workflow.outputSchema.parse(result);\n\n      ctx._emitWorkflowEnd({\n        status: 'completed',\n        duration: Date.now() - startedAt,\n        result,\n      });\n      // `_steps` is populated by onTrace for every event (including\n      // workflow_end); no separate `_recordStep` call needed — that\n      // would double-count.\n\n      if (this.recordPath) await this._writeRecording();\n      return result;\n    } catch (err) {\n      // Parity with production: failed workflows get a terminal\n      // `workflow_end(status: 'failed')` event so consumers counting\n      // workflow_start ↔ workflow_end pairs never see an unclosed one.\n      // `aborted` flag mirrors the runtime.ts AbortError detection.\n      const aborted =\n        typeof err === 'object' &&\n        err !== null &&\n        (err as { name?: unknown }).name === 'AbortError';\n      ctx._emitWorkflowEnd({\n        status: 'failed',\n        duration: Date.now() - startedAt,\n        error: err instanceof Error ? err.message : String(err),\n        ...(aborted ? { aborted: true } : {}),\n      });\n      // `_steps` populated by onTrace (see comment on the success path).\n      throw err;\n    }\n  }\n\n  toolCalls(name?: string): RecordedToolCall[] {\n    return name ? this._toolCalls.filter((c) => c.name === name) : this._toolCalls;\n  }\n\n  agentCalls(name?: string): RecordedAgentCall[] {\n    return name ? this._agentCalls.filter((c) => c.agent === name) : this._agentCalls;\n  }\n\n  totalCost(): number {\n    return this._totalCost;\n  }\n  /** True when any cost-bearing call was unpriced — `totalCost()` is then a\n   *  LOWER BOUND. Mirrors `ExecutionInfo.unpriced` / `BudgetResult.unpriced`. */\n  unpriced(): boolean {\n    return this._unpriced;\n  }\n  steps(): RecordedStep[] {\n    return this._steps;\n  }\n  traceLog(): AxlEvent[] {\n    return this._traceLog;\n  }\n\n  private async _writeRecording(): Promise<void> {\n    if (!this.recordPath) return;\n    const { writeFile, mkdir } = await import('node:fs/promises');\n    const { dirname } = await import('node:path');\n    await mkdir(dirname(this.recordPath), { recursive: true });\n    await writeFile(this.recordPath, JSON.stringify(this.recorded, null, 2), 'utf8');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/mock-provider.ts","../src/mock-tool.ts","../src/test-runtime.ts"],"sourcesContent":["export { AxlTestRuntime } from './test-runtime.js';\nexport type { RecordedToolCall, RecordedAgentCall, RecordedStep } from './test-runtime.js';\nexport { MockProvider } from './mock-provider.js';\nexport { MockTool } from './mock-tool.js';\n","import { readFileSync } from 'node:fs';\nimport { z } from 'zod';\nimport type {\n  ChatMessage,\n  ChatOptions,\n  ToolCallMessage,\n  ProviderResponse,\n  StreamChunk,\n  Provider,\n} from '@axlsdk/axl';\n\nfunction randomAlphanumeric(length: number): string {\n  const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * chars.length)];\n  }\n  return result;\n}\n\nfunction generateFromSchema(schema: unknown): unknown {\n  if (schema instanceof z.ZodString) return randomAlphanumeric(8 + Math.floor(Math.random() * 13));\n  if (schema instanceof z.ZodNumber) {\n    const min = Number.isFinite(schema.minValue) ? schema.minValue! : 0;\n    const max = Number.isFinite(schema.maxValue) ? schema.maxValue! : 100;\n    return min + Math.random() * (max - min);\n  }\n  if (schema instanceof z.ZodBoolean) return Math.random() < 0.5;\n  if (schema instanceof z.ZodArray) {\n    const count = 1 + Math.floor(Math.random() * 3);\n    return Array.from({ length: count }, () => generateFromSchema(schema.element));\n  }\n  if (schema instanceof z.ZodObject) {\n    const obj: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(schema.shape)) obj[key] = generateFromSchema(value);\n    return obj;\n  }\n  if (schema instanceof z.ZodOptional) {\n    if (Math.random() < 0.5) return undefined;\n    return generateFromSchema(schema.unwrap());\n  }\n  if (schema instanceof z.ZodDefault) return schema.parse(undefined);\n  if (schema instanceof z.ZodEnum) {\n    const values = schema.options;\n    return values.length > 0 ? values[Math.floor(Math.random() * values.length)] : '';\n  }\n  if (schema instanceof z.ZodLiteral) return [...schema.values][0];\n  if (schema instanceof z.ZodNullable) return null;\n  if (schema instanceof z.ZodUnion) {\n    const options = schema.options;\n    return generateFromSchema(options[Math.floor(Math.random() * options.length)]);\n  }\n  return {};\n}\n\nexport class MockProvider implements Provider {\n  readonly name = 'mock';\n  private _calls: { messages: ChatMessage[]; options: ChatOptions }[] = [];\n  /** Per-call optional chunk arrays, set by `sequence()` / `chunked()` so\n   *  `stream()` can yield one `text_delta` per chunk. Per-call indexed\n   *  alongside the response sequence. */\n  private chunkSequence?: Array<string[] | undefined>;\n  /** Optional ms delay between successive chunks during `stream()`. Useful\n   *  for dev fixtures that need to demonstrate streaming UX visually\n   *  (without a delay, mock chunks fire synchronously and complete in\n   *  microseconds — invisible to a human watching). Default 0 keeps\n   *  every existing test fast.\n   *\n   *  Set via `provider.chunkDelayMs = 50` after construction. Not part of\n   *  any factory's surface to keep the test API minimal. */\n  chunkDelayMs = 0;\n\n  private constructor(\n    private responseFn: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) => ProviderResponse | Promise<ProviderResponse>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async chat(messages: ChatMessage[], options: ChatOptions): Promise<ProviderResponse> {\n    this._calls.push({ messages, options });\n    return await this.responseFn(messages, this._calls.length - 1);\n  }\n\n  async *stream(messages: ChatMessage[], options: ChatOptions): AsyncGenerator<StreamChunk> {\n    const callIndex = this._calls.length;\n    const response = await this.chat(messages, options);\n    const chunks = this.chunkSequence?.[callIndex];\n    if (chunks && chunks.length > 0) {\n      // Sanity guard — if a caller passes chunks AND content, they MUST\n      // match. Otherwise tests pass while the real prod content silently\n      // diverges from what the streaming path observes.\n      const joined = chunks.join('');\n      if (joined !== response.content) {\n        throw new Error(\n          `MockProvider.stream: chunks.join('') !== content. ` +\n            `chunks=\"${joined}\" content=\"${response.content}\"`,\n        );\n      }\n      for (let i = 0; i < chunks.length; i++) {\n        yield { type: 'text_delta', content: chunks[i] };\n        if (this.chunkDelayMs > 0 && i < chunks.length - 1) {\n          await new Promise((resolve) => setTimeout(resolve, this.chunkDelayMs));\n        }\n      }\n    } else if (response.content) {\n      yield { type: 'text_delta', content: response.content };\n    }\n    if (response.tool_calls) {\n      for (const tc of response.tool_calls) {\n        yield {\n          type: 'tool_call_delta',\n          id: tc.id,\n          name: tc.function.name,\n          arguments: tc.function.arguments,\n        };\n      }\n    }\n    yield { type: 'done', usage: response.usage, providerMetadata: response.providerMetadata };\n  }\n\n  static sequence(\n    responses: Array<{\n      content: string;\n      tool_calls?: ToolCallMessage[];\n      providerMetadata?: Record<string, unknown>;\n      usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n      cost?: number;\n      /** When set, `stream()` yields one `text_delta` per entry instead\n       *  of one big delta with the full content. Use to exercise\n       *  partial-JSON parsing, structural-boundary throttling, and\n       *  cross-attempt token retention in tests. Must satisfy\n       *  `chunks.join('') === content`. */\n      chunks?: string[];\n    }>,\n  ): MockProvider {\n    const provider = new MockProvider((_messages, callIndex) => {\n      if (callIndex >= responses.length) {\n        throw new Error(\n          `MockProvider.sequence: no response for call index ${callIndex}. Only ${responses.length} responses defined.`,\n        );\n      }\n      const resp = responses[callIndex];\n      return {\n        content: resp.content,\n        tool_calls: resp.tool_calls,\n        providerMetadata: resp.providerMetadata,\n        usage: resp.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: resp.cost ?? 0,\n      };\n    });\n    provider.chunkSequence = responses.map((r) => r.chunks);\n    return provider;\n  }\n\n  /**\n   * Convenience: build a `sequence()` from plain content strings, splitting\n   * each one into fixed-size chunks for the streaming path. Default\n   * `chunkSize` is 4 chars (≈1 token).\n   */\n  static chunked(contents: string[], chunkSize = 4): MockProvider {\n    const responses = contents.map((content) => {\n      const chunks: string[] = [];\n      for (let i = 0; i < content.length; i += chunkSize) {\n        chunks.push(content.slice(i, i + chunkSize));\n      }\n      return { content, chunks };\n    });\n    return MockProvider.sequence(responses);\n  }\n\n  static echo(): MockProvider {\n    return new MockProvider((messages) => {\n      const lastUser = [...messages].reverse().find((m) => m.role === 'user');\n      return {\n        content: lastUser?.content ?? '',\n        usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: 0,\n      };\n    });\n  }\n\n  static json(schema: unknown): MockProvider {\n    return new MockProvider(() => ({\n      content: JSON.stringify(generateFromSchema(schema)),\n      usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n      cost: 0,\n    }));\n  }\n\n  static replay(source: string | ProviderResponse[]): MockProvider {\n    const data =\n      typeof source === 'string'\n        ? (JSON.parse(readFileSync(source, 'utf-8')) as ProviderResponse[])\n        : source;\n    return new MockProvider((_messages, callIndex) => {\n      if (callIndex >= data.length) {\n        throw new Error(`MockProvider.replay: no recorded response for call index ${callIndex}`);\n      }\n      return data[callIndex];\n    });\n  }\n\n  static fn(\n    handler: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) =>\n      | {\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }\n      | Promise<{\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }>,\n  ): MockProvider {\n    return new MockProvider(async (messages, callIndex) => {\n      const result = await handler(messages, callIndex);\n      return {\n        ...result,\n        usage: result.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: result.cost ?? 0,\n      };\n    });\n  }\n}\n","export class MockTool {\n  private _calls: { input: unknown }[] = [];\n\n  constructor(\n    readonly name: string,\n    private handler: (input: unknown) => unknown | Promise<unknown>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async execute(input: unknown): Promise<unknown> {\n    this._calls.push({ input });\n    return this.handler(input);\n  }\n\n  static create(name: string, handler: (input: unknown) => unknown | Promise<unknown>): MockTool {\n    return new MockTool(name, handler);\n  }\n}\n","import { MockProvider } from './mock-provider.js';\nimport { MockTool } from './mock-tool.js';\nimport type {\n  AxlEvent,\n  AwaitHumanOptions,\n  HumanDecision,\n  ProviderResponse,\n  AgentCallInfo,\n  AxlConfig,\n  AnyWorkflow,\n  ToolCallOutcome,\n  ObservationStatus,\n} from '@axlsdk/axl';\nimport {\n  WorkflowContext,\n  MemoryStore,\n  ProviderRegistry,\n  eventCostContribution,\n  isUnpricedLeaf,\n} from '@axlsdk/axl';\nimport type { EventStreamOptions, WorkflowContextInit } from '@axlsdk/axl';\n\n// `AnyWorkflow` is a re-exported alias for `Workflow<any, any>` — see\n// the JSDoc on `AnyWorkflow` in `@axlsdk/axl/workflow.ts`. The bivariant\n// `any` is load-bearing for satisfying narrowly-typed handlers (e.g., a\n// `Workflow<TInput=MsgType>` whose handler takes `WorkflowContext<MsgType>`).\n\n/** One accepted provider-issued tool invocation, recorded from its terminal v2 event.\n *\n * Narrow `outcome.status` before reading status-specific fields. Correlation uses\n * `(executionId, askId, callId)`; `name` is the canonical tool name.\n */\nexport type RecordedToolCall = {\n  name: string;\n  executionId: string;\n  askId: string;\n  callId: string;\n  args: unknown;\n  requestedTool?: string;\n  outcome: ToolCallOutcome;\n};\nexport type RecordedAgentCall = Partial<AgentCallInfo> &\n  Pick<AgentCallInfo, 'agent' | 'prompt' | 'response'>;\nexport type RecordedStep = { step: number; type: string; data: unknown };\n\nfunction generateExecutionId(): string {\n  return `test-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction preserveDrainCause(error: Error, cause: unknown): Error {\n  if (cause === undefined || cause === error || 'cause' in error) return error;\n  Object.defineProperty(error, 'cause', {\n    configurable: true,\n    enumerable: false,\n    value: cause,\n  });\n  return error;\n}\n\nexport type AxlTestRuntimeOptions = {\n  record?: string;\n  humanDecisions?: (options: AwaitHumanOptions) => HumanDecision;\n  /** AxlConfig for the test runtime. Controls trace level/redact, context management, etc.\n   *  Defaults to `{}`. Set `{ trace: { level: 'full' } }` to verify verbose-mode snapshots\n   *  in tests, or `{ trace: { redact: true } }` to verify redaction policy in tests. */\n  config?: AxlConfig;\n};\n\nexport class AxlTestRuntime {\n  private workflows = new Map<string, AnyWorkflow>();\n  private mockProviders = new Map<string, MockProvider>();\n  private mockToolMap = new Map<string, MockTool>();\n  private _toolCalls: RecordedToolCall[] = [];\n  private _agentCalls: RecordedAgentCall[] = [];\n  private _steps: RecordedStep[] = [];\n  private _traceLog: AxlEvent[] = [];\n  private _totalCost = 0;\n  private _unpriced = false;\n  private _stepCounter = 0;\n  private recordPath?: string;\n  private recorded: ProviderResponse[] = [];\n  private _executionId: string = generateExecutionId();\n  private _humanDecisionHandler?: (options: AwaitHumanOptions) => HumanDecision;\n  private _config: AxlConfig;\n\n  constructor(options?: AxlTestRuntimeOptions) {\n    this.recordPath = options?.record;\n    this._humanDecisionHandler = options?.humanDecisions;\n    this._config = options?.config ?? {};\n  }\n\n  register(workflow: AnyWorkflow): void {\n    this.workflows.set(workflow.name, workflow);\n  }\n\n  mockProvider(name: string, provider: MockProvider): void {\n    this.mockProviders.set(name, provider);\n  }\n\n  mockTool<TInput = unknown>(\n    name: string,\n    handler: (input: TInput) => unknown | Promise<unknown>,\n  ): void {\n    // The MockTool registry is type-erased (`(input: unknown) => unknown`)\n    // because the runtime can't statically know each tool's input shape; tests\n    // opt in to a typed input via the generic, and we cast on storage.\n    this.mockToolMap.set(name, MockTool.create(name, handler as (input: unknown) => unknown));\n  }\n\n  async execute(\n    workflowName: string,\n    input: unknown,\n    options?: {\n      metadata?: Record<string, unknown>;\n      events?: EventStreamOptions;\n      branchDrainTimeoutMs?: number;\n    },\n  ): Promise<unknown> {\n    const workflow = this.workflows.get(workflowName);\n    if (!workflow) throw new Error(`Workflow \"${workflowName}\" not registered`);\n\n    // Reset state between executions\n    this._toolCalls = [];\n    this._agentCalls = [];\n    this._steps = [];\n    this._traceLog = [];\n    this._totalCost = 0;\n    this._unpriced = false;\n    this._stepCounter = 0;\n    this.recorded = [];\n    this._executionId = generateExecutionId();\n\n    const validated = workflow.inputSchema.parse(input);\n\n    // Build ProviderRegistry from registered mock providers\n    const registry = new ProviderRegistry();\n    registry.clearFactories(); // Remove built-in factories; only use explicit mocks\n    for (const [name, provider] of this.mockProviders) {\n      registry.registerInstance(name, provider);\n    }\n    // Fallback resolution: 'default' key or single-provider\n    const defaultProvider = this.mockProviders.get('default');\n    if (defaultProvider) {\n      registry.setFallback(defaultProvider);\n    } else if (this.mockProviders.size === 1) {\n      const onlyProvider = this.mockProviders.values().next().value!;\n      registry.setFallback(onlyProvider);\n    }\n\n    // Build toolOverrides from mockToolMap\n    const toolOverrides = new Map<string, (args: unknown) => Promise<unknown>>();\n    for (const [name, mockTool] of this.mockToolMap) {\n      toolOverrides.set(name, async (args: unknown) => {\n        return mockTool.execute(args);\n      });\n    }\n\n    // Previously `_recordStep('workflow_start', ...)` was called here with\n    // raw `{ workflow, input }` data, AND `ctx._emitWorkflowStart` below\n    // pushed through the onTrace handler (which also bumps `_stepCounter`\n    // and appends to `_steps`). Result: two entries in `steps()` per\n    // workflow_start, with the first bypassing `config.trace.redact`.\n    // The `_recordStep` call is removed — onTrace is the single source\n    // of truth for `_steps`, matching the behavior of every other event\n    // type in the test runtime. Reviewer architecture §5.\n\n    const init: WorkflowContextInit = {\n      input: validated,\n      executionId: this._executionId,\n      metadata: options?.metadata,\n      // Thread the constructor-provided config so tests can exercise\n      // trace.level === 'full' and trace.redact behavior end-to-end.\n      config: this._config,\n      // Thread `events` config so tests can exercise the queue cap and\n      // overflow policy on `ctx.events`. Mirrors the production runtime.\n      eventStreamOptions: options?.events,\n      branchDrainTimeoutMs: options?.branchDrainTimeoutMs,\n      // Production runtime threads this (see `runtime.ts:594` in\n      // `execute()` and `:765` in `stream()`). `emitEvent` auto-stamps\n      // `event.workflow` from it, so consumers grouping by workflow\n      // (Cost Dashboard `byWorkflow`, `trackExecution.metadata.workflows`,\n      // any eval runner) see the same attribution in tests and prod.\n      workflowName,\n      providerRegistry: registry,\n      stateStore: new MemoryStore(),\n      toolOverrides: toolOverrides.size > 0 ? toolOverrides : undefined,\n      awaitHumanHandler: this._humanDecisionHandler\n        ? (opts: AwaitHumanOptions) => this._humanDecisionHandler!(opts)\n        : undefined,\n      onTrace: (event: AxlEvent) => {\n        this._traceLog.push(event);\n        this._stepCounter++;\n        this._steps.push({\n          step: this._stepCounter,\n          type: event.type,\n          data: (event as { data?: unknown }).data,\n        });\n\n        if (event.type === 'tool_call_end') {\n          const { args, requestedTool, outcome } = event.data;\n          this._toolCalls.push({\n            name: event.tool,\n            executionId: event.executionId,\n            askId: event.askId,\n            callId: event.callId,\n            args,\n            ...(requestedTool !== undefined ? { requestedTool } : {}),\n            outcome,\n          });\n        }\n\n        // Single-source-of-truth cost accumulator. Skips ask_end\n        // rollups (decision 10) and guards NaN/Infinity.\n        this._totalCost += eventCostContribution(event);\n        // Honest aggregate: one unpriced leaf makes `totalCost()` a lower bound.\n        if (isUnpricedLeaf(event)) this._unpriced = true;\n\n        // Track provider responses for recording\n        if (event.type === 'agent_call_end' && event.data) {\n          const { response } = event.data as { prompt?: string; response?: string };\n          if (response !== undefined) {\n            this.recorded.push({\n              content: response,\n              usage: event.tokens\n                ? {\n                    prompt_tokens: event.tokens.input ?? 0,\n                    completion_tokens: event.tokens.output ?? 0,\n                    total_tokens:\n                      (event.tokens.input ?? 0) +\n                      (event.tokens.output ?? 0) +\n                      (event.tokens.reasoning ?? 0),\n                    ...(event.tokens.reasoning !== undefined\n                      ? { reasoning_tokens: event.tokens.reasoning }\n                      : {}),\n                  }\n                : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },\n              ...(event.cost !== undefined ? { cost: event.cost } : {}),\n            });\n          }\n        }\n      },\n      onAgentCallComplete: (call: AgentCallInfo) => {\n        this._agentCalls.push(call);\n      },\n    };\n\n    const ctx = new WorkflowContext(init);\n\n    // Emit workflow_start through the same pipeline production uses,\n    // AFTER ctx exists so `emitEvent`'s redact/step/timestamp handling\n    // applies. Previously emitted via `_pushTrace` which bypassed\n    // redaction — `config: { trace: { redact: true } }` on the test\n    // runtime would scrub intermediate events but leak `input`/`result`\n    // through the synthesized workflow_start/end.\n    const startedAt = Date.now();\n    ctx._emitWorkflowStart(validated);\n    try {\n      const result = await workflow.handler(ctx);\n      const observation = await ctx._drainBranchWork();\n\n      // Validate output schema if defined\n      if (workflow.outputSchema) workflow.outputSchema.parse(result);\n\n      ctx._emitWorkflowEnd({\n        status: 'completed',\n        duration: Date.now() - startedAt,\n        result,\n        observation,\n      });\n      // `_steps` is populated by onTrace for every event (including\n      // workflow_end); no separate `_recordStep` call needed — that\n      // would double-count.\n\n      if (this.recordPath) await this._writeRecording();\n      return result;\n    } catch (err) {\n      let workflowError = err;\n      let observation: ObservationStatus = { complete: true };\n      try {\n        observation = await ctx._drainBranchWork();\n      } catch (drainError) {\n        workflowError =\n          drainError instanceof Error ? preserveDrainCause(drainError, workflowError) : drainError;\n      }\n      // Parity with production: failed workflows get a terminal\n      // `workflow_end(status: 'failed')` event so consumers counting\n      // workflow_start ↔ workflow_end pairs never see an unclosed one.\n      // `aborted` flag mirrors the runtime.ts AbortError detection.\n      const aborted =\n        typeof workflowError === 'object' &&\n        workflowError !== null &&\n        (workflowError as { name?: unknown }).name === 'AbortError';\n      ctx._emitWorkflowEnd({\n        status: 'failed',\n        duration: Date.now() - startedAt,\n        error: workflowError instanceof Error ? workflowError.message : String(workflowError),\n        ...(aborted ? { aborted: true } : {}),\n        observation,\n      });\n      // `_steps` populated by onTrace (see comment on the success path).\n      throw workflowError;\n    }\n  }\n\n  toolCalls(name?: string): RecordedToolCall[] {\n    return name ? this._toolCalls.filter((c) => c.name === name) : this._toolCalls;\n  }\n\n  agentCalls(name?: string): RecordedAgentCall[] {\n    return name ? this._agentCalls.filter((c) => c.agent === name) : this._agentCalls;\n  }\n\n  totalCost(): number {\n    return this._totalCost;\n  }\n  /** True when any cost-bearing call was unpriced — `totalCost()` is then a\n   *  LOWER BOUND. Mirrors `ExecutionInfo.unpriced` / `BudgetResult.unpriced`. */\n  unpriced(): boolean {\n    return this._unpriced;\n  }\n  steps(): RecordedStep[] {\n    return this._steps;\n  }\n  traceLog(): AxlEvent[] {\n    return this._traceLog;\n  }\n\n  private async _writeRecording(): Promise<void> {\n    if (!this.recordPath) return;\n    const { writeFile, mkdir } = await import('node:fs/promises');\n    const { dirname } = await import('node:path');\n    await mkdir(dirname(this.recordPath), { recursive: true });\n    await writeFile(this.recordPath, JSON.stringify(this.recorded, null, 2), 'utf8');\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Provider, ChatMessage, ChatOptions, ProviderResponse, StreamChunk, ToolCallMessage, AwaitHumanOptions, HumanDecision, AxlConfig, AnyWorkflow, EventStreamOptions, AgentCallInfo, AxlEvent } from '@axlsdk/axl';
+import { Provider, ChatMessage, ChatOptions, ProviderResponse, StreamChunk, ToolCallMessage, AwaitHumanOptions, HumanDecision, AxlConfig, AnyWorkflow, EventStreamOptions, ToolCallOutcome, AgentCallInfo, AxlEvent } from '@axlsdk/axl';
 
 declare class MockProvider implements Provider {
     private responseFn;
@@ -73,10 +73,19 @@ declare class MockProvider implements Provider {
     }>): MockProvider;
 }
 
+/** One accepted provider-issued tool invocation, recorded from its terminal v2 event.
+ *
+ * Narrow `outcome.status` before reading status-specific fields. Correlation uses
+ * `(executionId, askId, callId)`; `name` is the canonical tool name.
+ */
 type RecordedToolCall = {
     name: string;
+    executionId: string;
+    askId: string;
+    callId: string;
     args: unknown;
-    result: unknown;
+    requestedTool?: string;
+    outcome: ToolCallOutcome;
 };
 type RecordedAgentCall = Partial<AgentCallInfo> & Pick<AgentCallInfo, 'agent' | 'prompt' | 'response'>;
 type RecordedStep = {
@@ -115,6 +124,7 @@ declare class AxlTestRuntime {
     execute(workflowName: string, input: unknown, options?: {
         metadata?: Record<string, unknown>;
         events?: EventStreamOptions;
+        branchDrainTimeoutMs?: number;
     }): Promise<unknown>;
     toolCalls(name?: string): RecordedToolCall[];
     agentCalls(name?: string): RecordedAgentCall[];

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Provider, ChatMessage, ChatOptions, ProviderResponse, StreamChunk, ToolCallMessage, AwaitHumanOptions, HumanDecision, AxlConfig, AnyWorkflow, EventStreamOptions, AgentCallInfo, AxlEvent } from '@axlsdk/axl';
+import { Provider, ChatMessage, ChatOptions, ProviderResponse, StreamChunk, ToolCallMessage, AwaitHumanOptions, HumanDecision, AxlConfig, AnyWorkflow, EventStreamOptions, ToolCallOutcome, AgentCallInfo, AxlEvent } from '@axlsdk/axl';
 
 declare class MockProvider implements Provider {
     private responseFn;
@@ -73,10 +73,19 @@ declare class MockProvider implements Provider {
     }>): MockProvider;
 }
 
+/** One accepted provider-issued tool invocation, recorded from its terminal v2 event.
+ *
+ * Narrow `outcome.status` before reading status-specific fields. Correlation uses
+ * `(executionId, askId, callId)`; `name` is the canonical tool name.
+ */
 type RecordedToolCall = {
     name: string;
+    executionId: string;
+    askId: string;
+    callId: string;
     args: unknown;
-    result: unknown;
+    requestedTool?: string;
+    outcome: ToolCallOutcome;
 };
 type RecordedAgentCall = Partial<AgentCallInfo> & Pick<AgentCallInfo, 'agent' | 'prompt' | 'response'>;
 type RecordedStep = {
@@ -115,6 +124,7 @@ declare class AxlTestRuntime {
     execute(workflowName: string, input: unknown, options?: {
         metadata?: Record<string, unknown>;
         events?: EventStreamOptions;
+        branchDrainTimeoutMs?: number;
     }): Promise<unknown>;
     toolCalls(name?: string): RecordedToolCall[];
     agentCalls(name?: string): RecordedAgentCall[];

package/dist/index.js

@@ -203,6 +203,15 @@ import {
 function generateExecutionId() {
   return `test-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
 }
+function preserveDrainCause(error, cause) {
+  if (cause === void 0 || cause === error || "cause" in error) return error;
+  Object.defineProperty(error, "cause", {
+    configurable: true,
+    enumerable: false,
+    value: cause
+  });
+  return error;
+}
 var AxlTestRuntime = class {
   workflows = /* @__PURE__ */ new Map();
   mockProviders = /* @__PURE__ */ new Map();
@@ -274,6 +283,7 @@ var AxlTestRuntime = class {
       // Thread `events` config so tests can exercise the queue cap and
       // overflow policy on `ctx.events`. Mirrors the production runtime.
       eventStreamOptions: options?.events,
+      branchDrainTimeoutMs: options?.branchDrainTimeoutMs,
       // Production runtime threads this (see `runtime.ts:594` in
       // `execute()` and `:765` in `stream()`). `emitEvent` auto-stamps
       // `event.workflow` from it, so consumers grouping by workflow
@@ -292,9 +302,17 @@ var AxlTestRuntime = class {
           type: event.type,
           data: event.data
         });
-        if (event.type === "tool_call_end" && event.data) {
-          const { args, result } = event.data;
-          this._toolCalls.push({ name: event.tool, args, result });
+        if (event.type === "tool_call_end") {
+          const { args, requestedTool, outcome } = event.data;
+          this._toolCalls.push({
+            name: event.tool,
+            executionId: event.executionId,
+            askId: event.askId,
+            callId: event.callId,
+            args,
+            ...requestedTool !== void 0 ? { requestedTool } : {},
+            outcome
+          });
         }
         this._totalCost += eventCostContribution(event);
         if (isUnpricedLeaf(event)) this._unpriced = true;
@@ -323,23 +341,33 @@ var AxlTestRuntime = class {
     ctx._emitWorkflowStart(validated);
     try {
       const result = await workflow.handler(ctx);
+      const observation = await ctx._drainBranchWork();
       if (workflow.outputSchema) workflow.outputSchema.parse(result);
       ctx._emitWorkflowEnd({
         status: "completed",
         duration: Date.now() - startedAt,
-        result
+        result,
+        observation
       });
       if (this.recordPath) await this._writeRecording();
       return result;
     } catch (err) {
-      const aborted = typeof err === "object" && err !== null && err.name === "AbortError";
+      let workflowError = err;
+      let observation = { complete: true };
+      try {
+        observation = await ctx._drainBranchWork();
+      } catch (drainError) {
+        workflowError = drainError instanceof Error ? preserveDrainCause(drainError, workflowError) : drainError;
+      }
+      const aborted = typeof workflowError === "object" && workflowError !== null && workflowError.name === "AbortError";
       ctx._emitWorkflowEnd({
         status: "failed",
         duration: Date.now() - startedAt,
-        error: err instanceof Error ? err.message : String(err),
-        ...aborted ? { aborted: true } : {}
+        error: workflowError instanceof Error ? workflowError.message : String(workflowError),
+        ...aborted ? { aborted: true } : {},
+        observation
       });
-      throw err;
+      throw workflowError;
     }
   }
   toolCalls(name) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mock-provider.ts","../src/mock-tool.ts","../src/test-runtime.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { z } from 'zod';\nimport type {\n  ChatMessage,\n  ChatOptions,\n  ToolCallMessage,\n  ProviderResponse,\n  StreamChunk,\n  Provider,\n} from '@axlsdk/axl';\n\nfunction randomAlphanumeric(length: number): string {\n  const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * chars.length)];\n  }\n  return result;\n}\n\nfunction generateFromSchema(schema: unknown): unknown {\n  if (schema instanceof z.ZodString) return randomAlphanumeric(8 + Math.floor(Math.random() * 13));\n  if (schema instanceof z.ZodNumber) {\n    const min = Number.isFinite(schema.minValue) ? schema.minValue! : 0;\n    const max = Number.isFinite(schema.maxValue) ? schema.maxValue! : 100;\n    return min + Math.random() * (max - min);\n  }\n  if (schema instanceof z.ZodBoolean) return Math.random() < 0.5;\n  if (schema instanceof z.ZodArray) {\n    const count = 1 + Math.floor(Math.random() * 3);\n    return Array.from({ length: count }, () => generateFromSchema(schema.element));\n  }\n  if (schema instanceof z.ZodObject) {\n    const obj: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(schema.shape)) obj[key] = generateFromSchema(value);\n    return obj;\n  }\n  if (schema instanceof z.ZodOptional) {\n    if (Math.random() < 0.5) return undefined;\n    return generateFromSchema(schema.unwrap());\n  }\n  if (schema instanceof z.ZodDefault) return schema.parse(undefined);\n  if (schema instanceof z.ZodEnum) {\n    const values = schema.options;\n    return values.length > 0 ? values[Math.floor(Math.random() * values.length)] : '';\n  }\n  if (schema instanceof z.ZodLiteral) return [...schema.values][0];\n  if (schema instanceof z.ZodNullable) return null;\n  if (schema instanceof z.ZodUnion) {\n    const options = schema.options;\n    return generateFromSchema(options[Math.floor(Math.random() * options.length)]);\n  }\n  return {};\n}\n\nexport class MockProvider implements Provider {\n  readonly name = 'mock';\n  private _calls: { messages: ChatMessage[]; options: ChatOptions }[] = [];\n  /** Per-call optional chunk arrays, set by `sequence()` / `chunked()` so\n   *  `stream()` can yield one `text_delta` per chunk. Per-call indexed\n   *  alongside the response sequence. */\n  private chunkSequence?: Array<string[] | undefined>;\n  /** Optional ms delay between successive chunks during `stream()`. Useful\n   *  for dev fixtures that need to demonstrate streaming UX visually\n   *  (without a delay, mock chunks fire synchronously and complete in\n   *  microseconds — invisible to a human watching). Default 0 keeps\n   *  every existing test fast.\n   *\n   *  Set via `provider.chunkDelayMs = 50` after construction. Not part of\n   *  any factory's surface to keep the test API minimal. */\n  chunkDelayMs = 0;\n\n  private constructor(\n    private responseFn: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) => ProviderResponse | Promise<ProviderResponse>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async chat(messages: ChatMessage[], options: ChatOptions): Promise<ProviderResponse> {\n    this._calls.push({ messages, options });\n    return await this.responseFn(messages, this._calls.length - 1);\n  }\n\n  async *stream(messages: ChatMessage[], options: ChatOptions): AsyncGenerator<StreamChunk> {\n    const callIndex = this._calls.length;\n    const response = await this.chat(messages, options);\n    const chunks = this.chunkSequence?.[callIndex];\n    if (chunks && chunks.length > 0) {\n      // Sanity guard — if a caller passes chunks AND content, they MUST\n      // match. Otherwise tests pass while the real prod content silently\n      // diverges from what the streaming path observes.\n      const joined = chunks.join('');\n      if (joined !== response.content) {\n        throw new Error(\n          `MockProvider.stream: chunks.join('') !== content. ` +\n            `chunks=\"${joined}\" content=\"${response.content}\"`,\n        );\n      }\n      for (let i = 0; i < chunks.length; i++) {\n        yield { type: 'text_delta', content: chunks[i] };\n        if (this.chunkDelayMs > 0 && i < chunks.length - 1) {\n          await new Promise((resolve) => setTimeout(resolve, this.chunkDelayMs));\n        }\n      }\n    } else if (response.content) {\n      yield { type: 'text_delta', content: response.content };\n    }\n    if (response.tool_calls) {\n      for (const tc of response.tool_calls) {\n        yield {\n          type: 'tool_call_delta',\n          id: tc.id,\n          name: tc.function.name,\n          arguments: tc.function.arguments,\n        };\n      }\n    }\n    yield { type: 'done', usage: response.usage, providerMetadata: response.providerMetadata };\n  }\n\n  static sequence(\n    responses: Array<{\n      content: string;\n      tool_calls?: ToolCallMessage[];\n      providerMetadata?: Record<string, unknown>;\n      usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n      cost?: number;\n      /** When set, `stream()` yields one `text_delta` per entry instead\n       *  of one big delta with the full content. Use to exercise\n       *  partial-JSON parsing, structural-boundary throttling, and\n       *  cross-attempt token retention in tests. Must satisfy\n       *  `chunks.join('') === content`. */\n      chunks?: string[];\n    }>,\n  ): MockProvider {\n    const provider = new MockProvider((_messages, callIndex) => {\n      if (callIndex >= responses.length) {\n        throw new Error(\n          `MockProvider.sequence: no response for call index ${callIndex}. Only ${responses.length} responses defined.`,\n        );\n      }\n      const resp = responses[callIndex];\n      return {\n        content: resp.content,\n        tool_calls: resp.tool_calls,\n        providerMetadata: resp.providerMetadata,\n        usage: resp.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: resp.cost ?? 0,\n      };\n    });\n    provider.chunkSequence = responses.map((r) => r.chunks);\n    return provider;\n  }\n\n  /**\n   * Convenience: build a `sequence()` from plain content strings, splitting\n   * each one into fixed-size chunks for the streaming path. Default\n   * `chunkSize` is 4 chars (≈1 token).\n   */\n  static chunked(contents: string[], chunkSize = 4): MockProvider {\n    const responses = contents.map((content) => {\n      const chunks: string[] = [];\n      for (let i = 0; i < content.length; i += chunkSize) {\n        chunks.push(content.slice(i, i + chunkSize));\n      }\n      return { content, chunks };\n    });\n    return MockProvider.sequence(responses);\n  }\n\n  static echo(): MockProvider {\n    return new MockProvider((messages) => {\n      const lastUser = [...messages].reverse().find((m) => m.role === 'user');\n      return {\n        content: lastUser?.content ?? '',\n        usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: 0,\n      };\n    });\n  }\n\n  static json(schema: unknown): MockProvider {\n    return new MockProvider(() => ({\n      content: JSON.stringify(generateFromSchema(schema)),\n      usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n      cost: 0,\n    }));\n  }\n\n  static replay(source: string | ProviderResponse[]): MockProvider {\n    const data =\n      typeof source === 'string'\n        ? (JSON.parse(readFileSync(source, 'utf-8')) as ProviderResponse[])\n        : source;\n    return new MockProvider((_messages, callIndex) => {\n      if (callIndex >= data.length) {\n        throw new Error(`MockProvider.replay: no recorded response for call index ${callIndex}`);\n      }\n      return data[callIndex];\n    });\n  }\n\n  static fn(\n    handler: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) =>\n      | {\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }\n      | Promise<{\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }>,\n  ): MockProvider {\n    return new MockProvider(async (messages, callIndex) => {\n      const result = await handler(messages, callIndex);\n      return {\n        ...result,\n        usage: result.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: result.cost ?? 0,\n      };\n    });\n  }\n}\n","export class MockTool {\n  private _calls: { input: unknown }[] = [];\n\n  constructor(\n    readonly name: string,\n    private handler: (input: unknown) => unknown | Promise<unknown>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async execute(input: unknown): Promise<unknown> {\n    this._calls.push({ input });\n    return this.handler(input);\n  }\n\n  static create(name: string, handler: (input: unknown) => unknown | Promise<unknown>): MockTool {\n    return new MockTool(name, handler);\n  }\n}\n","import { MockProvider } from './mock-provider.js';\nimport { MockTool } from './mock-tool.js';\nimport type {\n  AxlEvent,\n  AwaitHumanOptions,\n  HumanDecision,\n  ProviderResponse,\n  AgentCallInfo,\n  AxlConfig,\n  AnyWorkflow,\n} from '@axlsdk/axl';\nimport {\n  WorkflowContext,\n  MemoryStore,\n  ProviderRegistry,\n  eventCostContribution,\n  isUnpricedLeaf,\n} from '@axlsdk/axl';\nimport type { EventStreamOptions, WorkflowContextInit } from '@axlsdk/axl';\n\n// `AnyWorkflow` is a re-exported alias for `Workflow<any, any>` — see\n// the JSDoc on `AnyWorkflow` in `@axlsdk/axl/workflow.ts`. The bivariant\n// `any` is load-bearing for satisfying narrowly-typed handlers (e.g., a\n// `Workflow<TInput=MsgType>` whose handler takes `WorkflowContext<MsgType>`).\n\nexport type RecordedToolCall = { name: string; args: unknown; result: unknown };\nexport type RecordedAgentCall = Partial<AgentCallInfo> &\n  Pick<AgentCallInfo, 'agent' | 'prompt' | 'response'>;\nexport type RecordedStep = { step: number; type: string; data: unknown };\n\nfunction generateExecutionId(): string {\n  return `test-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport type AxlTestRuntimeOptions = {\n  record?: string;\n  humanDecisions?: (options: AwaitHumanOptions) => HumanDecision;\n  /** AxlConfig for the test runtime. Controls trace level/redact, context management, etc.\n   *  Defaults to `{}`. Set `{ trace: { level: 'full' } }` to verify verbose-mode snapshots\n   *  in tests, or `{ trace: { redact: true } }` to verify redaction policy in tests. */\n  config?: AxlConfig;\n};\n\nexport class AxlTestRuntime {\n  private workflows = new Map<string, AnyWorkflow>();\n  private mockProviders = new Map<string, MockProvider>();\n  private mockToolMap = new Map<string, MockTool>();\n  private _toolCalls: RecordedToolCall[] = [];\n  private _agentCalls: RecordedAgentCall[] = [];\n  private _steps: RecordedStep[] = [];\n  private _traceLog: AxlEvent[] = [];\n  private _totalCost = 0;\n  private _unpriced = false;\n  private _stepCounter = 0;\n  private recordPath?: string;\n  private recorded: ProviderResponse[] = [];\n  private _executionId: string = generateExecutionId();\n  private _humanDecisionHandler?: (options: AwaitHumanOptions) => HumanDecision;\n  private _config: AxlConfig;\n\n  constructor(options?: AxlTestRuntimeOptions) {\n    this.recordPath = options?.record;\n    this._humanDecisionHandler = options?.humanDecisions;\n    this._config = options?.config ?? {};\n  }\n\n  register(workflow: AnyWorkflow): void {\n    this.workflows.set(workflow.name, workflow);\n  }\n\n  mockProvider(name: string, provider: MockProvider): void {\n    this.mockProviders.set(name, provider);\n  }\n\n  mockTool<TInput = unknown>(\n    name: string,\n    handler: (input: TInput) => unknown | Promise<unknown>,\n  ): void {\n    // The MockTool registry is type-erased (`(input: unknown) => unknown`)\n    // because the runtime can't statically know each tool's input shape; tests\n    // opt in to a typed input via the generic, and we cast on storage.\n    this.mockToolMap.set(name, MockTool.create(name, handler as (input: unknown) => unknown));\n  }\n\n  async execute(\n    workflowName: string,\n    input: unknown,\n    options?: { metadata?: Record<string, unknown>; events?: EventStreamOptions },\n  ): Promise<unknown> {\n    const workflow = this.workflows.get(workflowName);\n    if (!workflow) throw new Error(`Workflow \"${workflowName}\" not registered`);\n\n    // Reset state between executions\n    this._toolCalls = [];\n    this._agentCalls = [];\n    this._steps = [];\n    this._traceLog = [];\n    this._totalCost = 0;\n    this._unpriced = false;\n    this._stepCounter = 0;\n    this.recorded = [];\n    this._executionId = generateExecutionId();\n\n    const validated = workflow.inputSchema.parse(input);\n\n    // Build ProviderRegistry from registered mock providers\n    const registry = new ProviderRegistry();\n    registry.clearFactories(); // Remove built-in factories; only use explicit mocks\n    for (const [name, provider] of this.mockProviders) {\n      registry.registerInstance(name, provider);\n    }\n    // Fallback resolution: 'default' key or single-provider\n    const defaultProvider = this.mockProviders.get('default');\n    if (defaultProvider) {\n      registry.setFallback(defaultProvider);\n    } else if (this.mockProviders.size === 1) {\n      const onlyProvider = this.mockProviders.values().next().value!;\n      registry.setFallback(onlyProvider);\n    }\n\n    // Build toolOverrides from mockToolMap\n    const toolOverrides = new Map<string, (args: unknown) => Promise<unknown>>();\n    for (const [name, mockTool] of this.mockToolMap) {\n      toolOverrides.set(name, async (args: unknown) => {\n        return mockTool.execute(args);\n      });\n    }\n\n    // Previously `_recordStep('workflow_start', ...)` was called here with\n    // raw `{ workflow, input }` data, AND `ctx._emitWorkflowStart` below\n    // pushed through the onTrace handler (which also bumps `_stepCounter`\n    // and appends to `_steps`). Result: two entries in `steps()` per\n    // workflow_start, with the first bypassing `config.trace.redact`.\n    // The `_recordStep` call is removed — onTrace is the single source\n    // of truth for `_steps`, matching the behavior of every other event\n    // type in the test runtime. Reviewer architecture §5.\n\n    const init: WorkflowContextInit = {\n      input: validated,\n      executionId: this._executionId,\n      metadata: options?.metadata,\n      // Thread the constructor-provided config so tests can exercise\n      // trace.level === 'full' and trace.redact behavior end-to-end.\n      config: this._config,\n      // Thread `events` config so tests can exercise the queue cap and\n      // overflow policy on `ctx.events`. Mirrors the production runtime.\n      eventStreamOptions: options?.events,\n      // Production runtime threads this (see `runtime.ts:594` in\n      // `execute()` and `:765` in `stream()`). `emitEvent` auto-stamps\n      // `event.workflow` from it, so consumers grouping by workflow\n      // (Cost Dashboard `byWorkflow`, `trackExecution.metadata.workflows`,\n      // any eval runner) see the same attribution in tests and prod.\n      workflowName,\n      providerRegistry: registry,\n      stateStore: new MemoryStore(),\n      toolOverrides: toolOverrides.size > 0 ? toolOverrides : undefined,\n      awaitHumanHandler: this._humanDecisionHandler\n        ? (opts: AwaitHumanOptions) => this._humanDecisionHandler!(opts)\n        : undefined,\n      onTrace: (event: AxlEvent) => {\n        this._traceLog.push(event);\n        this._stepCounter++;\n        this._steps.push({\n          step: this._stepCounter,\n          type: event.type,\n          data: (event as { data?: unknown }).data,\n        });\n\n        if (event.type === 'tool_call_end' && event.data) {\n          const { args, result } = event.data as { args: unknown; result: unknown };\n          // `tool: string` is required on `tool_call_end`; narrowing makes it non-null.\n          this._toolCalls.push({ name: event.tool, args, result });\n        }\n\n        // Single-source-of-truth cost accumulator. Skips ask_end\n        // rollups (decision 10) and guards NaN/Infinity.\n        this._totalCost += eventCostContribution(event);\n        // Honest aggregate: one unpriced leaf makes `totalCost()` a lower bound.\n        if (isUnpricedLeaf(event)) this._unpriced = true;\n\n        // Track provider responses for recording\n        if (event.type === 'agent_call_end' && event.data) {\n          const { response } = event.data as { prompt?: string; response?: string };\n          if (response !== undefined) {\n            this.recorded.push({\n              content: response,\n              usage: event.tokens\n                ? {\n                    prompt_tokens: event.tokens.input ?? 0,\n                    completion_tokens: event.tokens.output ?? 0,\n                    total_tokens:\n                      (event.tokens.input ?? 0) +\n                      (event.tokens.output ?? 0) +\n                      (event.tokens.reasoning ?? 0),\n                    ...(event.tokens.reasoning !== undefined\n                      ? { reasoning_tokens: event.tokens.reasoning }\n                      : {}),\n                  }\n                : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },\n              ...(event.cost !== undefined ? { cost: event.cost } : {}),\n            });\n          }\n        }\n      },\n      onAgentCallComplete: (call: AgentCallInfo) => {\n        this._agentCalls.push(call);\n      },\n    };\n\n    const ctx = new WorkflowContext(init);\n\n    // Emit workflow_start through the same pipeline production uses,\n    // AFTER ctx exists so `emitEvent`'s redact/step/timestamp handling\n    // applies. Previously emitted via `_pushTrace` which bypassed\n    // redaction — `config: { trace: { redact: true } }` on the test\n    // runtime would scrub intermediate events but leak `input`/`result`\n    // through the synthesized workflow_start/end.\n    const startedAt = Date.now();\n    ctx._emitWorkflowStart(validated);\n    try {\n      const result = await workflow.handler(ctx);\n\n      // Validate output schema if defined\n      if (workflow.outputSchema) workflow.outputSchema.parse(result);\n\n      ctx._emitWorkflowEnd({\n        status: 'completed',\n        duration: Date.now() - startedAt,\n        result,\n      });\n      // `_steps` is populated by onTrace for every event (including\n      // workflow_end); no separate `_recordStep` call needed — that\n      // would double-count.\n\n      if (this.recordPath) await this._writeRecording();\n      return result;\n    } catch (err) {\n      // Parity with production: failed workflows get a terminal\n      // `workflow_end(status: 'failed')` event so consumers counting\n      // workflow_start ↔ workflow_end pairs never see an unclosed one.\n      // `aborted` flag mirrors the runtime.ts AbortError detection.\n      const aborted =\n        typeof err === 'object' &&\n        err !== null &&\n        (err as { name?: unknown }).name === 'AbortError';\n      ctx._emitWorkflowEnd({\n        status: 'failed',\n        duration: Date.now() - startedAt,\n        error: err instanceof Error ? err.message : String(err),\n        ...(aborted ? { aborted: true } : {}),\n      });\n      // `_steps` populated by onTrace (see comment on the success path).\n      throw err;\n    }\n  }\n\n  toolCalls(name?: string): RecordedToolCall[] {\n    return name ? this._toolCalls.filter((c) => c.name === name) : this._toolCalls;\n  }\n\n  agentCalls(name?: string): RecordedAgentCall[] {\n    return name ? this._agentCalls.filter((c) => c.agent === name) : this._agentCalls;\n  }\n\n  totalCost(): number {\n    return this._totalCost;\n  }\n  /** True when any cost-bearing call was unpriced — `totalCost()` is then a\n   *  LOWER BOUND. Mirrors `ExecutionInfo.unpriced` / `BudgetResult.unpriced`. */\n  unpriced(): boolean {\n    return this._unpriced;\n  }\n  steps(): RecordedStep[] {\n    return this._steps;\n  }\n  traceLog(): AxlEvent[] {\n    return this._traceLog;\n  }\n\n  private async _writeRecording(): Promise<void> {\n    if (!this.recordPath) return;\n    const { writeFile, mkdir } = await import('node:fs/promises');\n    const { dirname } = await import('node:path');\n    await mkdir(dirname(this.recordPath), { recursive: true });\n    await writeFile(this.recordPath, JSON.stringify(this.recorded, null, 2), 'utf8');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/mock-provider.ts","../src/mock-tool.ts","../src/test-runtime.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { z } from 'zod';\nimport type {\n  ChatMessage,\n  ChatOptions,\n  ToolCallMessage,\n  ProviderResponse,\n  StreamChunk,\n  Provider,\n} from '@axlsdk/axl';\n\nfunction randomAlphanumeric(length: number): string {\n  const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * chars.length)];\n  }\n  return result;\n}\n\nfunction generateFromSchema(schema: unknown): unknown {\n  if (schema instanceof z.ZodString) return randomAlphanumeric(8 + Math.floor(Math.random() * 13));\n  if (schema instanceof z.ZodNumber) {\n    const min = Number.isFinite(schema.minValue) ? schema.minValue! : 0;\n    const max = Number.isFinite(schema.maxValue) ? schema.maxValue! : 100;\n    return min + Math.random() * (max - min);\n  }\n  if (schema instanceof z.ZodBoolean) return Math.random() < 0.5;\n  if (schema instanceof z.ZodArray) {\n    const count = 1 + Math.floor(Math.random() * 3);\n    return Array.from({ length: count }, () => generateFromSchema(schema.element));\n  }\n  if (schema instanceof z.ZodObject) {\n    const obj: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(schema.shape)) obj[key] = generateFromSchema(value);\n    return obj;\n  }\n  if (schema instanceof z.ZodOptional) {\n    if (Math.random() < 0.5) return undefined;\n    return generateFromSchema(schema.unwrap());\n  }\n  if (schema instanceof z.ZodDefault) return schema.parse(undefined);\n  if (schema instanceof z.ZodEnum) {\n    const values = schema.options;\n    return values.length > 0 ? values[Math.floor(Math.random() * values.length)] : '';\n  }\n  if (schema instanceof z.ZodLiteral) return [...schema.values][0];\n  if (schema instanceof z.ZodNullable) return null;\n  if (schema instanceof z.ZodUnion) {\n    const options = schema.options;\n    return generateFromSchema(options[Math.floor(Math.random() * options.length)]);\n  }\n  return {};\n}\n\nexport class MockProvider implements Provider {\n  readonly name = 'mock';\n  private _calls: { messages: ChatMessage[]; options: ChatOptions }[] = [];\n  /** Per-call optional chunk arrays, set by `sequence()` / `chunked()` so\n   *  `stream()` can yield one `text_delta` per chunk. Per-call indexed\n   *  alongside the response sequence. */\n  private chunkSequence?: Array<string[] | undefined>;\n  /** Optional ms delay between successive chunks during `stream()`. Useful\n   *  for dev fixtures that need to demonstrate streaming UX visually\n   *  (without a delay, mock chunks fire synchronously and complete in\n   *  microseconds — invisible to a human watching). Default 0 keeps\n   *  every existing test fast.\n   *\n   *  Set via `provider.chunkDelayMs = 50` after construction. Not part of\n   *  any factory's surface to keep the test API minimal. */\n  chunkDelayMs = 0;\n\n  private constructor(\n    private responseFn: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) => ProviderResponse | Promise<ProviderResponse>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async chat(messages: ChatMessage[], options: ChatOptions): Promise<ProviderResponse> {\n    this._calls.push({ messages, options });\n    return await this.responseFn(messages, this._calls.length - 1);\n  }\n\n  async *stream(messages: ChatMessage[], options: ChatOptions): AsyncGenerator<StreamChunk> {\n    const callIndex = this._calls.length;\n    const response = await this.chat(messages, options);\n    const chunks = this.chunkSequence?.[callIndex];\n    if (chunks && chunks.length > 0) {\n      // Sanity guard — if a caller passes chunks AND content, they MUST\n      // match. Otherwise tests pass while the real prod content silently\n      // diverges from what the streaming path observes.\n      const joined = chunks.join('');\n      if (joined !== response.content) {\n        throw new Error(\n          `MockProvider.stream: chunks.join('') !== content. ` +\n            `chunks=\"${joined}\" content=\"${response.content}\"`,\n        );\n      }\n      for (let i = 0; i < chunks.length; i++) {\n        yield { type: 'text_delta', content: chunks[i] };\n        if (this.chunkDelayMs > 0 && i < chunks.length - 1) {\n          await new Promise((resolve) => setTimeout(resolve, this.chunkDelayMs));\n        }\n      }\n    } else if (response.content) {\n      yield { type: 'text_delta', content: response.content };\n    }\n    if (response.tool_calls) {\n      for (const tc of response.tool_calls) {\n        yield {\n          type: 'tool_call_delta',\n          id: tc.id,\n          name: tc.function.name,\n          arguments: tc.function.arguments,\n        };\n      }\n    }\n    yield { type: 'done', usage: response.usage, providerMetadata: response.providerMetadata };\n  }\n\n  static sequence(\n    responses: Array<{\n      content: string;\n      tool_calls?: ToolCallMessage[];\n      providerMetadata?: Record<string, unknown>;\n      usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n      cost?: number;\n      /** When set, `stream()` yields one `text_delta` per entry instead\n       *  of one big delta with the full content. Use to exercise\n       *  partial-JSON parsing, structural-boundary throttling, and\n       *  cross-attempt token retention in tests. Must satisfy\n       *  `chunks.join('') === content`. */\n      chunks?: string[];\n    }>,\n  ): MockProvider {\n    const provider = new MockProvider((_messages, callIndex) => {\n      if (callIndex >= responses.length) {\n        throw new Error(\n          `MockProvider.sequence: no response for call index ${callIndex}. Only ${responses.length} responses defined.`,\n        );\n      }\n      const resp = responses[callIndex];\n      return {\n        content: resp.content,\n        tool_calls: resp.tool_calls,\n        providerMetadata: resp.providerMetadata,\n        usage: resp.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: resp.cost ?? 0,\n      };\n    });\n    provider.chunkSequence = responses.map((r) => r.chunks);\n    return provider;\n  }\n\n  /**\n   * Convenience: build a `sequence()` from plain content strings, splitting\n   * each one into fixed-size chunks for the streaming path. Default\n   * `chunkSize` is 4 chars (≈1 token).\n   */\n  static chunked(contents: string[], chunkSize = 4): MockProvider {\n    const responses = contents.map((content) => {\n      const chunks: string[] = [];\n      for (let i = 0; i < content.length; i += chunkSize) {\n        chunks.push(content.slice(i, i + chunkSize));\n      }\n      return { content, chunks };\n    });\n    return MockProvider.sequence(responses);\n  }\n\n  static echo(): MockProvider {\n    return new MockProvider((messages) => {\n      const lastUser = [...messages].reverse().find((m) => m.role === 'user');\n      return {\n        content: lastUser?.content ?? '',\n        usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: 0,\n      };\n    });\n  }\n\n  static json(schema: unknown): MockProvider {\n    return new MockProvider(() => ({\n      content: JSON.stringify(generateFromSchema(schema)),\n      usage: { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n      cost: 0,\n    }));\n  }\n\n  static replay(source: string | ProviderResponse[]): MockProvider {\n    const data =\n      typeof source === 'string'\n        ? (JSON.parse(readFileSync(source, 'utf-8')) as ProviderResponse[])\n        : source;\n    return new MockProvider((_messages, callIndex) => {\n      if (callIndex >= data.length) {\n        throw new Error(`MockProvider.replay: no recorded response for call index ${callIndex}`);\n      }\n      return data[callIndex];\n    });\n  }\n\n  static fn(\n    handler: (\n      messages: ChatMessage[],\n      callIndex: number,\n    ) =>\n      | {\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }\n      | Promise<{\n          content: string;\n          tool_calls?: ToolCallMessage[];\n          providerMetadata?: Record<string, unknown>;\n          usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\n          cost?: number;\n        }>,\n  ): MockProvider {\n    return new MockProvider(async (messages, callIndex) => {\n      const result = await handler(messages, callIndex);\n      return {\n        ...result,\n        usage: result.usage ?? { prompt_tokens: 10, completion_tokens: 10, total_tokens: 20 },\n        cost: result.cost ?? 0,\n      };\n    });\n  }\n}\n","export class MockTool {\n  private _calls: { input: unknown }[] = [];\n\n  constructor(\n    readonly name: string,\n    private handler: (input: unknown) => unknown | Promise<unknown>,\n  ) {}\n\n  get calls() {\n    return this._calls;\n  }\n\n  async execute(input: unknown): Promise<unknown> {\n    this._calls.push({ input });\n    return this.handler(input);\n  }\n\n  static create(name: string, handler: (input: unknown) => unknown | Promise<unknown>): MockTool {\n    return new MockTool(name, handler);\n  }\n}\n","import { MockProvider } from './mock-provider.js';\nimport { MockTool } from './mock-tool.js';\nimport type {\n  AxlEvent,\n  AwaitHumanOptions,\n  HumanDecision,\n  ProviderResponse,\n  AgentCallInfo,\n  AxlConfig,\n  AnyWorkflow,\n  ToolCallOutcome,\n  ObservationStatus,\n} from '@axlsdk/axl';\nimport {\n  WorkflowContext,\n  MemoryStore,\n  ProviderRegistry,\n  eventCostContribution,\n  isUnpricedLeaf,\n} from '@axlsdk/axl';\nimport type { EventStreamOptions, WorkflowContextInit } from '@axlsdk/axl';\n\n// `AnyWorkflow` is a re-exported alias for `Workflow<any, any>` — see\n// the JSDoc on `AnyWorkflow` in `@axlsdk/axl/workflow.ts`. The bivariant\n// `any` is load-bearing for satisfying narrowly-typed handlers (e.g., a\n// `Workflow<TInput=MsgType>` whose handler takes `WorkflowContext<MsgType>`).\n\n/** One accepted provider-issued tool invocation, recorded from its terminal v2 event.\n *\n * Narrow `outcome.status` before reading status-specific fields. Correlation uses\n * `(executionId, askId, callId)`; `name` is the canonical tool name.\n */\nexport type RecordedToolCall = {\n  name: string;\n  executionId: string;\n  askId: string;\n  callId: string;\n  args: unknown;\n  requestedTool?: string;\n  outcome: ToolCallOutcome;\n};\nexport type RecordedAgentCall = Partial<AgentCallInfo> &\n  Pick<AgentCallInfo, 'agent' | 'prompt' | 'response'>;\nexport type RecordedStep = { step: number; type: string; data: unknown };\n\nfunction generateExecutionId(): string {\n  return `test-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction preserveDrainCause(error: Error, cause: unknown): Error {\n  if (cause === undefined || cause === error || 'cause' in error) return error;\n  Object.defineProperty(error, 'cause', {\n    configurable: true,\n    enumerable: false,\n    value: cause,\n  });\n  return error;\n}\n\nexport type AxlTestRuntimeOptions = {\n  record?: string;\n  humanDecisions?: (options: AwaitHumanOptions) => HumanDecision;\n  /** AxlConfig for the test runtime. Controls trace level/redact, context management, etc.\n   *  Defaults to `{}`. Set `{ trace: { level: 'full' } }` to verify verbose-mode snapshots\n   *  in tests, or `{ trace: { redact: true } }` to verify redaction policy in tests. */\n  config?: AxlConfig;\n};\n\nexport class AxlTestRuntime {\n  private workflows = new Map<string, AnyWorkflow>();\n  private mockProviders = new Map<string, MockProvider>();\n  private mockToolMap = new Map<string, MockTool>();\n  private _toolCalls: RecordedToolCall[] = [];\n  private _agentCalls: RecordedAgentCall[] = [];\n  private _steps: RecordedStep[] = [];\n  private _traceLog: AxlEvent[] = [];\n  private _totalCost = 0;\n  private _unpriced = false;\n  private _stepCounter = 0;\n  private recordPath?: string;\n  private recorded: ProviderResponse[] = [];\n  private _executionId: string = generateExecutionId();\n  private _humanDecisionHandler?: (options: AwaitHumanOptions) => HumanDecision;\n  private _config: AxlConfig;\n\n  constructor(options?: AxlTestRuntimeOptions) {\n    this.recordPath = options?.record;\n    this._humanDecisionHandler = options?.humanDecisions;\n    this._config = options?.config ?? {};\n  }\n\n  register(workflow: AnyWorkflow): void {\n    this.workflows.set(workflow.name, workflow);\n  }\n\n  mockProvider(name: string, provider: MockProvider): void {\n    this.mockProviders.set(name, provider);\n  }\n\n  mockTool<TInput = unknown>(\n    name: string,\n    handler: (input: TInput) => unknown | Promise<unknown>,\n  ): void {\n    // The MockTool registry is type-erased (`(input: unknown) => unknown`)\n    // because the runtime can't statically know each tool's input shape; tests\n    // opt in to a typed input via the generic, and we cast on storage.\n    this.mockToolMap.set(name, MockTool.create(name, handler as (input: unknown) => unknown));\n  }\n\n  async execute(\n    workflowName: string,\n    input: unknown,\n    options?: {\n      metadata?: Record<string, unknown>;\n      events?: EventStreamOptions;\n      branchDrainTimeoutMs?: number;\n    },\n  ): Promise<unknown> {\n    const workflow = this.workflows.get(workflowName);\n    if (!workflow) throw new Error(`Workflow \"${workflowName}\" not registered`);\n\n    // Reset state between executions\n    this._toolCalls = [];\n    this._agentCalls = [];\n    this._steps = [];\n    this._traceLog = [];\n    this._totalCost = 0;\n    this._unpriced = false;\n    this._stepCounter = 0;\n    this.recorded = [];\n    this._executionId = generateExecutionId();\n\n    const validated = workflow.inputSchema.parse(input);\n\n    // Build ProviderRegistry from registered mock providers\n    const registry = new ProviderRegistry();\n    registry.clearFactories(); // Remove built-in factories; only use explicit mocks\n    for (const [name, provider] of this.mockProviders) {\n      registry.registerInstance(name, provider);\n    }\n    // Fallback resolution: 'default' key or single-provider\n    const defaultProvider = this.mockProviders.get('default');\n    if (defaultProvider) {\n      registry.setFallback(defaultProvider);\n    } else if (this.mockProviders.size === 1) {\n      const onlyProvider = this.mockProviders.values().next().value!;\n      registry.setFallback(onlyProvider);\n    }\n\n    // Build toolOverrides from mockToolMap\n    const toolOverrides = new Map<string, (args: unknown) => Promise<unknown>>();\n    for (const [name, mockTool] of this.mockToolMap) {\n      toolOverrides.set(name, async (args: unknown) => {\n        return mockTool.execute(args);\n      });\n    }\n\n    // Previously `_recordStep('workflow_start', ...)` was called here with\n    // raw `{ workflow, input }` data, AND `ctx._emitWorkflowStart` below\n    // pushed through the onTrace handler (which also bumps `_stepCounter`\n    // and appends to `_steps`). Result: two entries in `steps()` per\n    // workflow_start, with the first bypassing `config.trace.redact`.\n    // The `_recordStep` call is removed — onTrace is the single source\n    // of truth for `_steps`, matching the behavior of every other event\n    // type in the test runtime. Reviewer architecture §5.\n\n    const init: WorkflowContextInit = {\n      input: validated,\n      executionId: this._executionId,\n      metadata: options?.metadata,\n      // Thread the constructor-provided config so tests can exercise\n      // trace.level === 'full' and trace.redact behavior end-to-end.\n      config: this._config,\n      // Thread `events` config so tests can exercise the queue cap and\n      // overflow policy on `ctx.events`. Mirrors the production runtime.\n      eventStreamOptions: options?.events,\n      branchDrainTimeoutMs: options?.branchDrainTimeoutMs,\n      // Production runtime threads this (see `runtime.ts:594` in\n      // `execute()` and `:765` in `stream()`). `emitEvent` auto-stamps\n      // `event.workflow` from it, so consumers grouping by workflow\n      // (Cost Dashboard `byWorkflow`, `trackExecution.metadata.workflows`,\n      // any eval runner) see the same attribution in tests and prod.\n      workflowName,\n      providerRegistry: registry,\n      stateStore: new MemoryStore(),\n      toolOverrides: toolOverrides.size > 0 ? toolOverrides : undefined,\n      awaitHumanHandler: this._humanDecisionHandler\n        ? (opts: AwaitHumanOptions) => this._humanDecisionHandler!(opts)\n        : undefined,\n      onTrace: (event: AxlEvent) => {\n        this._traceLog.push(event);\n        this._stepCounter++;\n        this._steps.push({\n          step: this._stepCounter,\n          type: event.type,\n          data: (event as { data?: unknown }).data,\n        });\n\n        if (event.type === 'tool_call_end') {\n          const { args, requestedTool, outcome } = event.data;\n          this._toolCalls.push({\n            name: event.tool,\n            executionId: event.executionId,\n            askId: event.askId,\n            callId: event.callId,\n            args,\n            ...(requestedTool !== undefined ? { requestedTool } : {}),\n            outcome,\n          });\n        }\n\n        // Single-source-of-truth cost accumulator. Skips ask_end\n        // rollups (decision 10) and guards NaN/Infinity.\n        this._totalCost += eventCostContribution(event);\n        // Honest aggregate: one unpriced leaf makes `totalCost()` a lower bound.\n        if (isUnpricedLeaf(event)) this._unpriced = true;\n\n        // Track provider responses for recording\n        if (event.type === 'agent_call_end' && event.data) {\n          const { response } = event.data as { prompt?: string; response?: string };\n          if (response !== undefined) {\n            this.recorded.push({\n              content: response,\n              usage: event.tokens\n                ? {\n                    prompt_tokens: event.tokens.input ?? 0,\n                    completion_tokens: event.tokens.output ?? 0,\n                    total_tokens:\n                      (event.tokens.input ?? 0) +\n                      (event.tokens.output ?? 0) +\n                      (event.tokens.reasoning ?? 0),\n                    ...(event.tokens.reasoning !== undefined\n                      ? { reasoning_tokens: event.tokens.reasoning }\n                      : {}),\n                  }\n                : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },\n              ...(event.cost !== undefined ? { cost: event.cost } : {}),\n            });\n          }\n        }\n      },\n      onAgentCallComplete: (call: AgentCallInfo) => {\n        this._agentCalls.push(call);\n      },\n    };\n\n    const ctx = new WorkflowContext(init);\n\n    // Emit workflow_start through the same pipeline production uses,\n    // AFTER ctx exists so `emitEvent`'s redact/step/timestamp handling\n    // applies. Previously emitted via `_pushTrace` which bypassed\n    // redaction — `config: { trace: { redact: true } }` on the test\n    // runtime would scrub intermediate events but leak `input`/`result`\n    // through the synthesized workflow_start/end.\n    const startedAt = Date.now();\n    ctx._emitWorkflowStart(validated);\n    try {\n      const result = await workflow.handler(ctx);\n      const observation = await ctx._drainBranchWork();\n\n      // Validate output schema if defined\n      if (workflow.outputSchema) workflow.outputSchema.parse(result);\n\n      ctx._emitWorkflowEnd({\n        status: 'completed',\n        duration: Date.now() - startedAt,\n        result,\n        observation,\n      });\n      // `_steps` is populated by onTrace for every event (including\n      // workflow_end); no separate `_recordStep` call needed — that\n      // would double-count.\n\n      if (this.recordPath) await this._writeRecording();\n      return result;\n    } catch (err) {\n      let workflowError = err;\n      let observation: ObservationStatus = { complete: true };\n      try {\n        observation = await ctx._drainBranchWork();\n      } catch (drainError) {\n        workflowError =\n          drainError instanceof Error ? preserveDrainCause(drainError, workflowError) : drainError;\n      }\n      // Parity with production: failed workflows get a terminal\n      // `workflow_end(status: 'failed')` event so consumers counting\n      // workflow_start ↔ workflow_end pairs never see an unclosed one.\n      // `aborted` flag mirrors the runtime.ts AbortError detection.\n      const aborted =\n        typeof workflowError === 'object' &&\n        workflowError !== null &&\n        (workflowError as { name?: unknown }).name === 'AbortError';\n      ctx._emitWorkflowEnd({\n        status: 'failed',\n        duration: Date.now() - startedAt,\n        error: workflowError instanceof Error ? workflowError.message : String(workflowError),\n        ...(aborted ? { aborted: true } : {}),\n        observation,\n      });\n      // `_steps` populated by onTrace (see comment on the success path).\n      throw workflowError;\n    }\n  }\n\n  toolCalls(name?: string): RecordedToolCall[] {\n    return name ? this._toolCalls.filter((c) => c.name === name) : this._toolCalls;\n  }\n\n  agentCalls(name?: string): RecordedAgentCall[] {\n    return name ? this._agentCalls.filter((c) => c.agent === name) : this._agentCalls;\n  }\n\n  totalCost(): number {\n    return this._totalCost;\n  }\n  /** True when any cost-bearing call was unpriced — `totalCost()` is then a\n   *  LOWER BOUND. Mirrors `ExecutionInfo.unpriced` / `BudgetResult.unpriced`. */\n  unpriced(): boolean {\n    return this._unpriced;\n  }\n  steps(): RecordedStep[] {\n    return this._steps;\n  }\n  traceLog(): AxlEvent[] {\n    return this._traceLog;\n  }\n\n  private async _writeRecording(): Promise<void> {\n    if (!this.recordPath) return;\n    const { writeFile, mkdir } = await import('node:fs/promises');\n    const { dirname } = await import('node:path');\n    await mkdir(dirname(this.recordPath), { recursive: true });\n    await writeFile(this.recordPath, JSON.stringify(this.recorded, null, 2), 'utf8');\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axlsdk/testing",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Testing utilities for Axl agentic workflows",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,7 @@
     "dist"
   ],
   "dependencies": {
-    "@axlsdk/axl": "0.19.0"
+    "@axlsdk/axl": "0.20.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0"