@pinecall/room 0.1.3 → 0.1.4

package/dist/wire/events-call.d.ts

@@ -0,0 +1,422 @@
+/** The events of a call's life and of the agent that holds it. */
+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>;
+/** 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>;
+/** One socket let go of its calls without cutting them. */
+export declare const AgentDrainingSchema: z.ZodObject<{
+    app: z.ZodString;
+    env: z.ZodEnum<{
+        production: "production";
+        sandbox: "sandbox";
+    }>;
+    handed: z.ZodInt;
+    parked: z.ZodInt;
+}, z.core.$strict>;
+/**
+ * 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>;
+/** The agent's state changed, in the session's own words. */
+export declare const AgentStateChangedSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        idle: "idle";
+        initializing: "initializing";
+        listening: "listening";
+        speaking: "speaking";
+        thinking: "thinking";
+    }>;
+}, z.core.$strict>;
+/**
+ * One delta of the reply the agent is giving, never the reply so far: in a voice call one word, as
+ * the voice plays it, with the seconds it was aligned to; in a written call one model token. The
+ * reply so far is every delta of the same speech_id since the last turn.agent, joined; turn.agent
+ * carries the whole reply and closes it. 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>;
+/**
+ * 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>>>;
+    persona: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+    accepts_when: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+    declines_when: 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>;
+/** A call changed hands without ending. */
+export declare const CallAttachedSchema: z.ZodObject<{
+    app: z.ZodString;
+    started: 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>>>;
+        persona: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+        accepts_when: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+        declines_when: 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>;
+    state: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    seq: z.ZodInt;
+    claimed: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
+}, z.core.$strict>;
+/** The call was bound to a page's code. */
+export declare const CallClaimedSchema: z.ZodObject<{
+    code: z.ZodString;
+    via: z.ZodEnum<{
+        agent: "agent";
+        keypad: "keypad";
+    }>;
+}, z.core.$strict>;
+/**
+ * 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>>;
+    asked_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/** The call is over. Nothing about the conversation follows; call.summary still does. */
+export declare const CallEndedSchema: z.ZodObject<{
+    reason: z.ZodEnum<{
+        agent_hung_up: "agent_hung_up";
+        app_detached: "app_detached";
+        busy: "busy";
+        caller_hung_up: "caller_hung_up";
+        dial_failed: "dial_failed";
+        drained: "drained";
+        error: "error";
+        no_answer: "no_answer";
+        supervisor_ended: "supervisor_ended";
+        timeout: "timeout";
+        transferred: "transferred";
+    }>;
+    ended_by: z.ZodEnum<{
+        agent: "agent";
+        caller: "caller";
+        platform: "platform";
+        supervisor: "supervisor";
+    }>;
+    ended_at: z.ZodNumber;
+    duration_s: z.ZodNumber;
+}, z.core.$strict>;
+/**
+ * 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>;
+/**
+ * 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>;
+/**
+ * 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<{
+            broken: "broken";
+            deferred: "deferred";
+            held: "held";
+            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_usd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+/**
+ * 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<{
+        agent_hung_up: "agent_hung_up";
+        app_detached: "app_detached";
+        busy: "busy";
+        caller_hung_up: "caller_hung_up";
+        dial_failed: "dial_failed";
+        drained: "drained";
+        error: "error";
+        no_answer: "no_answer";
+        supervisor_ended: "supervisor_ended";
+        timeout: "timeout";
+        transferred: "transferred";
+    }>;
+    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<{
+        usd: z.ZodNumber;
+        rows: z.ZodArray<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            unit: z.ZodEnum<{
+                audio_seconds: "audio_seconds";
+                cache_creation_tokens: "cache_creation_tokens";
+                cached_input_tokens: "cached_input_tokens";
+                characters: "characters";
+                input_tokens: "input_tokens";
+                minutes: "minutes";
+                output_tokens: "output_tokens";
+                requests: "requests";
+                session_seconds: "session_seconds";
+            }>;
+            quantity: z.ZodNumber;
+            unit_price_usd: z.ZodNumber;
+            usd: 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>;
+/** 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.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodEnum<{
+        cold: "cold";
+        warm: "warm";
+    }>>>>;
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Somebody asked to be called back: a phone caller the overflow agent answered, a web visitor who
+ * left a number at the widget, or a caller who asked the agent for one (call.callback). 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<{
+        agent: "agent";
+        overflow: "overflow";
+        widget: "widget";
+    }>;
+    call: z.ZodNullable<z.ZodString>;
+    when: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<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>;
+/**
+ * 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>;
+//# sourceMappingURL=events-call.d.ts.map

package/dist/wire/events-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-call.d.ts","sourceRoot":"","sources":["../../src/wire/events-call.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;kBAEhC,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB;;;;;;;kBAI9B,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB;;;;;;;;kBAK9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;kBAKhC,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB;;;;;;;;kBAElC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;kBAMhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAY5B,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM7B,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB;;;;;;kBAG5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;kBAQ5B,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;kBAK1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;kBAGzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;kBAO1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ5B,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,qBAAqB;;;;;;;;kBAKhC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;kBAQlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;kBAM/B,CAAC"}

package/dist/wire/events-call.js

@@ -0,0 +1,182 @@
+/** The events of a call's life and of the agent that holds it. */
+import { z } from "zod";
+import { AgentStateSchema, ChannelSchema, ContactSchema, CostSchema, DirectionSchema, EndedBySchema, EndReasonSchema, EnvSchema, RouteSchema, TransferModeSchema, } from "./defs.js";
+import { JudgmentSchema } from "./events.js";
+import { AgentTurnMetricsSchema, ModelUsageSchema } from "./metrics.js";
+/**
+ * The gateway applied an agent.configure. Live calls keep their session; the next call starts with
+ * the new config.
+ */
+export const AgentConfiguredSchema = z.strictObject({
+    changed: z.array(z.string()),
+});
+/** One socket stopped holding the agent. */
+export const AgentDetachedSchema = z.strictObject({
+    app: z.string(),
+    env: EnvSchema,
+    left: z.boolean(),
+});
+/** One socket let go of its calls without cutting them. */
+export const AgentDrainingSchema = z.strictObject({
+    app: z.string(),
+    env: EnvSchema,
+    handed: z.int(),
+    parked: z.int(),
+});
+/**
+ * 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 const AgentRegisteredSchema = z.strictObject({
+    routes: z.array(RouteSchema),
+    app: z.string(),
+    sdk: z.string().nullish(),
+    env: EnvSchema.nullish(),
+});
+/** The agent's state changed, in the session's own words. */
+export const AgentStateChangedSchema = z.strictObject({
+    state: AgentStateSchema,
+});
+/**
+ * One delta of the reply the agent is giving, never the reply so far: in a voice call one word, as
+ * the voice plays it, with the seconds it was aligned to; in a written call one model token. The
+ * reply so far is every delta of the same speech_id since the last turn.agent, joined; turn.agent
+ * carries the whole reply and closes it. Interim entries are ephemeral.
+ */
+export const AgentTranscriptSchema = z.strictObject({
+    speech_id: z.string(),
+    text: z.string(),
+    final: z.boolean(),
+    start: z.number().nullish(),
+    end: z.number().nullish(),
+});
+/**
+ * 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 const CallStartedSchema = z.strictObject({
+    channel: ChannelSchema,
+    direction: DirectionSchema,
+    from: z.string(),
+    to: z.string(),
+    run: z.string().nullable().nullish(),
+    persona: z.string().nullable().nullish(),
+    accepts_when: z.string().nullable().nullish(),
+    declines_when: z.string().nullable().nullish(),
+    caller: ContactSchema.nullable(),
+    started_at: z.number(),
+    env: EnvSchema.nullish(),
+});
+/** A call changed hands without ending. */
+export const CallAttachedSchema = z.strictObject({
+    app: z.string(),
+    started: CallStartedSchema,
+    state: z.record(z.string(), z.unknown()),
+    seq: z.int(),
+    claimed: z.string().nullable().nullish(),
+});
+/** The call was bound to a page's code. */
+export const CallClaimedSchema = z.strictObject({
+    code: z.string(),
+    via: z.enum(["keypad", "agent"]),
+});
+/**
+ * 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 const CallDialingSchema = z.strictObject({
+    channel: ChannelSchema,
+    from: z.string(),
+    to: z.string(),
+    run: z.string().nullable().nullish(),
+    caller: ContactSchema.nullable(),
+    external_id: z.string().nullish(),
+    asked_by: z.string().nullish(),
+});
+/** The call is over. Nothing about the conversation follows; call.summary still does. */
+export const CallEndedSchema = z.strictObject({
+    reason: EndReasonSchema,
+    ended_by: EndedBySchema,
+    ended_at: z.number(),
+    duration_s: z.number(),
+});
+/**
+ * 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 const CallLineSchema = z.strictObject({
+    held: z.boolean(),
+    muted: z.boolean(),
+});
+/**
+ * An inbound call is offered to this agent and has not been answered yet. The first entry of an
+ * inbound call's log.
+ */
+export const CallRingingSchema = z.strictObject({
+    channel: ChannelSchema,
+    from: z.string(),
+    to: z.string(),
+    route: RouteSchema,
+    run: z.string().nullable().nullish(),
+    caller: ContactSchema.nullable(),
+    external_id: z.string().nullish(),
+});
+/**
+ * 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 const CallScoreSchema = z.strictObject({
+    passed: z.boolean().nullish(),
+    not_judged: z.string().nullish(),
+    judges: z.array(JudgmentSchema),
+    panel: z.array(z.string()).nullish(),
+    judge_calls: z.int(),
+    judge_cost_usd: z.number().nullish(),
+});
+/**
+ * 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 const CallSummarySchema = z.strictObject({
+    reason: EndReasonSchema,
+    outcome: z.string(),
+    duration_s: z.number(),
+    turns: z.int(),
+    usage: z.array(ModelUsageSchema),
+    cost: CostSchema,
+    recording: z.string().nullish(),
+});
+/** A transfer asked for by the agent or a supervisor finished, one way or the other. */
+export const CallTransferredSchema = z.strictObject({
+    to: z.string(),
+    mode: TransferModeSchema.nullable().nullish(),
+    ok: z.boolean(),
+    error: z.string().nullish(),
+});
+/**
+ * Somebody asked to be called back: a phone caller the overflow agent answered, a web visitor who
+ * left a number at the widget, or a caller who asked the agent for one (call.callback). Written
+ * into the agent's own log; the tenant's app reads it and places the call.
+ */
+export const CallbackRequestedSchema = z.strictObject({
+    channel: ChannelSchema,
+    number: z.string(),
+    via: z.enum(["overflow", "widget", "agent"]),
+    call: z.string().nullable(),
+    when: z.string().nullish(),
+    note: z.string().nullish(),
+    contact: ContactSchema.nullable(),
+});
+/**
+ * The agent's reply is over and this is what was said. With it, everything the session measured
+ * about the reply.
+ */
+export const AgentTurnEndedSchema = z.strictObject({
+    speech_id: z.string(),
+    item_id: z.string().nullish(),
+    text: z.string(),
+    interrupted: z.boolean(),
+    metrics: AgentTurnMetricsSchema,
+});
+//# sourceMappingURL=events-call.js.map

package/dist/wire/events-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-call.js","sourceRoot":"","sources":["../../src/wire/events-call.ts"],"names":[],"mappings":"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"}