@livekit/agents 1.0.34 → 1.0.36

package/dist/voice/testing/run_result.js

@@ -0,0 +1,451 @@
+import { Future } from "../../utils.js";
+import { isSpeechHandle } from "../speech_handle.js";
+import {
+  isAgentHandoffEvent,
+  isChatMessageEvent,
+  isFunctionCallEvent,
+  isFunctionCallOutputEvent
+} from "./types.js";
+const evalsVerbose = parseInt(process.env.LIVEKIT_EVALS_VERBOSE || "0", 10);
+class RunResult {
+  _events = [];
+  doneFut = new Future();
+  userInput;
+  handles = /* @__PURE__ */ new Set();
+  lastSpeechHandle;
+  runAssert;
+  // TODO(brian): Add typed output support for parity with Python
+  // - Add outputType?: new (...args: unknown[]) => T
+  // - Add finalOutput?: T
+  // - Implement markDone() to extract final_output from SpeechHandle.maybeRunFinalOutput
+  // - See Python: run_result.py lines 182-201
+  constructor(options) {
+    this.userInput = options == null ? void 0 : options.userInput;
+  }
+  /**
+   * List of all recorded events generated during the run.
+   */
+  get events() {
+    return this._events;
+  }
+  /**
+   * Provides an assertion helper for verifying the run events.
+   */
+  get expect() {
+    if (evalsVerbose) {
+      const eventsStr = formatEvents(this._events).map((line) => `      ${line}`).join("\n");
+      console.log(
+        `
++ RunResult {
+    userInput: "${this.userInput}"
+    events: [
+${eventsStr}
+    ]
+  }`
+      );
+    }
+    if (!this.runAssert) {
+      this.runAssert = new RunAssert(this);
+    }
+    return this.runAssert;
+  }
+  /**
+   * Returns the final output of the run after completion.
+   *
+   * @throws Error - Not implemented yet.
+   */
+  get finalOutput() {
+    throw new Error("finalOutput is not yet implemented in JS.");
+  }
+  /**
+   * Indicates whether the run has finished processing all events.
+   */
+  done() {
+    return this.doneFut.done;
+  }
+  /**
+   * Wait for the RunResult to complete. Returns `this` for method chaining.
+   *
+   * @example
+   * ```ts
+   * const result = session.run({ userInput: 'Hi!' });
+   * await result.wait();  // waits for completion
+   * result.expect.nextEvent().isMessage({ role: 'assistant' });
+   * ```
+   */
+  async wait() {
+    await this.doneFut.await;
+    return this;
+  }
+  /**
+   * @internal
+   * Records an agent handoff event.
+   */
+  _agentHandoff(params) {
+    const event = {
+      type: "agent_handoff",
+      item: params.item,
+      oldAgent: params.oldAgent,
+      newAgent: params.newAgent
+    };
+    const index = this._findInsertionIndex(event.item.createdAt);
+    this._events.splice(index, 0, event);
+  }
+  /**
+   * @internal
+   * Called when a chat item is added during the run.
+   */
+  _itemAdded(item) {
+    if (this.doneFut.done) {
+      return;
+    }
+    let event;
+    if (item.type === "message") {
+      event = { type: "message", item };
+    } else if (item.type === "function_call") {
+      event = { type: "function_call", item };
+    } else if (item.type === "function_call_output") {
+      event = { type: "function_call_output", item };
+    }
+    if (event) {
+      const index = this._findInsertionIndex(item.createdAt);
+      this._events.splice(index, 0, event);
+    }
+  }
+  /**
+   * @internal
+   * Watch a speech handle or task for completion.
+   */
+  _watchHandle(handle) {
+    this.handles.add(handle);
+    if (isSpeechHandle(handle)) {
+      handle._addItemAddedCallback(this._itemAdded.bind(this));
+    }
+    handle.addDoneCallback(() => {
+      this._markDoneIfNeeded(handle);
+    });
+  }
+  /**
+   * @internal
+   * Unwatch a handle.
+   */
+  _unwatchHandle(handle) {
+    this.handles.delete(handle);
+    if (isSpeechHandle(handle)) {
+      handle._removeItemAddedCallback(this._itemAdded.bind(this));
+    }
+  }
+  _markDoneIfNeeded(handle) {
+    if (isSpeechHandle(handle)) {
+      this.lastSpeechHandle = handle;
+    }
+    if ([...this.handles].every((h) => isSpeechHandle(h) ? h.done() : h.done)) {
+      this._markDone();
+    }
+  }
+  _markDone() {
+    if (!this.doneFut.done) {
+      this.doneFut.resolve();
+    }
+  }
+  /**
+   * Find the correct insertion index to maintain chronological order.
+   */
+  _findInsertionIndex(createdAt) {
+    for (let i = this._events.length - 1; i >= 0; i--) {
+      if (this._events[i].item.createdAt <= createdAt) {
+        return i + 1;
+      }
+    }
+    return 0;
+  }
+}
+class RunAssert {
+  _events;
+  _currentIndex = 0;
+  // TODO(brian): Add range access for parity with Python __getitem__ slice support.
+  // - Add range(start?, end?) method returning EventRangeAssert
+  // - EventRangeAssert should have containsFunctionCall(), containsMessage() methods
+  // See Python run_result.py lines 247-251 for reference.
+  constructor(runResult) {
+    this._events = runResult.events;
+  }
+  /**
+   * Access a specific event by index for assertions.
+   * Supports negative indices (e.g., -1 for last event).
+   *
+   * @example
+   * ```typescript
+   * result.expect.at(0).isMessage({ role: 'user' });
+   * result.expect.at(-1).isMessage({ role: 'assistant' });
+   * ```
+   */
+  at(index) {
+    let normalizedIndex = index;
+    if (index < 0) {
+      normalizedIndex = this._events.length + index;
+    }
+    if (normalizedIndex < 0 || normalizedIndex >= this._events.length) {
+      this._raiseWithDebugInfo(
+        `at(${index}) out of range (total events: ${this._events.length})`,
+        normalizedIndex
+      );
+    }
+    return new EventAssert(this._events[normalizedIndex], this, normalizedIndex);
+  }
+  /**
+   * Advance to the next event, optionally filtering by type.
+   *
+   * @example
+   * ```typescript
+   * result.expect.nextEvent().isMessage({ role: 'assistant' });
+   * result.expect.nextEvent({ type: 'function_call' }).isFunctionCall({ name: 'foo' });
+   * ```
+   */
+  nextEvent(options) {
+    while (true) {
+      const evAssert = this._currentEvent();
+      this._currentIndex++;
+      if (!(options == null ? void 0 : options.type) || evAssert.event().type === options.type) {
+        return evAssert;
+      }
+    }
+  }
+  /**
+   * Skip a specified number of upcoming events without assertions.
+   *
+   * @example
+   * ```typescript
+   * result.expect.skipNext(2);
+   * ```
+   */
+  skipNext(count = 1) {
+    for (let i = 0; i < count; i++) {
+      if (this._currentIndex >= this._events.length) {
+        this._raiseWithDebugInfo(`Tried to skip ${count} event(s), but only ${i} were available.`);
+      }
+      this._currentIndex++;
+    }
+    return this;
+  }
+  /**
+   * Assert that there are no further events.
+   *
+   * @example
+   * ```typescript
+   * result.expect.noMoreEvents();
+   * ```
+   */
+  noMoreEvents() {
+    if (this._currentIndex < this._events.length) {
+      const event = this._events[this._currentIndex];
+      this._raiseWithDebugInfo(`Expected no more events, but found: ${event.type}`);
+    }
+  }
+  _currentEvent() {
+    if (this._currentIndex >= this._events.length) {
+      this._raiseWithDebugInfo("Expected another event, but none left.");
+    }
+    return this.at(this._currentIndex);
+  }
+  /** @internal */
+  _raiseWithDebugInfo(message, index) {
+    const markerIndex = index ?? this._currentIndex;
+    const eventsStr = formatEvents(this._events, markerIndex).join("\n");
+    throw new AssertionError(`${message}
+Context around failure:
+${eventsStr}`);
+  }
+}
+class EventAssert {
+  _event;
+  _parent;
+  _index;
+  constructor(event, parent, index) {
+    this._event = event;
+    this._parent = parent;
+    this._index = index;
+  }
+  /**
+   * Get the underlying event.
+   */
+  event() {
+    return this._event;
+  }
+  _raise(message) {
+    this._parent._raiseWithDebugInfo(message, this._index);
+  }
+  /**
+   * Verify this event is a message with optional role matching.
+   *
+   * @example
+   * ```typescript
+   * result.expect.nextEvent().isMessage({ role: 'assistant' });
+   * ```
+   */
+  isMessage(options) {
+    if (!isChatMessageEvent(this._event)) {
+      this._raise(`Expected ChatMessageEvent, got ${this._event.type}`);
+    }
+    if ((options == null ? void 0 : options.role) && this._event.item.role !== options.role) {
+      this._raise(`Expected role '${options.role}', got '${this._event.item.role}'`);
+    }
+    return new MessageAssert(this._event, this._parent, this._index);
+  }
+  /**
+   * Verify this event is a function call with optional name/args matching.
+   *
+   * @example
+   * ```typescript
+   * result.expect.nextEvent().isFunctionCall({ name: 'order_item', args: { id: 'big_mac' } });
+   * ```
+   */
+  isFunctionCall(options) {
+    if (!isFunctionCallEvent(this._event)) {
+      this._raise(`Expected FunctionCallEvent, got ${this._event.type}`);
+    }
+    if ((options == null ? void 0 : options.name) && this._event.item.name !== options.name) {
+      this._raise(`Expected call name '${options.name}', got '${this._event.item.name}'`);
+    }
+    if (options == null ? void 0 : options.args) {
+      let actual;
+      try {
+        actual = JSON.parse(this._event.item.args);
+      } catch {
+        this._raise(`Failed to parse function call arguments: ${this._event.item.args}`);
+      }
+      for (const [key, value] of Object.entries(options.args)) {
+        if (!(key in actual) || actual[key] !== value) {
+          this._raise(
+            `For key '${key}', expected ${JSON.stringify(value)}, got ${JSON.stringify(actual[key])}`
+          );
+        }
+      }
+    }
+    return new FunctionCallAssert(this._event, this._parent, this._index);
+  }
+  /**
+   * Verify this event is a function call output with optional matching.
+   *
+   * @example
+   * ```typescript
+   * result.expect.nextEvent().isFunctionCallOutput({ isError: false });
+   * ```
+   */
+  isFunctionCallOutput(options) {
+    if (!isFunctionCallOutputEvent(this._event)) {
+      this._raise(`Expected FunctionCallOutputEvent, got ${this._event.type}`);
+    }
+    if ((options == null ? void 0 : options.output) !== void 0 && this._event.item.output !== options.output) {
+      this._raise(`Expected output '${options.output}', got '${this._event.item.output}'`);
+    }
+    if ((options == null ? void 0 : options.isError) !== void 0 && this._event.item.isError !== options.isError) {
+      this._raise(`Expected isError=${options.isError}, got ${this._event.item.isError}`);
+    }
+    return new FunctionCallOutputAssert(this._event, this._parent, this._index);
+  }
+  /**
+   * Verify this event is an agent handoff with optional type matching.
+   *
+   * @example
+   * ```typescript
+   * result.expect.nextEvent().isAgentHandoff({ newAgentType: MyAgent });
+   * ```
+   */
+  isAgentHandoff(options) {
+    if (!isAgentHandoffEvent(this._event)) {
+      this._raise(`Expected AgentHandoffEvent, got ${this._event.type}`);
+    }
+    const event = this._event;
+    if (options == null ? void 0 : options.newAgentType) {
+      const actualType = event.newAgent.constructor.name;
+      if (!(event.newAgent instanceof options.newAgentType)) {
+        this._raise(`Expected new_agent '${options.newAgentType.name}', got '${actualType}'`);
+      }
+    }
+    return new AgentHandoffAssert(event, this._parent, this._index);
+  }
+}
+class MessageAssert extends EventAssert {
+  constructor(event, parent, index) {
+    super(event, parent, index);
+  }
+  event() {
+    return this._event;
+  }
+  // Phase 3: judge() method will be added here
+}
+class FunctionCallAssert extends EventAssert {
+  constructor(event, parent, index) {
+    super(event, parent, index);
+  }
+  event() {
+    return this._event;
+  }
+}
+class FunctionCallOutputAssert extends EventAssert {
+  constructor(event, parent, index) {
+    super(event, parent, index);
+  }
+  event() {
+    return this._event;
+  }
+}
+class AgentHandoffAssert extends EventAssert {
+  constructor(event, parent, index) {
+    super(event, parent, index);
+  }
+  event() {
+    return this._event;
+  }
+}
+class AssertionError extends Error {
+  constructor(message) {
+    var _a;
+    super(message);
+    this.name = "AssertionError";
+    (_a = Error.captureStackTrace) == null ? void 0 : _a.call(Error, this, AssertionError);
+  }
+}
+function formatEvents(events, selectedIndex) {
+  var _a;
+  const lines = [];
+  for (let i = 0; i < events.length; i++) {
+    const event = events[i];
+    let prefix = "";
+    if (selectedIndex !== void 0) {
+      prefix = i === selectedIndex ? ">>>" : "   ";
+    }
+    let line;
+    if (isChatMessageEvent(event)) {
+      const { role, content, interrupted } = event.item;
+      const textContent = typeof content === "string" ? content : Array.isArray(content) ? content.filter((c) => typeof c === "string").join(" ") : "";
+      const truncated = textContent.length > 50 ? textContent.slice(0, 50) + "..." : textContent;
+      line = `${prefix}[${i}] { type: "message", role: "${role}", content: "${truncated}", interrupted: ${interrupted} }`;
+    } else if (isFunctionCallEvent(event)) {
+      const { name, args } = event.item;
+      line = `${prefix}[${i}] { type: "function_call", name: "${name}", args: ${args} }`;
+    } else if (isFunctionCallOutputEvent(event)) {
+      const { output, isError } = event.item;
+      const truncated = output.length > 50 ? output.slice(0, 50) + "..." : output;
+      line = `${prefix}[${i}] { type: "function_call_output", output: "${truncated}", isError: ${isError} }`;
+    } else if (isAgentHandoffEvent(event)) {
+      line = `${prefix}[${i}] { type: "agent_handoff", oldAgent: "${(_a = event.oldAgent) == null ? void 0 : _a.constructor.name}", newAgent: "${event.newAgent.constructor.name}" }`;
+    } else {
+      line = `${prefix}[${i}] ${event}`;
+    }
+    lines.push(line);
+  }
+  return lines;
+}
+export {
+  AgentHandoffAssert,
+  AssertionError,
+  EventAssert,
+  FunctionCallAssert,
+  FunctionCallOutputAssert,
+  MessageAssert,
+  RunAssert,
+  RunResult
+};
+//# sourceMappingURL=run_result.js.map

package/dist/voice/testing/run_result.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/testing/run_result.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { AgentHandoffItem, ChatItem } from '../../llm/chat_context.js';\nimport type { Task } from '../../utils.js';\nimport { Future } from '../../utils.js';\nimport type { Agent } from '../agent.js';\nimport { type SpeechHandle, isSpeechHandle } from '../speech_handle.js';\nimport {\n  type AgentHandoffAssertOptions,\n  type AgentHandoffEvent,\n  type ChatMessageEvent,\n  type EventType,\n  type FunctionCallAssertOptions,\n  type FunctionCallEvent,\n  type FunctionCallOutputAssertOptions,\n  type FunctionCallOutputEvent,\n  type MessageAssertOptions,\n  type RunEvent,\n  isAgentHandoffEvent,\n  isChatMessageEvent,\n  isFunctionCallEvent,\n  isFunctionCallOutputEvent,\n} from './types.js';\n\n// Environment variable for verbose output\nconst evalsVerbose = parseInt(process.env.LIVEKIT_EVALS_VERBOSE || '0', 10);\n\n/**\n * Result of a test run containing recorded events and assertion utilities.\n *\n * @example\n * ```typescript\n * const result = await session.run({ userInput: 'Hello' });\n * result.expect.nextEvent().isMessage({ role: 'assistant' });\n * result.expect.noMoreEvents();\n * ```\n */\nexport class RunResult<T = unknown> {\n  private _events: RunEvent[] = [];\n  private doneFut = new Future<void>();\n  private userInput?: string;\n\n  private handles: Set<SpeechHandle | Task<void>> = new Set();\n  private lastSpeechHandle?: SpeechHandle;\n  private runAssert?: RunAssert;\n\n  // TODO(brian): Add typed output support for parity with Python\n  // - Add outputType?: new (...args: unknown[]) => T\n  // - Add finalOutput?: T\n  // - Implement markDone() to extract final_output from SpeechHandle.maybeRunFinalOutput\n  // - See Python: run_result.py lines 182-201\n\n  constructor(options?: { userInput?: string }) {\n    this.userInput = options?.userInput;\n  }\n\n  /**\n   * List of all recorded events generated during the run.\n   */\n  get events(): RunEvent[] {\n    return this._events;\n  }\n\n  /**\n   * Provides an assertion helper for verifying the run events.\n   */\n  get expect(): RunAssert {\n    if (evalsVerbose) {\n      const eventsStr = formatEvents(this._events)\n        .map((line) => `      ${line}`)\n        .join('\\n');\n      console.log(\n        `\\n+ RunResult {\\n    userInput: \"${this.userInput}\"\\n    events: [\\n${eventsStr}\\n    ]\\n  }`,\n      );\n    }\n\n    // Cache the RunAssert so cursor position persists across multiple .expect accesses\n    if (!this.runAssert) {\n      this.runAssert = new RunAssert(this);\n    }\n    return this.runAssert;\n  }\n\n  /**\n   * Returns the final output of the run after completion.\n   *\n   * @throws Error - Not implemented yet.\n   */\n  get finalOutput(): T {\n    // TODO(brian): Implement typed output support after AgentTask is implemented.\n    throw new Error('finalOutput is not yet implemented in JS.');\n  }\n\n  /**\n   * Indicates whether the run has finished processing all events.\n   */\n  done(): boolean {\n    return this.doneFut.done;\n  }\n\n  /**\n   * Wait for the RunResult to complete. Returns `this` for method chaining.\n   *\n   * @example\n   * ```ts\n   * const result = session.run({ userInput: 'Hi!' });\n   * await result.wait();  // waits for completion\n   * result.expect.nextEvent().isMessage({ role: 'assistant' });\n   * ```\n   */\n  async wait(): Promise<this> {\n    await this.doneFut.await;\n    return this;\n  }\n\n  /**\n   * @internal\n   * Records an agent handoff event.\n   */\n  _agentHandoff(params: { item: AgentHandoffItem; oldAgent?: Agent; newAgent: Agent }): void {\n    const event: AgentHandoffEvent = {\n      type: 'agent_handoff',\n      item: params.item,\n      oldAgent: params.oldAgent,\n      newAgent: params.newAgent,\n    };\n    const index = this._findInsertionIndex(event.item.createdAt);\n    this._events.splice(index, 0, event);\n  }\n\n  /**\n   * @internal\n   * Called when a chat item is added during the run.\n   */\n  _itemAdded(item: ChatItem): void {\n    if (this.doneFut.done) {\n      return;\n    }\n\n    let event: RunEvent | undefined;\n\n    if (item.type === 'message') {\n      event = { type: 'message', item } as ChatMessageEvent;\n    } else if (item.type === 'function_call') {\n      event = { type: 'function_call', item } as FunctionCallEvent;\n    } else if (item.type === 'function_call_output') {\n      event = { type: 'function_call_output', item } as FunctionCallOutputEvent;\n    }\n\n    if (event) {\n      const index = this._findInsertionIndex(item.createdAt);\n      this._events.splice(index, 0, event);\n    }\n  }\n\n  /**\n   * @internal\n   * Watch a speech handle or task for completion.\n   */\n  _watchHandle(handle: SpeechHandle | Task<void>): void {\n    this.handles.add(handle);\n\n    if (isSpeechHandle(handle)) {\n      handle._addItemAddedCallback(this._itemAdded.bind(this));\n    }\n\n    handle.addDoneCallback(() => {\n      this._markDoneIfNeeded(handle);\n    });\n  }\n\n  /**\n   * @internal\n   * Unwatch a handle.\n   */\n  _unwatchHandle(handle: SpeechHandle | Task<void>): void {\n    this.handles.delete(handle);\n\n    if (isSpeechHandle(handle)) {\n      handle._removeItemAddedCallback(this._itemAdded.bind(this));\n    }\n  }\n\n  private _markDoneIfNeeded(handle: SpeechHandle | Task<void>): void {\n    if (isSpeechHandle(handle)) {\n      this.lastSpeechHandle = handle;\n    }\n\n    if ([...this.handles].every((h) => (isSpeechHandle(h) ? h.done() : h.done))) {\n      this._markDone();\n    }\n  }\n\n  private _markDone(): void {\n    // TODO(brian): Implement final output support after AgentTask is implemented.\n    // See Python run_result.py _mark_done() for reference:\n    // - Check lastSpeechHandle._maybeRunFinalOutput\n    // - Validate output type matches expected type\n    // - Set exception or resolve based on output\n    if (!this.doneFut.done) {\n      this.doneFut.resolve();\n    }\n  }\n\n  /**\n   * Find the correct insertion index to maintain chronological order.\n   */\n  private _findInsertionIndex(createdAt: number): number {\n    for (let i = this._events.length - 1; i >= 0; i--) {\n      if (this._events[i]!.item.createdAt <= createdAt) {\n        return i + 1;\n      }\n    }\n    return 0;\n  }\n}\n\n/**\n * Assertion helper for verifying run events in sequence.\n */\nexport class RunAssert {\n  private _events: RunEvent[];\n  private _currentIndex = 0;\n\n  // TODO(brian): Add range access for parity with Python __getitem__ slice support.\n  // - Add range(start?, end?) method returning EventRangeAssert\n  // - EventRangeAssert should have containsFunctionCall(), containsMessage() methods\n  // See Python run_result.py lines 247-251 for reference.\n\n  constructor(runResult: RunResult) {\n    this._events = runResult.events;\n  }\n\n  /**\n   * Access a specific event by index for assertions.\n   * Supports negative indices (e.g., -1 for last event).\n   *\n   * @example\n   * ```typescript\n   * result.expect.at(0).isMessage({ role: 'user' });\n   * result.expect.at(-1).isMessage({ role: 'assistant' });\n   * ```\n   */\n  at(index: number): EventAssert {\n    let normalizedIndex = index;\n    if (index < 0) {\n      normalizedIndex = this._events.length + index;\n    }\n\n    if (normalizedIndex < 0 || normalizedIndex >= this._events.length) {\n      this._raiseWithDebugInfo(\n        `at(${index}) out of range (total events: ${this._events.length})`,\n        normalizedIndex,\n      );\n    }\n\n    return new EventAssert(this._events[normalizedIndex]!, this, normalizedIndex);\n  }\n\n  /**\n   * Advance to the next event, optionally filtering by type.\n   *\n   * @example\n   * ```typescript\n   * result.expect.nextEvent().isMessage({ role: 'assistant' });\n   * result.expect.nextEvent({ type: 'function_call' }).isFunctionCall({ name: 'foo' });\n   * ```\n   */\n  nextEvent(options?: { type?: EventType }): EventAssert {\n    while (true) {\n      const evAssert = this._currentEvent();\n      this._currentIndex++;\n\n      if (!options?.type || evAssert.event().type === options.type) {\n        return evAssert;\n      }\n    }\n  }\n\n  /**\n   * Skip a specified number of upcoming events without assertions.\n   *\n   * @example\n   * ```typescript\n   * result.expect.skipNext(2);\n   * ```\n   */\n  skipNext(count: number = 1): this {\n    for (let i = 0; i < count; i++) {\n      if (this._currentIndex >= this._events.length) {\n        this._raiseWithDebugInfo(`Tried to skip ${count} event(s), but only ${i} were available.`);\n      }\n      this._currentIndex++;\n    }\n    return this;\n  }\n\n  /**\n   * Assert that there are no further events.\n   *\n   * @example\n   * ```typescript\n   * result.expect.noMoreEvents();\n   * ```\n   */\n  noMoreEvents(): void {\n    if (this._currentIndex < this._events.length) {\n      const event = this._events[this._currentIndex]!;\n      this._raiseWithDebugInfo(`Expected no more events, but found: ${event.type}`);\n    }\n  }\n\n  private _currentEvent(): EventAssert {\n    if (this._currentIndex >= this._events.length) {\n      this._raiseWithDebugInfo('Expected another event, but none left.');\n    }\n    return this.at(this._currentIndex);\n  }\n\n  /** @internal */\n  _raiseWithDebugInfo(message: string, index?: number): never {\n    const markerIndex = index ?? this._currentIndex;\n    const eventsStr = formatEvents(this._events, markerIndex).join('\\n');\n    throw new AssertionError(`${message}\\nContext around failure:\\n${eventsStr}`);\n  }\n}\n\n/**\n * Assertion wrapper for a single event.\n */\nexport class EventAssert {\n  protected _event: RunEvent;\n  protected _parent: RunAssert;\n  protected _index: number;\n\n  constructor(event: RunEvent, parent: RunAssert, index: number) {\n    this._event = event;\n    this._parent = parent;\n    this._index = index;\n  }\n\n  /**\n   * Get the underlying event.\n   */\n  event(): RunEvent {\n    return this._event;\n  }\n\n  protected _raise(message: string): never {\n    this._parent._raiseWithDebugInfo(message, this._index);\n  }\n\n  /**\n   * Verify this event is a message with optional role matching.\n   *\n   * @example\n   * ```typescript\n   * result.expect.nextEvent().isMessage({ role: 'assistant' });\n   * ```\n   */\n  isMessage(options?: MessageAssertOptions): MessageAssert {\n    if (!isChatMessageEvent(this._event)) {\n      this._raise(`Expected ChatMessageEvent, got ${this._event.type}`);\n    }\n\n    if (options?.role && this._event.item.role !== options.role) {\n      this._raise(`Expected role '${options.role}', got '${this._event.item.role}'`);\n    }\n\n    return new MessageAssert(this._event, this._parent, this._index);\n  }\n\n  /**\n   * Verify this event is a function call with optional name/args matching.\n   *\n   * @example\n   * ```typescript\n   * result.expect.nextEvent().isFunctionCall({ name: 'order_item', args: { id: 'big_mac' } });\n   * ```\n   */\n  isFunctionCall(options?: FunctionCallAssertOptions): FunctionCallAssert {\n    if (!isFunctionCallEvent(this._event)) {\n      this._raise(`Expected FunctionCallEvent, got ${this._event.type}`);\n    }\n\n    if (options?.name && this._event.item.name !== options.name) {\n      this._raise(`Expected call name '${options.name}', got '${this._event.item.name}'`);\n    }\n\n    if (options?.args) {\n      let actual: Record<string, unknown>;\n      try {\n        actual = JSON.parse(this._event.item.args);\n      } catch {\n        this._raise(`Failed to parse function call arguments: ${this._event.item.args}`);\n      }\n\n      for (const [key, value] of Object.entries(options.args)) {\n        if (!(key in actual) || actual[key] !== value) {\n          this._raise(\n            `For key '${key}', expected ${JSON.stringify(value)}, got ${JSON.stringify(actual[key])}`,\n          );\n        }\n      }\n    }\n\n    return new FunctionCallAssert(this._event, this._parent, this._index);\n  }\n\n  /**\n   * Verify this event is a function call output with optional matching.\n   *\n   * @example\n   * ```typescript\n   * result.expect.nextEvent().isFunctionCallOutput({ isError: false });\n   * ```\n   */\n  isFunctionCallOutput(options?: FunctionCallOutputAssertOptions): FunctionCallOutputAssert {\n    if (!isFunctionCallOutputEvent(this._event)) {\n      this._raise(`Expected FunctionCallOutputEvent, got ${this._event.type}`);\n    }\n\n    if (options?.output !== undefined && this._event.item.output !== options.output) {\n      this._raise(`Expected output '${options.output}', got '${this._event.item.output}'`);\n    }\n\n    if (options?.isError !== undefined && this._event.item.isError !== options.isError) {\n      this._raise(`Expected isError=${options.isError}, got ${this._event.item.isError}`);\n    }\n\n    return new FunctionCallOutputAssert(this._event, this._parent, this._index);\n  }\n\n  /**\n   * Verify this event is an agent handoff with optional type matching.\n   *\n   * @example\n   * ```typescript\n   * result.expect.nextEvent().isAgentHandoff({ newAgentType: MyAgent });\n   * ```\n   */\n  isAgentHandoff(options?: AgentHandoffAssertOptions): AgentHandoffAssert {\n    if (!isAgentHandoffEvent(this._event)) {\n      this._raise(`Expected AgentHandoffEvent, got ${this._event.type}`);\n    }\n\n    // Cast to the correct type after validation\n    const event = this._event as AgentHandoffEvent;\n\n    if (options?.newAgentType) {\n      const actualType = event.newAgent.constructor.name;\n      if (!(event.newAgent instanceof options.newAgentType)) {\n        this._raise(`Expected new_agent '${options.newAgentType.name}', got '${actualType}'`);\n      }\n    }\n\n    return new AgentHandoffAssert(event, this._parent, this._index);\n  }\n}\n\n/**\n * Assertion wrapper for message events.\n */\nexport class MessageAssert extends EventAssert {\n  protected declare _event: ChatMessageEvent;\n\n  constructor(event: ChatMessageEvent, parent: RunAssert, index: number) {\n    super(event, parent, index);\n  }\n\n  override event(): ChatMessageEvent {\n    return this._event;\n  }\n\n  // Phase 3: judge() method will be added here\n}\n\n/**\n * Assertion wrapper for function call events.\n */\nexport class FunctionCallAssert extends EventAssert {\n  protected declare _event: FunctionCallEvent;\n\n  constructor(event: FunctionCallEvent, parent: RunAssert, index: number) {\n    super(event, parent, index);\n  }\n\n  override event(): FunctionCallEvent {\n    return this._event;\n  }\n}\n\n/**\n * Assertion wrapper for function call output events.\n */\nexport class FunctionCallOutputAssert extends EventAssert {\n  protected declare _event: FunctionCallOutputEvent;\n\n  constructor(event: FunctionCallOutputEvent, parent: RunAssert, index: number) {\n    super(event, parent, index);\n  }\n\n  override event(): FunctionCallOutputEvent {\n    return this._event;\n  }\n}\n\n/**\n * Assertion wrapper for agent handoff events.\n */\nexport class AgentHandoffAssert extends EventAssert {\n  protected declare _event: AgentHandoffEvent;\n\n  constructor(event: AgentHandoffEvent, parent: RunAssert, index: number) {\n    super(event, parent, index);\n  }\n\n  override event(): AgentHandoffEvent {\n    return this._event;\n  }\n}\n\n/**\n * Custom assertion error for test failures.\n */\nexport class AssertionError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'AssertionError';\n    Error.captureStackTrace?.(this, AssertionError);\n  }\n}\n\n/**\n * Format events for debug output, optionally marking a selected index.\n */\nfunction formatEvents(events: RunEvent[], selectedIndex?: number): string[] {\n  const lines: string[] = [];\n\n  for (let i = 0; i < events.length; i++) {\n    const event = events[i]!;\n    let prefix = '';\n    if (selectedIndex !== undefined) {\n      prefix = i === selectedIndex ? '>>>' : '   ';\n    }\n\n    let line: string;\n    if (isChatMessageEvent(event)) {\n      const { role, content, interrupted } = event.item;\n      const textContent =\n        typeof content === 'string'\n          ? content\n          : Array.isArray(content)\n            ? content.filter((c): c is string => typeof c === 'string').join(' ')\n            : '';\n      const truncated = textContent.length > 50 ? textContent.slice(0, 50) + '...' : textContent;\n      line = `${prefix}[${i}] { type: \"message\", role: \"${role}\", content: \"${truncated}\", interrupted: ${interrupted} }`;\n    } else if (isFunctionCallEvent(event)) {\n      const { name, args } = event.item;\n      line = `${prefix}[${i}] { type: \"function_call\", name: \"${name}\", args: ${args} }`;\n    } else if (isFunctionCallOutputEvent(event)) {\n      const { output, isError } = event.item;\n      const truncated = output.length > 50 ? output.slice(0, 50) + '...' : output;\n      line = `${prefix}[${i}] { type: \"function_call_output\", output: \"${truncated}\", isError: ${isError} }`;\n    } else if (isAgentHandoffEvent(event)) {\n      line = `${prefix}[${i}] { type: \"agent_handoff\", oldAgent: \"${event.oldAgent?.constructor.name}\", newAgent: \"${event.newAgent.constructor.name}\" }`;\n    } else {\n      line = `${prefix}[${i}] ${event}`;\n    }\n\n    lines.push(line);\n  }\n\n  return lines;\n}\n"],"mappings":"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","names":[]}

package/dist/voice/testing/types.cjs

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+__export(types_exports, {
+  isAgentHandoffEvent: () => isAgentHandoffEvent,
+  isChatMessageEvent: () => isChatMessageEvent,
+  isFunctionCallEvent: () => isFunctionCallEvent,
+  isFunctionCallOutputEvent: () => isFunctionCallOutputEvent
+});
+module.exports = __toCommonJS(types_exports);
+function isChatMessageEvent(event) {
+  return event.type === "message";
+}
+function isFunctionCallEvent(event) {
+  return event.type === "function_call";
+}
+function isFunctionCallOutputEvent(event) {
+  return event.type === "function_call_output";
+}
+function isAgentHandoffEvent(event) {
+  return event.type === "agent_handoff";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isAgentHandoffEvent,
+  isChatMessageEvent,
+  isFunctionCallEvent,
+  isFunctionCallOutputEvent
+});
+//# sourceMappingURL=types.cjs.map

package/dist/voice/testing/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/testing/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  AgentHandoffItem,\n  ChatMessage,\n  ChatRole,\n  FunctionCall,\n  FunctionCallOutput,\n} from '../../llm/chat_context.js';\nimport type { Agent } from '../agent.js';\n\n/**\n * Event representing an assistant or user message in the conversation.\n */\nexport interface ChatMessageEvent {\n  type: 'message';\n  item: ChatMessage;\n}\n\n/**\n * Event representing a function/tool call initiated by the LLM.\n */\nexport interface FunctionCallEvent {\n  type: 'function_call';\n  item: FunctionCall;\n}\n\n/**\n * Event representing the output/result of a function call.\n */\nexport interface FunctionCallOutputEvent {\n  type: 'function_call_output';\n  item: FunctionCallOutput;\n}\n\n/**\n * Event representing an agent handoff (switching from one agent to another).\n */\nexport interface AgentHandoffEvent {\n  type: 'agent_handoff';\n  item: AgentHandoffItem;\n  oldAgent?: Agent;\n  newAgent: Agent;\n}\n\n/**\n * Union type of all possible run events that can occur during a test run.\n */\nexport type RunEvent =\n  | ChatMessageEvent\n  | FunctionCallEvent\n  | FunctionCallOutputEvent\n  | AgentHandoffEvent;\n\n/**\n * Type guard to check if an event is a ChatMessageEvent.\n */\nexport function isChatMessageEvent(event: RunEvent): event is ChatMessageEvent {\n  return event.type === 'message';\n}\n\n/**\n * Type guard to check if an event is a FunctionCallEvent.\n */\nexport function isFunctionCallEvent(event: RunEvent): event is FunctionCallEvent {\n  return event.type === 'function_call';\n}\n\n/**\n * Type guard to check if an event is a FunctionCallOutputEvent.\n */\nexport function isFunctionCallOutputEvent(event: RunEvent): event is FunctionCallOutputEvent {\n  return event.type === 'function_call_output';\n}\n\n/**\n * Type guard to check if an event is an AgentHandoffEvent.\n */\nexport function isAgentHandoffEvent(event: RunEvent): event is AgentHandoffEvent {\n  return event.type === 'agent_handoff';\n}\n\n/**\n * Options for message assertion.\n */\nexport interface MessageAssertOptions {\n  role?: ChatRole;\n}\n\n/**\n * Options for function call assertion.\n */\nexport interface FunctionCallAssertOptions {\n  name?: string;\n  args?: Record<string, unknown>;\n}\n\n/**\n * Options for function call output assertion.\n */\nexport interface FunctionCallOutputAssertOptions {\n  output?: string;\n  isError?: boolean;\n}\n\n/**\n * Options for agent handoff assertion.\n */\nexport interface AgentHandoffAssertOptions {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  newAgentType?: new (...args: any[]) => Agent;\n}\n\n/**\n * Event type literals for type-safe event filtering.\n */\nexport type EventType = 'message' | 'function_call' | 'function_call_output' | 'agent_handoff';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0DO,SAAS,mBAAmB,OAA4C;AAC7E,SAAO,MAAM,SAAS;AACxB;AAKO,SAAS,oBAAoB,OAA6C;AAC/E,SAAO,MAAM,SAAS;AACxB;AAKO,SAAS,0BAA0B,OAAmD;AAC3F,SAAO,MAAM,SAAS;AACxB;AAKO,SAAS,oBAAoB,OAA6C;AAC/E,SAAO,MAAM,SAAS;AACxB;","names":[]}

package/dist/voice/testing/types.d.cts

@@ -0,0 +1,83 @@
+import type { AgentHandoffItem, ChatMessage, ChatRole, FunctionCall, FunctionCallOutput } from '../../llm/chat_context.js';
+import type { Agent } from '../agent.js';
+/**
+ * Event representing an assistant or user message in the conversation.
+ */
+export interface ChatMessageEvent {
+    type: 'message';
+    item: ChatMessage;
+}
+/**
+ * Event representing a function/tool call initiated by the LLM.
+ */
+export interface FunctionCallEvent {
+    type: 'function_call';
+    item: FunctionCall;
+}
+/**
+ * Event representing the output/result of a function call.
+ */
+export interface FunctionCallOutputEvent {
+    type: 'function_call_output';
+    item: FunctionCallOutput;
+}
+/**
+ * Event representing an agent handoff (switching from one agent to another).
+ */
+export interface AgentHandoffEvent {
+    type: 'agent_handoff';
+    item: AgentHandoffItem;
+    oldAgent?: Agent;
+    newAgent: Agent;
+}
+/**
+ * Union type of all possible run events that can occur during a test run.
+ */
+export type RunEvent = ChatMessageEvent | FunctionCallEvent | FunctionCallOutputEvent | AgentHandoffEvent;
+/**
+ * Type guard to check if an event is a ChatMessageEvent.
+ */
+export declare function isChatMessageEvent(event: RunEvent): event is ChatMessageEvent;
+/**
+ * Type guard to check if an event is a FunctionCallEvent.
+ */
+export declare function isFunctionCallEvent(event: RunEvent): event is FunctionCallEvent;
+/**
+ * Type guard to check if an event is a FunctionCallOutputEvent.
+ */
+export declare function isFunctionCallOutputEvent(event: RunEvent): event is FunctionCallOutputEvent;
+/**
+ * Type guard to check if an event is an AgentHandoffEvent.
+ */
+export declare function isAgentHandoffEvent(event: RunEvent): event is AgentHandoffEvent;
+/**
+ * Options for message assertion.
+ */
+export interface MessageAssertOptions {
+    role?: ChatRole;
+}
+/**
+ * Options for function call assertion.
+ */
+export interface FunctionCallAssertOptions {
+    name?: string;
+    args?: Record<string, unknown>;
+}
+/**
+ * Options for function call output assertion.
+ */
+export interface FunctionCallOutputAssertOptions {
+    output?: string;
+    isError?: boolean;
+}
+/**
+ * Options for agent handoff assertion.
+ */
+export interface AgentHandoffAssertOptions {
+    newAgentType?: new (...args: any[]) => Agent;
+}
+/**
+ * Event type literals for type-safe event filtering.
+ */
+export type EventType = 'message' | 'function_call' | 'function_call_output' | 'agent_handoff';
+//# sourceMappingURL=types.d.ts.map