@quickchatai/quickreview 0.0.0-stage → 1.1.0

package/dist/src/ipc/client.js.map

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

package/dist/src/ipc/control.js

@@ -0,0 +1,70 @@
+// The operator's controls over a running worker: steer, followUp and abort.
+// Neutral, like the rest of src/ipc/: shapes and validators, no engine, no pi, no
+// state store.
+//
+// The daemon validates a control (src/commands.ts has already validated the
+// operator's file) and pushes it down the worker's own connection as a `control`
+// message; the worker answers with ONE `control.ack` request naming the control's
+// id. The ack says what became of it, never that the model acted on it:
+//
+//   queued   the session has it and acts when its turn allows (a steer lands after
+//            the tool calls of the turn in flight, a follow-up after the run);
+//   handled  the session acted now (an idle session started the turn; an abort has
+//            stopped the turn and everything it started);
+//   refused  the worker did not take it, with a reason (the round is ending, the
+//            session is not open yet, the text is unusable).
+//
+// An abort the worker never acks is not trusted: the supervisor ends the group
+// after a grace period (src/workersupervisor.ts).
+import { IpcError } from "./protocol.js";
+export const CONTROL_KINDS = ["steer", "follow_up", "abort"];
+export const CONTROL_ACK_OP = "control.ack";
+export const CONTROL_ACKS = ["queued", "handled", "refused"];
+/** The longest `text` a steer or follow-up carries, in characters: the same bound
+ * the operator's command carries (tests/worker-control.test.ts holds them equal). */
+export const CONTROL_TEXT_MAX = 8000;
+/** The id every control carries and its ack names back. */
+export const CONTROL_ID_RE = /^[A-Za-z0-9_.:-]{1,128}$/;
+export const isControlKind = (x) => typeof x === "string" && CONTROL_KINDS.includes(x);
+function isRecord(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+/** The text of a steer or follow-up: non-empty after trimming, within the bound. */
+export function controlText(text) {
+    if (typeof text !== "string" || text.trim() === "")
+        throw new IpcError("bad_request", "a steer or follow-up needs a non-empty `text`");
+    if (text.length > CONTROL_TEXT_MAX)
+        throw new IpcError("bad_request", `\`text\` is over ${CONTROL_TEXT_MAX} characters`);
+    return text;
+}
+/** A control message, read by the worker. Throws `bad_request`. */
+export function parseControl(kind, body) {
+    if (!isControlKind(kind))
+        throw new IpcError("bad_request", `unknown control kind: ${kind}`);
+    if (!isRecord(body))
+        throw new IpcError("bad_request", "a control's body must be an object");
+    const id = body["id"];
+    if (typeof id !== "string" || !CONTROL_ID_RE.test(id))
+        throw new IpcError("bad_request", "a control's `id` has an invalid shape");
+    if (kind === "abort")
+        return { kind, id };
+    return { kind, id, text: controlText(body["text"]) };
+}
+/** The worker's ack, read by the daemon. Throws `bad_request`. */
+export function parseControlAck(body) {
+    if (!isRecord(body))
+        throw new IpcError("bad_request", "control.ack: the body must be an object");
+    const id = body["id"];
+    if (typeof id !== "string" || !CONTROL_ID_RE.test(id))
+        throw new IpcError("bad_request", "control.ack: `id` has an invalid shape");
+    const ack = body["ack"];
+    if (!CONTROL_ACKS.includes(ack))
+        throw new IpcError("bad_request", "control.ack: `ack` must be queued, handled or refused");
+    const reason = body["reason"];
+    return {
+        id,
+        ack: ack,
+        ...(typeof reason === "string" && reason !== "" ? { reason: reason.slice(0, 300) } : {}),
+    };
+}
+//# sourceMappingURL=control.js.map

package/dist/src/ipc/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../src/ipc/control.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,kFAAkF;AAClF,eAAe;AACf,EAAE;AACF,4EAA4E;AAC5E,iFAAiF;AACjF,kFAAkF;AAClF,wEAAwE;AACxE,EAAE;AACF,mFAAmF;AACnF,+EAA+E;AAC/E,mFAAmF;AACnF,0DAA0D;AAC1D,iFAAiF;AACjF,6DAA6D;AAC7D,EAAE;AACF,+EAA+E;AAC/E,kDAAkD;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAGtE,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAGtE;qFACqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAcxD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAU,EAAoB,EAAE,CAC5D,OAAO,CAAC,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE5E,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAChD,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,+CAA+C,CAAC,CAAC;IACrF,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB;QAChC,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,oBAAoB,gBAAgB,aAAa,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAa;IACtD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,yBAAyB,IAAI,EAAE,CAAC,CAAC;IAC7F,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,oCAAoC,CAAC,CAAC;IAC7F,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,uCAAuC,CAAC,CAAC;IAC7E,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,yCAAyC,CAAC,CAAC;IAClG,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,wCAAwC,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAE,YAAkC,CAAC,QAAQ,CAAC,GAAa,CAAC;QAC9D,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,uDAAuD,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO;QACL,EAAE;QACF,GAAG,EAAE,GAAsB;QAC3B,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC"}

package/dist/src/ipc/ghreadshim.js

@@ -0,0 +1,77 @@
+// The read client behind pr-context.sh, pr-checks.sh, pr-threads.sh and
+// pr-self.sh on a host the daemon runs: the daemon makes the GitHub
+// read (src/ghread.ts) with the App's installation token, which this process,
+// running as the model's tool uid, can neither read nor mint.
+//
+//   node dist/src/ipc/ghreadshim.js get <path> <outfile>
+//   node dist/src/ipc/ghreadshim.js graphql <query-name> <outfile> <variables-json>
+//
+// It writes GitHub's body to <outfile> and prints GitHub's status on stdout, as
+// `curl -o <outfile> -w '%{http_code}'` does, so a script swaps one for the
+// other. A body the daemon cut says so on stderr. A read the daemon refused, or
+// a socket that cannot be reached, is a line on stderr and exit 1, with nothing
+// printed on stdout.
+import { writeFileSync } from "node:fs";
+import { connectFromEnv } from "./client.js";
+import { GH_READ_OP, IpcError } from "./protocol.js";
+const OP = GH_READ_OP;
+const USAGE = "usage: ghreadshim get <path> <outfile> | graphql <query-name> <outfile> <variables-json>";
+/** A read can wait on GitHub's own 60 s deadline, once more after a re-mint. */
+const READ_TIMEOUT_MS = 150_000;
+/** A 4 MiB body, JSON-escaped, fits well inside this. */
+const MAX_ANSWER_LINE = 64 * 1024 * 1024;
+const processIo = {
+    stdout: (t) => void process.stdout.write(t),
+    stderr: (t) => void process.stderr.write(t),
+    write: (f, b) => writeFileSync(f, b),
+};
+/** The request body for the arguments, or an IpcError naming the usage. */
+export function readRequest(args) {
+    const [sub, what, out, vars] = args;
+    if (!what || !out)
+        throw new IpcError("bad_request", USAGE);
+    if (sub === "get" && args.length === 3)
+        return { body: { kind: "rest", path: what }, out };
+    if (sub === "graphql" && args.length === 4) {
+        let variables;
+        try {
+            variables = JSON.parse(vars ?? "");
+        }
+        catch {
+            throw new IpcError("bad_request", "the variables are not JSON");
+        }
+        return { body: { kind: "graphql", name: what, variables }, out };
+    }
+    throw new IpcError("bad_request", USAGE);
+}
+export async function runReadShim(args, env = process.env, io = processIo) {
+    let client;
+    try {
+        const { body, out } = readRequest(args);
+        client = await connectFromEnv("shim", env, {
+            timeoutMs: READ_TIMEOUT_MS,
+            maxLineBytes: MAX_ANSWER_LINE,
+        });
+        const a = await client.request(OP, body, { timeoutMs: READ_TIMEOUT_MS });
+        if (typeof a?.status !== "number" || typeof a.body !== "string")
+            throw new IpcError("internal", "the daemon's answer has no status and body");
+        io.write(out, a.body);
+        if (a.truncated === true)
+            io.stderr("ghread: the body was cut at the daemon's cap\n");
+        io.stdout(String(a.status));
+        return 0;
+    }
+    catch (e) {
+        const err = e instanceof IpcError ? e : new IpcError("internal", String(e));
+        io.stderr(`ghread: ${err.code}: ${err.message}\n`);
+        return 1;
+    }
+    finally {
+        client?.close();
+    }
+}
+// Run only as the entry point, not when a test imports runReadShim.
+if (process.argv[1]?.endsWith("ghreadshim.js")) {
+    void runReadShim(process.argv.slice(2)).then((code) => process.exit(code));
+}
+//# sourceMappingURL=ghreadshim.js.map

package/dist/src/ipc/ghreadshim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghreadshim.js","sourceRoot":"","sources":["../../../src/ipc/ghreadshim.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oEAAoE;AACpE,8EAA8E;AAC9E,8DAA8D;AAC9D,EAAE;AACF,yDAAyD;AACzD,oFAAoF;AACpF,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,EAAE,GAAG,UAAU,CAAC;AACtB,MAAM,KAAK,GACT,0FAA0F,CAAC;AAE7F,gFAAgF;AAChF,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,yDAAyD;AACzD,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAQzC,MAAM,SAAS,GAAe;IAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;CACrC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,IAAuB;IAIjD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC5D,IAAI,GAAG,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC;IAC3F,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,IAAI,SAAkB,CAAC;QACvB,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC;IACnE,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAuB,EACvB,MAAc,OAAO,CAAC,GAAG,EACzB,KAAiB,SAAS;IAE1B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;YACzC,SAAS,EAAE,eAAe;YAC1B,YAAY,EAAE,eAAe;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,OAAO,CAC5B,EAAE,EACF,IAAI,EACJ,EAAE,SAAS,EAAE,eAAe,EAAE,CAC/B,CAAC;QACF,IAAI,OAAO,CAAC,EAAE,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAC7D,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,4CAA4C,CAAC,CAAC;QAC/E,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI;YAAE,EAAE,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;QACtF,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,EAAE,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;IAC/C,KAAK,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/src/ipc/launcher.js

@@ -0,0 +1,65 @@
+// The pane-side half of the launch-file handoff.
+//
+// tmux does not pass file descriptors into a pane, so a takeover or debug pi
+// is started as
+//
+//     node dist/src/ipc/launcher.js <launch-file> -- pi ...
+//
+// The launcher claims the launch file (opens it, unlinks it), then runs the
+// command with the open fd as an inherited descriptor and QCR_IPC_CAP_FD set
+// to its number. pi and the shims under it read the capability with pread, as
+// anywhere else. The launch file's path is not a secret; the file is gone the
+// moment this runs.
+import { spawn } from "node:child_process";
+import { closeSync } from "node:fs";
+import { CAP_FD_INDEX, claimLaunchFile } from "./capability.js";
+export async function runLauncher(argv, env = process.env) {
+    const sep = argv.indexOf("--");
+    const file = argv[0];
+    const cmd = sep >= 0 ? argv.slice(sep + 1) : [];
+    if (!file || sep !== 1 || cmd.length === 0) {
+        process.stderr.write("usage: launcher <launch-file> -- <command> [args...]\n");
+        return 2;
+    }
+    let fd;
+    try {
+        fd = claimLaunchFile(file);
+    }
+    catch (e) {
+        process.stderr.write(`launcher: ${e.message}\n`);
+        return 3;
+    }
+    const child = spawn(cmd[0], cmd.slice(1), {
+        stdio: ["inherit", "inherit", "inherit", fd],
+        env: { ...env, QCR_IPC_CAP_FD: String(CAP_FD_INDEX) },
+    });
+    closeSync(fd); // the child holds its own copy
+    // The tty's SIGINT reaches the child directly; the launcher only outlives it.
+    const ignore = () => { };
+    const forward = (sig) => () => child.kill(sig);
+    const relays = [
+        ["SIGINT", ignore],
+        ["SIGTERM", forward("SIGTERM")],
+        ["SIGHUP", forward("SIGHUP")],
+    ];
+    for (const [sig, fn] of relays)
+        process.on(sig, fn);
+    try {
+        return await new Promise((resolve) => {
+            child.on("error", (e) => {
+                process.stderr.write(`launcher: ${e.message}\n`);
+                resolve(127);
+            });
+            child.on("exit", (code, signal) => resolve(code ?? (signal ? 128 : 1)));
+        });
+    }
+    finally {
+        for (const [sig, fn] of relays)
+            process.off(sig, fn);
+    }
+}
+// Run only as the entry point, not when a test imports runLauncher.
+if (process.argv[1]?.endsWith("launcher.js")) {
+    void runLauncher(process.argv.slice(2)).then((code) => process.exit(code));
+}
+//# sourceMappingURL=launcher.js.map

package/dist/src/ipc/launcher.js.map

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

package/dist/src/ipc/permits.js

@@ -0,0 +1,293 @@
+// The central lens permit broker: the daemon's one count of lens sessions
+// alive across every worker, and the worker's end of it.
+//
+// A worker's lens runner asks `permits.acquire{lens_id, weight}` before it
+// creates a pass's session and answers `permits.release{lens_id}` once the
+// session is read and disposed. The broker
+//   - never holds more than `ceiling` permits at once, over all workers;
+//   - grants in arrival order (FIFO across workers): a large head blocks the
+//     ones behind it rather than being starved by them;
+//   - spaces consecutive grants at least `staggerMs` apart, so a full wave of
+//     20 never creates its sessions in one burst (docs/cpu-gate.md, finding 4:
+//     8 to 20 simultaneous creations stalled the loop for 0.7 to 2.5 s);
+//   - takes a worker's permits back when the worker's command ends or its
+//     generation goes stale: the capability's revocation (`attach`) and a
+//     periodic look at the daemon's own view of the command (`reap`).
+// The command and its generation come from the authenticated connection, never
+// from the request body: a worker cannot spend another command's permits. Warm-
+// ups take no permit.
+//
+// Neutral, like the rest of src/ipc/: no engine, no pi, no state store. The
+// engine's lens runner reaches the broker through its `Permits` port
+// (packages/pi-plugin/src/engine/lens/permits.ts); `brokerPermits` below is the adapter the worker
+// builds over its IPC client.
+import { IpcError } from "./protocol.js";
+export const PERMITS_ACQUIRE_OP = "permits.acquire";
+export const PERMITS_RELEASE_OP = "permits.release";
+/** `[daemon] lens_permits`: ruled 20 for the VM (the CPU gate measured 20
+ * sessions fine on 2 cores). */
+export const DEFAULT_LENS_PERMITS = 20;
+/** `[daemon] lens_grant_stagger_ms`. */
+export const DEFAULT_LENS_GRANT_STAGGER_MS = 250;
+/** How often the daemon checks held permits against its view of the commands. */
+export const DEFAULT_PERMIT_REAP_MS = 5_000;
+const LENS_ID_RE = /^[A-Za-z0-9_.:-]{1,128}$/;
+const keyOf = (commandId, lensId) => `${commandId}\u0000${lensId}`;
+export class PermitBroker {
+    ceiling;
+    staggerMs;
+    available;
+    held = new Map();
+    queue = [];
+    lastGrantAt = Number.NEGATIVE_INFINITY;
+    timer = null;
+    reaper = null;
+    unsubscribe = null;
+    log;
+    constructor(opts = {}) {
+        const ceiling = opts.ceiling ?? DEFAULT_LENS_PERMITS;
+        const stagger = opts.staggerMs ?? DEFAULT_LENS_GRANT_STAGGER_MS;
+        if (!Number.isSafeInteger(ceiling) || ceiling < 1)
+            throw new Error(`the permit ceiling must be a positive integer (got ${String(ceiling)})`);
+        if (!Number.isFinite(stagger) || stagger < 0)
+            throw new Error(`the grant stagger must be a number of ms >= 0 (got ${String(stagger)})`);
+        this.ceiling = ceiling;
+        this.staggerMs = stagger;
+        this.available = ceiling;
+        this.log = opts.log ?? (() => { });
+    }
+    /** Resolves when `weight` permits are granted to `lensId` of the holder's
+     * command; rejects `cancelled` if the wait is ended by a release or by the
+     * command ending. A weight is clamped to 1..ceiling, as the local semaphore does. */
+    acquire(who, lensId, weight = 1) {
+        const key = keyOf(who.commandId, lensId);
+        if (this.held.has(key) || this.queue.some((w) => keyOf(w.commandId, w.lensId) === key))
+            return Promise.reject(new IpcError("bad_request", `lens ${lensId} already has a permit`));
+        // A newer generation of the command means the older worker is gone.
+        this.dropWhere((e) => e.commandId === who.commandId && e.generation < who.generation, "stale");
+        const w = Math.max(1, Math.min(Math.trunc(weight) || 1, this.ceiling));
+        return new Promise((resolve, reject) => {
+            this.queue.push({ ...who, lensId, weight: w, resolve, reject });
+            this.pump();
+        });
+    }
+    /** Give one lens's permits back, or cancel its wait. Idempotent. */
+    release(commandId, lensId) {
+        const key = keyOf(commandId, lensId);
+        const held = this.held.get(key);
+        if (held !== undefined) {
+            this.held.delete(key);
+            this.available += held.weight;
+            this.pump();
+            return "released";
+        }
+        const at = this.queue.findIndex((w) => keyOf(w.commandId, w.lensId) === key);
+        if (at >= 0) {
+            const [gone] = this.queue.splice(at, 1);
+            gone.reject(new IpcError("cancelled", "the permit wait was ended"));
+            this.pump();
+            return "cancelled";
+        }
+        return "none";
+    }
+    /** Everything a command holds or waits for, back: its worker exited. Returns
+     * the number of entries dropped. */
+    releaseCommand(commandId) {
+        return this.dropWhere((e) => e.commandId === commandId, "ended");
+    }
+    /** Drop what the daemon no longer stands behind: a command with no live
+     * worker, or a worker of an earlier generation. Returns the entries dropped. */
+    reap(lookup) {
+        const verdicts = new Map();
+        const live = (commandId) => {
+            if (!verdicts.has(commandId)) {
+                const s = lookup(commandId);
+                verdicts.set(commandId, s !== null && s.active ? s.generation : null);
+            }
+            return verdicts.get(commandId) ?? null;
+        };
+        return this.dropWhere((e) => live(e.commandId) !== e.generation, "no live worker");
+    }
+    /** Take permits back as soon as a command's capability is revoked (the
+     * supervisor revokes it when the worker's process has exited). */
+    attach(capabilities) {
+        this.unsubscribe?.();
+        this.unsubscribe = capabilities.onRevoke((id) => void this.releaseCommand(id));
+    }
+    /** Begin the periodic `reap`. */
+    start(lookup, intervalMs = DEFAULT_PERMIT_REAP_MS) {
+        if (this.reaper)
+            return;
+        this.reaper = setInterval(() => {
+            try {
+                this.reap(lookup);
+            }
+            catch (e) {
+                this.log(`permit reap failed: ${String(e)}`);
+            }
+        }, intervalMs);
+        this.reaper.unref();
+    }
+    /** The daemon is going down: end every wait and forget every permit. */
+    stop() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        if (this.reaper)
+            clearInterval(this.reaper);
+        this.reaper = null;
+        this.dropWhere(() => true, "the daemon is stopping");
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+    }
+    status() {
+        const per = new Map();
+        const slot = (id) => {
+            let s = per.get(id);
+            if (s === undefined)
+                per.set(id, (s = { in_use: 0, queued: 0 }));
+            return s;
+        };
+        for (const e of this.held.values())
+            slot(e.commandId).in_use += e.weight;
+        for (const w of this.queue)
+            slot(w.commandId).queued += 1;
+        return {
+            ceiling: this.ceiling,
+            stagger_ms: this.staggerMs,
+            in_use: this.ceiling - this.available,
+            queued: this.queue.length,
+            commands: [...per].map(([command_id, s]) => ({ command_id, ...s })),
+        };
+    }
+    dropWhere(pick, why) {
+        let n = 0;
+        for (const [key, e] of [...this.held]) {
+            if (!pick(e))
+                continue;
+            this.held.delete(key);
+            this.available += e.weight;
+            n++;
+            this.log(`permits of ${e.commandId} (lens ${e.lensId}) came back: ${why}`);
+        }
+        const keep = [];
+        for (const w of this.queue) {
+            if (pick(w)) {
+                w.reject(new IpcError("cancelled", `the permit wait was ended: ${why}`));
+                n++;
+            }
+            else
+                keep.push(w);
+        }
+        this.queue = keep;
+        if (n > 0)
+            this.pump();
+        return n;
+    }
+    /** Grant the head of the line while it fits and the stagger allows. */
+    pump() {
+        while (this.queue.length > 0) {
+            const head = this.queue[0];
+            if (head.weight > this.available)
+                return; // FIFO: the head waits for room
+            const wait = this.lastGrantAt + this.staggerMs - Date.now();
+            if (wait > 0) {
+                this.timer ??= setTimeout(() => {
+                    this.timer = null;
+                    this.pump();
+                }, wait);
+                this.timer.unref();
+                return;
+            }
+            this.queue.shift();
+            this.available -= head.weight;
+            this.lastGrantAt = Date.now();
+            this.held.set(keyOf(head.commandId, head.lensId), {
+                commandId: head.commandId,
+                generation: head.generation,
+                lensId: head.lensId,
+                weight: head.weight,
+            });
+            head.resolve();
+        }
+    }
+}
+function lensIdOf(body) {
+    const id = body?.lens_id;
+    if (typeof id !== "string" || !LENS_ID_RE.test(id))
+        throw new IpcError("bad_request", "`lens_id` must be a short plain id");
+    return id;
+}
+/** The two ops, for `IpcServer.register`. A worker's, not a shim's: only the
+ * round's host runs lens sessions. */
+export function permitOps(broker) {
+    return {
+        [PERMITS_ACQUIRE_OP]: {
+            roles: ["worker"],
+            handle: async (ctx, body) => {
+                const lensId = lensIdOf(body);
+                const raw = body.weight;
+                if (raw !== undefined && (typeof raw !== "number" || !Number.isFinite(raw)))
+                    throw new IpcError("bad_request", "`weight` must be a number");
+                await broker.acquire({ commandId: ctx.commandId, generation: ctx.generation }, lensId, raw ?? 1);
+                return { granted: true };
+            },
+        },
+        [PERMITS_RELEASE_OP]: {
+            roles: ["worker"],
+            handle: (ctx, body) => ({ result: broker.release(ctx.commandId, lensIdOf(body)) }),
+        },
+    };
+}
+function abortReason(signal) {
+    const r = signal.reason;
+    return r instanceof Error ? r : new Error("aborted");
+}
+/** The engine's `Permits` port (packages/pi-plugin/src/engine/lens/permits.ts) over the broker. */
+export function brokerPermits(client, warn = () => { }) {
+    const give = (lensId) => {
+        // A release that cannot be sent is not lost: the permit returns when the
+        // worker exits.
+        client.request(PERMITS_RELEASE_OP, { lens_id: lensId }).catch((e) => {
+            warn(`permit release for ${lensId} failed: ${String(e)}`);
+        });
+    };
+    return {
+        async acquire(lensId, weight, signal) {
+            signal?.throwIfAborted();
+            const call = client.request(PERMITS_ACQUIRE_OP, { lens_id: lensId, weight }, { timeoutMs: 0 });
+            // If the wait is abandoned the call still settles (cancelled): no unhandled rejection.
+            call.catch(() => { });
+            let onAbort;
+            try {
+                if (signal === undefined)
+                    await call;
+                else
+                    await Promise.race([
+                        call,
+                        new Promise((_, reject) => {
+                            onAbort = () => {
+                                give(lensId); // ends the wait, or returns a grant already on its way
+                                reject(abortReason(signal));
+                            };
+                            signal.addEventListener("abort", onAbort, { once: true });
+                        }),
+                    ]);
+            }
+            finally {
+                if (onAbort)
+                    signal?.removeEventListener("abort", onAbort);
+            }
+            let given = false;
+            return {
+                release: () => {
+                    if (given)
+                        return;
+                    given = true;
+                    give(lensId);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=permits.js.map

package/dist/src/ipc/permits.js.map

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