xo-harness 0.2.0 → 0.3.0

package/dist/internal/protocol/records.d.ts

@@ -0,0 +1,773 @@
+import { z } from "zod";
+import { type HarnessEvent } from "./events.js";
+/** Retention affects stored audio, never live capture or playback. */
+export type AudioRetention = "full" | "metadata";
+/** Same identities and order as live events; audio bytes may be explicitly unavailable. */
+export declare const HarnessRecordSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"session.started">;
+    formatVersion: z.ZodOptional<z.ZodInt>;
+    providerId: z.ZodString;
+    capabilities: z.ZodObject<{
+        continuousInputDuringOutput: z.ZodBoolean;
+        modelManagedFloor: z.ZodBoolean;
+        supportsToolCalls: z.ZodBoolean;
+        supportsAsyncContext: z.ZodBoolean;
+        supportsToolStatusContext: z.ZodOptional<z.ZodBoolean>;
+        supportsPlayoutAcknowledgements: z.ZodBoolean;
+        reportsResponseState: z.ZodOptional<z.ZodBoolean>;
+        inputCadence: z.ZodOptional<z.ZodEnum<{
+            continuous: "continuous";
+            "on-demand": "on-demand";
+        }>>;
+        outputLifecycle: z.ZodOptional<z.ZodEnum<{
+            continuous: "continuous";
+            response: "response";
+        }>>;
+        supportsAssistantTurn: z.ZodOptional<z.ZodBoolean>;
+        supportsTextOutput: z.ZodOptional<z.ZodBoolean>;
+        textInput: z.ZodOptional<z.ZodEnum<{
+            backend: "backend";
+            conversation: "conversation";
+            unsupported: "unsupported";
+        }>>;
+        maxContextUpdateBytes: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strip>;
+    instructions: z.ZodOptional<z.ZodString>;
+    outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        audio: "audio";
+        text: "text";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"session.ended">;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"provider.ready">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"response.state">;
+    state: z.ZodEnum<{
+        idle: "idle";
+        pending: "pending";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"provider.diagnostic">;
+    diagnostic: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"session">;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"speech">;
+        phase: z.ZodEnum<{
+            started: "started";
+            stopped: "stopped";
+        }>;
+        streamId: z.ZodOptional<z.ZodString>;
+        audioOffsetMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"response">;
+        phase: z.ZodEnum<{
+            completed: "completed";
+            started: "started";
+        }>;
+        responseId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        code: z.ZodOptional<z.ZodString>;
+        outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            streamId: z.ZodOptional<z.ZodString>;
+            type: z.ZodString;
+            contentTypes: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"assistant.turn.requested">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"provider.closed">;
+    reason: z.ZodString;
+    finalized: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"provider.error">;
+    message: z.ZodString;
+    recoverable: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"message.input">;
+    text: z.ZodString;
+    parts: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        mediaType: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        mediaType: z.ZodString;
+        url: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"input.delivery">;
+    inputId: z.ZodString;
+    providerId: z.ZodString;
+    target: z.ZodEnum<{
+        backend: "backend";
+        conversation: "conversation";
+    }>;
+    phase: z.ZodEnum<{
+        failed: "failed";
+        submitted: "submitted";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"audio.input">;
+    chunk: z.ZodObject<{
+        streamId: z.ZodString;
+        sequence: z.ZodInt;
+        encoding: z.ZodLiteral<"pcm_s16le">;
+        sampleRate: z.ZodInt;
+        channels: z.ZodInt;
+        startSample: z.ZodInt;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+    }, z.core.$strict>;
+    syntheticSilence: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"audio.output">;
+    chunk: z.ZodObject<{
+        streamId: z.ZodString;
+        sequence: z.ZodInt;
+        encoding: z.ZodLiteral<"pcm_s16le">;
+        sampleRate: z.ZodInt;
+        channels: z.ZodInt;
+        startSample: z.ZodInt;
+        data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+    }, z.core.$strict>;
+    source: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<{
+            backend: "backend";
+            voice: "voice";
+        }>;
+        responseId: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodString>;
+        outputIndex: z.ZodOptional<z.ZodInt>;
+        contentIndex: z.ZodOptional<z.ZodInt>;
+        summaryIndex: z.ZodOptional<z.ZodInt>;
+        delegationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"audio.interrupted">;
+    streamId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    text: z.ZodString;
+    streamId: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<{
+            backend: "backend";
+            voice: "voice";
+        }>;
+        responseId: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodString>;
+        outputIndex: z.ZodOptional<z.ZodInt>;
+        contentIndex: z.ZodOptional<z.ZodInt>;
+        summaryIndex: z.ZodOptional<z.ZodInt>;
+        delegationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"transcript">;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    delta: z.ZodString;
+    streamId: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<{
+            backend: "backend";
+            voice: "voice";
+        }>;
+        responseId: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodString>;
+        outputIndex: z.ZodOptional<z.ZodInt>;
+        contentIndex: z.ZodOptional<z.ZodInt>;
+        summaryIndex: z.ZodOptional<z.ZodInt>;
+        delegationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"transcript.delta">;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    text: z.ZodString;
+    fragmentId: z.ZodString;
+    startMs: z.ZodNumber;
+    endMs: z.ZodNumber;
+    timebase: z.ZodLiteral<"provider-session">;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"transcript.fragment">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        reasoning_summary: "reasoning_summary";
+        refusal: "refusal";
+        text: "text";
+    }>;
+    source: z.ZodObject<{
+        delegationId: z.ZodOptional<z.ZodString>;
+        scope: z.ZodLiteral<"backend">;
+        responseId: z.ZodString;
+        itemId: z.ZodString;
+        outputIndex: z.ZodInt;
+        contentIndex: z.ZodOptional<z.ZodInt>;
+        summaryIndex: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strip>;
+    delta: z.ZodString;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"backend.output.delta">;
+}, z.core.$strip>, z.ZodObject<{
+    source: z.ZodObject<{
+        delegationId: z.ZodOptional<z.ZodString>;
+        scope: z.ZodLiteral<"backend">;
+        responseId: z.ZodString;
+        itemId: z.ZodString;
+        outputIndex: z.ZodInt;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodEnum<{
+            refusal: "refusal";
+            text: "text";
+        }>;
+        text: z.ZodString;
+        contentIndex: z.ZodInt;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"reasoning_summary">;
+        text: z.ZodString;
+        summaryIndex: z.ZodInt;
+    }, z.core.$strip>], "kind">>;
+    status: z.ZodOptional<z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        in_progress: "in_progress";
+        incomplete: "incomplete";
+    }>>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"backend.output">;
+}, z.core.$strip>, z.ZodObject<{
+    delegationId: z.ZodOptional<z.ZodString>;
+    responseId: z.ZodString;
+    phase: z.ZodEnum<{
+        completed: "completed";
+        started: "started";
+        "waiting-for-tools": "waiting-for-tools";
+    }>;
+    status: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"backend.response">;
+}, z.core.$strip>, z.ZodObject<{
+    delegationId: z.ZodOptional<z.ZodString>;
+    responseId: z.ZodString;
+    toolId: z.ZodString;
+    outputIndex: z.ZodOptional<z.ZodInt>;
+    name: z.ZodString;
+    phase: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        started: "started";
+    }>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"backend.tool">;
+}, z.core.$strip>, z.ZodObject<{
+    delegationId: z.ZodString;
+    target: z.ZodEnum<{
+        client: "client";
+        responses: "responses";
+    }>;
+    offsetMs: z.ZodNumber;
+    responseId: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"delegation.created">;
+}, z.core.$strip>, z.ZodObject<{
+    contextId: z.ZodString;
+    callId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    phase: z.ZodEnum<{
+        acknowledged: "acknowledged";
+        failed: "failed";
+        submitted: "submitted";
+    }>;
+    kind: z.ZodEnum<{
+        commentary: "commentary";
+        instructions: "instructions";
+        thinking: "thinking";
+    }>;
+    startMs: z.ZodOptional<z.ZodNumber>;
+    endMs: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"context.delivery">;
+}, z.core.$strip>, z.ZodObject<{
+    seconds: z.ZodNumber;
+    final: z.ZodBoolean;
+    contextWindowUsageRatio: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"usage.duration">;
+}, z.core.$strip>, z.ZodObject<{
+    streamId: z.ZodString;
+    startSample: z.ZodInt;
+    endSample: z.ZodInt;
+    status: z.ZodEnum<{
+        discarded: "discarded";
+        played: "played";
+    }>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"playout.range">;
+}, z.core.$strip>, z.ZodObject<{
+    responseId: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        backend: "backend";
+        voice: "voice";
+    }>>;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+    cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+    audioInputTokens: z.ZodOptional<z.ZodNumber>;
+    audioOutputTokens: z.ZodOptional<z.ZodNumber>;
+    cachedAudioInputTokens: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"usage">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"playout.progress">;
+    streamId: z.ZodString;
+    playedThroughSample: z.ZodInt;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.requested">;
+    call: z.ZodObject<{
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        source: z.ZodOptional<z.ZodObject<{
+            scope: z.ZodEnum<{
+                backend: "backend";
+                voice: "voice";
+            }>;
+            responseId: z.ZodOptional<z.ZodString>;
+            itemId: z.ZodOptional<z.ZodString>;
+            outputIndex: z.ZodOptional<z.ZodInt>;
+            contentIndex: z.ZodOptional<z.ZodInt>;
+            summaryIndex: z.ZodOptional<z.ZodInt>;
+            delegationId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.denied">;
+    callId: z.ZodString;
+    name: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.started">;
+    callId: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.progress">;
+    callId: z.ZodString;
+    update: z.ZodJSONSchema;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.completed">;
+    callId: z.ZodString;
+    outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"completed">;
+        value: z.ZodJSONSchema;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"accepted_task">;
+        taskId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"failed">;
+        error: z.ZodString;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.failed">;
+    callId: z.ZodString;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool.delivery_failed">;
+    callId: z.ZodString;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.accepted">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.cancellation_requested">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.progress">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+    update: z.ZodJSONSchema;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.completed">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+    result: z.ZodJSONSchema;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.failed">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.cancelled">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"task.delivery_failed">;
+    taskId: z.ZodString;
+    callId: z.ZodString;
+    phase: z.ZodEnum<{
+        progress: "progress";
+        terminal: "terminal";
+    }>;
+    error: z.ZodString;
+}, z.core.$strip>], "type">, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"audio.input">;
+    syntheticSilence: z.ZodOptional<z.ZodBoolean>;
+    chunk: z.ZodObject<{
+        streamId: z.ZodString;
+        sequence: z.ZodInt;
+        encoding: z.ZodLiteral<"pcm_s16le">;
+        sampleRate: z.ZodInt;
+        channels: z.ZodInt;
+        startSample: z.ZodInt;
+        sampleCount: z.ZodInt;
+        availability: z.ZodLiteral<"omitted">;
+        data: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodInt;
+    recordedAtMs: z.ZodNumber;
+    sessionTimeMs: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    causationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"audio.output">;
+    source: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<{
+            backend: "backend";
+            voice: "voice";
+        }>;
+        responseId: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodString>;
+        outputIndex: z.ZodOptional<z.ZodInt>;
+        contentIndex: z.ZodOptional<z.ZodInt>;
+        summaryIndex: z.ZodOptional<z.ZodInt>;
+        delegationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    chunk: z.ZodObject<{
+        streamId: z.ZodString;
+        sequence: z.ZodInt;
+        encoding: z.ZodLiteral<"pcm_s16le">;
+        sampleRate: z.ZodInt;
+        channels: z.ZodInt;
+        startSample: z.ZodInt;
+        sampleCount: z.ZodInt;
+        availability: z.ZodLiteral<"omitted">;
+        data: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>;
+}, z.core.$strip>]>;
+export type HarnessRecord = z.infer<typeof HarnessRecordSchema>;
+/** Does not mutate the source. Non-audio records are shared; callers own snapshot isolation. */
+export declare function toHarnessRecord(event: HarnessRecord, retention: AudioRetention): HarnessRecord;
+export declare class AudioUnavailableError extends Error {
+    readonly sessionId: string;
+    readonly sequence: number;
+    readonly code = "audio_unavailable";
+    constructor(sessionId: string, sequence: number);
+}
+/** Explicit boundary for operations that require the original PCM, such as provider replay. */
+export declare function requireRecordedAudio(record: HarnessRecord): HarnessEvent;
+export declare function requireRecordedAudioHistory(records: readonly HarnessRecord[]): HarnessEvent[];
+export declare function stringifyHarnessRecord(record: HarnessRecord): string;
+/** Reads both legacy full-audio JSONL and records with explicitly omitted audio. */
+export declare function parseHarnessRecord(serialized: string): HarnessRecord;