@pinecall/agents 0.9.20

package/dist/views/nodes.d.ts

@@ -0,0 +1,48 @@
+/** Render view JSX to a node tree the console draws (not DOM). */
+import { type Child, type Component, type Props } from "./jsx-runtime.js";
+/** Badge tone; the console maps it to colours. */
+export type Tone = "neutral" | "good" | "warn" | "bad";
+/**
+ * One node of a view. The set is closed and drawn by the console's own components, so tenant
+ * panels cannot inject styles or scripts.
+ */
+export type ViewNode = {
+    tag: "panel";
+    title: string | null;
+    children: ViewNode[];
+} | {
+    tag: "rows";
+    children: ViewNode[];
+} | {
+    tag: "row";
+    label: string;
+    value: string;
+} | {
+    tag: "stat";
+    label: string;
+    value: string;
+} | {
+    tag: "table";
+    columns: string[];
+    rows: string[][];
+} | {
+    tag: "badge";
+    tone: Tone;
+    text: string;
+} | {
+    tag: "text";
+    text: string;
+};
+/** A panel component, with a builder for its node. */
+export interface Panels extends Component {
+    /** Set on built-in panel tags; other functions are called as ordinary components. */
+    node?: (props: Props, children: ViewNode[]) => ViewNode | null;
+}
+/** Format a value for display; null, undefined and booleans become "". */
+export declare function said(value: unknown): string;
+/**
+ * Render a child to view nodes. Panel tags become nodes, other components are called, strings and
+ * numbers become text. Components inside the tree must be synchronous; only the view itself may be async.
+ */
+export declare function renderToNodes(child: Child): ViewNode[];
+//# sourceMappingURL=nodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/views/nodes.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAAY,KAAK,KAAK,EAAE,KAAK,SAAS,EAAgB,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAElG,kDAAkD;AAClD,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC5D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,EAAE,CAAA;CAAE,GACrC;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,GACrD;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,sDAAsD;AACtD,MAAM,WAAW,MAAO,SAAQ,SAAS;IACvC,qFAAqF;IACrF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,QAAQ,GAAG,IAAI,CAAC;CAChE;AAED,0EAA0E;AAC1E,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,CAMtD"}

package/dist/views/nodes.js

@@ -0,0 +1,45 @@
+/** Render view JSX to a node tree the console draws (not DOM). */
+import { Fragment } from "./jsx-runtime.js";
+/** Format a value for display; null, undefined and booleans become "". */
+export function said(value) {
+    if (value === null || value === undefined || typeof value === "boolean")
+        return "";
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "string")
+        return value;
+    return String(value);
+}
+/**
+ * Render a child to view nodes. Panel tags become nodes, other components are called, strings and
+ * numbers become text. Components inside the tree must be synchronous; only the view itself may be async.
+ */
+export function renderToNodes(child) {
+    if (child === null || child === undefined || typeof child === "boolean")
+        return [];
+    if (typeof child === "string")
+        return child.trim() === "" ? [] : [{ tag: "text", text: child.trim() }];
+    if (typeof child === "number")
+        return [{ tag: "text", text: String(child) }];
+    if (Array.isArray(child))
+        return child.flatMap(renderToNodes);
+    return nodesOfElement(child);
+}
+function nodesOfElement(element) {
+    const { type, props } = element;
+    if (type === Fragment)
+        return renderToNodes(childrenOf(props));
+    if (typeof type === "function") {
+        const tag = type;
+        if (tag.node === undefined)
+            return renderToNodes(tag(props));
+        const node = tag.node(props, renderToNodes(childrenOf(props)));
+        return node === null ? [] : [node];
+    }
+    // Views have no intrinsic tags: a lowercase tag renders only its children.
+    return renderToNodes(childrenOf(props));
+}
+function childrenOf(props) {
+    return (props["children"] ?? null);
+}
+//# sourceMappingURL=nodes.js.map

package/dist/views/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/views/nodes.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAAE,QAAQ,EAAwD,MAAM,kBAAkB,CAAC;AAwBlG,0EAA0E;AAC1E,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvG,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,cAAc,CAAC,OAAgB;IACtC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAChC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAc,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,2EAA2E;IAE3E,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,UAAU,CAAC,KAAY;IAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAU,CAAC;AAC9C,CAAC"}

package/dist/views/panels.d.ts

@@ -0,0 +1,17 @@
+/** Panel components for views (`@pinecall/agents/panels`), drawn by the console. */
+import { type Panels } from "./nodes.js";
+/** A titled section; several stack vertically. */
+export declare const Panel: Panels;
+/** A list of labelled rows. */
+export declare const Rows: Panels;
+/** A labelled line, e.g. `Alta · 12 Mar 2024`. Value from `value` or the children. */
+export declare const Row: Panels;
+/** A prominent labelled number. */
+export declare const Stat: Panels;
+/** A table. Each of `rows` is an array in column order, or an object keyed by column name. */
+export declare const Table: Panels;
+/** A status badge with a `tone`: neutral, good, warn or bad. */
+export declare const Badge: Panels;
+/** A line of text. */
+export declare const Text: Panels;
+//# sourceMappingURL=panels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../src/views/panels.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAGpF,OAAO,EAAQ,KAAK,MAAM,EAA4B,MAAM,YAAY,CAAC;AAazE,kDAAkD;AAClD,eAAO,MAAM,KAAK,QAIf,CAAC;AAEJ,+BAA+B;AAC/B,eAAO,MAAM,IAAI,QAAiE,CAAC;AAEnF,sFAAsF;AACtF,eAAO,MAAM,GAAG,QAIb,CAAC;AAEJ,mCAAmC;AACnC,eAAO,MAAM,IAAI,QAAsG,CAAC;AAExH,8FAA8F;AAC9F,eAAO,MAAM,KAAK,QAIhB,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,KAAK,QAIf,CAAC;AAEJ,sBAAsB;AACtB,eAAO,MAAM,IAAI,QAGf,CAAC"}

package/dist/views/panels.js

@@ -0,0 +1,62 @@
+/** Panel components for views (`@pinecall/agents/panels`), drawn by the console. */
+import { said } from "./nodes.js";
+// Calling the function body means the tag was used in a prompt; throw instead of leaking panel text.
+const NOT_A_PROMPT = (tag) => `<${tag}> belongs to a view, not to a prompt: render() writes text, view() draws a panel`;
+function tag(name, node) {
+    const component = () => {
+        throw new TypeError(NOT_A_PROMPT(name));
+    };
+    component.node = node;
+    return component;
+}
+/** A titled section; several stack vertically. */
+export const Panel = tag("Panel", (props, children) => ({
+    tag: "panel",
+    title: props["title"] === undefined ? null : said(props["title"]),
+    children,
+}));
+/** A list of labelled rows. */
+export const Rows = tag("Rows", (_props, children) => ({ tag: "rows", children }));
+/** A labelled line, e.g. `Alta · 12 Mar 2024`. Value from `value` or the children. */
+export const Row = tag("Row", (props, children) => ({
+    tag: "row",
+    label: said(props["label"]),
+    value: props["value"] === undefined ? textOf(children) : said(props["value"]),
+}));
+/** A prominent labelled number. */
+export const Stat = tag("Stat", (props) => ({ tag: "stat", label: said(props["label"]), value: said(props["value"]) }));
+/** A table. Each of `rows` is an array in column order, or an object keyed by column name. */
+export const Table = tag("Table", (props) => {
+    const columns = Array.isArray(props["columns"]) ? props["columns"].map(said) : [];
+    const given = Array.isArray(props["rows"]) ? props["rows"] : [];
+    return { tag: "table", columns, rows: given.map((row) => cells(row, columns)) };
+});
+/** A status badge with a `tone`: neutral, good, warn or bad. */
+export const Badge = tag("Badge", (props, children) => ({
+    tag: "badge",
+    tone: toneOf(props["tone"]),
+    text: props["text"] === undefined ? textOf(children) : said(props["text"]),
+}));
+/** A line of text. */
+export const Text = tag("Text", (_props, children) => {
+    const text = textOf(children);
+    return text === "" ? null : { tag: "text", text };
+});
+const TONES = ["neutral", "good", "warn", "bad"];
+function toneOf(given) {
+    return typeof given === "string" && TONES.includes(given) ? given : "neutral";
+}
+function cells(row, columns) {
+    if (Array.isArray(row))
+        return row.map(said);
+    if (row !== null && typeof row === "object")
+        return columns.map((column) => said(row[column]));
+    return [said(row)];
+}
+function textOf(children) {
+    return children
+        .map((node) => (node.tag === "text" ? node.text : ""))
+        .filter((text) => text !== "")
+        .join(" ");
+}
+//# sourceMappingURL=panels.js.map

package/dist/views/panels.js.map

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

package/dist/views/render.d.ts

@@ -0,0 +1,11 @@
+/** Render the prompt as blocks for the runtime, or as a readable page. */
+import { type PromptRegion } from "../wire/defs.js";
+import type { Agent } from "../agent/agent.js";
+import { type Blocks } from "./layout.js";
+/** The agent's current prompt, block by block in send order. */
+export declare function promptOf(agent: Agent): Blocks;
+/** Section header for the printed prompt: the block name, with its region when given. */
+export declare function headerFor(name: string, region?: PromptRegion): string;
+/** The prompt as one readable page (static blocks, history, dynamic), as `--show-prompt` prints it. */
+export declare function showPrompt(agent: Agent): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/views/render.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAElD,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE7C;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAErE;AAED,uGAAuG;AAEvG,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAO/C"}

package/dist/views/render.js

@@ -0,0 +1,19 @@
+/** Render the prompt as blocks for the runtime, or as a readable page. */
+import {} from "../wire/defs.js";
+import { layout } from "./layout.js";
+/** The agent's current prompt, block by block in send order. */
+export function promptOf(agent) {
+    return layout(agent);
+}
+/** Section header for the printed prompt: the block name, with its region when given. */
+export function headerFor(name, region) {
+    return region === undefined ? `── ${name} ──` : `── ${name} (${region}) ──`;
+}
+/** The prompt as one readable page (static blocks, history, dynamic), as `--show-prompt` prints it. */
+export function showPrompt(agent) {
+    const { blocks, history } = promptOf(agent);
+    const section = (name, text, region) => `${headerFor(name, region)}\n${text}`.trimEnd();
+    const of = (region) => blocks.filter((block) => block.region === region).map((block) => section(block.name, block.text, region));
+    return [...of("static"), section("history", history), ...of("dynamic")].join("\n\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/views/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/views/render.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAqB,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAElD,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,KAAY;IACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAqB;IAC3D,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,MAAM,MAAM,CAAC;AAC9E,CAAC;AAED,uGAAuG;AAEvG,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,MAAqB,EAAU,EAAE,CAC5E,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,EAAE,GAAG,CAAC,MAAoB,EAAY,EAAE,CAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5G,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvF,CAAC"}

package/dist/wire/agent-config.d.ts

@@ -0,0 +1,213 @@
+/** An agent as its app declares it to the gateway: voice, models, turns, views, docs, memory. */
+import { z } from "zod";
+/** Which voice speaks for the agent: the name it was asked for, or the id the provider knows it by. */
+export declare const VoiceConfigSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    voice_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/** Which model does a job (the LLM, or the STT), and the one or two knobs worth turning. */
+export declare const ModelConfigSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    temperature: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type ModelConfig = z.infer<typeof ModelConfigSchema>;
+/** How the session decides that the caller has finished, and when the caller may interrupt. */
+export declare const TurnConfigSchema: z.ZodObject<{
+    min_interruption_words: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    endpointing_ms: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    eot_threshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    eager_eot_threshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+/** How the voice says one word it would otherwise get wrong: a proper name, a brand, a street. */
+export declare const PronunciationSchema: z.ZodObject<{
+    word: z.ZodString;
+    spoken: z.ZodString;
+}, z.core.$strict>;
+/**
+ * What the app declares about one field of its state: who may see it. A field never declared is
+ * tenant.
+ */
+export declare const StateFieldSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    visibility: z.ZodEnum<{
+        pii: "pii";
+        public: "public";
+        tenant: "tenant";
+    }>;
+}, z.core.$strict>;
+/**
+ * The panel the agent draws beside a conversation: it is declared here so a console knows the
+ * agent has one before it asks for it, and draws its own about the contact when it has not. What
+ * the panel CONTAINS never comes this way — it is asked for a conversation at a time, through the
+ * view.render dev verb.
+ */
+export declare const ViewSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strict>;
+/**
+ * One outside event the agent accepts, and from whom. An event nobody declared is refused before
+ * it touches the log.
+ */
+export declare const EventSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    from: z.ZodArray<z.ZodEnum<{
+        app: "app";
+        participant: "participant";
+    }>>;
+}, z.core.$strict>;
+/** One file of a base, as a push sends it: its path as the tenant keeps it, and its text. */
+export declare const KnowledgeFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strict>;
+export type KnowledgeFile = z.infer<typeof KnowledgeFileSchema>;
+/**
+ * The knowledge base the agent answers from, and how its chunks reach the model. It is named by
+ * the base it was pushed under, with PUT /v1/knowledge/{base}.
+ */
+export declare const DocsConfigSchema: z.ZodObject<{
+    base: z.ZodString;
+    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        retrieved: "retrieved";
+        tool: "tool";
+    }>>>;
+    k: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    min_score: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type DocsConfig = z.infer<typeof DocsConfigSchema>;
+/**
+ * How the agent opens a call, before the caller has said anything. Exactly one of the two, because
+ * there are only two ways to open one: `say` are the words themselves and `reply` is what the
+ * model is told before it finds its own. They are agent.say and agent.reply declared instead of
+ * called, so a class that opens every call the same way needs no onCall hook to do it, and an
+ * operator can turn the opening at the pipeline door without a deploy. Absent: nobody speaks until
+ * the caller does.
+ */
+export declare const GreetingConfigSchema: z.ZodObject<{
+    say: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reply: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    allow_interruptions: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strict>;
+/**
+ * Whether the model may end the call itself. Declaring this is what puts livekit's own end_call
+ * tool in front of the model; a class that says nothing here cannot hang up, and the call ends
+ * when the caller does or when a supervisor says so. The tool is hidden while the agent is
+ * greeting, because a model that can hang up on its first turn eventually does.
+ */
+export declare const HangupConfigSchema: z.ZodObject<{
+    when: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * What memory keeps about a contact across calls, and what it must never keep. Both lists are in
+ * the tenant's own words.
+ */
+export declare const MemoryConfigSchema: z.ZodObject<{
+    remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
+/**
+ * What an app declares about its agent: the prompt's layout, the tools, whether it searches its
+ * bases itself, and who may see and send what. Every field is optional so a configure can change
+ * one thing. The environment — voice, models, language, greeting, hangup, turn, says, hears,
+ * knowledge, docs, memory — is the world's, set in the agent's settings, and no longer read off
+ * this declaration.
+ */
+export declare const AgentConfigSchema: z.ZodObject<{
+    prompt: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        region: z.ZodEnum<{
+            dynamic: "dynamic";
+            static: "static";
+        }>;
+    }, z.core.$strict>>>>;
+    greeting: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        say: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reply: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        allow_interruptions: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strict>>>;
+    voice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        voice_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    llm: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        temperature: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>;
+    stt: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        temperature: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>;
+    turn: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        min_interruption_words: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        endpointing_ms: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        eot_threshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        eager_eot_threshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>;
+    says: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        spoken: z.ZodString;
+    }, z.core.$strict>>>>;
+    hears: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    knowledge: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>>;
+    docs: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        base: z.ZodString;
+        mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            retrieved: "retrieved";
+            tool: "tool";
+        }>>>;
+        k: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        min_score: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>;
+    memory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>>>;
+    hangup: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        when: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    record: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        side_effect: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            irreversible: "irreversible";
+            read: "read";
+            write: "write";
+        }>>>;
+        confirm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pii: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        timeout_s: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>>;
+    uses_knowledge: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    state_fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        visibility: z.ZodEnum<{
+            pii: "pii";
+            public: "public";
+            tenant: "tenant";
+        }>;
+    }, z.core.$strict>>>>;
+    view: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>>>;
+    events: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        from: z.ZodArray<z.ZodEnum<{
+            app: "app";
+            participant: "participant";
+        }>>;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>;
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+//# sourceMappingURL=agent-config.d.ts.map

package/dist/wire/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../src/wire/agent-config.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAEjG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,uGAAuG;AACvG,eAAO,MAAM,iBAAiB;;;;;kBAK5B,CAAC;AAEH,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB;;;;kBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB;;;;;kBAK3B,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,mBAAmB;;;kBAG9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;kBAG/B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;kBAEzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;kBAG1B,CAAC;AAEH,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB;;;kBAG9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;kBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;kBAI/B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;kBAE7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;kBAG7B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/wire/agent-config.js

@@ -0,0 +1,126 @@
+/** An agent as its app declares it to the gateway: voice, models, turns, views, docs, memory. */
+import { z } from "zod";
+import { DocsModeSchema, EventSourceSchema, PromptBlockSpecSchema, ToolSpecSchema, VisibilitySchema, } from "./defs.js";
+/** Which voice speaks for the agent: the name it was asked for, or the id the provider knows it by. */
+export const VoiceConfigSchema = z.strictObject({
+    name: z.string().nullish(),
+    provider: z.string().nullish(),
+    model: z.string().nullish(),
+    voice_id: z.string().nullish(),
+});
+/** Which model does a job (the LLM, or the STT), and the one or two knobs worth turning. */
+export const ModelConfigSchema = z.strictObject({
+    provider: z.string(),
+    model: z.string(),
+    temperature: z.number().nullish(),
+});
+/** How the session decides that the caller has finished, and when the caller may interrupt. */
+export const TurnConfigSchema = z.strictObject({
+    min_interruption_words: z.int().nullish(),
+    endpointing_ms: z.int().nullish(),
+    eot_threshold: z.number().nullish(),
+    eager_eot_threshold: z.number().nullish(),
+});
+/** How the voice says one word it would otherwise get wrong: a proper name, a brand, a street. */
+export const PronunciationSchema = z.strictObject({
+    word: z.string(),
+    spoken: z.string(),
+});
+/**
+ * What the app declares about one field of its state: who may see it. A field never declared is
+ * tenant.
+ */
+export const StateFieldSpecSchema = z.strictObject({
+    name: z.string(),
+    visibility: VisibilitySchema,
+});
+/**
+ * The panel the agent draws beside a conversation: it is declared here so a console knows the
+ * agent has one before it asks for it, and draws its own about the contact when it has not. What
+ * the panel CONTAINS never comes this way — it is asked for a conversation at a time, through the
+ * view.render dev verb.
+ */
+export const ViewSpecSchema = z.strictObject({
+    name: z.string(),
+});
+/**
+ * One outside event the agent accepts, and from whom. An event nobody declared is refused before
+ * it touches the log.
+ */
+export const EventSpecSchema = z.strictObject({
+    name: z.string(),
+    from: z.array(EventSourceSchema),
+});
+/** One file of a base, as a push sends it: its path as the tenant keeps it, and its text. */
+export const KnowledgeFileSchema = z.strictObject({
+    path: z.string(),
+    text: z.string(),
+});
+/**
+ * The knowledge base the agent answers from, and how its chunks reach the model. It is named by
+ * the base it was pushed under, with PUT /v1/knowledge/{base}.
+ */
+export const DocsConfigSchema = z.strictObject({
+    base: z.string(),
+    mode: DocsModeSchema.nullish(),
+    k: z.int().nullish(),
+    min_score: z.number().nullish(),
+});
+/**
+ * How the agent opens a call, before the caller has said anything. Exactly one of the two, because
+ * there are only two ways to open one: `say` are the words themselves and `reply` is what the
+ * model is told before it finds its own. They are agent.say and agent.reply declared instead of
+ * called, so a class that opens every call the same way needs no onCall hook to do it, and an
+ * operator can turn the opening at the pipeline door without a deploy. Absent: nobody speaks until
+ * the caller does.
+ */
+export const GreetingConfigSchema = z.strictObject({
+    say: z.string().nullish(),
+    reply: z.string().nullish(),
+    allow_interruptions: z.boolean().nullish(),
+});
+/**
+ * Whether the model may end the call itself. Declaring this is what puts livekit's own end_call
+ * tool in front of the model; a class that says nothing here cannot hang up, and the call ends
+ * when the caller does or when a supervisor says so. The tool is hidden while the agent is
+ * greeting, because a model that can hang up on its first turn eventually does.
+ */
+export const HangupConfigSchema = z.strictObject({
+    when: z.string().nullish(),
+});
+/**
+ * What memory keeps about a contact across calls, and what it must never keep. Both lists are in
+ * the tenant's own words.
+ */
+export const MemoryConfigSchema = z.strictObject({
+    remember: z.array(z.string()).nullish(),
+    forget: z.array(z.string()).nullish(),
+});
+/**
+ * What an app declares about its agent: the prompt's layout, the tools, whether it searches its
+ * bases itself, and who may see and send what. Every field is optional so a configure can change
+ * one thing. The environment — voice, models, language, greeting, hangup, turn, says, hears,
+ * knowledge, docs, memory — is the world's, set in the agent's settings, and no longer read off
+ * this declaration.
+ */
+export const AgentConfigSchema = z.strictObject({
+    prompt: z.array(PromptBlockSpecSchema).nullish(),
+    greeting: GreetingConfigSchema.nullish(),
+    voice: VoiceConfigSchema.nullish(),
+    llm: ModelConfigSchema.nullish(),
+    stt: ModelConfigSchema.nullish(),
+    turn: TurnConfigSchema.nullish(),
+    says: z.array(PronunciationSchema).nullish(),
+    hears: z.array(z.string()).nullish(),
+    knowledge: KnowledgeFileSchema.nullish(),
+    docs: DocsConfigSchema.nullish(),
+    memory: MemoryConfigSchema.nullish(),
+    hangup: HangupConfigSchema.nullish(),
+    record: z.boolean().nullish(),
+    tools: z.array(ToolSpecSchema).nullish(),
+    uses_knowledge: z.boolean().nullish(),
+    state_fields: z.array(StateFieldSpecSchema).nullish(),
+    view: ViewSpecSchema.nullish(),
+    events: z.array(EventSpecSchema).nullish(),
+});
+//# sourceMappingURL=agent-config.js.map

package/dist/wire/agent-config.js.map

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

package/dist/wire/codec.d.ts

@@ -0,0 +1,43 @@
+/** An entry read as the event its type names, typed; and the one place a key is renamed. */
+import { z } from "zod";
+import { type Entry } from "./envelope.js";
+import { COMMAND_SCHEMAS, type CommandType, EVENT_SCHEMAS, type EventType } from "./registry.js";
+export declare class UnknownType extends Error {
+    readonly name = "UnknownType";
+}
+/** The data shape of one event type. */
+export type EventData<K extends EventType> = z.infer<(typeof EVENT_SCHEMAS)[K]>;
+/** One event, typed by its type: switch on `type` and `data` narrows with it. */
+export type Event = {
+    [K in EventType]: {
+        type: K;
+        data: EventData<K>;
+    };
+}[EventType];
+/** The data shape of one command type. */
+export type CommandData<K extends CommandType> = z.infer<(typeof COMMAND_SCHEMAS)[K]>;
+/** One log line from decoded JSON. A bad shape throws. */
+export declare function decodeEntry(raw: unknown): Entry;
+/** The entry's data as the shape its type names; an unknown type or a bad shape throws. */
+export declare function eventOf(entry: Entry): Event;
+export declare function isEventType(type: string): type is EventType;
+/** "llm_node_ttft" as a type becomes "llmNodeTtft". */
+export type CamelCase<S extends string> = S extends `${infer Head}_${infer Tail}` ? `${Head}${Capitalize<CamelCase<Tail>>}` : S;
+/** "llmNodeTtft" as a type becomes "llm_node_ttft". */
+export type SnakeCase<S extends string> = S extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${SnakeCase<Tail>}` : `_${Lowercase<Head>}${SnakeCase<Tail>}` : S;
+/** A wire shape with every key camelCased, deep, except under the opaque keys. */
+export type Camel<T> = T extends readonly (infer Item)[] ? Camel<Item>[] : T extends object ? {
+    [K in keyof T as K extends string ? CamelCase<K> : K]: K extends OpaqueKey ? T[K] : Camel<T[K]>;
+} : T;
+/** A camelCased shape back to the wire's keys, deep, except under the opaque keys. */
+export type Snake<T> = T extends readonly (infer Item)[] ? Snake<Item>[] : T extends object ? {
+    [K in keyof T as K extends string ? SnakeCase<K> : K]: K extends OpaqueKey ? T[K] : Snake<T[K]>;
+} : T;
+/** The keys whose values belong to the app (its state, a tool's arguments, a map it named): never renamed below them. */
+export declare const OPAQUE_KEYS: Set<string>;
+export type OpaqueKey = "app_state" | "arguments" | "attributes" | "data" | "facts" | "input" | "metadata" | "output" | "parameters" | "prompt" | "result" | "state";
+/** Rename every key from snake_case to camelCase, deep. Values are never touched. */
+export declare function toCamel<T>(value: T): Camel<T>;
+/** Rename every key from camelCase to snake_case, deep. Values are never touched. */
+export declare function toSnake<T>(value: T): Snake<T>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/wire/codec.d.ts.map

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