pinecall 0.1.0

package/dist/cli/ui/refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusal.js","sourceRoot":"","sources":["../../../src/cli/ui/refusal.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,6GAA6G;AAC7G,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAIrB,MAAM;IAHC,IAAI,GAAG,SAAS,CAAC;IAEnC,YACW,MAAc,EACvB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;sBAHN,MAAM;IAIjB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAe;IACvC,IAAI,MAAM,YAAY,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACxF,IAAI,MAAM,YAAY,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACzF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5F,CAAC"}

package/dist/cli/ui/refused.d.ts

@@ -0,0 +1,8 @@
+/** A refusal from one of the console's own doors: a sentence for the page, and the status it travels under. */
+/** Thrown by a door of this process; the server writes it as `{detail}` under `status`, as FastAPI would. */
+export declare class Refused extends Error {
+    readonly status: number;
+    readonly name = "Refused";
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=refused.d.ts.map

package/dist/cli/ui/refused.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refused.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/refused.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,6GAA6G;AAC7G,qBAAa,OAAQ,SAAQ,KAAK;IAI9B,QAAQ,CAAC,MAAM,EAAE,MAAM;IAHzB,SAAkB,IAAI,aAAa;IAEnC,YACW,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EAGhB;CACF"}

package/dist/cli/ui/refused.js

@@ -0,0 +1,11 @@
+/** A refusal from one of the console's own doors: a sentence for the page, and the status it travels under. */
+/** Thrown by a door of this process; the server writes it as `{detail}` under `status`, as FastAPI would. */
+export class Refused extends Error {
+    status;
+    name = "Refused";
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+//# sourceMappingURL=refused.js.map

package/dist/cli/ui/refused.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refused.js","sourceRoot":"","sources":["../../../src/cli/ui/refused.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,6GAA6G;AAC7G,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAIrB,MAAM;IAHC,IAAI,GAAG,SAAS,CAAC;IAEnC,YACW,MAAc,EACvB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;sBAHN,MAAM;IAIjB,CAAC;CACF"}

package/dist/cli/ui/remembering.d.ts

@@ -0,0 +1,38 @@
+/** The console's own door to memory's two goldens: what recall ranks, and what a hang-up makes of a call. */
+import type { ExtractionGolden, ExtractionRun, MemoryScore } from "@pinecall/protocol";
+import type { Door } from "../testing/gateway.js";
+/** What this directory holds for memory: the recall golden, and the extraction cases beside it. */
+export interface Roster {
+    agent: string | null;
+    golden: string | null;
+    questions: number;
+    cases: string[];
+}
+/** What the server needs from the memory door, and nothing of how it reads a directory. */
+export interface Remembering {
+    roster(): Promise<Roster>;
+    /** The recall golden, asked of the gateway's own ranking. */
+    recall(asked: unknown): Promise<MemoryScore>;
+    /** The extraction goldens, through one hang-up's model call each, judged by code. */
+    extract(asked: unknown): Promise<ExtractionRun>;
+}
+/** The pieces a run is built from, named so a test can hand in its own. */
+export interface Pieces {
+    /** The extraction goldens of this directory, read off the disk. */
+    cases: () => Promise<ExtractionGolden[]>;
+    /** The cases through the class of this directory, mounted here for the length of the run. */
+    extract: (door: Door, cases: ExtractionGolden[]) => Promise<ExtractionRun>;
+    /** Where the recall golden is, and which class this directory holds. */
+    golden: () => Promise<{
+        agent: string | null;
+        golden: string | null;
+    }>;
+}
+/**
+ * One `Remembering` for the life of a `pinecall run`. Both goldens are FILES of this directory —
+ * `memory/golden.json` and `test/memory` — so only the process standing in it can run them, and
+ * both are the very ones `pinecall memory eval` and `pinecall remember` run. The models are the
+ * gateway's, as they always were: this process sends questions and cases, never a key.
+ */
+export declare function rememberingFrom(door: Door, agent: string | null, pieces?: Pieces): Remembering;
+//# sourceMappingURL=remembering.d.ts.map

package/dist/cli/ui/remembering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remembering.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/remembering.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAK7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AASvF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAKlD,mGAAmG;AACnG,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,qFAAqF;IACrF,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD;AAOD,2EAA2E;AAC3E,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,KAAK,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzC,6FAA6F;IAC7F,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3E,wEAAwE;IACxE,MAAM,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACxE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,GAAE,MAAuE,GAC9E,WAAW,CA8Bb"}

package/dist/cli/ui/remembering.js

@@ -0,0 +1,87 @@
+/** The console's own door to memory's two goldens: what recall ranks, and what a hang-up makes of a call. */
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { Pinecall } from "../../client/index.js";
+import { mount, slugOf } from "../../runtime/connect.js";
+import { theQuestionsIn } from "../knowledge.js";
+import { load, mountOptions } from "../load.js";
+import { AN_EMPTY_GOLDEN, DEFAULT_GOLDEN, NO_GOLDEN, recalledOn } from "../memory.js";
+import { CASES, extracted, NO_CASES } from "../remember.js";
+import { casesIn } from "../testing/goldens.js";
+import { anObject, aString, maybeNumber } from "./asked.js";
+import { Refusal } from "./refusal.js";
+const NOT_THIS_DIRECTORY = (asked, here) => here === null
+    ? `no agent class in this directory: run \`pinecall run\` where ${asked}'s agent.tsx is`
+    : `this process runs in ${here}'s directory: to run ${asked}'s memory goldens, run \`pinecall run\` there`;
+/**
+ * One `Remembering` for the life of a `pinecall run`. Both goldens are FILES of this directory —
+ * `memory/golden.json` and `test/memory` — so only the process standing in it can run them, and
+ * both are the very ones `pinecall memory eval` and `pinecall remember` run. The models are the
+ * gateway's, as they always were: this process sends questions and cases, never a key.
+ */
+export function rememberingFrom(door, agent, pieces = { cases: theCases, extract: inThisProcess, golden: theGolden }) {
+    return {
+        async roster() {
+            const { golden } = await pieces.golden();
+            const questions = golden !== null && existsSync(golden) ? theQuestionsIn(golden) : null;
+            return {
+                agent,
+                golden: golden !== null && existsSync(golden) ? golden : null,
+                questions: questions?.length ?? 0,
+                cases: (await pieces.cases()).map((one) => one.name),
+            };
+        },
+        async recall(asked) {
+            const given = anObject(asked, "a golden");
+            mine(aString(given, "agent"), agent);
+            const { golden } = await pieces.golden();
+            if (golden === null || !existsSync(golden))
+                throw new Refusal(404, NO_GOLDEN(golden ?? DEFAULT_GOLDEN));
+            const questions = theQuestionsIn(golden);
+            if (questions === null)
+                throw new Refusal(422, AN_EMPTY_GOLDEN(golden));
+            return await recalledOn(door, questions, maybeNumber(given, "k", 1, 100));
+        },
+        async extract(asked) {
+            mine(aString(anObject(asked, "a run"), "agent"), agent);
+            const cases = await pieces.cases();
+            if (cases.length === 0)
+                throw new Refusal(404, NO_CASES);
+            return await pieces.extract(door, cases);
+        },
+    };
+}
+function mine(asked, here) {
+    if (asked !== here)
+        throw new Refusal(409, NOT_THIS_DIRECTORY(asked, here));
+}
+/** The extraction goldens of `test/memory`, or none at all when this directory has none. */
+async function theCases() {
+    return existsSync(CASES) ? await casesIn([], CASES) : [];
+}
+// The class is mounted here for the length of the run, exactly as `pinecall remember` mounts it:
+// the categories a golden may name are the class's own declaration, read off the socket this
+// process opens, and the extraction itself runs where the org's keys are.
+async function inThisProcess(door, cases) {
+    const loaded = await load();
+    const pc = new Pinecall({ url: door.url, apiKey: door.apiKey });
+    const held = mount(loaded.ctor, { ...mountOptions(loaded, pc), takesUnclaimed: false });
+    try {
+        await pc.connect();
+        return await extracted(door, held.slug, cases);
+    }
+    finally {
+        pc.close();
+    }
+}
+/** Where the recall golden of this directory is, and which class it belongs to. */
+async function theGolden() {
+    try {
+        const loaded = await load();
+        return { agent: slugOf(loaded.ctor), golden: resolve(join(dirname(loaded.file), DEFAULT_GOLDEN)) };
+    }
+    catch {
+        return { agent: null, golden: null };
+    }
+}
+//# sourceMappingURL=remembering.js.map

package/dist/cli/ui/remembering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remembering.js","sourceRoot":"","sources":["../../../src/cli/ui/remembering.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAInD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAmBvC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,IAAmB,EAAU,EAAE,CACxE,IAAI,KAAK,IAAI;IACX,CAAC,CAAC,gEAAgE,KAAK,iBAAiB;IACxF,CAAC,CAAC,wBAAwB,IAAI,wBAAwB,KAAK,+CAA+C,CAAC;AAY/G;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAU,EACV,KAAoB,EACpB,MAAM,GAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;IAE/E,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxF,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;gBAC7D,SAAS,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;gBACjC,KAAK,EAAE,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;aACrD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAc;YACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACzC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC;YACxG,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,SAAS,KAAK,IAAI;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;YACxE,OAAO,MAAM,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAc;YAC1B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACzD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,KAAa,EAAE,IAAmB;IAC9C,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,4FAA4F;AAC5F,KAAK,UAAU,QAAQ;IACrB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAmB,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,iGAAiG;AACjG,6FAA6F;AAC7F,0EAA0E;AAC1E,KAAK,UAAU,aAAa,CAAC,IAAU,EAAE,KAAyB;IAChE,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;IACrG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/cli/ui/reproducing.d.ts

@@ -0,0 +1,23 @@
+/** The console's own door to a broken golden's reproduction: the file the suite left on this disk. */
+/** Which goldens of one run were written out, and where that folder is. */
+export interface Written {
+    run: string;
+    folder: string;
+    goldens: string[];
+}
+/** What the server needs from the reproduction door, and nothing of how it reads a folder. */
+export interface Reproducing {
+    /** Which goldens of this run left a file behind. A green run leaves none. */
+    roster(asked: unknown): Promise<Written>;
+    /** One of them, whole: the golden as written, the requests, the verdicts, the log. */
+    read(asked: unknown): Promise<unknown>;
+}
+/**
+ * One `Reproducing` for the life of a `pinecall run`. A reproduction is a FILE the suite left in
+ * the directory it ran in — `.pinecall/evals/<run>/<golden>.json` — so the page can only have it
+ * through the process standing there. It carries the one thing the log deliberately does not: the
+ * requests the model actually answered, region by region, because the log keeps a hash of each
+ * prompt block on purpose.
+ */
+export declare function reproducingFrom(under?: string): Reproducing;
+//# sourceMappingURL=reproducing.d.ts.map

package/dist/cli/ui/reproducing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproducing.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/reproducing.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAStG,2EAA2E;AAC3E,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AASD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,WAAW,CAyB1E"}

package/dist/cli/ui/reproducing.js

@@ -0,0 +1,52 @@
+/** The console's own door to a broken golden's reproduction: the file the suite left on this disk. */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { REPRODUCTIONS } from "../testing/reproduction.js";
+import { anObject, aString } from "./asked.js";
+import { Refusal } from "./refusal.js";
+const A_RUN = /^[A-Za-z0-9_-]{1,64}$/;
+const A_GOLDEN = /^[^/\\]{1,120}$/;
+const NOT_HERE = (run) => `no reproduction of ${run} under ${REPRODUCTIONS}: the suite writes them where it was run, ` +
+    "and a run that was green wrote none";
+/**
+ * One `Reproducing` for the life of a `pinecall run`. A reproduction is a FILE the suite left in
+ * the directory it ran in — `.pinecall/evals/<run>/<golden>.json` — so the page can only have it
+ * through the process standing there. It carries the one thing the log deliberately does not: the
+ * requests the model actually answered, region by region, because the log keeps a hash of each
+ * prompt block on purpose.
+ */
+export function reproducingFrom(under = REPRODUCTIONS) {
+    return {
+        async roster(asked) {
+            const run = theRun(asked);
+            const folder = join(under, run);
+            if (!existsSync(folder))
+                throw new Refusal(404, NOT_HERE(run));
+            const goldens = readdirSync(folder)
+                .filter((name) => name.endsWith(".json"))
+                .map((name) => name.slice(0, -".json".length))
+                .sort();
+            return { run, folder, goldens };
+        },
+        async read(asked) {
+            const given = anObject(asked, "a reproduction");
+            const run = theRun(given);
+            const golden = aString(given, "golden");
+            // A name out of the page is a name off this disk: neither half may climb out of the folder
+            // the suite wrote, which is why both are shapes and not just strings.
+            if (!A_GOLDEN.test(golden))
+                throw new Refusal(422, "a golden is a name, not a path");
+            const file = join(under, run, `${golden}.json`);
+            if (!existsSync(file))
+                throw new Refusal(404, `no reproduction of ${golden} in ${join(under, run)}`);
+            return JSON.parse(readFileSync(file, "utf8"));
+        },
+    };
+}
+function theRun(asked) {
+    const run = aString(anObject(asked, "a reproduction"), "run");
+    if (!A_RUN.test(run))
+        throw new Refusal(422, "a run is an id, not a path");
+    return run;
+}
+//# sourceMappingURL=reproducing.js.map

package/dist/cli/ui/reproducing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproducing.js","sourceRoot":"","sources":["../../../src/cli/ui/reproducing.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAiBvC,MAAM,KAAK,GAAG,uBAAuB,CAAC;AACtC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAEnC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CACvC,sBAAsB,GAAG,UAAU,aAAa,4CAA4C;IAC5F,qCAAqC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAK,GAAW,aAAa;IAC3D,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAc;YACzB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;iBAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;iBACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;iBAC7C,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAc;YACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;YAChD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxC,2FAA2F;YAC3F,sEAAsE;YACtE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;YACrF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,sBAAsB,MAAM,OAAO,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrG,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;IAC3E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/ui/server.d.ts

@@ -0,0 +1,22 @@
+/** The local server behind `pinecall ui`: the console's files and the gateway's doors, under one nonce on 127.0.0.1. */
+import type { Door } from "../testing/gateway.js";
+import type { OwnDoor } from "./doors.js";
+/**
+ * The console's server for the life of one command. Under its nonce it serves the built console
+ * and forwards `v1/*` to the gateway with the org key on the header; outside the nonce it answers
+ * 404 and nothing else. The key is a field of this object and is written into exactly one place:
+ * the authorization header of a request this process makes.
+ */
+export declare class LocalConsole {
+    #private;
+    private constructor();
+    /** Bind the loopback on a free port and serve the console in `files` for this door. */
+    static open(door: Door, files: string, own?: OwnDoor[]): Promise<LocalConsole>;
+    /** Where the console is: the loopback, the port, the nonce. The one URL that answers anything. */
+    get url(): string;
+    /** Where one screen of the console is, by the path the console routes. */
+    at(path: string): string;
+    /** Close every socket and the port. After this, nothing answers at `url`. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/cli/ui/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/server.ts"],"names":[],"mappings":"AAAA,wHAAwH;AASxH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAoC1C;;;;;GAKG;AACH,qBAAa,YAAY;;IAQvB,OAAO,eAYN;IAED,uFAAuF;IACvF,OAAa,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAIvF;IAED,kGAAkG;IAClG,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,0EAA0E;IAC1E,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvB;IAED,6EAA6E;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;CAqHF"}

package/dist/cli/ui/server.js

@@ -0,0 +1,211 @@
+/** The local server behind `pinecall ui`: the console's files and the gateway's doors, under one nonce on 127.0.0.1. */
+import { randomBytes } from "node:crypto";
+import { createReadStream, existsSync, readFileSync, statSync } from "node:fs";
+import { createServer } from "node:http";
+import { extname, join, normalize, resolve, sep } from "node:path";
+import { Readable } from "node:stream";
+import { Refusal, refusedAs } from "./refusal.js";
+// Loopback only, and the kernel picks the port: nothing on the network can reach this console,
+// and two `ui`s on one laptop do not fight over a number.
+const LOOPBACK = "127.0.0.1";
+// Everything answers under a random path — the console's files and, with them, the door to the
+// gateway that this process opens with the org key. A process on this machine that scans the
+// loopback finds a port; without the URL this process printed, it finds a 404 and nothing behind
+// it. The key itself never leaves this process: the browser sends requests, this server signs them.
+const NONCE_BYTES = 16;
+// The gateway's doors, as the console asks for them relative to its base. Everything else under
+// the nonce is a file of the console, or the console's page for a screen it routes itself.
+const DOORS = "v1/";
+// This process's OWN doors, beside the gateway's: what only the terminal that typed `ui` can do,
+// because it stands in the agent's directory. Which ones there are is ui/doors.ts, and this
+// server knows no more about them than their paths.
+const OWN = "ui/";
+const TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json",
+    ".map": "application/json",
+    ".svg": "image/svg+xml",
+    ".woff2": "font/woff2",
+};
+// The headers a browser's request carries that the gateway needs to see. Everything else — the
+// cookies, the origin, the user agent — is the browser's business and stops here.
+const FORWARDED = ["content-type", "accept", "last-event-id", "range"];
+/**
+ * The console's server for the life of one command. Under its nonce it serves the built console
+ * and forwards `v1/*` to the gateway with the org key on the header; outside the nonce it answers
+ * 404 and nothing else. The key is a field of this object and is written into exactly one place:
+ * the authorization header of a request this process makes.
+ */
+export class LocalConsole {
+    #server;
+    #nonce;
+    #door;
+    #files;
+    #own;
+    #url = "";
+    constructor(door, files, own) {
+        this.#door = door;
+        this.#own = own;
+        // Resolved, which is what strips a trailing separator: the directory arrives as a URL's path
+        // and so ends in one, and `#serve` compares against `#files + sep`. Left as it came, that
+        // comparison is `…/console//`, which no file under it starts with, and EVERY request fell
+        // through to the page — including the bundle, which the browser then parsed as HTML.
+        this.#files = resolve(files);
+        this.#nonce = randomBytes(NONCE_BYTES).toString("hex");
+        this.#server = createServer((request, response) => {
+            void this.#answer(request, response);
+        });
+    }
+    /** Bind the loopback on a free port and serve the console in `files` for this door. */
+    static async open(door, files, own = []) {
+        const served = new LocalConsole(door, files, own);
+        await served.#listen();
+        return served;
+    }
+    /** Where the console is: the loopback, the port, the nonce. The one URL that answers anything. */
+    get url() {
+        return this.#url;
+    }
+    /** Where one screen of the console is, by the path the console routes. */
+    at(path) {
+        return `${this.#url}${path.replace(/^\//, "")}`;
+    }
+    /** Close every socket and the port. After this, nothing answers at `url`. */
+    async close() {
+        this.#server.closeAllConnections();
+        await new Promise((closed) => this.#server.close(() => closed()));
+    }
+    async #listen() {
+        await new Promise((bound, failed) => {
+            this.#server.once("error", failed);
+            this.#server.listen(0, LOOPBACK, bound);
+        });
+        const { port } = this.#server.address();
+        this.#url = `http://${LOOPBACK}:${port}/${this.#nonce}/`;
+    }
+    async #answer(request, response) {
+        const asked = new URL(request.url ?? "/", this.#url);
+        const under = `/${this.#nonce}/`;
+        if (!asked.pathname.startsWith(under)) {
+            response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
+            response.end("not here\n");
+            return;
+        }
+        const path = asked.pathname.slice(under.length);
+        if (path.startsWith(DOORS)) {
+            await this.#forward(request, response, `/${path}${asked.search}`);
+        }
+        else if (path.startsWith(OWN)) {
+            await this.#answerOwn(request, response, path);
+        }
+        else {
+            this.#serve(response, path);
+        }
+    }
+    // The doors this process answers itself, read off the table it was opened with. A refusal
+    // travels as FastAPI's would — a status and a `detail` sentence — so the page reads both kinds
+    // of door the same way.
+    async #answerOwn(request, response, path) {
+        const method = request.method ?? "GET";
+        const door = this.#own.find((one) => `${OWN}${one.path}` === path);
+        const answer = method === "GET" ? door?.get : method === "POST" ? door?.post : undefined;
+        try {
+            if (answer === undefined)
+                throw new Refusal(404, `nothing at ${path}`);
+            json(response, 200, await answer(JSON.parse((await whole(request)).toString() || "{}")));
+        }
+        catch (refused) {
+            const said = refusedAs(refused);
+            json(response, said.status, { detail: said.detail });
+        }
+    }
+    // The one place the key is spent. The response streams back as it arrives, which is what a log
+    // over SSE needs; a browser that navigates away aborts the request behind it.
+    async #forward(request, response, path) {
+        const headers = { authorization: `Bearer ${this.#door.apiKey}` };
+        for (const name of FORWARDED) {
+            const value = request.headers[name];
+            if (typeof value === "string")
+                headers[name] = value;
+        }
+        // The response closing before it finished is the browser going away — a tab closed, a screen
+        // left — and the door behind it is let go with it. (The request's own `close` is not that: it
+        // fires the moment its body has been read.)
+        const stopping = new AbortController();
+        response.once("close", () => {
+            if (!response.writableFinished)
+                stopping.abort();
+        });
+        // A body the console sends is one JSON object, read whole before the door is asked: the
+        // doors it writes to take a document, never a stream.
+        const method = request.method ?? "GET";
+        const body = method === "GET" || method === "HEAD" ? {} : { body: await whole(request) };
+        let answered;
+        try {
+            answered = await fetch(new URL(path, this.#door.url), { method, headers, signal: stopping.signal, ...body });
+        }
+        catch (failed) {
+            if (stopping.signal.aborted)
+                return;
+            response.writeHead(502, { "content-type": "text/plain; charset=utf-8" });
+            response.end(`the gateway did not answer: ${failed instanceof Error ? failed.message : String(failed)}\n`);
+            return;
+        }
+        const relayed = {
+            "content-type": answered.headers.get("content-type") ?? "application/octet-stream",
+            "cache-control": "no-store",
+        };
+        // A recording is served in byte ranges so a player can seek; those three headers are the
+        // range's own and travel back with it.
+        for (const name of ["content-range", "accept-ranges", "content-length"]) {
+            const value = answered.headers.get(name);
+            if (value !== null)
+                relayed[name] = value;
+        }
+        response.writeHead(answered.status, relayed);
+        if (answered.body === null) {
+            response.end();
+            return;
+        }
+        const relaying = Readable.fromWeb(answered.body);
+        // The browser leaving mid-stream aborts the fetch, and the abort surfaces here as the body's
+        // own error. It is the one way a stream is expected to end, not a failure of this process —
+        // unheard, it was an uncaught exception that took the whole console down (2026-09-09).
+        relaying.on("error", () => response.destroy());
+        relaying.pipe(response);
+    }
+    // A path that names a file of the console is that file; every other path is a screen the console
+    // routes itself, so it gets the page. Nothing above the console's directory is ever read.
+    #serve(response, path) {
+        const file = join(this.#files, normalize(`/${path}`));
+        if (!file.startsWith(this.#files + sep) || !existsSync(file) || statSync(file).isDirectory()) {
+            response.writeHead(200, { "content-type": TYPES[".html"], "cache-control": "no-store" });
+            response.end(this.#page());
+            return;
+        }
+        response.writeHead(200, { "content-type": TYPES[extname(file)] ?? "application/octet-stream" });
+        createReadStream(file).pipe(response);
+    }
+    // Read on every request and not once: a console rebuilt while `ui` runs names new assets in a
+    // new page, and a person reloading should get it. The page is served for every screen the
+    // console routes itself, at any depth, so its assets are addressed from the base and not from
+    // wherever the address bar happens to stand.
+    #page() {
+        return readFileSync(join(this.#files, "index.html"), "utf8").replace("<head>", `<head><base href="/${this.#nonce}/">`);
+    }
+}
+/** One JSON answer, whole. */
+function json(response, status, body) {
+    response.writeHead(status, { "content-type": TYPES[".json"], "cache-control": "no-store" });
+    response.end(`${JSON.stringify(body)}\n`);
+}
+/** Every byte of a request's body, as one buffer. */
+async function whole(request) {
+    const chunks = [];
+    for await (const chunk of request)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks);
+}
+//# sourceMappingURL=server.js.map

package/dist/cli/ui/server.js.map

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

package/dist/cli/ui/simulating.d.ts

@@ -0,0 +1,47 @@
+/** The console's own door to a simulated caller: this directory's personas, and one call started from the page. */
+import { aSimulation } from "../simulate.js";
+import { type Persona } from "../testing/caller.js";
+import type { Door } from "../testing/gateway.js";
+/** What the page asks for: the caller, the line, and how far to go. */
+export interface Wanted {
+    agent: string;
+    persona: string;
+    voice: boolean;
+    judge: boolean;
+    turns: number;
+    /** dB under the caller. Only on a spoken line. */
+    background_noise?: number | undefined;
+    /** Percent of packets lost, as a person types it. Only on a spoken line. */
+    packet_loss?: number | undefined;
+}
+/** A persona as the page lists it: enough to pick one, and nothing the model is told. */
+export interface Listed {
+    name: string;
+    goal: string;
+    style: string;
+}
+/** What the door answers: the class this console can simulate against, and its callers. */
+export interface Roster {
+    agent: string | null;
+    personas: Listed[];
+}
+/** What the server needs from the simulation, and nothing of how it prints. */
+export interface Simulating {
+    roster(): Promise<Roster>;
+    start(wanted: unknown): Promise<{
+        call: string;
+    }>;
+}
+/** The pieces a simulation is built from, named so a test can hand in its own. */
+export interface Pieces {
+    personas: () => Promise<Persona[]>;
+    simulate: typeof aSimulation;
+}
+/**
+ * One `Simulating` for the life of a `pinecall run`: the door it was opened with, the class of the
+ * directory it runs in, and where the simulation's own lines go — the terminal that typed `ui`,
+ * exactly as `pinecall simulate` prints them. The call itself is watched from the page, off the
+ * log, like any other call; nothing here keeps a second transcript.
+ */
+export declare function simulatingFrom(door: Door, agent: string | null, out: NodeJS.WritableStream, pieces?: Pieces): Simulating;
+//# sourceMappingURL=simulating.d.ts.map

package/dist/cli/ui/simulating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulating.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/simulating.ts"],"names":[],"mappings":"AAAA,mHAAmH;AAEnH,OAAO,EAAE,WAAW,EAAqC,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIlD,uEAAuE;AACvE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD,yFAAyF;AACzF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2FAA2F;AAC3F,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAYD,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,kFAAkF;AAClF,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,WAAW,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,MAAM,GAAE,MAAgE,GACvE,UAAU,CAsBZ"}