@loompad/cli 0.1.0 → 1.1.1

package/dist/core/preview-shot.js

@@ -0,0 +1,109 @@
+/**
+ * A picture of the page Loom is previewing.
+ *
+ * The preview is an iframe pointing at someone else's origin, so the browser
+ * will not let the page photograph it — and a person who can see the bug on
+ * screen shouldn't have to describe it in words. The daemon takes the shot
+ * instead, with the Playwright the project already has for its specs, and the
+ * file lands where attachments live so the composer can carry it like any
+ * pasted image.
+ *
+ * A project without Playwright is told so plainly rather than handed an empty
+ * file: `npx --no-install` never installs anything behind your back.
+ */
+import { spawn } from "./process.js";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const MAX_SHOT_MS = 45_000;
+/** The little script Playwright runs. Kept here so what it does is readable. */
+export function shotScript(req) {
+    return `const { chromium } = require("playwright");
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage({
+    viewport: { width: ${req.width}, height: ${req.height} },
+    colorScheme: ${JSON.stringify(req.colorScheme)},
+    deviceScaleFactor: 2,
+  });
+  try {
+    await page.goto(${JSON.stringify(req.url)}, { waitUntil: "load", timeout: 20000 });
+    // Settle: fonts and the first paint of whatever loaded late.
+    await page.waitForTimeout(400);
+    ${req.selector
+        ? `const el = page.locator(${JSON.stringify(req.selector)}).first();
+    await el.scrollIntoViewIfNeeded({ timeout: 8000 });
+    await el.screenshot({ path: ${JSON.stringify(req.out)}, timeout: 8000 });`
+        : `await page.screenshot({ path: ${JSON.stringify(req.out)}, fullPage: ${req.fullPage} });`}
+  } finally {
+    await browser.close();
+  }
+})().catch((err) => { console.error(String(err && err.message || err)); process.exit(1); });
+`;
+}
+/**
+ * Take the shot in `projectDir` (so the project's own Playwright and browsers
+ * are the ones used). Rejects with something a person can act on.
+ */
+export async function capture(projectDir, req, spawnImpl = spawn) {
+    const url = req.url.trim();
+    if (!/^https?:\/\//.test(url))
+        throw new Error("a screenshot needs an http(s) url");
+    const width = clamp(req.width ?? 1280, 200, 3840);
+    const height = clamp(req.height ?? 800, 200, 3840);
+    const colorScheme = req.colorScheme === "dark" ? "dark" : "light";
+    const fullPage = Boolean(req.fullPage);
+    // The script lives in the PROJECT, not in /tmp: node resolves `playwright`
+    // from the script's own directory, and a script in /tmp would never find the
+    // project's copy — it would report "no Playwright" for a project that has it.
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "loom-shot-"));
+    const scriptDir = path.join(projectDir, ".loom");
+    fs.mkdirSync(scriptDir, { recursive: true });
+    const script = path.join(scriptDir, `preview-shot-${process.pid}-${Date.now()}.cjs`);
+    const out = path.join(tmp, "shot.png");
+    const selector = typeof req.selector === "string" && req.selector.trim() ? req.selector.trim().slice(0, 500) : undefined;
+    fs.writeFileSync(script, shotScript({ url, width, height, colorScheme, fullPage, out, ...(selector ? { selector } : {}) }));
+    const code = await new Promise((resolve) => {
+        const child = spawnImpl("npx", ["--no-install", "node", script], {
+            cwd: projectDir,
+            env: { ...process.env, CI: "1" },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let err = "";
+        child.stderr?.on("data", (d) => (err += String(d)));
+        const timer = setTimeout(() => child.kill("SIGKILL"), req.timeoutMs ?? MAX_SHOT_MS);
+        child.on("error", (e) => {
+            clearTimeout(timer);
+            resolve({ code: 1, err: e.message });
+        });
+        child.on("exit", (c) => {
+            clearTimeout(timer);
+            resolve({ code: c ?? 1, err });
+        });
+    });
+    fs.rmSync(script, { force: true });
+    if (code.code !== 0 || !fs.existsSync(out)) {
+        fs.rmSync(tmp, { recursive: true, force: true });
+        throw new Error(explain(code.err));
+    }
+    return { file: out, width, height, colorScheme, fullPage };
+}
+/** Playwright's failures, in words that say what to do. */
+export function explain(stderr) {
+    const s = stderr.trim();
+    if (/Cannot find module 'playwright'|Cannot find package 'playwright'/.test(s)) {
+        return "this project has no Playwright — add it (npm i -D playwright) and run npx playwright install chromium";
+    }
+    if (/Executable doesn't exist|browserType.launch/.test(s)) {
+        return "Playwright is here but its browser isn't — run npx playwright install chromium";
+    }
+    if (/net::ERR_CONNECTION_REFUSED/.test(s))
+        return "nothing answered at that address — is the server running?";
+    if (/Timeout .* exceeded|navigation timeout/i.test(s))
+        return "the page didn't finish loading in time";
+    return s.split("\n").slice(-3).join(" ").slice(0, 300) || "the screenshot failed";
+}
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, Math.round(Number(n) || lo)));
+}
+//# sourceMappingURL=preview-shot.js.map

package/dist/core/preview-shot.js.map

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

package/dist/core/process.d.ts

@@ -0,0 +1,36 @@
+import { spawn as nodeSpawn, execFile as nodeExecFile, execFileSync as nodeExecFileSync, type ChildProcess } from "node:child_process";
+/** A trusted, user-configured command line, using the native OS shell. */
+export declare function shellInvocation(command: string): {
+    command: string;
+    args: string[];
+    windowsVerbatimArguments?: boolean;
+};
+/** Carry a file placeholder through the environment so spaces and shell
+ * characters in the file's name cannot become command syntax. */
+export declare function fileCommand(template: string, file: string): {
+    command: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    windowsVerbatimArguments?: boolean;
+};
+export declare function findExecutable(command: string, env?: NodeJS.ProcessEnv, cwd?: string): string | null;
+export declare function commandInvocation(command: string, args: readonly string[], options?: {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string | URL;
+}): {
+    command: string;
+    args: string[];
+};
+export declare const spawn: typeof nodeSpawn;
+/** Native harnesses run inside an owned containment boundary on every OS. */
+export declare const spawnContained: typeof nodeSpawn;
+export declare const execFile: typeof nodeExecFile;
+export declare const execFileSync: typeof nodeExecFileSync;
+/** Stop the Windows process tree while its parent still exists. This is
+ * best-effort shutdown for ordinary sessions, not native-continuity containment.
+ */
+export declare function stopWindowsTree(child: ChildProcess): Promise<void>;
+/** Interrupt a pipe terminal's foreground children, preserving its cmd session. */
+export declare function stopWindowsChildren(parentPid: number): Promise<void>;
+/** Stop a verified orphan's tree without terminating shared console hosts. */
+export declare function stopWindowsPid(pid: number): Promise<void>;

package/dist/core/process.js

@@ -0,0 +1,168 @@
+/** Launch Node CLIs on Windows without passing prompts through cmd.exe.
+ * npm's .cmd shims and Unix shebangs are not executable by CreateProcess.
+ * Resolve those to their JavaScript entry point and keep every argument literal.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { spawn as nodeSpawn, execFile as nodeExecFile, execFileSync as nodeExecFileSync } from "node:child_process";
+import { promisify } from "node:util";
+import { spawnWindowsJob, hasWindowsJob, quiesceWindowsJob } from "./windows-jobs.js";
+/** A trusted, user-configured command line, using the native OS shell. */
+export function shellInvocation(command) {
+    return process.platform === "win32"
+        ? { command: process.env.ComSpec ?? "cmd.exe", args: ["/d", "/s", "/c", `"${command}"`], windowsVerbatimArguments: true }
+        : { command: "/bin/sh", args: ["-c", command] };
+}
+/** Carry a file placeholder through the environment so spaces and shell
+ * characters in the file's name cannot become command syntax. */
+export function fileCommand(template, file) {
+    const quoted = process.platform === "win32" ? '"%LOOM_INPUT_FILE%"' : '"$LOOM_INPUT_FILE"';
+    const command = template.replaceAll('"{file}"', quoted).replaceAll("'{file}'", quoted).replaceAll("{file}", quoted);
+    return { ...shellInvocation(command), env: { ...process.env, LOOM_INPUT_FILE: file } };
+}
+export function findExecutable(command, env = process.env, cwd = process.cwd()) {
+    const dirs = /[/\\]/.test(command) ? [""] : (env.PATH ?? env.Path ?? "").split(path.delimiter).filter(Boolean);
+    const extensions = process.platform === "win32" ? ["", ...(env.PATHEXT ?? ".EXE;.COM;.CMD;.BAT").split(";")] : [""];
+    for (const dir of dirs)
+        for (const ext of extensions) {
+            const file = path.resolve(cwd, dir.replace(/^"|"$/g, ""), command + ext.toLowerCase());
+            try {
+                if (fs.statSync(file).isFile())
+                    return file;
+            }
+            catch { /* try the next path */ }
+        }
+    return null;
+}
+export function commandInvocation(command, args, options = {}) {
+    if (process.platform !== "win32")
+        return { command, args: [...args] };
+    const file = findExecutable(command, options.env, typeof options.cwd === "string" ? options.cwd : undefined);
+    if (!file || /\.(exe|com)$/i.test(file))
+        return { command: file ?? command, args: [...args] };
+    let text;
+    try {
+        const fd = fs.openSync(file, "r");
+        try {
+            const buf = Buffer.alloc(8192);
+            text = buf.subarray(0, fs.readSync(fd, buf)).toString();
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return { command: file, args: [...args] };
+    }
+    if (/^#![^\r\n]*\bnode\b/.test(text) || /\.[cm]?js$/i.test(file))
+        return { command: process.execPath, args: [file, ...args] };
+    // npm/cmd-shim uses %dp0% (older versions: %~dp0) for its own directory.
+    // Only unwrap a Node launcher; a user's arbitrary batch file is not JavaScript.
+    if (/\.(cmd|bat)$/i.test(file) && /(?:^|[\s"\\/])node(?:\.exe)?(?:["\s]|$)/im.test(text)) {
+        const entry = /"%(?:dp0%|~dp0)[\\/]([^"\r\n]+)"\s+%\*/i.exec(text)?.[1];
+        if (entry) {
+            const script = path.resolve(path.dirname(file), entry);
+            if (fs.existsSync(script))
+                return { command: process.execPath, args: [script, ...args] };
+        }
+    }
+    // npm also wraps native binaries (OpenCode 1.19+ on Windows). Unwrap only
+    // its literal %dp0% executable + %* form, without interpreting batch code.
+    if (/\.(cmd|bat)$/i.test(file)) {
+        const entry = /"%(?:dp0%|~dp0)[\\/]([^"\r\n]+\.(?:exe|com))"\s+%\*/i.exec(text)?.[1];
+        if (entry) {
+            const binary = path.resolve(path.dirname(file), entry);
+            if (fs.existsSync(binary))
+                return { command: binary, args: [...args] };
+        }
+    }
+    // npm also writes an extensionless POSIX shim next to the .cmd file.
+    if (!path.extname(file) && fs.existsSync(`${file}.cmd`))
+        return commandInvocation(`${file}.cmd`, args, options);
+    return { command: file, args: [...args] };
+}
+export const spawn = ((command, args = [], options = {}) => {
+    if (!Array.isArray(args))
+        return nodeSpawn(command, { windowsHide: true, ...args });
+    const spec = commandInvocation(command, args, options);
+    return nodeSpawn(spec.command, spec.args, { windowsHide: true, ...options });
+});
+/** Native harnesses run inside an owned containment boundary on every OS. */
+export const spawnContained = ((command, args, options = {}) => {
+    const spec = commandInvocation(command, args, options);
+    return process.platform === "win32" ? spawnWindowsJob(spec.command, spec.args, options)
+        : nodeSpawn(spec.command, spec.args, { ...options, detached: true });
+});
+export const execFile = ((command, args, ...rest) => {
+    const options = (typeof rest[0] === "object" && rest[0] ? rest[0] : {});
+    const spec = commandInvocation(command, args, options);
+    return nodeExecFile(spec.command, spec.args, { windowsHide: true, ...options }, ...rest.filter((v) => typeof v === "function"));
+});
+Object.defineProperty(execFile, promisify.custom, { value: (command, args, options = {}) => {
+        const spec = commandInvocation(command, args, options);
+        return promisify(nodeExecFile)(spec.command, spec.args, { windowsHide: true, ...options });
+    } });
+export const execFileSync = ((command, args, options = {}) => {
+    const spec = commandInvocation(command, args, options);
+    return nodeExecFileSync(spec.command, spec.args, { windowsHide: true, ...options });
+});
+/** Stop the Windows process tree while its parent still exists. This is
+ * best-effort shutdown for ordinary sessions, not native-continuity containment.
+ */
+export async function stopWindowsTree(child) {
+    if (hasWindowsJob(child))
+        return quiesceWindowsJob(child);
+    if (!child.pid || child.exitCode !== null || child.signalCode !== null)
+        return;
+    await terminateWindowsTree(child.pid, true, () => child.exitCode === null && child.signalCode === null).catch(() => {
+        try {
+            child.kill();
+        }
+        catch { /* already gone */ }
+    });
+}
+/** Interrupt a pipe terminal's foreground children, preserving its cmd session. */
+export async function stopWindowsChildren(parentPid) {
+    await terminateWindowsTree(parentPid, false);
+}
+/** Stop a verified orphan's tree without terminating shared console hosts. */
+export async function stopWindowsPid(pid) {
+    await terminateWindowsTree(pid, true);
+}
+async function terminateWindowsTree(rootPid, includeRoot, stillRunning = () => true) {
+    const { stdout } = await promisify(nodeExecFile)("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command",
+        "Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,Name,@{Name='Created';Expression={if($_.CreationDate){$_.CreationDate.ToUniversalTime().ToString('o')}}} | ConvertTo-Json -Compress"], { windowsHide: true, timeout: 8000 });
+    const rows = JSON.parse(stdout);
+    // CIM can take seconds. A provider (or a second stop request) may have
+    // closed the child meanwhile, and Windows can reuse its PID for another
+    // process. Never act on that stale process-tree snapshot.
+    const root = rows.find(row => row.ProcessId === rootPid);
+    if (!stillRunning() || !root)
+        return;
+    const pids = [], visited = new Set();
+    const visit = (parent) => {
+        if (visited.has(parent.ProcessId))
+            return;
+        visited.add(parent.ProcessId);
+        for (const row of rows)
+            if (row.ParentProcessId === parent.ProcessId) {
+                // ParentProcessId can refer to a later process that reused an old
+                // parent's PID. UTC round-trip strings retain CIM's timestamp precision.
+                // Unknown ancestry is left alone rather than killing another session.
+                if (!parent.Created || !row.Created || row.Created < parent.Created)
+                    continue;
+                // A console host can serve the surviving shell/daemon too. taskkill /T
+                // kills it and leaves later console children with DLL_INIT_FAILED.
+                if (!/^(?:conhost|OpenConsole)\.exe$/i.test(row.Name)) {
+                    visit(row);
+                    pids.push(row.ProcessId);
+                }
+            }
+    };
+    visit(root);
+    if (includeRoot)
+        pids.push(rootPid);
+    if (pids.length)
+        await promisify(nodeExecFile)("taskkill.exe", [...pids.flatMap(pid => ["/pid", String(pid)]), "/F"], { windowsHide: true, timeout: 8000 }).catch(() => { });
+}
+//# sourceMappingURL=process.js.map

package/dist/core/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/core/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,QAAQ,IAAI,YAAY,EAAE,YAAY,IAAI,gBAAgB,EAAqB,MAAM,oBAAoB,CAAC;AACvI,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtF,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QACjC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,GAAG,CAAC,EAAE,wBAAwB,EAAE,IAAI,EAAE;QACzH,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;AACpD,CAAC;AAED;iEACiE;AACjE,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAY;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpH,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACpF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/G,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpH,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACvF,IAAI,CAAC;gBAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;oBAAE,OAAO,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;QACxF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAuB,EAAE,UAA2D,EAAE;IACvI,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7G,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9F,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC;YAAC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;IAAC,CAAC;IACzK,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,CAAC;IACpD,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9H,yEAAyE;IACzE,gFAAgF;IAChF,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzF,MAAM,KAAK,GAAG,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAC3F,CAAC;IACH,CAAC;IACD,0EAA0E;IAC1E,2EAA2E;IAC3E,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;IACD,qEAAqE;IACrE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,IAAI,MAAM,CAAC;QAAE,OAAO,iBAAiB,CAAC,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAqB,CAAC,CAAC,OAAe,EAAE,OAA0B,EAAE,EAAE,UAAkB,EAAE,EAAE,EAAE;IAC9G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC/E,CAAC,CAAqB,CAAC;AAEvB,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAqB,CAAC,CAAC,OAAe,EAAE,IAAc,EAAE,UAAkB,EAAE,EAAE,EAAE;IACzG,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QACrF,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC,CAAqB,CAAC;AAEvB,MAAM,CAAC,MAAM,QAAQ,GAAwB,CAAC,CAAC,OAAe,EAAE,IAAc,EAAE,GAAG,IAAe,EAAE,EAAE;IACpG,MAAM,OAAO,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAoD,CAAC;IAC3H,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,OAAQ,YAAyB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC;AAChJ,CAAC,CAAwB,CAAC;AAC1B,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;QAC3G,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC,EAAE,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,YAAY,GAA4B,CAAC,CAAC,OAAe,EAAE,IAAc,EAAE,UAAmF,EAAE,EAAE,EAAE;IAC/K,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACtF,CAAC,CAA4B,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAmB;IACvD,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO;IAC/E,MAAM,oBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACjH,IAAI,CAAC;YAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB;IACzD,MAAM,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,OAAe,EAAE,WAAoB,EAAE,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI;IAClG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU;QAC7G,6MAA6M,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAExP,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAiB,CAAC;IAChD,uEAAuE;IACvE,wEAAwE;IACxE,0DAA0D;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI;QAAE,OAAO;IACrC,MAAM,IAAI,GAAa,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,MAAkB,EAAQ,EAAE;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO;QAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,IAAI,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrE,kEAAkE;gBAClE,yEAAyE;gBACzE,sEAAsE;gBACtE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;oBAAE,SAAS;gBAC9E,uEAAuE;gBACvE,mEAAmE;gBACnE,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;YAClG,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,IAAI,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9K,CAAC"}

package/dist/core/prompt-queue.d.ts

@@ -0,0 +1,136 @@
+/**
+ * The prompt queue: what you've lined up for this project, run one at a time.
+ *
+ * You type while an agent is mid-turn, or while an orchestra goal is still
+ * running, and the prompt waits here instead of being refused or lost. Each
+ * item names who takes it — one agent, the orchestrator (a new goal), or the
+ * auto router — and nothing about it is final until it's sent: you can edit
+ * the text, change who it goes to, reorder it or drop it.
+ *
+ * This module is the data and its file; ProjectRuntime decides when the head
+ * of the queue may go (see ProjectRuntime.drainPromptQueue). The file lives in
+ * the project's .loom/ beside the log, so a queue survives a daemon restart —
+ * reloaded paused, because prompts you queued an hour ago shouldn't start
+ * running just because the daemon came back.
+ */
+export type QueueTarget = {
+    kind: "agent";
+    agentId: string;
+} | {
+    kind: "orchestra";
+    orchestrator?: string;
+    workers?: string[];
+    maxParallel?: number;
+    maxUsd?: number;
+} | {
+    kind: "auto";
+};
+/**
+ * When a queued prompt may go, beyond "when nothing is in the way".
+ *
+ * The queue's default is as soon as it can, which is right for the next thing
+ * you want said. These are for the things you want said *later*: at an hour,
+ * once a goal is really on main rather than merely finished, or once CI has
+ * spoken. Each one is a fact the daemon can check — nothing here guesses.
+ */
+export type QueueCondition = 
+/** Not before this moment (epoch ms). */
+{
+    kind: "at";
+    at: number;
+}
+/** After the goal that was running when this was queued has LANDED. */
+ | {
+    kind: "landed";
+    runId: string;
+}
+/** After that goal's PR checks are green. */
+ | {
+    kind: "checks-green";
+    runId: string;
+}
+/** After this many ms with no agent working. */
+ | {
+    kind: "quiet";
+    ms: number;
+};
+export interface QueueItem {
+    id: string;
+    text: string;
+    target: QueueTarget;
+    /** The chat it was typed in — an agent's reply comes back there. */
+    chat: string;
+    plan?: boolean;
+    /** The reply length it was sent with (brief / detailed). */
+    length?: "brief" | "detailed";
+    source: "user" | "route";
+    at: number;
+    editedAt?: number;
+    /** Native continuity freezes its target model and idempotency key at enqueue. */
+    continuity?: {
+        requestId: string;
+        model: string | null;
+    };
+    /** Hold it back until this is true — see QueueCondition. */
+    when?: QueueCondition;
+}
+/** A condition from the wire, checked. */
+export declare function parseCondition(raw: unknown): QueueCondition | undefined;
+/** The condition in the words the queue shows. */
+export declare function describeCondition(c: QueueCondition): string;
+export interface QueueState {
+    items: QueueItem[];
+    paused: boolean;
+    /** Why it's paused, when it paused itself (a refused send, a Stop, a restart). */
+    reason?: string;
+}
+export interface QueueInput {
+    text: string;
+    target?: QueueTarget;
+    chat?: string;
+    plan?: boolean;
+    length?: "brief" | "detailed";
+    source?: "user" | "route";
+    when?: QueueCondition;
+    continuity?: QueueItem["continuity"];
+}
+export declare const MAX_QUEUE = 100;
+export declare const MAX_QUEUE_TEXT = 100000;
+/** A target from the wire: validated, so nothing downstream sees a shape it doesn't know. */
+export declare function parseTarget(raw: unknown): QueueTarget;
+export declare class PromptQueue {
+    private file;
+    private onChange;
+    private state;
+    private seq;
+    /** `file` null keeps it in memory (tests, projects with no .loom). */
+    constructor(file: string | null, onChange?: (s: QueueState) => void);
+    snapshot(): QueueState;
+    get paused(): boolean;
+    get length(): number;
+    peek(): QueueItem | undefined;
+    add(input: QueueInput): QueueItem;
+    assertCanAdd(input: QueueInput): void;
+    edit(id: string, patch: {
+        text?: string;
+        target?: QueueTarget;
+        plan?: boolean;
+        when?: QueueCondition | null;
+    }): QueueItem;
+    remove(id: string): void;
+    /** Move an item to position `to` (0 = next to run), clamped to the queue. */
+    move(id: string, to: number): void;
+    clear(): number;
+    setPaused(paused: boolean, reason?: string): void;
+    /** Take the head to send it. */
+    shift(): QueueItem | undefined;
+    /** Put a head that couldn't go back where it was. */
+    unshift(item: QueueItem): void;
+    private must;
+    private index;
+    private changed;
+}
+/** The item was already sent or removed — the UI raced the queue. */
+export declare class QueueItemGone extends Error {
+    constructor(id: string);
+}