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

package/lib/types/components/messages/subagentTranscript.js

@@ -0,0 +1,304 @@
+/**
+ * Fold, paging and live-merge helpers for a child's transcript, shared by
+ * the subagent Detail scene and the main-screen AgentTranscriptScene so a
+ * child row reads the same wherever it is shown.
+ */
+import React from 'react';
+import { ARGS_PREVIEW_LIMIT, preview, RESULT_PREVIEW_LIMIT } from '../../channel/transcript.js';
+/** Presentations that never earn a duplicate card here either (the main
+ *  projector's rule): a nested delegation renders as the subagent card, a
+ *  todo write lives in the todo panel, a question in its dialog. */
+export const TRANSCRIPT_SUPPRESSED_CARDS = new Set(['subagent', 'todo', 'question']);
+/** Settle a tool card with its recorded result. */
+function applyToolResult(tool, event) {
+    tool.durationMs = Math.max(0, event.time - tool.startedAt);
+    if (event.isError) {
+        tool.status = 'error';
+        tool.errorText = event.errorText ?? '';
+    }
+    else {
+        tool.status = 'ok';
+        tool.resultText = event.text !== '' ? preview(event.text, RESULT_PREVIEW_LIMIT) : undefined;
+        tool.resultFull = event.text !== '' ? event.text : undefined;
+        tool.resultView = event.presentation;
+    }
+}
+/** Fold one history page's lane events into leaf rows (oldest first;
+ *  `into` may already hold the older pages' rows). A tool result whose
+ *  call is not on this page goes to `page.orphans` (or is dropped without
+ *  one) until the older page with the call is folded; consecutive blocks
+ *  of one API message join (the store splits a message into per-block
+ *  entries sharing the anchor).
+ *
+ *  `messages` (the agent↔agent feed for THIS child, newest last) is
+ *  interleaved by observedAt: each is flushed as an `agent-message` leaf
+ *  before the first event observed at/after it. Only the messages that
+ *  fall inside this page's span are placed (see TranscriptPagePlacement),
+ *  so loading an older page never repeats one. Returns the lower bound of
+ *  the span this page took — the `before` for the next older page. */
+export function foldTranscriptLeaves(events, into, messages = [], page = {}) {
+    const start = events.find(event => eventTime(event) !== undefined);
+    const from = page.olderPagesRemain === true && start !== undefined ? eventTime(start) : Number.NEGATIVE_INFINITY;
+    const until = page.before ?? Number.POSITIVE_INFINITY;
+    const own = messages.filter(message => message.observedAt >= from && message.observedAt < until);
+    let next = 0;
+    const flushMessages = (before) => {
+        while (next < own.length && own[next].observedAt <= before) {
+            const message = own[next];
+            into.push({ kind: 'agent-message', key: `am-${message.messageId}`, message });
+            next += 1;
+        }
+    };
+    for (const event of events) {
+        const at = eventTime(event);
+        if (at !== undefined)
+            flushMessages(at);
+        if (event.type === 'tool.call') {
+            if (event.presentation !== undefined && TRANSCRIPT_SUPPRESSED_CARDS.has(event.presentation.card))
+                continue;
+            into.push({ kind: 'tool', key: event.callId, tool: {
+                    callId: event.callId,
+                    name: event.name,
+                    argsText: preview(event.argsJson, ARGS_PREVIEW_LIMIT),
+                    argsFull: event.argsJson,
+                    status: 'running',
+                    callView: event.presentation,
+                    startedAt: event.time,
+                } });
+            continue;
+        }
+        if (event.type === 'tool.result') {
+            let row;
+            for (let i = into.length - 1; i >= 0; i -= 1) {
+                const leaf = into[i];
+                if (leaf.kind === 'tool' && leaf.tool.callId === event.callId) {
+                    row = leaf;
+                    break;
+                }
+            }
+            if (row === undefined) {
+                page.orphans?.set(event.callId, event);
+                continue;
+            }
+            applyToolResult(row.tool, event);
+            continue;
+        }
+        if (event.type === 'assistant.message') {
+            for (const block of event.blocks) {
+                if (block.type === 'reasoning') {
+                    const last = into.at(-1);
+                    if (last !== undefined && last.kind === 'thinking' && last.key === event.anchor)
+                        last.text = last.text === '' ? block.text ?? '' : `${last.text}\n${block.text ?? ''}`;
+                    else
+                        into.push({ kind: 'thinking', key: event.anchor, text: block.text ?? '' });
+                    continue;
+                }
+                if (block.type === 'reasoning-tokens' || block.type === 'reasoning-signature') {
+                    into.push({ kind: 'thinking-unavailable', key: `${event.anchor}:ua`, tokens: block.type === 'reasoning-tokens' && Number.isFinite(Number(block.text)) ? Number(block.text) : undefined });
+                    continue;
+                }
+                if (block.type === 'text') {
+                    const last = into.at(-1);
+                    if (last !== undefined && last.kind === 'text' && last.key === event.anchor)
+                        last.text = `${last.text}\n${block.text ?? ''}`;
+                    else
+                        into.push({ kind: 'text', key: event.anchor, text: block.text ?? '' });
+                }
+            }
+        }
+    }
+    flushMessages(Number.POSITIVE_INFINITY);
+    return from;
+}
+const eventTime = (event) => event.type === 'tool.call' || event.type === 'tool.result' || event.type === 'assistant.message' ? event.time : undefined;
+/** The newest page of a child's transcript, folded. */
+export function foldNewestPage(agentId, page, messages) {
+    const leaves = [];
+    const orphans = new Map();
+    const messagesFrom = foldTranscriptLeaves(page.events, leaves, messages, { olderPagesRemain: page.hasOlder, orphans });
+    // The newest page can itself repeat one anchor (text, tool, text of one
+    // message): its rows carry unique render keys from the start.
+    return { status: 'ready', agentId, leaves: uniqueRenderKeys(leaves), parentAgentId: page.parentAgentId, hasOlder: page.hasOlder, skippedFromStart: page.skippedFromStart, ...(page.sourceCursor === undefined ? {} : { sourceCursor: page.sourceCursor }), loadingOlder: false, messagesFrom, orphanResults: orphans };
+}
+/** One older page folded in front of a loaded transcript: its agent
+ *  messages are the ones before the loaded span, and the results the newer
+ *  pages held for its calls settle those calls' cards. */
+export function foldOlderPage(current, page, messages) {
+    const fresh = [];
+    const orphans = new Map();
+    const messagesFrom = foldTranscriptLeaves(page.events, fresh, messages, { olderPagesRemain: page.hasOlder, before: current.messagesFrom, orphans });
+    const carried = new Map(current.orphanResults);
+    for (const leaf of fresh) {
+        if (leaf.kind !== 'tool')
+            continue;
+        const result = carried.get(leaf.tool.callId);
+        if (result === undefined)
+            continue;
+        applyToolResult(leaf.tool, result);
+        carried.delete(leaf.tool.callId);
+    }
+    for (const [callId, result] of orphans)
+        carried.set(callId, result);
+    const { sourceCursor: previousCursor, ...previous } = current;
+    return { ...previous, leaves: prependOlderLeaves(fresh, current.leaves), hasOlder: page.hasOlder, skippedFromStart: page.skippedFromStart, ...(page.sourceCursor === undefined ? {} : { sourceCursor: page.sourceCursor }), loadingOlder: false, messagesFrom, orphanResults: carried };
+}
+/** One load-older window (messages; matches the backend's newest page). */
+export const TRANSCRIPT_OLDER_CHUNK = 400;
+/** The retained output window both stores keep (channel/activity.ts and
+ *  dsh-adapter/subagents.ts): a tail at this size is a WINDOW, and the
+ *  output page says so when no transcript source can show the rest. */
+export const OUTPUT_WINDOW_CAP = 160;
+/** Render keys must be unique per row: the store's block-per-entry split can
+ *  repeat one anchor inside a page (a text, a tool and another text of one
+ *  message), so a repeated key gets an ordinal suffix; a leaf is never
+ *  dropped for its key. The first occurrence keeps its key, later ones are
+ *  copied. */
+export function uniqueRenderKeys(leaves) {
+    const seen = new Map();
+    return leaves.map(leaf => {
+        const n = seen.get(leaf.key) ?? 0;
+        seen.set(leaf.key, n + 1);
+        return n === 0 ? leaf : { ...leaf, key: `${leaf.key}#${n + 1}` };
+    });
+}
+/** Prepend one older page's folded leaves. The store splits one API message
+ *  into per-block entries sharing the anchor, so a block can only be cut
+ *  across pages at the boundary: the older page's last leaf against the
+ *  current list's first. Those two merge when they share the key and the
+ *  text/thinking kind (the fold already joined everything consecutive
+ *  within a page). Every other leaf keeps its own row in the older page's
+ *  order: a different kind under the same key is kept, and a tool between
+ *  two text parts of one message stays between them. No current leaf is
+ *  mutated. */
+export function prependOlderLeaves(fresh, current) {
+    let older = fresh;
+    let head = current;
+    const last = fresh.at(-1);
+    const first = current[0];
+    if (last !== undefined && first !== undefined &&
+        (first.kind === 'text' || first.kind === 'thinking') &&
+        first.kind === last.kind && first.key === last.key) {
+        // Same-kind boundary blocks of one message: one continuous block the
+        // page slice cut — the older text precedes, the order it was written in.
+        head = [{ ...first, text: `${last.text}\n${first.text}` }, ...current.slice(1)];
+        older = fresh.slice(0, -1);
+    }
+    return uniqueRenderKeys([...older, ...head]);
+}
+const capLike = (line) => (line.length > 400 ? `${line.slice(0, 400)}…` : line);
+/** Merge the channel's live window into the folded history: tool records
+ *  pair by call id (live status/previews win while the disk has not
+ *  recorded the result; a call the history never saw appends as live),
+ *  and text/thinking tail lines the loaded history already paints are
+ *  suppressed — a settled block's lines are identical on both sides — so
+ *  history and live neither double a row nor drop a tail. */
+export function mergeLiveWindow(leaves, subagent, hasHistory) {
+    const rows = [...leaves];
+    subagent.toolCalls.forEach((call, callIndex) => {
+        let at = -1;
+        for (let i = rows.length - 1; i >= 0; i -= 1) {
+            const row = rows[i];
+            if (row.kind === 'tool' && row.tool.callId === call.id) {
+                at = i;
+                break;
+            }
+        }
+        if (at >= 0) {
+            const leaf = rows[at];
+            // A copy: the history leaves are the transcript state, read again on
+            // every render — the live status only overlays them here.
+            if (leaf.tool.status === 'running' && call.status !== 'running') {
+                rows[at] = { ...leaf, tool: {
+                        ...leaf.tool,
+                        status: call.status === 'failed' ? 'error' : 'ok',
+                        errorText: call.error,
+                        resultText: call.resultPreview,
+                        ...(call.endedAt !== undefined ? { durationMs: Math.max(0, call.endedAt - leaf.tool.startedAt) } : {}),
+                    } };
+            }
+            return;
+        }
+        rows.push({ kind: 'tool', key: call.id ?? `live-call-${callIndex}`, tool: {
+                callId: call.id ?? call.name,
+                name: call.name,
+                argsText: call.argsPreview ?? '',
+                status: call.status === 'failed' ? 'error' : call.status === 'running' ? 'running' : 'ok',
+                startedAt: call.startedAt,
+                ...(call.endedAt !== undefined ? { durationMs: Math.max(0, call.endedAt - call.startedAt) } : {}),
+                ...(call.resultPreview !== undefined ? { resultText: call.resultPreview } : {}),
+                ...(call.error !== undefined ? { errorText: call.error } : {}),
+            } });
+    });
+    if (!hasHistory) {
+        for (const line of subagent.outputEvents)
+            rows.push({ kind: 'live', line });
+        return rows;
+    }
+    const seen = new Set();
+    for (const leaf of leaves) {
+        if (leaf.kind !== 'text' && leaf.kind !== 'thinking')
+            continue;
+        for (const line of leaf.text.split('\n'))
+            if (line.trim() !== '')
+                seen.add(capLike(line));
+    }
+    for (const line of subagent.outputEvents) {
+        if (line.text.trim() !== '' && seen.has(capLike(line.text)))
+            continue;
+        rows.push({ kind: 'live', line });
+    }
+    return rows;
+}
+/**
+ * The paged history of one child: loads the newest page while `active`,
+ * reloads once when `reloadKey` changes (settlement makes the disk copy
+ * final), and prepends older windows on demand.
+ *
+ * The loader and the message feed ride refs: the channel UI proxy mints a
+ * fresh loader per read, and a reload must key on what changed (the child,
+ * activation, settlement), not on a churning identity. An older window is
+ * dropped when the state it was requested for is gone (the view switched
+ * to another agent, or a reload moved the newest page under it).
+ */
+export function useSubagentTranscript(loadTranscript, agentId, active, reloadKey, messages) {
+    const [transcript, setTranscript] = React.useState({ status: 'idle' });
+    const loaderRef = React.useRef(loadTranscript);
+    loaderRef.current = loadTranscript;
+    const messagesRef = React.useRef(messages);
+    messagesRef.current = messages;
+    React.useEffect(() => {
+        const load = loaderRef.current;
+        if (!active || load === undefined)
+            return;
+        let alive = true;
+        setTranscript(prev => prev.status === 'ready' && prev.agentId === agentId ? prev : { status: 'loading' });
+        load(agentId).then(loaded => {
+            if (!alive)
+                return;
+            setTranscript(loaded === null ? { status: 'unavailable' } : foldNewestPage(agentId, loaded, messagesRef.current));
+        }, () => { if (alive)
+            setTranscript({ status: 'unavailable' }); });
+        return () => { alive = false; };
+    }, [active, agentId, reloadKey]);
+    const loadOlder = () => {
+        const load = loaderRef.current;
+        if (transcript.status !== 'ready' || !transcript.hasOlder || transcript.loadingOlder || load === undefined)
+            return;
+        const requestedFor = transcript;
+        const count = requestedFor.sourceCursor === undefined ? Math.min(TRANSCRIPT_OLDER_CHUNK, requestedFor.skippedFromStart) : TRANSCRIPT_OLDER_CHUNK;
+        setTranscript(prev => prev === requestedFor ? { ...prev, loadingOlder: true } : prev);
+        const current = (prev) => prev.status === 'ready' && prev.agentId === requestedFor.agentId && prev.skippedFromStart === requestedFor.skippedFromStart && prev.sourceCursor === requestedFor.sourceCursor;
+        load(requestedFor.agentId, { count, skipFromStart: requestedFor.skippedFromStart, ...(requestedFor.sourceCursor === undefined ? {} : { sourceCursor: requestedFor.sourceCursor }) }).then(older => {
+            setTranscript(prev => {
+                if (!current(prev))
+                    return prev;
+                if (older === null)
+                    return { ...prev, loadingOlder: false };
+                return foldOlderPage(prev, older, messagesRef.current);
+            });
+        }, () => {
+            setTranscript(prev => current(prev) ? { ...prev, loadingOlder: false } : prev);
+        });
+    };
+    return { transcript, loadOlder };
+}

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

@@ -0,0 +1,83 @@
+import type { LlmModelInfo, LlmProviderInfo } from '../adapter/ports/channel-view.js';
+import type { BalanceResult } from '../adapter/ports/channel-catalog.js';
+/** 引导的四个配置域，按"先解决拦路的事、再解决好不好看、最后解决怎么用"排。 */
+export declare const ONBOARDING_STEPS: readonly ["apikey", "look", "model", "keys"];
+export type OnboardingStep = (typeof ONBOARDING_STEPS)[number];
+/**
+ * 步骤条需要的**最小**尺寸：四步的标题横排（`❯ API Key 与连通性 · ...`）
+ * 在 76 列下会被截成残句，在 8 行下会把内容挤没——那时整条不画，进度改由
+ * 头部那行"第 N / 4 步"承担（信息不丢，只是换了个地方）。
+ */
+export declare const STEP_BAR_MIN_COLUMNS = 76;
+export declare const STEP_BAR_MIN_ROWS = 10;
+/** 第四步（招式卡）里的一张卡。 */
+export interface TutorialCard {
+    /** 稳定 id（"试过没有"记在它上面）。 */
+    readonly id: string;
+    readonly titleKey: string;
+    readonly descKey: string;
+    /**
+     * 可试的命令名（不含斜杠）；`undefined` = 只能读的键位卡。
+     *
+     * 键位卡故意不给"试一下"：`Esc` / `Ctrl+C` 只有在真回合里才有意义，在引导
+     * 里按下去要么没反应、要么把引导关掉——那是在骗人。命令卡则真的能开：
+     * 交给 Chat 的 `runCommand`，与手敲 `/help` 走同一条路。
+     */
+    readonly command?: string;
+    /** 键位卡的按键动作 id（`utils/keymap` 的 `ShortcutActionId`）。 */
+    readonly action?: 'cancel';
+    /** 纯字面量的键（`/` / `?` 这类不是可重绑动作的）。 */
+    readonly literal?: string;
+}
+/**
+ * 招式卡表：四张能**直接试用**的命令卡 + 两张只能读的键位卡。
+ * 顺序 = 使用频率，不按重要性；第一张是用户最先会需要的。
+ */
+export declare const TUTORIAL_CARDS: readonly TutorialCard[];
+/**
+ * 某一步的标题 key。
+ * @param step - 步骤 id。
+ * @returns 该步标题的 i18n key。
+ */
+export declare function stepTitleKey(step: OnboardingStep): string;
+/**
+ * 某一步的说明 key。
+ * @param step - 步骤 id。
+ * @returns 该步说明的 i18n key。
+ */
+export declare function stepDescKey(step: OnboardingStep): string;
+/** provider 分组（首现顺序，名字用注册表的，取不到就退回 route key）。 */
+export declare function modelGroupsOf(models: readonly LlmModelInfo[], providers: readonly LlmProviderInfo[]): readonly {
+    provider: string;
+    label: string;
+    count: number;
+}[];
+/**
+ * 余额显示串：取第一条，币种码直接用接口给的（不猜符号）。
+ *
+ * @param result - `channel.balanceInfo()` 的返回值。
+ * @returns `"CNY 110.00"` 这类串；没有可用条目时 `null`。
+ */
+export declare function formatBalance(result: BalanceResult): string | null;
+/**
+ * 连通性失败分类 → 可执行的下一步。
+ *
+ * 分类口径与 `BalanceResult.reason` 一一对应，因为"检查网络"这种话对
+ * `unauthorized` 的用户毫无用处——五种原因要指向五个不同的动作，这正是
+ * `BalanceResult` 分了五类的原因。
+ *
+ * @param reason - `BalanceResult.reason`。
+ * @param status - 非 2xx 时的状态码。
+ * @returns 给用户看的排查方向。
+ */
+export declare function connFailText(reason: string, status?: number): string;
+/**
+ * 凭证来源的显示文案。`CredentialStatus.source` 是 adapter 自己的口径
+ * （`'env'` / `'config'` / 其他），这里只做展示映射，认不出的值一律走
+ * "未知"而不是把原始串丢到界面上——那个串属于 adapter 内部词汇。
+ *
+ * @param source - `CredentialStatus.source`。
+ * @returns 一句中文/英文来源说明。
+ */
+export declare function credentialSourceText(source: string | undefined): string;
+//# sourceMappingURL=onboardingModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingModel.d.ts","sourceRoot":"","sources":["../../../src/components/onboardingModel.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAExE,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,8CAA+C,CAAA;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;IAI1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAOjD,CAAA;AAkBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAExD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAe/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAKlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CASpE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIvE"}

package/lib/types/components/onboardingModel.js

@@ -0,0 +1,128 @@
+/**
+ * Pure derivation for the first-run onboarding wizard, kept free of React and
+ * channel state so `scripts/verify-onboarding-wizard.tsx` can drive it
+ * headless (the `modelGroups.ts` precedent, for the same reason: the parts
+ * worth pinning are the ones with an opinion, not the JSX).
+ *
+ * @module dsh-tui/components/onboardingModel
+ */
+import { t } from '../i18n.js';
+/** 引导的四个配置域，按"先解决拦路的事、再解决好不好看、最后解决怎么用"排。 */
+export const ONBOARDING_STEPS = ['apikey', 'look', 'model', 'keys'];
+/**
+ * 步骤条需要的**最小**尺寸：四步的标题横排（`❯ API Key 与连通性 · ...`）
+ * 在 76 列下会被截成残句，在 8 行下会把内容挤没——那时整条不画，进度改由
+ * 头部那行"第 N / 4 步"承担（信息不丢，只是换了个地方）。
+ */
+export const STEP_BAR_MIN_COLUMNS = 76;
+export const STEP_BAR_MIN_ROWS = 10;
+/**
+ * 招式卡表：四张能**直接试用**的命令卡 + 两张只能读的键位卡。
+ * 顺序 = 使用频率，不按重要性；第一张是用户最先会需要的。
+ */
+export const TUTORIAL_CARDS = [
+    { id: 'cmd', titleKey: 'onboarding-card-cmd-title', descKey: 'onboarding-card-cmd-desc', literal: '/' },
+    { id: 'help', titleKey: 'onboarding-card-help-title', descKey: 'onboarding-card-help-desc', command: 'help', literal: '?' },
+    { id: 'model', titleKey: 'onboarding-card-model-title', descKey: 'onboarding-card-model-desc', command: 'model' },
+    { id: 'sessions', titleKey: 'onboarding-card-sessions-title', descKey: 'onboarding-card-sessions-desc', command: 'home' },
+    { id: 'rewind', titleKey: 'onboarding-card-rewind-title', descKey: 'onboarding-card-rewind-desc', command: 'rewind' },
+    { id: 'interrupt', titleKey: 'onboarding-card-interrupt-title', descKey: 'onboarding-card-interrupt-desc', action: 'cancel' },
+];
+/**
+ * 每一步的标题与说明 key，**写成字面量表而不是拼串**。
+ *
+ * 拼串（`` `onboarding-step-${step}-title` ``）能跑，但 `verify-i18n` 的死键
+ * 检查是**文本**检查：它按引号字面量找引用，拼出来的键在源码里不存在，只能
+ * 靠登记 `DYNAMIC_PREFIXES` 放行——那是一张"这里不检查"的白名单，放行一次就
+ * 少一处保护。这里总共只有八条，写成表既能被检查器看见，也让"哪一步用哪条
+ * 文案"一眼可读。
+ */
+const STEP_TEXT = {
+    apikey: { title: 'onboarding-step-apikey-title', desc: 'onboarding-step-apikey-desc' },
+    look: { title: 'onboarding-step-look-title', desc: 'onboarding-step-look-desc' },
+    model: { title: 'onboarding-step-model-title', desc: 'onboarding-step-model-desc' },
+    keys: { title: 'onboarding-step-keys-title', desc: 'onboarding-step-keys-desc' },
+};
+/**
+ * 某一步的标题 key。
+ * @param step - 步骤 id。
+ * @returns 该步标题的 i18n key。
+ */
+export function stepTitleKey(step) {
+    return STEP_TEXT[step].title;
+}
+/**
+ * 某一步的说明 key。
+ * @param step - 步骤 id。
+ * @returns 该步说明的 i18n key。
+ */
+export function stepDescKey(step) {
+    return STEP_TEXT[step].desc;
+}
+/** provider 分组（首现顺序，名字用注册表的，取不到就退回 route key）。 */
+export function modelGroupsOf(models, providers) {
+    const order = [];
+    const counts = new Map();
+    for (const model of models) {
+        if (!counts.has(model.provider)) {
+            order.push(model.provider);
+            counts.set(model.provider, 0);
+        }
+        counts.set(model.provider, counts.get(model.provider) + 1);
+    }
+    return order.map(provider => ({
+        provider,
+        label: providers.find(info => info.id === provider)?.name ?? provider,
+        count: counts.get(provider),
+    }));
+}
+/**
+ * 余额显示串：取第一条，币种码直接用接口给的（不猜符号）。
+ *
+ * @param result - `channel.balanceInfo()` 的返回值。
+ * @returns `"CNY 110.00"` 这类串；没有可用条目时 `null`。
+ */
+export function formatBalance(result) {
+    if (!result.ok)
+        return null;
+    const first = result.balances[0];
+    if (first === undefined)
+        return null;
+    return `${first.currency} ${first.total.toFixed(2)}`;
+}
+/**
+ * 连通性失败分类 → 可执行的下一步。
+ *
+ * 分类口径与 `BalanceResult.reason` 一一对应，因为"检查网络"这种话对
+ * `unauthorized` 的用户毫无用处——五种原因要指向五个不同的动作，这正是
+ * `BalanceResult` 分了五类的原因。
+ *
+ * @param reason - `BalanceResult.reason`。
+ * @param status - 非 2xx 时的状态码。
+ * @returns 给用户看的排查方向。
+ */
+export function connFailText(reason, status) {
+    switch (reason) {
+        case 'no-key': return t('onboarding-conn-fail-no-key');
+        case 'network': return t('onboarding-conn-fail-network');
+        case 'unauthorized': return t('onboarding-conn-fail-unauthorized');
+        case 'http': return t('onboarding-conn-fail-http', { status: status ?? 0 });
+        case 'invalid': return t('onboarding-conn-fail-invalid');
+        default: return t('onboarding-conn-fail-unknown');
+    }
+}
+/**
+ * 凭证来源的显示文案。`CredentialStatus.source` 是 adapter 自己的口径
+ * （`'env'` / `'config'` / 其他），这里只做展示映射，认不出的值一律走
+ * "未知"而不是把原始串丢到界面上——那个串属于 adapter 内部词汇。
+ *
+ * @param source - `CredentialStatus.source`。
+ * @returns 一句中文/英文来源说明。
+ */
+export function credentialSourceText(source) {
+    if (source === 'env')
+        return t('onboarding-key-source-env');
+    if (source === 'config')
+        return t('onboarding-key-source-config');
+    return t('onboarding-key-source-unknown');
+}

package/lib/types/components/questions/AskUserQuestionPanel.d.ts

@@ -10,6 +10,8 @@
  * appends into that input row (single-select also attaches the option's
  * label, so the answer can carry both `selected` and `custom`); focusing
  * the input row itself and typing gives a pure custom answer.
+ * Local /provider model lists additionally offer a Tab capability editor;
+ * ordinary questionnaires retain the inline-answer behavior.
  *
  * Paste works on the input row like the composer: Ctrl+V/Alt+V (the keymap
  * `paste` binding, remappable in /settings) reads the system clipboard,
@@ -25,7 +27,8 @@
  * never be split into a lone surrogate by ←/→/⌫/Del or a paste boundary.
  */
 import React from 'react';
-import type { QuestionDraft, QuestionSelection } from '../../dsh-adapter/questions.js';
+import type { QuestionDraft, QuestionSelection } from '../../channel/questions.js';
+import type { ProviderModelEditor as ModelEditor } from '../../adapter/ports/channel-settings.js';
 import { type ClipboardRead } from '../../utils/clipboard.js';
 export type AskUserQuestionPanelProps = {
     /** The question to render (from the QuestionStore snapshot). */
@@ -46,11 +49,23 @@ export type AskUserQuestionPanelProps = {
          *  (single-select) shown on first display, before any saved draft — e.g.
          *  the models already enabled on a provider being edited. */
         readonly defaultSelected?: readonly string[];
+        /** A URL the question is about (an MCP server's sign-in page): one line
+         *  under the detail, an OSC 8 hyperlink where the terminal supports it
+         *  (plain otherwise; a scheme that is not http(s)/file/mailto shows
+         *  nothing — the notice row still names it). */
+        readonly link?: string;
+        /** A secret answer (a token, a password): the input row shows one `•`
+         *  per typed code point; the submitted answer is the real text. */
+        readonly secret?: boolean;
+        /** Local /provider draft editor. Ordinary model-facing asks carry none. */
+        readonly modelEditor?: ModelEditor;
         /** Presentation intent tag (rc.6): 'plan-review' switches to the
          *  decision-card layout; an intent never changes the protocol. */
         readonly intent?: {
             readonly kind: 'plan-review';
             readonly approve: string;
+            readonly approveAlso?: readonly string[];
+            readonly decline?: string;
         };
     };
     /** 1-based position within the batch (progress header). */

package/lib/types/components/questions/AskUserQuestionPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AskUserQuestionPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/AskUserQuestionPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAMtF,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAuB5E,MAAM,MAAM,yBAAyB,GAAG;IACtC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;QAC9B;;oEAE4D;QAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;QAClC;;qEAE6D;QAC7D,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;QAC5C;0EACkE;QAClE,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;YAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7E,CAAA;IACD,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAClD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAChD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IACnD;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IAC7D;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IAClC;;gEAE4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B,CAAA;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,SAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,UAAkB,GACnB,EAAE,yBAAyB,GAAG,KAAK,CAAC,SAAS,CA2pB7C"}
+{"version":3,"file":"AskUserQuestionPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/AskUserQuestionPanel.tsx"],"names":[],"mappings":"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"}