@bubblebrain-ai/bubble 0.0.10 → 0.0.12

package/dist/tui-ink/code-highlight.js

@@ -71,9 +71,8 @@ export async function highlightCode(code, lang) {
     const h = await getHighlighter();
     return runHighlight(h, code, lang);
 }
-// Synchronous variant that returns null when shiki hasn't finished loading yet.
-// Used by code paths that render into Ink's <Static> (which only paints once)
-// so the first frame can already carry highlighted output.
+// Synchronous variant that returns null when shiki hasn't finished loading yet,
+// so the first transcript frame can already carry highlighted output when warm.
 export function highlightCodeSync(code, lang) {
     if (!highlighterReady) {
         // Ensure warmup is in flight for future renders.

package/dist/tui-ink/detect-theme.d.ts

@@ -1,19 +1,2 @@
-/**
- * Detect whether the host terminal is using a light or dark background so we
- * can pick a sensible default palette when the user has theme set to "auto".
- *
- * Resolution order:
- *   1. `COLORFGBG` env var — synchronous, set by VTE-family terminals (GNOME
- *      Terminal, Konsole) and iTerm2 (when enabled). Format is "fg;bg" or
- *      "fg;aux;bg" with each value being an ANSI color index 0–15.
- *   2. OSC 11 query — write `ESC ] 11 ; ? BEL`, listen on stdin for a reply
- *      shaped like `ESC ] 11 ; rgb:RRRR/GGGG/BBBB BEL`. Capped at ~150 ms so
- *      we don't stall startup on terminals that swallow the query.
- *   3. Fallback to "dark" — most coding terminals are dark, so this is the
- *      least surprising default when detection fails.
- *
- * Must run BEFORE Ink's `render()` takes over stdin. Ink puts stdin into raw
- * mode and consumes input itself, so the OSC 11 reply would never reach us.
- */
-import type { ResolvedTheme } from "./theme.js";
+export type ResolvedTheme = "light" | "dark";
 export declare function detectTerminalTheme(timeoutMs?: number): Promise<ResolvedTheme>;

package/dist/tui-ink/detect-theme.js

@@ -1,20 +1,3 @@
-/**
- * Detect whether the host terminal is using a light or dark background so we
- * can pick a sensible default palette when the user has theme set to "auto".
- *
- * Resolution order:
- *   1. `COLORFGBG` env var — synchronous, set by VTE-family terminals (GNOME
- *      Terminal, Konsole) and iTerm2 (when enabled). Format is "fg;bg" or
- *      "fg;aux;bg" with each value being an ANSI color index 0–15.
- *   2. OSC 11 query — write `ESC ] 11 ; ? BEL`, listen on stdin for a reply
- *      shaped like `ESC ] 11 ; rgb:RRRR/GGGG/BBBB BEL`. Capped at ~150 ms so
- *      we don't stall startup on terminals that swallow the query.
- *   3. Fallback to "dark" — most coding terminals are dark, so this is the
- *      least surprising default when detection fails.
- *
- * Must run BEFORE Ink's `render()` takes over stdin. Ink puts stdin into raw
- * mode and consumes input itself, so the OSC 11 reply would never reach us.
- */
 export async function detectTerminalTheme(timeoutMs = 150) {
     const fromEnv = parseColorFgBg(process.env.COLORFGBG);
     if (fromEnv)
@@ -26,16 +9,6 @@ export async function detectTerminalTheme(timeoutMs = 150) {
     }
     return "dark";
 }
-/**
- * COLORFGBG examples:
- *   "15;0"     → bright-white fg on black bg → dark
- *   "0;15"     → black fg on bright-white bg → light
- *   "15;default;0" → some terminals add a default-bg sentinel in the middle.
- *
- * ANSI indices 0–6 are typically dark (black, red, green, yellow, blue,
- * magenta, cyan); 7–15 are typically light (gray-to-white-ish). 7 itself
- * (white) is ambiguous on some terminals but more often points to light.
- */
 function parseColorFgBg(value) {
     if (!value)
         return null;
@@ -65,7 +38,7 @@ function queryOsc11(timeoutMs) {
                 stdin.setRawMode(originalRaw);
             }
             catch {
-                // ignore — terminal may have already restored
+                // ignore - terminal may have already restored
             }
             stdin.pause();
         };
@@ -79,8 +52,6 @@ function queryOsc11(timeoutMs) {
         };
         const onData = (chunk) => {
             buffer += chunk.toString("utf8");
-            // Match `ESC ] 11 ; rgb:RRRR/GGGG/BBBB ST` where ST is BEL (\x07) or
-            // ESC \\. Some terminals reply with shorter hex (rgb:rr/gg/bb).
             const match = buffer.match(/\x1b\]11;rgb:([0-9a-fA-F]+)\/([0-9a-fA-F]+)\/([0-9a-fA-F]+)(?:\x07|\x1b\\)/);
             if (!match)
                 return;
@@ -106,17 +77,10 @@ function queryOsc11(timeoutMs) {
         }
     });
 }
-/** Normalize a hex channel string of arbitrary length to a 0–1 float. */
 function parseHexChannel(hex) {
     const max = (1 << (hex.length * 4)) - 1;
     return parseInt(hex, 16) / max;
 }
-/**
- * sRGB relative luminance per WCAG 2.x. Output range is 0 (black) to 1 (white).
- * We treat ≥ 0.5 as "light"; the actual threshold is forgiving because real
- * terminal backgrounds tend to be near-pure black (≈0.0) or near-pure white
- * (≈1.0).
- */
 function relativeLuminance(r, g, b) {
     const channel = (c) => c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
     return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);

package/dist/tui-ink/display-history.d.ts

@@ -1,14 +1,17 @@
-import type { ToolResultMetadata } from "../types.js";
+import type { Message, ToolResultMetadata } from "../types.js";
 export interface DisplayMessage {
-    /** Stable identity, used as Static/list key. Generated by the UI layer. */
+    /** Stable identity, used as the transcript list key. Generated by the UI layer. */
     key?: string;
     role: "user" | "assistant" | "error";
     content: string;
     reasoning?: string;
     toolCalls?: DisplayToolCall[];
     parts?: DisplayMessagePart[];
-    syntheticKind?: "ui_summary";
+    syntheticKind?: "ui_summary" | "ui_compact_summary";
+    /** Markdown body shown inside a `ui_compact_summary` card. */
+    compactionSummary?: string;
     hiddenCount?: number;
+    taskElapsedMs?: number;
 }
 export type DisplayMessagePart = DisplayTextPart | DisplayToolsPart;
 export interface DisplayTextPart {
@@ -23,6 +26,12 @@ export interface DisplayToolCall {
     id: string;
     name: string;
     args: Record<string, any>;
+    /**
+     * Unparsed JSON string for tool arguments, populated during partial-streaming
+     * before `args` resolves. Used as a fallback by trace-groups when extracting
+     * a command preview.
+     */
+    rawArguments?: string;
     result?: string;
     isError?: boolean;
     metadata?: ToolResultMetadata;
@@ -36,3 +45,11 @@ export declare function snapshotDisplayParts(parts: DisplayMessagePart[]): Displ
 export declare function contentFromParts(parts: DisplayMessagePart[]): string;
 export declare function toolCallsFromParts(parts: DisplayMessagePart[]): DisplayToolCall[];
 export declare function compactDisplayMessages(messages: DisplayMessage[]): DisplayMessage[];
+/**
+ * Find the most recent compaction summary embedded in the agent's system
+ * messages. Bubble's compaction step rewrites the system transcript so that
+ * the long-form summary lives in either a "Previous conversation summary:"
+ * block or an "Earlier in this turn" block; we walk from newest to oldest and
+ * return the first match so the UI can show the freshest summary.
+ */
+export declare function latestCompactionSummary(agentMessages: Message[]): string | undefined;

package/dist/tui-ink/display-history.js

@@ -43,7 +43,6 @@ export function contentFromParts(parts) {
 export function toolCallsFromParts(parts) {
     return parts.flatMap((part) => part.type === "tools" ? part.toolCalls : []);
 }
-const MAX_VISIBLE_MESSAGES = 80;
 const FULL_DETAIL_WINDOW = 24;
 const MAX_OLD_CONTENT_CHARS = 1200;
 const MAX_OLD_REASONING_CHARS = 600;
@@ -52,26 +51,12 @@ export function compactDisplayMessages(messages) {
     if (messages.length === 0) {
         return messages;
     }
-    let hiddenCount = 0;
-    const withoutSynthetic = messages.filter((message) => {
-        if (message.syntheticKind !== "ui_summary") {
-            return true;
-        }
-        hiddenCount += message.hiddenCount ?? 0;
-        return false;
-    });
-    const overflow = Math.max(0, withoutSynthetic.length - MAX_VISIBLE_MESSAGES);
-    hiddenCount += overflow;
-    const visible = overflow > 0 ? withoutSynthetic.slice(overflow) : withoutSynthetic;
+    const visible = messages.filter((message) => message.syntheticKind !== "ui_summary");
     const detailStart = Math.max(0, visible.length - FULL_DETAIL_WINDOW);
-    const compacted = visible.map((message, index) => (index < detailStart ? compactDisplayMessage(message) : message));
-    if (hiddenCount === 0) {
-        return compacted;
-    }
-    return [buildUiSummary(hiddenCount), ...compacted];
+    return visible.map((message, index) => (index < detailStart ? compactDisplayMessage(message) : message));
 }
 function compactDisplayMessage(message) {
-    if (message.syntheticKind === "ui_summary") {
+    if (message.syntheticKind === "ui_summary" || message.syntheticKind === "ui_compact_summary") {
         return message;
     }
     return {
@@ -84,15 +69,6 @@ function compactDisplayMessage(message) {
         parts: message.parts?.map(compactDisplayPart),
     };
 }
-function buildUiSummary(hiddenCount) {
-    return {
-        key: "synthetic-ui-summary",
-        role: "assistant",
-        content: `[Earlier UI history compacted to control memory: ${hiddenCount} message${hiddenCount === 1 ? "" : "s"} hidden]`,
-        syntheticKind: "ui_summary",
-        hiddenCount,
-    };
-}
 function truncateText(value, maxChars) {
     if (value.length <= maxChars) {
         return value;
@@ -128,3 +104,26 @@ function compactToolCall(toolCall) {
             : toolCall.result,
     };
 }
+const PREVIOUS_SUMMARY_PREFIX = /^Previous conversation summary:\s*\n?([\s\S]*)$/;
+const TURN_SUMMARY_PREFIX = /^Earlier in this turn \(compacted to free context\):\s*\n?([\s\S]*)$/;
+/**
+ * Find the most recent compaction summary embedded in the agent's system
+ * messages. Bubble's compaction step rewrites the system transcript so that
+ * the long-form summary lives in either a "Previous conversation summary:"
+ * block or an "Earlier in this turn" block; we walk from newest to oldest and
+ * return the first match so the UI can show the freshest summary.
+ */
+export function latestCompactionSummary(agentMessages) {
+    for (let index = agentMessages.length - 1; index >= 0; index--) {
+        const message = agentMessages[index];
+        if (!message || message.role !== "system" || typeof message.content !== "string")
+            continue;
+        const previousMatch = message.content.match(PREVIOUS_SUMMARY_PREFIX);
+        if (previousMatch?.[1]?.trim())
+            return previousMatch[1].trim();
+        const turnMatch = message.content.match(TURN_SUMMARY_PREFIX);
+        if (turnMatch?.[1]?.trim())
+            return turnMatch[1].trim();
+    }
+    return undefined;
+}

package/dist/tui-ink/feedback-dialog.d.ts

@@ -0,0 +1,19 @@
+import type { FeedbackPayload } from "../feedback/types.js";
+interface FeedbackDialogProps {
+    /** Pre-collected env + transcript; description is filled in by the user. */
+    base: Omit<FeedbackPayload, "description">;
+    initialDescription: string;
+    onDismiss: () => void;
+    onResult: (result: {
+        kind: "success";
+        url: string;
+        number: number;
+    } | {
+        kind: "error";
+        message: string;
+    } | {
+        kind: "cancelled";
+    }) => void;
+}
+export declare function FeedbackDialog({ base, initialDescription, onDismiss, onResult }: FeedbackDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,123 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { useTheme } from "./theme.js";
+import { submitFeedback, FeedbackSubmitError } from "../feedback/submit.js";
+export function FeedbackDialog({ base, initialDescription, onDismiss, onResult }) {
+    const theme = useTheme();
+    const [stage, setStage] = useState("edit");
+    const [description, setDescription] = useState(initialDescription);
+    const [cursor, setCursor] = useState(initialDescription.length);
+    const [showPreview, setShowPreview] = useState(false);
+    const [finalResult, setFinalResult] = useState(null);
+    const transcriptStats = useMemo(() => {
+        const total = base.transcript.reduce((sum, m) => sum + m.content.length, 0);
+        return { count: base.transcript.length, totalChars: total };
+    }, [base.transcript]);
+    const insertAtCursor = (text) => {
+        setDescription((prev) => prev.slice(0, cursor) + text + prev.slice(cursor));
+        setCursor((c) => c + text.length);
+    };
+    const submit = async () => {
+        setStage("submitting");
+        const payload = { ...base, description: description.trim() };
+        try {
+            const result = await submitFeedback(payload);
+            setFinalResult({ kind: "success", result });
+            setStage("done");
+            onResult({ kind: "success", url: result.url, number: result.number });
+        }
+        catch (err) {
+            const message = err instanceof FeedbackSubmitError
+                ? err.message
+                : err instanceof Error
+                    ? err.message
+                    : String(err);
+            setFinalResult({ kind: "error", message });
+            setStage("done");
+            onResult({ kind: "error", message });
+        }
+    };
+    useInput((input, key) => {
+        if (stage === "submitting")
+            return;
+        if (stage === "done") {
+            if (key.return || key.escape || input === " ") {
+                onDismiss();
+            }
+            return;
+        }
+        // edit stage
+        if (key.escape) {
+            onResult({ kind: "cancelled" });
+            onDismiss();
+            return;
+        }
+        if (key.tab) {
+            setShowPreview((v) => !v);
+            return;
+        }
+        if (key.ctrl && (input === "d" || input === "s")) {
+            if (description.trim().length === 0 && transcriptStats.count === 0) {
+                return;
+            }
+            void submit();
+            return;
+        }
+        if (key.return) {
+            insertAtCursor("\n");
+            return;
+        }
+        if (key.backspace || key.delete) {
+            if (cursor > 0) {
+                setDescription((prev) => prev.slice(0, cursor - 1) + prev.slice(cursor));
+                setCursor((c) => Math.max(0, c - 1));
+            }
+            return;
+        }
+        if (key.leftArrow) {
+            setCursor((c) => Math.max(0, c - 1));
+            return;
+        }
+        if (key.rightArrow) {
+            setCursor((c) => Math.min(description.length, c + 1));
+            return;
+        }
+        if (key.upArrow || key.downArrow) {
+            const before = description.slice(0, cursor);
+            const after = description.slice(cursor);
+            const beforeLines = before.split("\n");
+            const afterLines = after.split("\n");
+            const currentCol = beforeLines[beforeLines.length - 1].length;
+            if (key.upArrow && beforeLines.length > 1) {
+                const prevLine = beforeLines[beforeLines.length - 2];
+                const col = Math.min(currentCol, prevLine.length);
+                const newCursor = before.length - beforeLines[beforeLines.length - 1].length - 1 - (prevLine.length - col);
+                setCursor(Math.max(0, newCursor));
+            }
+            else if (key.downArrow && afterLines.length > 1) {
+                const nextLine = afterLines[1];
+                const col = Math.min(currentCol, nextLine.length);
+                const newCursor = before.length + afterLines[0].length + 1 + col;
+                setCursor(Math.min(description.length, newCursor));
+            }
+            return;
+        }
+        if (input && !key.meta) {
+            insertAtCursor(input);
+        }
+    });
+    if (stage === "done" && finalResult) {
+        return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, marginY: 1, children: [finalResult.kind === "success" ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.accent, bold: true, children: "Feedback submitted" }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["Thanks! Issue #", finalResult.result.number, " created."] }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: finalResult.result.url }) })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", bold: true, children: "Feedback failed to submit" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: finalResult.message }) })] })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "Press Enter to dismiss" }) })] }));
+    }
+    if (stage === "submitting") {
+        return (_jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, marginY: 1, children: _jsx(Text, { color: theme.accent, bold: true, children: "Sending feedback..." }) }));
+    }
+    // edit stage
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, marginY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: "Send feedback" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "yellow", children: "This creates a PUBLIC GitHub issue at DylanDDeng/bubble. Review before sending." }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.muted, children: "Describe what happened:" }), _jsx(Box, { borderStyle: "single", borderColor: theme.muted, paddingX: 1, marginTop: 0, minHeight: 3, children: _jsx(Text, { children: renderWithCursor(description, cursor) }) })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: theme.muted, children: ["Also included: v", base.version, " \u00B7 ", base.platform, "/", base.arch, " \u00B7 node ", base.nodeVersion, " \u00B7", " ", base.provider, "/", base.model, " \u00B7 ", transcriptStats.count, " messages (", transcriptStats.totalChars, " chars, secrets redacted)"] }), showPreview && (_jsxs(Box, { flexDirection: "column", marginTop: 1, borderStyle: "single", borderColor: theme.muted, paddingX: 1, children: [_jsx(Text, { color: theme.muted, bold: true, children: "Payload preview (exactly what will be submitted):" }), base.transcript.map((m, i) => (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { color: theme.accent, children: ["[", m.role, "]"] }), _jsx(Text, { children: m.content })] }, i))), base.recentError && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "red", children: "[recent error]" }), _jsx(Text, { children: base.recentError })] }))] }))] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.muted, children: [_jsx(Text, { color: theme.accent, bold: true, children: "Ctrl+D" }), " submit \u00B7", " ", _jsx(Text, { color: theme.accent, bold: true, children: "Tab" }), " ", showPreview ? "hide" : "view", " payload \u00B7", " ", _jsx(Text, { color: theme.accent, bold: true, children: "Enter" }), " newline \u00B7", " ", _jsx(Text, { color: theme.accent, bold: true, children: "Esc" }), " cancel"] }) })] }));
+}
+function renderWithCursor(text, cursor) {
+    if (text.length === 0)
+        return "▏";
+    return text.slice(0, cursor) + "▏" + text.slice(cursor);
+}

package/dist/tui-ink/feishu-setup-picker.d.ts

@@ -0,0 +1,5 @@
+export interface FeishuSetupPickerProps {
+    onComplete: (summary: string) => void;
+    onCancel: () => void;
+}
+export declare function FeishuSetupPicker({ onComplete, onCancel }: FeishuSetupPickerProps): import("react/jsx-runtime").JSX.Element;

package/dist/tui-ink/feishu-setup-picker.js

@@ -0,0 +1,261 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import qrTerminal from "qrcode-terminal";
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute, resolve as resolvePath, basename } from "node:path";
+import { homedir } from "node:os";
+import { registerApp } from "@larksuiteoapi/node-sdk";
+import { useTheme } from "./theme.js";
+import { bootstrapConfig } from "../feishu/config.js";
+import { ScopeRegistry } from "../feishu/scope/scope-registry.js";
+const EMPTY_VALUES = { chatId: "", cwd: "", displayName: "" };
+export function FeishuSetupPicker({ onComplete, onCancel }) {
+    const theme = useTheme();
+    const [stage, setStage] = useState({ kind: "registering" });
+    const abortRef = useRef(undefined);
+    const completedRef = useRef(false);
+    useEffect(() => {
+        const controller = new AbortController();
+        abortRef.current = controller;
+        let cancelled = false;
+        void (async () => {
+            try {
+                const result = await registerApp({
+                    signal: controller.signal,
+                    onQRCodeReady: (info) => {
+                        if (cancelled)
+                            return;
+                        qrTerminal.generate(info.url, { small: true }, (ascii) => {
+                            if (cancelled)
+                                return;
+                            setStage({
+                                kind: "qr_shown",
+                                url: info.url,
+                                ascii,
+                                status: "等待扫码…",
+                            });
+                        });
+                    },
+                    onStatusChange: (info) => {
+                        if (cancelled)
+                            return;
+                        setStage((prev) => {
+                            if (prev.kind !== "qr_shown")
+                                return prev;
+                            const label = info.status === "polling"
+                                ? "等待扫码…"
+                                : info.status === "slow_down"
+                                    ? "轮询变慢中…仍在等待"
+                                    : info.status === "domain_switched"
+                                        ? "已切换域名"
+                                        : info.status;
+                            return { ...prev, status: label };
+                        });
+                    },
+                });
+                if (cancelled)
+                    return;
+                const ownerOpenId = result.user_info?.open_id;
+                if (!ownerOpenId) {
+                    setStage({ kind: "error", message: "授权成功但没拿到 owner open_id，无法继续。" });
+                    return;
+                }
+                try {
+                    bootstrapConfig({
+                        appId: result.client_id,
+                        appSecret: result.client_secret,
+                        ownerOpenId,
+                    });
+                }
+                catch (err) {
+                    setStage({ kind: "error", message: `保存 config 失败：${err.message}` });
+                    return;
+                }
+                setStage({ kind: "credentialed", ownerOpenId, configWritten: true });
+            }
+            catch (err) {
+                if (cancelled || controller.signal.aborted)
+                    return;
+                setStage({ kind: "error", message: err.message || "扫码注册失败" });
+            }
+        })();
+        return () => {
+            cancelled = true;
+            controller.abort();
+        };
+    }, []);
+    const finish = (summary) => {
+        if (completedRef.current)
+            return;
+        completedRef.current = true;
+        setStage({ kind: "done", summary });
+        onComplete(summary);
+    };
+    const cancel = () => {
+        if (completedRef.current)
+            return;
+        completedRef.current = true;
+        abortRef.current?.abort();
+        onCancel();
+    };
+    useInput((input, key) => {
+        if (key.escape) {
+            // Esc at any stage = cancel/skip.
+            if (stage.kind === "credentialed") {
+                finish(`✅ 应用已注册并保存到 ~/.bubble/feishu/。owner: ${stage.ownerOpenId}\n(已跳过 chat 绑定 — 稍后可以编辑 ~/.bubble/feishu/scopes.json 添加)`);
+                return;
+            }
+            if (stage.kind === "binding") {
+                finish(`✅ 应用已注册。owner: ${stage.ownerOpenId}\n(已跳过 chat 绑定 — 稍后可以 /feishu setup 重来或编辑 scopes.json)`);
+                return;
+            }
+            cancel();
+            return;
+        }
+        if (stage.kind === "credentialed" && key.return) {
+            setStage({
+                kind: "binding",
+                ownerOpenId: stage.ownerOpenId,
+                field: "chatId",
+                values: EMPTY_VALUES,
+            });
+            return;
+        }
+        if (stage.kind === "error" && key.return) {
+            onCancel();
+            return;
+        }
+        if (stage.kind !== "binding")
+            return;
+        const cur = stage;
+        const updateValue = (next) => {
+            setStage({ ...cur, values: { ...cur.values, [cur.field]: next }, error: undefined });
+        };
+        if (key.return) {
+            const submitField = cur.field;
+            const value = cur.values[submitField];
+            if (submitField === "chatId") {
+                if (!value.trim()) {
+                    setStage({ ...cur, error: "Chat ID 不能为空（oc_...）" });
+                    return;
+                }
+                setStage({ ...cur, field: "cwd", error: undefined });
+                return;
+            }
+            if (submitField === "cwd") {
+                const expanded = expandUser(value.trim());
+                if (!isAbsolute(expanded)) {
+                    setStage({ ...cur, error: "cwd 必须是绝对路径或 ~/..." });
+                    return;
+                }
+                if (!existsSync(expanded) || !statSync(expanded).isDirectory()) {
+                    setStage({ ...cur, error: `路径不存在或不是目录：${expanded}` });
+                    return;
+                }
+                // Pre-fill display name with basename if user left it empty later.
+                const nextDisplayName = cur.values.displayName || basename(expanded);
+                setStage({
+                    ...cur,
+                    field: "displayName",
+                    values: { ...cur.values, cwd: expanded, displayName: nextDisplayName },
+                    error: undefined,
+                });
+                return;
+            }
+            // displayName
+            const displayName = value.trim() || basename(cur.values.cwd);
+            try {
+                const registry = ScopeRegistry.load();
+                const scope = {
+                    cwd: cur.values.cwd,
+                    displayName,
+                    allowedUsers: [cur.ownerOpenId],
+                    admins: [cur.ownerOpenId],
+                    defaultPermissionMode: "default",
+                    model: null,
+                    createdAt: Date.now(),
+                    lastActiveAt: Date.now(),
+                };
+                registry.upsert(cur.values.chatId.trim(), scope);
+            }
+            catch (err) {
+                setStage({ ...cur, error: `保存 scope 失败：${err.message}` });
+                return;
+            }
+            finish(`✅ 已注册应用并绑定第一个 chat：\n  chat: ${cur.values.chatId.trim()}\n  cwd:  ${cur.values.cwd}\n现在可以 /feishu start 启动服务。`);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            updateValue(cur.values[cur.field].slice(0, -1));
+            return;
+        }
+        if (key.tab && cur.field === "displayName") {
+            // Tab in displayName field = use default (basename).
+            updateValue(basename(cur.values.cwd));
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            updateValue(cur.values[cur.field] + input);
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, paddingX: 1, borderStyle: "round", borderColor: theme.borderActive, children: [_jsx(Text, { bold: true, color: theme.accent, children: "Feishu Setup Wizard" }), _jsx(Text, { color: theme.muted, children: renderHint(stage) }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: renderBody(stage, theme) })] }));
+}
+function renderHint(stage) {
+    switch (stage.kind) {
+        case "registering": return "Esc 取消";
+        case "qr_shown": return "用手机飞书扫码 · Esc 取消";
+        case "credentialed": return "Enter 绑定第一个 chat · Esc 跳过（之后可手动配置 scopes.json）";
+        case "binding": return "输入后 Enter 下一步 · Esc 跳过绑定";
+        case "done": return "Enter 关闭";
+        case "error": return "Enter 关闭";
+    }
+}
+function renderBody(stage, theme) {
+    switch (stage.kind) {
+        case "registering":
+            return _jsx(Text, { color: theme.muted, children: "\u6B63\u5728\u5411\u98DE\u4E66\u7533\u8BF7\u6CE8\u518C\u7801\u2026" });
+        case "qr_shown":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.muted, children: stage.status }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: stage.ascii.split("\n").map((line, i) => (_jsx(Text, { children: line || " " }, `q-${i}`))) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.muted, children: "\u626B\u4E0D\u5230\uFF1F\u4E5F\u53EF\u4EE5\u6D4F\u89C8\u5668\u6253\u5F00\uFF1A" }), _jsx(Text, { children: stage.url })] })] }));
+        case "credentialed":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.accent, children: "\u2705 \u6CE8\u518C\u6210\u529F" }), _jsxs(Text, { children: ["owner open_id: ", _jsx(Text, { color: theme.accent, children: stage.ownerOpenId })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "\u5DF2\u5199\u5165 ~/.bubble/feishu/config.json + secrets.enc\uFF08\u52A0\u5BC6\uFF09\u3002" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "\u4E0B\u4E00\u6B65\uFF1A\u628A\u4E00\u4E2A\u98DE\u4E66 chat \u7ED1\u5B9A\u5230\u672C\u5730\u76EE\u5F55\uFF1F" }) })] }));
+        case "binding":
+            return _jsx(BindingForm, { stage: stage, theme: theme });
+        case "done":
+            return (_jsx(Box, { flexDirection: "column", children: stage.summary.split("\n").map((line, i) => (_jsx(Text, { children: line }, i))) }));
+        case "error":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "red", children: ["\u274C ", stage.message] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.muted, children: "\u6309 Enter \u5173\u95ED\u3002\u53EF\u4EE5\u7A0D\u540E\u518D /feishu setup \u91CD\u8BD5\u3002" }) })] }));
+    }
+}
+function BindingForm({ stage, theme }) {
+    const labels = {
+        chatId: {
+            label: "Chat ID",
+            hint: "飞书 chat 的 oc_ 开头 ID。⚠️ 现在你大概率还不知道这个 —— 按 Esc 跳过，先 /feishu start 起服务，给 bot 发条消息后用 /feishu discover 自动获取。",
+        },
+        cwd: {
+            label: "本地 cwd",
+            hint: `例如 ${homedir()}/projects/my-app（绝对路径或 ~/...）`,
+        },
+        displayName: {
+            label: "显示名（可空，默认 = 目录名）",
+            hint: "出现在飞书卡片顶栏的短标签",
+        },
+    };
+    return (_jsxs(Box, { flexDirection: "column", children: [Object.keys(labels).map((field) => {
+                const meta = labels[field];
+                const value = stage.values[field];
+                const isActive = stage.field === field;
+                const isDone = !isActive && value && fieldOrderIndex(stage.field) > fieldOrderIndex(field);
+                const marker = isActive ? "› " : isDone ? "✓ " : "  ";
+                return (_jsxs(Box, { flexDirection: "column", marginBottom: isActive ? 1 : 0, children: [_jsxs(Box, { children: [_jsxs(Text, { color: isActive ? theme.accent : isDone ? "green" : theme.muted, children: [marker, meta.label, ":"] }), _jsx(Box, { marginLeft: 1, children: _jsxs(Text, { children: [value, isActive ? "▌" : ""] }) })] }), isActive && (_jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: theme.muted, children: meta.hint }) }))] }, field));
+            }), stage.error && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "red", children: stage.error }) }))] }));
+}
+function fieldOrderIndex(field) {
+    return field === "chatId" ? 0 : field === "cwd" ? 1 : 2;
+}
+function expandUser(p) {
+    if (p === "~" || p.startsWith("~/"))
+        return homedir() + p.slice(1);
+    return resolvePath(p);
+}