pinecall 0.1.0

package/dist/call/room.d.ts

@@ -0,0 +1,58 @@
+/** The room as a value: who is in it, and the four verbs the wire lets the agent use on them. */
+import type { Camel, CommandData, CommandType } from "@pinecall/protocol";
+/** Who a participant is to the call. The wire's five kinds, from protocol/schema/defs.json. */
+export type ParticipantKind = "caller" | "agent" | "supervisor" | "listener" | "sip";
+/** One participant, as the room's own facts describe them. */
+export interface Participant {
+    identity: string;
+    kind: ParticipantKind;
+    name?: string;
+    /** When participant.joined said so, in ms. */
+    joinedAt: number;
+    /** The room's voice activity for them right now; false until participant.speaking says otherwise. */
+    speaking: boolean;
+}
+/** How a call puts one command on the wire, already bound to the call it belongs to. */
+export type Commander = <K extends CommandType>(type: K, data: Camel<CommandData<K>>) => void;
+/** One participant, and what may be done to them. Returned by `call.participant(identity)`. */
+export declare class ParticipantHandle {
+    readonly identity: string;
+    private readonly send;
+    constructor(identity: string, send: Commander);
+    /** Silence them for the rest of the call. There is no unmute: a leg that must speak is invited again. */
+    mute(): void;
+    /** Put them out of the room. Removing the caller ends the call. */
+    remove(): void;
+}
+/**
+ * Who is in the room right now, reduced from the room's own entries — never asked of LiveKit,
+ * which the class does not know exists. Reading it is free; the verbs are commands.
+ */
+export declare class Room {
+    #private;
+    private readonly send;
+    constructor(send: Commander);
+    /** Everybody in the room, in the order they joined. */
+    get participants(): Participant[];
+    /** The person the agent is serving, when the room has named one. */
+    get caller(): Participant | undefined;
+    /** Whether anybody of this kind is in the room: `has("supervisor")` is the question worth asking. */
+    has(kind: ParticipantKind): boolean;
+    /** One participant by identity, as the room last saw them. */
+    get(identity: string): Participant | undefined;
+    /** Bring somebody else in: a number as a second SIP leg, or an identity as a seat. */
+    invite(to: string, options: {
+        kind: "sip" | "participant";
+    }): void;
+    /** Somebody joined. Re-joining under the same identity replaces the row rather than doubling it. */
+    joined(data: {
+        identity: string;
+        kind: ParticipantKind;
+        name?: string;
+    }, at: number): void;
+    /** Somebody left; they are gone from the room, and the log still remembers they were here. */
+    left(identity: string): void;
+    /** The room's voice activity for one participant flipped. 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,iGAAiG;AAEjG,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1E,+FAA+F;AAC/F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAErF,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,qGAAqG;IACrG,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wFAAwF;AACxF,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,+FAA+F;AAC/F,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,yGAAyG;IACzG,IAAI,IAAI,IAAI,CAEX;IAED,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAEb;CACF;AAED;;;GAGG;AACH,qBAAa,IAAI;;IAGH,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,SAAS,EAAI;IAEhD,uDAAuD;IACvD,IAAI,YAAY,IAAI,WAAW,EAAE,CAEhC;IAED,oEAAoE;IACpE,IAAI,MAAM,IAAI,WAAW,GAAG,SAAS,CAEpC;IAED,qGAAqG;IACrG,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAElC;IAED,8DAA8D;IAC9D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7C;IAED,sFAAsF;IACtF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,aAAa,CAAA;KAAE,GAAG,IAAI,CAEjE;IAID,oGAAoG;IACpG,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,8FAA8F;IAC9F,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAGlD;CACF"}

package/dist/call/room.js

@@ -0,0 +1,68 @@
+/** The room as a value: who is in it, and the four verbs the wire lets the agent use on them. */
+/** One participant, and what may be done to them. Returned by `call.participant(identity)`. */
+export class ParticipantHandle {
+    identity;
+    send;
+    constructor(identity, send) {
+        this.identity = identity;
+        this.send = send;
+    }
+    /** Silence them for the rest of the call. There is no unmute: a leg that must speak is invited again. */
+    mute() {
+        this.send("participant.mute", { identity: this.identity });
+    }
+    /** Put them out of the room. Removing the caller ends the call. */
+    remove() {
+        this.send("participant.remove", { identity: this.identity });
+    }
+}
+/**
+ * Who is in the room right now, reduced from the room's own entries — never asked of LiveKit,
+ * which the class does not know exists. Reading it is free; the verbs are commands.
+ */
+export class Room {
+    send;
+    #participants = new Map();
+    constructor(send) {
+        this.send = send;
+    }
+    /** Everybody in the room, in the order they joined. */
+    get participants() {
+        return [...this.#participants.values()];
+    }
+    /** The person the agent is serving, when the room has named one. */
+    get caller() {
+        return this.participants.find((one) => one.kind === "caller");
+    }
+    /** Whether anybody of this kind is in the room: `has("supervisor")` is the question worth asking. */
+    has(kind) {
+        return this.participants.some((one) => one.kind === kind);
+    }
+    /** One participant by identity, as the room last saw them. */
+    get(identity) {
+        return this.#participants.get(identity);
+    }
+    /** Bring somebody else in: a number as a second SIP leg, or an identity as a seat. */
+    invite(to, options) {
+        this.send("room.invite", { to, kind: options.kind });
+    }
+    // ── what the room's entries teach it ────────────────────────────────────────
+    /** Somebody joined. Re-joining under the same identity replaces the row rather than doubling it. */
+    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);
+    }
+    /** Somebody left; they are gone from the room, and the log still remembers they were here. */
+    left(identity) {
+        this.#participants.delete(identity);
+    }
+    /** The room's voice activity for one participant flipped. 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,iGAAiG;AAqBjG,+FAA+F;AAC/F,MAAM,OAAO,iBAAiB;IAEjB,QAAQ;IACA,IAAI;IAFvB,YACW,QAAgB,EACR,IAAe;wBADvB,QAAQ;oBACA,IAAI;IACpB,CAAC;IAEJ,yGAAyG;IACzG,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,mEAAmE;IACnE,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,IAAI;IAGc,IAAI;IAFxB,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IAExD,YAA6B,IAAe;oBAAf,IAAI;IAAc,CAAC;IAEhD,uDAAuD;IACvD,IAAI,YAAY;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,oEAAoE;IACpE,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,qGAAqG;IACrG,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,8DAA8D;IAC9D,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,sFAAsF;IACtF,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,+EAA+E;IAE/E,oGAAoG;IACpG,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,8FAA8F;IAC9F,IAAI,CAAC,QAAgB;QACnB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,6FAA6F;IAC7F,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/cli/browser.d.ts

@@ -0,0 +1,8 @@
+/** Opening a URL in whatever this machine calls a browser, and saying so when it has none. */
+/**
+ * Try to put this URL in front of the person. Whether it worked is not knowable and does not
+ * matter: the URL is printed either way, and a terminal on a server with no browser — over SSH,
+ * in a container — is the case this flow exists to serve. The person opens it wherever they are.
+ */
+export declare function openInABrowser(url: string, platform?: string): void;
+//# sourceMappingURL=browser.d.ts.map

package/dist/cli/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/cli/browser.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAa9F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAyB,GAAG,IAAI,CASrF"}

package/dist/cli/browser.js

@@ -0,0 +1,27 @@
+/** Opening a URL in whatever this machine calls a browser, and saying so when it has none. */
+import { spawn } from "node:child_process";
+// One command per platform, and nothing clever: `open` is macOS's, `xdg-open` is the freedesktop
+// standard every Linux desktop implements, and `start` is cmd's built-in — which is why Windows
+// needs a shell to run it and the other two do not.
+const OPENERS = {
+    darwin: ["open", []],
+    win32: ["cmd", ["/c", "start", ""]],
+};
+const ELSEWHERE = ["xdg-open", []];
+/**
+ * Try to put this URL in front of the person. Whether it worked is not knowable and does not
+ * matter: the URL is printed either way, and a terminal on a server with no browser — over SSH,
+ * in a container — is the case this flow exists to serve. The person opens it wherever they are.
+ */
+export function openInABrowser(url, platform = process.platform) {
+    const [command, args] = OPENERS[platform] ?? ELSEWHERE;
+    try {
+        // Detached and with both ends of its output thrown away: a browser that writes to stderr must
+        // not land in the middle of the terminal's own lines, and this process must not wait for it.
+        spawn(command, [...args, url], { detached: true, stdio: "ignore" }).unref();
+    }
+    catch {
+        // A machine with no such command is a machine where the printed URL is the whole answer.
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/cli/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/cli/browser.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,iGAAiG;AACjG,gGAAgG;AAChG,oDAAoD;AACpD,MAAM,OAAO,GAAuC;IAClD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;CACpC,CAAC;AACF,MAAM,SAAS,GAAuB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAAQ,GAAW,OAAO,CAAC,QAAQ;IAC7E,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;IACvD,IAAI,CAAC;QACH,8FAA8F;QAC9F,6FAA6F;QAC7F,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,yFAAyF;IAC3F,CAAC;AACH,CAAC"}

package/dist/cli/callbacks.d.ts

@@ -0,0 +1,26 @@
+/** `pinecall callbacks`: the numbers people left when the fleet was full, for this org's app to dial. */
+import type { Group } from "./groups.js";
+import { type Door } from "./testing/gateway.js";
+/** One request as the gateway lists it: the event's fields, plus where and when it was written. */
+export interface Callback {
+    position: number;
+    agent: string;
+    ts: number;
+    channel: string;
+    number: string;
+    via: "overflow" | "widget";
+    call: string | null;
+}
+interface Page {
+    requests: Callback[];
+    next: number | null;
+}
+export declare const group: Group;
+/** Resolve the door, read the page, print one line per request. */
+export declare function run(argv: string[], out?: NodeJS.WritableStream, err?: NodeJS.WritableStream, env?: NodeJS.ProcessEnv): Promise<number>;
+/** The page the gateway answers for these query parameters. */
+export declare function callbacks(door: Door, query: URLSearchParams): Promise<Page>;
+/** One request as a person reads it: when, who, the number, and who took it. */
+export declare function lineOf(one: Callback): string;
+export {};
+//# sourceMappingURL=callbacks.d.ts.map

package/dist/cli/callbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../src/cli/callbacks.ts"],"names":[],"mappings":"AAAA,yGAAyG;AAGzG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAMxD,mGAAmG;AACnG,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,IAAI;IACZ,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,KAAK,EAAE,KAQnB,CAAC;AAEF,mEAAmE;AACnE,wBAAsB,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,MAAM,CAAC,cAA+B,EAC3C,GAAG,GAAE,MAAM,CAAC,cAA+B,EAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,+DAA+D;AAC/D,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAI5C"}

package/dist/cli/callbacks.js

@@ -0,0 +1,68 @@
+/** `pinecall callbacks`: the numbers people left when the fleet was full, for this org's app to dial. */
+import { doorLine, theDoor } from "./env.js";
+import { notASlug } from "./load.js";
+import { asked } from "./testing/gateway.js";
+import { refusal } from "./whoami.js";
+// The door, written once: every request the org's agents took, oldest first, with a cursor.
+const CALLBACKS = "/v1/callbacks";
+export const group = {
+    purpose: "the numbers people left when every seat was taken: who to call back",
+    usage: `usage: pinecall callbacks [--agent <slug>] [--after <cursor>]
+
+  Every callback.requested this org's agents wrote — a phone caller the overflow agent answered,
+  or a web visitor who left a number at the widget — oldest first, with the cursor the next page
+  starts at. The runtime records them; dialing back is your app's.`,
+    run,
+};
+/** Resolve the door, read the page, print one line per request. */
+export async function run(argv, out = process.stdout, err = process.stderr, env = process.env) {
+    const door = theDoor(env, err);
+    if (door === undefined)
+        return 2;
+    const query = new URLSearchParams();
+    const agent = flag(argv, "--agent");
+    const aFile = notASlug(agent);
+    if (aFile !== undefined) {
+        err.write(`${aFile}\n`);
+        return 2;
+    }
+    const after = flag(argv, "--after");
+    if (agent !== undefined)
+        query.set("agent", agent);
+    if (after !== undefined)
+        query.set("after", after);
+    let page;
+    try {
+        page = await callbacks(door, query);
+    }
+    catch (refused) {
+        err.write(`${refusal(refused)}\n`);
+        return 1;
+    }
+    out.write(`${doorLine(door)}\n`);
+    if (page.requests.length === 0) {
+        out.write("nobody is waiting for a call back\n");
+        return 0;
+    }
+    for (const one of page.requests)
+        out.write(`${lineOf(one)}\n`);
+    if (page.next !== null)
+        out.write(`more: --after ${page.next}\n`);
+    return 0;
+}
+/** The page the gateway answers for these query parameters. */
+export async function callbacks(door, query) {
+    const suffix = query.size === 0 ? "" : `?${query.toString()}`;
+    return await asked(door, `${CALLBACKS}${suffix}`);
+}
+/** One request as a person reads it: when, who, the number, and who took it. */
+export function lineOf(one) {
+    const when = new Date(one.ts * 1000).toISOString().slice(0, 16).replace("T", " ");
+    const took = one.via === "overflow" ? `overflow on ${one.call ?? "?"}` : "the widget";
+    return `${when}  ${one.agent}  ${one.number}  ${one.channel}  via ${took}`;
+}
+function flag(argv, name) {
+    const at = argv.indexOf(name);
+    return at === -1 ? undefined : argv[at + 1];
+}
+//# sourceMappingURL=callbacks.js.map

package/dist/cli/callbacks.js.map

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

package/dist/cli/chat.d.ts

@@ -0,0 +1,21 @@
+/** `pinecall chat [agent]`: this directory's agent in this process, or a written call at one already held. */
+import type { Group } from "./groups.js";
+export declare const group: Group;
+/**
+ * One process, both sides: the app socket registers the agent, and `WS /v1/chat?agent=<slug>` is
+ * the caller. Typing goes out as `{ text }`; everything that comes back is the call's own log,
+ * printed as it lands. The tools run in this process, so a breakpoint in a @tool is reachable.
+ *
+ * This is `rails console`: it works with no `pinecall run` up and it works with three of them,
+ * because the caller socket names THIS process's app id and the gateway serves the call from it.
+ *
+ * Named an agent instead, it mounts nothing and is only the caller's side: a written call at
+ * whatever is holding that slug — your own `run` in the other terminal, or a colleague's. The
+ * positional is a SLUG and `--file` is the file, because `--agent` meaning one thing in three
+ * verbs and the other in six was a flag nobody could read.
+ */
+export declare function run(argv: string[]): Promise<number>;
+/** The chat socket's address off the gateway's HTTP one: the scheme flips, the path is fixed. */
+export declare function chatUrl(base: string, agent: string, app?: string, contact?: string): string;
+export declare function lineOf(frame: string): string | null;
+//# sourceMappingURL=chat.d.ts.map

package/dist/cli/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/cli/chat.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAU9G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQzC,eAAO,MAAM,KAAK,EAAE,KAkBnB,CAAC;AASF;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEzD;AAED,iGAAiG;AACjG,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAc3F;AAoED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnD"}

package/dist/cli/chat.js

@@ -0,0 +1,214 @@
+/** `pinecall chat [agent]`: this directory's agent in this process, or a written call at one already held. */
+import { createInterface } from "node:readline";
+import { parseArgs } from "node:util";
+import { Pinecall } from "../client/index.js";
+import WebSocket from "ws";
+import { mount } from "../runtime/connect.js";
+import { theDoor } from "./env.js";
+import { load, mountOptions, notASlug } from "./load.js";
+import { cannotTell, ENV_FLAG, notThisWorld, standing } from "./world.js";
+import { BROKE, CALLER, lineFor } from "./view.js";
+import { firstState } from "./prompt.js";
+const PROMPT = `${CALLER} `;
+export const group = {
+    purpose: "the app in this terminal's own process, and a prompt against it",
+    usage: `usage: pinecall chat [agent] [--file agent.tsx] [--as <contact>] [--state file [--case n]]
+
+  With nothing after it: the agent of this directory, mounted in THIS process, and a written
+  caller against it. The tools run here, so a breakpoint in a @tool is reachable.
+
+  With an agent's slug: a written call at the agent somebody is already holding — your own
+  \`pinecall run\` in another terminal, or a colleague's. Nothing is mounted here, so --state,
+  which opens a call in a class this process built, is refused.
+
+  --file <path>   which class to mount, when the directory holds more than one
+  --env <world>   the world you believe this key opens; refused when it opens the other
+  --as <contact>  who is calling: the id memory files this call under (a phone number, a customer id)
+  --state file    the state the call opens in — the same goldens file \`pinecall prompt\` reads
+  --case n        which case of that file, when it holds several
+  --events        one JSON line per log entry instead of the lines, for a pipe`,
+    run,
+};
+// --state is applied through mount's `opening` seam, which only exists in a class THIS process
+// built. Reaching an agent somebody else is holding, there is no such seam and no honest place to
+// put the state, so it is refused rather than silently dropped.
+const NOT_YOURS_TO_OPEN = "--state opens a call in a class this process mounted, and `pinecall chat <agent>` mounts none:"
+    + " drop the slug to chat the agent of this directory.";
+/**
+ * One process, both sides: the app socket registers the agent, and `WS /v1/chat?agent=<slug>` is
+ * the caller. Typing goes out as `{ text }`; everything that comes back is the call's own log,
+ * printed as it lands. The tools run in this process, so a breakpoint in a @tool is reachable.
+ *
+ * This is `rails console`: it works with no `pinecall run` up and it works with three of them,
+ * because the caller socket names THIS process's app id and the gateway serves the call from it.
+ *
+ * Named an agent instead, it mounts nothing and is only the caller's side: a written call at
+ * whatever is holding that slug — your own `run` in the other terminal, or a colleague's. The
+ * positional is a SLUG and `--file` is the file, because `--agent` meaning one thing in three
+ * verbs and the other in six was a flag nobody could read.
+ */
+export async function run(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            state: { type: "string" },
+            case: { type: "string" },
+            as: { type: "string" },
+            file: { type: "string" },
+            events: { type: "boolean", default: false },
+            ...ENV_FLAG,
+        },
+    });
+    const reach = positionals[0];
+    const aFile = notASlug(reach);
+    if (aFile !== undefined) {
+        process.stderr.write(`${aFile}\n`);
+        return 2;
+    }
+    if (reach !== undefined && values.state !== undefined) {
+        process.stderr.write(`${NOT_YOURS_TO_OPEN}\n`);
+        return 2;
+    }
+    const door = theDoor();
+    if (door === undefined)
+        return 2;
+    try {
+        const elsewhere = notThisWorld("chat", await standing(door), values.env);
+        if (elsewhere !== undefined) {
+            process.stderr.write(`${elsewhere}\n`);
+            return 2;
+        }
+    }
+    catch (failed) {
+        process.stderr.write(`${cannotTell("chat", failed)}\n`);
+        return 2;
+    }
+    const url = door.url;
+    if (reach !== undefined) {
+        return await talk(chatUrl(url, reach, undefined, values.as), door.apiKey, values.events === true);
+    }
+    const loaded = await load(values.file);
+    const pc = new Pinecall({ url, apiKey: door.apiKey });
+    // takesUnclaimed: false is the other half of the `?app=` below. Holding the agent is what makes
+    // this a console; taking a call nobody named would make it a server, and a real phone call would
+    // ring in this terminal. See the runtime's docs/decisions/dispatch.md: the registry is its.
+    // --state is the same file `pinecall prompt` reads, and it is applied where a call's opening
+    // state belongs: through mount's `opening` seam, after the class's own onCall and before the
+    // first render, so the model reads one view built from the whole state rather than one per field.
+    const preload = values.state === undefined ? undefined : firstState(values.state, values.case);
+    const mounted = mount(loaded.ctor, {
+        ...mountOptions(loaded, pc),
+        takesUnclaimed: false,
+        opening: () => preload,
+    });
+    // The app socket is this process's last handle: left open it keeps node alive after the last
+    // turn, and a `pinecall chat` nobody can kill is a process still holding this agent — one of
+    // several the gateway now allows, and one more than anybody wanted.
+    try {
+        await pc.connect();
+        // The id exists only after the register the connect awaited, which is why it is read here
+        // and not where the agent was mounted.
+        const address = chatUrl(url, mounted.slug, mounted.agent.app, values.as);
+        return await talk(address, door.apiKey, values.events === true);
+    }
+    finally {
+        pc.close();
+    }
+}
+/** The chat socket's address off the gateway's HTTP one: the scheme flips, the path is fixed. */
+export function chatUrl(base, agent, app, contact) {
+    const url = new URL(base);
+    url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+    url.pathname = `${url.pathname.replace(/\/$/, "")}/v1/chat`;
+    url.searchParams.set("agent", agent);
+    // Which process serves the call this socket opens. Without it the gateway picks the newest
+    // socket holding the agent, which in a terminal with a `run` running is the other one.
+    if (app !== undefined)
+        url.searchParams.set("app", app);
+    // A number names its caller; a web visitor is nobody until somebody says who they are, and
+    // `--as` is this terminal saying it: memory files the call under that id, so an agent that
+    // declares `memory` can be made to remember somebody from here. It is encoded on the way out,
+    // because a `+34600123456` written raw into a query string arrives at the gateway as a space.
+    if (contact !== undefined)
+        url.searchParams.set("contact", contact);
+    return url.toString();
+}
+// Every line typed is one turn; every frame received is one entry, printed as it lands. The key
+// travels as the upgrade's Authorization header, never in the URL, which is the only thing the
+// chat door accepts and the reason this socket is `ws` and not the runtime's global WebSocket.
+function talk(url, apiKey, events) {
+    const socket = new WebSocket(url, { headers: { authorization: `Bearer ${apiKey}` } });
+    const lines = createInterface({ input: process.stdin, output: process.stdout, prompt: PROMPT });
+    // An entry can land after the keyboard is gone — a piped stdin ends the moment it is read, and
+    // the agent's greeting arrives after that — and readline throws on a prompt it has closed.
+    let typing = true;
+    // The keyboard waits for the socket: `ws` throws on a send while the upgrade is still in flight
+    // rather than queueing it. Paused, a line typed early stays in the stream and arrives as the
+    // first turn the moment the socket is up, which is what a person who typed it meant.
+    lines.pause();
+    return new Promise((done) => {
+        socket.on("open", () => {
+            lines.resume();
+            lines.prompt();
+        });
+        socket.on("message", (frame) => {
+            // --events is the wire itself, one JSON entry per line, exactly what `run --events` prints:
+            // the same word means the same thing in both verbs, and it is what a person reaches for when
+            // what is wrong is the stream and not the conversation.
+            const line = events ? frame.toString() : lineOf(frame.toString());
+            if (line === null)
+                return;
+            // The prompt is rewritten after every entry: one may land while the caller is still typing.
+            process.stdout.write(`\r${line}\n`);
+            if (typing)
+                lines.prompt();
+        });
+        socket.on("error", (failed) => {
+            process.stderr.write(`\rthe gateway refused the chat socket: ${failed.message}\n`);
+            lines.close();
+            done(1);
+        });
+        // A close that carries a reason is the gateway saying why it will not take this call — today
+        // that is an agent nobody is serving, and the sentence names it. A close with none is the
+        // conversation ending, which is how every chat ends and is not worth a line.
+        socket.on("close", (_code, reason) => {
+            lines.close();
+            const why = reason.toString();
+            if (why === "") {
+                done(0);
+                return;
+            }
+            process.stderr.write(`\r${why}\n`);
+            done(1);
+        });
+        lines.on("line", (line) => {
+            if (line.trim() !== "")
+                socket.send(JSON.stringify({ text: line.trim() }));
+            lines.prompt();
+        });
+        lines.on("close", () => {
+            typing = false;
+            socket.close();
+        });
+    });
+}
+// One entry off the socket, printed the way the live view draws it — cli/view.ts owns the four
+// marks and the shortening. An entry it has no line for is machinery, and machinery is not the
+// conversation: a state change, a re-render, a metric is printed by nobody here and read whole
+// under --events. An error is the exception, because a tool that threw is the thing a person most
+// needs to see, and it is shown in its own words rather than as the bare type.
+// `turn.user` is the one entry of the conversation with no line: readline echoed those words at
+// the `‹ ` prompt as they were typed, and printing the frame too puts the caller's own sentence on
+// screen twice. `run`'s view is watching somebody else's call and still draws it, so this
+// rule is chat's.
+export function lineOf(frame) {
+    const entry = JSON.parse(frame);
+    if (entry.type === "turn.user")
+        return null;
+    if (entry.type === "error")
+        return `${BROKE} ${String(entry.data?.message)}`;
+    const line = lineFor({ ...entry, data: entry.data ?? {} });
+    return line === null ? null : `${line.mark} ${line.text}`;
+}
+//# sourceMappingURL=chat.js.map

package/dist/cli/chat.js.map

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

package/dist/cli/config.d.ts

@@ -0,0 +1,16 @@
+/** `pinecall config` and `pinecall use`: the gateways this machine knows, and which one is in hand. */
+import type { Group } from "./groups.js";
+import { activeName } from "./profiles.js";
+export declare const group: Group;
+/** What the verb can be told besides the argv. Tests only: where to print, and which home. */
+export interface Showing {
+    out?: NodeJS.WritableStream;
+    err?: NodeJS.WritableStream;
+    home?: string;
+}
+/** `config` with nothing after it prints them all; `use <name>` moves the mark. */
+export declare function run(argv: string[], how?: Showing): Promise<number>;
+/** The same verb under the name a person reaches for: `pinecall use box`. */
+export declare function use(argv: string[], how?: Showing): Promise<number>;
+export { activeName };
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAY,UAAU,EAAoC,MAAM,eAAe,CAAC;AAMvF,eAAO,MAAM,KAAK,EAAE,KAgBnB,CAAC;AAEF,8FAA8F;AAC9F,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5E;AAED,6EAA6E;AAC7E,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5E;AAmED,OAAO,EAAE,UAAU,EAAE,CAAC"}