@pinecall/room 0.1.0

package/dist/rows.d.ts

@@ -0,0 +1,37 @@
+/** The call's log as one column of rows, in the order things happened: turns and tool runs interleaved. */
+import type { State } from "@pinecall/protocol";
+export type Row = {
+    kind: "turn";
+    key: string;
+    role: "user" | "agent";
+    text: string;
+    /** How long the reply took, end to end, when the wire measured it. */
+    ms?: number | undefined;
+    /** The model's time to its first token: what a written call has instead of `ms`. */
+    ttft?: number | undefined;
+    interrupted?: boolean | undefined;
+} | {
+    kind: "tool";
+    key: string;
+    name: string;
+    args: string;
+    output?: string | undefined;
+    error?: string | undefined;
+    status: string;
+    /** The arguments and the output as they are, for a page that draws more than one line. */
+    raw: {
+        arguments: Record<string, unknown>;
+        output: unknown;
+    };
+};
+/** A value as one line of JSON, cut where a reader stops caring. */
+export declare function brief(value: unknown, max?: number): string;
+/** Every turn and every tool run, interleaved the way they happened. */
+export declare function rowsOf(state: State): Row[];
+/**
+ * The agent's own declared fields, in the order the class writes them, minus the empty ones. A
+ * field that is an object is opened one level — `person.name`, `person.email` — because a page
+ * shows a name, not a JSON blob; anything deeper is written briefly as it is.
+ */
+export declare function knownBy(state: State): [string, string][];
+//# sourceMappingURL=rows.d.ts.map

package/dist/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../src/rows.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAS3G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,MAAM,GAAG,GACX;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D,CAAC;AAEN,oEAAoE;AACpE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAM,GAAG,MAAM,CAKvD;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,CAyC1C;AAOD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAUxD"}

package/dist/rows.js

@@ -0,0 +1,89 @@
+/** The call's log as one column of rows, in the order things happened: turns and tool runs interleaved. */
+//
+// The state the protocol folds keeps turns and tool runs in two lists, each in
+// its own order, joined by the `speech_id` of the reply they belong to: a tool
+// with speech id X ran while the agent was working on reply X, so it goes ABOVE
+// the agent's turn and below the visitor's. Drawing the two lists one after the
+// other instead — every word, then every tool — is a timeline that never
+// happened, and the whole point of showing this is that it is the real one.
+/** A value as one line of JSON, cut where a reader stops caring. */
+export function brief(value, max = 160) {
+    if (value === undefined)
+        return "";
+    const written = typeof value === "string" ? value : JSON.stringify(value);
+    if (written === undefined)
+        return "";
+    return written.length > max ? `${written.slice(0, max - 1)}…` : written;
+}
+/** Every turn and every tool run, interleaved the way they happened. */
+export function rowsOf(state) {
+    const rows = [];
+    const drawn = new Set();
+    const tool = (run) => ({
+        kind: "tool",
+        key: `tool-${run.call_id}`,
+        name: run.name,
+        args: brief(run.arguments),
+        output: run.status === "done" ? brief(run.output) : undefined,
+        error: run.error ?? undefined,
+        status: run.status,
+        raw: { arguments: run.arguments, output: run.output },
+    });
+    for (const [at, turn] of state.turns.entries()) {
+        if (turn.role === "agent") {
+            for (const run of state.tools) {
+                if (run.speech_id !== turn.speech_id || drawn.has(run.call_id))
+                    continue;
+                drawn.add(run.call_id);
+                rows.push(tool(run));
+            }
+        }
+        rows.push({
+            kind: "turn",
+            key: `turn-${at}`,
+            role: turn.role,
+            text: turn.text,
+            ms: turn.role === "agent" ? msOf(turn.metrics?.e2e_latency) : undefined,
+            ttft: turn.role === "agent" ? msOf(turn.metrics?.llm_node_ttft) : undefined,
+            interrupted: turn.role === "agent" ? turn.interrupted : undefined,
+        });
+    }
+    // A tool that is still running belongs after everything said so far: the reply
+    // it was called for has not landed yet, which is exactly what it looks like.
+    for (const run of state.tools) {
+        if (drawn.has(run.call_id))
+            continue;
+        rows.push(tool(run));
+    }
+    return rows;
+}
+/** Seconds on the wire, milliseconds on the screen. */
+function msOf(seconds) {
+    return typeof seconds === "number" ? Math.round(seconds * 1000) : undefined;
+}
+/**
+ * The agent's own declared fields, in the order the class writes them, minus the empty ones. A
+ * field that is an object is opened one level — `person.name`, `person.email` — because a page
+ * shows a name, not a JSON blob; anything deeper is written briefly as it is.
+ */
+export function knownBy(state) {
+    const rows = [];
+    for (const [name, value] of Object.entries(state.app_state)) {
+        if (isRecord(value)) {
+            for (const [field, inner] of Object.entries(value)) {
+                if (!empty(inner))
+                    rows.push([`${name}.${field}`, brief(inner, 60)]);
+            }
+        }
+        else if (!empty(value))
+            rows.push([name, brief(value, 60)]);
+    }
+    return rows;
+}
+function empty(value) {
+    return value === null || value === undefined || value === "";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=rows.js.map

package/dist/rows.js.map

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

package/dist/seat/join.d.ts

@@ -0,0 +1,35 @@
+/** A seat in the call's room, talking or typing. The only file that names LiveKit's events. */
+import type { LivekitModule } from "./livekit.js";
+import type { Sink } from "./sink.js";
+/** Who is making a sound right now, and how loud the agent is (0 to 1). */
+export interface Speaking {
+    agent: boolean;
+    user: boolean;
+    level: number;
+}
+/** What the seat tells the room about itself after it is taken. */
+export interface SeatHears {
+    /** The room closed from the other side: the agent hung up, or the network went. */
+    disconnected: () => void;
+    speaking: (speaking: Speaking) => void;
+    /** True when the browser has not been told it may make a sound. */
+    wantsSound: (wanted: boolean) => void;
+}
+export interface SeatOptions {
+    livekit: LivekitModule;
+    server_url: string;
+    participant_token: string;
+    mode: "talk" | "chat";
+    sink: Sink;
+    on: SeatHears;
+}
+/** A taken seat. Leaving is final; `on.disconnected` is not called for a seat that left. */
+export interface Seat {
+    send(text: string): Promise<void>;
+    leave(): Promise<void>;
+    playSound(): void;
+    canPlaybackAudio(): boolean;
+}
+/** Join the room. Rejects with the room's own error when it cannot connect or hear the microphone. */
+export declare function joinSeat(options: SeatOptions): Promise<Seat>;
+//# sourceMappingURL=join.d.ts.map

package/dist/seat/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/seat/join.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,mFAAmF;IACnF,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,mEAAmE;IACnE,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,EAAE,EAAE,SAAS,CAAC;CACf;AAED,4FAA4F;AAC5F,MAAM,WAAW,IAAI;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,IAAI,IAAI,CAAC;IAClB,gBAAgB,IAAI,OAAO,CAAC;CAC7B;AAKD,sGAAsG;AACtG,wBAAsB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDlE"}

package/dist/seat/join.js

@@ -0,0 +1,64 @@
+/** A seat in the call's room, talking or typing. The only file that names LiveKit's events. */
+/** The topic a typed line rides on. LiveKit's own, and the one the agent listens to. */
+const CHAT = "lk.chat";
+/** Join the room. Rejects with the room's own error when it cannot connect or hear the microphone. */
+export async function joinSeat(options) {
+    const { livekit, mode, sink, on } = options;
+    const { RoomEvent } = livekit;
+    const room = new livekit.Room();
+    let left = false;
+    const leave = () => {
+        left = true;
+        sink.close();
+        return room.disconnect();
+    };
+    // Chat never plays the agent: a written conversation that starts talking out loud is a bug.
+    room.on(RoomEvent.TrackSubscribed, (track) => {
+        if (mode === "talk" && track.kind === livekit.Track.Kind.Audio)
+            sink.add(track.attach());
+    });
+    room.on(RoomEvent.TrackUnsubscribed, (track) => {
+        for (const element of track.detach())
+            sink.remove(element);
+    });
+    room.on(RoomEvent.Disconnected, () => {
+        if (left)
+            return;
+        left = true;
+        sink.close();
+        on.disconnected();
+    });
+    room.on(RoomEvent.AudioPlaybackStatusChanged, () => on.wantsSound(!room.canPlaybackAudio));
+    room.on(RoomEvent.ActiveSpeakersChanged, (speakers) => on.speaking(speakingOf(speakers, room.localParticipant.identity)));
+    try {
+        await room.connect(options.server_url, options.participant_token);
+        if (mode === "talk")
+            await room.localParticipant.setMicrophoneEnabled(true);
+    }
+    catch (refused) {
+        // The refusal is the news. A room that also fails to close has nothing to add to it.
+        await leave().catch(() => undefined);
+        throw refused;
+    }
+    return {
+        async send(text) {
+            await room.localParticipant.sendText(text, { topic: CHAT });
+        },
+        leave,
+        playSound() {
+            // A browser that still says no leaves the page asking, rather than silently mute.
+            room.startAudio().then(() => on.wantsSound(!room.canPlaybackAudio), () => on.wantsSound(!room.canPlaybackAudio));
+        },
+        canPlaybackAudio: () => room.canPlaybackAudio,
+    };
+}
+/** The agent is whoever speaks that is not this page; its level is how loud. */
+function speakingOf(speakers, me) {
+    const remote = speakers.find((speaker) => speaker.identity !== me);
+    return {
+        agent: remote !== undefined,
+        user: speakers.some((speaker) => speaker.identity === me),
+        level: remote?.audioLevel ?? 0,
+    };
+}
+//# sourceMappingURL=join.js.map

package/dist/seat/join.js.map

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

package/dist/seat/livekit.d.ts

@@ -0,0 +1,51 @@
+/** The one door to livekit-client: loaded when a seat is taken, and the little of it the seat uses. */
+/** A remote track as the seat handles it: its kind, and the element that plays it. */
+export interface SeatTrack {
+    readonly kind: string;
+    attach(): HTMLMediaElement;
+    detach(): HTMLMediaElement[];
+}
+/** Somebody in the room: who, and how loud right now (0 to 1). */
+export interface SeatParticipant {
+    readonly identity: string;
+    readonly audioLevel: number;
+}
+/** The page's own participant: its microphone, and the typed lines it sends. */
+export interface SeatLocal extends SeatParticipant {
+    setMicrophoneEnabled(enabled: boolean): Promise<unknown>;
+    sendText(text: string, options: {
+        topic: string;
+    }): Promise<unknown>;
+}
+/** The room the page joins. Five events are listened to; nothing else of LiveKit's is named. */
+export interface SeatRoom {
+    readonly localParticipant: SeatLocal;
+    readonly canPlaybackAudio: boolean;
+    connect(url: string, token: string): Promise<void>;
+    disconnect(): Promise<void>;
+    startAudio(): Promise<void>;
+    on(event: "trackSubscribed", listener: (track: SeatTrack) => void): this;
+    on(event: "trackUnsubscribed", listener: (track: SeatTrack) => void): this;
+    on(event: "disconnected", listener: () => void): this;
+    on(event: "audioPlaybackChanged", listener: (playing: boolean) => void): this;
+    on(event: "activeSpeakersChanged", listener: (speakers: SeatParticipant[]) => void): this;
+}
+/** What `import("livekit-client")` has to offer the seat. A test hands in a fake of this shape. */
+export interface LivekitModule {
+    Room: new () => SeatRoom;
+    RoomEvent: {
+        readonly TrackSubscribed: "trackSubscribed";
+        readonly TrackUnsubscribed: "trackUnsubscribed";
+        readonly Disconnected: "disconnected";
+        readonly AudioPlaybackStatusChanged: "audioPlaybackChanged";
+        readonly ActiveSpeakersChanged: "activeSpeakersChanged";
+    };
+    Track: {
+        Kind: {
+            readonly Audio: "audio";
+        };
+    };
+}
+/** livekit-client, the moment a seat is needed. */
+export declare function loadLivekit(): Promise<LivekitModule>;
+//# sourceMappingURL=livekit.d.ts.map

package/dist/seat/livekit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.d.ts","sourceRoot":"","sources":["../../src/seat/livekit.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,sFAAsF;AACtF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,gBAAgB,CAAC;IAC3B,MAAM,IAAI,gBAAgB,EAAE,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,WAAW,SAAU,SAAQ,eAAe;IAChD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE;AAED,gGAAgG;AAChG,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACtD,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9E,EAAE,CAAC,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3F;AAED,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,QAAQ,CAAC;IACzB,SAAS,EAAE;QACT,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;QAC5C,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;QAChD,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;QACtC,QAAQ,CAAC,0BAA0B,EAAE,sBAAsB,CAAC;QAC5D,QAAQ,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;KACzD,CAAC;IACF,KAAK,EAAE;QAAE,IAAI,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;CAC9C;AAID,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAEpD"}

package/dist/seat/livekit.js

@@ -0,0 +1,8 @@
+/** The one door to livekit-client: loaded when a seat is taken, and the little of it the seat uses. */
+// Loaded, not imported: a page that only follows a phone call never downloads a WebRTC stack, and
+// a server that imports this package for `mint` never evaluates one.
+/** livekit-client, the moment a seat is needed. */
+export function loadLivekit() {
+    return import("livekit-client");
+}
+//# sourceMappingURL=livekit.js.map

package/dist/seat/livekit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.js","sourceRoot":"","sources":["../../src/seat/livekit.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAgDvG,kGAAkG;AAClG,qEAAqE;AACrE,mDAAmD;AACnD,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAClC,CAAC"}

package/dist/seat/sink.d.ts

@@ -0,0 +1,11 @@
+/** Where the agent's voice plays: a hidden element in the page, made the first time it is needed. */
+/** What the seat hands a voice to. A test hands in one that records instead of playing. */
+export interface Sink {
+    add(element: HTMLMediaElement): void;
+    remove(element: HTMLMediaElement): void;
+    /** Every element out of the page. */
+    close(): void;
+}
+/** A hidden box at the end of the body. Nothing touches the document until a voice arrives. */
+export declare function hiddenSink(): Sink;
+//# sourceMappingURL=sink.d.ts.map

package/dist/seat/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/seat/sink.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAErG,2FAA2F;AAC3F,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,IAAI,IAAI,CAmBjC"}

package/dist/seat/sink.js

@@ -0,0 +1,23 @@
+/** Where the agent's voice plays: a hidden element in the page, made the first time it is needed. */
+/** A hidden box at the end of the body. Nothing touches the document until a voice arrives. */
+export function hiddenSink() {
+    let box = null;
+    return {
+        add(element) {
+            if (box === null) {
+                box = document.createElement("div");
+                box.style.display = "none";
+                document.body.append(box);
+            }
+            box.append(element);
+        },
+        remove(element) {
+            element.remove();
+        },
+        close() {
+            box?.remove();
+            box = null;
+        },
+    };
+}
+//# sourceMappingURL=sink.js.map

package/dist/seat/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../src/seat/sink.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAUrG,+FAA+F;AAC/F,MAAM,UAAU,UAAU;IACxB,IAAI,GAAG,GAAuB,IAAI,CAAC;IACnC,OAAO;QACL,GAAG,CAAC,OAAO;YACT,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBACpC,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,CAAC;QACD,KAAK;YACH,GAAG,EAAE,MAAM,EAAE,CAAC;YACd,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,48 @@
+/** @pinecall/room/server: what a tenant's server does with its key — a ticket for a seat, a call placed. */
+/** What `POST /v1/tokens` answers: where the room is, the ticket into it, and the call's id. */
+export interface Minted {
+    server_url: string;
+    participant_token: string;
+    call: string;
+}
+/** What `POST /v1/agents/{agent}/dial` answers: the call's id, before anything has rung. */
+export interface Dialed {
+    call: string;
+    agent: string;
+    to: string;
+    from: string;
+    env: string;
+}
+export interface MintOptions {
+    /** The gateway, `https://box.pinecall.io` or your own. */
+    url: string;
+    agent: string;
+    scope: "talk" | "chat";
+    /** How long the ticket lives. The gateway's default is 60 s, and 600 s the most. */
+    ttl_s?: number | undefined;
+    /** Who is calling: memory files the call under it. */
+    contact?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    fetch?: typeof fetch | undefined;
+}
+export interface DialOptions {
+    url: string;
+    agent: string;
+    /** The number to call, E.164. */
+    to: string;
+    /** Which of the agent's own numbers the far end sees. Unsaid, the first one it answers at. */
+    from?: string | undefined;
+    fetch?: typeof fetch | undefined;
+}
+/** The gateway said no. `detail` is its own sentence when it sent one; it names the fix. */
+export declare class GatewayRefused extends Error {
+    readonly name = "GatewayRefused";
+    readonly status: number;
+    readonly detail: string | null;
+    constructor(status: number, detail: string | null);
+}
+/** A ticket for one seat in one new call. The key needs the `talk` scope. */
+export declare function mint(key: string, options: MintOptions): Promise<Minted>;
+/** Have the agent call `to`. The key needs the `talk` scope; the number must have reached the org before. */
+export declare function dial(key: string, options: DialOptions): Promise<Dialed>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAM5G,gGAAgG;AAChG,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4FAA4F;AAC5F,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CAClC;AAED,4FAA4F;AAC5F,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAkB,IAAI,oBAAoB;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,YAAY,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAIhD;CACF;AAKD,6EAA6E;AAC7E,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7E;AAED,6GAA6G;AAC7G,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7E"}

package/dist/server/index.js

@@ -0,0 +1,73 @@
+/** @pinecall/room/server: what a tenant's server does with its key — a ticket for a seat, a call placed. */
+//
+// The key never reaches a page. The page asks the tenant's own server, the server asks the gateway
+// with the key, and what comes back to the page is a ticket for one call. Nothing here is imported
+// by the browser side, and nothing here needs more than `fetch`.
+/** The gateway said no. `detail` is its own sentence when it sent one; it names the fix. */
+export class GatewayRefused extends Error {
+    name = "GatewayRefused";
+    status;
+    detail;
+    constructor(status, detail) {
+        super(detail ?? `the gateway answered ${status}`);
+        this.status = status;
+        this.detail = detail;
+    }
+}
+// A gateway that has not answered in this long is not going to, and a visitor is waiting on it.
+const TIMEOUT_MS = 10_000;
+/** A ticket for one seat in one new call. The key needs the `talk` scope. */
+export async function mint(key, options) {
+    const { url, agent, scope, ttl_s, contact, metadata } = options;
+    const body = await post(key, `${bare(url)}/v1/tokens`, { agent, scope, ttl_s, contact, metadata }, options.fetch);
+    if (!isMinted(body))
+        throw new Error("the gateway answered /v1/tokens with a shape this package does not know");
+    return body;
+}
+/** Have the agent call `to`. The key needs the `talk` scope; the number must have reached the org before. */
+export async function dial(key, options) {
+    const { url, agent, to, from } = options;
+    const path = `${bare(url)}/v1/agents/${encodeURIComponent(agent)}/dial`;
+    const body = await post(key, path, { to, from }, options.fetch);
+    if (!isDialed(body))
+        throw new Error("the gateway answered the dial with a shape this package does not know");
+    return body;
+}
+async function post(key, url, body, fetcher = fetch) {
+    const answer = await fetcher(url, {
+        method: "POST",
+        headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+    });
+    const text = await answer.text();
+    if (!answer.ok)
+        throw new GatewayRefused(answer.status, detailOf(text));
+    return JSON.parse(text);
+}
+/** FastAPI's `{"detail": "…"}`, when the body is that. A 422's list of problems is not a sentence. */
+function detailOf(text) {
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    return typeof body === "object" && body !== null && "detail" in body && typeof body.detail === "string"
+        ? body.detail
+        : null;
+}
+function bare(url) {
+    return url.replace(/\/+$/, "");
+}
+function isMinted(body) {
+    return hasStrings(body, ["server_url", "participant_token", "call"]);
+}
+function isDialed(body) {
+    return hasStrings(body, ["call", "agent", "to", "from", "env"]);
+}
+function hasStrings(body, fields) {
+    return typeof body === "object" && body !== null && fields.every((field) => typeof Reflect.get(body, field) === "string");
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,20 @@
+/** The primitive under every surface: a value, whoever watches it, and ten paints a second. */
+/** A value that changes, and a way to hear it change. Every state it hands out is a new object. */
+export interface Store<T> {
+    readonly state: T;
+    /** `fn` hears every new state. Returns the call that stops it hearing. */
+    subscribe(fn: (state: T) => void): () => void;
+    /** Nobody hears anything again, and nothing is left running. */
+    close(): void;
+}
+export declare const FRAME_MS = 100;
+/** The writer's side of a store. */
+export interface Cell<T> extends Store<T> {
+    /** Publish now: watchers hear it before this returns. A paint that was waiting rides along. */
+    publish(patch: Partial<T>): void;
+    /** Publish within FRAME_MS: asked for many times in one frame, watchers hear once, the latest. */
+    paint(latest: () => Partial<T>): void;
+}
+/** A store holding `initial`. A patch that changes nothing is not a new state and is not heard. */
+export declare function cell<T extends object>(initial: T): Cell<T>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,mGAAmG;AACnG,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9C,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAID,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,oCAAoC;AACpC,MAAM,WAAW,IAAI,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IACvC,+FAA+F;IAC/F,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACjC,kGAAkG;IAClG,KAAK,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,mGAAmG;AACnG,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CA2C1D"}

package/dist/store.js

@@ -0,0 +1,55 @@
+/** The primitive under every surface: a value, whoever watches it, and ten paints a second. */
+// Ten paints a second. Nobody reads faster than that, and a burst of interim transcripts inside
+// one turn would repaint the whole window dozens of times while somebody is trying to read it.
+export const FRAME_MS = 100;
+/** A store holding `initial`. A patch that changes nothing is not a new state and is not heard. */
+export function cell(initial) {
+    let state = initial;
+    let waiting = null;
+    let frame = null;
+    let closed = false;
+    const watchers = new Set();
+    const publish = (patch) => {
+        if (closed)
+            return;
+        const merged = { ...(waiting === null ? {} : waiting()), ...patch };
+        waiting = null;
+        if (frame !== null)
+            clearTimeout(frame);
+        frame = null;
+        if (Object.entries(merged).every(([key, value]) => Object.is(Reflect.get(state, key), value)))
+            return;
+        state = { ...state, ...merged };
+        for (const watcher of [...watchers])
+            watcher(state);
+    };
+    return {
+        get state() {
+            return state;
+        },
+        subscribe(fn) {
+            if (closed)
+                return () => { };
+            watchers.add(fn);
+            return () => {
+                watchers.delete(fn);
+            };
+        },
+        close() {
+            closed = true;
+            waiting = null;
+            if (frame !== null)
+                clearTimeout(frame);
+            frame = null;
+            watchers.clear();
+        },
+        publish,
+        paint(latest) {
+            if (closed)
+                return;
+            waiting = latest;
+            frame ??= setTimeout(() => publish({}), FRAME_MS);
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAW/F,gGAAgG;AAChG,+FAA+F;AAC/F,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAU5B,mGAAmG;AACnG,MAAM,UAAU,IAAI,CAAmB,OAAU;IAC/C,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,IAAI,OAAO,GAA8B,IAAI,CAAC;IAC9C,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE/C,MAAM,OAAO,GAAG,CAAC,KAAiB,EAAQ,EAAE;QAC1C,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;QACpE,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,KAAK,KAAK,IAAI;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAAE,OAAO;QACtG,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC;QAChC,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,SAAS,CAAC,EAAE;YACV,IAAI,MAAM;gBAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjB,OAAO,GAAG,EAAE;gBACV,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtB,CAAC,CAAC;QACJ,CAAC;QACD,KAAK;YACH,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,KAAK,GAAG,IAAI,CAAC;YACb,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,OAAO;QACP,KAAK,CAAC,MAAM;YACV,IAAI,MAAM;gBAAE,OAAO;YACnB,OAAO,GAAG,MAAM,CAAC;YACjB,KAAK,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC"}