@pinecall/agents 0.9.20

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, Scripted, Searched } 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,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/testing/index.js

@@ -0,0 +1,4 @@
+// @pinecall/agents/client/testing: in-process fakes of the gateway and the call log for app tests.
+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,24 @@
+import { type Entry } from "../../wire/envelope.js";
+import { type EventType } from "../../wire/registry.js";
+/**
+ * Fake `GET /v1/calls/{id}/events` and `GET /v1/agents/{slug}/calls`, as JSON pages and SSE.
+ * `after` and `Last-Event-ID` are the same cursor; a reconnecting reader gets exactly what it missed.
+ */
+export declare class FakeLog {
+    #private;
+    readonly entries: Entry[];
+    private constructor();
+    /** Start on a random port. Close it when the test is over. */
+    static start(): Promise<FakeLog>;
+    /** The URL to give a client as PINECALL_URL. */
+    get url(): string;
+    /** Append one numbered entry and push it to attached readers. */
+    append(agent: string, call: string | null, type: EventType, data: Record<string, unknown>): Entry;
+    /** End every attached stream, simulating a deploy. */
+    cut(): void;
+    /** Number of attached readers. */
+    get readers(): number;
+    /** Stop listening and close all streams. */
+    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,EAAE,KAAK,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAU1E;;;GAGG;AACH,qBAAa,OAAO;;IAClB,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAM;IAK/B,OAAO,eAEN;IAED,8DAA8D;IAC9D,OAAa,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAQrC;IAED,gDAAgD;IAChD,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,iEAAiE;IACjE,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,sDAAsD;IACtD,GAAG,IAAI,IAAI,CAKV;IAED,kCAAkC;IAClC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,4CAA4C;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;CAwCF"}

package/dist/client/testing/log.js

@@ -0,0 +1,106 @@
+// An in-memory fake of the call log's two read endpoints, fed by the test.
+import { createServer } from "node:http";
+import {} from "../../wire/envelope.js";
+import { EPHEMERAL_EVENTS } from "../../wire/registry.js";
+import { LOOPBACK } from "./loopback.js";
+/**
+ * Fake `GET /v1/calls/{id}/events` and `GET /v1/agents/{slug}/calls`, as JSON pages and SSE.
+ * `after` and `Last-Event-ID` are the same cursor; a reconnecting reader gets exactly what it missed.
+ */
+export class FakeLog {
+    entries = [];
+    #server;
+    #readers = new Set();
+    #port = 0;
+    constructor(server) {
+        this.#server = server;
+    }
+    /** Start on a random port. 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;
+    }
+    /** The URL to give a client as PINECALL_URL. */
+    get url() {
+        return `http://${LOOPBACK}:${this.#port}`;
+    }
+    /** Append one numbered entry and push it to attached readers. */
+    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;
+    }
+    /** End every attached stream, simulating a deploy. */
+    cut() {
+        for (const reader of this.#readers) {
+            reader.response.end();
+        }
+        this.#readers.clear();
+    }
+    /** Number of attached readers. */
+    get readers() {
+        return this.#readers.size;
+    }
+    /** Stop listening and close all streams. */
+    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 live until call.ended; an agent's never ends. `next`: last seq sent, else `after` while live.
+        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 needed: Node drops errors on a destroyed ServerResponse, so only `close` fires.
+        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`);
+    }
+}
+/** Entry filter for a path, or null when the path is not a log endpoint. */
+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 only address the fakes listen on and hand out. */
+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,yDAAyD;AAEzD,eAAO,MAAM,QAAQ,cAAc,CAAC"}

package/dist/client/testing/loopback.js

@@ -0,0 +1,3 @@
+/** The only address the fakes listen on and hand out. */
+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,yDAAyD;AAEzD,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export * from "./agent/agent.js";
+export * from "./agent/knowledge.js";
+export * from "./agent/authors.js";
+export * from "./agent/state.js";
+export * from "./agent/tools.js";
+export * from "./agent/decorators.js";
+export type { Stages } from "./agent/stages.js";
+export * from "./agent/docstrings.js";
+export * from "./agent/view.js";
+export * from "./agent/lifecycle.js";
+export * from "./views/jsx-runtime.js";
+export * from "./views/components.js";
+export { PROMPT_BLOCKS, type Block, type Blocks } from "./views/layout.js";
+export * from "./views/render.js";
+export { renderToNodes, said, type Panels, type Tone, type ViewNode } from "./views/nodes.js";
+export { ToolFailed, runTool } from "./runtime/run-tool.js";
+export * from "./runtime/connect.js";
+export * from "./agent/visibility.js";
+export * from "./agent/accepts.js";
+export * from "./call/room.js";
+export * from "./call/history.js";
+export * from "./call/call.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3E,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG9F,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC5D,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+// pinecall: the public entry point — the Agent class, the JSX prompt runtime, the call and the bridge.
+// test/index.test.ts pins this list. The bare socket client is exported separately as `@pinecall/agents/client`.
+export * from "./agent/agent.js";
+export * from "./agent/knowledge.js";
+export * from "./agent/authors.js";
+export * from "./agent/state.js";
+export * from "./agent/tools.js";
+export * from "./agent/decorators.js";
+export * from "./agent/docstrings.js";
+export * from "./agent/view.js";
+export * from "./agent/lifecycle.js";
+export * from "./views/jsx-runtime.js";
+export * from "./views/components.js";
+// `layout` is exposed as `promptOf`.
+export { PROMPT_BLOCKS } from "./views/layout.js";
+export * from "./views/render.js";
+// The panel tags themselves are exported from `@pinecall/agents/panels`.
+export { renderToNodes, said } from "./views/nodes.js";
+// `runTool` lets a tenant's unit tests run a tool as the bridge would; the rest of run-tool.ts is internal.
+export { ToolFailed, runTool } from "./runtime/run-tool.js";
+export * from "./runtime/connect.js";
+export * from "./agent/visibility.js";
+export * from "./agent/accepts.js";
+export * from "./call/room.js";
+export * from "./call/history.js";
+export * from "./call/call.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,iHAAiH;AAEjH,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,qCAAqC;AACrC,OAAO,EAAE,aAAa,EAA2B,MAAM,mBAAmB,CAAC;AAC3E,cAAc,mBAAmB,CAAC;AAClC,yEAAyE;AACzE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAyC,MAAM,kBAAkB,CAAC;AAC9F,4GAA4G;AAE5G,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC5D,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/runtime/connect.d.ts

@@ -0,0 +1,42 @@
+/** The bridge: mounts an Agent class on a Pinecall client, one instance per call. */
+import type { Agent as SdkAgent, AgentOptions, Pinecall, Tool } from "../client/index.js";
+import { Agent } from "../agent/agent.js";
+import { type LastCall } from "../agent/state.js";
+/** Options for `mount()`. */
+export interface MountOptions {
+    pc: Pinecall;
+    /** The class's source, so docstrings and parameter types survive compilation. */
+    source?: string;
+    /** The agent file's path; its extension selects the parser dialect. */
+    file?: string;
+    /** Override the slug derived from the class name. */
+    slug?: string;
+    /** Source for `this.last(contact)` on every instance of this mount. */
+    last?: LastCall;
+    /** False for a console, which serves only calls it opened itself. */
+    takesUnclaimed?: boolean;
+}
+/** A mounted agent: its registered SDK agent and the instances serving live calls. */
+export interface Mounted {
+    slug: string;
+    agent: SdkAgent;
+    options: AgentOptions;
+    /** The instance serving a call, while it lasts. */
+    instanceOf(callId: string): Agent | undefined;
+}
+type Ctor = new () => Agent;
+/** The slug an agent registers under: its `static slug`, or its class name in kebab-case. */
+export declare function slugOf(ctor: Function): string;
+/**
+ * Build the declaration sent to the gateway: tools, prompt layout, knowledge use, state fields,
+ * events and view. Environment fields are refused. `instance` is a throwaway probe;
+ * knowledge use is detected from `source` (or the class body).
+ */
+export declare function optionsFor(ctor: Ctor, tools: Tool[], instance?: Agent, file?: string, source?: string): AgentOptions;
+/**
+ * Mount an agent class on a client. Each call gets its own instance, state and prompt.
+ * Nothing is sent until `pc.connect()`.
+ */
+export declare function mount(ctor: Ctor, { pc, source, file, slug, last, takesUnclaimed }: MountOptions): Mounted;
+export {};
+//# sourceMappingURL=connect.d.ts.map

package/dist/runtime/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/runtime/connect.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAKrF,OAAO,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,YAAY,EAAmB,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE3G,OAAO,EAAE,KAAK,EAAqD,MAAM,mBAAmB,CAAC;AAO7F,OAAO,EAAqB,KAAK,QAAQ,EAAiB,MAAM,mBAAmB,CAAC;AAUpF,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,sFAAsF;AACtF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,mDAAmD;IACnD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CAC/C;AAED,KAAK,IAAI,GAAG,UAAU,KAAK,CAAC;AAmB5B,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAO7C;AAOD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,GAAE,KAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAgBhI;AAED;;;GAGG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAqB,EAAE,EAAE,YAAY,GACpE,OAAO,CAqCT"}

package/dist/runtime/connect.js

@@ -0,0 +1,234 @@
+/** The bridge: mounts an Agent class on a Pinecall client, one instance per call. */
+import {} from "../wire/codec.js";
+import {} from "../wire/defs.js";
+import {} from "../wire/registry.js";
+import { Agent, onChange, onLog, recalled, seal, setCall, setLast } from "../agent/agent.js";
+import { eventsOf } from "../agent/accepts.js";
+import { visibilityOf } from "../agent/visibility.js";
+import { CallWorld } from "../call/call.js";
+import { describe } from "../agent/docstrings.js";
+import { searchesKnowledge } from "../agent/searching.js";
+import { runHook } from "../agent/lifecycle.js";
+import { restore, snapshot } from "../agent/state.js";
+import { toolNamed } from "../agent/tools.js";
+import { viewOf } from "../agent/view.js";
+import { PROMPT_BLOCKS } from "../views/layout.js";
+import { promptOf } from "../views/render.js";
+import { inOrder } from "./dispatch.js";
+import { refuseTheEnvironment } from "./environment.js";
+import { wordsRecalled } from "./recall.js";
+import { runTool, ToolFailed } from "./run-tool.js";
+/** The slug an agent registers under: its `static slug`, or its class name in kebab-case. */
+export function slugOf(ctor) {
+    const declared = ctor.slug;
+    if (typeof declared === "string")
+        return declared;
+    return ctor.name
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+        .toLowerCase();
+}
+function stateFieldsOf(ctor) {
+    const declared = visibilityOf(ctor);
+    return declared.length === 0 ? undefined : declared;
+}
+/**
+ * Build the declaration sent to the gateway: tools, prompt layout, knowledge use, state fields,
+ * events and view. Environment fields are refused. `instance` is a throwaway probe;
+ * knowledge use is detected from `source` (or the class body).
+ */
+export function optionsFor(ctor, tools, instance = new ctor(), file, source) {
+    const probe = instance;
+    refuseTheEnvironment(probe);
+    // Phone numbers are org rows managed with `pinecall numbers`, so a `phone` field is never sent.
+    const options = { tools };
+    if (searchesKnowledge(source ?? ctor.toString(), file))
+        options.usesKnowledge = true;
+    // Always sent whole, so the runtime and console name blocks the same way.
+    options.prompt = [...PROMPT_BLOCKS];
+    const stateFields = stateFieldsOf(ctor);
+    if (stateFields)
+        options.stateFields = stateFields;
+    const events = eventsOf(ctor);
+    if (events.length > 0)
+        options.events = events;
+    // Only the name: the panel's content is rendered on demand by view.render (cli/ui/viewing.ts).
+    const panel = viewOf(ctor);
+    if (panel !== undefined)
+        options.view = { name: panel.name };
+    return options;
+}
+/**
+ * Mount an agent class on a client. Each call gets its own instance, state and prompt.
+ * Nothing is sent until `pc.connect()`.
+ */
+export function mount(ctor, { pc, source, file, slug, last, takesUnclaimed = true }) {
+    if (source !== undefined)
+        describe(ctor, source, file);
+    const name = slug ?? slugOf(ctor);
+    const live = new Map();
+    const probe = new ctor();
+    const tools = probe.tools().map((spec) => ({
+        ...spec,
+        run: (args, call) => call_(live, call, spec.name, args),
+    }));
+    const options = { ...optionsFor(ctor, tools, probe, file, source), takesUnclaimed };
+    const agent = pc.agent(name, options);
+    agent.on("call.started", (started, call) => {
+        if (call !== null) {
+            const send = (type, id, data) => agent.command(type, id, data);
+            const searching = (query, k) => pc.search(call.id, query, k);
+            void start(ctor, live, call, send, searching, last, started.state ?? undefined);
+        }
+    });
+    // A call handed over mid-conversation. If already served here (the gateway restarted), keep the
+    // instance and resend the whole prompt, which the gateway may have lost.
+    agent.on("call.attached", (attached, call) => {
+        if (call === null)
+            return;
+        const held = live.get(call.id);
+        if (held !== undefined) {
+            held.sent = { blocks: new Map() };
+            sync(held, call);
+            return;
+        }
+        const send = (type, id, data) => agent.command(type, id, data);
+        const searching = (query, k) => pc.search(call.id, query, k);
+        adopt(ctor, live, call, attached.state, send, searching, last);
+    });
+    agent.on("call.ended", (_payload, call) => {
+        if (call !== null)
+            void end(live, call);
+    });
+    return { slug: name, agent, options, instanceOf: (id) => live.get(id)?.agent };
+}
+// An unserved call means the line hung up: tell the model instead of throwing in the process.
+async function call_(live, call, name, args) {
+    const serving = live.get(call.id);
+    if (serving === undefined)
+        throw new ToolFailed(`${name}: this call is no longer being served`);
+    const declaration = toolNamed(serving.agent, name);
+    if (declaration === undefined)
+        throw new ToolFailed(`${name}: this agent declares no such tool`);
+    return runTool(serving.agent, declaration, args);
+}
+// Subscribe to changes only after the first sync, so onCall's writes go out as one prompt. The
+// state the opener asked for is applied after onCall, which would overwrite it, and before the
+// first render, so the model never sees the class's own state first.
+async function start(ctor, live, call, send, searching, last, openedIn) {
+    const link = serve(ctor, live, call, send, searching, last);
+    await runHook(link.agent, "onCall", hookCall(call));
+    if (openedIn !== undefined)
+        link.agent.startIn(openedIn);
+    call.setState(snapshot(link.agent));
+    sync(link, call);
+    follow(link, call);
+}
+// call.attached: take over a call from another process. Synchronous, because pending tool calls
+// arrive next and must find the instance. No onCall; the gateway's snapshot is restored instead.
+function adopt(ctor, live, call, state, send, searching, last) {
+    const link = serve(ctor, live, call, send, searching, last);
+    restore(link.agent, state);
+    sync(link, call);
+    follow(link, call);
+}
+function serve(ctor, live, call, send, searching, last) {
+    const agent = seal(new ctor());
+    if (last !== undefined)
+        setLast(agent, last);
+    const world = new CallWorld(callLine(call), (type, data) => send(type, call.id, data), searching);
+    setCall(agent, world);
+    const serving = { agent, ctor, call: world, warned: new Set(), queue: Promise.resolve() };
+    const link = { agent, sent: { blocks: new Map() }, stop: [], serving };
+    live.set(call.id, link);
+    return link;
+}
+function follow(link, call) {
+    const { agent, serving } = link;
+    const world = serving.call;
+    link.stop.push(onChange(agent, (change) => {
+        call.setState(snapshot(agent), [change.field]);
+        // state.set has no cause field on the wire, so log it separately.
+        const cause = world.cause;
+        if (cause !== null)
+            call.log("state.cause", { field: change.field, kind: "event", ...cause });
+        sync(link, call);
+    }), onLog(agent, (entry) => call.log(entry.name, dataOf(entry.data))), call.onAny((event) => {
+        world.take(event.type, event.data, Date.now());
+        if (event.type === "event.received")
+            void received(serving, event.data);
+        // Recalled memory is not state, so re-render explicitly.
+        if (event.type === "memory.ops") {
+            recalled(agent, wordsRecalled(event.data));
+            sync(link, call);
+        }
+        // Re-render on the user's turn so the view reflects the turn being answered, not the previous
+        // one. The gateway holds the LLM request while lookups run (runtime's session/lookups.py).
+        if (event.type === "turn.user")
+            sync(link, call);
+        // A claim changes the view (the caller can now see the page) without moving a field.
+        if (event.type === "call.claimed")
+            sync(link, call);
+    }));
+}
+// Numbered per call: listeners receive events without the wire's seq.
+async function received(serving, data) {
+    const fact = data;
+    await inOrder(serving, {
+        name: fact.name,
+        data: fact.data,
+        source: fact.source,
+        seq: serving.call.numbered(),
+        ...(fact.identity === undefined ? {} : { identity: fact.identity }),
+    });
+}
+async function end(live, call) {
+    const link = live.get(call.id);
+    if (link === undefined)
+        return;
+    live.delete(call.id);
+    for (const stop of link.stop)
+        stop();
+    await runHook(link.agent, "onEnd", hookCall(call));
+    setCall(link.agent, null);
+}
+// Send only blocks whose text changed. Tools are compared as a whole: only `when` changes them mid-call.
+function sync(serving, call) {
+    const { blocks } = promptOf(serving.agent);
+    for (const block of blocks) {
+        if (block.text === (serving.sent.blocks.get(block.name) ?? ""))
+            continue;
+        serving.sent.blocks.set(block.name, block.text);
+        call.setPrompt(block.name, block.text);
+    }
+    const visible = serving.agent.visibleTools();
+    const key = JSON.stringify(visible);
+    if (key !== serving.sent.tools) {
+        serving.sent.tools = key;
+        call.setTools(visible);
+    }
+}
+function hookCall(call) {
+    const hook = { id: call.id, contact: call.contact?.id ?? call.from ?? "" };
+    if (call.from !== null)
+        hook.from = call.from;
+    if (call.channel !== null)
+        hook.channel = call.channel;
+    if (call.medium !== null)
+        hook.medium = call.medium;
+    return hook;
+}
+// Adds `today` and `claimed`, which hookCall lacks; without them `this.call.today` is undefined.
+function callLine(call) {
+    return { ...hookCall(call), today: call.today, claimed: call.claimed };
+}
+// call.log requires an object, so wrap other values under `value`.
+function dataOf(data) {
+    if (data === undefined)
+        return {};
+    if (typeof data === "object" && data !== null && !Array.isArray(data)) {
+        return data;
+    }
+    return { value: data };
+}
+//# sourceMappingURL=connect.js.map

package/dist/runtime/connect.js.map

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

package/dist/runtime/dispatch.d.ts

@@ -0,0 +1,32 @@
+/** Dispatches `event.received` entries to the instance serving the call, or drops them. */
+import { type EventSource } from "../agent/accepts.js";
+import type { CallWorld } from "../call/call.js";
+/** One `event.received` entry as the wire carries it. */
+export interface Received {
+    name: string;
+    data: Record<string, unknown>;
+    source: EventSource;
+    identity?: string;
+    seq: number;
+}
+/** The live instance, its class and its call, as the dispatcher needs them. */
+export interface Serving {
+    agent: object;
+    ctor: Function;
+    call: CallWorld;
+    /** `call:name` keys already warned about, so each warns once. */
+    warned: Set<string>;
+    /** Serializes this call's events so a write's cause is the event currently running. */
+    queue: Promise<unknown>;
+}
+/**
+ * Dispatch after all earlier events finish. The cause lives on the call while a hook runs, so
+ * concurrent hooks would attribute writes to each other's event.
+ */
+export declare function inOrder(serving: Serving, received: Received): Promise<boolean>;
+/**
+ * Pass the event to `onEvent` if its name and source are declared, else drop it. Writes inside the
+ * hook are authored `event:<name>`, and the call carries the cause so the log can name it.
+ */
+export declare function dispatch(serving: Serving, received: Received): Promise<boolean>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/runtime/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/runtime/dispatch.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAI3F,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,uFAAuF;IACvF,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9E;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBrF"}