@deepseek-harness-tui/dsh-tui 0.5.0

package/lib/types/childStderr.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Child-process stderr guard (issue #17).
+ *
+ * MCP servers spawned through `@deepseek-ai/dsh-mcp-client` run under the MCP
+ * SDK's `StdioClientTransport`, whose stderr defaults to `'inherit'`
+ * (`stdio: ['pipe', 'pipe', server.stderr ?? 'inherit']`). An inherited fd 2
+ * is written by the CHILD process straight to the terminal device — those
+ * bytes never pass through this process's patched `process.stderr.write`
+ * (see `ink.tsx` patchStderr), so they land at the parked cursor, scroll the
+ * alt-screen, and interleave with the diff renderer's absolute-coordinate
+ * writes. A server in a reconnect loop (e.g. a proxy repeatedly printing
+ * `Error: Non-HTTPS URLs ...` + its usage line) turns that into the
+ * overlapping garbage shown in the issue screenshot.
+ *
+ * The guard patches `child_process.spawn` and rewrites requests whose stderr
+ * would be inherited (`'inherit'` as the whole-stdio string, stdio array slot
+ * 2, or raw fd 2) to a pipe, then drains the pipe line by line into a sink.
+ * Only fd 2 is touched; stdin/stdout keep their requested modes, so MCP's
+ * JSON-RPC stdio channel is unaffected.
+ *
+ * Reachability note: the MCP SDK spawns via `cross-spawn`, which reads
+ * `child_process.spawn` off the CJS exports object at call time, so this
+ * patch covers it (verified by scripts/verify-child-stderr.tsx). A consumer
+ * holding a snapshotted ESM named import (`import { spawn } from
+ * 'node:child_process'`) would bypass the patch — no known consumer in the
+ * dependency tree does that.
+ */
+/**
+ * Take over inherited child stderr for the TUI's lifetime: any `spawn` whose
+ * stderr would hit the terminal directly is piped and drained into `sink`
+ * instead. Returns a restore function that reverts the patch; in-flight
+ * children keep their (already piped) streams.
+ */
+export declare function installChildStderrGuard(sink: (line: string) => void): () => void;
+/** Notification callback signature — structurally `Channel['notify']`. */
+export interface ChildStderrNotify {
+    (text: string, options?: {
+        color?: 'error' | 'warning' | 'success';
+        timeoutMs?: number;
+    }): void;
+}
+export interface ChildStderrReporterOptions {
+    /** Quiet window that batches a burst of repeats into one notice (default 1500ms). */
+    debounceMs?: number;
+    /** After a notice, the same line stays silent for this long (default 30s). */
+    cooldownMs?: number;
+    /** Single-line length cap; longer lines are truncated with an ellipsis (default 200). */
+    maxLineLength?: number;
+}
+export interface ChildStderrReporter {
+    /** Feed one raw stderr line. */
+    push(line: string): void;
+    /** Cancel pending debounce timers (teardown). */
+    dispose(): void;
+}
+/**
+ * Turn a raw child-stderr line stream into bounded, deduplicated
+ * notifications: identical lines inside a short debounce window collapse into
+ * one "（重复 N 次）" notice, and a line that was just shown stays silent for
+ * a cooldown so a failing reconnect loop can't spam the status area.
+ */
+export declare function createChildStderrReporter(notify: ChildStderrNotify, options?: ChildStderrReporterOptions): ChildStderrReporter;
+//# sourceMappingURL=childStderr.d.ts.map

package/lib/types/childStderr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"childStderr.d.ts","sourceRoot":"","sources":["../../src/childStderr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAsDH;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CA8BhF;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAChG;AAED,MAAM,WAAW,0BAA0B;IACzC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CA4CrB"}

package/lib/types/childStderr.js

@@ -0,0 +1,161 @@
+/**
+ * Child-process stderr guard (issue #17).
+ *
+ * MCP servers spawned through `@deepseek-ai/dsh-mcp-client` run under the MCP
+ * SDK's `StdioClientTransport`, whose stderr defaults to `'inherit'`
+ * (`stdio: ['pipe', 'pipe', server.stderr ?? 'inherit']`). An inherited fd 2
+ * is written by the CHILD process straight to the terminal device — those
+ * bytes never pass through this process's patched `process.stderr.write`
+ * (see `ink.tsx` patchStderr), so they land at the parked cursor, scroll the
+ * alt-screen, and interleave with the diff renderer's absolute-coordinate
+ * writes. A server in a reconnect loop (e.g. a proxy repeatedly printing
+ * `Error: Non-HTTPS URLs ...` + its usage line) turns that into the
+ * overlapping garbage shown in the issue screenshot.
+ *
+ * The guard patches `child_process.spawn` and rewrites requests whose stderr
+ * would be inherited (`'inherit'` as the whole-stdio string, stdio array slot
+ * 2, or raw fd 2) to a pipe, then drains the pipe line by line into a sink.
+ * Only fd 2 is touched; stdin/stdout keep their requested modes, so MCP's
+ * JSON-RPC stdio channel is unaffected.
+ *
+ * Reachability note: the MCP SDK spawns via `cross-spawn`, which reads
+ * `child_process.spawn` off the CJS exports object at call time, so this
+ * patch covers it (verified by scripts/verify-child-stderr.tsx). A consumer
+ * holding a snapshotted ESM named import (`import { spawn } from
+ * 'node:child_process'`) would bypass the patch — no known consumer in the
+ * dependency tree does that.
+ */
+import childProcess from 'node:child_process';
+import { t } from './i18n.js';
+/** Strip ANSI escape sequences (CSI/OSC) so raw child output can't inject
+ *  cursor moves or colors into the notification area. */
+// eslint-disable-next-line no-control-regex -- intentional: matching terminal escape sequences
+const ANSI_PATTERN = /[\u001b\u009b][[\]()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><~]|\u001b\][^\u0007\u001b]*(?:\u0007|\u001b\\)/g;
+/**
+ * Rewrite spawn options so an inherited stderr (fd 2) becomes a pipe.
+ * Returns the adjusted options, or undefined when stderr is not inherited
+ * (default/'pipe'/'ignore'/explicit stream) and the spawn needs no takeover.
+ */
+function redirectInheritedStderr(options) {
+    const stdio = options.stdio;
+    if (stdio === undefined || stdio === null)
+        return undefined;
+    if (typeof stdio === 'string') {
+        // The string form applies to all three fds; keep stdin/stdout inherited.
+        if (stdio !== 'inherit')
+            return undefined;
+        return { ...options, stdio: ['inherit', 'inherit', 'pipe'] };
+    }
+    if (Array.isArray(stdio)) {
+        // A short array leaves fd 2 at the 'pipe' default — already safe.
+        const stderr = stdio[2];
+        if (stderr !== 'inherit' && stderr !== 2)
+            return undefined;
+        const next = [...stdio];
+        next[2] = 'pipe';
+        return { ...options, stdio: next };
+    }
+    return undefined;
+}
+/** Drain a piped stderr stream, forwarding complete lines (and the unterminated tail) to the sink. */
+function drainLines(stream, sink) {
+    let pending = '';
+    stream.on('data', (chunk) => {
+        pending += chunk.toString();
+        let newline = pending.indexOf('\n');
+        while (newline >= 0) {
+            sink(pending.slice(0, newline));
+            pending = pending.slice(newline + 1);
+            newline = pending.indexOf('\n');
+        }
+    });
+    stream.on('end', () => {
+        if (pending.length > 0)
+            sink(pending);
+    });
+    stream.on('error', () => {
+        // A broken stderr pipe must never take the TUI down.
+    });
+}
+/**
+ * Take over inherited child stderr for the TUI's lifetime: any `spawn` whose
+ * stderr would hit the terminal directly is piped and drained into `sink`
+ * instead. Returns a restore function that reverts the patch; in-flight
+ * children keep their (already piped) streams.
+ */
+export function installChildStderrGuard(sink) {
+    const original = childProcess.spawn;
+    const patched = function (command, argsOrOptions, maybeOptions) {
+        let args;
+        let options;
+        if (Array.isArray(argsOrOptions)) {
+            args = argsOrOptions;
+            options = maybeOptions ?? {};
+        }
+        else {
+            args = [];
+            // Array.isArray doesn't exclude `readonly string[]` in the else branch.
+            options = argsOrOptions ?? maybeOptions ?? {};
+        }
+        const redirected = redirectInheritedStderr(options);
+        const child = original.call(childProcess, command, args, redirected ?? options);
+        if (redirected !== undefined && child.stderr !== null) {
+            drainLines(child.stderr, sink);
+        }
+        return child;
+    };
+    childProcess.spawn = patched;
+    return () => {
+        if (childProcess.spawn === patched) {
+            childProcess.spawn = original;
+        }
+    };
+}
+/**
+ * Turn a raw child-stderr line stream into bounded, deduplicated
+ * notifications: identical lines inside a short debounce window collapse into
+ * one "（重复 N 次）" notice, and a line that was just shown stays silent for
+ * a cooldown so a failing reconnect loop can't spam the status area.
+ */
+export function createChildStderrReporter(notify, options = {}) {
+    const debounceMs = options.debounceMs ?? 1500;
+    const cooldownMs = options.cooldownMs ?? 30_000;
+    const maxLineLength = options.maxLineLength ?? 200;
+    const groups = new Map();
+    const mutedUntil = new Map();
+    return {
+        push(raw) {
+            const cleaned = raw.replace(ANSI_PATTERN, '').trim();
+            if (cleaned.length === 0)
+                return;
+            const line = cleaned.length > maxLineLength ? `${cleaned.slice(0, maxLineLength)}…` : cleaned;
+            const existing = groups.get(line);
+            if (existing !== undefined) {
+                existing.count += 1;
+                clearTimeout(existing.timer);
+                existing.timer = setTimeout(flush, debounceMs);
+                return;
+            }
+            groups.set(line, { count: 1, timer: setTimeout(flush, debounceMs) });
+            function flush() {
+                const group = groups.get(line);
+                if (group === undefined)
+                    return;
+                groups.delete(line);
+                // A burst inside the cooldown window is counted but stays silent.
+                if ((mutedUntil.get(line) ?? 0) > Date.now())
+                    return;
+                mutedUntil.set(line, Date.now() + cooldownMs);
+                const text = group.count > 1
+                    ? t('child-stderr-line-repeat', { line, count: group.count })
+                    : t('child-stderr-line', { line });
+                notify(text, { color: 'error', timeoutMs: 8000 });
+            }
+        },
+        dispose() {
+            for (const group of groups.values())
+                clearTimeout(group.timer);
+            groups.clear();
+        },
+    };
+}

package/lib/types/commands.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Local slash commands for the dsh-tui TUI. Claude Code's command system is
+ * deeply wired into its engine; dsh-tui ships a small built-in set with the
+ * same `/name — description` suggestion chrome, and merges plugin-registered
+ * commands (plan/goal/…) from the DSH command registry (`dsh-commands`) —
+ * `runCommand` in the Chat screen dispatches either kind, with the registry
+ * handler winning for names both sides declare.
+ */
+export interface LocalCommand {
+    /** The command name without the slash, e.g. `clear`. */
+    name: string;
+    /** One-line description shown in the suggestion overlay. */
+    description: string;
+    /** Optional bracket tag shown between name and description. */
+    tag?: string;
+    /** True when a DSH plugin registered this command (not built in). */
+    external?: boolean;
+}
+/**
+ * The built-in slash commands (name + description pairs). Plugin-registered
+ * commands merge in at runtime; locals win on name collisions.
+ */
+export declare const LOCAL_COMMANDS: LocalCommand[];
+/**
+ * Parse a slash-command line into its name and the verbatim input following
+ * the name (separator whitespace included) — the same split the DSH command
+ * registry uses, so `/plan off` dispatches `plan` with ` off`.
+ *
+ * @param line - Complete candidate command line.
+ * @returns The parsed name and raw input, or `undefined` when the line is
+ *   not a command.
+ */
+export declare function parseCommandName(line: string): {
+    name: string;
+    rawInput: string;
+} | undefined;
+/**
+ * Whether the input names a local command. Local commands must never be sent
+ * to the model when typed alone; trailing whitespace is legal.
+ * @param input - Candidate command line (slash optional).
+ * @param list - Command list to match against; defaults to LOCAL_COMMANDS.
+ * @returns True when the trimmed input names a command in `list`.
+ */
+export declare function isLocalCommandName(input: string, list?: readonly LocalCommand[]): boolean;
+/**
+ * Filter commands by a `/…` input prefix (matches the CC overlay behavior).
+ * The prefix is the whole input after the slash, so `/plan off` matches
+ * nothing and the overlay stays closed — Enter still dispatches through
+ * `parseCommandName`.
+ * @param input - Slash-command input; the prefix is the whole text after the slash.
+ * @param list - Command list to filter; defaults to LOCAL_COMMANDS.
+ * @returns Commands whose name starts with the prefix, in list order.
+ */
+export declare function filterCommands(input: string, list?: readonly LocalCommand[]): LocalCommand[];
+//# sourceMappingURL=commands.d.ts.map

package/lib/types/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA+CxC,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB"}

package/lib/types/commands.js

@@ -0,0 +1,101 @@
+/**
+ * Local slash commands for the dsh-tui TUI. Claude Code's command system is
+ * deeply wired into its engine; dsh-tui ships a small built-in set with the
+ * same `/name — description` suggestion chrome, and merges plugin-registered
+ * commands (plan/goal/…) from the DSH command registry (`dsh-commands`) —
+ * `runCommand` in the Chat screen dispatches either kind, with the registry
+ * handler winning for names both sides declare.
+ */
+/**
+ * The built-in slash commands (name + description pairs). Plugin-registered
+ * commands merge in at runtime; locals win on name collisions.
+ */
+export const LOCAL_COMMANDS = [
+    // Conversation
+    { name: 'new', description: 'Start a new conversation' },
+    { name: 'clear', description: 'Clear the conversation' },
+    { name: 'compact', description: 'Compact the conversation history' },
+    { name: 'resume', description: 'Resume a previous session' },
+    { name: 'rewind', description: 'Rewind the conversation to a previous message' },
+    { name: 'export', description: 'Export the conversation to a markdown file' },
+    // Session / environment
+    { name: 'status', description: 'Show session status' },
+    { name: 'cost', description: 'Show session token usage' },
+    { name: 'config', description: 'Show the dsh-tui configuration source' },
+    { name: 'doctor', description: 'Run environment checks' },
+    { name: 'init', description: 'Create AGENTS.md in the working directory' },
+    { name: 'agents', description: 'Show subagents of this session' },
+    // Model / display
+    { name: 'activity', description: 'Switch the working-activity indicator preset' },
+    { name: 'preset', description: 'Switch the agent preset (standard/code/minimal/cordis)' },
+    { name: 'theme', description: 'Switch the color theme (built-in or custom)' },
+    { name: 'lang', description: 'Switch the UI language (en / zh)' },
+    { name: 'model', description: 'Show the active model' },
+    { name: 'thinking', description: 'Toggle extended thinking display' },
+    { name: 'tokens', description: 'Show session token usage' },
+    // Account / policy
+    { name: 'login', description: 'Show API credential status' },
+    { name: 'logout', description: 'Clear the API credential' },
+    { name: 'permissions', description: 'Show permission policy status' },
+    { name: 'add-dir', description: 'Show the filesystem policy scope' },
+    { name: 'hooks', description: 'Show hooks status' },
+    { name: 'mcp', description: 'Show MCP status' },
+    { name: 'memory', description: 'Show memory status' },
+    { name: 'update', description: 'Update dsh-tui and restart' },
+    // Built-in skills (CC's skill commands, driven through DSH skills)
+    { name: 'audit', description: 'Run a comprehensive code audit on this project' },
+    { name: 'bug', description: 'Capture a bug report' },
+    { name: 'practice', description: 'Practice programming with dsh-tui' },
+    { name: 'review', description: 'Run a comprehensive code review on this project' },
+    { name: 'pr_comments', description: 'Review pull request comments' },
+    { name: 'release-notes', description: 'Generate release notes' },
+    { name: 'vuln-check', description: 'Run a security vulnerability check' },
+    // Misc / not applicable on this leaf
+    { name: 'vim', description: 'Toggle vim mode' },
+    { name: 'terminal-setup', description: 'Show terminal setup instructions' },
+    { name: 'connect', description: 'Connect to a remote machine' },
+    // Help / exit
+    { name: 'help', description: 'Show shortcuts and commands' },
+    { name: 'exit', description: 'Exit dsh-tui' },
+];
+/**
+ * Parse a slash-command line into its name and the verbatim input following
+ * the name (separator whitespace included) — the same split the DSH command
+ * registry uses, so `/plan off` dispatches `plan` with ` off`.
+ *
+ * @param line - Complete candidate command line.
+ * @returns The parsed name and raw input, or `undefined` when the line is
+ *   not a command.
+ */
+export function parseCommandName(line) {
+    const match = /^\/([a-z][a-z0-9_-]*)(?=$|[\t\n\r ])/.exec(line);
+    if (match === null)
+        return undefined;
+    return { name: match[1], rawInput: line.slice(match[0].length) };
+}
+/**
+ * Whether the input names a local command. Local commands must never be sent
+ * to the model when typed alone; trailing whitespace is legal.
+ * @param input - Candidate command line (slash optional).
+ * @param list - Command list to match against; defaults to LOCAL_COMMANDS.
+ * @returns True when the trimmed input names a command in `list`.
+ */
+export function isLocalCommandName(input, list = LOCAL_COMMANDS) {
+    // Trailing whitespace is legal (Tab completion leaves a space after the
+    // name so the user can type arguments).
+    const name = input.replace(/^\//, '').trim();
+    return list.some(command => command.name === name);
+}
+/**
+ * Filter commands by a `/…` input prefix (matches the CC overlay behavior).
+ * The prefix is the whole input after the slash, so `/plan off` matches
+ * nothing and the overlay stays closed — Enter still dispatches through
+ * `parseCommandName`.
+ * @param input - Slash-command input; the prefix is the whole text after the slash.
+ * @param list - Command list to filter; defaults to LOCAL_COMMANDS.
+ * @returns Commands whose name starts with the prefix, in list order.
+ */
+export function filterCommands(input, list = LOCAL_COMMANDS) {
+    const prefix = input.replace(/^\//, '').trim().toLowerCase();
+    return list.filter(command => command.name.toLowerCase().startsWith(prefix));
+}

package/lib/types/components/ActivityLine.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { ActivityStatus } from '../channel.js';
+/**
+ * Context-pressure percentage (0–100) from the last usage snapshot, or
+ * undefined when unknown — shared by the spinner-line and status-line
+ * placements of the working-activity line (pi working-activity style:
+ * amber ≥ 80%, red ≥ 95%).
+ */
+export declare function contextPressurePct(usage: {
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+} | undefined, contextWindow: number | undefined): number | undefined;
+/**
+ * The working-activity line, rendered either in the spinner slot (while a
+ * turn runs — replacing the CC random-verb spinner) or on the status bar
+ * (the turn-summary card once idle). pi working-activity style: an animated
+ * indicator frame, an ice-blue shimmer sweep over the line, an amber/red
+ * `⚠ ctx N%` pressure prefix, and a trailing token suffix for the spinner
+ * placement. Done summaries render statically in the brand mist blue.
+ */
+export declare function ActivityLine({ activity, activityFrames, warnPct, warnDanger, suffix, }: {
+    activity: ActivityStatus;
+    activityFrames: string | undefined;
+    warnPct?: number;
+    warnDanger?: boolean;
+    suffix?: string;
+}): React.ReactNode;
+//# sourceMappingURL=ActivityLine.d.ts.map

package/lib/types/components/ActivityLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityLine.d.ts","sourceRoot":"","sources":["../../../src/components/ActivityLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC3E,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,cAAc,EACd,OAAO,EACP,UAAU,EACV,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,cAAc,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,KAAK,CAAC,SAAS,CAuClB"}

package/lib/types/components/ActivityLine.js

@@ -0,0 +1,47 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { t } from '../i18n.js';
+import { Text, useAnimationFrame } from '../ui.js';
+import { resolvePreset } from './activityFrames.js';
+import { BRAND, FLASH, ICE, sweep } from './shimmer.js';
+import { getTheme } from '../theme.js';
+import { useTheme } from './design-system/ThemeProvider.js';
+import { parseRGB } from './Spinner/spinnerUtils.js';
+/**
+ * Context-pressure percentage (0–100) from the last usage snapshot, or
+ * undefined when unknown — shared by the spinner-line and status-line
+ * placements of the working-activity line (pi working-activity style:
+ * amber ≥ 80%, red ≥ 95%).
+ */
+export function contextPressurePct(usage, contextWindow) {
+    if (usage === undefined || contextWindow === undefined || contextWindow <= 0) {
+        return undefined;
+    }
+    const occupied = usage.input + usage.cacheRead + usage.cacheWrite;
+    return Math.round((occupied / contextWindow) * 100);
+}
+/**
+ * The working-activity line, rendered either in the spinner slot (while a
+ * turn runs — replacing the CC random-verb spinner) or on the status bar
+ * (the turn-summary card once idle). pi working-activity style: an animated
+ * indicator frame, an ice-blue shimmer sweep over the line, an amber/red
+ * `⚠ ctx N%` pressure prefix, and a trailing token suffix for the spinner
+ * placement. Done summaries render statically in the brand mist blue.
+ */
+export function ActivityLine({ activity, activityFrames, warnPct, warnDanger, suffix, }) {
+    // 60ms frames: the shimmer sweep advances one column per frame (3.3× the
+    // ported 200ms cadence — the slow crawl read as lag).
+    const [, time] = useAnimationFrame(60);
+    const [themeName] = useTheme();
+    const theme = getTheme(themeName);
+    const preset = React.useMemo(() => resolvePreset(activityFrames), [activityFrames]);
+    const frameIndex = Math.floor(time / preset.intervalMs) % preset.frames.length;
+    const frame = preset.frames[frameIndex] ?? '·';
+    const color = activity.phase === 'done' || activity.phase === 'tool'
+        ? 'claude'
+        : 'claudeBlue_FOR_SYSTEM_SPINNER';
+    const baseRGB = activity.phase === 'tool'
+        ? (parseRGB(theme.claude) ?? BRAND)
+        : (parseRGB(theme.claudeBlue_FOR_SYSTEM_SPINNER) ?? ICE);
+    return (_jsxs(Text, { wrap: "truncate", children: [activity.phase !== 'done' && (_jsxs(Text, { color: color, children: [frame, " "] })), warnPct !== undefined && warnPct >= 80 && (_jsxs(Text, { color: warnDanger ? 'error' : 'warning', children: [t('activity-ctx-warn'), warnPct, "% \u00B7", ' '] })), activity.phase === 'done' ? (_jsx(Text, { color: color, children: activity.line })) : (_jsx(Text, { children: sweep(activity.line, time, baseRGB, FLASH, 60) })), suffix !== undefined && _jsx(Text, { dimColor: true, children: suffix })] }));
+}

package/lib/types/components/ActivityPicker.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+/**
+ * Working-activity indicator picker in the CC ModelPicker style (ported
+ * from the pi extension's `/activity` interactive select): a
+ * permission-colored Pane listing every preset (random first) with its
+ * frame preview, `❯` focus pointer and `✓` on the active preset. Enter
+ * applies through `channel.setActivityFrames`, Esc cancels.
+ */
+export declare function ActivityPicker({ focusIndex, currentPreset, }: {
+    focusIndex: number;
+    currentPreset: string | undefined;
+}): React.ReactNode;
+//# sourceMappingURL=ActivityPicker.d.ts.map

package/lib/types/components/ActivityPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityPicker.d.ts","sourceRoot":"","sources":["../../../src/components/ActivityPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,aAAa,GACd,EAAE;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC,GAAG,KAAK,CAAC,SAAS,CA6BlB"}

package/lib/types/components/ActivityPicker.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { Select } from './Select.js';
+import { Byline } from './design-system/Byline.js';
+import { KeyboardShortcutHint } from './design-system/KeyboardShortcutHint.js';
+import { FRAME_PRESETS, PRESET_NAMES } from './activityFrames.js';
+/**
+ * Working-activity indicator picker in the CC ModelPicker style (ported
+ * from the pi extension's `/activity` interactive select): a
+ * permission-colored Pane listing every preset (random first) with its
+ * frame preview, `❯` focus pointer and `✓` on the active preset. Enter
+ * applies through `channel.setActivityFrames`, Esc cancels.
+ */
+export function ActivityPicker({ focusIndex, currentPreset, }) {
+    return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: "Indicator preset" }) }), _jsx(Select, { options: PRESET_NAMES.map(name => ({
+                        value: name,
+                        label: name,
+                        description: name === 'random'
+                            ? t('activity-random-each-preset')
+                            : FRAME_PRESETS[name].frames.slice(0, 5).join(' '),
+                    })), focusIndex: focusIndex, selectedValue: currentPreset }), _jsx(Text, { dimColor: true, italic: true, children: _jsxs(Byline, { children: [_jsx(KeyboardShortcutHint, { shortcut: "Enter", action: "confirm", bold: true }), _jsx(KeyboardShortcutHint, { shortcut: "Esc", action: "exit" })] }) })] }) }));
+}

package/lib/types/components/CommandSuggestions.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { LocalCommand } from '../commands.js';
+/**
+ * The slash-command suggestion overlay, ported from the leak's
+ * `PromptInputFooterSuggestions.tsx` (command layout only): a name column
+ * padded to a fixed width, optional `[tag]`, then a truncated description.
+ * The selected row renders in the theme's `suggestion` color, others dim.
+ */
+export declare function CommandSuggestions({ commands, selectedIndex, columns, }: {
+    commands: readonly LocalCommand[];
+    selectedIndex: number;
+    columns: number;
+}): React.ReactNode;
+//# sourceMappingURL=CommandSuggestions.d.ts.map

package/lib/types/components/CommandSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/CommandSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,aAAa,EACb,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,KAAK,CAAC,SAAS,CAoDlB"}

package/lib/types/components/CommandSuggestions.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from '../ui.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
+/**
+ * The slash-command suggestion overlay, ported from the leak's
+ * `PromptInputFooterSuggestions.tsx` (command layout only): a name column
+ * padded to a fixed width, optional `[tag]`, then a truncated description.
+ * The selected row renders in the theme's `suggestion` color, others dim.
+ */
+export function CommandSuggestions({ commands, selectedIndex, columns, }) {
+    if (commands.length === 0)
+        return null;
+    // Cap the command name column at 40% of terminal width to ensure the
+    // description has space (same as the leak).
+    const maxNameWidth = Math.floor(columns * 0.4);
+    const nameWidth = Math.min(Math.max(...commands.map(c => stringWidth(c.name))) + 5, maxNameWidth);
+    const maxVisible = 5;
+    const startIndex = Math.max(0, Math.min(selectedIndex - Math.floor(maxVisible / 2), commands.length - maxVisible));
+    const visible = commands.slice(startIndex, startIndex + maxVisible);
+    return (_jsx(Box, { flexDirection: "column", children: visible.map(command => {
+            const isSelected = command.name === commands[selectedIndex]?.name;
+            const padded = command.name +
+                ' '.repeat(Math.max(0, nameWidth - stringWidth(command.name)));
+            const tagText = command.tag ? `[${command.tag}] ` : '';
+            const tagWidth = stringWidth(tagText);
+            const descriptionWidth = Math.max(0, columns - nameWidth - tagWidth - 4);
+            const description = stringWidth(command.description) > descriptionWidth
+                ? truncateToWidth(command.description, descriptionWidth - 1) + '…'
+                : command.description;
+            return (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: isSelected ? 'suggestion' : undefined, dimColor: !isSelected, children: padded }), tagText ? _jsx(Text, { dimColor: true, children: tagText }) : null, _jsx(Text, { color: isSelected ? 'suggestion' : undefined, dimColor: !isSelected, children: description })] }, command.name));
+        }) }));
+}

package/lib/types/components/FileSuggestions.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+/**
+ * The `@` file-completion overlay in CC's suggestion style: `+` icon prefix
+ * (CC's file suggestions) + name column + description. The selected row
+ * renders in the theme's `suggestion` color, others dim.
+ */
+export declare function FileSuggestions({ files, selectedIndex, columns, }: {
+    files: readonly string[];
+    selectedIndex: number;
+    columns: number;
+}): React.ReactNode;
+//# sourceMappingURL=FileSuggestions.d.ts.map

package/lib/types/components/FileSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/FileSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,aAAa,EACb,OAAO,GACR,EAAE;IACD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,KAAK,CAAC,SAAS,CAqClB"}

package/lib/types/components/FileSuggestions.js

@@ -0,0 +1,26 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from '../ui.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
+/**
+ * The `@` file-completion overlay in CC's suggestion style: `+` icon prefix
+ * (CC's file suggestions) + name column + description. The selected row
+ * renders in the theme's `suggestion` color, others dim.
+ */
+export function FileSuggestions({ files, selectedIndex, columns, }) {
+    if (files.length === 0)
+        return null;
+    const maxVisible = 6;
+    const startIndex = Math.max(0, Math.min(selectedIndex - Math.floor(maxVisible / 2), files.length - maxVisible));
+    const visible = files.slice(startIndex, startIndex + maxVisible);
+    return (_jsx(Box, { flexDirection: "column", children: visible.map(file => {
+            const isSelected = file === files[selectedIndex];
+            const isDir = file.endsWith('/');
+            const name = isDir ? file.slice(0, -1) : file;
+            const descriptionWidth = Math.max(0, columns - 24);
+            const description = isDir ? 'directory' : 'file';
+            return (_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: isSelected ? 'suggestion' : undefined, dimColor: !isSelected, children: ["+ ", name] }), _jsxs(Text, { color: isSelected ? 'suggestion' : undefined, dimColor: !isSelected, children: [' '.repeat(Math.max(1, 20 - stringWidth(name))), stringWidth(description) > descriptionWidth
+                                ? truncateToWidth(description, descriptionWidth - 1) + '…'
+                                : description] })] }, file));
+        }) }));
+}

package/lib/types/components/GoalTodoPanel.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { Channel } from '../channel.js';
+/**
+ * Live goal + todo panel above the prompt input. Data rides on the channel:
+ * `channel.goal` is folded from `goal/change` context events and
+ * `channel.todos` from `todo/write` whole-list snapshots, so every model
+ * update re-renders this panel in real time (no polling). Renders nothing
+ * while both slots are empty.
+ */
+export declare function GoalTodoPanel({ channel }: {
+    channel: Channel;
+}): React.ReactNode;
+//# sourceMappingURL=GoalTodoPanel.d.ts.map

package/lib/types/components/GoalTodoPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalTodoPanel.d.ts","sourceRoot":"","sources":["../../../src/components/GoalTodoPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,OAAO,EAA8B,MAAM,eAAe,CAAA;AAwDxE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CA2DhF"}