@quickchatai/pi-quickreview 0.0.0-stage → 1.2.0

package/dist/extensions/ledger-pin.js

@@ -0,0 +1,331 @@
+import { parsePrIdentity as parseOwnPr } from "../src/pr-identity.js";
+// ledger-pin — keeps the review ledger alive across pi's native compaction.
+//
+// The PR session maintains a fenced block that starts with "LEDGER PR #<n> @
+// <sha>" (see prompts/conversation-system.md). Compaction is token-driven and
+// would happily summarise it away, so this extension hooks
+// session_before_compact, finds the most recent ledger block in the entries
+// the hook hands it, and returns a REAL compaction: pi's own
+// default summary, produced by calling the package's exported `compact()`
+// (the function pi would have called itself), with the pinned ledger block
+// appended to it VERBATIM. That summary is what pi puts back in front of the
+// model after compaction, so the ledger survives word for word. Any failure
+// on that path (no model, no auth, the summariser threw, a shape we do not
+// recognise) returns nothing, and pi runs its default compaction unchanged:
+// never a cancelled compaction, never a wedged session. The ledger then still
+// comes back through the daemon, because every round order re-hands the
+// mirrored snapshot (packages/pi-plugin/src/ledgercarry.ts).
+//
+// pi 1.0.0 reads only `cancel` and `compaction` from the handler's result, so
+// returning a whole compaction is the only way to pin anything.
+//
+// It also mirrors the newest ledger block to state/ledgers/<session>.md after
+// every turn — that snapshot is what archiveAndClose() copies into
+// archive/pr-<n>/ (the session JSONL alone would need parsing).
+//
+// Only a block whose PR number equals the session's OWN PR (QCR_PR, riding
+// the pi command line per session) is ever mirrored or pinned. Sessions quote
+// sibling PRs' ledger headers when reading their posted reviews for format
+// reference; without the filter a sibling's ledger would be persisted over
+// the session's own. A session with no / garbage
+// QCR_PR (the overseer) mirrors NO PR ledger, ever — fail safe is no mirror.
+//
+// pi is a dependency of this repo, so the pi API is typechecked against its own
+// declarations; what a live session does with it stays VERIFY-ON-PIN.
+// The compaction contract was read out of pi 1.0.0's shipped dist (the
+// `qcr-bench:fast1` image, docker create + docker cp, no container run); each
+// tag below names the file and symbol it was checked against.
+import { backtickFence } from "../src/codespan.js";
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+// A block runs from its "LEDGER PR #<n>" header to the next fence / blank
+// line + heading / NEXT ledger header / end — the last terminator keeps a
+// quoted sibling header from being swallowed into the preceding block's body.
+const LEDGER_RE = /(^|\n)\s*LEDGER\s+PR\s+#(\d+)[^\n]*\n[\s\S]*?(?=\n```|\n\s*\n\s*#|\n\s*LEDGER\s+PR\s+#|$)/g;
+/** The session's own PR number from QCR_PR — undefined for the overseer (no
+ * QCR_PR) and for anything that is not a plain digit string (fail safe). */
+export { parsePrIdentity as parseOwnPr } from "../src/pr-identity.js";
+/** Deep-walk an unknown payload collecting every string that could be message
+ * text. // VERIFY-ON-PIN: the event payload shape is undocumented, so this is
+ * deliberately shape-agnostic rather than assuming `event.messages`. */
+export function collectText(value, out = [], depth = 0) {
+    if (depth > 8 || value == null)
+        return out;
+    if (typeof value === "string") {
+        out.push(value);
+        return out;
+    }
+    if (Array.isArray(value)) {
+        for (const v of value)
+            collectText(v, out, depth + 1);
+        return out;
+    }
+    if (typeof value === "object") {
+        for (const v of Object.values(value))
+            collectText(v, out, depth + 1);
+    }
+    return out;
+}
+// The format's own example in the system prompt (prompts/conversation-system.md
+// renders `LEDGER PR #<n> @ <head-sha>` with the PR's number filled in) names a
+// placeholder where a ledger names its head. A worker that wrote no ledger in a
+// recheck mirrored that example over #6114's real ledger (2026-10-22).
+const PLACEHOLDER_HEAD_RE = /^\s*LEDGER\s+PR\s+#\d+\s*@\s*</;
+/** A block opened right after a fence of four or more backticks runs to that
+ * fence's close, so a three-backtick quote inside it stays part of the ledger.
+ * undefined when no such fence encloses the header. */
+function wrappedBlock(text, match) {
+    const start = (match.index ?? 0) + (match[1] ?? "").length;
+    const open = /(?:^|\n)(`{4,})[^\n`]*\n\s*$/.exec(text.slice(0, start));
+    if (!open)
+        return undefined;
+    const rest = text.slice(start);
+    const close = new RegExp(`\\n\\s*${open[1]}\`*[ \\t]*(?:\\n|$)`).exec(rest);
+    const end = close ? close.index : rest.length;
+    return rest.slice(0, end);
+}
+/** The last (most recent) LEDGER block for the session's OWN PR, trimmed.
+ * Blocks naming any other PR are ignored (reported via onIgnore) — even when
+ * they appear after the own-PR block. With no own PR (overseer / garbage
+ * QCR_PR) every block is ignored and nothing is returned. A block whose head is
+ * a `<placeholder>` is the format's example, never a ledger, and is skipped. */
+export function extractLedger(texts, ownPr, onIgnore = () => { }) {
+    let found;
+    for (const text of texts) {
+        for (const match of text.matchAll(LEDGER_RE)) {
+            const pr = Number(match[2]);
+            const block = wrappedBlock(text, match) ?? match[0];
+            if (PLACEHOLDER_HEAD_RE.test(block.trim()))
+                continue;
+            if (ownPr !== undefined && pr === ownPr)
+                found = block.trim();
+            else
+                onIgnore(pr);
+        }
+    }
+    return found;
+}
+export function ledgerSnapshotPath(env, session, cwd) {
+    const explicit = env.QCR_LEDGER_FILE?.trim();
+    if (explicit)
+        return explicit;
+    const root = env.QCR_SANDBOX_ROOT?.trim() || cwd;
+    return join(root, "state", "ledgers", `${session}.md`);
+}
+function writeSnapshot(path, body) {
+    mkdirSync(dirname(path), { recursive: true });
+    let previous = "";
+    try {
+        previous = readFileSync(path, "utf8");
+    }
+    catch {
+        /* first snapshot */
+    }
+    if (previous.trim() === body.trim())
+        return;
+    const tmp = `${path}.tmp-${process.pid}-${randomUUID()}`;
+    try {
+        writeFileSync(tmp, `${body}\n`);
+        renameSync(tmp, path);
+    }
+    finally {
+        rmSync(tmp, { force: true });
+    }
+}
+/** Sentinels around the pinned block, so the next compaction can strip the
+ * previous copy out of `previousSummary` before pi's summariser sees it (it
+ * would otherwise paraphrase a stale ledger into the new summary). */
+export const PIN_OPEN = "<!-- qcr:ledger-pin -->";
+export const PIN_CLOSE = "<!-- /qcr:ledger-pin -->";
+/** A fence longer than any backtick run in `body`, so a ledger that quotes
+ * code can never close its own fence early. */
+export const fenceFor = backtickFence;
+/** The block appended to the compaction summary: PR meta + the ledger,
+ * verbatim, between the sentinels. */
+export function pinnedBlock(meta, ledger) {
+    const fence = fenceFor(ledger);
+    return [
+        PIN_OPEN,
+        "PINNED LEDGER — your review ledger exactly as you last wrote it, appended",
+        "verbatim to this compaction summary by the ledger-pin extension. It is the",
+        "checklist the next round starts from; the summary above is a paraphrase.",
+        ...(meta ? ["", meta] : []),
+        "",
+        fence,
+        ledger,
+        fence,
+        PIN_CLOSE,
+    ].join("\n");
+}
+/** `summary` with every pinned block (sentinels inclusive) removed. */
+export function stripPinned(summary) {
+    let out = summary;
+    for (;;) {
+        const open = out.indexOf(PIN_OPEN);
+        if (open < 0)
+            return out.trimEnd();
+        const close = out.indexOf(PIN_CLOSE, open);
+        if (close < 0)
+            return out.slice(0, open).trimEnd();
+        out = out.slice(0, open).trimEnd() + out.slice(close + PIN_CLOSE.length);
+    }
+}
+/** Load `compact` from the installed (= pinned) pi package, resolved inside
+ * the pi process, so it lands on the running instance
+ * (tests/pi-resolution.test.ts). VERIFY-ON-PIN: pi 1.0.0 `dist/index.js` exports `compact`
+ * (re-exported from `dist/core/compaction/index.js`). Undefined when the
+ * import fails or the export is missing. */
+export async function loadPiCompact() {
+    try {
+        const pkg = (await import("@earendil-works/pi-coding-agent"));
+        return typeof pkg.compact === "function" ? pkg.compact : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isPreparation(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const p = value;
+    return typeof p.firstKeptEntryId === "string" && typeof p.tokensBefore === "number";
+}
+/**
+ * The pinned compaction: pi's own default summary with the pinned block
+ * appended. It mirrors pi 1.0.0's `AgentSession._runDefaultCompaction`
+ * (dist/core/agent-session.js): resolve request auth for the session model,
+ * then `compact(preparation, model, apiKey, headers, customInstructions,
+ * signal, thinkingLevel, streamFn, env)`. The stream function is the model
+ * registry's `streamSimple`, which is what pi's own agent streamFn delegates
+ * to (dist/core/sdk.js, `modelRuntime.streamSimple`; ModelRegistry.streamSimple
+ * is that same runtime call). Returns undefined on ANY failure, so pi falls
+ * back to its default compaction rather than cancelling one.
+ * VERIFY-ON-PIN, whole function: every name here is from pi 1.0.0's dist and
+ * has not yet run in a live session.
+ */
+export async function pinnedCompaction(event, ctx, pinned, compactFn, log = () => { }) {
+    const fail = (why) => {
+        log(`[ledger-pin] pinned compaction unavailable (${why}); pi runs its default compaction and the ledger returns with the next round order`);
+        return undefined;
+    };
+    if (!compactFn)
+        return fail("pi's compact() is not exported by the installed package");
+    const preparation = event.preparation;
+    if (!isPreparation(preparation))
+        return fail("event.preparation has no firstKeptEntryId/tokensBefore");
+    const registry = ctx?.modelRegistry;
+    const model = ctx?.model;
+    if (!registry || typeof registry.getApiKeyAndHeaders !== "function")
+        return fail("no model registry");
+    if (!model || typeof model !== "object")
+        return fail("no session model");
+    try {
+        const auth = await registry.getApiKeyAndHeaders(model);
+        if (!auth.ok)
+            return fail(`auth: ${auth.error}`);
+        const requestModel = auth.baseUrl ? { ...model, baseUrl: auth.baseUrl } : model;
+        const forSummary = typeof preparation.previousSummary === "string"
+            ? { ...preparation, previousSummary: stripPinned(preparation.previousSummary) }
+            : preparation;
+        const custom = typeof event.customInstructions === "string" ? event.customInstructions : undefined;
+        const signal = event.signal instanceof AbortSignal ? event.signal : undefined;
+        const result = await compactFn(forSummary, requestModel, auth.apiKey, 
+        // ProviderHeaders allows null values (a header to drop); compact() types
+        // them as strings, and pi hands its own summariser the same object.
+        auth.headers, custom, signal, ctx?.thinkingLevel, (m, c, o) => registry.streamSimple(m, c, o), auth.env);
+        if (!result ||
+            typeof result.summary !== "string" ||
+            typeof result.firstKeptEntryId !== "string" ||
+            typeof result.tokensBefore !== "number")
+            return fail("compact() returned no usable result");
+        return {
+            compaction: {
+                ...result,
+                summary: `${stripPinned(result.summary)}\n\n${pinned}`,
+            },
+        };
+    }
+    catch (err) {
+        return fail(`summariser threw: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** The custom entry type ledger-pin writes into the session file. */
+export const LEDGER_ENTRY_TYPE = "qcr-review-ledger";
+/** The config the env describes (QCR_SESSION_NAME, QCR_PR_META, QCR_PR, and
+ * the snapshot path from ledgerSnapshotPath, `cwd` standing in for an absent
+ * sandbox root). */
+export function ledgerPinConfigFromEnv(env, cwd, deps = {}) {
+    const session = env.QCR_SESSION_NAME?.trim() || "session";
+    return {
+        prMeta: env.QCR_PR_META?.trim() ?? "",
+        ownPr: parseOwnPr(env.QCR_PR),
+        snapshotPath: ledgerSnapshotPath(env, session, cwd),
+        ...deps,
+    };
+}
+/** The factory an SDK session loads. Its env shim is extensions/cli/ledger-pin.ts. */
+export function createLedgerPin(config) {
+    return (pi) => {
+        registerLedgerPin(pi, config);
+    };
+}
+function registerLedgerPin(pi, config) {
+    const loadCompact = config.loadCompact ?? loadPiCompact;
+    const log = config.log ?? (() => { });
+    const { prMeta: meta, ownPr, snapshotPath } = config;
+    let lastLedger = "";
+    let persistedLedger = "";
+    const capture = (source) => {
+        const onIgnore = (pr) => {
+            const who = ownPr === undefined ? "session has no QCR_PR" : `own PR is #${ownPr}`;
+            log(`[ledger-pin] debug: ignoring LEDGER PR #${pr} (${who})`);
+        };
+        const ledger = extractLedger(collectText(source), ownPr, onIgnore) ?? lastLedger;
+        if (ledger)
+            lastLedger = ledger;
+        if (ledger && ledger !== persistedLedger) {
+            try {
+                writeSnapshot(snapshotPath, ledger);
+                persistedLedger = ledger;
+            }
+            catch (err) {
+                log(`[ledger-pin] snapshot write failed: ${String(err)}`);
+            }
+        }
+        return ledger;
+    };
+    // VERIFY-ON-PIN: "turn_end". pi 1.0.0 `TurnEndEvent` (dist/core/extensions/
+    // types.d.ts) carries the turn's `message` and `toolResults`; the walk stays
+    // shape-agnostic.
+    pi.on("turn_end", (event) => {
+        capture(event);
+    });
+    // VERIFY-ON-PIN: pi 1.0.0 `SessionBeforeCompactEvent` (dist/core/extensions/
+    // types.d.ts) is { preparation, branchEntries, customInstructions?, reason,
+    // willRetry, signal }. The handler gets (event, ctx: ExtensionContext) and
+    // may return `SessionBeforeCompactResult` = { cancel?, compaction? }, the
+    // only two keys `dist/core/agent-session.js` reads (both `compact()` and
+    // `_runAutoCompaction()`). The ledger is looked for in `branchEntries`
+    // (oldest first, so the newest own block wins), falling back to the whole
+    // event if that field is ever missing.
+    pi.on("session_before_compact", async (event, ctx) => {
+        const ledger = capture(Array.isArray(event.branchEntries) ? event.branchEntries : event);
+        if (!ledger)
+            return;
+        // Persist it into the session file too, so archival never depends on the
+        // summariser. VERIFY-ON-PIN: pi 1.0.0 `ExtensionAPI.appendEntry<T>(
+        // customType: string, data?: T): void` (dist/core/extensions/types.d.ts),
+        // implemented in dist/core/agent-session.js as
+        // `sessionManager.appendCustomEntry(customType, data)`: a `custom` entry,
+        // never sent to the model.
+        try {
+            pi.appendEntry?.(LEDGER_ENTRY_TYPE, { pr: ownPr, ledger, meta });
+        }
+        catch (err) {
+            log(`[ledger-pin] appendEntry failed: ${String(err)}`);
+        }
+        return pinnedCompaction(event, ctx, pinnedBlock(meta, ledger), await loadCompact(), log);
+    });
+}
+//# sourceMappingURL=ledger-pin.js.map

package/dist/extensions/ledger-pin.js.map

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

package/dist/extensions/lens.d.ts

@@ -0,0 +1,43 @@
+import type { ExtensionFactory, ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { type AgentRegistry } from "../src/engine/lens/registry.js";
+import { type LensRunConfig } from "../src/engine/lens/runlens.js";
+import { LENS_TOOL, LENS_WAVE_TOOL, type LensToolDeps } from "../src/engine/lens/tool.js";
+import { LensWave } from "../src/engine/lens/wave.js";
+import { PiHost } from "../src/engine/pisdk.js";
+export { LENS_TOOL, LENS_WAVE_TOOL };
+/** The two tools as pi ToolDefinitions, over `deps`. */
+export declare function lensTools(deps: LensToolDeps): ToolDefinition[];
+/** The factory that registers `lens` and `lens_wave` on a pi. */
+export declare function createLens(deps: LensToolDeps): ExtensionFactory;
+/** The runner of an interactive pi, from its environment. Exported so the shim's
+ * wiring can be tested with a host of its own, and so an engine route (the bench)
+ * can build its round's runner the same way over agents it keeps elsewhere
+ * (`registry`; omitted: the agent dir's own `agents`). */
+export declare function lensRunConfigFromEnv(env: Readonly<Record<string, string | undefined>>, host: PiHost, cwd: string, registry?: AgentRegistry): LensRunConfig;
+/** The interactive pi's lens tools and the board and runner behind them. */
+export interface InteractiveLens {
+    /** Registers `lens` and `lens_wave` on a pi. */
+    factory: ExtensionFactory;
+    /** The runner a pass starts on (builds the host on its first pass). */
+    runner: LensToolDeps["runner"];
+    /** The rows in flight: what `lens_wave` joins. A round's wave starts on it. */
+    wave: LensWave;
+}
+/** The interactive pi's lens tools over `makeHost`, which builds the PiHost on
+ * the first pass. Exported so a test can hand it a host of its own, and so the
+ * debug round (extensions/debug-round.ts) can start its planned wave on the very
+ * board and runner the session's `lens_wave` reads. */
+export declare function interactiveLensBoard(env: Readonly<Record<string, string | undefined>>, cwd: () => string, makeHost: (agentDir: string) => Promise<PiHost>, 
+/** Final say on the runner's config (the debug round adds the reviewer stub,
+ * the bash env allowlist and the context pack). */
+adjust?: (config: LensRunConfig) => LensRunConfig): InteractiveLens;
+export declare function interactiveLens(env: Readonly<Record<string, string | undefined>>, cwd: () => string, makeHost: (agentDir: string) => Promise<PiHost>, 
+/** Where the runner's warnings go (`[lens] …`), one line each: the host's.
+ * Omitted: nowhere. */
+warn?: (line: string) => void): ExtensionFactory;
+/** A runner config adjustment that sends its warnings to `warn`, prefixed. */
+export declare function lensWarnTo(warn: ((line: string) => void) | undefined): (config: LensRunConfig) => LensRunConfig;
+/** The host an interactive pi's lens passes run on, from its env. `homeDir` is
+ * the user's home the host resolved (the tool fence keeps its `.pi` out). */
+export declare function interactiveHostFor(env: Readonly<Record<string, string | undefined>>, homeDir?: string): (agentDir: string) => Promise<PiHost>;
+//# sourceMappingURL=lens.d.ts.map

package/dist/extensions/lens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens.d.ts","sourceRoot":"","sources":["../../extensions/lens.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAEV,gBAAgB,EAChB,cAAc,EACf,MAAM,iCAAiC,CAAC;AAKzC,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,SAAS,EACT,cAAc,EAEd,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAShD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AAErC,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,EAAE,CAE9D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAI/D;AAcD;;;0DAG0D;AAC1D,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,aAAa,GACvB,aAAa,CAqBf;AA6CD,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,OAAO,EAAE,gBAAgB,CAAC;IAC1B,uEAAuE;IACvE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;uDAGuD;AACvD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,GAAG,EAAE,MAAM,MAAM,EACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;AAC/C;mDACmD;AACnD,MAAM,GAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAwB,GAC1D,eAAe,CAIjB;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,GAAG,EAAE,MAAM,MAAM,EACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;AAC/C;uBACuB;AACvB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,gBAAgB,CAElB;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GACzC,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAE1C;AAED;6EAC6E;AAC7E,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,OAAO,CAAC,EAAE,MAAM,GACf,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAEvC"}

package/dist/extensions/lens.js

@@ -0,0 +1,150 @@
+// lens — our lens tools (`lens`, `lens_wave`) as a pi extension, the interactive
+// pi's way to run lenses in-process on the SDK.
+//
+// The tools themselves are packages/pi-plugin/src/engine/lens/tool.ts; this file gives them to pi,
+// in the two shapes the hosts want:
+//
+//   lensTools(deps)    the two ToolDefinitions, for an SDK main session's
+//                      `customTools` (the engine routes hand them over data,
+//                      packages/pi-plugin/src/engine/lens/engine-tools.ts)
+//   createLens(deps)   the factory that registers them on a pi
+//   extensions/cli/lens.ts  the env shim for an interactive pi (a debug round, the
+//                      companion): it builds the lens runner on first use
+//
+// The tmux bot does NOT load this file. pi's native `subagent` and the glue's
+// `launch_plan` (extensions/subagents.ts) are retired. A lens session is
+// never given either of these tools (the runner refuses an agent file that
+// lists one, include.ts strips them at build time), so a pass cannot fan out.
+// They ride the session's own extension list, never the global settings.json.
+//
+// The shim's lens sessions are SDK sessions of this pi process. It builds a
+// PiHost over the pi's own agent dir (`PI_CODING_AGENT_DIR`) with a read-only
+// copy of its login, and leaves the HTTP dispatcher to the CLI pi
+// (`ownsProcess` false). The host is built when the first lens is asked for, so
+// a missing login fails that call, never the pi's start-up. This is the one
+// extension that may reach packages/pi-plugin/src/engine/pisdk.ts (tests/helpers/engine-fences.ts).
+//
+// VERIFY-ON-PIN: defineTool's and registerTool's definition shape, as in
+// finding-clusters.ts.
+import { dirname, isAbsolute, join } from "node:path";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { agentDirSettings } from "../src/engine/agentdir.js";
+import { applyEnvApiKeys, engineCredentials } from "../src/engine/auth.js";
+import { LENS_LEDGER_FILE, LENS_SESSIONS_DIR } from "../src/engine/openable.js";
+import { resolvePassDeadlineMs } from "../src/engine/lens/deadline.js";
+import { loadBuiltAgents } from "../src/engine/lens/registry.js";
+import { createLensRunner, } from "../src/engine/lens/runlens.js";
+import { LENS_TOOL, LENS_WAVE_TOOL, lensToolDefinitions, } from "../src/engine/lens/tool.js";
+import { LensWave } from "../src/engine/lens/wave.js";
+import { PiHost } from "../src/engine/pisdk.js";
+import { bashGuardConfigFromEnv, createBashGuard } from "./bash-guard.js";
+import { toPiTool } from "./pi-tool.js";
+import { resolveCacheGroup, resolveCacheStagger, resolveMaxConcurrency, } from "../src/engine/lens/env.js";
+export { LENS_TOOL, LENS_WAVE_TOOL };
+/** The two tools as pi ToolDefinitions, over `deps`. */
+export function lensTools(deps) {
+    return lensToolDefinitions(deps).map((t) => defineTool(toPiTool(t)));
+}
+/** The factory that registers `lens` and `lens_wave` on a pi. */
+export function createLens(deps) {
+    return (pi) => {
+        for (const tool of lensTools(deps))
+            pi.registerTool(tool);
+    };
+}
+/** How long a lens session has before its login must not expire: the
+ * longest a round runs. */
+const LOGIN_WINDOW_MS = 90 * 60_000;
+/** The agent dir an interactive pi runs over; anything but an absolute path is refused. */
+function requireAgentDir(env) {
+    const agentDir = env["PI_CODING_AGENT_DIR"];
+    if (agentDir === undefined || !isAbsolute(agentDir))
+        throw new Error(`lens: PI_CODING_AGENT_DIR is not an absolute path (${String(agentDir)})`);
+    return agentDir;
+}
+/** The runner of an interactive pi, from its environment. Exported so the shim's
+ * wiring can be tested with a host of its own, and so an engine route (the bench)
+ * can build its round's runner the same way over agents it keeps elsewhere
+ * (`registry`; omitted: the agent dir's own `agents`). */
+export function lensRunConfigFromEnv(env, host, cwd, registry) {
+    const agentDir = requireAgentDir(env);
+    const ledger = env["QCR_LEDGER_FILE"];
+    const group = resolveCacheGroup({ ...env });
+    const deadlineMs = resolvePassDeadlineMs({ ...env });
+    return {
+        host,
+        permits: resolveMaxConcurrency({ ...env }),
+        registry: registry ?? loadBuiltAgents(join(agentDir, "agents")),
+        cwd,
+        env,
+        bashGuard: createBashGuard(bashGuardConfigFromEnv(env, cwd)),
+        ledgerPath: join(ledger ? dirname(ledger) : agentDir, LENS_LEDGER_FILE),
+        // A round's lens sessions are kept beside its ledger; an interactive pi
+        // with no round keeps none, and never writes into its own agent dir.
+        ...(ledger ? { sessionsDir: join(dirname(ledger), LENS_SESSIONS_DIR) } : {}),
+        ...(deadlineMs !== undefined ? { deadlineMs } : {}),
+        // The round's context pack belongs to a wave the engine launches; an
+        // interactive pi's groups are warmed by the stagger.
+        ...(group > 0 ? { cache: { size: group, staggerMs: resolveCacheStagger({ ...env }) } } : {}),
+    };
+}
+/** The shim's runner: the host and the runner are built by the first pass. */
+function lazyRunner(env, cwd, makeHost, adjust) {
+    let built;
+    const ensure = () => {
+        built ??= (async () => {
+            const agentDir = requireAgentDir(env);
+            const host = await makeHost(agentDir);
+            return createLensRunner(adjust(lensRunConfigFromEnv(env, host, cwd())));
+        })();
+        // A host that failed to build is not kept: the next ask tries again.
+        built.catch(() => {
+            built = undefined;
+        });
+        return built;
+    };
+    return { run: async (request) => (await ensure()).run(request) };
+}
+/** A PiHost over the interactive pi's own agent dir: a read-only copy of its
+ * login, pi's dispatcher left alone. */
+async function interactiveHost(agentDir, env, homeDir) {
+    const auth = engineCredentials({ srcDir: agentDir, needMs: LOGIN_WINDOW_MS });
+    return PiHost.create({
+        agentDir,
+        ownsProcess: false,
+        ...(homeDir !== undefined ? { homeDir } : {}),
+        credentials: auth.credentials,
+        settings: agentDirSettings(agentDir),
+        configureModels: async (runtime) => {
+            await applyEnvApiKeys(runtime, env);
+        },
+    });
+}
+/** The interactive pi's lens tools over `makeHost`, which builds the PiHost on
+ * the first pass. Exported so a test can hand it a host of its own, and so the
+ * debug round (extensions/debug-round.ts) can start its planned wave on the very
+ * board and runner the session's `lens_wave` reads. */
+export function interactiveLensBoard(env, cwd, makeHost, 
+/** Final say on the runner's config (the debug round adds the reviewer stub,
+ * the bash env allowlist and the context pack). */
+adjust = (c) => c) {
+    const runner = lazyRunner(env, cwd, makeHost, adjust);
+    const wave = new LensWave();
+    return { factory: createLens({ runner, wave, env, cwd }), runner, wave };
+}
+export function interactiveLens(env, cwd, makeHost, 
+/** Where the runner's warnings go (`[lens] …`), one line each: the host's.
+ * Omitted: nowhere. */
+warn) {
+    return interactiveLensBoard(env, cwd, makeHost, lensWarnTo(warn)).factory;
+}
+/** A runner config adjustment that sends its warnings to `warn`, prefixed. */
+export function lensWarnTo(warn) {
+    return (c) => (warn ? { ...c, warn: (m) => warn(`[lens] ${m}`) } : c);
+}
+/** The host an interactive pi's lens passes run on, from its env. `homeDir` is
+ * the user's home the host resolved (the tool fence keeps its `.pi` out). */
+export function interactiveHostFor(env, homeDir) {
+    return (dir) => interactiveHost(dir, env, homeDir);
+}
+//# sourceMappingURL=lens.js.map

package/dist/extensions/lens.js.map

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

package/dist/extensions/pi-tool.d.ts

@@ -0,0 +1,22 @@
+import type { AgentToolResult, ExtensionAPI, ExtensionToolContext, ToolDefinition } from "@earendil-works/pi-coding-agent";
+/** What a tool hands back to the model: text only, which is all ours emit. */
+export type QcrToolResult = Omit<AgentToolResult<Record<string, unknown> | undefined>, "content"> & {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export type QcrTool = Omit<ToolDefinition, "execute"> & {
+    execute(id: string, params: Record<string, unknown>, signal?: AbortSignal, onUpdate?: unknown, ctx?: ExtensionToolContext): QcrToolResult | Promise<QcrToolResult>;
+};
+/** A text-only tool result; `details` rides along only when given. */
+export declare function textResult(text: string, details?: Record<string, unknown>): QcrToolResult;
+/** A refused setup call as the tool result: what was asked, then one line per error. */
+export declare function refusedResult(what: string, r: {
+    errors: readonly string[];
+}): QcrToolResult;
+/** `tool` as pi's contract has it: a synchronous `execute` awaited into the
+ * Promise pi asks for. */
+export declare function toPiTool(tool: QcrTool): ToolDefinition;
+export declare function registerQcrTool(pi: ExtensionAPI, tool: QcrTool): void;
+//# sourceMappingURL=pi-tool.d.ts.map

package/dist/extensions/pi-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-tool.d.ts","sourceRoot":"","sources":["../../extensions/pi-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACf,MAAM,iCAAiC,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,EACpD,SAAS,CACV,GAAG;IACF,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;IACtD,OAAO,CACL,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,OAAO,EAClB,GAAG,CAAC,EAAE,oBAAoB,GACzB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3C,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAEzF;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,aAAa,CAE3F;AAED;0BAC0B;AAC1B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAMtD;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAErE"}

package/dist/extensions/pi-tool.js

@@ -0,0 +1,20 @@
+/** A text-only tool result; `details` rides along only when given. */
+export function textResult(text, details) {
+    return { content: [{ type: "text", text }], details };
+}
+/** A refused setup call as the tool result: what was asked, then one line per error. */
+export function refusedResult(what, r) {
+    return textResult(`${what} refused:\n${r.errors.map((e) => `✗ ${e}`).join("\n")}`);
+}
+/** `tool` as pi's contract has it: a synchronous `execute` awaited into the
+ * Promise pi asks for. */
+export function toPiTool(tool) {
+    return {
+        ...tool,
+        execute: async (id, params, signal, onUpdate, ctx) => tool.execute(id, params, signal, onUpdate, ctx),
+    };
+}
+export function registerQcrTool(pi, tool) {
+    pi.registerTool(toPiTool(tool));
+}
+//# sourceMappingURL=pi-tool.js.map

package/dist/extensions/pi-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-tool.js","sourceRoot":"","sources":["../../extensions/pi-tool.ts"],"names":[],"mappings":"AA8BA,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAiC;IACxE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACxD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,CAAgC;IAC1E,OAAO,UAAU,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;0BAC0B;AAC1B,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CACnD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,MAAiC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAgB,EAAE,IAAa;IAC7D,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/extensions/quickreview.d.ts

@@ -0,0 +1,21 @@
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { Runner } from "../src/plugin/session.js";
+/** What the host entry hands the plugin. */
+export interface QuickReviewConfig {
+    /** The process environment, read once by the host entry. */
+    env: NodeJS.ProcessEnv;
+    /** The user's home. */
+    home: string;
+    runner: Runner;
+    /** Standard output (pi's print mode shows a command's result there). */
+    print: (text: string) => void;
+    /** Test seams: the running pi's version, its agent dir, the range. */
+    piVersion?: string;
+    agentDir?: string;
+    range?: string;
+}
+/** The commands, in the order /qcr-setup names them. */
+export declare const QUICKREVIEW_COMMANDS: readonly ["review", "scan", "qcr-setup", "selfimprove"];
+/** The plugin's extension factory over `config`. */
+export declare function createQuickReview(config: QuickReviewConfig): (pi: ExtensionAPI) => void;
+//# sourceMappingURL=quickreview.d.ts.map

package/dist/extensions/quickreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickreview.d.ts","sourceRoot":"","sources":["../../extensions/quickreview.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EAAc,MAAM,EAAa,MAAM,0BAA0B,CAAC;AAI9E,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,yDAA0D,CAAC;AAoE5F,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAuEvF"}