@proj-airi/trace-kit 0.0.0-stage → 0.15.3

package/dist/testing/index.d.mts

@@ -0,0 +1,79 @@
+import { V as TraceRecordInput, x as TraceProfileDefinition, z as TraceRecord } from "../clock-CewQJzn8.mjs";
+import { b as TraceReader, p as TimelineState } from "../types-Fp54Yi6b.mjs";
+//#region src/testing/voice-turn.d.ts
+/**
+ * A real recording: the level and the VAD probability of each 32 ms detector window of 5.3 s of speech.
+ *
+ * The values come from the AIRI Silero VAD model and `levelOf` of stage-ui, run on
+ * `cases/long-leading-silence/input.test.wav` of `@proj-airi/testing-audio`. The probability is near 0 in silence,
+ * jumps to near 1 within one or two windows, and dips between words. The speech starts at 884 ms.
+ */
+declare const LONG_LEADING_SILENCE: {
+  intervalMs: number;
+  times: number[];
+  level: number[];
+  probability: number[];
+};
+/** The trace clock times of the voice turn of {@link voiceTurnRecords}, in milliseconds. */
+declare const VOICE_TURN: {
+  readonly inputStart: 200;
+  readonly speechStart: 1084;
+  readonly inputEnd: 5500;
+  readonly playbackStart: 7000;
+  readonly playbackEnd: 10000;
+  /** A second model request starts here and stays open. */
+  readonly openRequestStart: 10200;
+  readonly end: 12000;
+};
+/**
+ * Records of one voice turn, for tests and stories of trace views. The trace has every kind of item that the IO
+ * tracer draws:
+ *
+ * - A voice input with the level and the VAD probability of {@link LONG_LEADING_SILENCE}, and two speech segments.
+ * - A failed speech recognition and its retry.
+ * - A chat turn, a model request with tokens and a first chunk, and a labelled tool call.
+ * - A speech output, a TTS request, and a playback with a level series.
+ * - Participant states, floor instants, and a model request that is still open at the end.
+ */
+declare function voiceTurnRecords(): TraceRecordInput[];
+//#endregion
+//#region src/testing/index.d.ts
+/**
+ * Helpers for tests and stories that need trace records. Production code must not import this module.
+ */
+interface RecordStamperOptions {
+  /** @default 'window:main' */
+  source?: string;
+  /** @default 'e1' */
+  epoch?: string;
+  /** The clock of an input without its own clock. @default 'mono:collector' */
+  clock?: string;
+}
+/**
+ * Returns a function that completes record inputs as the records of one source epoch, with `seq` from 0.
+ *
+ * @example
+ * const stamp = createRecordStamper({ source: 'tab:a' })
+ * stamp({ type: 'span.begin', ts: 0, track: 'agents/agent/llm', spanId: 's', name: 'chat' })
+ * // => { clock: 'mono:collector', type: 'span.begin', ..., source: 'tab:a', epoch: 'e1', seq: 0 }
+ */
+declare function createRecordStamper(options?: RecordStamperOptions): (input: TraceRecordInput) => TraceRecord;
+interface ReadTimelineOptions extends RecordStamperOptions {
+  /** Profiles whose definitions come before the inputs, so tracks have their definitions. @default [] */
+  profiles?: TraceProfileDefinition[];
+}
+/**
+ * Reads record inputs into the timeline state that a viewer sees, with the definitions of `profiles` first.
+ *
+ * @example
+ * const { state } = readTimeline([{ type: 'span.begin', ts: 0, track: 'agents/agent/llm', spanId: 's', name: 'chat' }], { profiles: [agentProfile] })
+ * state.spans.size
+ * // => 1
+ */
+declare function readTimeline(inputs: TraceRecordInput[], options?: ReadTimelineOptions): {
+  state: TimelineState;
+  indexes: TraceReader['indexes'];
+  records: TraceRecord[];
+};
+//#endregion
+export { LONG_LEADING_SILENCE, ReadTimelineOptions, RecordStamperOptions, VOICE_TURN, createRecordStamper, readTimeline, voiceTurnRecords };