@deepseek-harness-tui/dsh-tui 0.12.0 → 0.14.0

package/lib/types/components/diffPatch.js

@@ -0,0 +1,142 @@
+/**
+ * The `patch` branch of a {@link ToolFileDiff} (N5): one file's unified diff
+ * hunks, as a backend that only has the patch reports them (Codex
+ * `fileChange`: `@@ -1,3 +1,3 @@\n one\n-two\n+TWO\n three\n`, no file
+ * headers). Both diff renderers — the unified card body and the two-pane
+ * SplitDiffView — read the parsed form from here, so they agree on line
+ * numbers and on the `(+N -M)` stat.
+ *
+ * Parsing uses jsdiff's `parsePatch` (file headers are synthesized when the
+ * text has none). A hunk whose line counts disagree with its header makes
+ * `parsePatch` throw; such a patch, and a headerless one jsdiff cannot
+ * place, falls back to a lenient line walk under the same rules. An `add` /
+ * `delete` change whose text holds no hunk at all is the file's raw
+ * content (Codex reports a new file that way) and becomes one all-added /
+ * all-removed hunk. Anything still without hunks keeps its raw lines
+ * (`raw`), so nothing the backend sent is silently dropped.
+ *
+ * Results are cached by patch text (bounded): a running card re-renders
+ * every second, and the same patch must not be re-parsed each time.
+ */
+import * as JsDiff from 'diff';
+import { t } from '../i18n.js';
+/** Whether a file diff carries a unified patch (vs old/new texts). */
+export const isPatchDiff = (diff) => 'patch' in diff;
+const HUNK_HEADER = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/u;
+/** Number the lines of one hunk from its starts. */
+function numberHunk(oldStart, newStart, rawLines) {
+    const lines = [];
+    let oldNo = oldStart;
+    let newNo = newStart;
+    for (const raw of rawLines) {
+        const marker = raw[0];
+        const text = raw.slice(1);
+        if (marker === ' ')
+            lines.push({ kind: 'context', text, oldNo: oldNo++, newNo: newNo++ });
+        else if (marker === '-')
+            lines.push({ kind: 'del', text, oldNo: oldNo++ });
+        else if (marker === '+')
+            lines.push({ kind: 'add', text, newNo: newNo++ });
+        // `` and stray lines carry no content.
+    }
+    return { oldStart, newStart, lines };
+}
+/** A start line as a header states it: `-0,0` (nothing on that side) still
+ *  numbers the first line it would hold as 1. */
+const startOf = (start, count) => (count === 0 && start === 0 ? 1 : start);
+/** The lenient walk: every `@@` header opens a hunk; ` `/`-`/`+` lines
+ *  belong to it until the next header, whatever its counts claim. */
+function lenientHunks(text) {
+    const hunks = [];
+    let current;
+    const close = () => {
+        if (current !== undefined)
+            hunks.push(numberHunk(current.oldStart, current.newStart, current.lines));
+    };
+    for (const line of text.split('\n')) {
+        const header = HUNK_HEADER.exec(line);
+        if (header !== null) {
+            close();
+            current = {
+                oldStart: startOf(Number(header[1]), header[2] === undefined ? undefined : Number(header[2])),
+                newStart: startOf(Number(header[3]), header[4] === undefined ? undefined : Number(header[4])),
+                lines: [],
+            };
+        }
+        else if (current !== undefined && (line.startsWith(' ') || line.startsWith('-') || line.startsWith('+') || line.startsWith('\\'))) {
+            current.lines.push(line);
+        }
+    }
+    close();
+    return hunks;
+}
+/** jsdiff's reading of the patch; undefined when it refuses it. */
+function jsdiffHunks(text, path) {
+    // Synthesize the file headers jsdiff expects before the first hunk.
+    const first = text.search(/^@@ /mu);
+    const preamble = first === -1 ? text : text.slice(0, first);
+    const withHeaders = /^--- /mu.test(preamble) ? text : `--- a/${path}\n+++ b/${path}\n${text}`;
+    try {
+        const files = JsDiff.parsePatch(withHeaders);
+        return files.flatMap(file => file.hunks.map(hunk => numberHunk(hunk.oldStart, hunk.newStart, hunk.lines)));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A raw-content add/delete as one hunk of added/removed lines. */
+function contentHunk(text, kind) {
+    const body = text.endsWith('\n') ? text.slice(0, -1) : text;
+    const marker = kind === 'add' ? '+' : '-';
+    return numberHunk(1, 1, body === '' ? [] : body.split('\n').map(line => `${marker}${line}`));
+}
+const CACHE_LIMIT = 64;
+const cache = new Map();
+/** Parse one file's patch (cached by its text, path and change kind). */
+export function parseFilePatch(diff) {
+    const key = `${diff.change ?? ''}\u0000${diff.path}\u0000${diff.patch}`;
+    const known = cache.get(key);
+    if (known !== undefined)
+        return known;
+    let hunks = /^@@ -\d/mu.test(diff.patch) ? jsdiffHunks(diff.patch, diff.path) ?? lenientHunks(diff.patch) : [];
+    if (hunks.length === 0 && (diff.change === 'add' || diff.change === 'delete') && diff.patch !== '')
+        hunks = [contentHunk(diff.patch, diff.change)];
+    let added = 0;
+    let removed = 0;
+    let maxLineNo = 0;
+    for (const hunk of hunks) {
+        for (const line of hunk.lines) {
+            if (line.kind === 'add')
+                added += 1;
+            else if (line.kind === 'del')
+                removed += 1;
+            maxLineNo = Math.max(maxLineNo, line.oldNo ?? 0, line.newNo ?? 0);
+        }
+    }
+    const raw = hunks.length === 0 && diff.patch.trim() !== '' ? diff.patch.replace(/\n$/u, '').split('\n') : undefined;
+    const parsed = { hunks, added, removed, maxLineNo, ...(raw === undefined ? {} : { raw }) };
+    if (cache.size >= CACHE_LIMIT)
+        cache.delete(cache.keys().next().value);
+    cache.set(key, parsed);
+    return parsed;
+}
+/** A moved file's destination (absent when it did not move). */
+const movedTo = (diff) => diff.movePath === undefined || diff.movePath === diff.path ? undefined : diff.movePath;
+/** The change-kind word of an added / deleted file. */
+const changeLabel = (diff) => diff.change === 'add' ? t('diff-patch-added') : diff.change === 'delete' ? t('diff-patch-deleted') : undefined;
+export function patchHeader(diff, parsed, multiFile) {
+    const moved = movedTo(diff);
+    const label = changeLabel(diff);
+    const stat = `(+${parsed.added} -${parsed.removed})`;
+    if (multiFile) {
+        return {
+            kind: 'path',
+            path: moved === undefined ? diff.path : `${diff.path} → ${moved}`,
+            target: moved ?? diff.path,
+            suffix: `${label === undefined ? '' : ` · ${label}`} ${stat}`,
+        };
+    }
+    return { kind: 'stat', text: [moved === undefined ? undefined : `→ ${moved}`, label, stat].filter((part) => part !== undefined).join(' ') };
+}
+/** The plain text of a header (split view separators, tests). */
+export const patchHeaderText = (header) => header.kind === 'path' ? `${header.path}${header.suffix}` : header.text;

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

@@ -0,0 +1,48 @@
+/** Kernel rows shared by the launchpad and picker. Detection is supplied by the host. */
+import { type KernelBackendId } from '../kernelPrefs.js';
+export { kernelDisplayName } from '../kernelPrefs.js';
+export type KernelUnavailableReason = 'kernel-unavailable-not-installed' | 'kernel-unavailable-auth-missing' | 'kernel-probing'
+/** The installable variant of not-installed: the row stays dim but Enter
+ *  opens the SDK install wizard instead of a dead-end toast. */
+ | 'kernel-not-installed-installable'
+/** Installed, but older than the backend supports (its hint says how to upgrade). */
+ | 'kernel-unavailable-too-old';
+/** Product-qualified version; unknown kernels keep the raw version. */
+export declare function kernelVersionLabel(id: string, version?: string): string | undefined;
+export interface KernelOption {
+    readonly id: KernelBackendId;
+    readonly labelKey: string;
+    readonly current: boolean;
+    readonly selectable: boolean;
+    readonly reasonKey?: KernelUnavailableReason;
+    /** A selectable row's caveat (signed out, but `/login` works in-session). */
+    readonly noteKey?: 'kernel-login-in-session';
+    /** An unavailable row's own guidance from detection (install / upgrade). */
+    readonly hint?: string;
+    readonly version?: string;
+    /** Not installed, but the host can install it (Enter opens the wizard). */
+    readonly installable?: boolean;
+}
+export interface KernelStatus {
+    readonly installed: boolean;
+    readonly auth?: 'ok' | 'missing' | 'unknown';
+    readonly version?: string;
+    /** A missing credential can be supplied after start (BackendDetection). */
+    readonly loginInSession?: true;
+    /** Detection's install / upgrade / sign-in guidance. */
+    readonly hint?: string;
+}
+/** DSH is always available. Optional kernels stay disabled until detection completes. */
+export declare function buildKernelCatalog(input: {
+    readonly current: string;
+    readonly dshVersion?: string;
+    readonly statuses?: Readonly<Record<string, KernelStatus>>;
+    /** The host provides an install path (the wizard callbacks): a dim
+     *  not-installed row of a kernel the wizard can install
+     *  (`KERNEL_INFO[id].installable`) then says "press Enter to install"
+     *  instead of a dead-end reason. */
+    readonly canInstallSdk?: boolean;
+}): readonly KernelOption[];
+/** Join the available version and unavailability reason without an empty subtitle. */
+export declare function kernelSubtitle(option: KernelOption, reason: (key: KernelUnavailableReason | 'kernel-login-in-session') => string): string | undefined;
+//# sourceMappingURL=kernelCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kernelCatalog.d.ts","sourceRoot":"","sources":["../../../src/components/kernelCatalog.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,uBAAuB,GAC/B,kCAAkC,GAClC,iCAAiC,GACjC,gBAAgB;AAClB;gEACgE;GAC9D,kCAAkC;AACpC,qFAAqF;GACnF,4BAA4B,CAAA;AAEhC,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnF;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAA;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAA;IAC5C,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAC1D;;;wCAGoC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACjC,GAAG,SAAS,YAAY,EAAE,CA+B1B;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,CAAC,GAAG,EAAE,uBAAuB,GAAG,yBAAyB,KAAK,MAAM,GAC3E,MAAM,GAAG,SAAS,CAMpB"}

package/lib/types/components/kernelCatalog.js

@@ -0,0 +1,53 @@
+/** Kernel rows shared by the launchpad and picker. Detection is supplied by the host. */
+import { KERNEL_IDS, KERNEL_INFO, isKernelId } from '../kernelPrefs.js';
+export { kernelDisplayName } from '../kernelPrefs.js';
+/** Product-qualified version; unknown kernels keep the raw version. */
+export function kernelVersionLabel(id, version) {
+    if (version === undefined || version === '')
+        return undefined;
+    return isKernelId(id) ? KERNEL_INFO[id].product + ' v' + version : version;
+}
+/** DSH is always available. Optional kernels stay disabled until detection completes. */
+export function buildKernelCatalog(input) {
+    return KERNEL_IDS.map(id => {
+        const status = input.statuses?.[id];
+        const signInLater = status?.auth === 'missing' && status.loginInSession === true;
+        const selectable = id === 'dsh' || (status !== undefined && status.installed && (status.auth !== 'missing' || signInLater));
+        // `!selectable` already implies `id !== 'dsh'` (the DSH row is always
+        // selectable), so an unselectable, undetected row is an install miss.
+        const installable = !selectable && status !== undefined && !status.installed && input.canInstallSdk === true && KERNEL_INFO[id].installable;
+        const reasonKey = status === undefined
+            ? 'kernel-probing'
+            : installable
+                ? 'kernel-not-installed-installable'
+                : status.installed && status.auth === 'missing'
+                    ? 'kernel-unavailable-auth-missing'
+                    // Not installed but a version was read: the binary is too old.
+                    : id === 'codex' && !status.installed && status.version !== undefined
+                        ? 'kernel-unavailable-too-old'
+                        : 'kernel-unavailable-not-installed';
+        const version = kernelVersionLabel(id, id === 'dsh' ? input.dshVersion : status?.version);
+        return {
+            id,
+            labelKey: KERNEL_INFO[id].labelKey,
+            current: input.current === id,
+            selectable,
+            ...(selectable ? {} : { reasonKey }),
+            ...(selectable || status?.hint === undefined || status.hint === '' ? {} : { hint: status.hint }),
+            ...(selectable && signInLater ? { noteKey: 'kernel-login-in-session' } : {}),
+            ...(installable ? { installable } : {}),
+            ...(version === undefined ? {} : { version }),
+        };
+    });
+}
+/** Join the available version and unavailability reason without an empty subtitle. */
+export function kernelSubtitle(option, reason) {
+    const parts = [];
+    if (option.version !== undefined && option.version !== '')
+        parts.push(option.version);
+    if (option.reasonKey !== undefined)
+        parts.push(reason(option.reasonKey));
+    if (option.noteKey !== undefined)
+        parts.push(reason(option.noteKey));
+    return parts.length === 0 ? undefined : parts.join(' \u00b7 ');
+}

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

@@ -0,0 +1,80 @@
+/**
+ * 落地页的一个动作入口（第四版：状态驱动的"下一步建议"）。
+ *
+ * 动作走命令名（第七版表 + 内核入口：continue / home / settings / backend
+ * / jobs / update / star / help）——除 backend 外全部是既有命令；backend 打开
+ * 内核选择器（选择器渲染与 runCommand 处理在 Chat 侧）。它把"当前状态下最
+ * 可能的下一步"摆到台面上。知道了名字，键盘用户直接敲；鼠标用户点一下，
+ * 两条路落到同一个 `runCommand`。
+ */
+export interface LaunchpadAction {
+    /** 稳定的行标识（焦点、`key` 都用它）。 */
+    readonly id: string;
+    /** i18n key：那一行的短标签。 */
+    readonly labelKey: string;
+    /** i18n 插值参数（目前只有 Continue 带会话标题）。 */
+    readonly values?: Readonly<Record<string, string>>;
+    /** 点击/回车时交给 `Chat.runCommand` 的命令名（不含斜杠）。 */
+    readonly command: string;
+}
+/**
+ * resolveLaunchpadActions 的输入——一次启动的状态快照。
+ *
+ * 第七版：每个字段都来自**既有**数据源（不造假）：
+ *   - `lastSessionTitle`：会话名册（`channel.agentViewRows`，含持久化会话）
+ *     里最近一条**可继续**会话的标题；没有就没有 Continue（不放假动作）；
+ *   - `jobsRunning`：`channel.backgroundJobs` 里有 running/stopping 的任务；
+ *   - `updateAvailable`：`checkForTuiUpdate()`（src/update.ts，与 /update
+ *     同一条判定）在启动页挂起时异步探得的新版本；
+ *   - `starDue`：`usageStats`（~/.dsh-tui/usage.json）有**未报过的**已达档
+ *     里程碑（首档 24h）且本进程尚未 star 成功——口径与开屏求 star 弹窗
+ *     完全一致（pendingStarMilestone + starred）。
+ */
+export interface LaunchpadActionState {
+    /** 最近一条可继续会话的标题；没有（或为空）视为"无历史"，整格不画。 */
+    readonly lastSessionTitle?: string | undefined;
+    /** 有后台任务在跑（条件位①）。 */
+    readonly jobsRunning: boolean;
+    /** 检测到可用更新（条件位②）。 */
+    readonly updateAvailable: boolean;
+    /** 用量到档且从未 star（条件位③）。 */
+    readonly starDue: boolean;
+    /** 当前内核（channel.backendCapabilities.backendId）；缺省 = 未知，内核
+     *  入口用不带名的短标签。 */
+    readonly backendId?: string | undefined;
+}
+/** Continue 标题的截断上限（显示宽度，含截断省略号）。 */
+export declare const LAUNCHPAD_CONTINUE_TITLE_MAX = 16;
+/**
+ * 截断会话标题：按显示宽度（CJK 双宽）从头部取，超宽补 `…`。
+ * 纯函数、无副作用，表驱动回归直接钉它的边界。
+ */
+export declare function truncateContinueTitle(title: string, max?: number): string;
+/**
+ * 落地页第七版的核心纯函数：按状态快照决定入口行放什么。
+ *
+ * 版面（用户拍板的四格 + 内核入口；第一格条件性缺席，最多五格）：
+ *
+ *   1. `继续「<标题>」` —— 有可继续会话才画（无历史不放假动作）；
+ *      快捷键 Alt+R（keymap 的 `continue` 动作，见 utils/keymap.ts）。
+ *   2. `会话与工作区` —— 历史会话 + 工作区合并入口；命令用既有 `home`。
+ *   3. `设置` —— /settings。
+ *   4. `内核` —— 打开内核选择器（backendId 已知时「内核 · Claude」；选择
+ *      器本体在 Chat 侧渲染）。窄屏装不下时它排在条件位**之后**被裁——
+ *      fitChips 整条取舍，条件位先让位。
+ *   5. 条件位，**按优先级取第一个成立者**（同时成立时高优先级胜出，
+ *      回归按这张优先级表驱动）：
+ *        ① jobsRunning → `后台任务`（/jobs）
+ *        ② updateAvailable → `有新版本`（/update，走既有更新路径）
+ *        ③ starDue → `投喂一颗 Star`（/star）
+ *        ④ 都不成立 → `帮助`（/help）兜底。
+ *
+ * 第六版的 doctor 入口已删（第七版）：它的输出属于转录区，天然把人带进
+ * 对话页，不适合留在"Esc 必须回启动页"的这一屏；首启/配置问题专属按钮
+ * 也随之退役——首启由引导向导（盖在落地页之上）承担，provider 配置经
+ * 向导或 /settings 可达。输出恒 ≤5 条。
+ *
+ * 纯函数：不改入参、不读环境、同样输入恒同样输出——表驱动回归钉死每个状态。
+ */
+export declare function resolveLaunchpadActions(state: LaunchpadActionState): readonly LaunchpadAction[];
+//# sourceMappingURL=launchpadActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launchpadActions.d.ts","sourceRoot":"","sources":["../../../src/components/launchpadActions.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9C,qBAAqB;IACrB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,qBAAqB;IACrB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;sBACkB;IAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED,qCAAqC;AACrC,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAA+B,GAAG,MAAM,CAY/F;AA8DD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,eAAe,EAAE,CAwB/F"}

package/lib/types/components/launchpadActions.js

@@ -0,0 +1,133 @@
+import { stringWidth } from '../ink/stringWidth.js';
+import { kernelDisplayName } from './kernelCatalog.js';
+/** Continue 标题的截断上限（显示宽度，含截断省略号）。 */
+export const LAUNCHPAD_CONTINUE_TITLE_MAX = 16;
+/**
+ * 截断会话标题：按显示宽度（CJK 双宽）从头部取，超宽补 `…`。
+ * 纯函数、无副作用，表驱动回归直接钉它的边界。
+ */
+export function truncateContinueTitle(title, max = LAUNCHPAD_CONTINUE_TITLE_MAX) {
+    const clean = title.replace(/[\r\n]+/gu, ' ').trim();
+    if (stringWidth(clean) <= max)
+        return clean;
+    let width = 0;
+    let out = '';
+    for (const ch of Array.from(clean)) {
+        const w = stringWidth(ch);
+        if (width + w > max - 1)
+            break;
+        out += ch;
+        width += w;
+    }
+    return out + '…';
+}
+/** Continue（不带标题时的短标签）。 */
+const CONTINUE = {
+    id: 'continue',
+    labelKey: 'launchpad-action-continue',
+    command: 'continue',
+};
+/**
+ * 会话与工作区（第七版合并入口）：历史会话与工作区本来就是同一个界面
+ * （`/home` 的会话名册 = 工作区首页，见 Chat 的 resume/home/agentview 合一
+ * 注释），两个按钮进同一个页面——用户实测后要求合并只留一个。命令用
+ * 既有的 `home` 那条。
+ */
+const SESSIONS_WORKSPACE = {
+    id: 'sessions-workspace',
+    labelKey: 'launchpad-action-sessions-workspace',
+    command: 'home',
+};
+/** Settings（用户拍板的第三格）。 */
+const SETTINGS = {
+    id: 'settings',
+    labelKey: 'launchpad-action-settings',
+    command: 'settings',
+};
+/**
+ * 内核（第四格，固定入口）：打开内核选择器。当前内核已知时带名
+ * （「内核 · Claude」），未知（接线前）用短标签——kernelCatalog 的
+ * displayName 是品牌名的唯一来源。
+ */
+const BACKEND = {
+    id: 'backend',
+    labelKey: 'launchpad-action-backend',
+    // 命令名 = /kernel（LOCAL_COMMANDS 的登记名，requirement 'any'）：入口、
+    // 手敲命令与 Chat 的 case 'kernel' 三条路同一个名字，不给第二个别名。
+    command: 'kernel',
+};
+/** 条件位①：有后台任务在跑。 */
+const JOBS = {
+    id: 'jobs',
+    labelKey: 'launchpad-action-jobs',
+    command: 'jobs',
+};
+/** 条件位②：检测到可用更新。 */
+const UPDATE = {
+    id: 'update',
+    labelKey: 'launchpad-action-update',
+    command: 'update',
+};
+/** 条件位③：用量到档且从未 star。 */
+const STAR = {
+    id: 'star',
+    labelKey: 'launchpad-action-star',
+    command: 'star',
+};
+/** Help（? 快捷键与命令）——条件位的兜底。 */
+const HELP = {
+    id: 'help',
+    labelKey: 'launchpad-action-help',
+    command: 'help',
+};
+/**
+ * 落地页第七版的核心纯函数：按状态快照决定入口行放什么。
+ *
+ * 版面（用户拍板的四格 + 内核入口；第一格条件性缺席，最多五格）：
+ *
+ *   1. `继续「<标题>」` —— 有可继续会话才画（无历史不放假动作）；
+ *      快捷键 Alt+R（keymap 的 `continue` 动作，见 utils/keymap.ts）。
+ *   2. `会话与工作区` —— 历史会话 + 工作区合并入口；命令用既有 `home`。
+ *   3. `设置` —— /settings。
+ *   4. `内核` —— 打开内核选择器（backendId 已知时「内核 · Claude」；选择
+ *      器本体在 Chat 侧渲染）。窄屏装不下时它排在条件位**之后**被裁——
+ *      fitChips 整条取舍，条件位先让位。
+ *   5. 条件位，**按优先级取第一个成立者**（同时成立时高优先级胜出，
+ *      回归按这张优先级表驱动）：
+ *        ① jobsRunning → `后台任务`（/jobs）
+ *        ② updateAvailable → `有新版本`（/update，走既有更新路径）
+ *        ③ starDue → `投喂一颗 Star`（/star）
+ *        ④ 都不成立 → `帮助`（/help）兜底。
+ *
+ * 第六版的 doctor 入口已删（第七版）：它的输出属于转录区，天然把人带进
+ * 对话页，不适合留在"Esc 必须回启动页"的这一屏；首启/配置问题专属按钮
+ * 也随之退役——首启由引导向导（盖在落地页之上）承担，provider 配置经
+ * 向导或 /settings 可达。输出恒 ≤5 条。
+ *
+ * 纯函数：不改入参、不读环境、同样输入恒同样输出——表驱动回归钉死每个状态。
+ */
+export function resolveLaunchpadActions(state) {
+    const conditional = state.jobsRunning
+        ? JOBS
+        : state.updateAvailable
+            ? UPDATE
+            : state.starDue
+                ? STAR
+                : HELP;
+    // 内核入口：当前内核已知 → 带名（「内核 · Claude」）；未知（Chat 侧接线
+    // 前）→ 短标签。显示名走 kernelCatalog，与选择器和重启通知同源。
+    const backend = state.backendId === undefined
+        ? BACKEND
+        : { ...BACKEND, labelKey: 'launchpad-action-backend-named', values: { name: kernelDisplayName(state.backendId) } };
+    const title = truncateContinueTitle(state.lastSessionTitle ?? '');
+    if (title !== '') {
+        return [
+            { ...CONTINUE, labelKey: 'launchpad-action-continue-titled', values: { title } },
+            SESSIONS_WORKSPACE,
+            SETTINGS,
+            backend,
+            conditional,
+        ];
+    }
+    return [SESSIONS_WORKSPACE, SETTINGS, backend, conditional];
+}

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

@@ -0,0 +1,62 @@
+import type { SplashFont } from './splashFonts.js';
+/** 输入框卡片占的行数：边框 2 + 输入 1（第三版：参数行移出框外）。 */
+export declare const CARD_ROWS = 3;
+/** 框下参数行的行数（模型/思考深度/模式/权限全空时整行不画）。 */
+export declare const PARAM_ROWS = 1;
+/** 该尺寸下渲染哪一档。 */
+export type LaunchpadStage = 'full' | 'no-tip' | 'no-hints' | 'no-art' | 'input-only';
+/** 一屏落地页在该尺寸下要渲染哪些部件。 */
+export interface LaunchpadLayout {
+    /** 整块撤的顺序档位。 */
+    readonly stage: LaunchpadStage;
+    /** 渲染像素鲸鱼 / 女仆娘立绘（宽轴决定；窄了不画，免得被裁）。 */
+    readonly showWhale: boolean;
+    /** 渲染 DEEPSEEK / HARNESS 块体大字。 */
+    readonly showBigTitle: boolean;
+    /** 大字放不下、立绘也放不下：退化成一行纯文字标题。 */
+    readonly showPlainTitle: boolean;
+    /** 头部整块是否渲染。 */
+    readonly showHero: boolean;
+    /** 键帽按钮行（框下成组行的第二行，右对齐）。 */
+    readonly showHints: boolean;
+    /** 居中 Tips 行（成组行的第三行）。 */
+    readonly showTip: boolean;
+    /**
+     * 参数行与入口行之间的呼吸留白行数（0 或 1）：默认 1；矮屏阶梯里排在
+     * Tips 之后、键帽行之前被撤掉。参数行缺席时恒 0（没有可隔开的两行）。
+     */
+    readonly hintsGapRows: number;
+    /**
+     * 词标与输入框之间的呼吸留白行数（1 或 2，第六版默认 2——刻意的呼吸感，
+     * 不是遗漏）：矮屏阶梯里先于 Tips 行被撤回紧档 1。
+     */
+    readonly heroGapRows: number;
+    /**
+     * 入口行与 Tips 行之间的呼吸留白行数（1 或 2，第六版默认 2）：矮屏阶梯
+     * 里先于 Tips 行被撤回紧档 1（Tips 行本身更晚才整行撤掉）。
+     */
+    readonly tipGapRows: number;
+    /** 双角铭牌行（永远画：它是这一屏的底边锚点）。 */
+    readonly showCorners: boolean;
+    /** 输入框卡片占的行数（边框 2 + 输入 1，恒 3）。 */
+    readonly cardRows: number;
+    /** 头部本体占的行数（不含 LogoV2 根盒的 marginTop）。 */
+    readonly heroRows: number;
+    /** 内容总行数——测试用来钉死这一档真的放得下。 */
+    readonly totalRows: number;
+}
+/**
+ * @param columns - 内容区列数。
+ * @param rows - 内容区行数。
+ * @param options - whale / whaleGirl 对应设置项；font 是当天那款字体（字身宽度
+ *   不同，宽轴阈值也跟着不同）；params 是框下有没有参数行（模型/思考深度/模式/
+ *   权限全拿不到时为 false，成组行矮一行）。
+ * @returns 该尺寸下要渲染的部件。
+ */
+export declare function resolveLaunchpadLayout(columns: number, rows: number, options: {
+    whale: boolean;
+    whaleGirl?: boolean;
+    font: SplashFont;
+    params?: boolean;
+}): LaunchpadLayout;
+//# sourceMappingURL=launchpadLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launchpadLayout.d.ts","sourceRoot":"","sources":["../../../src/components/launchpadLayout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AA0ClD,0CAA0C;AAC1C,eAAO,MAAM,SAAS,IAAI,CAAA;AAC1B,sCAAsC;AACtC,eAAO,MAAM,UAAU,IAAI,CAAA;AAwC3B,iBAAiB;AACjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAA;AAErF,yBAAyB;AACzB,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACnF,eAAe,CAwFjB"}