@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/engine/roundagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundagents.js","sourceRoot":"","sources":["../../../src/engine/roundagents.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6EAA6E;AAC7E,mEAAmE;AACnE,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAsB,MAAM,gBAAgB,CAAC;AAE9F;;;;;qEAKqE;AACrE,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,GAAe,EACf,MAAc,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC;AACzC;;+DAE+D;AAC/D,UAA2E,EAAE;IAE7E,0EAA0E;IAC1E,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE;QACnD,0EAA0E;QAC1E,MAAM,EAAE,KAAK;QACb,IAAI;QACJ,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK;QACvB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW;QAClC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa;QACtC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC;QACvB,SAAS,EAAE,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;QACzE,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC;QAC7B,OAAO,EAAE;YACP,GAAG,YAAY;YACf,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC;YAC5B,GAAG,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;YAC/D,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC;YAChC,gEAAgE;YAChE,GAAG,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC;SACrC;KACF,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC"}

package/dist/src/engine/roundevents.d.ts

@@ -0,0 +1,110 @@
+export interface Usage {
+    input: number;
+    output: number;
+    cacheRead: number;
+}
+/** The child results a `tool_execution_end` event of a lens tool carries
+ * (`result.details.results`); [] for any other shape. A result with an `id`
+ * (LensResult v1) can come back from more than one call — claim it on a
+ * `LensOnce` before counting it. */
+export declare function childResults(e: Record<string, unknown>): unknown[];
+/**
+ * Sum model usage from pi `--mode json` stdout lines. The parent's own turns
+ * carry `usage` on every assistant `message_end`; lens passes run as child
+ * processes, and the native subagent tool reports each child's usage in its
+ * tool result — both are counted, and a line that is not JSON is skipped
+ * (stderr noise, a truncated final line).
+ */
+export declare function usageFromEvents(lines: Iterable<string>): Usage & {
+    children: number;
+};
+/** One lens tool call (`subagent`, `launch_plan`, `lens`, `lens_wave`) of the
+ * main session: a lens fan-out, a validator, a re-run. */
+export interface StageCall {
+    /** Launch order, from 0. */
+    call: number;
+    tool_call_id: string | null;
+    /** The agents it launched (one, or a parallel `tasks` list). */
+    agents: string[];
+    /** `validate` when every agent is pass-validate. */
+    kind: "lens" | "validate";
+    /**
+     * A GUESS from launch order: `delta` up to and including the first
+     * validator call, `sweep` for every call launched after that validator
+     * returned. On a follow-up round that is the change review vs the
+     * pre-approval sweep (its lenses and its own validator); on a round-1 case
+     * a `sweep` call is a re-run after the validator.
+     */
+    phase: "delta" | "sweep";
+    /** The main session's last message before the call — so the window
+     * includes the session writing the tasks (tool-call arguments are output
+     * tokens). Null when no message preceded it. */
+    start_ms: number | null;
+    /** The last child message; else the session's first message after the
+     * call returned. Null when neither exists (a truncated stream). */
+    end_ms: number | null;
+    usage: Usage;
+    /** pi's own price of the children ($), summed. */
+    cost: number;
+    children: number;
+}
+export interface StageTotals {
+    calls: number;
+    agents: number;
+    usage: Usage;
+    cost: number;
+    /** First start to last end over the phase's calls; null when unknown. */
+    start_ms: number | null;
+    end_ms: number | null;
+    wall_ms: number | null;
+}
+export interface Stages {
+    calls: StageCall[];
+    phases: {
+        delta: StageTotals;
+        sweep: StageTotals;
+    };
+}
+/**
+ * Split one review's pi `--mode json` stream into its subagent calls, each
+ * with its agents, its phase (by launch order relative to the first
+ * pass-validate call — see `StageCall.phase`), its wall window and its usage
+ * and cost, plus a total per phase. Pure; a line that is not JSON is skipped.
+ * `tool_execution_*` events carry no timestamp, so times come from message
+ * stamps: the parent's, and each child's own messages in the tool result.
+ */
+export declare function stagesFromEvents(lines: Iterable<string>): Stages;
+/** Model-call failures one review saw, by kind. `rate_limited` and
+ * `overloaded` are the shared login pushing back (every bench container
+ * draws on ONE ChatGPT login): a case that failed with either is retried by
+ * arm.sh after a pause, never scored as the reviewer's own miss.
+ * `usage_limit` is the login's PLAN window exhausted ("Codex error: The usage
+ * limit has been reached", each case failing within seconds): no pause of
+ * minutes cures it, so arm.sh stops launching instead of burning the retries
+ * (older summaries lack this kind). */
+export interface ModelErrors {
+    rate_limited: number;
+    overloaded: number;
+    usage_limit?: number;
+    other: number;
+    /** One message of the most telling kind, for the log. */
+    sample?: string;
+}
+/** The plan's usage window is spent (checked before RATE_LIMIT_RE, which it
+ * would also match). */
+export declare const USAGE_LIMIT_RE: RegExp;
+export declare const RATE_LIMIT_RE: RegExp;
+export declare const OVERLOAD_RE: RegExp;
+/** A model error message's kind: a spent usage window first (its words would
+ * also read as a rate limit), then a rate limit, then an overload. One
+ * reading for pi's event stream and its stderr. */
+export declare function modelErrorKind(message: string): "usage_limit" | "rate_limited" | "overloaded" | "other";
+/**
+ * Count the failed model calls in pi's `--mode json` stream: every assistant
+ * message with `stopReason: "error"`, the parent's and the lens children's
+ * alike (children's arrive nested in the subagent tool result). pi repeats a
+ * message in later events (updates, the final message list), so each is
+ * counted once, keyed by its timestamp and text.
+ */
+export declare function modelErrorsFromEvents(lines: Iterable<string>): ModelErrors;
+//# sourceMappingURL=roundevents.d.ts.map

package/dist/src/engine/roundevents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundevents.d.ts","sourceRoot":"","sources":["../../../src/engine/roundevents.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD;;;oCAGoC;AACpC,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CA2BrF;AAID;0DAC0D;AAC1D,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gEAAgE;IAChE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B;;;;;;OAMG;IACH,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB;;oDAEgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;uEACmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAqHhE;AAED;;;;;;;uCAOuC;AACvC,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;wBACwB;AACxB,eAAO,MAAM,cAAc,QACwF,CAAC;AACpH,eAAO,MAAM,aAAa,QAAsE,CAAC;AACjG,eAAO,MAAM,WAAW,QAA4C,CAAC;AAErE;;mDAEmD;AACnD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,OAAO,CAKzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CA0C1E"}

package/dist/src/engine/roundevents.js

@@ -0,0 +1,276 @@
+// What a round's pi event stream says about the round: its token usage, its
+// per-stage cost and time (the lens calls, split into the change review and the
+// pre-approval sweep), and the model-call failures it saw. Pure readers of the
+// `pi --mode json` stream either runtime writes; the round records them
+// (packages/pi-plugin/src/engine/round.ts), the bench reports them (src/bench/aacr.ts).
+import { isLensTool, LENS_WAVE_TOOL, lensIdOf, LensOnce, lensResultsOf } from "../lensresult.js";
+import { usageCost } from "../pricing.js";
+// ---- pi's JSON event stream ---------------------------------------------------
+/** Add one pi `usage` object's token counts to `into` (a field that is not a
+ * number counts 0; a usage that is not an object adds nothing). */
+function addUsage(into, x) {
+    if (typeof x !== "object" || x === null)
+        return;
+    const r = x;
+    const n = (k) => (typeof r[k] === "number" ? r[k] : 0);
+    into.input += n("input");
+    into.output += n("output");
+    into.cacheRead += n("cacheRead");
+}
+/** The child results a `tool_execution_end` event of a lens tool carries
+ * (`result.details.results`); [] for any other shape. A result with an `id`
+ * (LensResult v1) can come back from more than one call — claim it on a
+ * `LensOnce` before counting it. */
+export function childResults(e) {
+    return lensResultsOf(e["result"]);
+}
+/**
+ * Sum model usage from pi `--mode json` stdout lines. The parent's own turns
+ * carry `usage` on every assistant `message_end`; lens passes run as child
+ * processes, and the native subagent tool reports each child's usage in its
+ * tool result — both are counted, and a line that is not JSON is skipped
+ * (stderr noise, a truncated final line).
+ */
+export function usageFromEvents(lines) {
+    const u = { input: 0, output: 0, cacheRead: 0, children: 0 };
+    const add = (x) => addUsage(u, x);
+    const once = new LensOnce();
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (e["type"] === "message_end") {
+            const m = e["message"];
+            if (m?.["role"] === "assistant")
+                add(m["usage"]);
+        }
+        if (e["type"] === "tool_execution_end") {
+            for (const r of childResults(e)) {
+                const usage = r?.["usage"];
+                if (usage && once.claim(lensIdOf(r))) {
+                    add(usage);
+                    u.children++;
+                }
+            }
+        }
+    }
+    return u;
+}
+/**
+ * Split one review's pi `--mode json` stream into its subagent calls, each
+ * with its agents, its phase (by launch order relative to the first
+ * pass-validate call — see `StageCall.phase`), its wall window and its usage
+ * and cost, plus a total per phase. Pure; a line that is not JSON is skipped.
+ * `tool_execution_*` events carry no timestamp, so times come from message
+ * stamps: the parent's, and each child's own messages in the tool result.
+ */
+export function stagesFromEvents(lines) {
+    const calls = [];
+    const open = new Map();
+    const awaitingEnd = [];
+    const once = new LensOnce();
+    let lastTs = null;
+    let firstValidateDone = false;
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const m = e["message"];
+        const ts = typeof m?.["timestamp"] === "number" ? m["timestamp"] : null;
+        if (ts !== null) {
+            for (const c of awaitingEnd.splice(0))
+                c.end_ms = ts;
+            lastTs = ts;
+        }
+        // `launch_plan` launches lenses through the subagent tool's own
+        // execute; its args name task dirs, so its agents come from the result.
+        // `lens_wave` joins a wave the engine launched: no args at all.
+        if (!isLensTool(e["toolName"]))
+            continue;
+        const id = typeof e["toolCallId"] === "string" ? e["toolCallId"] : null;
+        if (e["type"] === "tool_execution_start") {
+            const args = (e["args"] ?? {});
+            const agents = typeof args["agent"] === "string"
+                ? [args["agent"]]
+                : Array.isArray(args["tasks"])
+                    ? args["tasks"]
+                        .map((t) => t?.["agent"])
+                        .filter((a) => typeof a === "string")
+                    : [];
+            const call = {
+                call: calls.length,
+                tool_call_id: id,
+                agents,
+                kind: agents.length > 0 && agents.every((a) => a.startsWith("pass-validate"))
+                    ? "validate"
+                    : "lens",
+                phase: firstValidateDone ? "sweep" : "delta",
+                start_ms: lastTs,
+                end_ms: null,
+                usage: { input: 0, output: 0, cacheRead: 0 },
+                cost: 0,
+                children: 0,
+            };
+            calls.push(call);
+            if (id !== null)
+                open.set(id, call);
+        }
+        else if (e["type"] === "tool_execution_end") {
+            const call = id !== null ? open.get(id) : undefined;
+            if (!call)
+                continue;
+            open.delete(id);
+            const results = childResults(e);
+            // A run a lens-id'd result already reported (a `lens_wave` joining a
+            // wave, or joining it again) is counted by its first call only.
+            const fresh = new Set(results.filter((r) => once.claim(lensIdOf(r))));
+            // A launch_plan call named no agent at start: its results do.
+            if (call.agents.length === 0)
+                call.agents = results
+                    .filter((r) => fresh.has(r))
+                    .map((r) => r?.["agent"])
+                    .filter((a) => typeof a === "string");
+            let last = null;
+            let first = null;
+            for (const r0 of results) {
+                const r = (r0 ?? {});
+                const u = r["usage"];
+                if (u && fresh.has(r0)) {
+                    addUsage(call.usage, u);
+                    call.cost += usageCost(u["cost"]);
+                    call.children++;
+                }
+                for (const msg of Array.isArray(r["messages"]) ? r["messages"] : []) {
+                    const t = msg?.["timestamp"];
+                    if (typeof t !== "number")
+                        continue;
+                    if (last === null || t > last)
+                        last = t;
+                    if (fresh.has(r0) && (first === null || t < first))
+                        first = t;
+                }
+            }
+            // A `lens_wave` joins a wave the engine started at round start: the
+            // wave's window opens with its first lens message, not with the join.
+            if (e["toolName"] === LENS_WAVE_TOOL && first !== null)
+                call.start_ms = call.start_ms === null ? first : Math.min(call.start_ms, first);
+            if (last !== null)
+                call.end_ms = last;
+            else
+                awaitingEnd.push(call);
+            if (call.kind === "validate")
+                firstValidateDone = true;
+        }
+    }
+    const total = (phase) => {
+        const mine = calls.filter((c) => c.phase === phase);
+        const starts = mine.map((c) => c.start_ms).filter((x) => x !== null);
+        const ends = mine.map((c) => c.end_ms).filter((x) => x !== null);
+        const start = starts.length ? Math.min(...starts) : null;
+        const end = ends.length ? Math.max(...ends) : null;
+        return {
+            calls: mine.length,
+            agents: mine.reduce((n, c) => n + c.agents.length, 0),
+            usage: mine.reduce((u, c) => ({
+                input: u.input + c.usage.input,
+                output: u.output + c.usage.output,
+                cacheRead: u.cacheRead + c.usage.cacheRead,
+            }), { input: 0, output: 0, cacheRead: 0 }),
+            cost: mine.reduce((n, c) => n + c.cost, 0),
+            start_ms: start,
+            end_ms: end,
+            wall_ms: start !== null && end !== null && end >= start ? end - start : null,
+        };
+    };
+    return { calls, phases: { delta: total("delta"), sweep: total("sweep") } };
+}
+/** The plan's usage window is spent (checked before RATE_LIMIT_RE, which it
+ * would also match). */
+export const USAGE_LIMIT_RE = /usage limit has been reached|usage[ _-]?limit[ _-]?reached|insufficient[ _-]?quota|exceeded your current quota/i;
+export const RATE_LIMIT_RE = /\b429\b|rate[ _-]?limit|too many requests|usage[ _-]?limit|quota/i;
+export const OVERLOAD_RE = /overloaded|\b50[23]\b|\b529\b|capacity/i;
+/** A model error message's kind: a spent usage window first (its words would
+ * also read as a rate limit), then a rate limit, then an overload. One
+ * reading for pi's event stream and its stderr. */
+export function modelErrorKind(message) {
+    if (USAGE_LIMIT_RE.test(message))
+        return "usage_limit";
+    if (RATE_LIMIT_RE.test(message))
+        return "rate_limited";
+    if (OVERLOAD_RE.test(message))
+        return "overloaded";
+    return "other";
+}
+/**
+ * Count the failed model calls in pi's `--mode json` stream: every assistant
+ * message with `stopReason: "error"`, the parent's and the lens children's
+ * alike (children's arrive nested in the subagent tool result). pi repeats a
+ * message in later events (updates, the final message list), so each is
+ * counted once, keyed by its timestamp and text.
+ */
+export function modelErrorsFromEvents(lines) {
+    const seen = new Set();
+    const out = { rate_limited: 0, overloaded: 0, usage_limit: 0, other: 0 };
+    const visit = (x, depth) => {
+        if (depth > 12 || typeof x !== "object" || x === null)
+            return;
+        if (Array.isArray(x)) {
+            for (const y of x)
+                visit(y, depth + 1);
+            return;
+        }
+        const r = x;
+        if (r["stopReason"] === "error" && typeof r["errorMessage"] === "string") {
+            const msg = r["errorMessage"];
+            const key = `${String(r["timestamp"] ?? "")}|${msg}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                const kind = modelErrorKind(msg);
+                if (kind === "usage_limit") {
+                    out.usage_limit = (out.usage_limit ?? 0) + 1;
+                    out.sample = msg.slice(0, 200);
+                }
+                else if (kind === "rate_limited") {
+                    out.rate_limited++;
+                    if (!out.usage_limit)
+                        out.sample = msg.slice(0, 200);
+                }
+                else if (kind === "overloaded") {
+                    out.overloaded++;
+                    if (!out.rate_limited && !out.usage_limit)
+                        out.sample = msg.slice(0, 200);
+                }
+                else {
+                    out.other++;
+                    out.sample ??= msg.slice(0, 200);
+                }
+            }
+        }
+        for (const v of Object.values(r))
+            visit(v, depth + 1);
+    };
+    for (const line of lines) {
+        if (!line.trim() || !line.includes('"errorMessage"'))
+            continue;
+        try {
+            visit(JSON.parse(line), 0);
+        }
+        catch {
+            // not JSON — stderr noise or a truncated final line
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=roundevents.js.map

package/dist/src/engine/roundevents.js.map

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

package/dist/src/engine/roundsdk.d.ts

@@ -0,0 +1,33 @@
+import type { ExtensionFactory, ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { SessionSpec } from "./port.js";
+import type { SessionExtras } from "./sdkruntime.js";
+/** The lens tool of a round: the factories that register it (the native tool is
+ * a file's extension) or the definitions handed over as `customTools` (our own,
+ * packages/pi-plugin/src/engine/lens/engine-tools.ts), and the tool names they add to the allowlist. */
+export interface RoundLensTools {
+    factories: readonly ExtensionFactory[];
+    customTools?: readonly ToolDefinition[];
+    toolNames: readonly string[];
+}
+export interface RoundSdkOptions {
+    /** The route's lens tool. Omitted: the session has none. */
+    lens?: RoundLensTools;
+    /** Where ledger-pin's diagnostics go, one line each. Omitted: nowhere. */
+    log?: (line: string) => void;
+}
+/** The names the model's bash may draw from the spec's env besides the host
+ * defaults: the git isolation pins and the QCR_* names the round's scripts read.
+ * The proc route's bash saw the whole env; the API keys in it are not carried. */
+export declare const BASH_ENV_ALLOW: readonly ["GIT_*", "QCR_*"];
+/** The reviewer stub as a context file at `<cwd>/AGENTS.override.md`. A
+ * checkout keeps it at `deploy/reviewer/`; the release and bench images install
+ * it at the tree's root (docker/Dockerfile, bench/aacr/Dockerfile), so both
+ * places are tried. A round without the stub fails here, loudly: a context file
+ * is never dropped silently. */
+export declare function reviewerStub(root: string, cwd: string): {
+    path: string;
+    content: string;
+};
+/** The per-session pieces of a round's main session on the SDK runtime. */
+export declare function roundSdkExtras(options?: RoundSdkOptions): (spec: SessionSpec) => SessionExtras;
+//# sourceMappingURL=roundsdk.d.ts.map

package/dist/src/engine/roundsdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundsdk.d.ts","sourceRoot":"","sources":["../../../src/engine/roundsdk.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AASxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;wGAEwG;AACxG,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;kFAEkF;AAClF,eAAO,MAAM,cAAc,6BAA8B,CAAC;AAE1D;;;;gCAIgC;AAChC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKzF;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,OAAO,GAAE,eAAoB,GAC5B,CAAC,IAAI,EAAE,WAAW,KAAK,aAAa,CA6BtC"}

package/dist/src/engine/roundsdk.js

@@ -0,0 +1,76 @@
+// What a review round's main session carries on the SDK runtime, so that its
+// provider request is the one the process route's `pi` sends (canary 10, full:
+// tests/pi-canary/canary-10-oneshot-request.test.ts).
+//
+// The process route hands pi extension FILES (`--extension`), the cwd's context
+// file and a spawn env. An SDK session has none of those, so the same things
+// arrive as data and factories:
+//
+//   extension files          the factories the files' own shims call, built from
+//                            the spec's env (bash-guard, ledger-pin,
+//                            finding-clusters), in the file order of the proc route
+//   the lens tool            a factory the route hands in (`lens`): today's native
+//                            one is a file only; the engine's lens tools
+//                            take this slot
+//   the tool allowlist       pi's defaults plus every tool those extensions
+//                            register: pi's CLI activates all of them, and the
+//                            host drops anything not named
+//   the context stub     the reviewer stub handed as data, at the path pi
+//                            would have read it from in the cwd; never read
+//                            from, or written into, a checkout
+//   the model's bash env     an allowlist over the spec's env, never a GitHub
+//                            token (pisdk.ts buildBashEnv)
+//
+// `roundSdkExtras()` is the `extras` option of `sdkRuntime(host, { extras })`.
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { bashGuardConfigFromEnv, createBashGuard } from "../../extensions/bash-guard.js";
+import { FINDING_CLUSTERS_TOOLS, createFindingClusters, } from "../../extensions/finding-clusters.js";
+import { createLedgerPin, ledgerPinConfigFromEnv } from "../../extensions/ledger-pin.js";
+import { HOST_CONTEXT_STUB, reviewerStubSource } from "../reviewerstub.js";
+import { DEFAULT_TOOLS } from "./pisdk.js";
+/** The names the model's bash may draw from the spec's env besides the host
+ * defaults: the git isolation pins and the QCR_* names the round's scripts read.
+ * The proc route's bash saw the whole env; the API keys in it are not carried. */
+export const BASH_ENV_ALLOW = ["GIT_*", "QCR_*"];
+/** The reviewer stub as a context file at `<cwd>/AGENTS.override.md`. A
+ * checkout keeps it at `deploy/reviewer/`; the release and bench images install
+ * it at the tree's root (docker/Dockerfile, bench/aacr/Dockerfile), so both
+ * places are tried. A round without the stub fails here, loudly: a context file
+ * is never dropped silently. */
+export function reviewerStub(root, cwd) {
+    return {
+        path: join(cwd, HOST_CONTEXT_STUB),
+        content: readFileSync(reviewerStubSource(root), "utf8"),
+    };
+}
+/** The per-session pieces of a round's main session on the SDK runtime. */
+export function roundSdkExtras(options = {}) {
+    return (spec) => {
+        const root = spec.env["QCR_SANDBOX_ROOT"];
+        if (root === undefined)
+            throw new Error("a round's spec names its production tree (QCR_SANDBOX_ROOT)");
+        const lens = options.lens;
+        return {
+            // The proc route's `--extension` order: bash-guard, ledger-pin, the lens
+            // tool, finding-clusters. The tool list in the request follows it.
+            extensions: [
+                createBashGuard(bashGuardConfigFromEnv(spec.env, spec.cwd)),
+                // The snapshot lands under the production tree (QCR_SANDBOX_ROOT),
+                // which a round's spec always names.
+                createLedgerPin(ledgerPinConfigFromEnv(spec.env, root, options.log ? { log: options.log } : {})),
+                ...(lens?.factories ?? []),
+                createFindingClusters(),
+            ],
+            tools: [
+                ...DEFAULT_TOOLS,
+                ...(lens?.toolNames ?? []),
+                ...FINDING_CLUSTERS_TOOLS.map((t) => t.name),
+            ],
+            ...(lens?.customTools?.length ? { customTools: lens.customTools } : {}),
+            agentsFiles: [reviewerStub(root, spec.cwd)],
+            bashEnv: { allow: BASH_ENV_ALLOW },
+        };
+    };
+}
+//# sourceMappingURL=roundsdk.js.map

package/dist/src/engine/roundsdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundsdk.js","sourceRoot":"","sources":["../../../src/engine/roundsdk.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,sDAAsD;AACtD,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gCAAgC;AAChC,EAAE;AACF,iFAAiF;AACjF,qEAAqE;AACrE,oFAAoF;AACpF,mFAAmF;AACnF,yEAAyE;AACzE,4CAA4C;AAC5C,4EAA4E;AAC5E,+EAA+E;AAC/E,2DAA2D;AAC3D,0EAA0E;AAC1E,4EAA4E;AAC5E,+DAA+D;AAC/D,8EAA8E;AAC9E,2DAA2D;AAC3D,EAAE;AACF,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoB3C;;kFAEkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,CAAU,CAAC;AAE1D;;;;gCAIgC;AAChC,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,GAAW;IACpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC;QAClC,OAAO,EAAE,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAC5B,UAA2B,EAAE;IAE7B,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,SAAS;YACpB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,OAAO;YACL,yEAAyE;YACzE,mEAAmE;YACnE,UAAU,EAAE;gBACV,eAAe,CAAC,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3D,mEAAmE;gBACnE,qCAAqC;gBACrC,eAAe,CACb,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChF;gBACD,GAAG,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;gBAC1B,qBAAqB,EAAE;aACxB;YACD,KAAK,EAAE;gBACL,GAAG,aAAa;gBAChB,GAAG,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;gBAC1B,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAC7C;YACD,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,WAAW,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,OAAO,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;SACnC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/engine/sdkruntime.d.ts

@@ -0,0 +1,23 @@
+import { type BudgetReason } from "./budget.js";
+import type { HostSessionSpec, PiHost } from "./pisdk.js";
+import { type Runtime, type SessionSpec } from "./port.js";
+/** What only the route knows about a session, beyond the port's plain data: the
+ * extension factories and tools it carries (P3's factories, the lens tool), the
+ * tool allowlist those tools join, the model's bash environment, the context
+ * files it hands over as data, the thinking level, and text appended to pi's own
+ * system prompt (a leaf's body). Called once per session. A field here wins over
+ * the spec's own. */
+export type SessionExtras = Pick<HostSessionSpec, "extensions" | "customTools" | "tools" | "agentsFiles" | "bashEnv" | "inheritFds" | "thinkingLevel" | "appendSystemPrompt">;
+export interface SdkRuntimeOptions {
+    /** The route's own pieces for a spec. Without it a spec that names
+     * `extensions` (paths) is refused: an SDK session loads factories, not files. */
+    extras?: (spec: SessionSpec) => SessionExtras;
+    /** The last resort of a turn's budget, when its abort and its dispose both
+     * failed to end it (packages/pi-plugin/src/engine/budget.ts). A host that owns its process
+     * passes one that exits it; omitted, the abort and dispose are all a wedged
+     * turn gets, and the process is left to its owner. */
+    backstop?: (reason: BudgetReason) => void;
+}
+/** The runtime that hosts a session in this process, on `host`'s pi SDK. */
+export declare function sdkRuntime(host: PiHost, options?: SdkRuntimeOptions): Runtime;
+//# sourceMappingURL=sdkruntime.d.ts.map

package/dist/src/engine/sdkruntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkruntime.d.ts","sourceRoot":"","sources":["../../../src/engine/sdkruntime.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAIL,KAAK,OAAO,EAGZ,KAAK,WAAW,EAKjB,MAAM,WAAW,CAAC;AAEnB;;;;;qBAKqB;AACrB,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,eAAe,EACb,YAAY,GACZ,aAAa,GACb,OAAO,GACP,aAAa,GACb,SAAS,GACT,YAAY,GACZ,eAAe,GACf,oBAAoB,CACvB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC;qFACiF;IACjF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,aAAa,CAAC;IAC9C;;;0DAGsD;IACtD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAgRD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CA8DjF"}