@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/tui/pretty-identity.js

@@ -0,0 +1,112 @@
+/**
+ * pretty-mcp tape paint. Compact is the identity line; expand adds the
+ * block. Question while live/ask; effect when sealed. Uncovered tools
+ * stay on the hand identity. Gutter chrome is not this file.
+ */
+import { MCPToolJob, ProgrammaticJob, FileMutateToolJob } from "@inhuman.tools/harness-model";
+import { catalogIndex, renderTool, splitIdentity } from "@inhuman.tools/pretty-mcp";
+import { parseMcpWireName } from "./mcp-identity.js";
+import { sugarcoatProgram } from "./sugarcoat.js";
+const TOOLKIT = "harness-toolkit";
+/** Tape paint: toolkit + playwright. Other Smithery catalogs stay lookup-later. */
+const TAPE_SERVERS = new Set(["harness-toolkit", "playwright"]);
+function paintArgs(work, args) {
+    const name = work.name;
+    let next = args;
+    if ((name === "glob" || name === "fff_search") && args.cwd === undefined && typeof args.path === "string") {
+        next = { ...args, cwd: args.path };
+    }
+    if (name === "write_file") {
+        const existed = writeFileExisted(work);
+        if (existed !== undefined)
+            next = { ...next, existed };
+    }
+    return next;
+}
+/** Host-only. dist-tools.ts seals `created ` / `replaced `. Not a model argument. */
+function writeFileExisted(work) {
+    if (work.completed) {
+        const text = work.outcomeSnap?.ok === true ? work.outcomeSnap?.text : undefined;
+        if (typeof text === "string") {
+            if (text.startsWith("created "))
+                return false;
+            if (text.startsWith("replaced "))
+                return true;
+        }
+    }
+    if (work instanceof FileMutateToolJob) {
+        if (work.existed === true)
+            return true;
+        if (work.existed === false)
+            return false;
+    }
+    return undefined;
+}
+function argsOf(work) {
+    return { ...(work.args ?? {}) };
+}
+function catalogTool(server, tool) {
+    const needle = server.toLowerCase();
+    for (const file of catalogIndex().byId.values()) {
+        if (!TAPE_SERVERS.has(file.id))
+            continue;
+        if (file.id === server || file.id.toLowerCase() === needle || file.displayName.toLowerCase() === needle) {
+            return file.tools[tool];
+        }
+    }
+    return undefined;
+}
+function paint(server, tool, kind, args, result) {
+    const row = catalogTool(server, tool);
+    if (row === undefined)
+        return null;
+    const rendered = renderTool(row, kind, args, result);
+    if (!rendered.ok || rendered.markdown.trim() === "")
+        return null;
+    return splitIdentity(rendered.markdown);
+}
+export function prettyIdentity(work, kind) {
+    if (work instanceof ProgrammaticJob) {
+        return paint(TOOLKIT, "scheme_repl", kind, { expr: sugarcoatProgram(work.expr) });
+    }
+    const args = paintArgs(work, argsOf(work));
+    if (work instanceof MCPToolJob) {
+        const wired = parseMcpWireName(work.name);
+        const tool = work.serverToolName.trim() || wired.tool;
+        for (const server of [work.connectionKey.trim(), wired.server]) {
+            if (server === "")
+                continue;
+            const hit = paint(server, tool, kind, args);
+            if (hit !== null)
+                return hit;
+        }
+        return null;
+    }
+    return paint(TOOLKIT, work.name, kind, args);
+}
+export function prettyResult(work, result) {
+    if (work instanceof ProgrammaticJob) {
+        const hit = paint(TOOLKIT, "scheme_repl", "result", { expr: sugarcoatProgram(work.expr) }, result);
+        return hit === null ? null : [hit.line, hit.block].filter((part) => part !== "").join("\n");
+    }
+    const args = paintArgs(work, argsOf(work));
+    if (work instanceof MCPToolJob) {
+        const wired = parseMcpWireName(work.name);
+        const tool = work.serverToolName.trim() || wired.tool;
+        for (const server of [work.connectionKey.trim(), wired.server]) {
+            if (server === "")
+                continue;
+            const hit = paint(server, tool, "result", args, result);
+            if (hit !== null)
+                return [hit.line, hit.block].filter((part) => part !== "").join("\n");
+        }
+        return null;
+    }
+    const hit = paint(TOOLKIT, work.name, "result", args, result);
+    return hit === null ? null : [hit.line, hit.block].filter((part) => part !== "").join("\n");
+}
+/** Question templates end in `?`. The gutter owns that mark, not the sentence. */
+export function stripQuestion(line) {
+    return line.endsWith("?") ? line.slice(0, -1).trimEnd() : line;
+}
+//# sourceMappingURL=pretty-identity.js.map

package/dist/tui/pretty-identity.js.map

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

package/dist/tui/queue-shortcuts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Busy-turn omnibox hint. Slash and ask covers own their own chords;
+ * this list is only the leftover draft face.
+ */
+import { type SuperKey } from "@inhuman.tools/harness-model";
+import type { ChromeHotkey } from "@inhuman.tools/quickdraw/layout";
+export declare function busyDraftShortcuts(input: {
+    readonly draft: string;
+    readonly queued: number;
+    readonly retrying?: boolean;
+    readonly superKey?: SuperKey;
+}): ChromeHotkey[] | undefined;
+//# sourceMappingURL=queue-shortcuts.d.ts.map

package/dist/tui/queue-shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-shortcuts.d.ts","sourceRoot":"","sources":["../../src/tui/queue-shortcuts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAQpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,GAAG,YAAY,EAAE,GAAG,SAAS,CAU7B"}

package/dist/tui/queue-shortcuts.js

@@ -0,0 +1,23 @@
+/**
+ * Busy-turn omnibox hint. Slash and ask covers own their own chords;
+ * this list is only the leftover draft face.
+ */
+import { parseSuperKey } from "@inhuman.tools/harness-model";
+import { HOTKEY_EVENT, superChord } from "./ask-shortcuts.js";
+function hk(key, action, event) {
+    return { key, action, event };
+}
+export function busyDraftShortcuts(input) {
+    const retry = hk(superChord("Enter", parseSuperKey(input.superKey)), "retry now", HOTKEY_EVENT.retry);
+    if (input.draft.trim() !== "")
+        return [hk("Enter", "queue message", HOTKEY_EVENT.queueMessage)];
+    if (input.queued > 0) {
+        const steer = hk("Enter", "steer first", HOTKEY_EVENT.steerFirst);
+        const retract = { key: "Esc", action: "retract last queued" };
+        return input.retrying === true ? [steer, retry, retract] : [steer, retract];
+    }
+    if (input.retrying === true)
+        return [retry];
+    return undefined;
+}
+//# sourceMappingURL=queue-shortcuts.js.map

package/dist/tui/queue-shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-shortcuts.js","sourceRoot":"","sources":["../../src/tui/queue-shortcuts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAiB,MAAM,8BAA8B,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE9D,SAAS,EAAE,CAAC,GAAW,EAAE,MAAc,EAAE,KAAa;IACpD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAKlC;IACC,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACtG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IAChG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/tui/read-widen.d.ts

@@ -0,0 +1,14 @@
+export type FileReadWiden = {
+    readonly path: string;
+    readonly label: string;
+};
+/** One directory up. Undefined at `.` / `/` / `$HOME` / a volume root. */
+export declare function fileReadParent(prepared: string): string | undefined;
+export declare function fileReadWidenLabel(rootPath: string, parent: string): string;
+/**
+ * Suggest `parent(prepared)` when another observed extra-root read shares
+ * that parent (or *is* that parent). `observed` is allowlist keys plus
+ * other in-flight read paths — not denials.
+ */
+export declare function fileReadWiden(rootPath: string, prepared: string, observed: readonly string[]): FileReadWiden | undefined;
+//# sourceMappingURL=read-widen.d.ts.map

package/dist/tui/read-widen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-widen.d.ts","sourceRoot":"","sources":["../../src/tui/read-widen.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUnE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,aAAa,GAAG,SAAS,CAM3B"}

package/dist/tui/read-widen.js

@@ -0,0 +1,45 @@
+/**
+ * Extra-root read folder suggestion, as an explicit question: "Treat <folder> as part of this session?"
+ * One directory up, offered, never installed. Evidence is a same-parent sibling (an existing session
+ * root or an in-flight read). Disjoint trees stay a set — this is not LCA. A yes adds a session read
+ * root (`SessionRoot.addReadRoot`): reads under it follow the in-workspace rules, and block rules
+ * still block. A single outside read is never remembered, and writes are never a root.
+ */
+import { workspaceRelative } from "@inhuman.tools/harness-model";
+const HOME_TOP = new Set(["Users", "home", "Volumes", "private"]);
+/** One directory up. Undefined at `.` / `/` / `$HOME` / a volume root. */
+export function fileReadParent(prepared) {
+    if (prepared === "." || prepared === "/" || prepared === "")
+        return undefined;
+    const cut = prepared.lastIndexOf("/");
+    if (cut <= 0)
+        return undefined;
+    const parent = prepared.slice(0, cut);
+    if (parent === "/" || parent === "" || !parent.startsWith("/"))
+        return undefined;
+    const segs = parent.split("/").filter(Boolean);
+    if (segs.length < 2)
+        return undefined;
+    if (segs.length === 2 && HOME_TOP.has(segs[0]))
+        return undefined;
+    return parent;
+}
+export function fileReadWidenLabel(rootPath, parent) {
+    const rel = workspaceRelative(rootPath, parent);
+    return rel.length > 0 && rel.length < parent.length ? rel : parent;
+}
+/**
+ * Suggest `parent(prepared)` when another observed extra-root read shares
+ * that parent (or *is* that parent). `observed` is allowlist keys plus
+ * other in-flight read paths — not denials.
+ */
+export function fileReadWiden(rootPath, prepared, observed) {
+    const parent = fileReadParent(prepared);
+    if (parent === undefined)
+        return undefined;
+    const sibling = observed.some((path) => path !== prepared && (path === parent || fileReadParent(path) === parent));
+    if (!sibling)
+        return undefined;
+    return { path: parent, label: fileReadWidenLabel(rootPath, parent) };
+}
+//# sourceMappingURL=read-widen.js.map

package/dist/tui/read-widen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-widen.js","sourceRoot":"","sources":["../../src/tui/read-widen.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAOlE,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9E,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,MAAc;IACjE,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,QAAgB,EAChB,QAA2B;IAE3B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;IACnH,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/tui/rewind-chrome.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Neighbor prompt stacks and the 2-deep edge budget. Layout nodes only —
+ * Tea owns the pin list; assemble seats them.
+ */
+import { type LayoutNode } from "@inhuman.tools/quickdraw/layout";
+export type RewindNeighbor = {
+    readonly key: string;
+    readonly text: string;
+};
+export type RewindNeighborEdge = {
+    readonly side: "behind" | "ahead";
+    /** Quickdraw T-join past the 2-deep window. */
+    readonly moreOuter: boolean;
+};
+export declare function rewindNeighborSlots(aheadCount: number, behindCount: number): {
+    readonly ahead: number;
+    readonly behind: number;
+};
+export declare function compactPinDraft(prompt: string): string;
+/** Chrome stack: first frame 3 rows, each extra omitTop frame 2. */
+export declare function neighborColumnHeight(n: number): number;
+/** Past flex kept before neighbor rows are dropped. */
+export declare const REWIND_MIN_TAPE_ROWS = 4;
+export declare function dropOldestPastThenFarthestFuture(past: readonly RewindNeighbor[], future: readonly RewindNeighbor[], maxHeight: number): {
+    past: RewindNeighbor[];
+    future: RewindNeighbor[];
+};
+export declare function prepareRewindNeighbors(rows: readonly RewindNeighbor[], width: number, key: string, edge: RewindNeighborEdge): LayoutNode | null;
+//# sourceMappingURL=rewind-chrome.d.ts.map

package/dist/tui/rewind-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewind-chrome.d.ts","sourceRoot":"","sources":["../../src/tui/rewind-chrome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG1F,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKrD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CAUtD;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,kBAAkB,GACvB,UAAU,GAAG,IAAI,CAuCnB"}

package/dist/tui/rewind-chrome.js

@@ -0,0 +1,77 @@
+/**
+ * Neighbor prompt stacks and the 2-deep edge budget. Layout nodes only —
+ * Tea owns the pin list; assemble seats them.
+ */
+import { chromeFrameTotalHeight } from "@inhuman.tools/quickdraw/layout";
+import { ComposerFrame } from "@inhuman.tools/quickdraw/widgets";
+export function rewindNeighborSlots(aheadCount, behindCount) {
+    return {
+        ahead: Math.min(2, Math.max(0, aheadCount)),
+        behind: Math.min(2, Math.max(0, behindCount)),
+    };
+}
+export function compactPinDraft(prompt) {
+    const first = (prompt.split("\n")[0] ?? "").replaceAll(/\s+/g, " ").trim();
+    return prompt.includes("\n") ? `${first}…` : first;
+}
+/** Chrome stack: first frame 3 rows, each extra omitTop frame 2. */
+export function neighborColumnHeight(n) {
+    if (n <= 0)
+        return 0;
+    return chromeFrameTotalHeight(1) + (n - 1) * chromeFrameTotalHeight(1, { omitTop: true });
+}
+/** Past flex kept before neighbor rows are dropped. */
+export const REWIND_MIN_TAPE_ROWS = 4;
+export function dropOldestPastThenFarthestFuture(past, future, maxHeight) {
+    const budget = Math.max(0, Math.floor(maxHeight));
+    let behind = [...past];
+    let ahead = [...future];
+    while (neighborColumnHeight(behind.length) + neighborColumnHeight(ahead.length) > budget) {
+        if (behind.length > 0)
+            behind = behind.slice(1);
+        else if (ahead.length > 0)
+            ahead = ahead.slice(0, -1);
+        else
+            break;
+    }
+    return { past: behind, future: ahead };
+}
+export function prepareRewindNeighbors(rows, width, key, edge) {
+    if (rows.length === 0)
+        return null;
+    const n = rows.length;
+    return {
+        type: "flex",
+        regionProminence: 0.45,
+        key,
+        style: { direction: "column", gap: 0, width },
+        children: rows.map((row, i) => {
+            const first = i === 0;
+            const last = i === n - 1;
+            const omitTop = !first;
+            const joinTop = first && edge.side === "behind" && edge.moreOuter;
+            const joinBottom = edge.side === "behind" ? !last : !last || edge.moreOuter;
+            return {
+                type: "box",
+                key: row.key,
+                intent: "activate",
+                userSelect: "none",
+                children: [
+                    ComposerFrame({
+                        inputValue: compactPinDraft(row.text),
+                        interactive: false,
+                        readOnly: true,
+                    }, {
+                        key: `${row.key}:chrome`,
+                        width,
+                        omitTop,
+                        joinTop,
+                        joinBottom,
+                        plainBottom: true,
+                    }),
+                ],
+            };
+        }),
+    };
+}
+//# sourceMappingURL=rewind-chrome.js.map

package/dist/tui/rewind-chrome.js.map

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

package/dist/tui/rust-present.d.ts

@@ -0,0 +1,37 @@
+import type { Writable } from "node:stream";
+import type { BoxBusUpMessage } from "@inhuman.tools/quickdraw/runtime";
+import type { PaintDownMessage } from "./paint-transport.js";
+export declare function qdPackageName(platform: string, arch: string): string;
+export declare function resolveQdBinary(opts: {
+    platform: string;
+    arch: string;
+    devBinary: string;
+    resolvePackageJson: (spec: string) => string;
+    exists: (file: string) => boolean;
+    executable: (file: string) => boolean;
+}): string;
+export type RustPresent = {
+    writeDown(message: PaintDownMessage | {
+        kind: "title";
+        text: string;
+    } | {
+        kind: "phase";
+        text: string;
+    } | {
+        kind: "shutdown";
+    }): void;
+    geometry(): {
+        cols: number;
+        rows: number;
+    };
+    /** Shutdown frame, then wait. `SIGTERM` only if the child does not exit. */
+    restore(): Promise<void>;
+};
+export declare function qdBinary(): string;
+export declare function startRustPresent(opts: {
+    stderr: Writable;
+    onUp(message: BoxBusUpMessage): void;
+    onQuit(): void;
+    onFailed(reason: string): void;
+}): RustPresent;
+//# sourceMappingURL=rust-present.d.ts.map

package/dist/tui/rust-present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust-present.d.ts","sourceRoot":"","sources":["../../src/tui/rust-present.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAWD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,GAAG,MAAM,CAcT;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,CACP,OAAO,EACL,gBAAgB,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,GAC5G,IAAI,CAAC;IACR,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,wBAAgB,QAAQ,IAAI,MAAM,CAUjC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GAAG,WAAW,CA8Ed"}

package/dist/tui/rust-present.js

@@ -0,0 +1,205 @@
+/**
+ * The Rust process owns the terminal. This file is the pipe.
+ *
+ * Child stdin is length-prefixed frames (paint_init, paint_patch, title,
+ * phase, shutdown). Child stdout is length-prefixed frames back (input_events,
+ * resize, activate, quit, failed). The child opens `/dev/tty` itself.
+ */
+import { spawn } from "node:child_process";
+import { accessSync, constants, existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const FRAME_CAP = 32 * 1024 * 1024;
+/** Long enough for one poll and the destructor. Then `SIGTERM`, then `SIGKILL`. */
+const SHUTDOWN_GRACE_MS = 1000;
+const require = createRequire(import.meta.url);
+const CARGO_BUILD = "cargo build --release --manifest-path packages/quickdraw/rust/qd/Cargo.toml";
+export function qdPackageName(platform, arch) {
+    return `@inhuman.tools/qd-${platform}-${arch}`;
+}
+function canExecute(file) {
+    try {
+        accessSync(file, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveQdBinary(opts) {
+    const pkg = qdPackageName(opts.platform, opts.arch);
+    try {
+        // The name is built at runtime so the boundary checker does not see a static import.
+        const manifest = opts.resolvePackageJson(`${pkg}/package.json`);
+        const binary = path.join(path.dirname(manifest), "qd");
+        if (opts.exists(binary) && opts.executable(binary))
+            return binary;
+    }
+    catch {
+        // This platform's optional package is not installed.
+    }
+    if (opts.exists(opts.devBinary) && opts.executable(opts.devBinary))
+        return opts.devBinary;
+    throw new Error(`qd binary missing for ${opts.platform}-${opts.arch}. Expected ${pkg} or ${opts.devBinary}. Build it with ${CARGO_BUILD}`);
+}
+export function qdBinary() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return resolveQdBinary({
+        platform: process.platform,
+        arch: process.arch,
+        devBinary: path.resolve(here, "../../../quickdraw/rust/qd/target/release/qd"),
+        resolvePackageJson: (spec) => require.resolve(spec),
+        exists: existsSync,
+        executable: canExecute,
+    });
+}
+export function startRustPresent(opts) {
+    const held = holdWrites(opts.stderr);
+    const child = spawn(qdBinary(), [], {
+        stdio: ["pipe", "pipe", "inherit"],
+    });
+    const input = child.stdin;
+    const output = child.stdout;
+    if (input == null || output == null) {
+        throw new Error("qd stdio pipes were not created");
+    }
+    let cols = 80;
+    let rows = 24;
+    let restoring = null;
+    const pending = { buf: Buffer.alloc(0) };
+    output.on("data", (chunk) => {
+        pending.buf = Buffer.concat([pending.buf, chunk]);
+        for (;;) {
+            if (pending.buf.length < 4)
+                return;
+            const len = pending.buf.readUInt32LE(0);
+            if (len > FRAME_CAP) {
+                opts.onFailed("qd frame too large");
+                return;
+            }
+            if (pending.buf.length < 4 + len)
+                return;
+            const payload = pending.buf.subarray(4, 4 + len);
+            pending.buf = pending.buf.subarray(4 + len);
+            let message;
+            try {
+                message = JSON.parse(payload.toString("utf8"));
+            }
+            catch (error) {
+                opts.onFailed(error instanceof Error ? error.message : "qd frame");
+                return;
+            }
+            if (message.kind === "resize" && message.cols != null && message.rows != null) {
+                cols = message.cols;
+                rows = message.rows;
+            }
+            if (message.kind === "quit") {
+                opts.onQuit();
+                return;
+            }
+            if (message.kind === "failed") {
+                opts.onFailed(message.reason ?? "qd failed");
+                return;
+            }
+            if (message.kind === "input_events" ||
+                message.kind === "resize" ||
+                message.kind === "activate" ||
+                message.kind === "picker_activate" ||
+                message.kind === "picker_scroll" ||
+                message.kind === "agents_scroll" ||
+                message.kind === "agents_focus" ||
+                message.kind === "agents_hover" ||
+                message.kind === "submit") {
+                opts.onUp(message);
+            }
+        }
+    });
+    child.on("error", (error) => opts.onFailed(error.message));
+    child.on("exit", (code) => {
+        if (restoring === null && code !== 0 && code !== null)
+            opts.onFailed(`qd exit ${code}`);
+    });
+    return {
+        writeDown(message) {
+            writeFrame(input, Buffer.from(JSON.stringify(message)));
+        },
+        geometry() {
+            return { cols, rows };
+        },
+        restore() {
+            restoring ??= shutdownChild(child, input, held);
+            return restoring;
+        },
+    };
+}
+function shutdownChild(child, input, held) {
+    if (child.exitCode !== null || child.signalCode !== null) {
+        held.release();
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(term);
+            clearTimeout(kill);
+            held.release();
+            resolve();
+        };
+        const term = setTimeout(() => signal(child, "SIGTERM"), SHUTDOWN_GRACE_MS);
+        const kill = setTimeout(() => {
+            signal(child, "SIGKILL");
+            setTimeout(finish, SHUTDOWN_GRACE_MS);
+        }, SHUTDOWN_GRACE_MS * 2);
+        child.once("exit", finish);
+        try {
+            writeFrame(input, Buffer.from(JSON.stringify({ kind: "shutdown" })));
+        }
+        catch {
+            clearTimeout(term);
+            signal(child, "SIGTERM");
+        }
+    });
+}
+function signal(child, name) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    try {
+        child.kill(name);
+    }
+    catch {
+        /* already gone */
+    }
+}
+function writeFrame(stream, payload) {
+    const head = Buffer.alloc(4);
+    head.writeUInt32LE(payload.length, 0);
+    stream.write(head);
+    stream.write(payload);
+}
+function holdWrites(stream) {
+    const chunks = [];
+    const original = stream.write.bind(stream);
+    let released = false;
+    stream.write = ((chunk, encoding, cb) => {
+        const enc = typeof encoding === "string" ? encoding : "utf8";
+        const done = typeof encoding === "function" ? encoding : cb;
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk, enc) : Buffer.from(chunk));
+        done?.();
+        return true;
+    });
+    return {
+        release() {
+            if (released)
+                return;
+            released = true;
+            stream.write = original;
+            for (const chunk of chunks)
+                original(chunk);
+        },
+    };
+}
+//# sourceMappingURL=rust-present.js.map

package/dist/tui/rust-present.js.map

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

package/dist/tui/spinner-phase.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Wait-pin copy for the stalls that used to be a blank screen: `/new`
+ * (worker swap + three room syncs) and a cold `/model` catalog handshake.
+ * Paint already spins a live wait cell; these strings are the status.
+ */
+export declare const SPINNER_PHASE: {
+    readonly cancelTurn: "cancelling the turn...";
+    readonly closingSession: "closing the session...";
+    readonly openingSession: "opening the session...";
+    readonly syncingSession: "syncing the session...";
+    readonly syncingKernel: "syncing the kernel...";
+    readonly kernelOccupancy: "reading kernel occupancy...";
+    readonly syncingProject: "syncing the project...";
+    readonly applyingModel: "applying the model...";
+    readonly loadingModels: "loading models...";
+};
+export type SpinnerPhase = (typeof SPINNER_PHASE)[keyof typeof SPINNER_PHASE];
+/** Cold completion wire: interned, handshake not finished, catalog still empty. */
+export declare function coldModelCatalog(input: {
+    readonly connectionId: string;
+    readonly readyState: string | null;
+    readonly modelCount: number;
+}): boolean;
+//# sourceMappingURL=spinner-phase.d.ts.map

package/dist/tui/spinner-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-phase.d.ts","sourceRoot":"","sources":["../../src/tui/spinner-phase.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;CAUhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE9E,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAIV"}