@inhuman.tools/quickdraw 0.0.0-stage → 0.3.0

package/dist/measure/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ./index.js — display-column text width (terminal columns).
+ * Thin façade over string-width + grapheme-aware split.
+ *
+ * Dependency choice (2026-07 npm survey): string-width@8 — grapheme clusters
+ * via Intl.Segmenter, RGI/ZWJ emoji → 2 cols, combining/format → 0, TR11
+ * ambiguous-narrow default.
+ * Rejected: eastasianwidth (Ambiguous→2 breaks combining), wcwidth (stale),
+ * kitchen-sink TUI kits, Bun-only stringWidth.
+ *
+ * One module-level Segmenter. Per-call `new Intl.Segmenter` was ~27 ms of a
+ * 200×50 catalog paintFrame. ASCII + box/block drawing (U+2500–259F) is
+ * width-1 per code unit — slice, do not segment.
+ *
+ * TWO_COLUMN_SYMBOLS are Neutral under UAX #11 (string-width → 1) but the
+ * fonts we paint ink two cells. Layout width is 2. The mate is an emitted
+ * space, not a CJK placeholder: emit skips placeholders, and a wcwidth-1
+ * TTY would then draw the next glyph on top of the ink (⏎: Confirm).
+ */
+/** Printable ASCII, or box-drawing / block elements — one column per code unit. */
+export declare function isUnitWidthRun(text: string): boolean;
+/** Width-2 Neutral cluster whose mate must be an emitted space, not a CJK placeholder. */
+export declare function isTwoColumnSymbol(cluster: string): boolean;
+export type MeasureOpts = {
+    ambiguousIsNarrow?: boolean;
+    countAnsiEscapeCodes?: boolean;
+};
+export type Measure = (text: string) => number;
+export declare function displayWidth(text: string, opts?: MeasureOpts): number;
+/** Width of a single grapheme cluster (0 | 1 | 2+ via string-width). */
+export declare function graphemeWidth(cluster: string): number;
+/**
+ * First grapheme cluster. Unlike {@link splitAtWidth}(text, 1), a wide
+ * cluster is returned whole — paint walks must not drop ⏎ / CJK.
+ */
+export declare function takeGrapheme(text: string): [cluster: string, rest: string];
+/**
+ * Split `text` so `head` fits in `maxColumns` display columns.
+ * Never splits mid-grapheme-cluster.
+ */
+export declare function splitAtWidth(text: string, maxColumns: number): [head: string, tail: string];
+export declare const defaultMeasure: Measure;
+//# sourceMappingURL=index.d.ts.map

package/dist/measure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/measure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAmBH,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAS/C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAWrE;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAO1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAuB3F;AAED,eAAO,MAAM,cAAc,EAAE,OAAgC,CAAC"}

package/dist/measure/index.js

@@ -0,0 +1,120 @@
+/**
+ * ./index.js — display-column text width (terminal columns).
+ * Thin façade over string-width + grapheme-aware split.
+ *
+ * Dependency choice (2026-07 npm survey): string-width@8 — grapheme clusters
+ * via Intl.Segmenter, RGI/ZWJ emoji → 2 cols, combining/format → 0, TR11
+ * ambiguous-narrow default.
+ * Rejected: eastasianwidth (Ambiguous→2 breaks combining), wcwidth (stale),
+ * kitchen-sink TUI kits, Bun-only stringWidth.
+ *
+ * One module-level Segmenter. Per-call `new Intl.Segmenter` was ~27 ms of a
+ * 200×50 catalog paintFrame. ASCII + box/block drawing (U+2500–259F) is
+ * width-1 per code unit — slice, do not segment.
+ *
+ * TWO_COLUMN_SYMBOLS are Neutral under UAX #11 (string-width → 1) but the
+ * fonts we paint ink two cells. Layout width is 2. The mate is an emitted
+ * space, not a CJK placeholder: emit skips placeholders, and a wcwidth-1
+ * TTY would then draw the next glyph on top of the ink (⏎: Confirm).
+ */
+import stringWidth from "string-width";
+const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, {
+    granularity: "grapheme",
+});
+/**
+ * Code points that occupy two columns in product fonts while remaining
+ * East-Asian-width Neutral. Add a code point here when a glyph overlaps
+ * the next cell; do not add true double-width (CJK / RGI emoji).
+ */
+const TWO_COLUMN_SYMBOLS = new Set([
+    0x23_ce, // RETURN SYMBOL
+    0x24_aa, // scheme_repl
+    0x24_b2, // scheme_watch
+]);
+/** Printable ASCII, or box-drawing / block elements — one column per code unit. */
+export function isUnitWidthRun(text) {
+    for (let i = 0; i < text.length; i++) {
+        const c = text.charCodeAt(i);
+        if (c >= 0x20 && c <= 0x7e)
+            continue;
+        if (c >= 0x25_00 && c <= 0x25_9f)
+            continue;
+        return false;
+    }
+    return true;
+}
+/** Width-2 Neutral cluster whose mate must be an emitted space, not a CJK placeholder. */
+export function isTwoColumnSymbol(cluster) {
+    if (cluster.length === 0)
+        return false;
+    const cp = cluster.codePointAt(0);
+    if (cp === undefined || !TWO_COLUMN_SYMBOLS.has(cp))
+        return false;
+    return cluster.length === String.fromCodePoint(cp).length;
+}
+function stringWidthOf(text, opts) {
+    return stringWidth(text, {
+        ambiguousIsNarrow: opts?.ambiguousIsNarrow ?? true,
+        countAnsiEscapeCodes: opts?.countAnsiEscapeCodes ?? false,
+    });
+}
+export function displayWidth(text, opts) {
+    const w = stringWidthOf(text, opts);
+    if (w === 0 || isUnitWidthRun(text))
+        return w;
+    let boost = 0;
+    for (const ch of text) {
+        const cp = ch.codePointAt(0);
+        if (cp === undefined || !TWO_COLUMN_SYMBOLS.has(cp))
+            continue;
+        const native = stringWidthOf(ch, opts);
+        if (native < 2)
+            boost += 2 - native;
+    }
+    return w + boost;
+}
+/** Width of a single grapheme cluster (0 | 1 | 2+ via string-width). */
+export function graphemeWidth(cluster) {
+    return displayWidth(cluster);
+}
+/**
+ * First grapheme cluster. Unlike {@link splitAtWidth}(text, 1), a wide
+ * cluster is returned whole — paint walks must not drop ⏎ / CJK.
+ */
+export function takeGrapheme(text) {
+    if (text.length === 0)
+        return ["", ""];
+    if (isUnitWidthRun(text))
+        return [text[0], text.slice(1)];
+    for (const { segment } of GRAPHEME_SEGMENTER.segment(text)) {
+        return [segment, text.slice(segment.length)];
+    }
+    return ["", ""];
+}
+/**
+ * Split `text` so `head` fits in `maxColumns` display columns.
+ * Never splits mid-grapheme-cluster.
+ */
+export function splitAtWidth(text, maxColumns) {
+    if (maxColumns <= 0) {
+        return ["", text];
+    }
+    if (isUnitWidthRun(text)) {
+        if (text.length <= maxColumns)
+            return [text, ""];
+        return [text.slice(0, maxColumns), text.slice(maxColumns)];
+    }
+    let used = 0;
+    let headEnd = 0;
+    for (const { segment, index } of GRAPHEME_SEGMENTER.segment(text)) {
+        const w = displayWidth(segment);
+        if (used + w > maxColumns) {
+            return [text.slice(0, headEnd), text.slice(headEnd)];
+        }
+        used += w;
+        headEnd = index + segment.length;
+    }
+    return [text, ""];
+}
+export const defaultMeasure = (t) => displayWidth(t);
+//# sourceMappingURL=index.js.map

package/dist/measure/index.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,72 @@
+/**
+ * UI-thread face: probe + attune + TTY enter + Renderer.
+ * Teardown is split — do not collapse into one stop().
+ */
+import type { Readable, Writable } from "node:stream";
+import { type ThemeBinding } from "./layout/paint_theme.js";
+import type { PaintLocal, RetainedPaintSource } from "./runtime/paint_source.js";
+import { type PresentConfig } from "./runtime/present_profile.js";
+import { type BoxCadencePort, type TtyInput, type TtyOutput } from "./runtime/renderer.js";
+import { type TtyOptions } from "./runtime/tty.js";
+/** OSC 11 wait — too short only means default ground (wrong one direction). */
+export declare const GROUND_PROBE_TIMEOUT_MS = 80;
+/** Post-probe / pre-exit stdin drain — late DA1/OSC11 must not reach the shell. */
+export declare const STDIN_DRAIN_MS = 50;
+export type AttuneStdin = Readable & {
+    readonly isTTY?: boolean;
+    setRawMode?(mode: boolean): void;
+};
+export type AttuneStdout = Writable & {
+    readonly isTTY?: boolean;
+};
+/** process.stderr / test stream — held while alt-screen occupies the glass. */
+export type AttuneStderr = Writable & {
+    readonly isTTY?: boolean;
+};
+/** process.stdout / test stream — columns + resize for the cadence output face. */
+export type StdioStdout = AttuneStdout & {
+    columns?: number;
+    rows?: number;
+    on?(event: "resize", listener: () => void): unknown;
+};
+/** stdin → {@link TtyInput}. Same adapter the harness host uses. */
+export declare function processStdioInput(stdin: AttuneStdin): TtyInput;
+/** stdout → {@link TtyOutput}. */
+export declare function processStdioOutput(stdout: StdioStdout): TtyOutput;
+export interface StartRenderOptions {
+    readonly stdin: AttuneStdin;
+    readonly stdout: AttuneStdout;
+    /** Held during alt-screen when both this and stdout are TTYs. Default process.stderr. */
+    readonly stderr?: AttuneStderr;
+    readonly port: BoxCadencePort;
+    readonly input: TtyInput;
+    readonly output: TtyOutput;
+    readonly targetFps?: number;
+    readonly onQuit?: () => void;
+    /** Armed Ctrl-C hint. Default `"exit"`. */
+    readonly quitAction?: () => string;
+    readonly onReady?: () => void;
+    readonly onFirstPaint?: () => void;
+    readonly composerBoxKey?: string;
+    readonly composerFrameKey?: string;
+    readonly paintSource?: RetainedPaintSource;
+    readonly paintLocal?: PaintLocal;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly timeoutMs?: number;
+    readonly tty?: TtyOptions;
+}
+export interface RenderHandle {
+    stop(): void;
+    restore(): void;
+}
+export interface AttunedBoot {
+    readonly binding: ThemeBinding;
+    readonly present: PresentConfig;
+}
+/**
+ * Read-and-discard stdin briefly. Call while still owning the TTY (ideally raw)
+ * so late capability replies never land as shell-prompt garbage.
+ */
+export declare function drainStdinQuiet(stdin: AttuneStdin, ms?: number): Promise<void>;
+export declare function startRender(opts: StartRenderOptions): Promise<RenderHandle>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

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

package/dist/render.js

@@ -0,0 +1,164 @@
+import { detectCapabilities } from "./capabilities/index.js";
+import { attuneTheme, setActiveTheme, setColorDepth } from "./layout/paint_theme.js";
+import { resolvePresentConfig } from "./runtime/present_profile.js";
+import { Renderer } from "./runtime/renderer.js";
+import { holdStderr } from "./runtime/stderr_hold.js";
+import { createTtySession } from "./runtime/tty.js";
+import { canvasPolarity } from "./theme/ansi16.js";
+import { bootSyntax } from "./widgets/syntax-boot.js";
+/** OSC 11 wait — too short only means default ground (wrong one direction). */
+export const GROUND_PROBE_TIMEOUT_MS = 80;
+/** Post-probe / pre-exit stdin drain — late DA1/OSC11 must not reach the shell. */
+export const STDIN_DRAIN_MS = 50;
+/** stdin → {@link TtyInput}. Same adapter the harness host uses. */
+export function processStdioInput(stdin) {
+    return {
+        onData(handler) {
+            if (typeof stdin.setEncoding === "function")
+                stdin.setEncoding("utf8");
+            stdin.resume();
+            stdin.on("data", (chunk) => handler(chunk));
+        },
+        setRawMode(enabled) {
+            if (stdin.isTTY)
+                stdin.setRawMode?.(enabled);
+        },
+    };
+}
+/** stdout → {@link TtyOutput}. */
+export function processStdioOutput(stdout) {
+    return {
+        write(text) {
+            stdout.write(text);
+        },
+        get cols() {
+            return stdout.columns ?? 80;
+        },
+        get rows() {
+            return stdout.rows ?? 24;
+        },
+        onResize(handler) {
+            stdout.on?.("resize", handler);
+        },
+    };
+}
+/**
+ * Read-and-discard stdin briefly. Call while still owning the TTY (ideally raw)
+ * so late capability replies never land as shell-prompt garbage.
+ */
+export function drainStdinQuiet(stdin, ms = STDIN_DRAIN_MS) {
+    if (!stdin.isTTY)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const onData = () => {
+            /* discard */
+        };
+        stdin.resume();
+        stdin.on("data", onData);
+        setTimeout(() => {
+            stdin.off("data", onData);
+            resolve();
+        }, ms);
+    });
+}
+async function probeAndAttune(stdin, stdout, env, timeoutMs) {
+    const setRawMode = typeof stdin.isTTY === "boolean" && stdin.isTTY && typeof stdin.setRawMode === "function"
+        ? stdin.setRawMode.bind(stdin)
+        : null;
+    if (setRawMode) {
+        try {
+            setRawMode(true);
+        }
+        catch {
+            /* non-fatal: probe still runs; echo risk remains */
+        }
+    }
+    let binding;
+    let present;
+    try {
+        try {
+            const { caps } = await detectCapabilities({
+                stdin,
+                stdout,
+                env,
+                timeoutMs,
+                batch: true,
+            });
+            present = resolvePresentConfig({
+                env,
+                probedDepth: caps.colorDepth,
+                probedSync2026: caps.sync2026,
+            });
+            const rgb = caps.groundRgb;
+            binding = attuneTheme({
+                depth: present.colorDepth,
+                groundRgb: rgb,
+            });
+        }
+        catch {
+            present = resolvePresentConfig({ env });
+            binding = attuneTheme({ depth: present.colorDepth });
+        }
+        await drainStdinQuiet(stdin, STDIN_DRAIN_MS);
+    }
+    finally {
+        if (setRawMode) {
+            try {
+                setRawMode(false);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+    setActiveTheme(binding.theme);
+    setColorDepth(binding.depth);
+    return { binding, present };
+}
+export async function startRender(opts) {
+    const env = opts.env ?? process.env;
+    const { binding, present } = await probeAndAttune(opts.stdin, opts.stdout, env, opts.timeoutMs ?? GROUND_PROBE_TIMEOUT_MS);
+    // Same law as `fx`: per-frame 2026 unless QD_SYNC=0. Probe does not
+    // turn the bracket off — that is what made storybook look vsync-off.
+    const sync2026 = opts.tty?.sync2026 ?? env.QD_SYNC !== "0";
+    const tty = createTtySession(opts.tty ?? {
+        sync2026,
+    });
+    const stderr = opts.stderr ?? process.stderr;
+    const hold = opts.stdout.isTTY === true && stderr.isTTY === true ? holdStderr(stderr) : null;
+    opts.stdout.write(tty.enterBytes());
+    tty.markEntered();
+    const host = new Renderer({
+        port: opts.port,
+        input: opts.input,
+        output: opts.output,
+        theme: binding,
+        targetFps: opts.targetFps ?? present.targetFps,
+        flourishHz: present.flourishHz,
+        sync2026,
+        onQuit: opts.onQuit,
+        quitAction: opts.quitAction,
+        onReady: opts.onReady,
+        onFirstPaint: opts.onFirstPaint,
+        composerBoxKey: opts.composerBoxKey,
+        composerFrameKey: opts.composerFrameKey,
+        paintSource: opts.paintSource,
+        paintLocal: opts.paintLocal,
+    });
+    host.start();
+    void bootSyntax(canvasPolarity(binding.theme.ground)).then(() => host.requestPaint());
+    return {
+        stop() {
+            host.stop();
+        },
+        restore() {
+            if (tty.entered) {
+                opts.stdout.write(tty.exitBytes());
+                tty.markExited();
+            }
+            // After leave-alt — held bytes must land on the primary screen.
+            hold?.release();
+        },
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/runtime/agents_keys.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Drawer row keys are `session:<id>`, `call:<id>`, `bot:<id>`. Paint
+ * children append a suffix (`:name`, `:id-line`, …). Hits report the
+ * child; restore / hover want the row key.
+ */
+export declare function agentsRowKeyFromHit(key: string): string | null;
+export declare function sessionIdFromAgentsKey(key: string): string | null;
+//# sourceMappingURL=agents_keys.d.ts.map

package/dist/runtime/agents_keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents_keys.d.ts","sourceRoot":"","sources":["../../src/runtime/agents_keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKjE"}

package/dist/runtime/agents_keys.js

@@ -0,0 +1,24 @@
+/**
+ * Drawer row keys are `session:<id>`, `call:<id>`, `bot:<id>`. Paint
+ * children append a suffix (`:name`, `:id-line`, …). Hits report the
+ * child; restore / hover want the row key.
+ */
+const SESSION_PREFIX = "session:";
+const ROW = /^(session|call|bot):/;
+const CHILD = /(?::name|:id-line|:id-row|:id|:title|:mark|:status|:recap|:indent|:dive:\d+)$/;
+export function agentsRowKeyFromHit(key) {
+    if (key.includes(":gap:") || !ROW.test(key))
+        return null;
+    let cur = key;
+    while (CHILD.test(cur))
+        cur = cur.replace(CHILD, "");
+    return ROW.test(cur) && cur !== "session:" && cur !== "call:" && cur !== "bot:" ? cur : null;
+}
+export function sessionIdFromAgentsKey(key) {
+    const row = agentsRowKeyFromHit(key);
+    if (!row?.startsWith(SESSION_PREFIX))
+        return null;
+    const id = row.slice(SESSION_PREFIX.length).trim();
+    return id === "" ? null : id;
+}
+//# sourceMappingURL=agents_keys.js.map

package/dist/runtime/agents_keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents_keys.js","sourceRoot":"","sources":["../../src/runtime/agents_keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,cAAc,GAAG,UAAU,CAAC;AAClC,MAAM,GAAG,GAAG,sBAAsB,CAAC;AACnC,MAAM,KAAK,GAAG,+EAA+E,CAAC;AAE9F,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC"}

package/dist/runtime/agents_peek.d.ts

@@ -0,0 +1,44 @@
+import type { LayoutNode } from "../layout/types.js";
+export declare const APP_AGENTS_PEEK_KEY = "agents:peek";
+export declare const APP_AGENTS_PEEK_OVERLAY_KEY = "agents:peek-overlay";
+/** Gap between the drawer panel and the peek. */
+export declare const AGENTS_PEEK_GAP = 1;
+/** Gap between the peek's right edge and the viewport. */
+export declare const AGENTS_PEEK_RIGHT_MARGIN = 1;
+/** Plaque height including pad. */
+export declare const AGENTS_PEEK_MAX_HEIGHT = 9;
+export type AgentsPeekPlace = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    side: "down" | "up";
+};
+export declare function placeAgentsPeek(args: {
+    anchor: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    panel: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    cols: number;
+    rows: number;
+    size: {
+        w: number;
+        h: number;
+    };
+}): AgentsPeekPlace | null;
+export declare function withAgentsPeek(args: {
+    root: LayoutNode;
+    peek: LayoutNode;
+    focusKey: string;
+    cols: number;
+    rows: number;
+}): LayoutNode;
+//# sourceMappingURL=agents_peek.d.ts.map

package/dist/runtime/agents_peek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents_peek.d.ts","sourceRoot":"","sources":["../../src/runtime/agents_peek.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,iDAAiD;AACjD,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,mCAAmC;AACnC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,GAAG,eAAe,GAAG,IAAI,CAwBzB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,UAAU,CAyCb"}

package/dist/runtime/agents_peek.js

@@ -0,0 +1,96 @@
+/**
+ * Agents-drawer peek — same-fill plaque next to the focused row.
+ *
+ * Placement is the copy-toast grain: prefer top-aligned to the anchor,
+ * flip to bottom-align when that hangs off the viewport, then clamp.
+ * Horizontal seat is 1 cell off the panel's right edge, and 1 cell
+ * in from the viewport's right edge. No rim.
+ */
+import { layout } from "../layout/engine.js";
+import { measureNode } from "../layout/measure.js";
+export const APP_AGENTS_PEEK_KEY = "agents:peek";
+export const APP_AGENTS_PEEK_OVERLAY_KEY = "agents:peek-overlay";
+/** Gap between the drawer panel and the peek. */
+export const AGENTS_PEEK_GAP = 1;
+/** Gap between the peek's right edge and the viewport. */
+export const AGENTS_PEEK_RIGHT_MARGIN = 1;
+/** Plaque height including pad. */
+export const AGENTS_PEEK_MAX_HEIGHT = 9;
+export function placeAgentsPeek(args) {
+    const right = args.panel.x + args.panel.w + AGENTS_PEEK_GAP;
+    const maxW = Math.max(0, args.cols - right - AGENTS_PEEK_RIGHT_MARGIN);
+    if (maxW < 1 || args.rows < 1)
+        return null;
+    const w = Math.min(Math.max(1, args.size.w), maxW);
+    const h = Math.min(Math.max(1, args.size.h), args.rows);
+    const x = clamp(right, 0, Math.max(0, args.cols - w - AGENTS_PEEK_RIGHT_MARGIN));
+    const downY = args.anchor.y;
+    const upY = args.anchor.y + args.anchor.h - h;
+    const downFits = downY >= 0 && downY + h <= args.rows;
+    const upFits = upY >= 0 && upY + h <= args.rows;
+    let side;
+    let y;
+    if (downFits) {
+        side = "down";
+        y = downY;
+    }
+    else if (upFits) {
+        side = "up";
+        y = upY;
+    }
+    else {
+        side = "down";
+        y = clamp(downY, 0, Math.max(0, args.rows - h));
+    }
+    return { x, y, w, h, side };
+}
+export function withAgentsPeek(args) {
+    if (args.root.type !== "box")
+        return args.root;
+    const frame = layout(args.root, { w: args.cols, h: args.rows });
+    const panel = frame.byKey.get("agents:panel");
+    const anchor = frame.byKey.get(args.focusKey);
+    if (panel === undefined || anchor === undefined)
+        return args.root;
+    if (anchor.hitRect.w < 1 || anchor.hitRect.h < 1)
+        return args.root;
+    const room = args.cols - (panel.hitRect.x + panel.hitRect.w) - AGENTS_PEEK_GAP - AGENTS_PEEK_RIGHT_MARGIN;
+    if (room < 1)
+        return args.root;
+    const measured = measureNode(args.peek, room, args.rows);
+    const size = {
+        w: Math.max(1, measured.w),
+        h: Math.min(Math.max(1, measured.h), AGENTS_PEEK_MAX_HEIGHT, args.rows),
+    };
+    const place = placeAgentsPeek({
+        anchor: anchor.hitRect,
+        panel: panel.hitRect,
+        cols: args.cols,
+        rows: args.rows,
+        size,
+    });
+    if (place === null)
+        return args.root;
+    const peek = args.peek.type === "box"
+        ? {
+            ...args.peek,
+            style: { ...args.peek.style, width: place.w, height: place.h, overflow: "hidden" },
+        }
+        : args.peek;
+    return {
+        ...args.root,
+        children: [
+            ...(args.root.children ?? []),
+            {
+                type: "overlay",
+                key: APP_AGENTS_PEEK_OVERLAY_KEY,
+                origin: { x: place.x, y: place.y },
+                children: [peek],
+            },
+        ],
+    };
+}
+function clamp(n, lo, hi) {
+    return Math.min(hi, Math.max(lo, n));
+}
+//# sourceMappingURL=agents_peek.js.map

package/dist/runtime/agents_peek.js.map

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

package/dist/runtime/agents_preview.d.ts

@@ -0,0 +1,25 @@
+import type { LayoutNode } from "../layout/types.js";
+export declare const APP_AGENTS_PREVIEW_OVERLAY_KEY = "agents:preview-overlay";
+export declare const APP_AGENTS_PREVIEW_KEY = "agents:preview";
+export declare const APP_AGENTS_PREVIEW_CHROME_KEY = "agents:preview:chrome";
+export declare const APP_AGENTS_PREVIEW_BODY_KEY = "agents:preview:body";
+export declare const APP_AGENTS_PREVIEW_VIEWPORT_KEY = "agents:preview:viewport";
+export declare const APP_AGENTS_PREVIEW_TAPE_KEY = "agents:preview:tape";
+/** Viewport fraction for the peek modal. */
+export declare const AGENTS_PREVIEW_SCALE = 0.9;
+export declare function agentsPreviewRect(cols: number, rows: number): {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+};
+export declare function withAgentsPreview(args: {
+    readonly root: LayoutNode;
+    readonly tape: LayoutNode;
+    readonly cols: number;
+    readonly rows: number;
+    readonly title?: string;
+    readonly scroll?: number;
+    readonly atBottom?: boolean;
+}): LayoutNode;
+//# sourceMappingURL=agents_preview.d.ts.map

package/dist/runtime/agents_preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents_preview.d.ts","sourceRoot":"","sources":["../../src/runtime/agents_preview.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAcrD,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AACvE,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,eAAO,MAAM,6BAA6B,0BAA0B,CAAC;AACrE,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,+BAA+B,4BAA4B,CAAC;AACzE,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AAEjE,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAIxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CASpF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,UAAU,CA8Eb"}