pinecall 0.3.0 → 0.4.0

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

@@ -1,15 +0,0 @@
-/** `pinecall ui [agent]`: the console on 127.0.0.1 for the life of the command, opened in this machine's browser. */
-import type { Group } from "../groups.js";
-export declare const group: Group;
-/** What ui can be told besides the argv: where to print, and which browser to open. Tests only. */
-export interface Opening {
-    out?: NodeJS.WritableStream;
-    err?: NodeJS.WritableStream;
-    open?: (url: string) => void;
-    env?: NodeJS.ProcessEnv;
-    files?: string;
-}
-/** Serve, open, wait, close. The org key is read once and spent only by the server, never printed. */
-export declare function ui(argv: string[], how?: Opening): Promise<number>;
-export declare function consoleFiles(): string;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/index.ts"],"names":[],"mappings":"AAAA,qHAAqH;AAOrH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAoB1C,eAAO,MAAM,KAAK,EAAE,KAcnB,CAAC;AAEF,mGAAmG;AACnG,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sGAAsG;AACtG,wBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD3E;AAWD,wBAAgB,YAAY,IAAI,MAAM,CAMrC"}

package/dist/cli/ui/index.js

@@ -1,117 +0,0 @@
-/** `pinecall ui [agent]`: the console on 127.0.0.1 for the life of the command, opened in this machine's browser. */
-import { existsSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { slugOf } from "../../runtime/connect.js";
-import { doorLine, theDoor } from "../env.js";
-import { agentOfThisDirectory, DEFAULT_AGENTS } from "../load.js";
-import { headless, openInBrowser } from "./browser.js";
-import { chattingFrom } from "./chatting.js";
-import { driftingFrom } from "./drifting.js";
-import { ownDoors } from "./doors.js";
-import { knowingFrom } from "./knowing.js";
-import { promotingFrom } from "./promoting.js";
-import { rememberingFrom } from "./remembering.js";
-import { reproducingFrom } from "./reproducing.js";
-import { LocalConsole } from "./server.js";
-import { simulatingFrom } from "./simulating.js";
-import { testingFrom } from "./testing.js";
-const USAGE = "usage: pinecall ui [agent]";
-// A checkout runs everything else from its sources; the console is the one thing that has to be
-// bundled first, because a browser reads no TypeScript. The sentence names the command.
-const NOT_BUILT = "the console is not built: run scripts/build once, then pinecall ui";
-export const group = {
-    purpose: "the console: this gateway's agents, their calls and logs as they happen, evals, and a page to talk",
-    usage: `${USAGE}
-
-  Opens the console on this gateway, landing on the agent of this directory — the class in
-  ${DEFAULT_AGENTS[0]} — or on the agent named, or on the list of every agent the gateway holds when
-  there is neither. The console is served on 127.0.0.1 for as long as the command runs and opened
-  in this machine's browser: Talk joins the agent's room with the browser's microphone, Calls
-  follows every call as it happens, Sessions reads the finished ones, Evals and Pipeline read
-  their doors. Ctrl-C here closes the port with the command.
-
-  The key never reaches the browser: this process signs every request the console makes, under a
-  URL only it printed. Runs where a browser is — over ssh or with no display it says so and exits 2.`,
-    run: ui,
-};
-/** Serve, open, wait, close. The org key is read once and spent only by the server, never printed. */
-export async function ui(argv, how = {}) {
-    const out = how.out ?? process.stdout;
-    const err = how.err ?? process.stderr;
-    const env = how.env ?? process.env;
-    if (argv[0]?.startsWith("-")) {
-        out.write(`${USAGE}\n`);
-        return 2;
-    }
-    const door = theDoor(env, err);
-    if (door === undefined)
-        return 2;
-    const why = headless(env);
-    if (why !== null) {
-        err.write(`ui needs a browser on this machine and ${why}: run it where the screen is\n`);
-        return 2;
-    }
-    const here = await agentOfThisDirectory();
-    const agent = argv[0] ?? here;
-    const files = how.files ?? consoleFiles();
-    if (!existsSync(files)) {
-        err.write(`${NOT_BUILT}\n`);
-        return 2;
-    }
-    // A simulation or a suite started from the page mounts the class of THIS directory in this
-    // process and prints here, exactly as `pinecall simulate` and `pinecall test` would; the page
-    // watches the call's log, or the run's row.
-    const chatting = chattingFrom(door, here, out);
-    const served = await LocalConsole.open(door, files, ownDoors({
-        simulating: simulatingFrom(door, here, out),
-        testing: testingFrom(door, here, out),
-        chatting,
-        knowing: knowingFrom(door, here),
-        remembering: rememberingFrom(door, here),
-        promoting: promotingFrom(door, here, out),
-        drifting: driftingFrom(door),
-        reproducing: reproducingFrom(),
-    }));
-    const at = agent === null ? served.url : served.at(`a/${agent}`);
-    // Which gateway and which of the four places the key came from: the one line that answers
-    // "why is it talking to that box" before anybody has to grep for an exported name.
-    out.write(`${doorLine(door)}\n`);
-    out.write(`${agent ?? "console"} · ${door.url} · ${at}\n`);
-    (how.open ?? openInBrowser)(at);
-    const hungUp = interrupted();
-    try {
-        await hungUp.happened;
-    }
-    finally {
-        hungUp.stop();
-        await chatting.close();
-        await served.close();
-    }
-    return 0;
-}
-// Named by the same rule `run` registers it under, read from the same file, so the two verbs never
-// The console is a browser program inside this package: its source is src/cli/ui/console and vite
-// writes its build to dist/cli/ui/console, which is what `files` publishes. So from the compiled
-// verb the page is the sibling directory, and from the source under a loader it is the same path
-// in dist — one of the two exists, and a tree where neither does was never built.
-// Beside this module sits `console/` twice over: in the published package it is the BUILT console,
-// and in a checkout it is the SOURCE, whose index.html points at `main.tsx` — TypeScript, which no
-// browser runs, and which served a blank page for as long as the check was `existsSync` alone.
-// What tells them apart is that source file, so that is what is asked about.
-export function consoleFiles() {
-    const beside = fileURLToPath(new URL("console/", import.meta.url));
-    if (existsSync(beside) && !existsSync(fileURLToPath(new URL("console/main.tsx", import.meta.url)))) {
-        return beside;
-    }
-    return fileURLToPath(new URL("../../../dist/cli/ui/console/", import.meta.url));
-}
-/** Ctrl-C, as a promise that resolves once, and the handle that unhooks it. */
-function interrupted() {
-    let hungUp = () => undefined;
-    const happened = new Promise((resolve) => {
-        hungUp = () => resolve();
-        process.once("SIGINT", hungUp);
-    });
-    return { happened, stop: () => process.off("SIGINT", hungUp) };
-}
-//# sourceMappingURL=index.js.map

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

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

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

@@ -1,8 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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

@@ -1,11 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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/server.d.ts

@@ -1,22 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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

@@ -1,211 +0,0 @@
-/** 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

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