@bubblebrain-ai/bubble 0.0.63 → 0.0.65

package/dist/tui/components/feedback-dialog.js

@@ -0,0 +1,262 @@
+import chalk from "chalk";
+import { Editor, matchesKey, wrapTextWithAnsi, } from "@bubblebrain-ai/pi-tui";
+import { FeedbackSubmitError, submitFeedback } from "../../feedback/submit.js";
+import { redact } from "../../feedback/redact.js";
+import { createComposerEditorTheme } from "../composer-style.js";
+import { darkTheme } from "../model/theme.js";
+import { themeDim, themeForeground } from "../model/theme-style.js";
+import { paintSheetLine, padSheetLine, safeSheetText } from "./bottom-sheet.js";
+/** Full-width, review-before-submit feedback workflow for the Pi TUI. */
+export class FeedbackDialogComponent {
+    base;
+    options;
+    editor;
+    stage = "edit";
+    showPreview = false;
+    previewOffset = 0;
+    previewRows = 0;
+    previewContentRows = 0;
+    validationMessage;
+    finalResult;
+    hasFocus = false;
+    dismissed = false;
+    constructor(tui, base, initialDescription, options) {
+        this.base = base;
+        this.options = options;
+        this.editor = new Editor(tui, createComposerEditorTheme(() => this.theme()), {
+            borderStyle: "box",
+            paddingX: 1,
+            prompt: "",
+            autocompletePlacement: "below",
+            autocompleteBorderStyle: "none",
+        });
+        this.editor.setText(safeSheetText(initialDescription));
+        this.editor.onChange = (value) => {
+            this.previewOffset = 0;
+            if (value.trim() || this.base.transcript.length > 0)
+                this.validationMessage = undefined;
+        };
+    }
+    get focused() {
+        return this.hasFocus;
+    }
+    set focused(value) {
+        this.hasFocus = value;
+        this.editor.focused = value && this.stage === "edit" && !this.showPreview;
+    }
+    render(width) {
+        const theme = this.theme();
+        const safeWidth = Math.max(1, width);
+        const terminalRows = Math.max(1, this.options.getTerminalRows());
+        const sheetRows = terminalRows > 1 ? Math.min(22, terminalRows - 1) : 1;
+        const showHelp = sheetRows >= 4;
+        const panelBudget = Math.max(1, sheetRows - (showHelp ? 1 : 0));
+        const panel = this.stage === "submitting"
+            ? this.renderSubmitting(safeWidth, panelBudget, theme)
+            : this.stage === "done"
+                ? this.renderDone(safeWidth, panelBudget, theme)
+                : this.showPreview
+                    ? this.renderPreview(safeWidth, panelBudget, theme)
+                    : this.renderEditor(safeWidth, panelBudget, theme);
+        const painted = panel.map((line) => paintSheetLine(line, safeWidth, false, theme));
+        if (!showHelp)
+            return painted;
+        return [...painted, themeDim(theme.dim, padSheetLine(this.helpText(), safeWidth))];
+    }
+    handleInput(data) {
+        if (this.dismissed)
+            return;
+        if (this.stage === "submitting")
+            return;
+        if (this.stage === "done") {
+            if (matchesKey(data, "enter") || matchesKey(data, "escape") || data === " ")
+                this.dismiss();
+            return;
+        }
+        if (matchesKey(data, "escape")) {
+            this.options.onResult({ kind: "cancelled" });
+            this.dismiss();
+            return;
+        }
+        if (matchesKey(data, "tab")) {
+            this.showPreview = !this.showPreview;
+            this.editor.focused = this.hasFocus && !this.showPreview;
+            this.previewOffset = 0;
+            this.options.onRender();
+            return;
+        }
+        if (matchesKey(data, "ctrl+s") || matchesKey(data, "ctrl+d")) {
+            this.startSubmit();
+            return;
+        }
+        if (this.showPreview) {
+            if (matchesKey(data, "up") || data === "k") {
+                this.previewOffset = Math.max(0, this.previewOffset - 1);
+            }
+            else if (matchesKey(data, "down") || data === "j") {
+                this.previewOffset = Math.min(this.maxPreviewOffset(), this.previewOffset + 1);
+            }
+            return;
+        }
+        if (matchesKey(data, "enter")) {
+            this.editor.insertTextAtCursor("\n");
+            return;
+        }
+        this.editor.handleInput(data);
+    }
+    invalidate() {
+        this.editor.invalidate();
+    }
+    startSubmit() {
+        const payload = this.payload();
+        if (!payload.description && payload.transcript.length === 0) {
+            this.validationMessage = "Describe the issue before submitting.";
+            this.showPreview = false;
+            this.editor.focused = this.hasFocus;
+            this.options.onRender();
+            return;
+        }
+        this.validationMessage = undefined;
+        this.stage = "submitting";
+        this.editor.focused = false;
+        this.options.onRender();
+        const submit = this.options.submit ?? submitFeedback;
+        void submit(payload).then((result) => {
+            this.finalResult = { kind: "success", url: result.url, number: result.number };
+            this.stage = "done";
+            this.options.onResult(this.finalResult);
+            this.options.onRender();
+        }).catch((error) => {
+            const message = error instanceof FeedbackSubmitError
+                ? error.message
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            this.finalResult = { kind: "error", message };
+            this.stage = "done";
+            this.options.onResult(this.finalResult);
+            this.options.onRender();
+        });
+    }
+    payload() {
+        return {
+            description: redact(safeSheetText(this.editor.getExpandedText()).trim()),
+            ...this.base,
+        };
+    }
+    renderEditor(width, budget, theme) {
+        const indentWidth = width >= 12 ? 2 : width >= 3 ? 1 : 0;
+        const indent = " ".repeat(indentWidth);
+        const contentWidth = Math.max(1, width - indentWidth * 2);
+        const stats = this.transcriptStats();
+        const title = `${indent}${chalk.bold(themeForeground(theme.inputText, "Send feedback"))}`;
+        const warning = `${indent}${themeForeground(theme.warning, "Creates a PUBLIC GitHub issue. Review the payload before sending.")}`;
+        const label = `${indent}${themeForeground(theme.muted, "Describe what happened:")}`;
+        const meta = `${indent}${themeDim(theme.dim, `Included: v${this.base.version} · ${this.base.platform}/${this.base.arch} · node ${this.base.nodeVersion} · ${this.base.provider}/${this.base.model} · ${stats.count} messages (${stats.totalChars} chars, secrets redacted)`)}`;
+        if (budget <= 2)
+            return [title, warning].slice(0, budget);
+        const errorRows = this.validationMessage ? 1 : 0;
+        const fixedRows = 4 + errorRows;
+        const editorBudget = Math.max(1, budget - fixedRows);
+        const editorLines = this.fitEditorWindow(this.editor.render(contentWidth), editorBudget);
+        const lines = [title, warning, label, ...editorLines.map((line) => `${indent}${line}`), meta];
+        if (this.validationMessage) {
+            lines.push(`${indent}${themeForeground(theme.error, this.validationMessage)}`);
+        }
+        return lines.slice(0, budget);
+    }
+    renderPreview(width, budget, theme) {
+        const indentWidth = width >= 12 ? 2 : width >= 3 ? 1 : 0;
+        const indent = " ".repeat(indentWidth);
+        const contentWidth = Math.max(1, width - indentWidth * 2);
+        const title = `${indent}${chalk.bold(themeForeground(theme.inputText, "Payload preview"))}`;
+        const subtitle = `${indent}${themeDim(theme.dim, "Exact request body · ↑/↓ scroll · Tab return to editor")}`;
+        if (budget <= 2)
+            return [title, subtitle].slice(0, budget);
+        const preview = safeSheetText(JSON.stringify(this.payload(), null, 2))
+            .split("\n")
+            .flatMap((line) => line ? wrapTextWithAnsi(line, contentWidth) : [""]);
+        const bodyBudget = Math.max(0, budget - 2);
+        this.previewRows = bodyBudget;
+        this.previewContentRows = preview.length;
+        this.previewOffset = Math.min(this.previewOffset, this.maxPreviewOffset());
+        const visible = preview.slice(this.previewOffset, this.previewOffset + bodyBudget);
+        while (visible.length < bodyBudget)
+            visible.push("");
+        return [
+            title,
+            subtitle,
+            ...visible.map((line) => `${indent}${themeForeground(theme.muted, line)}`),
+        ].slice(0, budget);
+    }
+    renderSubmitting(width, budget, theme) {
+        const indent = " ".repeat(width >= 12 ? 2 : width >= 3 ? 1 : 0);
+        return [
+            `${indent}${chalk.bold(themeForeground(theme.inputText, "Sending feedback…"))}`,
+            `${indent}${themeDim(theme.dim, "Creating the GitHub issue. Please wait.")}`,
+        ].slice(0, budget);
+    }
+    renderDone(width, budget, theme) {
+        const indentWidth = width >= 12 ? 2 : width >= 3 ? 1 : 0;
+        const indent = " ".repeat(indentWidth);
+        const contentWidth = Math.max(1, width - indentWidth * 2);
+        const result = this.finalResult;
+        if (!result)
+            return [`${indent}${themeForeground(theme.error, "Feedback result unavailable.")}`];
+        if (result.kind === "success") {
+            const url = wrapTextWithAnsi(safeSheetText(result.url), contentWidth)
+                .map((line) => `${indent}${themeForeground(theme.accent, line)}`);
+            return [
+                `${indent}${chalk.bold(themeForeground(theme.success, "Feedback submitted"))}`,
+                `${indent}${themeForeground(theme.inputText, `Thanks! Issue #${result.number} was created.`)}`,
+                ...url,
+            ].slice(0, budget);
+        }
+        const error = wrapTextWithAnsi(safeSheetText(result.message), contentWidth)
+            .map((line) => `${indent}${themeForeground(theme.error, line)}`);
+        return [
+            `${indent}${chalk.bold(themeForeground(theme.error, "Feedback failed to submit"))}`,
+            ...error,
+        ].slice(0, budget);
+    }
+    helpText() {
+        if (this.stage === "submitting")
+            return "Submitting feedback…";
+        if (this.stage === "done")
+            return "Enter/Space/Esc dismiss";
+        if (this.showPreview)
+            return "↑/↓ scroll  │  Tab edit  │  Ctrl+S/Ctrl+D submit  │  Esc cancel";
+        return "Enter newline  │  Tab preview  │  Ctrl+S/Ctrl+D submit  │  Esc cancel";
+    }
+    transcriptStats() {
+        return {
+            count: this.base.transcript.length,
+            totalChars: this.base.transcript.reduce((sum, message) => sum + message.content.length, 0),
+        };
+    }
+    maxPreviewOffset() {
+        return Math.max(0, this.previewContentRows - this.previewRows);
+    }
+    dismiss() {
+        if (this.dismissed)
+            return;
+        this.dismissed = true;
+        this.options.onDismiss();
+    }
+    theme() {
+        return this.options.getTheme?.() ?? darkTheme;
+    }
+    fitEditorWindow(lines, budget) {
+        if (lines.length <= budget)
+            return lines;
+        if (budget <= 2)
+            return lines.slice(-budget);
+        const top = lines[0];
+        const bottom = lines[lines.length - 1];
+        const body = lines.slice(1, -1);
+        const bodyBudget = budget - 2;
+        const cursorIndex = Math.max(0, body.findIndex((line) => line.includes("\x1b[7m")));
+        const start = Math.max(0, Math.min(cursorIndex - Math.floor(bodyBudget / 2), Math.max(0, body.length - bodyBudget)));
+        return [top, ...body.slice(start, start + bodyBudget), bottom];
+    }
+}

package/dist/tui/components/feishu-setup-dialog.d.ts

@@ -0,0 +1,65 @@
+import { type Component, type Focusable } from "@bubblebrain-ai/pi-tui";
+import type { ScopeConfig } from "../../feishu/types.js";
+import { type Theme } from "../model/theme.js";
+type RegistrationResult = {
+    client_id: string;
+    client_secret: string;
+    user_info?: {
+        open_id?: string;
+    };
+};
+interface RegistrationOptions {
+    signal: AbortSignal;
+    onQRCodeReady(info: {
+        url: string;
+        expireIn: number;
+    }): void;
+    onStatusChange(info: {
+        status: string;
+    }): void;
+}
+export type FeishuSetupResult = {
+    kind: "completed";
+    summary: string;
+} | {
+    kind: "cancelled";
+} | {
+    kind: "error";
+    message: string;
+};
+export interface FeishuSetupDialogOptions {
+    getTerminalRows(): number;
+    getTheme?: () => Theme;
+    register?: (options: RegistrationOptions) => Promise<RegistrationResult>;
+    renderQr?: (url: string) => Promise<string>;
+    saveCredentials?: (input: {
+        appId: string;
+        appSecret: string;
+        ownerOpenId: string;
+    }) => void;
+    saveScope?: (chatId: string, scope: ScopeConfig) => void;
+    onResult(result: FeishuSetupResult): void;
+    onRender(): void;
+}
+/** Interactive Feishu registration and first-chat binding workflow for Pi TUI. */
+export declare class FeishuSetupDialogComponent implements Component, Focusable {
+    private readonly options;
+    focused: boolean;
+    private stage;
+    private readonly abortController;
+    private settled;
+    constructor(options: FeishuSetupDialogOptions);
+    start(): void;
+    render(width: number): string[];
+    handleInput(data: string): void;
+    invalidate(): void;
+    dispose(): void;
+    private renderStage;
+    private renderBinding;
+    private helpText;
+    private advanceBinding;
+    private updateBinding;
+    private showError;
+    private finish;
+}
+export {};

package/dist/tui/components/feishu-setup-dialog.js

@@ -0,0 +1,332 @@
+import chalk from "chalk";
+import { existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, isAbsolute, resolve as resolvePath } from "node:path";
+import { registerApp } from "@larksuiteoapi/node-sdk";
+import qrTerminal from "qrcode-terminal";
+import { decodeKittyPrintable, matchesKey, truncateToWidth, wrapTextWithAnsi, } from "@bubblebrain-ai/pi-tui";
+import { bootstrapConfig } from "../../feishu/config.js";
+import { ScopeRegistry } from "../../feishu/scope/scope-registry.js";
+import { darkTheme } from "../model/theme.js";
+import { themeDim, themeForeground } from "../model/theme-style.js";
+import { paintSheetLine, padSheetLine, safeSheetInlineText, safeSheetText } from "./bottom-sheet.js";
+const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+/** Interactive Feishu registration and first-chat binding workflow for Pi TUI. */
+export class FeishuSetupDialogComponent {
+    options;
+    focused = false;
+    stage = { kind: "registering" };
+    abortController = new AbortController();
+    settled = false;
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        const register = this.options.register ?? ((options) => registerApp(options));
+        void register({
+            signal: this.abortController.signal,
+            onQRCodeReady: (info) => {
+                void (this.options.renderQr ?? renderQr)(info.url).then((ascii) => {
+                    if (this.settled || this.abortController.signal.aborted)
+                        return;
+                    this.stage = { kind: "qr", url: info.url, ascii, status: "等待扫码…" };
+                    this.options.onRender();
+                });
+            },
+            onStatusChange: (info) => {
+                if (this.stage.kind !== "qr")
+                    return;
+                this.stage = { ...this.stage, status: registrationStatus(info.status) };
+                this.options.onRender();
+            },
+        }).then((result) => {
+            if (this.settled || this.abortController.signal.aborted)
+                return;
+            const ownerOpenId = result.user_info?.open_id;
+            if (!ownerOpenId) {
+                this.showError("授权成功但没有返回 owner open_id，无法继续。");
+                return;
+            }
+            try {
+                (this.options.saveCredentials ?? bootstrapConfig)({
+                    appId: result.client_id,
+                    appSecret: result.client_secret,
+                    ownerOpenId,
+                });
+            }
+            catch (error) {
+                this.showError(`保存 Feishu 配置失败：${errorMessage(error)}`);
+                return;
+            }
+            this.stage = { kind: "credentialed", ownerOpenId };
+            this.options.onRender();
+        }).catch((error) => {
+            if (this.settled || this.abortController.signal.aborted)
+                return;
+            this.showError(errorMessage(error) || "扫码注册失败");
+        });
+    }
+    render(width) {
+        const theme = this.options.getTheme?.() ?? darkTheme;
+        const safeWidth = Math.max(1, width);
+        const terminalRows = Math.max(1, this.options.getTerminalRows());
+        const sheetRows = terminalRows > 1 ? terminalRows - 1 : 1;
+        const showHelp = sheetRows >= 4;
+        const budget = Math.max(1, sheetRows - (showHelp ? 1 : 0));
+        const rows = this.renderStage(safeWidth, budget, theme)
+            .slice(0, budget)
+            .map((line) => paintSheetLine(line, safeWidth, false, theme));
+        if (!showHelp)
+            return rows;
+        return [...rows, themeDim(theme.dim, padSheetLine(this.helpText(), safeWidth))];
+    }
+    handleInput(data) {
+        if (this.settled)
+            return;
+        if (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
+            if (this.stage.kind === "credentialed" || this.stage.kind === "binding") {
+                this.finish({
+                    kind: "completed",
+                    summary: `✅ Feishu 应用已注册并保存。owner: ${this.stage.ownerOpenId}\n已跳过 chat 绑定；启动服务后可用 /feishu discover 和 /feishu bind 完成绑定。`,
+                });
+            }
+            else {
+                this.finish({ kind: "cancelled" });
+            }
+            return;
+        }
+        if (this.stage.kind === "error") {
+            if (matchesKey(data, "enter") || data === " ") {
+                this.finish({ kind: "error", message: this.stage.message });
+            }
+            return;
+        }
+        if (this.stage.kind === "credentialed") {
+            if (matchesKey(data, "enter")) {
+                this.stage = {
+                    kind: "binding",
+                    ownerOpenId: this.stage.ownerOpenId,
+                    field: "chatId",
+                    values: { chatId: "", cwd: "", displayName: "" },
+                };
+                this.options.onRender();
+            }
+            return;
+        }
+        if (this.stage.kind !== "binding")
+            return;
+        if (matchesKey(data, "enter")) {
+            this.advanceBinding();
+            return;
+        }
+        if (matchesKey(data, "backspace") || matchesKey(data, "delete")) {
+            this.updateBinding(removeLastGrapheme(this.stage.values[this.stage.field]));
+            return;
+        }
+        if (matchesKey(data, "tab") && this.stage.field === "displayName") {
+            this.updateBinding(basename(this.stage.values.cwd));
+            return;
+        }
+        const printable = printableInput(data);
+        if (printable !== undefined) {
+            this.updateBinding(this.stage.values[this.stage.field] + safeSheetText(printable).replace(/\n/g, " "));
+        }
+    }
+    invalidate() { }
+    dispose() {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.abortController.abort();
+    }
+    renderStage(width, budget, theme) {
+        const indentWidth = width >= 12 ? 2 : width >= 3 ? 1 : 0;
+        const indent = " ".repeat(indentWidth);
+        const contentWidth = Math.max(1, width - indentWidth * 2);
+        const title = `${indent}${chalk.bold(themeForeground(theme.inputText, "Feishu Setup"))}`;
+        if (this.stage.kind === "registering") {
+            return [title, "", `${indent}${themeDim(theme.dim, "正在向飞书申请注册码…")}`].slice(0, budget);
+        }
+        if (this.stage.kind === "qr") {
+            const fixedRows = 4;
+            const qr = safeSheetText(this.stage.ascii).split("\n").filter((line, index, rows) => line || index < rows.length - 1);
+            const canShowQr = qr.length > 0 && qr.length <= Math.max(0, budget - fixedRows);
+            const urlRows = wrapTextWithAnsi(this.stage.url, contentWidth)
+                .map((line) => `${indent}${themeForeground(theme.accent, line)}`);
+            return [
+                title,
+                `${indent}${themeDim(theme.dim, this.stage.status)}`,
+                ...(canShowQr
+                    ? qr.map((line) => `${indent}${truncateToWidth(line, contentWidth, "")}`)
+                    : [`${indent}${themeForeground(theme.warning, "终端高度不足以完整显示二维码，请在浏览器打开下面的链接：")}`]),
+                ...urlRows,
+            ].slice(0, budget);
+        }
+        if (this.stage.kind === "credentialed") {
+            return [
+                title,
+                "",
+                `${indent}${themeForeground(theme.success, "✅ 注册成功")}`,
+                `${indent}${themeForeground(theme.inputText, `owner open_id: ${safeSheetInlineText(this.stage.ownerOpenId)}`)}`,
+                `${indent}${themeDim(theme.dim, "配置与加密密钥已写入 ~/.bubble/feishu/。")}`,
+                "",
+                `${indent}${themeForeground(theme.inputText, "按 Enter 继续绑定第一个 chat，或 Esc 跳过。")}`,
+            ].slice(0, budget);
+        }
+        if (this.stage.kind === "error") {
+            return [
+                title,
+                "",
+                ...wrapTextWithAnsi(`❌ ${safeSheetText(this.stage.message)}`, contentWidth)
+                    .map((line) => `${indent}${themeForeground(theme.error, line)}`),
+            ].slice(0, budget);
+        }
+        return this.renderBinding(title, indent, contentWidth, budget, theme);
+    }
+    renderBinding(title, indent, width, budget, theme) {
+        if (this.stage.kind !== "binding")
+            return [];
+        const stage = this.stage;
+        const fields = [
+            { key: "chatId", label: "Chat ID", hint: "oc_ 开头；如果还不知道，可按 Esc 跳过后使用 /feishu discover。" },
+            { key: "cwd", label: "本地目录", hint: `绝对路径或 ~/…，例如 ${homedir()}/projects/app` },
+            { key: "displayName", label: "显示名", hint: "可留空；默认使用目录名。" },
+        ];
+        const currentIndex = fields.findIndex((field) => field.key === stage.field);
+        const rows = [title, ""];
+        for (const [index, field] of fields.entries()) {
+            const active = index === currentIndex;
+            const done = index < currentIndex;
+            const marker = active ? "›" : done ? "✓" : " ";
+            const value = safeSheetInlineText(stage.values[field.key]);
+            rows.push(`${indent}${themeForeground(active ? theme.accent : done ? theme.success : theme.muted, `${marker} ${field.label}: ${value}${active ? "▌" : ""}`)}`);
+            if (active)
+                rows.push(`${indent}${themeDim(theme.dim, truncateToWidth(field.hint, width, "…"))}`);
+        }
+        if (stage.error) {
+            rows.push(`${indent}${themeForeground(theme.error, truncateToWidth(stage.error, width, "…"))}`);
+        }
+        return rows.slice(0, budget);
+    }
+    helpText() {
+        if (this.stage.kind === "credentialed")
+            return "Enter bind first chat  │  Esc skip binding";
+        if (this.stage.kind === "binding")
+            return "Enter next  │  Backspace delete  │  Esc skip binding";
+        if (this.stage.kind === "error")
+            return "Enter/Space dismiss  │  Esc cancel";
+        return "Scan with Feishu mobile  │  Esc cancel";
+    }
+    advanceBinding() {
+        if (this.stage.kind !== "binding")
+            return;
+        const value = this.stage.values[this.stage.field].trim();
+        if (this.stage.field === "chatId") {
+            if (!value) {
+                this.stage = { ...this.stage, error: "Chat ID 不能为空。" };
+            }
+            else {
+                this.stage = { ...this.stage, field: "cwd", error: undefined };
+            }
+            this.options.onRender();
+            return;
+        }
+        if (this.stage.field === "cwd") {
+            const cwd = expandUser(value);
+            if (!isAbsolute(cwd) || !existsSync(cwd) || !statSync(cwd).isDirectory()) {
+                this.stage = { ...this.stage, error: `路径不存在或不是目录：${cwd}` };
+            }
+            else {
+                this.stage = {
+                    ...this.stage,
+                    field: "displayName",
+                    values: { ...this.stage.values, cwd, displayName: this.stage.values.displayName || basename(cwd) },
+                    error: undefined,
+                };
+            }
+            this.options.onRender();
+            return;
+        }
+        const displayName = value || basename(this.stage.values.cwd);
+        const scope = {
+            cwd: this.stage.values.cwd,
+            displayName,
+            allowedUsers: [this.stage.ownerOpenId],
+            admins: [this.stage.ownerOpenId],
+            defaultPermissionMode: "default",
+            model: null,
+            createdAt: Date.now(),
+            lastActiveAt: Date.now(),
+        };
+        try {
+            if (this.options.saveScope) {
+                this.options.saveScope(this.stage.values.chatId.trim(), scope);
+            }
+            else {
+                ScopeRegistry.load().upsert(this.stage.values.chatId.trim(), scope);
+            }
+        }
+        catch (error) {
+            this.stage = { ...this.stage, error: `保存 scope 失败：${errorMessage(error)}` };
+            this.options.onRender();
+            return;
+        }
+        this.finish({
+            kind: "completed",
+            summary: `✅ Feishu 已注册并绑定第一个 chat：\n  chat: ${this.stage.values.chatId.trim()}\n  cwd:  ${this.stage.values.cwd}\n现在可以运行 /feishu start 启动服务。`,
+        });
+    }
+    updateBinding(value) {
+        if (this.stage.kind !== "binding")
+            return;
+        this.stage = {
+            ...this.stage,
+            values: { ...this.stage.values, [this.stage.field]: value },
+            error: undefined,
+        };
+        this.options.onRender();
+    }
+    showError(message) {
+        this.stage = { kind: "error", message };
+        this.options.onRender();
+    }
+    finish(result) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.abortController.abort();
+        this.options.onResult(result);
+    }
+}
+function renderQr(url) {
+    return new Promise((resolve) => qrTerminal.generate(url, { small: true }, resolve));
+}
+function registrationStatus(status) {
+    if (status === "polling")
+        return "等待扫码…";
+    if (status === "slow_down")
+        return "轮询变慢中…仍在等待";
+    if (status === "domain_switched")
+        return "已切换域名";
+    return safeSheetInlineText(status);
+}
+function printableInput(data) {
+    const decoded = decodeKittyPrintable(data);
+    if (decoded !== undefined)
+        return decoded;
+    // eslint-disable-next-line no-control-regex
+    return data && !/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/.test(data) ? data : undefined;
+}
+function removeLastGrapheme(value) {
+    const segments = [...graphemeSegmenter.segment(value)];
+    const last = segments[segments.length - 1];
+    return last ? value.slice(0, last.index) : "";
+}
+function expandUser(value) {
+    if (value === "~" || value.startsWith("~/"))
+        return homedir() + value.slice(1);
+    return resolvePath(value);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/tui/components/image-preview.d.ts

@@ -0,0 +1,32 @@
+import { type Component, type TuiMouseEvent } from "@bubblebrain-ai/pi-tui";
+import type { ComposerDraftAttachment } from "../controller/composer-controller.js";
+import type { DisplayImageAttachment } from "../model/image-attachment.js";
+import { type Theme } from "../model/theme.js";
+type PreviewImage = ComposerDraftAttachment | DisplayImageAttachment;
+export declare function formatImageBytes(bytes: number): string;
+export declare function imageDetailLine(input: PreviewImage): string;
+/** Grok-style transient preview rendered directly above the composer. */
+export declare class ComposerImagePreviewComponent implements Component {
+    private readonly getImage;
+    private readonly getTheme;
+    private cachedKey?;
+    private cachedImage?;
+    constructor(getImage: () => ComposerDraftAttachment | undefined, getTheme?: () => Theme);
+    render(width: number): string[];
+    invalidate(): void;
+}
+/** Full image inspector used by composer activation and sent-message clicks. */
+export declare class ImageViewerComponent implements Component {
+    private readonly onClose;
+    private readonly getTheme;
+    focused: boolean;
+    private readonly image;
+    private readonly renderer;
+    private hovered;
+    constructor(input: PreviewImage, onClose: () => void, getTerminalRows?: () => number, getTheme?: () => Theme);
+    render(width: number): string[];
+    handleInput(data: string): void;
+    handleMouse(event: TuiMouseEvent): boolean;
+    invalidate(): void;
+}
+export {};