@pinecall/agents 0.9.20

package/dist/call/call.js

@@ -0,0 +1,228 @@
+/** `this.call`: the live call an agent instance serves — its room, turns and verbs. */
+import {} from "../wire/defs.js";
+import { History } from "./history.js";
+import { ParticipantHandle, Room } from "./room.js";
+/** How long `say`/`reply` wait for their `turn.agent` before resolving false. */
+const ACK_MS = 30_000;
+/** Transfer timeout: the far end may ring for 25s before it fails. */
+const TRANSFER_MS = 90_000;
+/** Extra time `attention()` waits beyond `waitS` for the answer entry to arrive. */
+const A_MOMENT_MS = 15_000;
+/** Error when no answer came back: the gateway, not the far end, went quiet. */
+const NO_ANSWER = "the runtime never said how it went";
+/** Error for a pending verb when the call ends first. */
+const THE_CALL_ENDED = "the call ended before it was answered";
+/** Error for `search()` on a call with no gateway (an offline prompt, a test). */
+export const NO_GATEWAY_TO_SEARCH = "this call cannot search: no gateway is serving it";
+/**
+ * One live call. State is reduced from log entries; every verb sends one wire command.
+ * There is no direct LiveKit access.
+ */
+export class CallWorld {
+    out;
+    searching;
+    ackMs;
+    id;
+    contact;
+    from;
+    channel;
+    /** Spoken (`voice`) or written (`text`). A gateway that does not say gets it from the channel. */
+    medium;
+    /** The day this call opened, `YYYY-MM-DD`. */
+    today;
+    /** The page code this call claimed, or null. */
+    claimed = null;
+    room;
+    history = new History();
+    // say/reply settle on the next turn.agent: commands are fire-and-forget, so that entry is the only ack.
+    #speaking = [];
+    // Settled by call.transferred and attention.answered.
+    #transfers = [];
+    #asks = [];
+    /** The event being dispatched, so a write inside onEvent can name its cause. */
+    cause = null;
+    #events = 0;
+    constructor(line, out, searching = null, ackMs = ACK_MS) {
+        this.out = out;
+        this.searching = searching;
+        this.ackMs = ackMs;
+        this.id = line.id;
+        this.contact = line.contact;
+        if (line.from !== undefined)
+            this.from = line.from;
+        if (line.channel !== undefined)
+            this.channel = line.channel;
+        this.medium = line.medium ?? (line.channel === "whatsapp" ? "text" : "voice");
+        if (line.today !== undefined)
+            this.today = line.today;
+        if (line.claimed !== undefined)
+            this.claimed = line.claimed;
+        this.room = new Room(out);
+    }
+    /** Next sequence number for this call's events (independent of the wire's seq). */
+    numbered() {
+        return (this.#events += 1);
+    }
+    /** A handle to one participant, e.g. `call.participant(id).mute()`. */
+    participant(identity) {
+        return new ParticipantHandle(identity, this.out);
+    }
+    /** Send a payload to browsers in the room. The log records its size, not its content. */
+    send(topic, data, options = {}) {
+        this.out("room.send", options.to === undefined ? { topic, data } : { topic, data, to: options.to });
+    }
+    /** Speak this text verbatim. Resolves true once the turn lands, false on timeout. */
+    say(text, options = {}) {
+        this.out("agent.say", { text, ...options });
+        return this.#spoken();
+    }
+    /** Have the model speak, guided by instructions the caller never hears. Resolves like `say`. */
+    reply(instructions, options = {}) {
+        this.out("agent.reply", { instructions, ...options });
+        return this.#spoken();
+    }
+    /**
+     * Search the knowledge bases attached to this agent. The gateway runs the search and logs the
+     * results. `k` defaults to each base's own setting.
+     */
+    search(query, options = {}) {
+        if (this.searching === null)
+            return Promise.reject(new Error(NO_GATEWAY_TO_SEARCH));
+        return this.searching(query, options.k);
+    }
+    /** Invite someone into the room. Same as `room.invite`. */
+    invite(to, options) {
+        this.room.invite(to, options);
+    }
+    /**
+     * Transfer the caller to a number. On a phone call the line is sent on (cold); in a browser the
+     * number is dialled into the call (warm) and the agent goes silent once it answers. `mode`
+     * forces one. `ok: false` means the caller is still with the agent.
+     */
+    transfer(to, options = {}) {
+        this.out("call.transfer", options.mode === undefined ? { to } : { to, mode: options.mode });
+        return this.#answered(this.#transfers, TRANSFER_MS, { to, mode: null, ok: false, error: NO_ANSWER });
+    }
+    /**
+     * Ask for a supervisor. The caller waits (on hold, or unanswered in a thread) until someone takes
+     * the line or `waitS` passes. `reason` is shown to the supervisor. The calling tool runs the
+     * whole time, so give it a `timeout` longer than `waitS`.
+     */
+    attention(reason, options) {
+        this.out("call.attention", { reason, waitS: options.waitS });
+        const lapsed = { ok: false, by: null, error: NO_ANSWER };
+        return this.#answered(this.#asks, options.waitS * 1000 + A_MOMENT_MS, lapsed);
+    }
+    /** Put the caller on hold: they hear hold music and the agent neither speaks nor listens. */
+    hold() {
+        this.out("call.hold", {});
+    }
+    /** Take the caller off hold. */
+    unhold() {
+        this.out("call.unhold", {});
+    }
+    /** Send DTMF tones: `0-9`, `*`, `#`, and `,` for a pause. */
+    dtmf(digits) {
+        this.out("call.dtmf", { digits });
+    }
+    /**
+     * Bind this call to the code shown on the caller's page, so the page follows the call. Sets
+     * `claimed` on `call.claimed`; an unknown, expired or taken code is refused with `no_code`.
+     */
+    claim(code) {
+        this.out("call.claim", { code });
+    }
+    /** Record a callback request in the call log for your backend to dial. */
+    callback(number, options = {}) {
+        this.out("call.callback", { number, ...options });
+    }
+    /**
+     * The caller asked never to be called again: their number joins the org's do-not-call list, and
+     * no call of the org reaches it until a consent is recorded. Tell them it is done.
+     */
+    optOut(note) {
+        this.out("call.opt_out", note === undefined ? {} : { note });
+    }
+    /** End the call. Say goodbye before calling this; nothing after it is heard. */
+    hangup(reason) {
+        this.out("call.hangup", reason === undefined ? {} : { reason });
+    }
+    /** Fold one log entry into the room and history. Unknown types are ignored. */
+    take(type, data, at) {
+        switch (type) {
+            case "participant.joined":
+                return this.room.joined({
+                    identity: String(data["identity"]),
+                    kind: data["kind"],
+                    ...(typeof data["name"] === "string" ? { name: data["name"] } : {}),
+                }, at);
+            case "call.claimed":
+                this.claimed = String(data["code"]);
+                return;
+            case "participant.left":
+                return this.room.left(String(data["identity"]));
+            case "participant.speaking":
+                return this.room.speaking(String(data["identity"]), data["speaking"] === true);
+            case "turn.user":
+                return this.history.took({ who: "user", text: String(data["text"] ?? ""), speechId: String(data["speech_id"] ?? data["speechId"] ?? ""), interrupted: false, at });
+            case "turn.agent":
+                this.history.took({ who: "agent", text: String(data["text"] ?? ""), speechId: String(data["speech_id"] ?? data["speechId"] ?? ""), interrupted: data["interrupted"] === true, at });
+                return this.#settle(true);
+            case "call.transferred":
+                return settle(this.#transfers, {
+                    to: String(data["to"] ?? ""),
+                    mode: (data["mode"] ?? null),
+                    ok: data["ok"] === true,
+                    ...(typeof data["error"] === "string" ? { error: data["error"] } : {}),
+                });
+            case "attention.answered":
+                return settle(this.#asks, {
+                    ok: data["ok"] === true,
+                    by: (data["by"] ?? null),
+                    ...(typeof data["error"] === "string" ? { error: data["error"] } : {}),
+                });
+            // Settle every pending verb now instead of waiting for its timeout.
+            case "call.ended":
+                this.#settle(false);
+                settle(this.#transfers, { to: "", mode: null, ok: false, error: THE_CALL_ENDED });
+                settle(this.#asks, { ok: false, by: null, error: THE_CALL_ENDED });
+                return;
+            default:
+                return;
+        }
+    }
+    #spoken() {
+        return new Promise((resolve) => {
+            this.#speaking.push(resolve);
+            // Resolve false rather than reject: a hang-up mid-sentence is not an error the tool can handle.
+            setTimeout(() => {
+                this.#speaking = this.#speaking.filter((waiting) => waiting !== resolve);
+                resolve(false);
+            }, this.ackMs).unref?.();
+        });
+    }
+    #settle(spoken) {
+        const waiting = this.#speaking;
+        this.#speaking = [];
+        for (const resolve of waiting)
+            resolve(spoken);
+    }
+    // The runtime always answers via a log entry; the ceiling only guards against a gateway that went away.
+    #answered(waiting, ceiling, lapsed) {
+        return new Promise((resolve) => {
+            waiting.push(resolve);
+            setTimeout(() => {
+                const index = waiting.indexOf(resolve);
+                if (index >= 0)
+                    waiting.splice(index, 1);
+                resolve(lapsed);
+            }, ceiling).unref?.();
+        });
+    }
+}
+function settle(waiting, answer) {
+    const resolvers = waiting.splice(0, waiting.length);
+    for (const resolve of resolvers)
+        resolve(answer);
+}
+//# sourceMappingURL=call.js.map

package/dist/call/call.js.map

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

package/dist/call/history.d.ts

@@ -0,0 +1,28 @@
+/** The call's finished turns, and an optional summary that replaces older ones. */
+/** One finished turn from `turn.user` or `turn.agent`. Metrics stay in the log. */
+export interface Turn {
+    who: "user" | "agent";
+    text: string;
+    /** Links a caller's turn to the reply it triggered. */
+    speechId: string;
+    /** True when the caller interrupted the agent; always false for user turns. */
+    interrupted: boolean;
+    at: number;
+}
+/** The call's finished turns, oldest first. A turn still being spoken is not included. */
+export declare class History {
+    #private;
+    /** Every finished turn, oldest first. */
+    get turns(): readonly Turn[];
+    /** Number of turns kept. */
+    get length(): number;
+    /** The summary left by `collapse()`, or null. */
+    get summary(): string | null;
+    /** The most recent turn. */
+    get last(): Turn | undefined;
+    /** Append a finished turn. Called by the bridge only. */
+    took(turn: Turn): void;
+    /** Replace all turns with a summary. Affects the view only; the call log keeps every turn. */
+    collapse(summary: string): void;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/call/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/call/history.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,mFAAmF;AACnF,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,0FAA0F;AAC1F,qBAAa,OAAO;;IAIlB,yCAAyC;IACzC,IAAI,KAAK,IAAI,SAAS,IAAI,EAAE,CAE3B;IAED,4BAA4B;IAC5B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,iDAAiD;IACjD,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,4BAA4B;IAC5B,IAAI,IAAI,IAAI,IAAI,GAAG,SAAS,CAE3B;IAED,yDAAyD;IACzD,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAErB;IAED,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9B;CACF"}

package/dist/call/history.js

@@ -0,0 +1,32 @@
+/** The call's finished turns, and an optional summary that replaces older ones. */
+/** The call's finished turns, oldest first. A turn still being spoken is not included. */
+export class History {
+    #turns = [];
+    #summary = null;
+    /** Every finished turn, oldest first. */
+    get turns() {
+        return this.#turns;
+    }
+    /** Number of turns kept. */
+    get length() {
+        return this.#turns.length;
+    }
+    /** The summary left by `collapse()`, or null. */
+    get summary() {
+        return this.#summary;
+    }
+    /** The most recent turn. */
+    get last() {
+        return this.#turns[this.#turns.length - 1];
+    }
+    /** Append a finished turn. Called by the bridge only. */
+    took(turn) {
+        this.#turns.push(turn);
+    }
+    /** Replace all turns with a summary. Affects the view only; the call log keeps every turn. */
+    collapse(summary) {
+        this.#turns.length = 0;
+        this.#summary = summary;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/call/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/call/history.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAanF,0FAA0F;AAC1F,MAAM,OAAO,OAAO;IACT,MAAM,GAAW,EAAE,CAAC;IAC7B,QAAQ,GAAkB,IAAI,CAAC;IAE/B,yCAAyC;IACzC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC,IAAU;QACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,8FAA8F;IAC9F,QAAQ,CAAC,OAAe;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;CACF"}

package/dist/call/room.d.ts

@@ -0,0 +1,56 @@
+/** The call's room: its participants and the commands that act on them. */
+import { type Camel, type CommandData } from "../wire/codec.js";
+import { type CommandType } from "../wire/registry.js";
+/** A participant's role in the call (protocol/schema/defs.json). */
+export type ParticipantKind = "caller" | "agent" | "supervisor" | "listener" | "sip";
+/** One participant in the room. */
+export interface Participant {
+    identity: string;
+    kind: ParticipantKind;
+    name?: string;
+    /** Join time from `participant.joined`, in ms. */
+    joinedAt: number;
+    /** Current voice activity, from `participant.speaking`. */
+    speaking: boolean;
+}
+/** Sends one command on the wire, bound to its call. */
+export type Commander = <K extends CommandType>(type: K, data: Camel<CommandData<K>>) => void;
+/** Commands for one participant. Returned by `call.participant(identity)`. */
+export declare class ParticipantHandle {
+    readonly identity: string;
+    private readonly send;
+    constructor(identity: string, send: Commander);
+    /** Mute for the rest of the call. There is no unmute; invite the leg again instead. */
+    mute(): void;
+    /** Remove from the room. Removing the caller ends the call. */
+    remove(): void;
+}
+/** Current participants, reduced from the room's log entries. Reads are local; verbs send commands. */
+export declare class Room {
+    #private;
+    private readonly send;
+    constructor(send: Commander);
+    /** Participants in join order. */
+    get participants(): Participant[];
+    /** The caller, if one has joined. */
+    get caller(): Participant | undefined;
+    /** Whether a participant of this kind is present, e.g. `has("supervisor")`. */
+    has(kind: ParticipantKind): boolean;
+    /** A participant by identity. */
+    get(identity: string): Participant | undefined;
+    /** Invite a number as a SIP leg, or an identity as a participant. */
+    invite(to: string, options: {
+        kind: "sip" | "participant";
+    }): void;
+    /** Record a join. Re-joining under the same identity replaces the entry. */
+    joined(data: {
+        identity: string;
+        kind: ParticipantKind;
+        name?: string;
+    }, at: number): void;
+    /** Record a departure. */
+    left(identity: string): void;
+    /** Update voice activity. Unknown identities are ignored. */
+    speaking(identity: string, speaking: boolean): void;
+}
+//# sourceMappingURL=room.d.ts.map

package/dist/call/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../src/call/room.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAErF,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE9F,8EAA8E;AAC9E,qBAAa,iBAAiB;IAE1B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFvB,YACW,QAAQ,EAAE,MAAM,EACR,IAAI,EAAE,SAAS,EAC9B;IAEJ,uFAAuF;IACvF,IAAI,IAAI,IAAI,CAEX;IAED,+DAA+D;IAC/D,MAAM,IAAI,IAAI,CAEb;CACF;AAED,uGAAuG;AACvG,qBAAa,IAAI;;IAGH,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,SAAS,EAAI;IAEhD,kCAAkC;IAClC,IAAI,YAAY,IAAI,WAAW,EAAE,CAEhC;IAED,qCAAqC;IACrC,IAAI,MAAM,IAAI,WAAW,GAAG,SAAS,CAEpC;IAED,+EAA+E;IAC/E,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAElC;IAED,iCAAiC;IACjC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7C;IAED,qEAAqE;IACrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,aAAa,CAAA;KAAE,GAAG,IAAI,CAEjE;IAED,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIzF;IAED,0BAA0B;IAC1B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAGlD;CACF"}

package/dist/call/room.js

@@ -0,0 +1,66 @@
+/** The call's room: its participants and the commands that act on them. */
+import {} from "../wire/codec.js";
+import {} from "../wire/registry.js";
+/** Commands for one participant. Returned by `call.participant(identity)`. */
+export class ParticipantHandle {
+    identity;
+    send;
+    constructor(identity, send) {
+        this.identity = identity;
+        this.send = send;
+    }
+    /** Mute for the rest of the call. There is no unmute; invite the leg again instead. */
+    mute() {
+        this.send("participant.mute", { identity: this.identity });
+    }
+    /** Remove from the room. Removing the caller ends the call. */
+    remove() {
+        this.send("participant.remove", { identity: this.identity });
+    }
+}
+/** Current participants, reduced from the room's log entries. Reads are local; verbs send commands. */
+export class Room {
+    send;
+    #participants = new Map();
+    constructor(send) {
+        this.send = send;
+    }
+    /** Participants in join order. */
+    get participants() {
+        return [...this.#participants.values()];
+    }
+    /** The caller, if one has joined. */
+    get caller() {
+        return this.participants.find((one) => one.kind === "caller");
+    }
+    /** Whether a participant of this kind is present, e.g. `has("supervisor")`. */
+    has(kind) {
+        return this.participants.some((one) => one.kind === kind);
+    }
+    /** A participant by identity. */
+    get(identity) {
+        return this.#participants.get(identity);
+    }
+    /** Invite a number as a SIP leg, or an identity as a participant. */
+    invite(to, options) {
+        this.send("room.invite", { to, kind: options.kind });
+    }
+    /** Record a join. Re-joining under the same identity replaces the entry. */
+    joined(data, at) {
+        const one = { identity: data.identity, kind: data.kind, joinedAt: at, speaking: false };
+        if (data.name !== undefined)
+            one.name = data.name;
+        this.#participants.set(data.identity, one);
+    }
+    /** Record a departure. */
+    left(identity) {
+        this.#participants.delete(identity);
+    }
+    /** Update voice activity. Unknown identities are ignored. */
+    speaking(identity, speaking) {
+        const one = this.#participants.get(identity);
+        if (one !== undefined)
+            one.speaking = speaking;
+    }
+}
+//# sourceMappingURL=room.js.map

package/dist/call/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../src/call/room.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAgC,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAoB,MAAM,qBAAqB,CAAC;AAmBvD,8EAA8E;AAC9E,MAAM,OAAO,iBAAiB;IAEjB,QAAQ;IACA,IAAI;IAFvB,YACW,QAAgB,EACR,IAAe;wBADvB,QAAQ;oBACA,IAAI;IACpB,CAAC;IAEJ,uFAAuF;IACvF,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,+DAA+D;IAC/D,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,uGAAuG;AACvG,MAAM,OAAO,IAAI;IAGc,IAAI;IAFxB,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IAExD,YAA6B,IAAe;oBAAf,IAAI;IAAc,CAAC;IAEhD,kCAAkC;IAClC,IAAI,YAAY;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,+EAA+E;IAC/E,GAAG,CAAC,IAAqB;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,iCAAiC;IACjC,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,EAAU,EAAE,OAAwC;QACzD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,IAAgE,EAAE,EAAU;QACjF,MAAM,GAAG,GAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACrG,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAClD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,QAAgB;QACnB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,QAAgB,EAAE,QAAiB;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACjD,CAAC;CACF"}

package/dist/client/agent.d.ts

@@ -0,0 +1,93 @@
+import { type AgentConfig } from "../wire/agent-config.js";
+import { type Camel, type CommandData } from "../wire/codec.js";
+import { type DevVerb, type ToolSpec } from "../wire/defs.js";
+import { type Entry } from "../wire/envelope.js";
+import { type CommandType, type EventType } from "../wire/registry.js";
+import { Call, CallBook, type CallGateway } from "./calls.js";
+import { type AnyListener, type CamelEvent, type Listener, type Payload } from "./listeners.js";
+/** A tool: the spec the model sees and the function that runs when it is called. */
+export interface Tool extends Camel<ToolSpec> {
+    run: (args: Record<string, unknown>, call: Call) => unknown;
+}
+/** An agent's declaration plus its tools' code. */
+export interface AgentOptions extends Omit<Camel<AgentConfig>, "tools"> {
+    tools?: Tool[];
+    /**
+     * Whether the gateway may route calls that name no app (phone calls, most web calls) to this
+     * socket. Defaults to true; a console such as `pinecall chat` passes false.
+     */
+    takesUnclaimed?: boolean;
+    /**
+     * Whether this socket answers the console's dev verbs for the agent, beside the process serving
+     * its calls. Such a socket declares nothing: it never sends `agent.configure`.
+     */
+    answersDev?: boolean;
+}
+/** The client-side socket an agent sends frames through. */
+export interface AgentGateway {
+    send<K extends CommandType>(type: K, agent: string, call: string | null, data: Camel<CommandData<K>>, id: string): void;
+    seen(event: CamelEvent, call: Call | null): void;
+    onError(error: Error): void;
+    readonly sdk: string;
+    readonly host: string;
+}
+/**
+ * Handles a console's `dev.request`. Resolve with the answer, or throw `DevRefused` to refuse with
+ * a status; any other error reaches the console as a 500.
+ */
+export type DevHandler = (verb: DevVerb, data: Record<string, unknown>) => Promise<Record<string, unknown>>;
+/**
+ * An agent, from the app's side.
+ *
+ * The gateway's registry is in memory, so the declaration is re-sent on every reconnect. Several
+ * sockets may hold one agent; unclaimed calls go to the newest one that takes them, so a rolling
+ * deploy serves as soon as the new process registers. Call `drain()` before exiting to hand live
+ * calls over instead of cutting them.
+ */
+export declare class Agent implements CallGateway {
+    #private;
+    readonly slug: string;
+    private readonly gateway;
+    readonly calls: CallBook;
+    constructor(slug: string, options: AgentOptions, gateway: AgentGateway);
+    /** The agent's current declaration, in wire shape. */
+    get config(): Camel<AgentConfig>;
+    /**
+     * This socket's app id as minted by the gateway, or undefined before the first register. A call
+     * that names it (`WS /v1/chat?app=<id>`, `app` in `POST /v1/calls`) is served by this process.
+     */
+    get app(): string | undefined;
+    /** Listen for one event type across every call of this agent. `null` for the agent's own log. */
+    on<K extends EventType>(type: K, listener: Listener<K, Call | null>): () => void;
+    /** Listen for every event of this agent. The returned function stops listening. */
+    onAny(listener: AnyListener<Call | null>): () => void;
+    /**
+     * Handle `dev.request` asks relayed from a console. `pinecall start` registers one; without it
+     * every ask is refused with 501.
+     */
+    onDev(handler: DevHandler): void;
+    /** Replace the tools. The next `configure` sends the new declaration. */
+    declare(tools: Tool[]): void;
+    /** Update the declaration. Only the given fields change; live calls keep their session. */
+    configure(changes?: Partial<Camel<AgentConfig>>): Promise<Payload<"agent.configured">>;
+    /** Register the slug, then send the declaration. Runs again on every reconnect. */
+    open(): Promise<void>;
+    /** Fold one entry into its call and dispatch it to listeners. */
+    take(entry: Entry): void;
+    /** Send one command on this agent's behalf. */
+    command<K extends CommandType>(type: K, call: string | null, data: Camel<CommandData<K>>): void;
+    /** Report an error no caller is waiting on. */
+    onError(error: Error): void;
+    /**
+     * Stop receiving new calls and hand live ones to another holder (or park them for the next).
+     * Running tools still answer. Resolves with where the calls went.
+     */
+    drain(answerMs?: number): Promise<Payload<"agent.draining">>;
+    /** Number of tool runs in progress. */
+    get inFlight(): number;
+    /** Resolve once every running tool has sent its tool.result. */
+    settled(): Promise<void>;
+    /** Send `ping`; the gateway answers with `pong`. */
+    ping(): void;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/client/agent.d.ts.map

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