@dsh-cc/tui 0.5.0

package/lib/harness/approval-preview.js

@@ -0,0 +1,179 @@
+/**
+ * Approval-prompt preview builders extracted from harness/driver.ts: argument
+ * restoration from the session log, structured payload previews, permission
+ * rule derivation, and settings-conflict detection. Pure functions over the
+ * approval request and store view types — no I/O and no harness state.
+ * @module @dsh-cc/tui/harness/approval-preview
+ */
+import { canonicalizeHostname, isWebFetchRuleTool, ruleString } from '@dsh-cc/permission-rules';
+/**
+ * Character cap for the pretty-printed raw-arguments preview of an approval
+ * prompt (non-shell, non-file-edit tools).
+ */
+const ARGS_PREVIEW_MAX_CHARS = 500;
+/**
+ * Restore the approved call's arguments by scanning the session log backwards
+ * for the `tool/call` event carrying the request's callId (`appendToolCall`
+ * lands before the pre-execute approval, so the event is always present).
+ * Returns undefined when the callId is missing, unpaired, or its arguments
+ * are not stored as a string.
+ */
+function argsOf(req) {
+    if (req.callId === undefined)
+        return undefined;
+    const events = req.agent.session.events;
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const event = events[i];
+        if (event.type !== 'tool/call')
+            continue;
+        if (String(event.data.callId) !== String(req.callId))
+            continue;
+        const raw = event.data.arguments;
+        if (typeof raw !== 'string')
+            return undefined;
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return { args: parsed };
+            }
+        }
+        catch {
+            // Not JSON — fall through to the raw-text preview.
+        }
+        return { raw };
+    }
+    return undefined;
+}
+/**
+ * Build the approval prompt's structured payload preview from the restored
+ * call arguments: shell-style `command` arguments map to the command kind;
+ * Edit/MultiEdit/Write arguments map to per-file diffs (rendered with the
+ * transcript's multi-hunk diff renderer); anything else pretty-prints the raw
+ * arguments, and a failed recovery degrades to tool name + reason only.
+ */
+export function payloadOf(req) {
+    const restored = argsOf(req);
+    if (restored === undefined)
+        return { kind: 'none' };
+    if ('raw' in restored) {
+        return { kind: 'args', json: restored.raw.slice(0, ARGS_PREVIEW_MAX_CHARS) };
+    }
+    const args = restored.args;
+    if (typeof args.command === 'string') {
+        return { kind: 'command', command: args.command };
+    }
+    const diffs = diffsOf(req.toolName.toLowerCase(), args);
+    if (diffs !== undefined)
+        return { kind: 'diff', diffs };
+    return { kind: 'args', json: JSON.stringify(args, null, 2).slice(0, ARGS_PREVIEW_MAX_CHARS) };
+}
+/**
+ * Extract per-file diffs from file-edit tool arguments, or undefined when the
+ * arguments do not carry the expected shape (the preview then degrades to the
+ * raw-arguments kind).
+ */
+function diffsOf(name, args) {
+    const path = typeof args.file_path === 'string' ? args.file_path : undefined;
+    if (name === 'write') {
+        if (path === undefined || typeof args.content !== 'string')
+            return undefined;
+        return [{ path, oldText: null, newText: args.content }];
+    }
+    if (name === 'edit') {
+        if (path === undefined || typeof args.old_string !== 'string' || typeof args.new_string !== 'string')
+            return undefined;
+        return [{ path, oldText: args.old_string, newText: args.new_string }];
+    }
+    if (name === 'multiedit' || name === 'multi_edit') {
+        if (path === undefined || !Array.isArray(args.edits))
+            return undefined;
+        const diffs = [];
+        for (const edit of args.edits) {
+            if (edit === null || typeof edit !== 'object')
+                continue;
+            const { old_string: oldText, new_string: newText } = edit;
+            if (typeof oldText !== 'string' || typeof newText !== 'string')
+                continue;
+            diffs.push({ path, oldText, newText });
+        }
+        return diffs.length > 0 ? diffs : undefined;
+    }
+    return undefined;
+}
+/**
+ * Derive the permission rule an "always" answer persists for the approved
+ * call. Shell commands get a trailing-space first-word prefix rule
+ * (`Bash(npm )` matches `npm install …` but not `npmx …` — the deliberate
+ * trailing space replaces the colon-carrying `:*` legacy form, which would
+ * otherwise embed the colon in the prefix and never match). Environment
+ * variable prefixes (e.g., `FOO=bar`) are stripped before extracting the
+ * first word, so `FOO=bar npm install` derives a rule for `npm`, not `FOO=bar`.
+ * A WebFetch call derives a `WebFetch(domain:<host>)` rule on the exact host
+ * from its `url` argument; every other tool gets a whole-tool rule. Undefined
+ * (stay once-only) when nothing usable remains, e.g. a blank command.
+ */
+export function allowRuleOf(toolName, preview) {
+    const name = toolName.trim();
+    if (name === '')
+        return undefined;
+    if (preview?.kind === 'command') {
+        const command = preview.command.trim();
+        if (command === '')
+            return undefined;
+        // Strip environment variable prefixes (FOO=bar, FOO=bar BAZ=qux, etc.)
+        // These are assignments that appear before the actual command.
+        let remaining = command;
+        while (true) {
+            const match = remaining.match(/^[A-Z_][A-Z0-9_]*=\S*\s+/);
+            if (!match)
+                break;
+            remaining = remaining.slice(match[0].length);
+        }
+        // Handle common command prefixes that should be stripped
+        // sudo: run as root, but rule should match the actual command
+        // npx/yarn: package runners, but rule should match the underlying tool
+        const prefixesToStrip = ['sudo ', 'npx ', 'yarn '];
+        for (const prefix of prefixesToStrip) {
+            if (remaining.startsWith(prefix)) {
+                remaining = remaining.slice(prefix.length);
+                break; // Only strip one prefix
+            }
+        }
+        // For compound commands (&&, ||, ;), only consider the first segment
+        // This is a simplification - the rule will match any command starting
+        // with the first segment's command, which is the desired behavior.
+        const firstSegment = remaining.split(/&&|\|\||;/)[0]?.trim() ?? '';
+        const firstWord = firstSegment.split(/\s+/)[0] ?? '';
+        if (firstWord === '')
+            return undefined;
+        // ruleString escapes parens/backslashes so a subshell-opening first word
+        // round-trips through parseRuleString.
+        return ruleString(name, `${firstWord} `);
+    }
+    // WebFetch persists a domain rule on the exact host (not `*.host`): the
+    // args preview carries the URL, whose hostname is canonicalized here. An
+    // unparsable payload keeps today's whole-tool rule.
+    if (isWebFetchRuleTool(name) && preview?.kind === 'args') {
+        try {
+            const parsed = JSON.parse(preview.json);
+            const url = parsed.url;
+            if (typeof url === 'string') {
+                const hostname = canonicalizeHostname(url);
+                if (hostname !== undefined)
+                    return ruleString('WebFetch', `domain:${hostname}`);
+            }
+        }
+        catch {
+            // Malformed JSON or missing url — fall through to the whole-tool rule.
+        }
+    }
+    return name;
+}
+/** Whether an error is the settings provider's revision-conflict rejection. */
+export function isSettingsConflict(error) {
+    const candidate = error;
+    if (candidate === null || typeof candidate !== 'object')
+        return false;
+    return candidate.code === 'SETTINGS_CONFLICT' || candidate.name === 'SettingsConflictError';
+}
+//# sourceMappingURL=approval-preview.js.map

package/lib/harness/approval-preview.js.map

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

package/lib/harness/boot-banner.d.ts

@@ -0,0 +1,14 @@
+import type { TranscriptRow } from '../store.ts';
+/**
+ * Build the 6-line half-block whale art: vertical row pairs compress to one
+ * line ('█' both, '▀' upper only, '▄' lower only). Lines are right-trimmed,
+ * then the common left indent is trimmed so alignment survives. Every line
+ * is wrapped in its fixed blue SGR foreground and closed with `\x1b[0m`
+ * (pi-tui's wrap engine carries active codes across lines).
+ */
+export declare function whaleBannerArt(): string;
+/** Boot info line under the whale art (em dash + middle dots, as historically). */
+export declare function bootBannerText(modelLabel: string, cwd: string): string;
+/** The two transcript rows emitted at boot: whale art, then the info line. */
+export declare function bootBannerRows(modelLabel: string, cwd: string): TranscriptRow[];
+//# sourceMappingURL=boot-banner.d.ts.map

package/lib/harness/boot-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-banner.d.ts","sourceRoot":"","sources":["../../src/harness/boot-banner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAiDhD;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAmBvC;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAK/E"}

package/lib/harness/boot-banner.js

@@ -0,0 +1,89 @@
+/**
+ * Boot banner art + info text for the CC transcript. Brand art is
+ * theme-independent: the whale renders through a fixed deep-to-light blue
+ * 256-color ramp regardless of the configured palette.
+ * @module @dsh-cc/tui/harness/boot-banner
+ */
+import { sgr } from "../components/theme.js";
+/**
+ * DeepSeek whale source art, "half-block compressed" (半块压缩版): 11 rows of
+ * '█' (filled) / '.' (background), embedded verbatim — pristine. The eye is
+ * punched at build time (see {@link EYE}), so the source art above stays
+ * untouched and the eye intent is documented here rather than edited in.
+ */
+const WHALE_BITMAP = [
+    '..........................███......█.......',
+    '..........................█████..█████.....',
+    '..........█████████.......████████████.....',
+    '........███████████████.....█████████......',
+    '......███████████████████..██████..........',
+    '......████████████████████████.██..........',
+    '......███████████████████████████..........',
+    '......█████.......██████████████...........',
+    '.......██.............█████████............',
+    '.........███...........█████████...........',
+    '............███████████..███████...........',
+];
+/**
+ * Eye hole: bitmap rows 4 and 5, column 27 (0-based). Rows are paired
+ * vertically (0,1),(2,3),(4,5),… so punching both rows keeps the eye inside
+ * one half-block pair. Applied at build time over the verbatim bitmap.
+ */
+const EYE = [
+    [4, 27],
+    [5, 27],
+];
+/**
+ * Fixed deep→light 256-color SGR foreground ramp, one per output line. The
+ * mid rows anchor on 63 (#5f5fff), the nearest 256-color match to the
+ * DeepSeek brand blue #4D6BFE; the ramp stays on the blue axis (no cyan
+ * drift) and the belly tops out at 75 (#5fafff).
+ */
+const BLUE_RAMP = ['38;5;25', '38;5;26', '38;5;27', '38;5;63', '38;5;69', '38;5;75'];
+/** Bitmap with the eye punched in (filled → background) at the EYE points. */
+const PUNCHED = (() => {
+    const rows = WHALE_BITMAP.slice();
+    for (const [r, c] of EYE) {
+        rows[r] = rows[r].slice(0, c) + '.' + rows[r].slice(c + 1);
+    }
+    return rows;
+})();
+/**
+ * Build the 6-line half-block whale art: vertical row pairs compress to one
+ * line ('█' both, '▀' upper only, '▄' lower only). Lines are right-trimmed,
+ * then the common left indent is trimmed so alignment survives. Every line
+ * is wrapped in its fixed blue SGR foreground and closed with `\x1b[0m`
+ * (pi-tui's wrap engine carries active codes across lines).
+ */
+export function whaleBannerArt() {
+    const lines = [];
+    for (let pair = 0; pair * 2 < PUNCHED.length; pair++) {
+        const upper = PUNCHED[pair * 2];
+        const lower = PUNCHED[pair * 2 + 1] ?? '';
+        let line = '';
+        for (let col = 0; col < upper.length; col++) {
+            const up = upper[col] === '█';
+            const low = lower[col] === '█';
+            line += up && low ? '█' : up ? '▀' : low ? '▄' : ' ';
+        }
+        lines.push(line);
+    }
+    const trimmed = lines.map(line => line.replace(/\s+$/, ''));
+    const indent = Math.min(...trimmed.map(line => line.length - line.trimStart().length));
+    return trimmed
+        .map(line => line.slice(indent))
+        .map((line, i) => sgr(BLUE_RAMP[i % BLUE_RAMP.length])(line))
+        .join('\n');
+}
+/** Boot info line under the whale art (em dash + middle dots, as historically). */
+export function bootBannerText(modelLabel, cwd) {
+    return `dsh cc-mode — ${modelLabel} · ${cwd} · /tui-help for keys`;
+}
+/** The two transcript rows emitted at boot: whale art, then the info line. */
+export function bootBannerRows(modelLabel, cwd) {
+    return [
+        { kind: 'banner', text: whaleBannerArt() },
+        { kind: 'status', text: bootBannerText(modelLabel, cwd) },
+    ];
+}
+//# sourceMappingURL=boot-banner.js.map

package/lib/harness/boot-banner.js.map

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

package/lib/harness/driver-agent.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Agent-model + history cluster of the TUI driver factory.
+ *
+ * createDriver used to hold these locals inline: resolveEfforts / stalePair /
+ * seedDefaultModel, the resume marker + prompt/bash histories, the tool
+ * presenters, history folding, and the model-command catalog. They only read
+ * `ctx`/`current`/`selection`/`liveMode` off `rt` (DriverAgentCtx), so they
+ * migrate here as a free-function collaborator to keep the factory under the
+ * 500-line budget — the same pattern as the other harness/driver-*.ts leaves.
+ *
+ * Mutable state the other sections rebind (`markedContent`, `history`,
+ * `bashHistory`) is owned HERE and exposed through get/set/append handles so
+ * no other module captures a stale copy.
+ * @module @dsh-cc/tui/harness/driver-agent
+ */
+import { type TuiState } from '../store.ts';
+import { type ToolPresenters } from '../transcript.ts';
+import type { CatalogEntry } from '../model-catalog.ts';
+import type { ShellExecutorLike } from '../state/driver-types.ts';
+import type { DriverAgentCtx, DriverSessionEventsCtx } from './driver-ctx.ts';
+/**
+ * The slice of createDriver's model/history cluster that the session/event
+ * listener needs: it folds events onto fresh state and presents tool cards for
+ * the live agent.
+ */
+export declare function attachSessionEvents(rt: DriverSessionEventsCtx): void;
+/**
+ * The handle object returned by {@link createAgentSection}. createDriver
+ * destructures these into its locals and threads them into the other sections.
+ */
+export interface AgentSection {
+    resolveEfforts(provider: string, model: string): Promise<readonly {
+        id: string;
+        name: string;
+    }[] | undefined>;
+    stalePair(captured: {
+        provider: string;
+        model: string;
+    }): boolean;
+    seedDefaultModel(reset?: boolean): Promise<void>;
+    /**
+     * Await the boot default-model seed (kicked once, shared promise). Model-turn
+     * paths must await this before dispatch so a turn never runs with an
+     * unresolved selection. Resolves even when the seed failed.
+     */
+    waitForModel(): Promise<void>;
+    /** Bounded boot-frame wait (never blocks on a slow seed). */
+    awaitBootFrame(): Promise<void>;
+    persistResumeTarget(): void;
+    getMarkedContent(): boolean;
+    setMarkedContent(value: boolean): void;
+    historyDir: string | undefined;
+    /**
+     * Rebind prompt/bash history to a new data directory and reload both from
+     * disk. Used by /resume to re-scope history onto the switched session's
+     * project (a no-op caller-side when the project is unchanged).
+     */
+    bindHistoryDir(dir: string | undefined): void;
+    getHistory(): string[];
+    setHistory(next: string[]): void;
+    getBashHistory(): string[];
+    appendBashHistory(command: string): void;
+    /** Tool presenters (absent when no tools service mounted). */
+    presenters: ToolPresenters | undefined;
+    /** Shell executor seam for `!` commands (used by the bash section). */
+    shell: ShellExecutorLike | undefined;
+    /** Fold the live session's event log onto the current view-model. */
+    foldHistory(): TuiState;
+    loadCatalog(): Promise<CatalogEntry[]>;
+}
+/**
+ * Build the agent-model/history cluster. Returns handles createDriver threads
+ * into the picker/session/run-local/queue sections and the Driver API, and
+ * exposes the owned `markedContent`/`history`/`bashHistory` state through
+ * get/set seams so no other module captures a stale copy.
+ */
+export declare function createAgentSection(rt: DriverAgentCtx): AgentSection;
+//# sourceMappingURL=driver-agent.d.ts.map

package/lib/harness/driver-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-agent.d.ts","sourceRoot":"","sources":["../../src/harness/driver-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,EAOL,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAGV,iBAAiB,EAElB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAE7E;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI,CAuEpE;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC,CAAA;IAC7G,SAAS,CAAC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IACjE,gBAAgB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,6DAA6D;IAC7D,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,mBAAmB,IAAI,IAAI,CAAA;IAC3B,gBAAgB,IAAI,OAAO,CAAA;IAC3B,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IAC7C,UAAU,IAAI,MAAM,EAAE,CAAA;IACtB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,cAAc,IAAI,MAAM,EAAE,CAAA;IAC1B,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,8DAA8D;IAC9D,UAAU,EAAE,cAAc,GAAG,SAAS,CAAA;IACtC,uEAAuE;IACvE,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACpC,qEAAqE;IACrE,WAAW,IAAI,QAAQ,CAAA;IACvB,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAqNnE"}