pinecall 0.4.0 → 0.6.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-processes.d.ts

@@ -0,0 +1,13 @@
+/** `pinecall agent list` and `agent stop`: which processes hold the org's agents, where they run, and stopping one. */
+import type { AppProcess } from "@pinecall/protocol";
+import { type Door } from "./testing/gateway.js";
+/** Every app connected in the key's world: one line each, the agents it holds and where it runs. */
+export declare function listed(door: Door, out: NodeJS.WritableStream): Promise<number>;
+/**
+ * One app stopped: its socket is closed with the stop code, and a pinecall that hears it exits
+ * instead of dialling back. A supervisor that restarts whatever exits starts it again.
+ */
+export declare function stopped(door: Door, app: string | undefined, out: NodeJS.WritableStream, err: NodeJS.WritableStream): Promise<number>;
+/** The line: which app, its agents, whose corner, the machine and address, the SDK, since when. */
+export declare function lineOf(app: AppProcess): string;
+//# sourceMappingURL=agent-processes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-processes.d.ts","sourceRoot":"","sources":["../../src/cli/agent-processes.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAEvH,OAAO,KAAK,EAAW,UAAU,EAAc,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAExD,oGAAoG;AACpG,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAQpF;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ1I;AAED,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAK9C"}

package/dist/cli/agent-processes.js

@@ -0,0 +1,34 @@
+/** `pinecall agent list` and `agent stop`: which processes hold the org's agents, where they run, and stopping one. */
+import { asked } from "./testing/gateway.js";
+/** Every app connected in the key's world: one line each, the agents it holds and where it runs. */
+export async function listed(door, out) {
+    const { apps } = await asked(door, "/v1/apps");
+    if (apps.length === 0) {
+        out.write("no app is connected here: `pinecall start` holds a project's agents\n");
+        return 0;
+    }
+    for (const app of apps)
+        out.write(`${lineOf(app)}\n`);
+    return 0;
+}
+/**
+ * One app stopped: its socket is closed with the stop code, and a pinecall that hears it exits
+ * instead of dialling back. A supervisor that restarts whatever exits starts it again.
+ */
+export async function stopped(door, app, out, err) {
+    if (app === undefined) {
+        err.write("usage: pinecall agent stop <app> — the app is the first column of `pinecall agent list`\n");
+        return 2;
+    }
+    const answer = await asked(door, `/v1/apps/${encodeURIComponent(app)}/stop`, { method: "POST" });
+    out.write(`stopped ${answer.app}: its agents are free — a supervisor that restarts it (systemd, pm2) starts it again\n`);
+    return 0;
+}
+/** The line: which app, its agents, whose corner, the machine and address, the SDK, since when. */
+export function lineOf(app) {
+    const whose = app.holder === null ? "the org's" : (app.holder.name ?? app.holder.holder ?? "");
+    const where = `${app.host ?? "an unnamed host"}${app.address === null ? "" : ` (${app.address})`}`;
+    const since = new Date(app.connected_at * 1000).toISOString().slice(0, 16).replace("T", " ");
+    return `${app.app}  ${app.agents.join(", ") || "no agent yet"}  ${whose} · ${where} · ${app.sdk ?? "an unknown sdk"} · since ${since}`;
+}
+//# sourceMappingURL=agent-processes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-processes.js","sourceRoot":"","sources":["../../src/cli/agent-processes.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAIvH,OAAO,EAAE,KAAK,EAAa,MAAM,sBAAsB,CAAC;AAExD,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAU,EAAE,GAA0B;IACjE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAU,IAAI,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,GAAG,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAU,EAAE,GAAuB,EAAE,GAA0B,EAAE,GAA0B;IACvH,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,GAAG,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;QACvG,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAa,IAAI,EAAE,YAAY,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7G,GAAG,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,GAAG,wFAAwF,CAAC,CAAC;IACzH,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,MAAM,CAAC,GAAe;IACpC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,iBAAiB,GAAG,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;IACnG,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7F,OAAO,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,KAAK,KAAK,MAAM,KAAK,MAAM,GAAG,CAAC,GAAG,IAAI,gBAAgB,YAAY,KAAK,EAAE,CAAC;AACzI,CAAC"}

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 — setting it, and the processes that hold 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,wIAAwI;AAExI,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAgBzC,eAAO,MAAM,KAAK,EAAE,KA8BnB,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,CAmC5E;AA8BD,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAuB9E"}