pinecall 0.1.0 → 0.3.0

package/dist/cli/run-screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-screens.d.ts","sourceRoot":"","sources":["../../src/cli/run-screens.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAEpH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAW/D,0FAA0F;AAC1F,MAAM,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;AAK3E,wBAAsB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1E;AAED,iGAAiG;AACjG,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChC;AAKD,wBAAsB,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBvF;AAeD,iGAAiG;AACjG,wBAAsB,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA8C5F;AAED,gGAAgG;AAChG,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,IAAI,MAAM,CAAC;CAClB;AAqBD,wBAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvC"}

package/dist/cli/run-screens.js

@@ -0,0 +1,134 @@
+/** What `pinecall run` prints while it holds the agents: the plain log, the JSON pipe, and the full-screen view. */
+import { absorb, draw, screenFor } from "./view.js";
+// Ten frames a second. The terminal view is a person watching a conversation, and a person cannot read
+// faster than that; redrawing on every entry would repaint the whole screen several times inside
+// one turn and make the transcript flicker while somebody is trying to read it.
+const FRAME_MS = 100;
+const CLEAR = "\x1b[2J\x1b[3J\x1b[H";
+const KEYS = "keys: p pause · c clear · e events · s prompt · q quit";
+// --events is the view for a program: one JSON line per entry, nothing else on stdout, so a
+// `pinecall run --events | jq` is a first-class way to watch a call.
+export async function stream(pc, listen) {
+    listen((event) => process.stdout.write(`${JSON.stringify(event)}\n`));
+    await pc.connect();
+    await forever();
+    return 0;
+}
+// The default: the same lines the view would have grown, appended, with nothing that moves
+// the cursor. It is what a process manager captures and what `docker logs` shows. With several
+// agents every line says whose it is.
+export async function plain(pc, agents, url) {
+    const width = Math.max(...agents.map((agent) => agent.slug.length));
+    const prefix = (slug) => (agents.length > 1 ? `${slug.padEnd(width)} │ ` : "");
+    for (const agent of agents) {
+        let screen = screenFor(agent.slug, url);
+        agent.heard((event) => {
+            const before = screen;
+            screen = absorb(screen, event);
+            for (const line of newLines(before, screen))
+                process.stdout.write(`${prefix(agent.slug)}${line}\n`);
+        });
+    }
+    // After the socket is up and not before it: the line says the gateway took this agent, and a
+    // gateway that refused it must leave its own refusal as the last thing on the screen.
+    await pc.connect();
+    for (const agent of agents)
+        process.stdout.write(`${prefix(agent.slug)}${agent.connected}\n`);
+    for (const agent of agents) {
+        for (const said of await agent.after())
+            process.stdout.write(`${prefix(agent.slug)}${said}\n`);
+    }
+    await forever();
+    return 0;
+}
+// What one event added, so the plain log prints the line the view would have grown and not the
+// whole view again. Only the two panels a person follows in a log grow line by line.
+function newLines(before, after) {
+    const lines = [];
+    for (const line of after.transcript.slice(before.transcript.length))
+        lines.push(`${line.mark} ${line.text}`);
+    for (const line of after.tools.slice(before.tools.length))
+        lines.push(`${line.mark} ${line.text}`);
+    for (const metric of after.metrics.slice(before.metrics.length))
+        lines.push(`metrics  ${metric}`);
+    if (after.changed !== before.changed && after.changed.length > 0) {
+        lines.push(`state    ${after.changed.join(", ")}`);
+    }
+    return lines;
+}
+/** The full-screen terminal view: absorb every event, and repaint at most ten times a second. */
+export async function live(pc, listen, watching) {
+    let screen = screenFor(watching.slug, watching.url);
+    let paused = false;
+    let raw = false;
+    let dirty = true;
+    let prompt;
+    const paint = () => {
+        if (paused || !dirty)
+            return;
+        dirty = false;
+        const rows = process.stdout.rows ?? 40;
+        const columns = process.stdout.columns ?? 100;
+        const page = prompt ?? draw(screen, rows - 3, columns, raw);
+        process.stdout.write(`${CLEAR}${page}\n\n${KEYS}\n`);
+    };
+    listen((event) => {
+        screen = absorb(screen, event);
+        dirty = true;
+    });
+    // The repaint starts only once the socket is up. Started before it, a refused connection leaves
+    // it running: nothing reaches the clearInterval below, the timer holds the process open, and it
+    // wipes the screen ten times a second over the one line that says what went wrong.
+    await pc.connect();
+    const timer = setInterval(paint, FRAME_MS);
+    paint();
+    await new Promise((done) => {
+        const stop = onKey((key) => {
+            if (key === "q" || key === "\u0003") {
+                stop();
+                done();
+                return;
+            }
+            if (key === "p")
+                paused = !paused;
+            if (key === "c")
+                screen = screenFor(watching.slug, watching.url);
+            if (key === "e")
+                raw = !raw;
+            // s shows the prompt the model would read right now, and the stage that decided its tools:
+            // the live instance when a call is up, and a fresh one otherwise, as --show-prompt prints.
+            if (key === "s")
+                prompt = prompt === undefined ? watching.prompt() : undefined;
+            dirty = true;
+        });
+    });
+    clearInterval(timer);
+    process.stdout.write(CLEAR);
+    return 0;
+}
+// Raw mode is how a single keypress arrives without an enter; a terminal that has no tty (a pipe,
+// CI) simply never sends one, and the view still draws.
+function onKey(handle) {
+    const input = process.stdin;
+    if (!input.isTTY)
+        return () => undefined;
+    input.setRawMode(true);
+    input.resume();
+    input.setEncoding("utf8");
+    const listener = (chunk) => handle(chunk);
+    input.on("data", listener);
+    return () => {
+        input.off("data", listener);
+        input.setRawMode(false);
+        input.pause();
+    };
+}
+// The verb ends when the process is signalled, not when a promise settles: it registers an
+// agent and then has nothing left to do but stay reachable.
+export function forever() {
+    return new Promise((done) => {
+        process.once("SIGINT", () => done());
+        process.once("SIGTERM", () => done());
+    });
+}
+//# sourceMappingURL=run-screens.js.map

package/dist/cli/run-screens.js.map

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

package/dist/cli/run.d.ts

@@ -7,14 +7,13 @@ export declare const group: Group;
  *
  * This is the verb that goes under pm2 and into a container, and it is the same process in
  * the sandbox and in production: it runs the agent, binds no port and serves no page. What a
- * person looks at is `--ui` in this terminal, or the log over the gateway's API.
+ * person looks at is `--ui` in this terminal, or a console: the gateway's own for production, and
+ * `pinecall serve` on this machine for the sandbox — which `--serve` opens beside this process.
  * See docs/decisions/tenant-cli.md.
  */
 export declare function run(argv: string[]): Promise<number>;
-/** Where the console of this agent is, with the code that signs the browser in. */
-export declare function consoleUrl(gateway: string, slug: string, code: string): string;
-/** Why the console line has no URL in it, in words that name the next move. */
-export declare function whyNoConsole(refused: unknown): string;
+/** Whether this failure is the gateway being away, which a reconnect answers, and not the app's own. */
+export declare function aLostSocket(failed: Error): boolean;
 /** Whether this agent answers at a number at all: with no number there is no ring to land. */
 export declare function rings(routes: RouteInput[] | undefined): boolean;
 //# sourceMappingURL=run.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAI7F,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOhF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA2BzC,eAAO,MAAM,KAAK,EAAE,KAcnB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwGzD;AASD,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9E;AAQD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAKrD;AA8BD,8FAA8F;AAC9F,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,GAAG,OAAO,CAE/D"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAI7F,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAO/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuBzC,eAAO,MAAM,KAAK,EAAE,KAmBnB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqLzD;AAeD,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAElD;AAcD,8FAA8F;AAC9F,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,GAAG,OAAO,CAE/D"}

package/dist/cli/run.js

@@ -2,42 +2,44 @@
 import { parseArgs } from "node:util";
 import { Pinecall } from "../client/index.js";
 import { showPrompt } from "../views/render.js";
-import { mount } from "../runtime/connect.js";
+import { mount, slugOf } from "../runtime/connect.js";
 import { showMachine } from "./machine.js";
 import { theDoor } from "./env.js";
 import { callsFrom, describing, theLine } from "./line.js";
 import { connectedLine, doorsOf } from "./connected.js";
-import { cannotTell, ENV_FLAG, notThisWorld, standing } from "./world.js";
+import { cannotTell, ENV_FLAG, notThisWorld, PRODUCTION, standing } from "./world.js";
 import { orgOf } from "./whoami.js";
 import { callingFrom } from "./profiles.js";
-import { instanceFor, load, mountOptions } from "./load.js";
-import { asked, Refused } from "./testing/gateway.js";
-import { chattingFrom } from "./ui/chatting.js";
+import { agentFilesOfTheProject, instanceFor, load, mountOptions } from "./load.js";
+import { AGENT_FLAG, homesFor } from "./home.js";
+import { goldensOf } from "./testing/goldens.js";
+import { chattingFrom, linesFromThisProcess } from "./ui/chatting.js";
 import { devHandler, ownVerbs } from "./ui/doors.js";
 import { driftingFrom } from "./ui/drifting.js";
-import { knowingFrom } from "./ui/knowing.js";
+import { hereOf, knowingFrom } from "./ui/knowing.js";
 import { promotingFrom } from "./ui/promoting.js";
-import { rememberingFrom } from "./ui/remembering.js";
+import { rememberingFrom, rememberingPiecesFor } from "./ui/remembering.js";
 import { reproducingFrom } from "./ui/reproducing.js";
-import { simulatingFrom } from "./ui/simulating.js";
-import { testingFrom } from "./ui/testing.js";
-import { absorb, draw, screenFor } from "./view.js";
-// Ten frames a second. The terminal view is a person watching a conversation, and a person cannot read
-// faster than that; redrawing on every entry would repaint the whole screen several times inside
-// one turn and make the transcript flicker while somebody is trying to read it.
-const FRAME_MS = 100;
-const CLEAR = "";
-const KEYS = "keys: p pause · c clear · e events · s prompt · q quit";
+import { simulatingFrom, simulatingPiecesFor } from "./ui/simulating.js";
+import { testingFrom, testingPiecesFor } from "./ui/testing.js";
+import { live, plain, stream } from "./run-screens.js";
+import { consoleLine, HOSTED, NOWHERE, whyNoConsole } from "./run-console.js";
+import { NoSidecar, openOrReuse, theOneUp } from "./serve/sidecar.js";
 export const group = {
     purpose: "the app and its doors: the process you deploy",
-    usage: `usage: pinecall run [agent.tsx] [--env production] [--ui] [--events] [--show-prompt]
+    usage: `usage: pinecall run [agent.tsx] [--agent <name>] [--env production] [--serve] [--ui] [--events] [--show-prompt]
 
   With nothing after it: the agent registered on the gateway, one line per log entry on stdout,
-  no port bound and no page served: the gateway serves the console, and this prints its URL with a
-  one-use code that signs the browser in. It answers that console for this directory.
+  no port bound and no page served. It answers the console for this directory — in the sandbox
+  that console is \`pinecall serve\`, on this machine; in production it is the gateway's own.
+
+  At the root of a project of several agents — agents/<name>.tsx — every agent at once, on one
+  socket, each line prefixed by its slug; --agent <name> (or its slug) runs one of them.
 
   --env <world>  say which world you believe this key opens, and be refused if it opens the
                  other. Nothing said is the sandbox; a deployment types --env production
+  --serve        also serve the sandbox's console on http://localhost:4100, or point at the one
+                 already up: \`pinecall run\` and \`pinecall serve\` in one terminal
   --show-prompt  the prompt a fresh instance would produce, then exit. No key, no gateway
   --events       one JSON line per log entry instead of the lines, for a pipe
   --ui           the full-screen terminal view; keys: p pause · c clear · e events · s prompt · q quit`,
@@ -48,7 +50,8 @@ export const group = {
  *
  * This is the verb that goes under pm2 and into a container, and it is the same process in
  * the sandbox and in production: it runs the agent, binds no port and serves no page. What a
- * person looks at is `--ui` in this terminal, or the log over the gateway's API.
+ * person looks at is `--ui` in this terminal, or a console: the gateway's own for production, and
+ * `pinecall serve` on this machine for the sandbox — which `--serve` opens beside this process.
  * See docs/decisions/tenant-cli.md.
  */
 export async function run(argv) {
@@ -59,19 +62,32 @@ export async function run(argv) {
             "show-prompt": { type: "boolean", default: false },
             events: { type: "boolean", default: false },
             ui: { type: "boolean", default: false },
+            serve: { type: "boolean", default: false },
+            ...AGENT_FLAG,
             ...ENV_FLAG,
         },
     });
-    const loaded = await load(positionals[0]);
+    // One class, or — at the root of a project of several — every agents/*.tsx, or the one named.
+    const homes = await homesFor(positionals[0], values.agent);
+    const loaded = await Promise.all(homes.map(async (home) => ({ home, loaded: await load(home.file) })));
     // What the `s` key and --show-prompt both print: the prompt the model would read, and under it
     // the stage this instance is in with the tools that stage shows.
     const promptPage = (agent) => `${showPrompt(agent)}\n\n${showMachine(agent)}`;
     // --show-prompt never connects: it is the question "what would the model read at the start of a
     // call", and answering it must not need a gateway, a key or a network.
     if (values["show-prompt"] === true) {
-        process.stdout.write(`${promptPage(instanceFor(loaded))}\n`);
+        for (const one of loaded) {
+            if (loaded.length > 1)
+                process.stdout.write(`── ${slugOf(one.loaded.ctor)} ──\n`);
+            process.stdout.write(`${promptPage(instanceFor(one.loaded))}\n`);
+        }
         return 0;
     }
+    if (values.ui === true && loaded.length > 1) {
+        const names = homes.map((home) => `--agent ${home.name}`).join(" or ");
+        process.stderr.write(`the full-screen view watches one agent and this project has ${loaded.length}: add ${names}\n`);
+        return 2;
+    }
     const door = theDoor();
     if (door === undefined)
         return 2;
@@ -92,46 +108,120 @@ export async function run(argv) {
         process.stderr.write(`${elsewhere}\n`);
         return 2;
     }
+    // The sandbox's console is this machine's: opened here when asked, else the one already up is
+    // named, else the line says which verb opens it. Production's is the gateway's own page.
+    let sidecar;
+    let local;
+    if (who.env === PRODUCTION) {
+        if (values.serve === true) {
+            process.stderr.write(`--serve is the sandbox's console, and this key opens ${PRODUCTION}: production is watched at ${door.url}\n`);
+            return 2;
+        }
+    }
+    else if (values.serve === true) {
+        try {
+            sidecar = await openOrReuse(door, who);
+            local = sidecar.url;
+        }
+        catch (failed) {
+            if (!(failed instanceof NoSidecar))
+                throw failed;
+            process.stderr.write(`${failed.message}\n`);
+            return 2;
+        }
+    }
+    else {
+        local = await theOneUp(door, who);
+    }
     const url = door.url;
+    // One socket for every agent of the project: the gateway takes several slugs on one app socket,
+    // and every call is routed to the class it names.
     const pc = new Pinecall({ url, apiKey: door.apiKey });
+    // A gateway that restarts is a blip, not a crash: the client redials on its own, and what a
+    // person needs is one line saying so — not a stack per attempt. --events prints only its JSON.
+    let lost = false;
+    pc.onErrors((failed) => {
+        // Anything that is not the socket — a tool that threw where nobody waited, a frame that would
+        // not parse — is said whole, as it always was.
+        if (!aLostSocket(failed))
+            return console.error(failed);
+        if (!lost && values.events !== true && values.ui !== true)
+            process.stderr.write(`gateway  ${failed.message} — reconnecting\n`);
+        lost = true;
+    });
+    // The gateway keeps whose phone is whose beside its live table and not in a row, because it is
+    // only meaningful next to a socket. So every connect says it again — the first and each
+    // reconnect, in every mode, for every agent and not only one that declares a number: a
+    // production number is the box's route and no class declares it, yet a developer's own phone
+    // dialling it reaches their copy (the runtime's rings-for door). A restarted gateway learns it
+    // here rather than sending the person's test call to production.
+    pc.onConnected(() => {
+        if (lost && values.events !== true && values.ui !== true)
+            process.stderr.write("gateway  back\n");
+        lost = false;
+        if (who.env !== PRODUCTION)
+            void sayWhoCallsFromHere(door);
+    });
     // Whoever opens the app socket closes it. Left open it keeps this process alive after the
     // signal has been read — a plain `kill` on `pinecall run` did nothing until this landed —
     // and the gateway holds the slug until it shuts.
     // What a console may ask of THIS process through the gateway, because the answer is a file of
-    // this directory or the class in it: a written call, the personas and a simulation, the goldens
+    // the agent's home or the class in it: a written call, the personas and a simulation, the goldens
     // and a suite, the knowledge folder, the memory goldens, a candidate, drift, a reproduction.
     // The lines they print land here, in the terminal that typed `run`, as the verbs would print
     // them. Registered before connect, so the first dev.request finds a handler.
-    let chatting;
+    const chattings = [];
     try {
-        const mounted = mount(loaded.ctor, mountOptions(loaded, pc));
-        chatting = chattingFrom(door, mounted.slug, process.stdout);
-        mounted.agent.onDev(devHandler(ownVerbs({
-            simulating: simulatingFrom(door, mounted.slug, process.stdout),
-            testing: testingFrom(door, mounted.slug, process.stdout),
-            chatting,
-            knowing: knowingFrom(door, mounted.slug),
-            remembering: rememberingFrom(door, mounted.slug),
-            promoting: promotingFrom(door, mounted.slug, process.stdout),
-            drifting: driftingFrom(door),
-            reproducing: reproducingFrom(),
-        })));
+        const all = loaded.map(({ home, loaded: one }) => {
+            const mounted = mount(one.ctor, mountOptions(one, pc));
+            const project = homes.length > 1 || agentFilesOfTheProject().length > 0;
+            const chatting = project
+                ? chattingFrom(door, mounted.slug, process.stdout, linesFromThisProcess(door, process.stdout, home.file), () => goldensOf(home.goldens))
+                : chattingFrom(door, mounted.slug, process.stdout);
+            chattings.push(chatting);
+            mounted.agent.onDev(devHandler(ownVerbs({
+                simulating: project
+                    ? simulatingFrom(door, mounted.slug, process.stdout, simulatingPiecesFor(home))
+                    : simulatingFrom(door, mounted.slug, process.stdout),
+                testing: project
+                    ? testingFrom(door, mounted.slug, process.stdout, testingPiecesFor(home))
+                    : testingFrom(door, mounted.slug, process.stdout),
+                chatting,
+                knowing: project ? knowingFrom(door, mounted.slug, hereOf(home, mounted.slug)) : knowingFrom(door, mounted.slug),
+                remembering: project
+                    ? rememberingFrom(door, mounted.slug, rememberingPiecesFor(home, mounted.slug))
+                    : rememberingFrom(door, mounted.slug),
+                promoting: promotingFrom(door, mounted.slug, process.stdout),
+                drifting: driftingFrom(door),
+                reproducing: reproducingFrom(),
+            })));
+            return { mounted, loaded: one };
+        });
+        const listens = all.map(({ mounted }) => mounted.agent.onAny.bind(mounted.agent));
         // --events is a pipe into another program: it prints nothing but its JSON.
         if (values.events === true)
-            return await stream(pc, mounted.agent.onAny.bind(mounted.agent));
+            return await stream(pc, (listener) => {
+                const stops = listens.map((listen) => listen(listener));
+                return () => stops.forEach((stop) => stop());
+            });
         if (values.ui !== true) {
-            const doors = doorsOf(mounted.options.routes);
-            const line = connectedLine({
+            const agents = all.map(({ mounted }) => ({
                 slug: mounted.slug,
-                url,
-                tools: mounted.options.tools?.length ?? 0,
-                doors,
-                org: orgOf(who),
-                env: who.env,
-                source: door.source,
-            });
-            return await plain(pc, mounted.agent.onAny.bind(mounted.agent), mounted.slug, url, line, () => onceUp(door, mounted.slug, rings(mounted.options.routes)));
+                heard: mounted.agent.onAny.bind(mounted.agent),
+                connected: connectedLine({
+                    slug: mounted.slug,
+                    url,
+                    tools: mounted.options.tools?.length ?? 0,
+                    doors: doorsOf(mounted.options.routes),
+                    org: orgOf(who),
+                    env: who.env,
+                    source: door.source,
+                }),
+                after: () => onceUp(door, mounted.slug, rings(mounted.options.routes), who.env === PRODUCTION ? HOSTED : (local ?? NOWHERE)),
+            }));
+            return await plain(pc, agents, url);
         }
+        const { mounted, loaded: one } = all[0];
         // Which call the `s` key renders: the newest one, so the prompt on screen is the prompt of the
         // conversation on screen. With no call up it is a fresh instance — the same page --show-prompt gives.
         let newest;
@@ -142,51 +232,33 @@ export async function run(argv) {
         const watching = {
             slug: mounted.slug,
             url,
-            prompt: () => promptPage(instanceOf(mounted, newest) ?? instanceFor(loaded)),
+            prompt: () => promptPage(instanceOf(mounted, newest) ?? instanceFor(one)),
         };
         return await live(pc, mounted.agent.onAny.bind(mounted.agent), watching);
     }
     finally {
-        await chatting?.close();
+        for (const chatting of chattings)
+            await chatting.close();
         pc.close();
+        await sidecar?.close();
     }
 }
-// What a gateway answers for a path no router of its declared.
-const NO_SUCH_DOOR = 404;
-// The console is the gateway's page at `/a/<agent>`, and it holds a key of its own — never this
-// process's. So this process mints a one-use code standing for its key (five minutes, once) and
-// prints the URL that carries it; the page spends it for a key of the tab's own. A gateway that
-// refuses the code is one line, and the app runs on.
-/** Where the console of this agent is, with the code that signs the browser in. */
-export function consoleUrl(gateway, slug, code) {
-    return `${gateway.replace(/\/$/, "")}/a/${encodeURIComponent(slug)}?login=${encodeURIComponent(code)}`;
-}
-// A 404 at this door means the gateway has no such door, which means it is OLDER than this CLI —
-// a long-running dev gateway is the usual way to meet it, since nothing restarts one for you. A
-// status is not a thing a person can act on, so the sentence says the cause and the fix instead.
-const OLDER_GATEWAY = "this gateway has no login-code door, so it is older than this CLI. Restart it: it serves the console too, and that will be stale as well.";
-/** Why the console line has no URL in it, in words that name the next move. */
-export function whyNoConsole(refused) {
-    if (refused instanceof Refused) {
-        return refused.status === NO_SUCH_DOOR ? OLDER_GATEWAY : `the gateway answered ${refused.status}`;
-    }
-    return refused instanceof Error ? refused.message : String(refused);
-}
 // What is only true once the socket is up: the console's URL, and — when the agent answers at a
 // number — whose terminal that number rings in. Both are asked of the gateway, and neither is
 // worth failing the run over: a gateway that refuses says so on its own line and the app runs on.
-async function onceUp(door, slug, rings) {
-    const said = [await consoleLine(door, slug)];
-    if (rings) {
-        // The gateway keeps whose phone is whose beside its live table and not in a row, because it
-        // is only meaningful next to a socket. So every connect says it again: a restarted gateway,
-        // or one this terminal has never told, learns it here rather than routing the person's own
-        // test call into a colleague's terminal.
-        await sayWhoCallsFromHere(door);
+async function onceUp(door, slug, rings, where) {
+    const said = [await consoleLine(door, slug, where)];
+    if (rings)
         said.push(await lineLine(door, slug));
-    }
     return said;
 }
+// What `ws` and the network say when the gateway is not there: a refused or reset connection, a
+// name that does not resolve, or a proxy in front of it answering for it while it restarts.
+const LOST = /^(Unexpected server response|WebSocket|socket hang up|connect |getaddrinfo |read ECONN|write E)/;
+/** Whether this failure is the gateway being away, which a reconnect answers, and not the app's own. */
+export function aLostSocket(failed) {
+    return typeof failed.code === "string" || LOST.test(failed.message);
+}
 /** Re-send the phone `pinecall line from` remembered for this gateway. Silent: it is upkeep. */
 async function sayWhoCallsFromHere(door) {
     const kept = callingFrom();
@@ -215,133 +287,7 @@ async function lineLine(door, slug) {
         return `line     not available: ${whyNoConsole(refused)}`;
     }
 }
-async function consoleLine(door, slug) {
-    try {
-        const minted = await asked(door, "/v1/login/codes", { method: "POST", body: {} });
-        return `console  ${consoleUrl(door.url, slug, minted.code)}   (opens within five minutes, once)`;
-    }
-    catch (refused) {
-        return `console  not available: ${whyNoConsole(refused)}`;
-    }
-}
 function instanceOf(mounted, call) {
     return call === undefined ? undefined : mounted.instanceOf(call);
 }
-// --events is the view for a program: one JSON line per entry, nothing else on stdout, so a
-// `pinecall run --events | jq` is a first-class way to watch a call.
-async function stream(pc, listen) {
-    listen((event) => process.stdout.write(`${JSON.stringify(event)}\n`));
-    await pc.connect();
-    await forever();
-    return 0;
-}
-// The default: the same lines the view would have grown, appended, with nothing that moves
-// the cursor. It is what a process manager captures and what `docker logs` shows.
-async function plain(pc, listen, slug, url, connected, after) {
-    let screen = screenFor(slug, url);
-    listen((event) => {
-        const before = screen;
-        screen = absorb(screen, event);
-        for (const line of newLines(before, screen))
-            process.stdout.write(`${line}\n`);
-    });
-    // After the socket is up and not before it: the line says the gateway took this agent, and a
-    // gateway that refused it must leave its own refusal as the last thing on the screen.
-    await pc.connect();
-    process.stdout.write(`${connected}\n`);
-    for (const said of await after())
-        process.stdout.write(`${said}\n`);
-    await forever();
-    return 0;
-}
-// What one event added, so the plain log prints the line the view would have grown and not the
-// whole view again. Only the two panels a person follows in a log grow line by line.
-function newLines(before, after) {
-    const lines = [];
-    for (const line of after.transcript.slice(before.transcript.length))
-        lines.push(`${line.mark} ${line.text}`);
-    for (const line of after.tools.slice(before.tools.length))
-        lines.push(`${line.mark} ${line.text}`);
-    for (const metric of after.metrics.slice(before.metrics.length))
-        lines.push(`metrics  ${metric}`);
-    if (after.changed !== before.changed && after.changed.length > 0) {
-        lines.push(`state    ${after.changed.join(", ")}`);
-    }
-    return lines;
-}
-/** The full-screen terminal view: absorb every event, and repaint at most ten times a second. */
-async function live(pc, listen, watching) {
-    let screen = screenFor(watching.slug, watching.url);
-    let paused = false;
-    let raw = false;
-    let dirty = true;
-    let prompt;
-    const paint = () => {
-        if (paused || !dirty)
-            return;
-        dirty = false;
-        const rows = process.stdout.rows ?? 40;
-        const columns = process.stdout.columns ?? 100;
-        const page = prompt ?? draw(screen, rows - 3, columns, raw);
-        process.stdout.write(`${CLEAR}${page}\n\n${KEYS}\n`);
-    };
-    listen((event) => {
-        screen = absorb(screen, event);
-        dirty = true;
-    });
-    // The repaint starts only once the socket is up. Started before it, a refused connection leaves
-    // it running: nothing reaches the clearInterval below, the timer holds the process open, and it
-    // wipes the screen ten times a second over the one line that says what went wrong.
-    await pc.connect();
-    const timer = setInterval(paint, FRAME_MS);
-    paint();
-    await new Promise((done) => {
-        const stop = onKey((key) => {
-            if (key === "q" || key === "\u0003") {
-                stop();
-                done();
-                return;
-            }
-            if (key === "p")
-                paused = !paused;
-            if (key === "c")
-                screen = screenFor(watching.slug, watching.url);
-            if (key === "e")
-                raw = !raw;
-            // s shows the prompt the model would read right now, and the stage that decided its tools:
-            // the live instance when a call is up, and a fresh one otherwise, as --show-prompt prints.
-            if (key === "s")
-                prompt = prompt === undefined ? watching.prompt() : undefined;
-            dirty = true;
-        });
-    });
-    clearInterval(timer);
-    process.stdout.write(CLEAR);
-    return 0;
-}
-// Raw mode is how a single keypress arrives without an enter; a terminal that has no tty (a pipe,
-// CI) simply never sends one, and the view still draws.
-function onKey(handle) {
-    const input = process.stdin;
-    if (!input.isTTY)
-        return () => undefined;
-    input.setRawMode(true);
-    input.resume();
-    input.setEncoding("utf8");
-    const listener = (chunk) => handle(chunk);
-    input.on("data", listener);
-    return () => {
-        input.off("data", listener);
-        input.setRawMode(false);
-        input.pause();
-    };
-}
-// The verb ends when the process is signalled, not when a promise settles: it registers an
-// agent and then has nothing left to do but stay reachable.
-function forever() {
-    return new Promise((done) => {
-        process.once("SIGINT", () => done());
-        process.once("SIGTERM", () => done());
-    });
-}
 //# sourceMappingURL=run.js.map