@pinecall/protocol 0.1.0

package/dist/generated/events.d.ts

@@ -0,0 +1,1234 @@
+import { z } from "zod";
+/**
+ * The gateway applied an agent.configure. Live calls keep their session; the next call starts with
+ * the new config.
+ */
+export declare const AgentConfiguredSchema: z.ZodObject<{
+    changed: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type AgentConfigured = z.infer<typeof AgentConfiguredSchema>;
+/** One socket stopped holding the agent. */
+export declare const AgentDetachedSchema: z.ZodObject<{
+    app: z.ZodString;
+    env: z.ZodEnum<{
+        production: "production";
+        sandbox: "sandbox";
+    }>;
+    left: z.ZodBoolean;
+}, z.core.$strict>;
+export type AgentDetached = z.infer<typeof AgentDetachedSchema>;
+/**
+ * The gateway accepted an agent.register: this socket now speaks for the agent and answers its
+ * routes. Many sockets may hold one agent at once — a new call takes the newest of them, unless
+ * the caller names one by its `app` id.
+ */
+export declare const AgentRegisteredSchema: z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        channel: z.ZodEnum<{
+            phone: "phone";
+            web: "web";
+            whatsapp: "whatsapp";
+        }>;
+        number: z.ZodNullable<z.ZodString>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    app: z.ZodString;
+    sdk: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    env: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        production: "production";
+        sandbox: "sandbox";
+    }>>>;
+}, z.core.$strict>;
+export type AgentRegistered = z.infer<typeof AgentRegisteredSchema>;
+/** The agent's state changed, in the session's own words. */
+export declare const AgentStateChangedSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        listening: "listening";
+        speaking: "speaking";
+        initializing: "initializing";
+        idle: "idle";
+        thinking: "thinking";
+    }>;
+}, z.core.$strict>;
+export type AgentStateChanged = z.infer<typeof AgentStateChangedSchema>;
+/**
+ * Words from the agent as they are played, synced to the audio. Interim while final is false; the
+ * whole reply becomes turn.agent. Interim entries are ephemeral.
+ */
+export declare const AgentTranscriptSchema: z.ZodObject<{
+    speech_id: z.ZodString;
+    text: z.ZodString;
+    final: z.ZodBoolean;
+    start: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    end: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type AgentTranscript = z.infer<typeof AgentTranscriptSchema>;
+/**
+ * The platform is placing an outbound call and the far end has not answered yet. The first entry
+ * of an outbound call's log.
+ */
+export declare const CallDialingSchema: z.ZodObject<{
+    channel: z.ZodEnum<{
+        phone: "phone";
+        web: "web";
+        whatsapp: "whatsapp";
+    }>;
+    from: z.ZodString;
+    to: z.ZodString;
+    run: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+    caller: z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CallDialing = z.infer<typeof CallDialingSchema>;
+/** The call is over. Nothing about the conversation follows; call.summary still does. */
+export declare const CallEndedSchema: z.ZodObject<{
+    reason: z.ZodEnum<{
+        caller_hung_up: "caller_hung_up";
+        agent_hung_up: "agent_hung_up";
+        supervisor_ended: "supervisor_ended";
+        transferred: "transferred";
+        no_answer: "no_answer";
+        busy: "busy";
+        dial_failed: "dial_failed";
+        timeout: "timeout";
+        drained: "drained";
+        app_detached: "app_detached";
+        error: "error";
+    }>;
+    ended_by: z.ZodEnum<{
+        agent: "agent";
+        caller: "caller";
+        supervisor: "supervisor";
+        platform: "platform";
+    }>;
+    ended_at: z.ZodNumber;
+    duration_s: z.ZodNumber;
+}, z.core.$strict>;
+export type CallEnded = z.infer<typeof CallEndedSchema>;
+/**
+ * The line's hold and mute flags after one of them changed. Both are stated so a reader never has
+ * to remember the other.
+ */
+export declare const CallLineSchema: z.ZodObject<{
+    held: z.ZodBoolean;
+    muted: z.ZodBoolean;
+}, z.core.$strict>;
+export type CallLine = z.infer<typeof CallLineSchema>;
+/**
+ * An inbound call is offered to this agent and has not been answered yet. The first entry of an
+ * inbound call's log.
+ */
+export declare const CallRingingSchema: z.ZodObject<{
+    channel: z.ZodEnum<{
+        phone: "phone";
+        web: "web";
+        whatsapp: "whatsapp";
+    }>;
+    from: z.ZodString;
+    to: z.ZodString;
+    route: z.ZodObject<{
+        channel: z.ZodEnum<{
+            phone: "phone";
+            web: "web";
+            whatsapp: "whatsapp";
+        }>;
+        number: z.ZodNullable<z.ZodString>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    run: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+    caller: z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CallRinging = z.infer<typeof CallRingingSchema>;
+/**
+ * Where in the call's own log a judgment is about. A reader who disagrees with a verdict opens the
+ * log at those lines.
+ */
+export declare const JudgmentEvidenceSchema: z.ZodObject<{
+    seqs: z.ZodArray<z.ZodInt>;
+    said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type JudgmentEvidence = z.infer<typeof JudgmentEvidenceSchema>;
+/**
+ * One judge's answer about one call: the question it was asked, the word it answered and the
+ * sentence that says why.
+ */
+export declare const JudgmentSchema: z.ZodObject<{
+    name: z.ZodString;
+    verdict: z.ZodEnum<{
+        held: "held";
+        broken: "broken";
+        deferred: "deferred";
+        skipped: "skipped";
+    }>;
+    criteria: z.ZodString;
+    reason: z.ZodString;
+    evidence: z.ZodObject<{
+        seqs: z.ZodArray<z.ZodInt>;
+        said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type Judgment = z.infer<typeof JudgmentSchema>;
+/**
+ * The last entry of a call: what the judges said about it at hang-up, one row per judge. Written
+ * after call.summary, and the entry the log seals on.
+ */
+export declare const CallScoreSchema: z.ZodObject<{
+    passed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    not_judged: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    judges: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        verdict: z.ZodEnum<{
+            held: "held";
+            broken: "broken";
+            deferred: "deferred";
+            skipped: "skipped";
+        }>;
+        criteria: z.ZodString;
+        reason: z.ZodString;
+        evidence: z.ZodObject<{
+            seqs: z.ZodArray<z.ZodInt>;
+            said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    panel: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    judge_calls: z.ZodInt;
+    judge_cost_eur: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type CallScore = z.infer<typeof CallScoreSchema>;
+/**
+ * Media is up: the caller and the agent can hear each other, or the text session is open.
+ * Everything the agent says and hears comes after this.
+ */
+export declare const CallStartedSchema: z.ZodObject<{
+    channel: z.ZodEnum<{
+        phone: "phone";
+        web: "web";
+        whatsapp: "whatsapp";
+    }>;
+    direction: z.ZodEnum<{
+        inbound: "inbound";
+        outbound: "outbound";
+    }>;
+    from: z.ZodString;
+    to: z.ZodString;
+    run: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+    caller: z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    started_at: z.ZodNumber;
+    env: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        production: "production";
+        sandbox: "sandbox";
+    }>>>;
+}, z.core.$strict>;
+export type CallStarted = z.infer<typeof CallStartedSchema>;
+/**
+ * What the call was about, how it went, what it consumed and what that cost. Written after
+ * call.ended, once memory and pricing are done; call.score follows it and seals the log.
+ */
+export declare const CallSummarySchema: z.ZodObject<{
+    reason: z.ZodEnum<{
+        caller_hung_up: "caller_hung_up";
+        agent_hung_up: "agent_hung_up";
+        supervisor_ended: "supervisor_ended";
+        transferred: "transferred";
+        no_answer: "no_answer";
+        busy: "busy";
+        dial_failed: "dial_failed";
+        timeout: "timeout";
+        drained: "drained";
+        app_detached: "app_detached";
+        error: "error";
+    }>;
+    outcome: z.ZodString;
+    duration_s: z.ZodNumber;
+    turns: z.ZodInt;
+    usage: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"llm_usage">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_cached_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_cache_creation_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_cached_audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_cached_text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        input_cached_image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        output_audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        output_text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        output_reasoning_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        session_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"tts_usage">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        characters_count: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        audio_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"stt_usage">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        audio_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"interruption_usage">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        total_requests: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"eot_usage">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        total_requests: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    }, z.core.$strict>], "type">>;
+    cost: z.ZodObject<{
+        eur: z.ZodNumber;
+        rate: z.ZodObject<{
+            currency: z.ZodLiteral<"EUR">;
+            usd_to_eur: z.ZodNumber;
+            as_of: z.ZodString;
+        }, z.core.$strict>;
+        rows: z.ZodArray<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            unit: z.ZodEnum<{
+                input_tokens: "input_tokens";
+                cached_input_tokens: "cached_input_tokens";
+                cache_creation_tokens: "cache_creation_tokens";
+                output_tokens: "output_tokens";
+                characters: "characters";
+                audio_seconds: "audio_seconds";
+                requests: "requests";
+                session_seconds: "session_seconds";
+            }>;
+            quantity: z.ZodNumber;
+            unit_price_usd: z.ZodNumber;
+            eur: z.ZodNumber;
+        }, z.core.$strict>>;
+        unpriced: z.ZodArray<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    recording: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CallSummary = z.infer<typeof CallSummarySchema>;
+/** A transfer asked for by the agent or a supervisor finished, one way or the other. */
+export declare const CallTransferredSchema: z.ZodObject<{
+    to: z.ZodString;
+    mode: z.ZodEnum<{
+        cold: "cold";
+        warm: "warm";
+    }>;
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CallTransferred = z.infer<typeof CallTransferredSchema>;
+/**
+ * Somebody asked to be called back because no seat was free: a phone caller the overflow agent
+ * answered, or a web visitor who left a number at the widget. Written into the agent's own log;
+ * the tenant's app reads it and places the call.
+ */
+export declare const CallbackRequestedSchema: z.ZodObject<{
+    channel: z.ZodEnum<{
+        phone: "phone";
+        web: "web";
+        whatsapp: "whatsapp";
+    }>;
+    number: z.ZodString;
+    via: z.ZodEnum<{
+        overflow: "overflow";
+        widget: "widget";
+    }>;
+    call: z.ZodNullable<z.ZodString>;
+    contact: z.ZodNullable<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CallbackRequested = z.infer<typeof CallbackRequestedSchema>;
+/** The caller did not say yes, or the request lapsed. The tool does not run; the model is told. */
+export declare const ConfirmDeclinedSchema: z.ZodObject<{
+    tool: z.ZodString;
+    call_id: z.ZodString;
+    audience: z.ZodString;
+    said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reason: z.ZodEnum<{
+        timeout: "timeout";
+        changed: "changed";
+        cancelled: "cancelled";
+        no: "no";
+    }>;
+}, z.core.$strict>;
+export type ConfirmDeclined = z.infer<typeof ConfirmDeclinedSchema>;
+/**
+ * The caller said yes. The platform minted a one-shot token bound to the audience and the tool now
+ * runs. The token itself never enters the log.
+ */
+export declare const ConfirmGrantedSchema: z.ZodObject<{
+    tool: z.ZodString;
+    call_id: z.ZodString;
+    audience: z.ZodString;
+    said: z.ZodString;
+    ttl_s: z.ZodInt;
+}, z.core.$strict>;
+export type ConfirmGranted = z.infer<typeof ConfirmGrantedSchema>;
+/**
+ * A tool with confirm set is about to run and the platform is asking the caller. The agent reads
+ * the phrase; nothing runs until confirm.granted.
+ */
+export declare const ConfirmRequestSchema: z.ZodObject<{
+    tool: z.ZodString;
+    call_id: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    audience: z.ZodString;
+    phrase: z.ZodString;
+    ttl_s: z.ZodInt;
+}, z.core.$strict>;
+export type ConfirmRequest = z.infer<typeof ConfirmRequestSchema>;
+/**
+ * The gateway refused a call or a register because one of the org's quotas ran out. Written into
+ * the agent's own log, which is the org's, before the door says no.
+ */
+export declare const CreditsExhaustedSchema: z.ZodObject<{
+    org: z.ZodString;
+    quota: z.ZodEnum<{
+        minutes: "minutes";
+        messages: "messages";
+        agents: "agents";
+        concurrent_calls: "concurrent_calls";
+        memory_facts: "memory_facts";
+        knowledge_chunks: "knowledge_chunks";
+        numbers: "numbers";
+        seats: "seats";
+    }>;
+    used: z.ZodNumber;
+    limit: z.ZodInt;
+}, z.core.$strict>;
+export type CreditsExhausted = z.infer<typeof CreditsExhaustedSchema>;
+/**
+ * A line the app wrote into the log with call.log. The platform never reads it; the console shows
+ * it and evals may.
+ */
+export declare const CustomSchema: z.ZodObject<{
+    name: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type Custom = z.infer<typeof CustomSchema>;
+/** One ask of the process in the agent's directory, on a console's behalf. */
+export declare const DevRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    verb: z.ZodEnum<{
+        "chat.roster": "chat.roster";
+        "chat.start": "chat.start";
+        "chat.say": "chat.say";
+        "chat.end": "chat.end";
+        "simulate.roster": "simulate.roster";
+        "simulate.start": "simulate.start";
+        "goldens.roster": "goldens.roster";
+        "goldens.run": "goldens.run";
+        "knowledge.roster": "knowledge.roster";
+        "knowledge.push": "knowledge.push";
+        "knowledge.eval": "knowledge.eval";
+        "memory.roster": "memory.roster";
+        "memory.eval": "memory.eval";
+        "memory.extraction": "memory.extraction";
+        "promote.roster": "promote.roster";
+        "promote.write": "promote.write";
+        "drift.read": "drift.read";
+        "reproductions.roster": "reproductions.roster";
+        "reproductions.read": "reproductions.read";
+    }>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type DevRequest = z.infer<typeof DevRequestSchema>;
+/**
+ * What retrieval put in front of the model for this turn. An answer can be traced back to its
+ * chunks.
+ */
+export declare const DocsSourcesSchema: z.ZodObject<{
+    query: z.ZodString;
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        score: z.ZodNumber;
+        excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    took_ms: z.ZodNumber;
+    speech_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type DocsSources = z.infer<typeof DocsSourcesSchema>;
+/**
+ * Something went wrong. Inside a call it says what failed; outside a call it says which command
+ * the gateway refused.
+ */
+export declare const ErrorEventSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    command: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recoverable: z.ZodBoolean;
+}, z.core.$strict>;
+export type ErrorEvent = z.infer<typeof ErrorEventSchema>;
+/**
+ * The gateway refused to open a call because every worker of the fleet was full. Written into the
+ * agent's own log, which is the org's, before the door says no — the caller was offered a call
+ * back instead of a room.
+ */
+export declare const FleetFullSchema: z.ZodObject<{
+    channel: z.ZodEnum<{
+        phone: "phone";
+        web: "web";
+        whatsapp: "whatsapp";
+    }>;
+    workers: z.ZodInt;
+    active: z.ZodInt;
+}, z.core.$strict>;
+export type FleetFull = z.infer<typeof FleetFullSchema>;
+/**
+ * The replay is done: everything up to seq has been sent and what follows is live. Never stored;
+ * sent to the reader.
+ */
+export declare const LogCaughtUpSchema: z.ZodObject<{
+    seq: z.ZodInt;
+}, z.core.$strict>;
+export type LogCaughtUp = z.infer<typeof LogCaughtUpSchema>;
+/**
+ * This reader missed a stretch: it reconnected too late for the store, or fell behind and the
+ * fanout dropped ephemeral entries. When the platform has a snapshot, it is here so the reader can
+ * catch up in one step. Never stored; sent to the reader.
+ */
+export declare const LogGapSchema: z.ZodObject<{
+    from_seq: z.ZodInt;
+    to_seq: z.ZodInt;
+    snapshot: z.ZodNullable<z.ZodObject<{
+        seq: z.ZodInt;
+        agent: z.ZodString;
+        call: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            idle: "idle";
+            ringing: "ringing";
+            dialing: "dialing";
+            active: "active";
+            ended: "ended";
+        }>;
+        channel: z.ZodNullable<z.ZodEnum<{
+            phone: "phone";
+            web: "web";
+            whatsapp: "whatsapp";
+        }>>;
+        direction: z.ZodNullable<z.ZodEnum<{
+            inbound: "inbound";
+            outbound: "outbound";
+        }>>;
+        from: z.ZodNullable<z.ZodString>;
+        to: z.ZodNullable<z.ZodString>;
+        caller: z.ZodNullable<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        room: z.ZodNullable<z.ZodObject<{
+            name: z.ZodString;
+            sid: z.ZodString;
+            participants: z.ZodArray<z.ZodObject<{
+                identity: z.ZodString;
+                kind: z.ZodEnum<{
+                    agent: "agent";
+                    caller: "caller";
+                    supervisor: "supervisor";
+                    listener: "listener";
+                    sip: "sip";
+                }>;
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                joined_at: z.ZodNumber;
+                speaking: z.ZodBoolean;
+                attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>>;
+            caller: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        started_at: z.ZodNullable<z.ZodNumber>;
+        ended_at: z.ZodNullable<z.ZodNumber>;
+        end_reason: z.ZodNullable<z.ZodEnum<{
+            caller_hung_up: "caller_hung_up";
+            agent_hung_up: "agent_hung_up";
+            supervisor_ended: "supervisor_ended";
+            transferred: "transferred";
+            no_answer: "no_answer";
+            busy: "busy";
+            dial_failed: "dial_failed";
+            timeout: "timeout";
+            drained: "drained";
+            app_detached: "app_detached";
+            error: "error";
+        }>>;
+        outcome: z.ZodNullable<z.ZodString>;
+        user_state: z.ZodNullable<z.ZodEnum<{
+            listening: "listening";
+            speaking: "speaking";
+            away: "away";
+        }>>;
+        agent_state: z.ZodNullable<z.ZodEnum<{
+            listening: "listening";
+            speaking: "speaking";
+            initializing: "initializing";
+            idle: "idle";
+            thinking: "thinking";
+        }>>;
+        live: z.ZodObject<{
+            user: z.ZodNullable<z.ZodString>;
+            agent: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        turns: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            role: z.ZodLiteral<"user">;
+            speech_id: z.ZodString;
+            item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodString;
+            language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transcript_confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            metrics: z.ZodObject<{
+                started_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                stopped_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                transcription_delay: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                end_of_turn_delay: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                on_user_turn_completed_delay: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                stt_metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            role: z.ZodLiteral<"agent">;
+            speech_id: z.ZodString;
+            item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodString;
+            interrupted: z.ZodBoolean;
+            metrics: z.ZodObject<{
+                started_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                stopped_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                llm_node_ttft: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                llm_node_tps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                llm_node_ttfs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                tts_node_ttfb: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                playback_latency: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                e2e_latency: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                provider_request_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                llm_metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>>;
+                tts_metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>], "role">>;
+        metrics: z.ZodObject<{
+            llm: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"llm_metrics">;
+                label: z.ZodString;
+                request_id: z.ZodString;
+                timestamp: z.ZodNumber;
+                duration: z.ZodNumber;
+                ttft: z.ZodNumber;
+                cancelled: z.ZodBoolean;
+                completion_tokens: z.ZodInt;
+                prompt_tokens: z.ZodInt;
+                prompt_cached_tokens: z.ZodInt;
+                cache_creation_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                reasoning_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                total_tokens: z.ZodInt;
+                tokens_per_second: z.ZodNumber;
+                speech_id: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            stt: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"stt_metrics">;
+                label: z.ZodString;
+                request_id: z.ZodString;
+                timestamp: z.ZodNumber;
+                duration: z.ZodNumber;
+                audio_duration: z.ZodNumber;
+                input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                streamed: z.ZodBoolean;
+                acquire_time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                connection_reused: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            tts: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"tts_metrics">;
+                label: z.ZodString;
+                request_id: z.ZodString;
+                timestamp: z.ZodNumber;
+                ttfb: z.ZodNumber;
+                duration: z.ZodNumber;
+                audio_duration: z.ZodNumber;
+                cancelled: z.ZodBoolean;
+                characters_count: z.ZodInt;
+                input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                streamed: z.ZodBoolean;
+                acquire_time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                connection_reused: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                segment_id: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                speech_id: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            vad: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"vad_metrics">;
+                label: z.ZodString;
+                timestamp: z.ZodNumber;
+                idle_time: z.ZodNumber;
+                inference_duration_total: z.ZodNumber;
+                inference_count: z.ZodInt;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            eou: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"eou_metrics">;
+                timestamp: z.ZodNumber;
+                end_of_utterance_delay: z.ZodNumber;
+                transcription_delay: z.ZodNumber;
+                on_user_turn_completed_delay: z.ZodNumber;
+                speech_id: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            eot: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"eot_inference_metrics">;
+                timestamp: z.ZodNumber;
+                total_duration: z.ZodNumber;
+                detection_delay: z.ZodNumber;
+                prediction_duration: z.ZodNumber;
+                num_requests: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            interruption: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"interruption_metrics">;
+                timestamp: z.ZodNumber;
+                total_duration: z.ZodNumber;
+                prediction_duration: z.ZodNumber;
+                detection_delay: z.ZodNumber;
+                num_interruptions: z.ZodInt;
+                num_backchannels: z.ZodInt;
+                num_requests: z.ZodInt;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            realtime: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"realtime_model_metrics">;
+                label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                request_id: z.ZodString;
+                timestamp: z.ZodNumber;
+                duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                session_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                ttft: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                cancelled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                total_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                tokens_per_second: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                input_token_details: z.ZodObject<{
+                    audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    cached_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    cached_tokens_details: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                        audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                        text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                        image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    }, z.core.$strict>>>>;
+                }, z.core.$strict>;
+                output_token_details: z.ZodObject<{
+                    text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                    image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                }, z.core.$strict>;
+                acquire_time: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                connection_reused: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+            avatar: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"avatar_metrics">;
+                timestamp: z.ZodNumber;
+                playback_latency: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                session_started_time: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodNumber>>>;
+                avatar_joined_time: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodNumber>>>;
+                metadata: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodObject<{
+                    model_name: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                    model_provider: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+                }, z.core.$strict>>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        tools: z.ZodArray<z.ZodObject<{
+            call_id: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            speech_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+            }>;
+            output: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+            error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            duration_s: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            seq: z.ZodInt;
+        }, z.core.$strict>>;
+        app_state: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        events: z.ZodArray<z.ZodObject<{
+            seq: z.ZodInt;
+            name: z.ZodString;
+            source: z.ZodEnum<{
+                app: "app";
+                participant: "participant";
+            }>;
+            identity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        prompt: z.ZodRecord<z.ZodString, z.ZodObject<{
+            hash: z.ZodString;
+            chars: z.ZodInt;
+            seq: z.ZodInt;
+        }, z.core.$strict>>;
+        tools_visible: z.ZodArray<z.ZodString>;
+        confirms: z.ZodArray<z.ZodObject<{
+            tool: z.ZodString;
+            call_id: z.ZodString;
+            audience: z.ZodString;
+            phrase: z.ZodString;
+            status: z.ZodEnum<{
+                pending: "pending";
+                granted: "granted";
+                declined: "declined";
+            }>;
+            said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        memory: z.ZodArray<z.ZodObject<{
+            op: z.ZodEnum<{
+                recall: "recall";
+                remember: "remember";
+                forget: "forget";
+            }>;
+            contact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            facts: z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                text: z.ZodString;
+                category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                score: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+            took_ms: z.ZodNumber;
+        }, z.core.$strict>>;
+        sources: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            path: z.ZodString;
+            heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            score: z.ZodNumber;
+            excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        handoff: z.ZodObject<{
+            active: z.ZodBoolean;
+            by: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        held: z.ZodBoolean;
+        muted: z.ZodBoolean;
+        transfer: z.ZodNullable<z.ZodObject<{
+            to: z.ZodString;
+            mode: z.ZodEnum<{
+                cold: "cold";
+                warm: "warm";
+            }>;
+            status: z.ZodEnum<{
+                done: "done";
+                failed: "failed";
+                requested: "requested";
+            }>;
+            by: z.ZodEnum<{
+                agent: "agent";
+                supervisor: "supervisor";
+            }>;
+        }, z.core.$strict>>;
+        usage: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"llm_usage">;
+            provider: z.ZodString;
+            model: z.ZodString;
+            input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_cached_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_cache_creation_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_cached_audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_cached_text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            input_cached_image_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            output_audio_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            output_text_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            output_reasoning_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            session_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"tts_usage">;
+            provider: z.ZodString;
+            model: z.ZodString;
+            input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            characters_count: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            audio_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"stt_usage">;
+            provider: z.ZodString;
+            model: z.ZodString;
+            input_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            output_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            audio_duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"interruption_usage">;
+            provider: z.ZodString;
+            model: z.ZodString;
+            total_requests: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"eot_usage">;
+            provider: z.ZodString;
+            model: z.ZodString;
+            total_requests: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        }, z.core.$strict>], "type">>;
+        cost: z.ZodNullable<z.ZodObject<{
+            eur: z.ZodNumber;
+            rate: z.ZodObject<{
+                currency: z.ZodLiteral<"EUR">;
+                usd_to_eur: z.ZodNumber;
+                as_of: z.ZodString;
+            }, z.core.$strict>;
+            rows: z.ZodArray<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                unit: z.ZodEnum<{
+                    input_tokens: "input_tokens";
+                    cached_input_tokens: "cached_input_tokens";
+                    cache_creation_tokens: "cache_creation_tokens";
+                    output_tokens: "output_tokens";
+                    characters: "characters";
+                    audio_seconds: "audio_seconds";
+                    requests: "requests";
+                    session_seconds: "session_seconds";
+                }>;
+                quantity: z.ZodNumber;
+                unit_price_usd: z.ZodNumber;
+                eur: z.ZodNumber;
+            }, z.core.$strict>>;
+            unpriced: z.ZodArray<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        routes: z.ZodArray<z.ZodObject<{
+            channel: z.ZodEnum<{
+                phone: "phone";
+                web: "web";
+                whatsapp: "whatsapp";
+            }>;
+            number: z.ZodNullable<z.ZodString>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        gaps: z.ZodArray<z.ZodObject<{
+            from_seq: z.ZodInt;
+            to_seq: z.ZodInt;
+        }, z.core.$strict>>;
+        errors: z.ZodArray<z.ZodObject<{
+            seq: z.ZodInt;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        custom: z.ZodArray<z.ZodObject<{
+            seq: z.ZodInt;
+            name: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LogGap = z.infer<typeof LogGapSchema>;
+/**
+ * What memory did for this turn or at hangup: a recall before the reply, a remember after the
+ * call, a forget on request.
+ */
+export declare const MemoryOpsSchema: z.ZodObject<{
+    ops: z.ZodArray<z.ZodObject<{
+        op: z.ZodEnum<{
+            recall: "recall";
+            remember: "remember";
+            forget: "forget";
+        }>;
+        contact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        facts: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodString;
+            category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            score: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        took_ms: z.ZodNumber;
+    }, z.core.$strict>>;
+    speech_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type MemoryOps = z.infer<typeof MemoryOpsSchema>;
+/** The answer to ping. Ephemeral: it proves the socket is alive and says nothing else. */
+export declare const PongSchema: z.ZodObject<{
+    ts: z.ZodNumber;
+}, z.core.$strict>;
+export type Pong = z.infer<typeof PongSchema>;
+/**
+ * A block of the prompt was rewritten. The text stays out of the log; its hash and length let two
+ * states be compared.
+ */
+export declare const PromptChangedSchema: z.ZodObject<{
+    name: z.ZodString;
+    hash: z.ZodString;
+    chars: z.ZodInt;
+}, z.core.$strict>;
+export type PromptChanged = z.infer<typeof PromptChangedSchema>;
+/** A tool call's result changed the state. */
+export declare const StateCauseToolSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"tool">;
+    tool: z.ZodString;
+    call_id: z.ZodString;
+}, z.core.$strict>;
+export type StateCauseTool = z.infer<typeof StateCauseToolSchema>;
+/** A fact from outside changed the state: the app's handler for an event.received moved a field. */
+export declare const StateCauseEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    name: z.ZodString;
+    seq: z.ZodInt;
+}, z.core.$strict>;
+export type StateCauseEvent = z.infer<typeof StateCauseEventSchema>;
+/** What changed the state: a tool's result, or a fact from outside. Told apart by kind. */
+export declare const StateCauseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"tool">;
+    tool: z.ZodString;
+    call_id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    name: z.ZodString;
+    seq: z.ZodInt;
+}, z.core.$strict>], "kind">;
+export type StateCause = z.infer<typeof StateCauseSchema>;
+/**
+ * The app's declared state changed. A tool's result or an outside fact caused it, and the cause
+ * says which; the whole state travels so a reader never needs the previous entry.
+ */
+export declare const StateChangedSchema: z.ZodObject<{
+    state: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    changed: z.ZodArray<z.ZodString>;
+    cause: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"tool">;
+        tool: z.ZodString;
+        call_id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        name: z.ZodString;
+        seq: z.ZodInt;
+    }, z.core.$strict>], "kind">>>;
+}, z.core.$strict>;
+export type StateChanged = z.infer<typeof StateChangedSchema>;
+/** A supervisor hung up the call. call.ended follows with reason supervisor_ended. */
+export declare const SupervisorEndedSchema: z.ZodObject<{
+    by: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type SupervisorEnded = z.infer<typeof SupervisorEndedSchema>;
+/** The supervisor gave the line back; the agent resumes with the history intact. */
+export declare const SupervisorReleasedSchema: z.ZodObject<{
+    by: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SupervisorReleased = z.infer<typeof SupervisorReleasedSchema>;
+/** A supervisor made the agent say this to the caller. */
+export declare const SupervisorSaidSchema: z.ZodObject<{
+    by: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    text: z.ZodString;
+}, z.core.$strict>;
+export type SupervisorSaid = z.infer<typeof SupervisorSaidSchema>;
+/** A supervisor took the line; the agent is quiet until supervisor.released. */
+export declare const SupervisorTookOverSchema: z.ZodObject<{
+    by: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SupervisorTookOver = z.infer<typeof SupervisorTookOverSchema>;
+/** A supervisor asked for a transfer. call.transferred says how it went. */
+export declare const SupervisorTransferredSchema: z.ZodObject<{
+    by: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    to: z.ZodString;
+    mode: z.ZodEnum<{
+        cold: "cold";
+        warm: "warm";
+    }>;
+}, z.core.$strict>;
+export type SupervisorTransferred = z.infer<typeof SupervisorTransferredSchema>;
+/** A supervisor told the agent something the caller never heard. */
+export declare const SupervisorWhisperedSchema: z.ZodObject<{
+    by: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    text: z.ZodString;
+}, z.core.$strict>;
+export type SupervisorWhispered = z.infer<typeof SupervisorWhisperedSchema>;
+/**
+ * The model called a tool. The platform sends this to the app and the app's method runs in the
+ * app's own process; tool.result closes it.
+ */
+export declare const ToolCallSchema: z.ZodObject<{
+    call_id: z.ZodString;
+    name: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    speech_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ToolCall = z.infer<typeof ToolCallSchema>;
+/** The tools the model can see changed. The app's state moved and each tool's when was recomputed. */
+export declare const ToolsChangedSchema: z.ZodObject<{
+    visible: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type ToolsChanged = z.infer<typeof ToolsChangedSchema>;
+/**
+ * The agent's reply is over and this is what was said. With it, everything the session measured
+ * about the reply.
+ */
+export declare const AgentTurnEndedSchema: z.ZodObject<{
+    speech_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodString;
+    interrupted: z.ZodBoolean;
+    metrics: z.ZodObject<{
+        started_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        stopped_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        llm_node_ttft: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        llm_node_tps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        llm_node_ttfs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        tts_node_ttfb: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        playback_latency: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        e2e_latency: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        provider_request_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        llm_metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            model_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+        tts_metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            model_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AgentTurnEnded = z.infer<typeof AgentTurnEndedSchema>;
+/**
+ * The caller's turn is over and this is what they said. With it, everything the session measured
+ * about the turn.
+ */
+export declare const UserTurnEndedSchema: z.ZodObject<{
+    speech_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodString;
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    transcript_confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    metrics: z.ZodObject<{
+        started_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        stopped_speaking_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        transcription_delay: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        end_of_turn_delay: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        on_user_turn_completed_delay: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        stt_metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            model_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            model_provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type UserTurnEnded = z.infer<typeof UserTurnEndedSchema>;
+/** The caller's state changed, in the session's own words. */
+export declare const UserStateChangedSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        listening: "listening";
+        speaking: "speaking";
+        away: "away";
+    }>;
+}, z.core.$strict>;
+export type UserStateChanged = z.infer<typeof UserStateChangedSchema>;
+/**
+ * Words from the caller as the recognizer hears them. Interim while final is false; the final one
+ * becomes turn.user. Interim entries are ephemeral.
+ */
+export declare const UserTranscriptSchema: z.ZodObject<{
+    text: z.ZodString;
+    final: z.ZodBoolean;
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type UserTranscript = z.infer<typeof UserTranscriptSchema>;