pinecall 0.1.0

package/dist/client/listeners.js

@@ -0,0 +1,61 @@
+// Who is listening for what. One registry, used for a whole agent and for a single call alike.
+import { toCamel } from "@pinecall/protocol";
+/** The decoded event with its keys as the app reads them. */
+export function camelEvent(event) {
+    return { type: event.type, data: toCamel(event.data) };
+}
+/**
+ * Every listener registered against one thing — an agent, or a call — and the dispatch to them.
+ *
+ * A listener that throws is a bug in the app, not a reason to stop reading the socket: it is
+ * handed to `onError` and the next listener still runs.
+ */
+export class Listeners {
+    onError;
+    #byType = new Map();
+    #any = new Set();
+    constructor(onError) {
+        this.onError = onError;
+    }
+    /** Listen for one event type. The returned function stops listening. */
+    on(type, listener) {
+        const listeners = this.#byType.get(type) ?? new Set();
+        this.#byType.set(type, listeners);
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    /** Listen for every event. The returned function stops listening. */
+    onAny(listener) {
+        this.#any.add(listener);
+        return () => {
+            this.#any.delete(listener);
+        };
+    }
+    /** Hand one event to everybody waiting for it, then to everybody waiting for anything. */
+    emit(event, context) {
+        for (const listener of this.#byType.get(event.type) ?? []) {
+            this.#run(() => listener(event.data, context));
+        }
+        for (const listener of this.#any) {
+            this.#run(() => listener(event, context));
+        }
+    }
+    #run(listener) {
+        try {
+            const running = listener();
+            if (running instanceof Promise) {
+                running.catch((failed) => this.onError(asError(failed)));
+            }
+        }
+        catch (failed) {
+            this.onError(asError(failed));
+        }
+    }
+}
+/** Whatever was thrown, as an Error: `catch` gives `unknown` and a listener may throw a string. */
+export function asError(thrown) {
+    return thrown instanceof Error ? thrown : new Error(String(thrown));
+}
+//# sourceMappingURL=listeners.js.map

package/dist/client/listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listeners.js","sourceRoot":"","sources":["../../src/client/listeners.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,EAAE,OAAO,EAA0D,MAAM,oBAAoB,CAAC;AAgBrG,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAgB,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IAIS,OAAO;IAH3B,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IAClD,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,YAA6B,OAA+B;uBAA/B,OAAO;IAA2B,CAAC;IAEhE,wEAAwE;IACxE,EAAE,CAAsB,IAAO,EAAE,QAA8B;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAmB,CAAC;QACvE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,SAAS,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAC;QAC3C,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,MAAM,CAAC,QAA2B,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,QAA8B;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC;IAED,0FAA0F;IAC1F,IAAI,CAAC,KAAiB,EAAE,OAAgB;QACtC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAE,QAAyD,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACnG,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAuB;QAC1B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;YAC3B,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,CAAC,MAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAED,mGAAmG;AACnG,MAAM,UAAU,OAAO,CAAC,MAAe;IACrC,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/client/observe.d.ts

@@ -0,0 +1,44 @@
+import { type Entry, type State } from "@pinecall/protocol";
+import { type CamelEvent } from "./listeners.js";
+/** Whose log: one call's, or an agent's own. */
+export type LogTarget = {
+    call: string;
+    agent?: never;
+} | {
+    agent: string;
+    call?: never;
+};
+/** Where to read from and from which cursor. */
+export interface ReadOptions {
+    url: string;
+    apiKey: string;
+    after?: number;
+    signal?: AbortSignal;
+}
+/** One page of a log: the entries after the cursor, what they fold to, and where to go next. */
+export interface Page {
+    entries: Entry[];
+    state: State;
+    /** True while the log is still open: more will follow, and the stream is how to get it. */
+    live: boolean;
+    /** The cursor to ask from next, or null when nothing follows this page. */
+    next: number | null;
+}
+/** One entry, what it means, and the state the log has folded to including it. */
+export interface Observation {
+    entry: Entry;
+    event: CamelEvent;
+    state: State;
+}
+/**
+ * A log as it happens: every entry after the cursor, then everything that follows, forever.
+ *
+ * The cursor is the whole protocol. A stream that drops is the same URL again with a fresher
+ * `Last-Event-ID`, and the platform answers a reader that fell behind with `log.gap` — carrying a
+ * snapshot when it has one — then `log.caught_up` when what follows is live. The reducer is
+ * `@pinecall/protocol`'s, so a client and the platform never disagree about what a log means.
+ */
+export declare function observe(target: LogTarget, options: ReadOptions): AsyncGenerator<Observation>;
+/** The log as it stands: one page after the cursor, what it folds to, and whether more follows. */
+export declare function history(target: LogTarget, options: ReadOptions): Promise<Page>;
+//# sourceMappingURL=observe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/client/observe.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6C,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGvG,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE1F,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,gGAAgG;AAChG,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,2FAA2F;IAC3F,IAAI,EAAE,OAAO,CAAC;IACd,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CACd;AAKD;;;;;;;GAOG;AACH,wBAAuB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CA2BnG;AAID,mGAAmG;AACnG,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAcpF"}

package/dist/client/observe.js

@@ -0,0 +1,122 @@
+// Reading a log: the same URL as a JSON page and as SSE, folded by the protocol's own reducer.
+import { apply, decodeEntry, eventOf, initialState } from "@pinecall/protocol";
+import { agentLogUrl, callLogUrl } from "./endpoints.js";
+import { PinecallError } from "./frames.js";
+import { camelEvent } from "./listeners.js";
+const RETRY_MS = 1_000;
+const RETRY_CAP_MS = 30_000;
+/**
+ * A log as it happens: every entry after the cursor, then everything that follows, forever.
+ *
+ * The cursor is the whole protocol. A stream that drops is the same URL again with a fresher
+ * `Last-Event-ID`, and the platform answers a reader that fell behind with `log.gap` — carrying a
+ * snapshot when it has one — then `log.caught_up` when what follows is live. The reducer is
+ * `@pinecall/protocol`'s, so a client and the platform never disagree about what a log means.
+ */
+export async function* observe(target, options) {
+    let state = initialState();
+    let after = options.after ?? 0;
+    let attempt = 0;
+    let opened = false;
+    while (!aborted(options.signal)) {
+        try {
+            for await (const entry of stream(target, { ...options, after })) {
+                attempt = 0;
+                opened = true;
+                after = entry.seq;
+                state = apply(state, entry);
+                yield { entry, event: camelEvent(eventOf(entry)), state };
+            }
+        }
+        catch (failed) {
+            if (aborted(options.signal)) {
+                return;
+            }
+            // A stream that never opened is a misconfiguration — a wrong key, a call nobody has — and
+            // the reader hears it now. One that dropped after it worked is what the cursor is for.
+            if (!opened) {
+                throw failed;
+            }
+        }
+        attempt += 1;
+        await pause(Math.min(RETRY_CAP_MS, RETRY_MS * 2 ** (attempt - 1)) * Math.random(), options.signal);
+    }
+}
+// The page says where to go next itself, rather than leaving the reader to infer a cursor from
+// the last entry it happened to receive: an empty page of a live log still has a next.
+/** The log as it stands: one page after the cursor, what it folds to, and whether more follows. */
+export async function history(target, options) {
+    const response = await read(target, options, "application/json");
+    const page = await response.json();
+    if (page === null || typeof page !== "object" || !Array.isArray(page.entries)) {
+        throw new PinecallError("the log page is not { entries, live, next }");
+    }
+    const { entries: raw, live, next } = page;
+    const entries = raw.map((one) => decodeEntry(one));
+    return {
+        entries,
+        state: entries.reduce(apply, initialState()),
+        live: live === true,
+        next: typeof next === "number" ? next : null,
+    };
+}
+/** One SSE connection: entries until the server closes it or the reader is aborted. */
+async function* stream(target, options) {
+    const response = await read(target, options, "text/event-stream");
+    if (response.body === null) {
+        throw new PinecallError("the event stream came back with no body");
+    }
+    let buffered = "";
+    const decoder = new TextDecoder();
+    for await (const chunk of response.body) {
+        buffered += decoder.decode(chunk, { stream: true });
+        let cut = buffered.indexOf("\n\n");
+        while (cut !== -1) {
+            const entry = entryIn(buffered.slice(0, cut));
+            buffered = buffered.slice(cut + 2);
+            cut = buffered.indexOf("\n\n");
+            if (entry !== null) {
+                yield entry;
+            }
+        }
+    }
+}
+/** One SSE block as an entry, or null for a comment or a keep-alive that carries no data. */
+function entryIn(block) {
+    const data = block
+        .split("\n")
+        .filter((line) => line.startsWith("data:"))
+        .map((line) => line.slice("data:".length).trimStart())
+        .join("\n");
+    return data === "" ? null : decodeEntry(JSON.parse(data));
+}
+async function read(target, options, accept) {
+    const url = new URL(target.call === undefined ? agentLogUrl(options.url, target.agent) : callLogUrl(options.url, target.call));
+    const after = options.after ?? 0;
+    if (after > 0) {
+        url.searchParams.set("after", String(after));
+    }
+    const headers = { accept, authorization: `Bearer ${options.apiKey}` };
+    if (after > 0) {
+        headers["last-event-id"] = String(after);
+    }
+    const response = await fetch(url, { headers, ...(options.signal === undefined ? {} : { signal: options.signal }) });
+    if (!response.ok) {
+        throw new PinecallError(`${url.pathname}: the gateway answered ${response.status}`);
+    }
+    return response;
+}
+/** True once the reader asked to stop. A function, so no narrowing survives the loop's own check. */
+function aborted(signal) {
+    return signal?.aborted === true;
+}
+async function pause(ms, signal) {
+    await new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timer);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=observe.js.map

package/dist/client/observe.js.map

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

package/dist/client/testing/gateway.d.ts

@@ -0,0 +1,39 @@
+import { type Command, type Entry, type EventType } from "@pinecall/protocol";
+/** What a fake gateway answers to, and what it hands back. */
+export interface FakeGatewayOptions {
+    /** The only key it accepts. Anything else is closed with 1008 and no body, like the real door. */
+    apiKey?: string;
+    /** Slugs this gateway refuses to register at all: the real one refuses a door another agent
+     * already answers, or a slug another fleet is holding. */
+    taken?: string[];
+}
+/** One command the fake gateway received, as it arrived. */
+export type Received = Command;
+/**
+ * A gateway with no session, no store and no model: it numbers entries, answers the three
+ * commands the app socket answers itself, and lets a test push any entry it likes down the wire.
+ *
+ * It exists because the client's promise is that an app can be tested without a gateway, and a
+ * promise like that has to be shipped, not re-written in every app's test folder.
+ */
+export declare class FakeGateway {
+    #private;
+    private readonly options;
+    readonly received: Received[];
+    private constructor();
+    /** Start one on a port nobody chose. Close it when the test is over. */
+    static start(options?: FakeGatewayOptions): Promise<FakeGateway>;
+    /** What a client should be given as its PINECALL_URL. */
+    get url(): string;
+    /** How many apps are connected right now. */
+    get connections(): number;
+    /** Every command of one type, in the order it arrived. */
+    commandsOf(type: string): Received[];
+    /** Push one entry to every connected app, numbered as a store would number it. */
+    emit(agent: string, call: string | null, type: EventType, data: Record<string, unknown>): Entry;
+    /** Drop every open socket without closing the door: what a gateway restart looks like. */
+    cut(): void;
+    /** Stop listening and hang up on everybody. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/client/testing/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/client/testing/gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmC,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/G,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;8DAC0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAE/B;;;;;;GAMG;AACH,qBAAa,WAAW;;IASuB,OAAO,CAAC,QAAQ,CAAC,OAAO;IARrE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAM;IAQnC,OAAO,eAGN;IAID,wEAAwE;IACxE,OAAa,KAAK,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBzE;IAED,yDAAyD;IACzD,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6CAA6C;IAC7C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,0DAA0D;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEnC;IAED,kFAAkF;IAClF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAM9F;IAED,0FAA0F;IAC1F,GAAG,IAAI,IAAI,CAKV;IAED,+CAA+C;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;CAuDF"}

package/dist/client/testing/gateway.js

@@ -0,0 +1,129 @@
+// A gateway that is not there: enough of the app socket to test an app's own agents, in process.
+import { CommandSchema, EPHEMERAL_EVENTS } from "@pinecall/protocol";
+import { WebSocket, WebSocketServer } from "ws";
+import { LOOPBACK } from "./loopback.js";
+// The gateway answers a key nothing knows during the handshake, so the upgrade never happens.
+const FORBIDDEN = 403;
+/**
+ * A gateway with no session, no store and no model: it numbers entries, answers the three
+ * commands the app socket answers itself, and lets a test push any entry it likes down the wire.
+ *
+ * It exists because the client's promise is that an app can be tested without a gateway, and a
+ * promise like that has to be shipped, not re-written in every app's test folder.
+ */
+export class FakeGateway {
+    options;
+    received = [];
+    #server;
+    #sockets = new Set();
+    #refused;
+    #seq = 0;
+    #apps = 0;
+    #port = 0;
+    constructor(server, options) {
+        this.options = options;
+        this.#server = server;
+        this.#refused = new Set(options.taken ?? []);
+    }
+    // The key is checked during the handshake, the way the real door checks it: a socket that never
+    // opens is what a wrong key looks like from the app's side, not one that opens and shuts.
+    /** Start one on a port nobody chose. Close it when the test is over. */
+    static async start(options = {}) {
+        const server = new WebSocketServer({
+            port: 0,
+            // The address `url` hands out, and nothing wider. Without it the listener takes the IPv6
+            // wildcard, which the kernel will grant on a port another program already holds on IPv4 —
+            // and then the client's `127.0.0.1` connection is served by that program instead of by us.
+            host: LOOPBACK,
+            path: "/v1/apps",
+            verifyClient: ({ req }, done) => done(options.apiKey === undefined || req.headers.authorization === `Bearer ${options.apiKey}`, FORBIDDEN),
+        });
+        await new Promise((resolve) => server.once("listening", resolve));
+        const gateway = new FakeGateway(server, options);
+        const address = server.address();
+        gateway.#port = typeof address === "object" && address !== null ? address.port : 0;
+        server.on("connection", (socket) => gateway.#accept(socket));
+        return gateway;
+    }
+    /** What a client should be given as its PINECALL_URL. */
+    get url() {
+        return `http://${LOOPBACK}:${this.#port}`;
+    }
+    /** How many apps are connected right now. */
+    get connections() {
+        return this.#sockets.size;
+    }
+    /** Every command of one type, in the order it arrived. */
+    commandsOf(type) {
+        return this.received.filter((command) => command.type === type);
+    }
+    /** Push one entry to every connected app, numbered as a store would number it. */
+    emit(agent, call, type, data) {
+        const entry = { seq: (this.#seq += 1), ts: Date.now() / 1000, call, agent, type, ephemeral: EPHEMERAL_EVENTS.has(type), data };
+        for (const socket of this.#sockets) {
+            socket.send(JSON.stringify(entry));
+        }
+        return entry;
+    }
+    /** Drop every open socket without closing the door: what a gateway restart looks like. */
+    cut() {
+        for (const socket of this.#sockets) {
+            socket.terminate();
+        }
+        this.#sockets.clear();
+    }
+    /** Stop listening and hang up on everybody. */
+    async close() {
+        this.cut();
+        await new Promise((resolve, reject) => this.#server.close((failed) => (failed ? reject(failed) : resolve())));
+    }
+    #accept(socket) {
+        this.#sockets.add(socket);
+        // The id the real gateway mints per connection and hands back in `agent.registered`.
+        const app = `app_${(this.#apps += 1)}`;
+        socket.on("message", (raw) => this.#take(socket, app, raw));
+        socket.on("close", () => this.#sockets.delete(socket));
+        // Node THROWS an `error` event nobody listens for, and `ws` raises one on this socket for any
+        // frame it cannot parse — a confused client, or whatever else found the port. Without this
+        // line one bad connection ends the whole test run instead of just itself.
+        socket.on("error", () => this.#sockets.delete(socket));
+    }
+    #take(socket, app, raw) {
+        const command = CommandSchema.parse(JSON.parse(raw.toString()));
+        this.received.push(command);
+        switch (command.type) {
+            case "agent.register":
+                return this.#register(socket, app, command);
+            case "agent.configure":
+                return this.#answer(socket, command, "agent.configured", { changed: Object.keys((command.data["config"] ?? {})) });
+            case "ping":
+                return this.#answer(socket, command, "pong", { ts: Date.now() / 1000 });
+            default:
+                return;
+        }
+    }
+    // Many sockets may hold one agent, so a second register is answered like the first: what the
+    // real registry refuses is a door another agent answers. `taken` is how a test asks for that.
+    #register(socket, app, command) {
+        if (this.#refused.has(command.agent)) {
+            this.#refuse(socket, command, "refused", `${command.agent} answers at a door somebody else has`);
+            return;
+        }
+        const { routes, sdk } = command.data;
+        this.#answer(socket, command, "agent.registered", sdk === undefined ? { routes, app } : { routes, app, sdk });
+    }
+    #answer(socket, command, type, data) {
+        socket.send(JSON.stringify(this.#entry(command.agent, null, type, data)));
+    }
+    #refuse(socket, command, code, message) {
+        const data = { code, message, recoverable: true, command: command.type };
+        if (command.id !== undefined) {
+            data["id"] = command.id;
+        }
+        socket.send(JSON.stringify(this.#entry(command.agent, null, "error", data)));
+    }
+    #entry(agent, call, type, data) {
+        return { seq: (this.#seq += 1), ts: Date.now() / 1000, call, agent, type, ephemeral: EPHEMERAL_EVENTS.has(type), data };
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/client/testing/gateway.js.map

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

package/dist/client/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { FakeGateway } from "./gateway.js";
+export type { FakeGatewayOptions, Received } from "./gateway.js";
+export { FakeLog } from "./log.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/testing/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/testing/index.js

@@ -0,0 +1,4 @@
+// pinecall/client/testing: a gateway and a log that are not there, so an app's tests need neither.
+export { FakeGateway } from "./gateway.js";
+export { FakeLog } from "./log.js";
+//# sourceMappingURL=index.js.map

package/dist/client/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/testing/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/testing/log.d.ts

@@ -0,0 +1,26 @@
+import { type Entry, type EventType } from "@pinecall/protocol";
+/**
+ * `GET /v1/calls/{id}/events` and `GET /v1/agents/{slug}/calls`, as a JSON page and as SSE.
+ *
+ * The cursor is the whole protocol, so this is the piece worth faking: `after` and
+ * `Last-Event-ID` are the same number, and a reader that reconnects with a fresher one gets
+ * exactly what it missed.
+ */
+export declare class FakeLog {
+    #private;
+    readonly entries: Entry[];
+    private constructor();
+    /** Start one on a port nobody chose. Close it when the test is over. */
+    static start(): Promise<FakeLog>;
+    /** What a client should be given as its PINECALL_URL. */
+    get url(): string;
+    /** Append one entry, numbered as a store would number it, and push it to everybody attached. */
+    append(agent: string, call: string | null, type: EventType, data: Record<string, unknown>): Entry;
+    /** Drop every attached reader mid-stream: what a deploy looks like to somebody reading. */
+    cut(): void;
+    /** How many readers are attached right now. */
+    get readers(): number;
+    /** Stop listening and hang up on everybody. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/client/testing/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/client/testing/log.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUlF;;;;;;GAMG;AACH,qBAAa,OAAO;;IAClB,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAM;IAK/B,OAAO,eAEN;IAED,wEAAwE;IACxE,OAAa,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAQrC;IAED,yDAAyD;IACzD,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,gGAAgG;IAChG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAOhG;IAED,2FAA2F;IAC3F,GAAG,IAAI,IAAI,CAKV;IAED,+CAA+C;IAC/C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,+CAA+C;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;CA2CF"}

package/dist/client/testing/log.js

@@ -0,0 +1,111 @@
+// A log nobody stored: the two reading doors, over a list of entries a test appends to.
+import { createServer } from "node:http";
+import { EPHEMERAL_EVENTS } from "@pinecall/protocol";
+import { LOOPBACK } from "./loopback.js";
+/**
+ * `GET /v1/calls/{id}/events` and `GET /v1/agents/{slug}/calls`, as a JSON page and as SSE.
+ *
+ * The cursor is the whole protocol, so this is the piece worth faking: `after` and
+ * `Last-Event-ID` are the same number, and a reader that reconnects with a fresher one gets
+ * exactly what it missed.
+ */
+export class FakeLog {
+    entries = [];
+    #server;
+    #readers = new Set();
+    #port = 0;
+    constructor(server) {
+        this.#server = server;
+    }
+    /** Start one on a port nobody chose. Close it when the test is over. */
+    static async start() {
+        const server = createServer();
+        const log = new FakeLog(server);
+        server.on("request", (request, response) => log.#serve(request, response));
+        await new Promise((resolve) => server.listen(0, LOOPBACK, resolve));
+        const address = server.address();
+        log.#port = typeof address === "object" && address !== null ? address.port : 0;
+        return log;
+    }
+    /** What a client should be given as its PINECALL_URL. */
+    get url() {
+        return `http://${LOOPBACK}:${this.#port}`;
+    }
+    /** Append one entry, numbered as a store would number it, and push it to everybody attached. */
+    append(agent, call, type, data) {
+        const entry = { seq: this.entries.length + 1, ts: Date.now() / 1000, call, agent, type, ephemeral: EPHEMERAL_EVENTS.has(type), data };
+        this.entries.push(entry);
+        for (const reader of this.#readers) {
+            this.#push(reader, entry);
+        }
+        return entry;
+    }
+    /** Drop every attached reader mid-stream: what a deploy looks like to somebody reading. */
+    cut() {
+        for (const reader of this.#readers) {
+            reader.response.end();
+        }
+        this.#readers.clear();
+    }
+    /** How many readers are attached right now. */
+    get readers() {
+        return this.#readers.size;
+    }
+    /** Stop listening and hang up on everybody. */
+    async close() {
+        this.cut();
+        await new Promise((resolve, reject) => this.#server.close((failed) => (failed ? reject(failed) : resolve())));
+    }
+    #serve(request, response) {
+        const url = new URL(request.url ?? "/", this.url);
+        const of = matched(url.pathname);
+        if (of === null) {
+            response.writeHead(404).end();
+            return;
+        }
+        const after = Number(request.headers["last-event-id"] ?? url.searchParams.get("after") ?? 0);
+        const mine = this.entries.filter((entry) => entry.seq > after && of(entry));
+        if ((request.headers.accept ?? "").includes("text/event-stream")) {
+            this.#attach(response, mine, after);
+            return;
+        }
+        // A call's log is open until call.ended; an agent's never closes. The cursor is the last seq
+        // this page carried, or the one the reader asked from when the page is empty and more follows.
+        const live = !this.entries.some((entry) => of(entry) && entry.type === "call.ended");
+        const last = mine.at(-1);
+        const next = last !== undefined ? last.seq : live ? after : null;
+        response.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify({ entries: mine, live, next }));
+    }
+    #attach(response, replay, after) {
+        response.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", connection: "keep-alive" });
+        const reader = { after, response };
+        for (const entry of replay) {
+            this.#push(reader, entry);
+        }
+        this.#readers.add(reader);
+        // No `error` listener here, unlike the gateway's socket, and that asymmetry is deliberate: a
+        // broken reader destroys its `ServerResponse` first, and node drops an error on a destroyed
+        // message instead of emitting it. `close` is the only event this door ever gets. See sdk.md.
+        response.on("close", () => this.#readers.delete(reader));
+    }
+    #push(reader, entry) {
+        if (entry.seq <= reader.after) {
+            return;
+        }
+        reader.after = entry.seq;
+        reader.response.write(`id: ${entry.seq}\ndata: ${JSON.stringify(entry)}\n\n`);
+    }
+}
+/** Which entries a path is asking for, or null when it is not one of the two doors. */
+function matched(pathname) {
+    const call = /^\/v1\/calls\/([^/]+)\/events$/.exec(pathname);
+    if (call !== null) {
+        return (entry) => entry.call === decodeURIComponent(call[1]);
+    }
+    const agent = /^\/v1\/agents\/([^/]+)\/calls$/.exec(pathname);
+    if (agent !== null) {
+        return (entry) => entry.agent === decodeURIComponent(agent[1]);
+    }
+    return null;
+}
+//# sourceMappingURL=log.js.map

package/dist/client/testing/log.js.map

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

package/dist/client/testing/loopback.d.ts

@@ -0,0 +1,3 @@
+/** The one address a fake listens on and hands out, so it is served by itself and by nothing else. */
+export declare const LOOPBACK = "127.0.0.1";
+//# sourceMappingURL=loopback.d.ts.map

package/dist/client/testing/loopback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.d.ts","sourceRoot":"","sources":["../../../src/client/testing/loopback.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,eAAO,MAAM,QAAQ,cAAc,CAAC"}

package/dist/client/testing/loopback.js

@@ -0,0 +1,3 @@
+/** The one address a fake listens on and hands out, so it is served by itself and by nothing else. */
+export const LOOPBACK = "127.0.0.1";
+//# sourceMappingURL=loopback.js.map

package/dist/client/testing/loopback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.js","sourceRoot":"","sources":["../../../src/client/testing/loopback.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC"}