pinecall 0.4.0 → 0.5.0

package/README.md

@@ -57,22 +57,29 @@ on a laptop in one sitting. To read this code or run the two examples, clone ins
 ```
 pnpm install                       nothing to build: the checkout runs from its sources
 cd examples/clinica-norte
+pnpm exec pinecall link            sign in through a browser, pick the org: your key, in ./.env
 pnpm exec pinecall chat            the agent in this terminal, and a prompt against it
 pnpm exec pinecall prompt --state test/prompts/states.json   the exact prompt a state produces
-pnpm exec pinecall run             the app: the process you deploy
-pnpm exec pinecall run --serve     the same, and its console on http://localhost:4100
+pnpm exec pinecall start           the app: the process you deploy
+pnpm exec pinecall start --serve   the same, and its console on http://localhost:4100
 pnpm exec pinecall serve           that console alone: your sandbox, on this machine
 pnpm exec pinecall knowledge push  ./knowledge/docs to the gateway, under the agent's name
 pnpm exec pinecall test            ring 1: the goldens, through the app in this process
 ```
 
 Two consoles, one per world. What you are running is in the sandbox and is watched on your own
-machine — `pinecall serve` forwards every request to the gateway with the terminal's key, so there
+machine — `pinecall serve` forwards every request to the gateway with the project's key, so there
 is nothing to sign in to. Production is watched on the gateway's own page, which shows production
 and nothing else. [docs/the-cli.md](docs/the-cli.md#serve).
 
-A tenant that installed `pinecall` from npm has it on the PATH and writes `pinecall run`. A
-repository of several agents keeps each in `agents/<name>.tsx`, and one `pinecall run` at its root
+Every verb reads `PINECALL_KEY` (and `PINECALL_URL`, when the gateway is not the cloud) from the
+environment, else from the project's `.env`, which `pinecall link` wrote; each is the sandbox until
+`--prod` says production, for a person whose org lets them act there. On a server the agent runs
+on a server's token from the console's Tokens screen, as `pinecall start --prod` or mounted inside
+your own Node app — [docs/production.md](docs/production.md).
+
+A tenant that installed `pinecall` from npm has it on the PATH and writes `pinecall start`. A
+repository of several agents keeps each in `agents/<name>.tsx`, and one `pinecall start` at its root
 holds them all — [docs/writing-an-agent.md](docs/writing-an-agent.md#several-agents-in-one-project).
 
 Working on the framework itself:
@@ -131,7 +138,8 @@ means editing a list on purpose, which is the point.
 | [docs/testing-an-agent.md](docs/testing-an-agent.md) | the five rings: unit tests, goldens, personas, one call replayed, the score every call gets |
 | [docs/testing-memory-and-knowledge.md](docs/testing-memory-and-knowledge.md) | memory's own goldens, the index's, and why a call has no retrieval score |
 | [docs/the-cli.md](docs/the-cli.md) | every verb, what it needs, and where its key comes from — one agent, or a project of several |
-| [docs/worlds-and-teams.md](docs/worlds-and-teams.md) | from the sign-up to the deploy: the two worlds, what is yours and what is the org's, the team and its seats |
+| [docs/worlds-and-teams.md](docs/worlds-and-teams.md) | one key per person, the production switch, the two worlds, a team from the invitation to the rollback |
+| [docs/production.md](docs/production.md) | running the agent on your own server: the server's token, the two ways, the release push, changes with `--prod` |
 | [CHANGELOG.md](CHANGELOG.md) · [CLAUDE.md](CLAUDE.md) | what changed · the working agreement |
 
 ## The wire

package/dist/cli/agent-files.d.ts

@@ -0,0 +1,6 @@
+/** `pinecall agent pull | push`: a corner's settings as a file, for whoever keeps them in git and CI. */
+import type { Typed } from "./agent.js";
+import { type Door } from "./testing/gateway.js";
+/** The two file verbs, dispatched by `pinecall agent`. */
+export declare function filesRun(door: Door, agent: string, verb: "pull" | "push", rest: string[], values: Typed, out: NodeJS.WritableStream, err: NodeJS.WritableStream): Promise<number>;
+//# sourceMappingURL=agent-files.d.ts.map

package/dist/cli/agent-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-files.d.ts","sourceRoot":"","sources":["../../src/cli/agent-files.ts"],"names":[],"mappings":"AAAA,yGAAyG;AAOzG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAWxD,0DAA0D;AAC1D,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,KAAK,EACb,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,GAAG,EAAE,MAAM,CAAC,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/cli/agent-files.js

@@ -0,0 +1,40 @@
+/** `pinecall agent pull | push`: a corner's settings as a file, for whoever keeps them in git and CI. */
+import { readFile } from "node:fs/promises";
+import { readSettings, settingsPath } from "./agent-lines.js";
+import { asked } from "./testing/gateway.js";
+/** The two file verbs, dispatched by `pinecall agent`. */
+export async function filesRun(door, agent, verb, rest, values, out, err) {
+    if (verb === "pull")
+        return pull(door, agent, values.team === true, out, err);
+    return push(door, agent, rest[0], values.team === true, out, err);
+}
+// The team's corner unless --team is absent AND the key has one of its own with a row: a machine
+// key pulls the org's own, which is what a CI job keeps in the repository.
+async function pull(door, agent, team, out, err) {
+    const answer = await readSettings(door, agent);
+    const row = team ? answer.team : (answer.yours ?? answer.team);
+    if (row === null) {
+        err.write(`nothing set for ${agent} in ${team ? "the team's" : "your"} corner of ${answer.world}\n`);
+        return 1;
+    }
+    const pulled = { agent, world: answer.world, holder: row.holder, version: row.version, config: row.config };
+    out.write(`${JSON.stringify(pulled, null, 2)}\n`);
+    return 0;
+}
+// A push carries no if_version: CI is applying a file, and what stands is what the file says.
+async function push(door, agent, file, team, out, err) {
+    if (file === undefined) {
+        err.write("push takes the file `pinecall agent pull` wrote\n");
+        return 2;
+    }
+    const read = JSON.parse(await readFile(file, "utf8"));
+    const config = read.config ?? read;
+    const answer = await asked(door, settingsPath(agent), {
+        method: "PUT",
+        body: { config, if_version: null, note: `pushed from ${file}`, team },
+    });
+    const row = team ? answer.team : (answer.yours ?? answer.team);
+    out.write(`${agent} · ${answer.world} · ${team ? "the team's corner" : "your corner"} v${row?.version ?? "?"} from ${file}\n`);
+    return 0;
+}
+//# sourceMappingURL=agent-files.js.map

package/dist/cli/agent-files.js.map

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

package/dist/cli/agent-lines.d.ts

@@ -0,0 +1,23 @@
+/** How `pinecall agent` says the three corners on one page, and the door it reads them from. */
+import type { TuningAnswer, TuningBody, TuningRow } from "@pinecall/protocol";
+import { type Door } from "./testing/gateway.js";
+/** The settings door of one agent, spelled once for every verb that knocks at it. */
+export declare function settingsPath(agent: string): string;
+/** The three corners as this key sees them: its own, the team's, production's. */
+export declare function readSettings(door: Door, agent: string): Promise<TuningAnswer>;
+/** The fields on the page, in the order a person reads them, under the names a person types. */
+export declare const FIELDS: readonly ["voice", "tts", "tts-model", "stt", "llm", "greeting", "hangup", "turn", "memory", "knowledge"];
+export type Field = (typeof FIELDS)[number];
+/** The name a person types, as the wire spells it. */
+export declare const WIRE: Record<Field, keyof TuningBody>;
+/** One field of one config, as a cell of the page; undefined when the config does not set it. */
+export declare function shown(config: TuningBody, field: Field): string | undefined;
+/** One kept version on one line: the number, who, when, and why. */
+export declare function versionLine(row: TuningRow): string;
+/**
+ * The page: the agent and the world, the three corners as columns, a row per field, and under
+ * them which version each corner is at. A corner that set nothing reads as what it falls back
+ * to — `(team's)` in your column — because that is what a session built there runs.
+ */
+export declare function linesOf(agent: string, answer: TuningAnswer): string[];
+//# sourceMappingURL=agent-lines.d.ts.map

package/dist/cli/agent-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-lines.d.ts","sourceRoot":"","sources":["../../src/cli/agent-lines.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnF;AAED,gGAAgG;AAChG,eAAO,MAAM,MAAM,YAAI,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAChI,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,UAAU,CAWhD,CAAC;AAOF,iGAAiG;AACjG,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAiC1E;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAqBrE"}

package/dist/cli/agent-lines.js

@@ -0,0 +1,109 @@
+/** How `pinecall agent` says the three corners on one page, and the door it reads them from. */
+import { dayAndTime } from "./knowledge.js";
+import { asked } from "./testing/gateway.js";
+/** The settings door of one agent, spelled once for every verb that knocks at it. */
+export function settingsPath(agent) {
+    return `/v1/agents/${encodeURIComponent(agent)}/settings`;
+}
+/** The three corners as this key sees them: its own, the team's, production's. */
+export async function readSettings(door, agent) {
+    return await asked(door, settingsPath(agent));
+}
+/** The fields on the page, in the order a person reads them, under the names a person types. */
+export const FIELDS = ["voice", "tts", "tts-model", "stt", "llm", "greeting", "hangup", "turn", "memory", "knowledge"];
+/** The name a person types, as the wire spells it. */
+export const WIRE = {
+    voice: "voice",
+    tts: "tts",
+    "tts-model": "tts_model",
+    stt: "stt",
+    llm: "llm",
+    greeting: "greeting",
+    hangup: "hangup",
+    turn: "turn",
+    memory: "memory",
+    knowledge: "knowledge",
+};
+// A cell is one line, however the field is shaped: the words of an opening in quotes, a turn's
+// two numbers, a memory policy as two counts, the bases by name. Long words are cut, because a
+// page of three columns has to stay a page.
+const A_CELL = 40;
+/** One field of one config, as a cell of the page; undefined when the config does not set it. */
+export function shown(config, field) {
+    // The wire leaves a field out or sends null for "not set": both read as nothing here.
+    if (field === "greeting") {
+        const greeting = config.greeting ?? undefined;
+        if (greeting === undefined)
+            return undefined;
+        const say = greeting.say ?? undefined;
+        return say !== undefined ? `"${say}"` : `reply: ${greeting.reply ?? ""}`;
+    }
+    if (field === "hangup") {
+        const hangup = config.hangup ?? undefined;
+        if (hangup === undefined)
+            return undefined;
+        return hangup.when === "" || hangup.when === null || hangup.when === undefined ? "may hang up" : `when ${hangup.when}`;
+    }
+    if (field === "turn") {
+        const turn = config.turn ?? undefined;
+        if (turn === undefined)
+            return undefined;
+        const said = [];
+        if (turn.endpointing_ms !== undefined && turn.endpointing_ms !== null)
+            said.push(`endpointing ${turn.endpointing_ms} ms`);
+        if (turn.min_interruption_words !== undefined && turn.min_interruption_words !== null)
+            said.push(`interrupt at ${turn.min_interruption_words} words`);
+        return said.join(" · ");
+    }
+    if (field === "memory") {
+        const memory = config.memory ?? undefined;
+        if (memory === undefined)
+            return undefined;
+        return `remember ${memory.remember?.length ?? 0} · forget ${memory.forget?.length ?? 0}`;
+    }
+    if (field === "knowledge") {
+        const bases = config.knowledge ?? undefined;
+        if (bases === undefined || bases.length === 0)
+            return undefined;
+        return bases.map((one) => `${one.base}${one.k === undefined || one.k === null ? "" : ` (k ${one.k})`}`).join(" · ");
+    }
+    const value = config[WIRE[field]];
+    return typeof value === "string" ? value : undefined;
+}
+/** One kept version on one line: the number, who, when, and why. */
+export function versionLine(row) {
+    const said = [`v${row.version}`, row.author, dayAndTime(row.set_at)];
+    if (row.note !== null)
+        said.push(`"${row.note}"`);
+    return said.join(" · ");
+}
+/**
+ * The page: the agent and the world, the three corners as columns, a row per field, and under
+ * them which version each corner is at. A corner that set nothing reads as what it falls back
+ * to — `(team's)` in your column — because that is what a session built there runs.
+ */
+export function linesOf(agent, answer) {
+    const corners = [
+        { name: "yours", row: answer.yours, fallsTo: "(team's)" },
+        { name: "team", row: answer.team, fallsTo: "—" },
+        { name: "production", row: answer.production, fallsTo: "—" },
+    ];
+    const cell = (corner, field) => {
+        if (corner.row === null)
+            return corner.fallsTo;
+        const value = shown(corner.row.config, field);
+        if (value === undefined)
+            return "—";
+        return value.length > A_CELL ? `${value.slice(0, A_CELL - 1)}…` : value;
+    };
+    const widths = corners.map((corner) => Math.max(corner.name.length, ...FIELDS.map((field) => cell(corner, field).length)) + 2);
+    const lines = [`${agent} · ${answer.world}`, ""];
+    lines.push(`  ${"".padEnd(14)}${corners.map((corner, at) => corner.name.padEnd(widths[at])).join("")}`.trimEnd());
+    for (const field of FIELDS) {
+        lines.push(`  ${field.replace("-", " ").padEnd(14)}${corners.map((corner, at) => cell(corner, field).padEnd(widths[at])).join("")}`.trimEnd());
+    }
+    lines.push("");
+    lines.push(`  ${corners.map((corner) => `${corner.name}: ${corner.row === null ? "nothing set" : versionLine(corner.row)}`).join(" · ")}`);
+    return lines;
+}
+//# sourceMappingURL=agent-lines.js.map

package/dist/cli/agent-lines.js.map

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

package/dist/cli/agent-versions.d.ts

@@ -0,0 +1,12 @@
+/** `pinecall agent history | diff | rollback`: the versions a corner kept, and one of them back. */
+import type { TuningBody, TuningRow } from "@pinecall/protocol";
+import { type Field } from "./agent-lines.js";
+import type { Typed } from "./agent.js";
+import { type Door } from "./testing/gateway.js";
+/** The three version verbs, dispatched by `pinecall agent`. */
+export declare function versionsRun(door: Door, agent: string, verb: "history" | "diff" | "rollback", rest: string[], values: Typed, out: NodeJS.WritableStream, err: NodeJS.WritableStream): Promise<number>;
+/** The fields set differently between two configs, each as `field before → after`. */
+export declare function changes(before: TuningBody, after: TuningBody, lead: string, joined?: string): string;
+/** Whether a kept row sets this field at all, for the pages that draw a row. */
+export declare function sets(row: TuningRow, field: Field): boolean;
+//# sourceMappingURL=agent-versions.d.ts.map

package/dist/cli/agent-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-versions.d.ts","sourceRoot":"","sources":["../../src/cli/agent-versions.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAEpG,OAAO,KAAK,EAAgB,UAAU,EAA6B,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEzG,OAAO,EAAqD,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAExD,+DAA+D;AAC/D,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,EACrC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,KAAK,EACb,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,GAAG,EAAE,MAAM,CAAC,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC,CAIjB;AA+CD,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CASnG;AAED,gFAAgF;AAChF,wBAAgB,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAE1D"}

package/dist/cli/agent-versions.js

@@ -0,0 +1,70 @@
+/** `pinecall agent history | diff | rollback`: the versions a corner kept, and one of them back. */
+import { FIELDS, linesOf, settingsPath, shown, versionLine } from "./agent-lines.js";
+import { asked } from "./testing/gateway.js";
+/** The three version verbs, dispatched by `pinecall agent`. */
+export async function versionsRun(door, agent, verb, rest, values, out, err) {
+    if (verb === "history")
+        return history(door, agent, values.team === true, out);
+    if (verb === "diff")
+        return diff(door, agent, values.against, out, err);
+    return rollback(door, agent, rest[0], values.team === true, out, err);
+}
+async function history(door, agent, team, out) {
+    const kept = await asked(door, `${settingsPath(agent)}/history?team=${team}`);
+    out.write(`${agent} · ${kept.world} · ${kept.holder === "" ? "the org's own corner" : `corner ${kept.holder}`}\n`);
+    if (kept.rows.length === 0) {
+        out.write("  nothing set yet\n");
+        return 0;
+    }
+    // Each version against the one before it, so a line says what that save changed and not the
+    // whole set again; the oldest is against nothing, and reads as what it set.
+    kept.rows.forEach((row, at) => {
+        const older = kept.rows[at + 1] ?? null;
+        out.write(`  ${versionLine(row)}${changes(older?.config ?? {}, row.config, "   ")}\n`);
+    });
+    return 0;
+}
+async function diff(door, agent, against, out, err) {
+    const world = against ?? "production";
+    if (world !== "team" && world !== "production") {
+        err.write("--against takes team or production\n");
+        return 2;
+    }
+    const said = await asked(door, `${settingsPath(agent)}/diff?against=${world}`);
+    const ours = said.ours === null ? "nothing set" : `${said.ours.holder === "" ? "team" : "yours"} v${said.ours.version}`;
+    const theirs = said.theirs === null ? "nothing set" : `v${said.theirs.version}`;
+    out.write(`${agent} · ${ours} vs ${world} ${theirs}\n`);
+    if (said.changed.length === 0) {
+        out.write("  the same\n");
+        return 0;
+    }
+    out.write(`${changes(said.theirs?.config ?? {}, said.ours?.config ?? {}, "  ", "\n")}\n`);
+    return 0;
+}
+async function rollback(door, agent, version, team, out, err) {
+    const wanted = Number(version);
+    if (version === undefined || !Number.isInteger(wanted) || wanted < 1) {
+        err.write("rollback takes the version to bring back: `pinecall agent history` lists them\n");
+        return 2;
+    }
+    const answer = await asked(door, `${settingsPath(agent)}/rollback`, { method: "POST", body: { version: wanted, team } });
+    out.write(`${linesOf(agent, answer).join("\n")}\n`);
+    return 0;
+}
+/** The fields set differently between two configs, each as `field before → after`. */
+export function changes(before, after, lead, joined = " · ") {
+    const said = [];
+    for (const field of FIELDS) {
+        const was = shown(before, field);
+        const is = shown(after, field);
+        if (was === is)
+            continue;
+        said.push(`${field.replace("-", " ")} ${was ?? "—"} → ${is ?? "—"}`);
+    }
+    return said.length === 0 ? "" : `${lead}${said.join(joined === "\n" ? `\n${lead}` : joined)}`;
+}
+/** Whether a kept row sets this field at all, for the pages that draw a row. */
+export function sets(row, field) {
+    return shown(row.config, field) !== undefined;
+}
+//# sourceMappingURL=agent-versions.js.map

package/dist/cli/agent-versions.js.map

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

package/dist/cli/agent.d.ts

@@ -0,0 +1,77 @@
+/** `pinecall agent`: what the org set over the class — yours, the team's, production's — and setting it. */
+import { parseArgs } from "node:util";
+import type { TuningBody } from "@pinecall/protocol";
+import type { Group } from "./groups.js";
+export declare const group: Group;
+/** What the verb can be told besides the argv: where to print, and which environment. Tests only. */
+export interface Setting {
+    out?: NodeJS.WritableStream;
+    err?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+}
+/** Every flag the sub-verbs take, declared once: parseArgs is strict, and one table is one seam. */
+export declare const OPTIONS: {
+    readonly agent: {
+        readonly type: "string";
+    };
+    readonly json: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly team: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly note: {
+        readonly type: "string";
+    };
+    readonly voice: {
+        readonly type: "string";
+    };
+    readonly tts: {
+        readonly type: "string";
+    };
+    readonly "tts-model": {
+        readonly type: "string";
+    };
+    readonly stt: {
+        readonly type: "string";
+    };
+    readonly llm: {
+        readonly type: "string";
+    };
+    readonly greeting: {
+        readonly type: "string";
+    };
+    readonly reply: {
+        readonly type: "string";
+    };
+    readonly hangup: {
+        readonly type: "string";
+    };
+    readonly "endpointing-ms": {
+        readonly type: "string";
+    };
+    readonly "min-interruption-words": {
+        readonly type: "string";
+    };
+    readonly remember: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly forget: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly against: {
+        readonly type: "string";
+    };
+};
+export type Typed = ReturnType<typeof parseArgs<{
+    options: typeof OPTIONS;
+    allowPositionals: true;
+}>>["values"];
+export declare function run(argv: string[], how?: Setting): Promise<number>;
+/** What this command line set, under the wire's names, over what the corner's row already says. */
+export declare function typed(values: Typed, standing: TuningBody): Partial<TuningBody>;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/cli/agent.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAE5G,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAA2B,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAM9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAgBzC,eAAO,MAAM,KAAK,EAAE,KA2BnB,CAAC;AAEF,qGAAqG;AACrG,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,oGAAoG;AACpG,eAAO,MAAM,OAAO;aAClB,KAAK;iBAAI,IAAI,EAAE,QAAQ;;aACvB,IAAI;iBAAI,IAAI,EAAE,SAAS;iBAAE,OAAO;;aAChC,IAAI;iBAAI,IAAI,EAAE,SAAS;iBAAE,OAAO;;aAChC,IAAI;iBAAI,IAAI,EAAE,QAAQ;;aACtB,KAAK;iBAAI,IAAI,EAAE,QAAQ;;aACvB,GAAG;iBAAI,IAAI,EAAE,QAAQ;;aACrB,WAAW;iBAAI,IAAI,EAAE,QAAQ;;aAC7B,GAAG;iBAAI,IAAI,EAAE,QAAQ;;aACrB,GAAG;iBAAI,IAAI,EAAE,QAAQ;;aACrB,QAAQ;iBAAI,IAAI,EAAE,QAAQ;;aAC1B,KAAK;iBAAI,IAAI,EAAE,QAAQ;;aACvB,MAAM;iBAAI,IAAI,EAAE,QAAQ;;aACxB,gBAAgB;iBAAI,IAAI,EAAE,QAAQ;;aAClC,wBAAwB;iBAAI,IAAI,EAAE,QAAQ;;aAC1C,QAAQ;iBAAI,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;aACpC,MAAM;iBAAI,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;aAClC,OAAO;iBAAI,IAAI,EAAE,QAAQ;;CACjB,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC;IAAE,OAAO,EAAE,OAAO,OAAO,CAAC;IAAC,gBAAgB,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEhH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC5E;AA2CD,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAuB9E"}

package/dist/cli/agent.js

@@ -0,0 +1,192 @@
+/** `pinecall agent`: what the org set over the class — yours, the team's, production's — and setting it. */
+import { parseArgs } from "node:util";
+import { FIELDS, linesOf, readSettings, settingsPath, WIRE } from "./agent-lines.js";
+import { filesRun } from "./agent-files.js";
+import { versionsRun } from "./agent-versions.js";
+import { theDoor } from "./env.js";
+import { agentOfThisDirectory, notASlug } from "./load.js";
+import { asked } from "./testing/gateway.js";
+import { refusal } from "./whoami.js";
+const USAGE = [
+    "usage: pinecall agent [--agent <slug>] [--json]",
+    "       pinecall agent list",
+    "       pinecall agent set [--voice x] [--tts x] [--tts-model x] [--stt x] [--llm x] [--greeting '…' | --reply '…']",
+    "                          [--hangup '…'] [--endpointing-ms n] [--min-interruption-words n]",
+    "                          [--remember '…' …] [--forget '…' …] [--team] [--note '…']",
+    "       pinecall agent clear [voice|tts|tts-model|stt|llm|greeting|hangup|turn|memory|knowledge …] [--team]",
+    "       pinecall agent history [--team] · diff [--against team|production] · rollback <version> [--team]",
+    "       pinecall agent pull [--team] · push <file> [--team]",
+].join("\n");
+export const group = {
+    purpose: "what the org set over the class — yours, the team's, production's — and setting it",
+    usage: `${USAGE}
+
+  With nothing after it: the agent's settings as your key sees them, three corners side by side —
+  your own sandbox corner, the team's, and production's — a row per field, and which version each
+  corner is at. A corner that set nothing reads as what it falls back to.
+
+  set writes a NEW version in your own corner: what you set is yours, and a colleague's next call
+  does not hear it. --team writes the org's own corner instead, which every corner falls back to.
+  --prod writes production's, if your org lets you act there. The whole set travels with the version it was read at, so two people
+  saving at once never write over each other: the second is told where the corner is now. A model
+  knob reads three ways — \`--llm anthropic/claude-haiku-4-5\`, \`--llm cartesia\` (a vendor, its own
+  model), \`--llm claude-haiku-4-5\` (a model, the vendor in use). --greeting sets the words said as
+  the call opens; --reply what the model reads before it finds its own. --remember and --forget
+  replace those lists whole. A field nobody names is left as it stands.
+
+  clear takes fields out of the corner's own row, so what the class declared — or the runtime's
+  default — stands for them again; with no name, every field. There is no blank value.
+
+  history, diff and rollback are the versions: every one kept, who set it and why; this corner
+  against the team's or production's; one version back as the next one — with --prod, production's.
+  pull prints the corner's config as JSON; push sends a file as the next version, --team to the
+  team's corner.
+
+  list prints the agents this org is holding in your key's world.`,
+    run,
+};
+/** Every flag the sub-verbs take, declared once: parseArgs is strict, and one table is one seam. */
+export const OPTIONS = {
+    agent: { type: "string" },
+    json: { type: "boolean", default: false },
+    team: { type: "boolean", default: false },
+    note: { type: "string" },
+    voice: { type: "string" },
+    tts: { type: "string" },
+    "tts-model": { type: "string" },
+    stt: { type: "string" },
+    llm: { type: "string" },
+    greeting: { type: "string" },
+    reply: { type: "string" },
+    hangup: { type: "string" },
+    "endpointing-ms": { type: "string" },
+    "min-interruption-words": { type: "string" },
+    remember: { type: "string", multiple: true },
+    forget: { type: "string", multiple: true },
+    against: { type: "string" },
+};
+export async function run(argv, how = {}) {
+    const out = how.out ?? process.stdout;
+    const err = how.err ?? process.stderr;
+    const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: OPTIONS });
+    const door = theDoor(how.env ?? process.env, err);
+    if (door === undefined)
+        return 2;
+    const [verb, ...rest] = positionals;
+    try {
+        if (verb === "list")
+            return await list(door, out);
+        const aFile = notASlug(values.agent);
+        if (aFile !== undefined) {
+            err.write(`${aFile}\n`);
+            return 2;
+        }
+        const agent = values.agent ?? (await agentOfThisDirectory());
+        if (agent === null || agent === undefined) {
+            err.write(`${USAGE}\n  name the agent, or run this beside an agent file\n`);
+            return 2;
+        }
+        if (verb === undefined)
+            return said(agent, await readSettings(door, agent), values.json === true, out);
+        if (verb === "set")
+            return said(agent, await set(door, agent, values), values.json === true, out);
+        if (verb === "clear")
+            return said(agent, await clear(door, agent, rest, values.team === true), values.json === true, out);
+        if (verb === "history" || verb === "diff" || verb === "rollback") {
+            return await versionsRun(door, agent, verb, rest, values, out, err);
+        }
+        if (verb === "pull" || verb === "push")
+            return await filesRun(door, agent, verb, rest, values, out, err);
+    }
+    catch (refused) {
+        // The gateway's own sentence: it knows this build's vendors, the corner's version, and which
+        // half of the settings a key opens — and every refusal names the one it was.
+        err.write(`${refusal(refused)}\n`);
+        return 1;
+    }
+    err.write(`${USAGE}\n`);
+    return 2;
+}
+// ── the verbs ───────────────────────────────────────────────────────────────────
+async function list(door, out) {
+    const held = await asked(door, "/v1/agents");
+    if (held.agents.length === 0) {
+        out.write("no agent is held here: `pinecall start` holds one\n");
+        return 0;
+    }
+    for (const one of held.agents) {
+        const whose = one.holder === null || one.holder === undefined ? "the org's own" : (one.holder.name ?? one.holder.holder ?? "");
+        out.write(`${one.slug}  ${one.channels.join(", ") || "no doors"}  ${whose}\n`);
+    }
+    return 0;
+}
+// The door takes the WHOLE set with the version it was read at, so what this command line did
+// not name is read back off the corner's own row and sent again: `set --llm x` must not quietly
+// take the voice out of the row. The corner written is yours, or the team's with --team.
+async function set(door, agent, values) {
+    const standing = await readSettings(door, agent);
+    const row = values.team === true ? standing.team : standing.yours;
+    const config = { ...(row?.config ?? {}), ...typed(values, row?.config ?? {}) };
+    return await asked(door, settingsPath(agent), {
+        method: "PUT",
+        body: { config, if_version: row?.version ?? null, note: values.note ?? null, team: values.team === true },
+    });
+}
+async function clear(door, agent, named, team) {
+    const unknown = named.filter((name) => !FIELDS.includes(name));
+    if (unknown.length > 0)
+        throw new Error(`no field called ${unknown.join(", ")}: ${FIELDS.join(" · ")}`);
+    const standing = await readSettings(door, agent);
+    const row = team ? standing.team : standing.yours;
+    const config = named.length === 0 ? {} : { ...(row?.config ?? {}) };
+    for (const name of named)
+        delete config[WIRE[name]];
+    return await asked(door, settingsPath(agent), {
+        method: "PUT",
+        body: { config, if_version: row?.version ?? null, note: named.length === 0 ? "cleared" : `cleared ${named.join(", ")}`, team },
+    });
+}
+/** What this command line set, under the wire's names, over what the corner's row already says. */
+export function typed(values, standing) {
+    const wanted = {};
+    for (const field of ["voice", "tts", "tts-model", "stt", "llm"]) {
+        const value = values[field];
+        if (typeof value === "string")
+            wanted[WIRE[field]] = value;
+    }
+    if (values.greeting !== undefined)
+        wanted.greeting = { say: values.greeting };
+    else if (values.reply !== undefined)
+        wanted.greeting = { reply: values.reply };
+    if (values.hangup !== undefined)
+        wanted.hangup = { when: values.hangup };
+    const endpointing = numberOf(values["endpointing-ms"]);
+    const words = numberOf(values["min-interruption-words"]);
+    if (endpointing !== undefined || words !== undefined) {
+        wanted.turn = { ...(standing.turn ?? {}) };
+        if (endpointing !== undefined)
+            wanted.turn.endpointing_ms = endpointing;
+        if (words !== undefined)
+            wanted.turn.min_interruption_words = words;
+    }
+    if (values.remember !== undefined || values.forget !== undefined) {
+        wanted.memory = {
+            remember: values.remember ?? standing.memory?.remember ?? [],
+            forget: values.forget ?? standing.memory?.forget ?? [],
+        };
+    }
+    return wanted;
+}
+function numberOf(said) {
+    if (said === undefined)
+        return undefined;
+    const number = Number(said);
+    if (!Number.isInteger(number) || number < 0)
+        throw new Error(`${said} is not a whole number`);
+    return number;
+}
+function said(agent, answer, asJson, out) {
+    out.write(asJson ? `${JSON.stringify(answer)}\n` : `${linesOf(agent, answer).join("\n")}\n`);
+    return 0;
+}
+//# sourceMappingURL=agent.js.map