@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { LoadedContext } from '../dsh-adapter/channel.js';
+/**
+ * The startup context panel: a collapsed one-line summary of what a
+ * fresh conversation will load for the current agent (system prompt
+ * sections, workspace instruction files, dynamic context, skill catalog,
+ * tools), expandable to the grouped details with Ctrl+P. The `/context`
+ * local command still prints the same details as a transcript report.
+ * The panel renders only while the transcript is still empty — the first
+ * message's rows take over. Renders nothing for an empty snapshot.
+ * @param context - the channel's loaded-context snapshot.
+ * @param open - whether the grouped details are shown.
+ * @param onToggle - flips `open`; fired by the Ctrl+P keybinding.
+ */
+export declare function LoadedContextPanel({ context, open, onToggle, }: {
+    context: LoadedContext;
+    open: boolean;
+    onToggle: () => void;
+}): React.ReactNode;
+//# sourceMappingURL=LoadedContextPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoadedContextPanel.d.ts","sourceRoot":"","sources":["../../../src/components/LoadedContextPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAA;AA+BlF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CA2ElB"}

package/lib/types/components/LoadedContextPanel.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { summarizeLoadedContext, truncateContextText } from '../utils/loaded-context.js';
+/** One named entry (section or dynamic context) with its full text. */
+function Entry({ entry }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: entry.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(entry.text) })] }));
+}
+/** A titled group of rows inside the expanded panel. */
+function Group({ title, children }) {
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, color: "subtle", children: title }), _jsx(Box, { flexDirection: "column", paddingLeft: 2, children: children })] }));
+}
+/**
+ * The startup context panel: a collapsed one-line summary of what a
+ * fresh conversation will load for the current agent (system prompt
+ * sections, workspace instruction files, dynamic context, skill catalog,
+ * tools), expandable to the grouped details with Ctrl+P. The `/context`
+ * local command still prints the same details as a transcript report.
+ * The panel renders only while the transcript is still empty — the first
+ * message's rows take over. Renders nothing for an empty snapshot.
+ * @param context - the channel's loaded-context snapshot.
+ * @param open - whether the grouped details are shown.
+ * @param onToggle - flips `open`; fired by the Ctrl+P keybinding.
+ */
+export function LoadedContextPanel({ context, open, onToggle, }) {
+    const summary = summarizeLoadedContext(context);
+    const [hovered, setHovered] = React.useState(false);
+    if (summary === '')
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: [_jsx(Box, { paddingX: 1, backgroundColor: open || hovered ? 'userMessageBackgroundHover' : undefined, onClick: onToggle, onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), children: _jsxs(Text, { bold: open, wrap: "truncate", children: [open ? '▼' : '▶', " ", _jsxs(Text, { dimColor: true, children: ["\uFF08Ctrl+P", open ? t('context-panel-collapse') : t('context-panel-expand'), "\uFF09"] }), " ", t('context-loaded'), " \u00B7 ", summary] }) }), open && (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [context.sections.length > 0 && (_jsx(Group, { title: t('context-panel-sections', { n: context.sections.length }), children: context.sections.map(section => (_jsx(Entry, { entry: section }, section.name))) })), context.files.length > 0 && (_jsx(Group, { title: t('context-panel-files', { n: context.files.length }), children: context.files.map(file => (_jsx(Text, { dimColor: true, children: file.displayPath }, file.displayPath))) })), context.contexts.length > 0 && (_jsx(Group, { title: t('context-panel-runtime', { n: context.contexts.length }), children: context.contexts.map(entry => (_jsx(Entry, { entry: entry }, entry.name))) })), context.skills.length > 0 && (_jsx(Group, { title: t('context-panel-skills', { n: context.skills.length }), children: context.skills.map(skill => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: skill.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: skill.description })] }, skill.name))) })), context.tools.length > 0 && (_jsx(Group, { title: t('context-panel-tools', { n: context.tools.length }), children: context.tools.map(tool => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: tool.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(tool.description, 160) })] }, tool.name))) })), _jsx(Text, { dimColor: true, children: "\u00B7 /context" })] }))] }));
+}

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

@@ -0,0 +1,48 @@
+import React from 'react';
+import { type Tip } from '../tips.js';
+import { type UpstreamDriftSummary } from '../dsh-adapter/contract.js';
+import { type WhaleIntroId } from './whaleFrames.js';
+/**
+ * The header splash: one layout, two phases. The **opening** (~1.7–3.5s,
+ * once) plays one of three whale intros — the classic blink + spout +
+ * tail-wag combo, the heart pass, or the sleep-Z float — rolled on every
+ * mount (see `pickOpeningSequence`): randomly at startup, and again
+ * randomly on each `/deepseek` easter-egg replay — and runs the shimmer
+ * sweeps; the **settled** header is the same tree frozen at t=0 — whale
+ * on the standard pose, sweep highlights parked off-screen, clock
+ * unsubscribed, zero timers.
+ *
+ * Layout: the 13-row pixel whale beside a text column of matching height —
+ * the `✦ dsh-TUI` wordmark with version, the `DEEPSEEK`/`HARNESS` tagline in
+ * the 5-row block font (brand-blue → ice gradient), the model/effort and
+ * cwd in plain text (no brand-color highlight), the startup tip, and below
+ * the whale the welcome tagline, centered under the art, in ice
+ * blue. Narrow terminals drop the whale and keep the text column.
+ */
+export declare function LogoV2({ model, effort, cwd, skipIntro, intro, tip, whale, whaleIdle, working, drift, }: {
+    model: string;
+    effort?: string | undefined;
+    cwd: string;
+    /** Test seam: mount straight into the settled header (probes skip the intro). */
+    skipIntro?: boolean;
+    /** Test seam: pin the intro animation instead of rolling one at startup. */
+    intro?: WhaleIntroId;
+    /** Test seam: pin the startup tip line (probes need a deterministic tip). */
+    tip?: Tip;
+    /** Show the pixel whale art (settings `dsh-tui.whale`); off → text-only header. */
+    whale?: boolean;
+    /** Welcome-phase idle whale behaviors — fin flutters, tail thumps,
+     * sleep after inactivity (settings `dsh-tui.whaleIdle`; on by default —
+     * an explicit `false` keeps the settled header timer-free). Click-hearts
+     * work regardless, until the freeze. */
+    whaleIdle?: boolean;
+    /** Whether an agent turn is active. The FIRST active turn permanently
+     * freezes the whale to the static standard frame (the idle planner and
+     * click-hearts are welcome-phase features); sustained !working before
+     * that lets it fall asleep. */
+    working?: boolean;
+    /** Test seam: pin/suppress the upstream-drift notice (`null` forces it off;
+     * `undefined` — the production default — auto-detects the install). */
+    drift?: UpstreamDriftSummary | null;
+}): React.ReactNode;
+//# sourceMappingURL=LogoV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LogoV2.d.ts","sourceRoot":"","sources":["../../../src/components/LogoV2.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAoD,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAYxH,OAAO,EAA+E,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAsDjI;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,MAAM,EACN,GAAG,EACH,SAAiB,EACjB,KAAK,EACL,GAAG,EACH,KAAY,EACZ,SAAgB,EAChB,OAAe,EACf,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;4CAGwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;mCAG+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;2EACuE;IACvE,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;CACpC,GAAG,KAAK,CAAC,SAAS,CAqOlB"}

package/lib/types/components/LogoV2.js

@@ -0,0 +1,239 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { getLang, t as tr, tOr } from '../i18n.js';
+import { pickRandomTip } from '../tips.js';
+import { upstreamDriftSummary, UPSTREAM_VALIDATED_VERSION } from '../dsh-adapter/contract.js';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Box, Text, useAnimationFrame, useTerminalSize } from '../ui.js';
+import { getTheme } from '../theme.js';
+import { useTheme } from './design-system/ThemeProvider.js';
+import { parseRGB } from './Spinner/spinnerUtils.js';
+import { renderBigText } from './bigfont.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { BRAND, FLASH, ICE, PALE, sweep } from './shimmer.js';
+import { STANDARD_FRAME_INDEX, WhaleArt } from './Whale.js';
+import { OPENING_SEQUENCES, pickOpeningSequence, WHALE_FRAME_INDEX } from './whaleFrames.js';
+import { RESTING_POSE } from './whaleLayers.js';
+import { initialWhaleIdleState, nextWhaleIdleStep, } from './whaleIdle.js';
+/** Intro-phase heart pass (whole frames — the planner owns the settled phase). */
+const INTRO_HEART_PASS = [
+    WHALE_FRAME_INDEX.heart1, WHALE_FRAME_INDEX.heart2, WHALE_FRAME_INDEX.heart3,
+];
+/**
+ * Header badge version, read from the installed package.json so the display
+ * never drifts from the published version. Falls back to a literal when the
+ * package metadata is unreadable (unusual layouts).
+ */
+const VERSION = (() => {
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'package.json');
+        return JSON.parse(readFileSync(pkgPath, 'utf8')).version ?? '0.1.0';
+    }
+    catch {
+        return '0.1.0';
+    }
+})();
+/** Below this width the whale hides and the header goes text-only. */
+const WHALE_MIN_COLUMNS = 64;
+/**
+ * Fixed whale box width: the tail-wag frames reach 4 columns further right
+ * than the standard pose, and a pinned width keeps the text column from
+ * shifting sideways during the opening animation.
+ */
+const FULL_WHALE_WIDTH = 40;
+/**
+ * Center of the whale art's bounding box: sprite columns 3..34 (center
+ * 18.5) of the 40-wide box. The welcome tagline is indented so its own
+ * center lands on this column — for the 14-column Chinese tagline that is
+ * 18.5 − 7 = 11.5 → 12 leading spaces. (Centering on the full 40-column
+ * box would need 13, which reads one column right of the whale body.)
+ * The pad is recomputed from the rendered tagline's display width so
+ * longer locales — e.g. the 21-column English tagline → 8 — stay
+ * centered under the art too.
+ */
+const WHALE_CENTER = 18.5;
+/** `max` → `Max` (effort levels arrive lower-case from the adapter). */
+function capitalize(text) {
+    return text.length === 0 ? text : text[0].toUpperCase() + text.slice(1);
+}
+/**
+ * The header splash: one layout, two phases. The **opening** (~1.7–3.5s,
+ * once) plays one of three whale intros — the classic blink + spout +
+ * tail-wag combo, the heart pass, or the sleep-Z float — rolled on every
+ * mount (see `pickOpeningSequence`): randomly at startup, and again
+ * randomly on each `/deepseek` easter-egg replay — and runs the shimmer
+ * sweeps; the **settled** header is the same tree frozen at t=0 — whale
+ * on the standard pose, sweep highlights parked off-screen, clock
+ * unsubscribed, zero timers.
+ *
+ * Layout: the 13-row pixel whale beside a text column of matching height —
+ * the `✦ dsh-TUI` wordmark with version, the `DEEPSEEK`/`HARNESS` tagline in
+ * the 5-row block font (brand-blue → ice gradient), the model/effort and
+ * cwd in plain text (no brand-color highlight), the startup tip, and below
+ * the whale the welcome tagline, centered under the art, in ice
+ * blue. Narrow terminals drop the whale and keep the text column.
+ */
+export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whale = true, whaleIdle = true, working = false, drift, }) {
+    // One intro per logo mount: the production path rolls (startup splash
+    // and each /deepseek replay roll independently), the `intro` seam pins
+    // a specific animation for probes.
+    const [sequence] = React.useState(() => OPENING_SEQUENCES[intro ?? pickOpeningSequence().id]);
+    const [step, setStep] = React.useState(skipIntro ? sequence.length : 0);
+    const settled = step >= sequence.length;
+    // Opening clock: drives the shimmer sweep and big-text highlight only
+    // while the intro plays; `null` afterwards unsubscribes so the settled
+    // header never repaints. 60ms frames keep the sweep lively.
+    const [ref, time] = useAnimationFrame(settled ? null : 60);
+    // Frame chain: dwell per sequence entry, then settle for good.
+    React.useEffect(() => {
+        if (settled)
+            return;
+        const timer = setTimeout(() => {
+            setStep(s => s + 1);
+        }, sequence[step].ms);
+        return () => {
+            clearTimeout(timer);
+        };
+    }, [step, settled, sequence]);
+    // First task latches the freeze: once an agent turn starts, the settled
+    // whale drops to the static standard frame for the rest of the session —
+    // idle motion and click-hearts are a welcome-phase feature, and a frozen
+    // logo costs nothing while the transcript scrolls it off-screen.
+    const [whaleFrozen, setWhaleFrozen] = React.useState(false);
+    React.useEffect(() => {
+        if (working)
+            setWhaleFrozen(true);
+    }, [working]);
+    // ── Whale behaviors (ported from the dsh-ui-whale pet) ─────────────────
+    // Intro-phase click → heart pass: whole heart frames over the opening
+    // animation (one-way heart1→heart2→heart3). Once the header settles, the
+    // layered planner below owns hearts as an overlay, so this state only
+    // matters before settle. heartKey restarts the pass on every click, even
+    // when heartSeq is already 0 (setHeartSeq(0) alone bails in React when the
+    // value is unchanged).
+    const [heartSeq, setHeartSeq] = React.useState(-1);
+    const [heartKey, setHeartKey] = React.useState(0);
+    React.useEffect(() => {
+        if (heartSeq < 0)
+            return;
+        // Once settled with the layered planner on, hearts are the planner's
+        // overlay — a whole-frame pass started during the intro ends here. The
+        // freeze (first task) tears interactions down the same way. A settled
+        // header with `whaleIdle` off has no planner, so the whole-frame pass
+        // keeps playing there (click-hearts don't depend on the setting).
+        if (settled && (whaleIdle || whaleFrozen)) {
+            setHeartSeq(-1);
+            return;
+        }
+        const timer = setTimeout(() => {
+            setHeartSeq(s => (s >= INTRO_HEART_PASS.length - 1 ? -1 : s + 1));
+        }, 350);
+        return () => {
+            clearTimeout(timer);
+        };
+    }, [heartSeq, heartKey, settled, whaleIdle, whaleFrozen]);
+    const [themeName] = useTheme();
+    const theme = getTheme(themeName);
+    const { columns } = useTerminalSize();
+    const wordmarkRGB = parseRGB(theme.accent) ?? BRAND;
+    const wordmarkShimmerRGB = parseRGB(theme.accentShimmer) ?? ICE;
+    const taglineRGB = parseRGB(theme.activity) ?? ICE;
+    const showWhale = whale && columns >= WHALE_MIN_COLUMNS;
+    // Welcome-phase idle behaviors (settings `dsh-tui.whaleIdle`): fin
+    // flutters, tail thumps and blinks while idle, and a sleep-Z loop after
+    // sustained inactivity — all as INDEPENDENT layers composed per tick
+    // (whaleLayers.ts), so a click heart plays over a mid-wag tail or the
+    // sleep-Z loop instead of replacing it. The planner is event-driven —
+    // while the whale rests, the ONLY pending timer is the one waiting for
+    // the next due event, and with the setting off there is no timer at all
+    // (the idle-wakeup contract keeps holding). The freeze latch above tears
+    // the whole thing down at the first agent turn; the planner's working
+    // branch only ever runs for the same-tick race before the latch renders.
+    const [idlePose, setIdlePose] = React.useState(null);
+    const idleStateRef = React.useRef(initialWhaleIdleState(0));
+    const pendingHeartRef = React.useRef(false);
+    const tickRef = React.useRef(null);
+    React.useEffect(() => {
+        if (!settled || !whaleIdle || !showWhale || whaleFrozen) {
+            setIdlePose(null);
+            tickRef.current = null;
+            return;
+        }
+        // A working flip restarts the loop: work wakes a sleeping whale and
+        // slides every idle deadline forward (see nextWhaleIdleStep).
+        idleStateRef.current = initialWhaleIdleState(Date.now());
+        let timer;
+        const tick = () => {
+            // A click can drive tick() directly (tickRef.current?.() in the click
+            // handler) while the timer armed by the previous tick is still pending —
+            // drop it first, or every click forks an extra rescheduling chain that
+            // outlives the effect cleanup (which only knows the latest timer).
+            if (timer !== undefined)
+                clearTimeout(timer);
+            const heart = pendingHeartRef.current;
+            pendingHeartRef.current = false;
+            const step = nextWhaleIdleStep(idleStateRef.current, { working, heart }, Date.now());
+            idleStateRef.current = step.state;
+            setIdlePose(step.pose);
+            timer = setTimeout(tick, step.delayMs);
+            timer.unref?.();
+        };
+        tickRef.current = tick;
+        tick();
+        return () => {
+            tickRef.current = null;
+            if (timer !== undefined)
+                clearTimeout(timer);
+        };
+    }, [settled, whaleIdle, showWhale, working, whaleFrozen]);
+    // Render priority: the layered planner pose owns the settled header while
+    // it runs (hearts and blinks compose over the body planes). Otherwise a
+    // click heart plays as whole heart frames over the intro — or over the
+    // settled standard pose when `whaleIdle` is off (no planner there).
+    const frameIndex = heartSeq >= 0
+        ? (INTRO_HEART_PASS[heartSeq] ?? STANDARD_FRAME_INDEX)
+        : !settled
+            ? sequence[step].frame
+            : STANDARD_FRAME_INDEX;
+    // Frozen clock for the settled header: t=0 parks every sweep highlight
+    // off-screen, leaving the static gradient behind.
+    const t = settled ? 0 : time;
+    const tagline = tr('logo-tagline');
+    // One random tip per mount: the settled header must not re-roll on every
+    // repaint (language switch, terminal resize), or the line would flicker.
+    // `tip` is a test seam; production always passes undefined and rolls.
+    const [randomTip] = React.useState(() => tip ?? pickRandomTip());
+    // Upstream-drift notice, merged to one line: computed once per mount from
+    // the same memoized contract data the adapter checks (undefined when the
+    // install matches). `drift` is a test seam to pin or suppress it.
+    const [driftLine] = React.useState(() => drift === undefined ? upstreamDriftSummary() : drift);
+    // Indent that centers the tagline under the whale art's bounding box.
+    const welcomePad = showWhale
+        ? Math.max(0, Math.round(WHALE_CENTER - stringWidth(tagline) / 2))
+        : 2;
+    const bigDeepSeek = renderBigText('DEEPSEEK', t, wordmarkRGB, taglineRGB, FLASH, 60);
+    const bigHarness = renderBigText('HARNESS', t, taglineRGB, PALE, FLASH, 60);
+    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { flexDirection: "row", gap: 2, width: "100%", alignItems: "center", children: [showWhale && (_jsx(Box, { flexShrink: 0, onClick: () => {
+                            // Frozen (first task started): the whale is a static logo —
+                            // clicks do nothing. Settled: the layered planner consumes the
+                            // click on its next tick — run that tick immediately so the
+                            // heart shows instantly instead of after the current delay.
+                            // Intro: the whole-frame heart pass above.
+                            if (whaleFrozen)
+                                return;
+                            if (settled && whaleIdle) {
+                                pendingHeartRef.current = true;
+                                tickRef.current?.();
+                            }
+                            else {
+                                setHeartSeq(0);
+                                setHeartKey(k => k + 1);
+                            }
+                        }, children: _jsx(WhaleArt, { frameIndex: frameIndex, pose: settled && whaleIdle && !whaleFrozen ? (idlePose ?? RESTING_POSE) : undefined, width: FULL_WHALE_WIDTH }) })), _jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] }), bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`))), _jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), getLang() === 'zh' ? randomTip.zh : randomTip.en, _jsx(Text, { dimColor: true, children: ' · /tips ' + tr('logo-tip-more') })] }), driftLine != null && (_jsxs(Text, { color: "warning", wrap: "wrap", children: ["\u26A0", ' ', tOr(`logo-drift-${driftLine.kind}`, `The dsh engine (${driftLine.versions.join(' / ')}) does not match the validated ${UPSTREAM_VALIDATED_VERSION}; reinstall via npm i -g @deepseek-ai/dsh@${UPSTREAM_VALIDATED_VERSION}.`, {
+                                        installed: driftLine.versions.join(' / '),
+                                        validated: UPSTREAM_VALIDATED_VERSION,
+                                        primary: UPSTREAM_VALIDATED_VERSION,
+                                    })] }))] })] }), _jsx(Box, { marginTop: 1, paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(tagline, t, taglineRGB, FLASH, 60) }) })] }));
+}

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

@@ -0,0 +1,46 @@
+import React from 'react';
+import { type Token } from 'marked';
+/**
+ * Markdown 渲染组件：marked 分词 + ANSI 格式化。
+ *
+ * 表格 token 交给 MarkdownTable 渲染为带边框的 flexbox 布局，mermaid
+ * 代码块交给 MermaidDiagram 画成 box-drawing 图（两者都需要终端宽度，
+ * 所以是独立节点而不是 ANSI 字符串）；
+ * 其余块级内容由 formatToken 转成 ANSI 字符串，按块边界分批放进
+ * Text（只去整段首尾空白）。代码块高亮由 cli-highlight 异步提供，
+ * 加载完成后自动触发一次重渲染。无 markdown 语法的纯文本走快速
+ * 路径，直接合成段落 token，省掉 lexer 调用。
+ */
+type Props = {
+    children: string;
+    /** 为 true 时全部文本内容以 dim 样式呈现 */
+    dimColor?: boolean;
+    /** 为 false 时跳过 token 缓存（流式尾部的内容逐帧变化，缓存必然失效） */
+    cacheTokens?: boolean;
+};
+/**
+ * Tokens that render as their own layout node (a width-aware component)
+ * instead of joining the ANSI text run. StreamingMarkdown consults the same
+ * predicate: a standalone node has a fixed one-row gap to its neighbours
+ * rather than the newline-derived spacing of text blocks.
+ */
+export declare function isStandaloneToken(token: Token): boolean;
+/**
+ * 混合渲染 Markdown 内容：表格用带边框的 flexbox 组件，其余内容由
+ * formatToken 生成 ANSI 字符串放入 Text。高亮对象异步就绪后自动刷新。
+ *
+ * memo by content: finished transcript blocks render with the SAME string
+ * identity for the whole session (StreamingMarkdown keeps its stable prefix
+ * identity-stable precisely to hit this); without the memo every parent
+ * re-render re-ran the full token→ANSI→yoga pipeline for every settled
+ * block — the dominant long-output stall (string-width via wrap-ansi, 60%+
+ * of CPU in streaming profiles).
+ */
+declare function MarkdownImpl({ children, dimColor, cacheTokens }: Props): React.ReactNode;
+/**
+ * Memoized Markdown: skips the whole token→ANSI→layout pipeline when the
+ * content string is the same reference (see MarkdownImpl's doc comment).
+ */
+export declare const Markdown: React.MemoExoticComponent<typeof MarkdownImpl>;
+export {};
+//# sourceMappingURL=Markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAU,KAAK,KAAK,EAAe,MAAM,QAAQ,CAAA;AAQxD;;;;;;;;;;GAUG;AAEH,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AA4ED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEvD;AAgFD;;;;;;;;;;GAUG;AACH,iBAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,WAAkB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA6BhG;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,gDAMpB,CAAA"}

package/lib/types/components/Markdown.js

@@ -0,0 +1,178 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { marked } from 'marked';
+import { Box, Text } from '../ui.js';
+import { configureMarked, formatToken, stripPromptXMLTags } from '../terminal-utils/markdown.js';
+import { getCliHighlightPromise } from '../terminal-utils/cliHighlight.js';
+import { isMermaidLang } from '../terminal-utils/mermaid.js';
+import { MarkdownTable } from './MarkdownTable.js';
+import { MermaidDiagram } from './MermaidDiagram.js';
+// ---- token 缓存 ----
+//
+// marked.lexer 在组件重挂载时是最贵的开销；消息内容不可变，相同文本
+// 必然产出相同 token，因此以原文为 key 缓存。
+//
+// 容量控制不能只看条数：Token 的 raw/text 字段是输入字符串的切片，
+// 会钉住整段输入常驻内存；流式渲染时输入逐帧增长，若只按条数限流，
+// LRU 会保留大量接近最终形态的快照（1MB 消息 ≈ 500 条 × 1MB ≈
+// 500MB）。这里用字符预算限制保留量，超长内容干脆不缓存（重挂载时
+// 重跑 lexer，极少发生且远比常驻便宜）。
+const TOKEN_CACHE_CAPACITY = 200;
+const TOKEN_CACHE_CHAR_BUDGET = 200_000;
+const TOKEN_CACHE_MAX_SOURCE_LENGTH = 20_000;
+const TEXT_BLOCK_BUDGET = 8192;
+const tokenCache = new Map();
+let tokenCacheChars = 0;
+// 语法探针：命中任意 markdown 结构标记才值得走 lexer；内容过长时
+// 只探测开头一段，纯文本直接跳过约 3ms 的 lexer 调用。
+const MD_SYNTAX_MARKERS = /[#*`|[>\-_~]|\n\n|^\d+\. |\n\d+\. /;
+const SYNTAX_PROBE_WINDOW = 500;
+function looksLikePlainText(s) {
+    const probe = s.length > SYNTAX_PROBE_WINDOW ? s.slice(0, SYNTAX_PROBE_WINDOW) : s;
+    return !MD_SYNTAX_MARKERS.test(probe);
+}
+function lexWithCache(content, allowCache) {
+    // 快速路径：纯文本直接合成单个段落 token，不触碰 lexer。
+    if (looksLikePlainText(content)) {
+        return [
+            {
+                type: 'paragraph',
+                raw: content,
+                text: content,
+                tokens: [{ type: 'text', raw: content, text: content }],
+            },
+        ];
+    }
+    if (!allowCache)
+        return marked.lexer(content);
+    // 直接用内容字符串做 key：V8 在字符串头缓存哈希，首次插入后 Map
+    // 查找无需再算哈希，也比 sha256 少一次摘要分配与碰撞风险。
+    const hit = tokenCache.get(content);
+    if (hit) {
+        tokenCache.delete(content); // 提升为最近使用
+        tokenCache.set(content, hit);
+        return hit;
+    }
+    const tokens = marked.lexer(content);
+    if (content.length > TOKEN_CACHE_MAX_SOURCE_LENGTH)
+        return tokens;
+    // Evict oldest entries (Map preserves insertion order) until both the
+    // count and char budgets fit. The previous full clear() nuked the whole
+    // cache every time a long session crossed 200 blocks — every subsequent
+    // row remount then re-ran the lexer (scroll-through-a-long-session
+    // stutter); evicting only what the newcomer displaces keeps the working
+    // set warm.
+    while (tokenCache.size >= TOKEN_CACHE_CAPACITY ||
+        tokenCacheChars + content.length > TOKEN_CACHE_CHAR_BUDGET) {
+        const oldest = tokenCache.keys().next().value;
+        if (oldest === undefined)
+            break;
+        tokenCache.delete(oldest);
+        tokenCacheChars -= oldest.length;
+    }
+    tokenCache.set(content, tokens);
+    tokenCacheChars += content.length;
+    return tokens;
+}
+/**
+ * Tokens that render as their own layout node (a width-aware component)
+ * instead of joining the ANSI text run. StreamingMarkdown consults the same
+ * predicate: a standalone node has a fixed one-row gap to its neighbours
+ * rather than the newline-derived spacing of text blocks.
+ */
+export function isStandaloneToken(token) {
+    return token.type === 'table' || isMermaidToken(token);
+}
+function isMermaidToken(token) {
+    return token.type === 'code' && isMermaidLang(token.lang);
+}
+/**
+ * 把 lexer 产出的 token 列表转成 React 节点序列：table 与 mermaid 块独立
+ * 渲染，其余 token 的 ANSI 文本按完整块分批拼接，只去整段首尾空白。
+ */
+function renderTokensToNodes(tokens, highlight, dimColor) {
+    const nodes = [];
+    let ansiText = '';
+    let textParts = [];
+    const flushAnsiText = () => {
+        if (!ansiText && textParts.length === 0)
+            return;
+        if (textParts.length === 0) {
+            nodes.push(_jsx(Text, { dimColor: dimColor, children: ansiText.trim() }, nodes.length));
+        }
+        else {
+            textParts.push(ansiText);
+            let first = 0;
+            let last = textParts.length - 1;
+            while (first < last && textParts[first].trimStart() === '')
+                first++;
+            while (last > first && textParts[last].trimEnd() === '')
+                last--;
+            textParts[first] = textParts[first].trimStart();
+            textParts[last] = textParts[last].trimEnd();
+            // Each internal boundary replaces exactly one source newline with a
+            // column-child boundary. Only the whole text span trims outer space.
+            nodes.push(_jsx(Box, { flexDirection: "column", children: textParts.slice(first, last + 1).map((part, index) => (_jsx(Text, { dimColor: dimColor, children: index + first < last ? part.slice(0, -1) : part }, index))) }, nodes.length));
+        }
+        ansiText = '';
+        textParts = [];
+    };
+    for (const token of tokens) {
+        if (token.type === 'table') {
+            flushAnsiText();
+            nodes.push(_jsx(MarkdownTable, { token: token, highlight: highlight }, nodes.length));
+        }
+        else if (isMermaidToken(token)) {
+            flushAnsiText();
+            nodes.push(_jsx(MermaidDiagram, { token: token, highlight: highlight, dimColor: dimColor }, nodes.length));
+        }
+        else {
+            ansiText += formatToken(token, 0, null, null, highlight);
+            // A top-level token boundary keeps inline formatting and code fences
+            // intact while letting the painter cull finished offscreen text blocks.
+            if (ansiText.length >= TEXT_BLOCK_BUDGET && ansiText.endsWith('\n')) {
+                textParts.push(ansiText);
+                ansiText = '';
+            }
+        }
+    }
+    flushAnsiText();
+    return nodes;
+}
+/**
+ * 混合渲染 Markdown 内容：表格用带边框的 flexbox 组件，其余内容由
+ * formatToken 生成 ANSI 字符串放入 Text。高亮对象异步就绪后自动刷新。
+ *
+ * memo by content: finished transcript blocks render with the SAME string
+ * identity for the whole session (StreamingMarkdown keeps its stable prefix
+ * identity-stable precisely to hit this); without the memo every parent
+ * re-render re-ran the full token→ANSI→yoga pipeline for every settled
+ * block — the dominant long-output stall (string-width via wrap-ansi, 60%+
+ * of CPU in streaming profiles).
+ */
+function MarkdownImpl({ children, dimColor = false, cacheTokens = true }) {
+    const [highlight, setHighlight] = React.useState(null);
+    React.useEffect(() => {
+        let mounted = true;
+        void getCliHighlightPromise().then((loaded) => {
+            if (mounted)
+                setHighlight(loaded);
+        });
+        return () => {
+            mounted = false;
+        };
+    }, []);
+    configureMarked();
+    const renderedNodes = React.useMemo(() => {
+        const source = stripPromptXMLTags(children);
+        return renderTokensToNodes(lexWithCache(source, cacheTokens), highlight, dimColor);
+    }, [children, dimColor, highlight, cacheTokens]);
+    return (_jsx(Box, { flexDirection: "column", gap: 1, children: renderedNodes }));
+}
+/**
+ * Memoized Markdown: skips the whole token→ANSI→layout pipeline when the
+ * content string is the same reference (see MarkdownImpl's doc comment).
+ */
+export const Markdown = React.memo(MarkdownImpl, (prev, next) => prev.children === next.children &&
+    prev.dimColor === next.dimColor &&
+    prev.cacheTokens === next.cacheTokens);

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

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { Tokens } from 'marked';
+import type { CliHighlight } from '../terminal-utils/cliHighlight.js';
+type Props = {
+    token: Tokens.Table;
+    highlight: CliHighlight | null;
+    /** Override terminal width (useful for testing). */
+    forceWidth?: number;
+};
+/** Render a markdown table with ANSI-aware cells and a narrow-terminal fallback. */
+export declare function MarkdownTable({ token, highlight, forceWidth }: Props): React.ReactNode;
+export {};
+//# sourceMappingURL=MarkdownTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownTable.d.ts","sourceRoot":"","sources":["../../../src/components/MarkdownTable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAA;AAQ3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAMrE,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC,KAAK,CAAA;IACnB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;IAC9B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAuID,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAiDtF"}