@pinecall/agents 0.9.20

package/dist/serve/prompt.d.ts

@@ -0,0 +1,7 @@
+/** `serve prompt`: the prompt a state produces, and the stage and tools it shows, offline. */
+import type { Io } from "./io.js";
+/** Load the class, open it in the state the pairs name, and print its prompt. No gateway, no key. */
+export declare function prompt(argv: string[], io: Io): Promise<number>;
+/** `field=json` pairs as the state they name; a value that is not JSON is refused by its field. */
+export declare function stateOf(pairs: string[]): Record<string, unknown>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/serve/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/serve/prompt.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAO9F,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAIlC,qGAAqG;AACrG,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBpE;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAahE"}

package/dist/serve/prompt.js

@@ -0,0 +1,51 @@
+/** `serve prompt`: the prompt a state produces, and the stage and tools it shows, offline. */
+import { parseArgs } from "node:util";
+import { ChannelSchema, MediumSchema } from "../wire/defs.js";
+import { showPrompt } from "../views/render.js";
+import { CannotServe, instanceFor, loadServed } from "./load.js";
+import { showMachine } from "./machine.js";
+/** Load the class, open it in the state the pairs name, and print its prompt. No gateway, no key. */
+export async function prompt(argv, io) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            file: { type: "string" },
+            slug: { type: "string" },
+            state: { type: "string", multiple: true },
+            channel: { type: "string", default: "phone" },
+            medium: { type: "string" },
+            "show-machine": { type: "boolean", default: false },
+        },
+    });
+    if (values.file === undefined || values.slug === undefined) {
+        throw new CannotServe("serve prompt takes the agent's --file and the --slug it is served as");
+    }
+    const channel = ChannelSchema.safeParse(values.channel);
+    const medium = MediumSchema.optional().safeParse(values.medium);
+    if (!channel.success || !medium.success) {
+        throw new CannotServe("--channel is phone, web or whatsapp, and --medium is voice or text");
+    }
+    const agent = instanceFor(await loadServed(values.file, values.slug), channel.data, medium.data);
+    agent.startIn(stateOf(values.state ?? []));
+    const machine = values["show-machine"] === true ? `\n\n${showMachine(agent)}` : "";
+    io.out.write(`${showPrompt(agent)}${machine}\n`);
+    return 0;
+}
+/** `field=json` pairs as the state they name; a value that is not JSON is refused by its field. */
+export function stateOf(pairs) {
+    const state = {};
+    for (const pair of pairs) {
+        const at = pair.indexOf("=");
+        if (at <= 0)
+            throw new CannotServe(`--state ${pair}: a field, =, and its value as JSON`);
+        const field = pair.slice(0, at);
+        try {
+            state[field] = JSON.parse(pair.slice(at + 1));
+        }
+        catch {
+            throw new CannotServe(`--state ${field}: its value is not JSON`);
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/serve/prompt.js.map

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

package/dist/serve/start.d.ts

@@ -0,0 +1,7 @@
+/** `serve start`: hold the agents named, serve their calls, and leave by draining them. */
+import type { Io } from "./io.js";
+/** The console's other verbs are answered by the CLI's companion socket, never by the class. */
+export declare const ONLY_THE_VIEW = "this process answers only view.render: the console's other verbs are the CLI's";
+/** Hold every agent named until asked to leave; the exit code is 0 once they drained. */
+export declare function start(argv: string[], io: Io): Promise<number>;
+//# sourceMappingURL=start.d.ts.map

package/dist/serve/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/serve/start.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAU3F,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAGlC,gGAAgG;AAChG,eAAO,MAAM,aAAa,mFAAmF,CAAC;AAY9G,yFAAyF;AACzF,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBnE"}

package/dist/serve/start.js

@@ -0,0 +1,95 @@
+/** `serve start`: hold the agents named, serve their calls, and leave by draining them. */
+import { parseArgs } from "node:util";
+import { aLostSocket, DevRefused, Pinecall } from "../client/index.js";
+import { mount } from "../runtime/connect.js";
+import { drainLine, askedToLeave, drainedUnlessSignalledAgain } from "./leaving.js";
+import { eventLine, personLine } from "./lines.js";
+import { CannotServe, loadServed } from "./load.js";
+import { viewingFrom } from "./viewing.js";
+/** The console's other verbs are answered by the CLI's companion socket, never by the class. */
+export const ONLY_THE_VIEW = "this process answers only view.render: the console's other verbs are the CLI's";
+const NO_DOOR = "serve start reads PINECALL_URL and PINECALL_KEY from its environment, and one was not set";
+const WORLDS = ["sandbox", "production"];
+/** Hold every agent named until asked to leave; the exit code is 0 once they drained. */
+export async function start(argv, io) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            file: { type: "string", multiple: true },
+            slug: { type: "string", multiple: true },
+            console: { type: "boolean", default: false },
+            events: { type: "boolean", default: false },
+        },
+    });
+    const served = paired(values.file ?? [], values.slug ?? []);
+    const pc = clientFrom(io.env);
+    for (const one of served)
+        await held(pc, one, values.console === true);
+    said(pc, io, values.events === true);
+    try {
+        await pc.connect();
+        if ((await askedToLeave(pc, io)) !== "stopped") {
+            const drained = await drainedUnlessSignalledAgain(pc, io);
+            if (drained !== undefined)
+                io.err.write(`${drainLine(drained)}\n`);
+        }
+        return 0;
+    }
+    finally {
+        pc.close();
+    }
+}
+/** Every `--file` with the `--slug` at its place. */
+function paired(files, slugs) {
+    if (files.length === 0 || files.length !== slugs.length) {
+        throw new CannotServe("serve start takes one --slug for each --file, and at least one of each");
+    }
+    return files.map((file, at) => ({ file, slug: slugs[at] }));
+}
+function clientFrom(env) {
+    const url = env["PINECALL_URL"];
+    const apiKey = env["PINECALL_KEY"];
+    if (url === undefined || url === "" || apiKey === undefined || apiKey === "")
+        throw new CannotServe(NO_DOOR);
+    const world = env["PINECALL_ENV"];
+    if (world === undefined || world === "")
+        return new Pinecall({ url, apiKey });
+    if (!WORLDS.includes(world))
+        throw new CannotServe(`PINECALL_ENV is sandbox or production, not ${world}`);
+    return new Pinecall({ url, apiKey, env: world });
+}
+// A console's own process takes only the calls that name it; the class draws the panel.
+async function held(pc, one, console) {
+    const loaded = await loadServed(one.file, one.slug);
+    const mounted = mount(loaded.ctor, { pc, source: loaded.source, file: loaded.file, slug: one.slug, takesUnclaimed: !console });
+    const viewing = viewingFrom(loaded.ctor, one.slug);
+    mounted.agent.onDev(async (verb, data) => {
+        if (verb !== "view.render")
+            throw new DevRefused(404, ONLY_THE_VIEW);
+        return { ...(await viewing.render(data)) };
+    });
+    return mounted;
+}
+// Listening starts before connect, so agent.registered is the first line. A lost gateway is one
+// line per outage, on err so --events stays the wire alone.
+function said(pc, io, events) {
+    pc.onEntries((entry) => {
+        const line = events ? eventLine(entry) : personLine(entry);
+        if (line !== null)
+            io.out.write(`${line}\n`);
+    });
+    let lost = false;
+    pc.onErrors((failed) => {
+        if (!aLostSocket(failed))
+            return void io.err.write(`${failed.stack ?? failed.message}\n`);
+        if (!lost)
+            io.err.write(`gateway  ${failed.message} — reconnecting\n`);
+        lost = true;
+    });
+    pc.onConnected(() => {
+        if (lost)
+            io.err.write("gateway  back\n");
+        lost = false;
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/serve/start.js.map

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

package/dist/serve/viewing.d.ts

@@ -0,0 +1,17 @@
+/** Render the agent class's view as the console panel for one conversation. */
+import { type ViewNode } from "../views/nodes.js";
+/** Rendered panel: its title and node tree. */
+export interface Drawn {
+    name: string;
+    nodes: ViewNode[];
+}
+/** This process's answer to `view.render`, for the class it serves. */
+export interface Viewing {
+    render(asked: unknown): Promise<Drawn>;
+}
+/**
+ * Bind `view.render` to a class. The view may be async; its output is rendered to
+ * `@pinecall/agents/panels` nodes, so only data reaches the browser.
+ */
+export declare function viewingFrom(ctor: object, slug: string): Viewing;
+//# sourceMappingURL=viewing.d.ts.map

package/dist/serve/viewing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewing.d.ts","sourceRoot":"","sources":["../../src/serve/viewing.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAK/E,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAKjE,+CAA+C;AAC/C,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAe/D"}

package/dist/serve/viewing.js

@@ -0,0 +1,42 @@
+/** Render the agent class's view as the console panel for one conversation. */
+import { DevRefused } from "../client/index.js";
+import { viewOf } from "../agent/view.js";
+import { renderToNodes } from "../views/nodes.js";
+// The console falls back to its own contact panel on this 404.
+const DRAWS_NONE = (agent) => `${agent} declares no view: nothing in this directory draws a panel`;
+/**
+ * Bind `view.render` to a class. The view may be async; its output is rendered to
+ * `@pinecall/agents/panels` nodes, so only data reaches the browser.
+ */
+export function viewingFrom(ctor, slug) {
+    return {
+        async render(asked) {
+            const said = aConversation(asked);
+            const who = { agent: slug, contact: said.contact, call: said.call };
+            const declared = viewOf(ctor);
+            if (declared === undefined)
+                throw new DevRefused(404, DRAWS_NONE(slug));
+            // Report a throwing view in the pane instead of breaking the conversation screen.
+            try {
+                return { name: declared.name, nodes: renderToNodes(await declared.draw(who)) };
+            }
+            catch (failed) {
+                throw new DevRefused(502, `${slug}'s view failed: ${failed instanceof Error ? failed.message : String(failed)}`);
+            }
+        },
+    };
+}
+function aConversation(asked) {
+    if (typeof asked !== "object" || asked === null || Array.isArray(asked)) {
+        throw new DevRefused(422, "a panel is asked for with a JSON object");
+    }
+    const said = asked;
+    return { contact: aName(said, "contact"), call: aName(said, "call") };
+}
+function aName(said, name) {
+    const value = said[name];
+    if (typeof value !== "string" || value === "")
+        throw new DevRefused(422, `${name} is a name, and it was missing`);
+    return value;
+}
+//# sourceMappingURL=viewing.js.map

package/dist/serve/viewing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewing.js","sourceRoot":"","sources":["../../src/serve/viewing.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAY,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAiB,MAAM,mBAAmB,CAAC;AAEjE,+DAA+D;AAC/D,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,4DAA4D,CAAC;AAanH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAc;YACzB,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,GAAG,GAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,QAAQ,KAAK,SAAS;gBAAE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,kFAAkF;YAClF,IAAI,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjF,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,mBAAmB,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,KAAK,CAAC,IAA6B,EAAE,IAAY;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,gCAAgC,CAAC,CAAC;IAClH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/views/built-in-rules.d.ts

@@ -0,0 +1,9 @@
+/** The framework's own words in the identity block: the rules, the protocols, and the channel's. */
+import { type Medium } from "../wire/defs.js";
+/** The rules every agent is given. */
+export declare const RULES: string;
+/** The protocols every agent is given. */
+export declare const PROTOCOLS: string;
+/** How to write on this channel and medium: WhatsApp's formatting, a website's Markdown, or speech. */
+export declare function channelRulesFor(channel: string | undefined, medium: Medium): string;
+//# sourceMappingURL=built-in-rules.d.ts.map

package/dist/views/built-in-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-rules.d.ts","sourceRoot":"","sources":["../../src/views/built-in-rules.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAEpG,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C,sCAAsC;AACtC,eAAO,MAAM,KAAK,QAIN,CAAC;AAEb,0CAA0C;AAC1C,eAAO,MAAM,SAAS,QAIV,CAAC;AAYb,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnF"}

package/dist/views/built-in-rules.js

@@ -0,0 +1,28 @@
+/** The framework's own words in the identity block: the rules, the protocols, and the channel's. */
+import {} from "../wire/defs.js";
+// English for every agent: a model follows English instructions and answers in any language.
+// Constant within a call, so they stay in the cached prompt prefix.
+/** The rules every agent is given. */
+export const RULES = [
+    "- Invent nothing: if it did not come from a tool or from the knowledge, do not say it.",
+    "- One question per turn, and wait for the answer.",
+    "- Answer in the language the caller speaks.",
+].join("\n");
+/** The protocols every agent is given. */
+export const PROTOCOLS = [
+    "- To act, call a tool; saying you have done something does not do it.",
+    "- Before an irreversible action read back what you are about to do and wait for an explicit yes.",
+    "- If you cannot solve it, say so and offer to hand over to a person.",
+].join("\n");
+const SPOKEN = "You are on a phone call. Everything you write is read aloud by a voice: short spoken sentences, " +
+    "no lists, no bold, no symbols, no links. Say an email or a web address the way a person says it out loud.";
+const ON_A_WEBSITE = "You are in a written chat on a website. Markdown is fine: short paragraphs, a list when there " +
+    "are steps, bold for the one thing that matters.";
+const ON_WHATSAPP = "You are on WhatsApp. Use its formatting: *bold*, _italic_, no headings, no tables, short messages.";
+/** How to write on this channel and medium: WhatsApp's formatting, a website's Markdown, or speech. */
+export function channelRulesFor(channel, medium) {
+    if (channel === "whatsapp")
+        return ON_WHATSAPP;
+    return channel === "web" && medium === "text" ? ON_A_WEBSITE : SPOKEN;
+}
+//# sourceMappingURL=built-in-rules.js.map

package/dist/views/built-in-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-rules.js","sourceRoot":"","sources":["../../src/views/built-in-rules.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAEpG,OAAO,EAAe,MAAM,iBAAiB,CAAC;AAE9C,6FAA6F;AAC7F,oEAAoE;AAEpE,sCAAsC;AACtC,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,wFAAwF;IACxF,mDAAmD;IACnD,6CAA6C;CAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,0CAA0C;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,uEAAuE;IACvE,kGAAkG;IAClG,sEAAsE;CACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,MAAM,GACV,kGAAkG;IAClG,2GAA2G,CAAC;AAE9G,MAAM,YAAY,GAChB,gGAAgG;IAChG,iDAAiD,CAAC;AAEpD,MAAM,WAAW,GAAG,oGAAoG,CAAC;AAEzH,uGAAuG;AACvG,MAAM,UAAU,eAAe,CAAC,OAA2B,EAAE,MAAc;IACzE,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC;IAC/C,OAAO,OAAO,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AACxE,CAAC"}

package/dist/views/components.d.ts

@@ -0,0 +1,17 @@
+/** Prompt components: rules, protocols, sections and examples, rendered to text. */
+import { type Component } from "./jsx-runtime.js";
+/** A single rule, rendered as a bullet line. */
+export declare const Rule: Component;
+/** A `<rules>` block, one child per line. */
+export declare const Rules: Component;
+/** A `<protocols>` block: behaviour that holds in every state. */
+export declare const Protocols: Component;
+/** A section with a `## title` heading and its children as paragraphs. */
+export declare const Section: Component;
+/** An `<example>` block, so the model reads it as an example rather than an instruction. */
+export declare const Example: Component;
+/** A paragraph; equivalent to the `<p>` tag. */
+export declare const p: Component;
+/** Wrap `body` in `<name>` tags, or return "" when it is empty. */
+export declare function tagged(name: string, body: string): string;
+//# sourceMappingURL=components.d.ts.map

package/dist/views/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/views/components.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAkD,KAAK,SAAS,EAAc,MAAM,kBAAkB,CAAC;AAE9G,gDAAgD;AAChD,eAAO,MAAM,IAAI,EAAE,SAAkE,CAAC;AAGtF,6CAA6C;AAC7C,eAAO,MAAM,KAAK,EAAE,SAAoD,CAAC;AAEzE,kEAAkE;AAClE,eAAO,MAAM,SAAS,EAAE,SAAwD,CAAC;AAEjF,0EAA0E;AAC1E,eAAO,MAAM,OAAO,EAAE,SAKrB,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,OAAO,EAAE,SAAuE,CAAC;AAE9F,gDAAgD;AAChD,eAAO,MAAM,CAAC,EAAE,SAAoD,CAAC;AAGrE,mEAAmE;AAEnE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/views/components.js

@@ -0,0 +1,33 @@
+/** Prompt components: rules, protocols, sections and examples, rendered to text. */
+import { blocks, renderInline, renderToText } from "./jsx-runtime.js";
+/** A single rule, rendered as a bullet line. */
+export const Rule = (props) => `- ${renderInline(children(props)).trim()}`;
+Rule.inline = true;
+/** A `<rules>` block, one child per line. */
+export const Rules = (props) => tagged("rules", lines(props));
+/** A `<protocols>` block: behaviour that holds in every state. */
+export const Protocols = (props) => tagged("protocols", lines(props));
+/** A section with a `## title` heading and its children as paragraphs. */
+export const Section = (props) => {
+    const body = renderToText(children(props));
+    const title = String(props["title"] ?? "").trim();
+    if (!title)
+        return body;
+    return body ? `## ${title}\n\n${body}` : `## ${title}`;
+};
+/** An `<example>` block, so the model reads it as an example rather than an instruction. */
+export const Example = (props) => tagged("example", renderToText(children(props)));
+/** A paragraph; equivalent to the `<p>` tag. */
+export const p = (props) => renderInline(children(props));
+p.inline = true;
+/** Wrap `body` in `<name>` tags, or return "" when it is empty. */
+export function tagged(name, body) {
+    return body ? `<${name}>\n${body}\n</${name}>` : "";
+}
+function children(props) {
+    return (props["children"] ?? null);
+}
+function lines(props) {
+    return blocks(children(props)).join("\n");
+}
+//# sourceMappingURL=components.js.map

package/dist/views/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/views/components.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAA0C,MAAM,kBAAkB,CAAC;AAE9G,gDAAgD;AAChD,MAAM,CAAC,MAAM,IAAI,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACtF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;AAEnB,6CAA6C;AAC7C,MAAM,CAAC,MAAM,KAAK,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAEzE,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAc,CAAC,KAAK,EAAE,EAAE;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,OAAO,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE9F,gDAAgD;AAChD,MAAM,CAAC,MAAM,CAAC,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;AAEhB,mEAAmE;AAEnE,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY;IAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAY;IAC5B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAU,CAAC;AAC9C,CAAC;AAED,SAAS,KAAK,CAAC,KAAY;IACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/views/jsx-dev-runtime.d.ts

@@ -0,0 +1,3 @@
+/** The dev-mode JSX runtime entry: re-exports the production runtime. */
+export * from "./jsx-runtime.js";
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/views/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../../src/views/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAIzE,cAAc,kBAAkB,CAAC"}

package/dist/views/jsx-dev-runtime.js

@@ -0,0 +1,4 @@
+/** The dev-mode JSX runtime entry: re-exports the production runtime. */
+// A re-export so dev and prod builds render identical prompts.
+export * from "./jsx-runtime.js";
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/views/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","sourceRoot":"","sources":["../../src/views/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,+DAA+D;AAE/D,cAAc,kBAAkB,CAAC"}

package/dist/views/jsx-runtime.d.ts

@@ -0,0 +1,46 @@
+/** The JSX runtime: elements form a tree that renders to text, not DOM. */
+/** Anything a component may return; arrays nest and falsy values render nothing. */
+export type Child = Element | string | number | boolean | null | undefined | Child[];
+export type Props = Record<string, unknown>;
+/** A function component from props to renderable children. */
+export interface Component {
+    (props: Props): Child;
+    /** Rendered on one line inside its parent instead of as its own paragraph. */
+    inline?: boolean;
+}
+/** A JSX element: a tag and its props (including `children`). */
+export interface Element {
+    readonly kind: "element";
+    readonly type: string | Component | typeof Fragment;
+    readonly props: Props;
+}
+/** `<>…</>`: groups siblings without adding text. */
+export declare const Fragment: unique symbol;
+/** Element factory for the automatic JSX runtime; also exported as `jsxs` and `jsxDEV`. */
+export declare function jsx(type: Element["type"], props: Props): Element;
+export { jsx as jsxs, jsx as jsxDEV };
+/** Render a child inline. Strings keep their spacing, so `{name} tiene cita` stays intact. */
+export declare function renderInline(child: Child): string;
+/**
+ * Render a child as text: siblings become paragraphs separated by a blank line, falsy values
+ * render nothing, and strings are trimmed.
+ */
+export declare function renderToText(child: Child): string;
+/** Render each child as a separate block, dropping empty ones. */
+export declare function blocks(child: Child): string[];
+/** JSX types TypeScript resolves through `jsxImportSource`. */
+type TextElement = Element;
+export declare namespace JSX {
+    type Element = TextElement;
+    /** An intrinsic tag or a function component; class components are not supported. */
+    type ElementType = string | ((props: never) => Child) | Component;
+    interface ElementChildrenAttribute {
+        children: object;
+    }
+    interface IntrinsicElements {
+        p: {
+            children?: Child;
+        };
+    }
+}
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/views/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/views/jsx-runtime.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,oFAAoF;AACpF,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;AAErF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,QAAQ,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ,eAAwC,CAAC;AAE9D,2FAA2F;AAC3F,wBAAgB,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAEhE;AAED,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;AAWtC,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAmB7C;AAED,+DAA+D;AAC/D,KAAK,WAAW,GAAG,OAAO,CAAC;AAE3B,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,KAAK,OAAO,GAAG,WAAW,CAAC;IAC3B,oFAAoF;IAEpF,KAAK,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,GAAG,SAAS,CAAC;IAClE,UAAU,wBAAwB;QAChC,QAAQ,EAAE,MAAM,CAAC;KAClB;IACD,UAAU,iBAAiB;QACzB,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;SAAE,CAAC;KACzB;CACF"}

package/dist/views/jsx-runtime.js

@@ -0,0 +1,63 @@
+/** The JSX runtime: elements form a tree that renders to text, not DOM. */
+/** `<>…</>`: groups siblings without adding text. */
+export const Fragment = Symbol.for("pinecall.views.fragment");
+/** Element factory for the automatic JSX runtime; also exported as `jsxs` and `jsxDEV`. */
+export function jsx(type, props) {
+    return { kind: "element", type, props: props ?? {} };
+}
+export { jsx as jsxs, jsx as jsxDEV };
+function childrenOf(props) {
+    return (props["children"] ?? null);
+}
+// Collapse JSX source newlines and indentation into single spaces.
+function paragraph(text) {
+    return text.replace(/\s*\n\s*/g, " ").replace(/[ \t]{2,}/g, " ").trim();
+}
+/** Render a child inline. Strings keep their spacing, so `{name} tiene cita` stays intact. */
+export function renderInline(child) {
+    if (child === null || child === undefined || typeof child === "boolean")
+        return "";
+    if (typeof child === "string")
+        return child;
+    if (typeof child === "number")
+        return String(child);
+    if (Array.isArray(child))
+        return child.map(renderInline).join("");
+    const { type, props } = child;
+    if (typeof type === "function")
+        return renderInline(type(props));
+    return renderInline(childrenOf(props));
+}
+/**
+ * Render a child as text: siblings become paragraphs separated by a blank line, falsy values
+ * render nothing, and strings are trimmed.
+ */
+export function renderToText(child) {
+    return blocks(child).join("\n\n");
+}
+/** Render each child as a separate block, dropping empty ones. */
+export function blocks(child) {
+    if (child === null || child === undefined || typeof child === "boolean")
+        return [];
+    if (typeof child === "string")
+        return child.trim() ? [child.trim()] : [];
+    if (typeof child === "number")
+        return [String(child)];
+    if (Array.isArray(child))
+        return child.flatMap(blocks);
+    const { type, props } = child;
+    if (typeof type === "function") {
+        if (type.inline) {
+            const line = paragraph(renderInline(child));
+            return line ? [line] : [];
+        }
+        return blocks(type(props));
+    }
+    // `<p>` is the only intrinsic tag; other lowercase tags render just their children.
+    if (type === "p") {
+        const line = paragraph(renderInline(childrenOf(props)));
+        return line ? [line] : [];
+    }
+    return blocks(childrenOf(props));
+}
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/views/jsx-runtime.js.map

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

package/dist/views/layout.d.ts

@@ -0,0 +1,19 @@
+/** Prompt layout: named blocks in send order, static, then history, then dynamic. */
+import { type PromptBlockSpec } from "../wire/defs.js";
+import { type Agent } from "../agent/agent.js";
+/** A rendered prompt block: name, region and text. */
+export interface Block extends PromptBlockSpec {
+    text: string;
+}
+/** The rendered prompt. Only `dynamic` blocks may differ between turns, to keep the cache prefix. */
+export interface Blocks {
+    /** Blocks in send order; the history goes between the static and dynamic ones. */
+    blocks: Block[];
+    /** `collapse()` summaries, for the printed page; the runtime owns the actual history. */
+    history: string;
+}
+/** Prompt block names and regions, in send order. */
+export declare const PROMPT_BLOCKS: readonly PromptBlockSpec[];
+/** Render every prompt block in send order. */
+export declare function layout(agent: Agent): Blocks;
+//# sourceMappingURL=layout.d.ts.map

package/dist/views/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/views/layout.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAMrE,sDAAsD;AACtD,MAAM,WAAW,KAAM,SAAQ,eAAe;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qGAAqG;AACrG,MAAM,WAAW,MAAM;IACrB,kFAAkF;IAClF,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,qDAAqD;AACrD,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAAyD,CAAC;AAE9G,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG3C"}

package/dist/views/layout.js

@@ -0,0 +1,58 @@
+/** Prompt layout: named blocks in send order, static, then history, then dynamic. */
+import {} from "../wire/defs.js";
+import { changes, internalsOf } from "../agent/agent.js";
+import { docOf, toolsOf } from "../agent/tools.js";
+import { tagged } from "./components.js";
+import { channelRulesFor, PROTOCOLS, RULES } from "./built-in-rules.js";
+import { renderToText } from "./jsx-runtime.js";
+// Static blocks are cached; the view is the only dynamic block and comes last, after the history,
+// so per-turn guidance is what the model reads last.
+const BLOCKS = [
+    { name: "identity", region: "static", text: identityBlock },
+    // Filled by the gateway from the agent's settings (`pinecall agent knowledge`); the app sends "".
+    { name: "knowledge", region: "static", text: () => "" },
+    { name: "tools", region: "static", text: toolsBlock },
+    { name: "view", region: "dynamic", text: viewBlock },
+];
+/** Prompt block names and regions, in send order. */
+export const PROMPT_BLOCKS = BLOCKS.map(({ name, region }) => ({ name, region }));
+/** Render every prompt block in send order. */
+export function layout(agent) {
+    const blocks = BLOCKS.map(({ name, region, text }) => ({ name, region, text: text(agent) }));
+    return { blocks, history: collapsedHistory(agent) };
+}
+/** Class docstring, built-in rules and protocols, and the channel's. Reads no state. */
+function identityBlock(agent) {
+    return paragraphs([docOf(agent) ?? "", tagged("rules", RULES), tagged("protocols", PROTOCOLS), channelBlock(agent)]);
+}
+// Static because a call never changes its channel or medium. With no call (an offline prompt), a
+// phone call's.
+function channelBlock(agent) {
+    if (agent.channelRules === false)
+        return "";
+    const call = internalsOf(agent).call;
+    return tagged("channel", channelRulesFor(call?.channel, call?.medium ?? "voice"));
+}
+// Lists every declared tool, visible or not, so this block stays static. Schemas go on the wire.
+function toolsBlock(agent) {
+    const docs = toolsOf(agent)
+        .map((declared) => `- ${declared.name}: ${declared.spec.description}`)
+        .join("\n");
+    return tagged("tools", docs);
+}
+// Only the tenant's `render()` output. Recalled facts and retrieved chunks reach the model as tool
+// results, never here (runtime docs/security/prompt-injection.md).
+function viewBlock(agent) {
+    return renderToText(agent.render());
+}
+/** Summaries left by `collapse()`; the runtime owns the actual turns. */
+function collapsedHistory(agent) {
+    return changes(agent)
+        .filter((change) => change.field === "@summary")
+        .map((change) => String(change.next))
+        .join("\n\n");
+}
+function paragraphs(parts) {
+    return parts.filter((part) => part.trim()).join("\n\n");
+}
+//# sourceMappingURL=layout.js.map

package/dist/views/layout.js.map

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