@quickchatai/quickreview 0.0.0-stage → 1.1.0

package/dist/src/livecli.js

@@ -0,0 +1,288 @@
+// `qcr live [RUN_ID | DIR] [--lens ID] [--round N] [--follow] [--json]` - read a
+// review's LiveEvent log (src/live/) as a transcript: what the main session
+// said and did, tool by tool, and with `--lens` one lens session's.
+//
+// RUN_ID is a detached run (`qcr review start`), DIR a run directory or a round
+// directory (`.../state/live/<key>/r<n>`); with neither, the newest run. With
+// `--follow` it keeps reading what is appended until the session settles or the
+// run is over. The log is read by byte offset, so a follow never re-reads, and
+// a line a writer is still finishing is left for the next poll.
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { LIVE_MAIN_FILE, lensLogName, readLiveEvents, } from "@quickchatai/pi-quickreview/src/live/events.js";
+import { latestLiveRound, lensLogIds, listLiveRounds } from "./live/read.js";
+export const LIVE_USAGE = "usage: qcr live [RUN_ID | DIR] [--lens ID] [--round N] [--follow] [--json]";
+const POLL_MS = 500;
+const clock = (at) => at.slice(11, 19);
+const oneLine = (s, max = 160) => {
+    const flat = s.replace(/\s+/g, " ").trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+};
+export function newRenderState() {
+    return { streamed: false };
+}
+/** One event as transcript lines. */
+export function renderLiveEvent(e, state) {
+    const t = clock(e.at);
+    switch (e.type) {
+        case "session_start":
+            return [
+                e.stream === "lens"
+                    ? `${t}  lens ${e.agent ?? ""} ${e.lens_id ?? ""} (${e.session}, round ${e.round})`.replace(/\s+/g, " ")
+                    : `${t}  session ${e.session} (${e.key}, round ${e.round})`,
+            ];
+        case "agent_start":
+            return [`${t}  agent started`];
+        case "agent_end":
+            return e.will_retry ? [`${t}  agent turn ended, retrying`] : [];
+        case "agent_settled":
+            return [`${t}  agent settled${e.aborted ? " (aborted)" : ""}`];
+        case "message_start":
+            state.streamed = false;
+            return e.role === "user" && e.text ? [`${t}  > ${oneLine(e.text)}`] : [];
+        case "message_delta":
+            state.streamed = state.streamed || Boolean(e.text);
+            return e.text ? e.text.split("\n").map((l) => `    ${l}`) : [];
+        case "message_end": {
+            const lines = [];
+            if (!state.streamed && e.text)
+                lines.push(...e.text.split("\n").map((l) => `    ${l}`));
+            const bits = [
+                e.tool_calls?.length ? `calls ${e.tool_calls.join(", ")}` : "",
+                e.stop_reason ?? "",
+                e.usage ? `$${e.usage.cost_usd.toFixed(4)}` : "",
+                e.error ? `error: ${oneLine(e.error, 100)}` : "",
+            ].filter(Boolean);
+            if (bits.length > 0)
+                lines.push(`${t}  assistant ${bits.join(" · ")}`);
+            state.streamed = false;
+            return lines;
+        }
+        case "tool_start": {
+            const what = e.executions?.length
+                ? e.executions.map((x) => x.agent).join(", ")
+                : (e.preview ?? "");
+            return [`${t}  ${e.parent ? "  " : ""}tool ${e.tool}${what ? ` ${what}` : ""}`];
+        }
+        case "tool_update":
+            return e.results.map((r) => `${t}    ${r.agent ?? `child ${r.slot}`} ${r.progress?.status ?? "…"}` +
+                ((r.progress?.tool_count ?? r.native?.tool_count)
+                    ? ` (${r.progress?.tool_count ?? r.native?.tool_count} tools)`
+                    : "") +
+                ((r.progress?.last_message ?? r.native?.last_text)
+                    ? ` ${oneLine((r.progress?.last_message ?? r.native?.last_text), 80)}`
+                    : ""));
+        case "tool_end": {
+            const bits = [
+                e.is_error ? "failed" : "done",
+                e.duration_ms !== undefined ? `${(e.duration_ms / 1000).toFixed(1)}s` : "",
+                e.cost_usd !== undefined ? `$${e.cost_usd.toFixed(4)}` : "",
+            ].filter(Boolean);
+            return [`${t}  ${e.parent ? "  " : ""}tool ${e.tool} ${bits.join(" · ")}`];
+        }
+        case "queue_update":
+            return e.steering.length + e.follow_up.length > 0
+                ? [`${t}  queued: ${e.steering.length} steer, ${e.follow_up.length} follow-up`]
+                : [];
+        case "compaction_start":
+            return [`${t}  compacting (${e.reason})`];
+        case "compaction_end":
+            return [`${t}  compaction ${e.aborted ? "aborted" : "done"}${e.error ? `: ${e.error}` : ""}`];
+        case "retry":
+            return [
+                e.phase === "start"
+                    ? `${t}  retry ${e.attempt}${e.error ? `: ${oneLine(e.error, 100)}` : ""}`
+                    : `${t}  retry ${e.success ? "succeeded" : "gave up"}`,
+            ];
+        default:
+            return [];
+    }
+}
+// ---- finding the log --------------------------------------------------------------
+function isDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** The run roots under a detached run directory: `work/<run>/`. */
+function runRoots(runDir) {
+    const work = join(runDir, "work");
+    try {
+        return readdirSync(work)
+            .map((d) => join(work, d))
+            .filter(isDir);
+    }
+    catch {
+        return [];
+    }
+}
+function newestRun(home) {
+    const runs = join(home, "runs");
+    try {
+        return readdirSync(runs)
+            .filter((d) => existsSync(join(runs, d, "run.json")))
+            .sort()
+            .at(-1);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveTarget(arg, round, deps) {
+    let roots;
+    let runDir;
+    let pid = null;
+    let container;
+    const id = arg ?? newestRun(deps.home);
+    const run = id !== undefined && /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(id)
+        ? readJson(join(deps.home, "runs", id, "run.json"))
+        : null;
+    if (run !== null && id !== undefined) {
+        runDir = join(deps.home, "runs", id);
+        pid = run.pid;
+        container = run.container;
+        roots = runRoots(runDir);
+    }
+    else if (arg !== undefined && existsSync(join(arg, LIVE_MAIN_FILE))) {
+        // a round directory: .../state/live/<key>/r<n>
+        const m = /^(.*)[/\\]([^/\\]+)[/\\]r(\d+)$/.exec(resolve(arg));
+        if (!m)
+            return `${arg} is not a round log directory (state/live/<key>/r<n>)`;
+        if (round !== undefined && round !== Number(m[3]))
+            return `${arg} is round ${m[3]}, not round ${round}`;
+        return { ref: { dir: resolve(arg), key: m[2], round: Number(m[3]) }, pid };
+    }
+    else if (arg !== undefined && isDir(arg)) {
+        roots = [resolve(arg)];
+    }
+    else {
+        return arg === undefined ? "no review run to read" : `no review run ${arg}`;
+    }
+    const pick = round !== undefined
+        ? roots
+            .flatMap((r) => listLiveRounds(r))
+            .filter((r) => r.round === round)
+            .at(-1)
+        : roots
+            .map((r) => latestLiveRound(r))
+            .filter((r) => r !== undefined)
+            .at(-1);
+    if (pick === undefined)
+        return round !== undefined
+            ? `no round ${round} log yet`
+            : "no live log yet: the review has not started its session";
+    return {
+        ref: pick,
+        ...(runDir !== undefined ? { runDir } : {}),
+        pid,
+        ...(container !== undefined ? { container } : {}),
+    };
+}
+// ---- the verb -----------------------------------------------------------------------
+/** Run `qcr live`; resolves its exit code (0 read, 1 nothing to read, 2 usage). */
+export async function runLive(rest, json, deps) {
+    let arg;
+    let lens;
+    let round;
+    let follow = false;
+    // a usage error found before a later --json is still reported as JSON
+    const wantsJson = json || rest.includes("--json");
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === "--follow" || a === "-f")
+            follow = true;
+        else if (a === "--json")
+            json = true;
+        else if (a === "--lens") {
+            lens = rest[++i];
+            if (lens === undefined)
+                return usage(deps, "--lens needs a lens id", wantsJson);
+        }
+        else if (a === "--round") {
+            const n = Number(rest[++i]);
+            if (!Number.isInteger(n) || n < 1)
+                return usage(deps, "--round needs a round number", wantsJson);
+            round = n;
+        }
+        else if (!a.startsWith("-") && arg === undefined)
+            arg = a;
+        else
+            return usage(deps, `unknown argument ${a}`, wantsJson);
+    }
+    if (lens === "" || (lens !== undefined && !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(lens)))
+        return usage(deps, "--lens needs a lens id", wantsJson);
+    const target = resolveTarget(arg, round, deps);
+    if (typeof target === "string") {
+        deps.out(json ? JSON.stringify({ ok: false, errors: [target] }) : `✗ ${target}`);
+        return 1;
+    }
+    const file = join(target.ref.dir, lens !== undefined ? lensLogName(lens) : LIVE_MAIN_FILE);
+    if (lens !== undefined && !existsSync(file)) {
+        const known = lensLogIds(target.ref.dir);
+        deps.out(json
+            ? JSON.stringify({ ok: false, errors: [`no lens log ${lens}`], lenses: known })
+            : `✗ no lens log ${lens}; this round has: ${known.join(", ") || "none"}`);
+        return 1;
+    }
+    const state = newRenderState();
+    let offset = 0;
+    let announced = false;
+    for (;;) {
+        const read = readLiveEvents(file, offset);
+        offset = read.nextOffset;
+        for (const e of read.events) {
+            if (json)
+                deps.out(JSON.stringify(e));
+            else
+                for (const line of renderLiveEvent(e, state))
+                    deps.out(line);
+        }
+        if (!announced && !json) {
+            announced = true;
+            const lenses = lensLogIds(target.ref.dir);
+            if (lens === undefined && lenses.length > 0)
+                deps.out(`(lens logs: ${lenses.join(", ")}; read one with --lens ID)`);
+        }
+        const settled = read.events.some((e) => e.type === "agent_settled");
+        if (!follow || (settled && lens === undefined))
+            return 0;
+        if (lens !== undefined && settled)
+            return 0;
+        // A run that ended, or whose driver died, writes nothing more.
+        if (target.runDir !== undefined && ended(target.runDir, target, deps)) {
+            const last = readLiveEvents(file, offset);
+            if (last.events.length === 0)
+                return 0;
+            continue;
+        }
+        await deps.sleep(POLL_MS);
+    }
+}
+function ended(runDir, run, deps) {
+    if (existsSync(join(runDir, "exit.json")) || existsSync(join(runDir, "stopped.json")))
+        return true;
+    // a container run's liveness is the wrapper's list of the containers that are up
+    if (run.container !== undefined) {
+        const live = deps.liveContainers?.() ?? null;
+        return live !== null && !live.has(run.container);
+    }
+    return run.pid !== null && !deps.alive(run.pid);
+}
+function usage(deps, why, json) {
+    deps.out(json
+        ? JSON.stringify({ ok: false, errors: [why], usage: LIVE_USAGE })
+        : `${LIVE_USAGE}\n(${why})`);
+    return 2;
+}
+//# sourceMappingURL=livecli.js.map

package/dist/src/livecli.js.map

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

package/dist/src/loginhint.js

@@ -0,0 +1,42 @@
+// Before `qcr review` spends anything: does pi hold a credential for every
+// provider the review's models run on? A login in pi's agent dir counts, and
+// so does the provider's own API key in the environment. An API key for some
+// OTHER provider never does: the review runs on the models its config names,
+// or not at all, and it never switches models to use a key. The refusal names
+// `qcr login`, the way to get the login.
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { loginSummary, RUNTIME_KEY_ENVS, } from "@quickchatai/pi-quickreview/src/engine/auth.js";
+/** pi's stored logins in `agentDir`; empty when it holds none. */
+export function readLogins(agentDir, read = (p) => readFileSync(p, "utf8")) {
+    try {
+        return loginSummary(read(join(agentDir, "auth.json")));
+    }
+    catch {
+        return {};
+    }
+}
+/** Why the review cannot run on this machine's credentials, or null when
+ * every provider it needs has one. */
+export function reviewLoginRefusal(o) {
+    const logins = o.logins ?? readLogins(o.agentDir);
+    const keyOf = (p) => {
+        const name = RUNTIME_KEY_ENVS[p];
+        return name !== undefined && (o.env[name] ?? "").trim() !== "" ? name : null;
+    };
+    for (const p of o.providers) {
+        if (logins[p] !== undefined || keyOf(p) !== null)
+            continue;
+        const otherKeys = Object.keys(RUNTIME_KEY_ENVS)
+            .filter((q) => q !== p)
+            .map(keyOf)
+            .filter((k) => k !== null);
+        const keys = otherKeys.length > 0
+            ? ` ${otherKeys.join(" and ")} ${otherKeys.length === 1 ? "is" : "are"} set, and the review does not switch models to use ${otherKeys.length === 1 ? "it" : "them"}: to review on another provider, set the review's models to it in your qcr config.`
+            : "";
+        return (`the review runs on ${p}, and pi has no login for it (pi's agent dir ${o.agentDir}). ` +
+            `Run \`qcr login\` to log in with pi's own /login, then review again.${keys}`);
+    }
+    return null;
+}
+//# sourceMappingURL=loginhint.js.map

package/dist/src/loginhint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginhint.js","sourceRoot":"","sources":["../../src/loginhint.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,gBAAgB,GAEjB,MAAM,gDAAgD,CAAC;AAExD,kEAAkE;AAClE,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,OAAiC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;IAE/D,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;sCACsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,CAKlC;IACC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,CAAS,EAAiB,EAAE;QACzC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,SAAS;QAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;aACtB,GAAG,CAAC,KAAK,CAAC;aACV,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,GACR,SAAS,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,sDAAsD,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,oFAAoF;YACtP,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,CACL,sBAAsB,CAAC,gDAAgD,CAAC,CAAC,QAAQ,KAAK;YACtF,uEAAuE,IAAI,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/loginrefresh/atomic.js

@@ -0,0 +1,66 @@
+// The one way the login file is replaced: a tmp file in the SAME directory,
+// fsync, rename over the target. Node builtins only and no runtime TypeScript
+// features, so a test can also run this very file as a separate process
+// (node's type stripping) and race a reader against it.
+//
+// A reader therefore sees the old file or the new one, whole, never a prefix.
+// The target's inode changes on every write, which is why the single-instance
+// lock is NOT on the target (lock.ts).
+import { chmodSync, chownSync, closeSync, fsyncSync, openSync, renameSync, statSync, unlinkSync, writeSync, } from "node:fs";
+import { dirname, join, basename } from "node:path";
+/** The mode every file in the login volume gets (entrypoint.sh share_login). */
+export const LOGIN_FILE_MODE = 0o660;
+/**
+ * Replace `target` with `text`: 0660, the login group. The chown is best
+ * effort (a uid outside the group cannot give a file to it); the mode is not.
+ */
+export function writeFileAtomic(target, text, o = {}) {
+    let gid = o.gid;
+    if (gid === undefined) {
+        try {
+            gid = statSync(target).gid;
+        }
+        catch {
+            /* first write: the directory's group applies */
+        }
+    }
+    const tmp = join(dirname(target), `.${basename(target)}.${process.pid}.tmp`);
+    const fd = openSync(tmp, "w", LOGIN_FILE_MODE);
+    try {
+        writeSync(fd, text);
+        fsyncSync(fd);
+    }
+    catch (err) {
+        closeSync(fd);
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            /* nothing to remove */
+        }
+        throw err;
+    }
+    closeSync(fd);
+    try {
+        chmodSync(tmp, LOGIN_FILE_MODE);
+        if (gid !== undefined) {
+            try {
+                chownSync(tmp, -1, gid);
+            }
+            catch {
+                /* not in that group: keep the creator's */
+            }
+        }
+        renameSync(tmp, target);
+    }
+    catch (err) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            /* already gone */
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/src/loginrefresh/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../../../src/loginrefresh/atomic.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,wDAAwD;AACxD,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,uCAAuC;AACvC,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAOrC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAY,EAAE,IAAwB,EAAE;IACtF,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IAChB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7E,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACpB,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,IAAI,CAAC;YACH,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,IAAI,CAAC;QACH,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;QACH,CAAC;QACD,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/src/loginrefresh/lock.js

@@ -0,0 +1,93 @@
+// The single-instance lock: an exclusive flock on a SEPARATE lock file
+// (`pihome/agent/auth.json.lock`), held for the refresher's whole life.
+//
+// Why not a lock on auth.json: every refresh replaces auth.json by rename
+// (atomic.ts), so a lock on it stays on the old inode, a second refresher could
+// then lock the new file and run beside the first, and the two would rotate the
+// refresh token under each other. The lock file is created once and never
+// renamed or replaced, so its lock survives every refresh.
+//
+// Node has no flock. The lock is held by a helper process: `flock -n <file> sh
+// -c 'echo locked; exec cat'`. `cat` blocks on a pipe from this process, so the
+// lock lasts exactly as long as the pipe's write end does: release() closes it,
+// and a refresher that is killed in any way closes it too (the kernel closes its
+// descriptors), so a crash can never leave the lock held by an orphan.
+import { spawn } from "node:child_process";
+import { chmodSync, chownSync, closeSync, mkdirSync, openSync } from "node:fs";
+import { dirname } from "node:path";
+/** flock's exit status when the lock is held by someone else (-E). */
+export const LOCK_HELD_EXIT = 75;
+/** Another refresher holds the lock. */
+export class LoginLockHeld extends Error {
+    // A plain field, not a parameter property: tests also run this file as a
+    // separate process under node's type stripping, which has no such syntax.
+    path;
+    constructor(path) {
+        super(`another login refresher holds ${path}`);
+        this.name = "LoginLockHeld";
+        this.path = path;
+    }
+}
+/** Create the lock file if it is missing, never replacing an existing one. */
+function ensureLockFile(path, gid) {
+    mkdirSync(dirname(path), { recursive: true });
+    // "a": create, never truncate; an existing file keeps its inode.
+    closeSync(openSync(path, "a", 0o660));
+    try {
+        chmodSync(path, 0o660);
+        if (gid !== undefined)
+            chownSync(path, -1, gid);
+    }
+    catch {
+        /* not ours to change: the lock does not need it */
+    }
+}
+/**
+ * Take the exclusive lock, without waiting. Throws `LoginLockHeld` when
+ * another process holds it.
+ */
+export function acquireLoginLock(path, o = {}) {
+    ensureLockFile(path, o.gid);
+    return new Promise((resolve, reject) => {
+        const child = spawn(o.flockBin ?? "flock", ["-n", "-E", String(LOCK_HELD_EXIT), path, "sh", "-c", "echo locked; exec cat"], { stdio: ["pipe", "pipe", "pipe"] });
+        let settled = false;
+        let stderr = "";
+        const done = new Promise((r) => child.once("exit", () => r()));
+        child.stderr.on("data", (c) => {
+            stderr += String(c);
+        });
+        child.stdout.once("data", () => {
+            if (settled)
+                return;
+            settled = true;
+            let released = false;
+            resolve({
+                path,
+                lost: done.then(() => (released ? undefined : "the lock holder exited")),
+                release: async () => {
+                    if (!released) {
+                        released = true;
+                        child.stdin.end();
+                    }
+                    await done;
+                },
+            });
+        });
+        child.once("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            reject(new Error(`could not run flock: ${err.message}`));
+        });
+        child.once("exit", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            if (code === LOCK_HELD_EXIT)
+                reject(new LoginLockHeld(path));
+            else
+                reject(new Error(`flock exited ${code}: ${stderr.trim() || "no output"}`));
+        });
+    });
+}
+//# sourceMappingURL=lock.js.map

package/dist/src/loginrefresh/lock.js.map

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

package/dist/src/loginrefresh/main.js

@@ -0,0 +1,58 @@
+// Entry point of the login refresher: `node dist/src/loginrefresh/main.js`,
+// spawned and supervised by the daemon (supervisor.ts) by path. Configured by
+// env, so this process reads no config.toml:
+//
+//   QCR_LOGIN_AGENT_DIR   pi's agent dir (default $PI_CODING_AGENT_DIR, else ~/.pi/agent)
+//   QCR_LOGIN_MARGIN_MIN  the refresh margin beyond pi's window, in minutes
+//   QCR_LOGIN_GID         the login group a new file is given (default: auth.json's)
+//
+// Exit 75: another refresher holds the lock (the supervisor backs off).
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { LOCK_HELD_EXIT, LoginLockHeld } from "./lock.js";
+import { piOAuthRefresh } from "./pirefresh.js";
+import { LoginRefresher } from "./refresher.js";
+const log = (msg, extra) => {
+    const tail = extra === undefined ? "" : ` ${extra instanceof Error ? extra.message : JSON.stringify(extra)}`;
+    console.log(`${msg}${tail}`);
+};
+const agentDir = process.env["QCR_LOGIN_AGENT_DIR"]?.trim() ||
+    process.env["PI_CODING_AGENT_DIR"]?.trim() ||
+    join(process.env["HOME"]?.trim() || homedir(), ".pi", "agent");
+const marginMin = Number(process.env["QCR_LOGIN_MARGIN_MIN"] ?? "90");
+const gid = Number(process.env["QCR_LOGIN_GID"] ?? "");
+try {
+    const refresher = await LoginRefresher.start({
+        agentDir,
+        refresh: piOAuthRefresh,
+        marginMs: (Number.isFinite(marginMin) && marginMin > 0 ? marginMin : 90) * 60_000,
+        gid: Number.isInteger(gid) && gid > 0 ? gid : undefined,
+        log,
+    });
+    log(`login refresh: up — owns ${join(agentDir, "auth.json")}`);
+    let stopping = false;
+    const shutdown = (signal) => {
+        if (stopping)
+            return;
+        stopping = true;
+        log(`login refresh: ${signal} — stopping`);
+        void refresher.stop().finally(() => process.exit(0));
+    };
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    void refresher.lost.then((why) => {
+        if (stopping || !why)
+            return;
+        log(`login refresh: ${why} — exiting so the supervisor starts a clean one`);
+        process.exit(1);
+    });
+}
+catch (err) {
+    if (err instanceof LoginLockHeld) {
+        log(`login refresh: ${err.message} — refusing to start`);
+        process.exit(LOCK_HELD_EXIT);
+    }
+    log("login refresh: could not start", err);
+    process.exit(1);
+}
+//# sourceMappingURL=main.js.map

package/dist/src/loginrefresh/main.js.map

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

package/dist/src/loginrefresh/pirefresh.js

@@ -0,0 +1,49 @@
+// pi-ai's own OAuth refresh for a provider: the one file in the refresher that
+// touches pi. Deep-imported by file path (the package's export map publishes no
+// OAuth flow), like the SDK host's dispatcher (packages/pi-plugin/src/engine/pisdk.ts), so the
+// refresh is exactly what pi itself would do. The daemon never imports this
+// module: it spawns main.js, which does.
+//
+// VERIFY-ON-PIN (pi-ai 1.3.0, re-read at 1.4.0): `dist/auth/oauth/load.js` exports the loaders
+// below, each resolving to an `OAuthAuth` whose `refresh(credential, signal)`
+// returns the new credential. A bump that moves or renames them makes the
+// refresh fail loudly (a `login_refresh_failed` anomaly), never silently.
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+const PI_AI = "@earendil-works/pi-ai";
+/** A provider id (its key in auth.json) to the pi-ai loader of its OAuth flow. */
+export const OAUTH_LOADERS = {
+    anthropic: "loadAnthropicOAuth",
+    "openai-codex": "loadOpenAICodexOAuth",
+    "github-copilot": "loadGitHubCopilotOAuth",
+    openrouter: "loadOpenRouterOAuth",
+    "kimi-coding": "loadKimiCodingOAuth",
+    meta: "loadMetaOAuth",
+    xai: "loadXaiOAuth",
+};
+/** The installed pi-ai package directory, found on the module search path. */
+export function piAiDir() {
+    const req = createRequire(import.meta.url);
+    for (const base of req.resolve.paths(PI_AI) ?? []) {
+        const dir = join(base, PI_AI);
+        if (existsSync(join(dir, "package.json")))
+            return dir;
+    }
+    throw new Error(`${PI_AI} not found on the module search path`);
+}
+export const piOAuthRefresh = async (provider, credential, signal) => {
+    const loaderName = OAUTH_LOADERS[provider];
+    if (!loaderName)
+        throw new Error(`no pi-ai OAuth flow is known for provider ${provider}`);
+    const file = join(piAiDir(), "dist", "auth", "oauth", "load.js");
+    const mod = (await import(pathToFileURL(file).href));
+    const loader = mod[loaderName];
+    if (typeof loader !== "function")
+        throw new Error(`pi-ai's ${loaderName} is gone from ${file}: the pinned pi drifted (VERIFY-ON-PIN)`);
+    const flow = await loader();
+    const fresh = await flow.refresh(credential, signal);
+    return fresh;
+};
+//# sourceMappingURL=pirefresh.js.map