pinecall 0.1.0

package/dist/cli/simulate.js

@@ -0,0 +1,320 @@
+/** `pinecall simulate --persona x`: a model plays the caller, and the call is judged at hang-up. */
+import { parseArgs } from "node:util";
+import { Pinecall } from "../client/index.js";
+import WebSocket from "ws";
+import { mount } from "../runtime/connect.js";
+import { chatUrl } from "./chat.js";
+import { theDoor } from "./env.js";
+import { anEarIn } from "./listening.js";
+import { load, mountOptions } from "./load.js";
+import { NO_PERSONAS, personaNamed } from "./testing/caller.js";
+import { entriesOf, theNextLine } from "./testing/gateway.js";
+import { latencyLine, mediansOf } from "./testing/latency.js";
+import { linesOfScore } from "./testing/score.js";
+import { aCallId, aVoiceCall, DEGRADED, watching } from "./testing/voice.js";
+import { lineFor, metricsLine } from "./view.js";
+const USAGE = "usage: pinecall simulate --persona <name> [--judge] [--turns n] [--voice] [--listen]\n" +
+    "       [--background-noise <dB under the caller>] [--packet-loss <percent>] [--file agent.tsx]\n";
+export const group = {
+    purpose: "a model plays one persona against the agent, live, and the call is scored at hang-up",
+    usage: `${USAGE}
+  A model in the gateway plays the caller: every turn improvised from the persona's goal, its
+  style and its own facts — there is no script. This terminal holds the class and the transcript;
+  the gateway holds the provider keys. The call lands in the log like any other.
+
+  --persona <name>    a file of test/personas, by its name
+  --judge             read back the call.score the log seals on, and print every judge
+  --turns n           how many turns the caller improvises before hanging up (default 6)
+  --voice             a real line: a room, the persona's own voice, the box's speech
+  --listen            the call on this machine's speakers while it happens; turns --voice on
+  --background-noise  dB under the caller: a television behind them. Spoken runs only
+  --packet-loss       percent of the caller's packets that never arrive. Spoken runs only
+  --file agent.tsx    which class to mount, when the directory holds more than one`,
+    run,
+};
+// Hearing a call means a call with audio in it, so the flag turns the line on rather than refusing
+// a person who asked to listen to a written one. Said out loud, because it changes what is run.
+const LISTEN_IS_A_LINE = "--listen is a call with audio in it: --voice is on";
+// A spoiled line is a property of audio: there is nothing to mix into a written turn, and a flag
+// that quietly did nothing would be a run reporting a noisy line it never had.
+export const ONLY_ON_A_LINE = "--background-noise and --packet-loss are about audio: add --voice";
+/**
+ * How many turns a caller improvises when nobody said. Six is the length of the walkthrough the
+ * examples are written against, and long enough for a booking to reach its confirmation.
+ */
+export const TURNS = 6;
+// How long a written call is left quiet before the caller says the next thing. The app answers
+// `call.started` with a render and a tool may run after the reply, so a turn is over when nothing
+// has been written for a moment — the same silence the gateway's own runner waits for.
+const SETTLE_MS = 400;
+// And how long one turn may take before the simulation gives up on it. A tenant's tool that awaits
+// something for ever must not leave a person watching a prompt that never returns.
+const A_TURN_MAY_TAKE_MS = 30_000;
+// The log seals on `call.score`, which is written after the caller has gone — so it is read back
+// rather than heard, and this is how long the judges are given before the terminal gives up.
+const JUDGING_MAY_TAKE_MS = 60_000;
+const TERMINAL_ENTRY = "call.score";
+// `sessions` is a group of the runtime's CLI, not of this one: pointing a person at `pinecall
+// sessions show` sends them to a stub that prints "not built yet" and nothing else.
+const notSealed = (call) => `no ${TERMINAL_ENTRY} within ${JUDGING_MAY_TAKE_MS / 1000}s: read the call with ` +
+    `\`pinecall sessions ${call}\`, or the console → Sessions`;
+export async function run(argv, out = process.stdout) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            persona: { type: "string" },
+            judge: { type: "boolean", default: false },
+            listen: { type: "boolean", default: false },
+            voice: { type: "boolean", default: false },
+            "background-noise": { type: "string" },
+            "packet-loss": { type: "string" },
+            turns: { type: "string" },
+            file: { type: "string" },
+        },
+    });
+    const listen = values.listen === true;
+    const voice = values.voice === true || listen;
+    if (listen && values.voice !== true)
+        out.write(`${LISTEN_IS_A_LINE}\n`);
+    if (values.persona === undefined) {
+        process.stderr.write(USAGE);
+        return 2;
+    }
+    const degraded = degradedBy(values["background-noise"], values["packet-loss"]);
+    if (!voice && degraded !== undefined) {
+        process.stderr.write(`${ONLY_ON_A_LINE}\n`);
+        return 2;
+    }
+    const persona = await personaNamed(values.persona);
+    if (persona === undefined) {
+        process.stderr.write(`no persona called ${values.persona}: ${NO_PERSONAS}\n`);
+        return 2;
+    }
+    const said = await aSimulation(persona, {
+        agentFile: values.file,
+        judge: values.judge === true,
+        voice,
+        listen,
+        ...(degraded === undefined ? {} : { degraded }),
+        turns: values.turns === undefined ? TURNS : Number(values.turns),
+        out,
+    });
+    return exitCodeOf(said);
+}
+/** How the line is to be spoiled, when it is: a level in dB, and a share of packets lost. */
+export function degradedBy(noise, loss) {
+    if (noise === undefined && loss === undefined)
+        return undefined;
+    return {
+        interferer_db: noise === undefined || noise === "" ? DEGRADED.interferer_db : Number(noise),
+        packet_loss: loss === undefined || loss === "" ? DEGRADED.packet_loss : Number(loss) / 100,
+    };
+}
+// A call nobody could open is a failure of this command; a call a judge answered `broken` about is
+// a failure of the agent. A call NOBODY judged is neither — and it does not exit zero either,
+// because an exit code is a gate and "nobody looked at this" must not open one. The three states
+// are told apart on the screen, where a verdict belongs — the runtime's docs/decisions/scoring.md.
+export function exitCodeOf(said) {
+    if (said === undefined)
+        return 2;
+    if (said.score === undefined)
+        return 0;
+    return said.score.passed === true ? 0 : 1;
+}
+/**
+ * The class is mounted in THIS process, as `chat` and `test` mount it, and a model in the runtime
+ * plays the caller: this terminal holds the persona and the transcript, the gateway holds the
+ * provider keys. Every turn is improvised from the goal, the style and the persona's own facts,
+ * and with `judge` the `call.score` the log seals on is read back and printed.
+ */
+export async function aSimulation(persona, how) {
+    const door = how.door ?? theDoor();
+    if (door === undefined)
+        return undefined;
+    const loaded = await load(how.agentFile);
+    const url = door.url;
+    const pc = new Pinecall({ url, apiKey: door.apiKey });
+    // A written call names this app in its own socket URL, so the terminal takes nothing it did not
+    // open. A spoken one arrives through the worker, which names no app (worker/entry.py:82) — so a
+    // `--voice` run has to be willing to serve the call the runtime opens for it, which is exactly
+    // the posture `pinecall run` has, and the gateway refuses the job otherwise.
+    const mounted = mount(loaded.ctor, {
+        ...mountOptions(loaded, pc),
+        takesUnclaimed: how.voice,
+        opening: () => persona.state,
+    });
+    how.out.write(`${persona.name} · ${persona.goal}\n`);
+    try {
+        await pc.connect();
+        const call = how.voice
+            ? await outLoud(door, mounted.slug, persona, how)
+            : await inWriting(chatUrl(url, mounted.slug, mounted.agent.app), door.apiKey, door, persona, how);
+        return { call, ...(await theEnding(door, call, how)) };
+    }
+    finally {
+        pc.close();
+    }
+}
+// The written door: one socket, the improvised lines down it one at a time, the log up it as it
+// happens. Closing the socket is the hangup, and the hangup is what writes the score.
+async function inWriting(socketUrl, apiKey, door, persona, how) {
+    const socket = new WebSocket(socketUrl, { headers: { authorization: `Bearer ${apiKey}` } });
+    const heard = new Heard(how.out, how.opened);
+    socket.on("message", (frame) => heard.absorb(JSON.parse(frame.toString())));
+    await once(socket, "open");
+    await heard.quiet();
+    for (let turn = 0; turn < how.turns; turn += 1) {
+        const next = await theNextLine(door, {
+            persona: callingAs(persona),
+            heard: heard.said,
+            turns_left: how.turns - turn,
+        });
+        if (next.say === "")
+            break;
+        const before = heard.agentTurns;
+        socket.send(JSON.stringify({ text: next.say }));
+        await heard.answered(before);
+        if (next.hangup)
+            break;
+    }
+    socket.close();
+    how.out.write(`  ${heard.call ?? "no call"} · ${heard.agentTurns} agent turn(s)\n`);
+    return heard.call ?? "";
+}
+// The spoken door: a room, the agent dispatched into it, and the persona's own voice on a line
+// that may be spoiled on purpose. The whole call is held in the runtime, where the LiveKit pair
+// and the box's speech tool are; this side mints the id and watches the log while it happens.
+async function outLoud(door, slug, persona, how) {
+    const call = aCallId();
+    how.opened?.(call);
+    const heard = new Heard(how.out);
+    // The ear is taken before the call is asked for: the seat is minted off the room, which opens a
+    // moment later, and joining late is joining after the greeting — the one turn worth hearing.
+    const ear = how.listen === true ? listening(door, call, how.out) : null;
+    const held = aVoiceCall(door, {
+        call,
+        agent: slug,
+        persona: callingAs(persona),
+        turns: how.turns,
+        ...(how.degraded === undefined ? {} : { degraded: how.degraded }),
+    });
+    await watching(door, call, held, (entry) => heard.absorb(entry));
+    const called = await held;
+    await (await ear)?.leave();
+    how.out.write(`  ${call} · ${called.turns} caller turn(s) · ${heard.agentTurns} agent turn(s) · ${called.line}\n`);
+    return call;
+}
+// An ear that could not be taken is a line printed and a call that still happens: a machine with
+// no player, or without the optional room library, must not lose the simulation over it.
+async function listening(door, call, out) {
+    try {
+        return await anEarIn(door, call, out);
+    }
+    catch (failed) {
+        out.write(`  not listening: ${failed instanceof Error ? failed.message : String(failed)}\n`);
+        return null;
+    }
+}
+/** The persona as the runtime's two doors take it: three declarations, and no script at all. */
+function callingAs(persona) {
+    return {
+        name: persona.name,
+        goal: persona.goal,
+        style: persona.style,
+        ...(persona.facts === undefined ? {} : { facts: persona.facts }),
+    };
+}
+// What is read back off the call's own log once the caller has gone: the latencies livekit
+// measured for every turn, and — when somebody asked for it — the `call.score` the log seals on.
+// Nothing here computes a metric the log does not already carry.
+async function theEnding(door, call, how) {
+    if (call === "")
+        return {};
+    const measured = latencyLine(mediansOf(await entriesOf(door, call)));
+    how.out.write(`  ${measured === "" ? "no metrics on this call" : measured}\n`);
+    return { score: how.judge ? await theScore(door, call, how.out) : undefined };
+}
+// The judges take as long as they take; nothing here hurries them, and a call that never sealed
+// says so instead of printing a verdict nobody wrote.
+async function theScore(door, call, out) {
+    const deadline = Date.now() + JUDGING_MAY_TAKE_MS;
+    while (Date.now() < deadline) {
+        const sealed = await sealing(door, call);
+        if (sealed !== undefined) {
+            out.write(`${linesOfScore(sealed).join("\n")}\n`);
+            return sealed;
+        }
+        await after(SETTLE_MS);
+    }
+    out.write(`${notSealed(call)}\n`);
+    return undefined;
+}
+/** The entry the log seals on, when it is there yet. A log still being written has none. */
+async function sealing(door, call) {
+    const sealed = (await entriesOf(door, call)).find((entry) => entry.type === TERMINAL_ENTRY);
+    return sealed === undefined ? undefined : sealed.data;
+}
+// The call's log as this terminal hears it: printed as it lands, and quiet when the app has
+// finished reacting. Everything the simulation knows about where the call is, it knows from here —
+// including the transcript the caller model is handed, which is the log's own turns and not a
+// second copy this process kept.
+class Heard {
+    out;
+    opened;
+    call;
+    agentTurns = 0;
+    said = [];
+    last = Date.now();
+    constructor(out, opened) {
+        this.out = out;
+        this.opened = opened;
+    }
+    /** One entry: remembered, and printed when it is a line of the conversation rather than wiring. */
+    absorb(entry) {
+        this.last = Date.now();
+        if (typeof entry.call === "string" && this.call === undefined) {
+            this.call = entry.call;
+            this.opened?.(entry.call);
+        }
+        if (entry.type === "turn.agent")
+            this.agentTurns += 1;
+        if (entry.type === "turn.user" || entry.type === "turn.agent") {
+            this.said.push({
+                who: entry.type === "turn.agent" ? "agent" : "caller",
+                said: String(entry.data["text"] ?? ""),
+            });
+        }
+        // Both sides are printed off the log and never off what this process sent: on a spoken call
+        // the caller's own turn is what the STT heard, which is the line that matters.
+        const line = lineFor(entry);
+        if (line === null)
+            return;
+        const metrics = entry.type === "turn.agent"
+            ? `  ${metricsLine(entry.data["metrics"])}`
+            : "";
+        this.out.write(`${line.mark} ${line.text}${metrics}\n`);
+    }
+    /** Waits until the agent has spoken again, and then until the app has finished reacting. */
+    async answered(said) {
+        const deadline = Date.now() + A_TURN_MAY_TAKE_MS;
+        while (this.agentTurns === said && Date.now() < deadline)
+            await after(SETTLE_MS / 4);
+        await this.quiet();
+    }
+    /** Waits until nothing has been written for a moment: the app has answered and re-rendered. */
+    async quiet() {
+        const deadline = Date.now() + A_TURN_MAY_TAKE_MS;
+        while (Date.now() - this.last < SETTLE_MS && Date.now() < deadline)
+            await after(SETTLE_MS / 4);
+    }
+}
+function after(ms) {
+    return new Promise((wake) => setTimeout(wake, ms));
+}
+function once(socket, event) {
+    return new Promise((done, failed) => {
+        socket.on(event, () => done());
+        socket.on("error", failed);
+    });
+}
+//# sourceMappingURL=simulate.js.map

package/dist/cli/simulate.js.map

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

package/dist/cli/supervise.d.ts

@@ -0,0 +1,18 @@
+/** `pinecall supervise <call>`: a human at the desk — the transcript as it lands, and the five moves. */
+import type { Verb } from "@pinecall/protocol";
+import type { Group } from "./groups.js";
+export declare const ON_THE_SPEAKERS = "the audio of a live call is the console, which has a room \u2014 `pinecall run` prints its URL; this is the transcript and the desk";
+/** What a supervisor may type, one move per line. `q` leaves and the call goes on without them. */
+export declare const MOVES: readonly [readonly ["w <text>", "whisper to the agent — the caller never hears it"], readonly ["s <text>", "say it to the caller, in the agent's voice, verbatim"], readonly ["t", "take the line: the agent stops speaking and you are on it"], readonly ["x", "give it back: the agent has the line again"], readonly ["e [reason]", "end the call"], readonly ["q", "leave the desk; the call goes on"]];
+export declare const group: Group;
+/** What the verb can be told besides the argv: where to print, and which environment. Tests only. */
+export interface Running {
+    out?: NodeJS.WritableStream;
+    err?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function run(argv: string[], how?: Running): Promise<number>;
+/** One typed line as the verb it names, `leave` for q, and nothing at all for a line nobody meant. */
+export declare function moveOf(typed: string): Verb | "leave" | null;
+export declare function lineOf(seq: number, type: string, data: Record<string, unknown>): string | null;
+//# sourceMappingURL=supervise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervise.d.ts","sourceRoot":"","sources":["../../src/cli/supervise.ts"],"names":[],"mappings":"AAAA,yGAAyG;AAIzG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASzC,eAAO,MAAM,eAAe,wIACsG,CAAC;AAEnI,mGAAmG;AACnG,eAAO,MAAM,KAAK,sBACf,UAAU,EAAE,kDAAkD,aAC9D,UAAU,EAAE,sDAAsD,aAClE,GAAG,EAAE,2DAA2D,aAChE,GAAG,EAAE,4CAA4C,aACjD,YAAY,EAAE,cAAc,aAC5B,GAAG,EAAE,kCAAkC,EAChC,CAAC;AAEX,eAAO,MAAM,KAAK,EAAE,KAWnB,CAAC;AAEF,qGAAqG;AACrG,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB5E;AA0CD,sGAAsG;AACtG,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAW3D;AASD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAW9F"}

package/dist/cli/supervise.js

@@ -0,0 +1,134 @@
+/** `pinecall supervise <call>`: a human at the desk — the transcript as it lands, and the five moves. */
+import { createInterface } from "node:readline";
+import { Pinecall } from "../client/index.js";
+import { theDoor } from "./env.js";
+import { asked } from "./testing/gateway.js";
+import { refusal } from "./whoami.js";
+const USAGE = "usage: pinecall supervise <call>";
+// The audio is the console's, deliberately: a terminal has no speakers this process may reach, and
+// `pinecall simulate --listen` already says the same sentence about the same room. What a terminal
+// CAN do is the transcript and the desk, which is what this verb is.
+export const ON_THE_SPEAKERS = "the audio of a live call is the console, which has a room — `pinecall run` prints its URL; this is the transcript and the desk";
+/** What a supervisor may type, one move per line. `q` leaves and the call goes on without them. */
+export const MOVES = [
+    ["w <text>", "whisper to the agent — the caller never hears it"],
+    ["s <text>", "say it to the caller, in the agent's voice, verbatim"],
+    ["t", "take the line: the agent stops speaking and you are on it"],
+    ["x", "give it back: the agent has the line again"],
+    ["e [reason]", "end the call"],
+    ["q", "leave the desk; the call goes on"],
+];
+export const group = {
+    purpose: "listen in: whisper, say, takeover, transfer, end",
+    usage: `${USAGE}
+
+  The call's transcript as it happens, and one line to move on it:
+
+${MOVES.map(([key, what]) => `    ${key.padEnd(11)} ${what}`).join("\n")}
+
+  Every move lands in the caller's own log as its own \`supervisor.*\` entry with a seq, so what a
+  human did to a call is read the same way as what the agent did. ${ON_THE_SPEAKERS}.`,
+    run,
+};
+export async function run(argv, how = {}) {
+    const out = how.out ?? process.stdout;
+    const err = how.err ?? process.stderr;
+    const call = argv.find((word) => !word.startsWith("-"));
+    if (call === undefined) {
+        err.write(`${USAGE}\n`);
+        return 2;
+    }
+    const door = theDoor(how.env ?? process.env, err);
+    if (door === undefined)
+        return 2;
+    out.write(`${call} · ${ON_THE_SPEAKERS}\n`);
+    const pc = new Pinecall({ url: door.url, apiKey: door.apiKey });
+    try {
+        return await atTheDesk(pc, door, call, out, err);
+    }
+    catch (refused) {
+        err.write(`${refusal(refused)}\n`);
+        return 1;
+    }
+}
+/**
+ * The two halves at once: the log printing itself, and a keyboard sending verbs. Neither waits for
+ * the other — a move typed while the caller is mid-sentence is sent while they finish it.
+ */
+async function atTheDesk(pc, door, call, out, err) {
+    const lines = createInterface({ input: process.stdin, output: process.stdout, prompt: "> " });
+    let ended = false;
+    const watching = (async () => {
+        for await (const seen of pc.observe({ call })) {
+            // The entry's own data and not the folded event: what a desk prints is what the log wrote.
+            const line = lineOf(seen.entry.seq, seen.entry.type, seen.entry.data);
+            if (line !== null)
+                out.write(`\r${line}\n`);
+            lines.prompt();
+            if (seen.entry.type === "call.ended")
+                ended = true;
+            if (ended)
+                break;
+        }
+    })();
+    lines.prompt();
+    for await (const typed of lines) {
+        if (ended)
+            break;
+        const move = moveOf(typed.trim());
+        if (move === "leave")
+            break;
+        if (move === null) {
+            err.write(`\rnot a move. ${MOVES.map(([key]) => key.split(" ")[0]).join(" · ")}\n`);
+        }
+        else {
+            await sent(door, call, move).catch((refused) => err.write(`\r${refusal(refused)}\n`));
+        }
+        lines.prompt();
+    }
+    lines.close();
+    await watching.catch(() => undefined);
+    return 0;
+}
+/** One typed line as the verb it names, `leave` for q, and nothing at all for a line nobody meant. */
+export function moveOf(typed) {
+    const [key, ...rest] = typed.split(" ");
+    const said = rest.join(" ").trim();
+    if (key === "q")
+        return "leave";
+    if (key === "t")
+        return { verb: "takeover" };
+    if (key === "x")
+        return { verb: "release" };
+    if (key === "e")
+        return { verb: "end", reason: said === "" ? undefined : said };
+    if (said === "")
+        return null;
+    if (key === "w")
+        return { verb: "whisper", text: said };
+    if (key === "s")
+        return { verb: "say", text: said };
+    return null;
+}
+async function sent(door, call, verb) {
+    await asked(door, `/v1/calls/${encodeURIComponent(call)}/verbs`, { method: "POST", body: verb });
+}
+// What a person at a desk reads: both speakers, and every move anybody made on this call. The
+// entries a supervisor cannot act on — metrics, prompt changes, state — are not printed, because
+// the whole point of the desk is the conversation.
+export function lineOf(seq, type, data) {
+    const at = String(seq).padStart(4, " ");
+    if (type === "turn.user")
+        return `${at}  caller  ${String(data["text"] ?? "")}`;
+    if (type === "turn.agent")
+        return `${at}  agent   ${String(data["text"] ?? "")}`;
+    if (type === "call.ended")
+        return `${at}  ——      ended: ${String(data["reason"] ?? "")}`;
+    if (type.startsWith("supervisor.")) {
+        const what = type.slice("supervisor.".length);
+        const said = data["text"] ?? data["reason"] ?? data["to"] ?? "";
+        return `${at}  desk    ${what}${said === "" ? "" : ` ${String(said)}`}`;
+    }
+    return null;
+}
+//# sourceMappingURL=supervise.js.map

package/dist/cli/supervise.js.map

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

package/dist/cli/test.d.ts

@@ -0,0 +1,12 @@
+/** `pinecall test [paths]`: the goldens, through the app this terminal is holding, scored by the runtime. */
+import type { Group } from "./groups.js";
+export declare const group: Group;
+/**
+ * The class is mounted HERE, in this process, exactly as `pinecall chat` mounts it: the tenant's
+ * @tool bodies run against the tenant's own database and a breakpoint in one is reachable. The
+ * gateway drives the conversations and scores them, because the judge, the keys and the log are
+ * its — see docs/decisions/pinecall-test.md. The suite itself is `testing/suite.ts`, which the
+ * console runs too.
+ */
+export declare function run(argv: string[], out?: NodeJS.WritableStream): Promise<number>;
+//# sourceMappingURL=test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/cli/test.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAS7G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAUzC,eAAO,MAAM,KAAK,EAAE,KAiBnB,CAAC;AA0BF;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAM,CAAC,cAA+B,GAAG,OAAO,CAAC,MAAM,CAAC,CA2CtG"}