@bubblebrain-ai/bubble 0.0.24 → 0.0.26

package/README.md

@@ -69,7 +69,9 @@ Bubble ships with a catalog of built-in providers. Configure them inside the app
 | `/key <provider> <key>` | Set the API key for a provider. |
 | `/model` | Pick the active model and reasoning effort. |
 
-Built-in providers include OpenAI, Anthropic, Google, DeepSeek, Moonshot (CN and international), Kimi for Coding, Zhipu AI, Z.AI, Alibaba DashScope, MiniMax, StepFun, Groq, Together AI, Fireworks, and a `local` profile for any OpenAI-compatible endpoint (Ollama, vLLM, LM Studio, etc.).
+Built-in providers include OpenAI, Anthropic, Google, DeepSeek, Moonshot (CN and international), Kimi for Coding, Zhipu AI, Z.AI, Alibaba DashScope, Doubao (Volcengine Ark), MiniMax, StepFun, Groq, Together AI, Fireworks, and a `local` profile for any OpenAI-compatible endpoint (Ollama, vLLM, LM Studio, etc.).
+
+For Doubao Seed models on Volcengine Ark, run `/provider --add doubao` and paste your Ark API key. The built-in endpoint is `https://ark.cn-beijing.volces.com/api/v3` and uses Ark's Responses API. The model picker exposes `minimal`, `low`, `medium`, and `high`, defaulting to `high`; `minimal` disables Ark thinking, while the other levels enable it.
 
 ### Custom providers and models
 
@@ -90,7 +92,7 @@ For full control — custom base URLs, self-hosted gateways, extra models, or pi
 }
 ```
 
-`protocol` accepts `openai-chat` (default) or `anthropic-messages`. Entries in `models.json` take precedence over the built-in catalog.
+`protocol` accepts `openai-chat` (default), `anthropic-messages`, or `ark-responses`. Entries in `models.json` take precedence over the built-in catalog.
 
 ### Reasoning effort
 
@@ -249,7 +251,7 @@ npm test           # run the test suite (vitest)
 npm start          # run the built agent
 ```
 
-`npm run dev` compiles and launches in one step. The TUI is built on [OpenTUI](https://github.com/anomalyco/opentui) and Solid.
+`npm run dev` compiles and launches in one step. The interactive TUI is built on React Ink.
 
 ## Feishu host (optional)
 

package/dist/agent.js

@@ -2047,7 +2047,7 @@ export class Agent {
         }
         if (toolCall.argsCorrupt) {
             return {
-                content: `Error: The arguments for "${toolCall.name}" failed to parse as JSON, indicating the tool call was truncated or malformed mid-stream. ` +
+                content: `Error: The arguments for "${toolCall.name}" failed to parse as JSON, indicating the provider returned truncated or malformed tool arguments. ` +
                     `Re-issue the call with valid JSON arguments; do not assume the previous attempt ran.`,
                 isError: true,
                 status: "blocked",

package/dist/clipboard.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build the OSC 52 escape sequence for the given text. Returns `null` when the
+ * base64 payload exceeds {@link MAX_OSC52_ENCODED_LENGTH}.
+ *
+ * Format: ESC ] 52 ; c ; <base64> BEL  =>  `\x1b]52;c;<base64>\x07`
+ *
+ * Exported for unit testing the encoding/cap logic in isolation.
+ */
+export declare function encodeOsc52(text: string): string | null;
+/**
+ * Copy `text` to the system clipboard. Resolves once a copy path succeeds and
+ * throws only when no path (native tools nor OSC 52) could place the text.
+ */
+export declare function copyToClipboard(text: string): Promise<void>;

package/dist/clipboard.js

@@ -0,0 +1,132 @@
+import { execSync, spawn } from "node:child_process";
+import { platform } from "node:os";
+/**
+ * Maximum length of the base64-encoded payload we are willing to emit via
+ * OSC 52. Very large payloads can desynchronize terminal rendering and many
+ * terminals silently drop sequences past ~100k, so we cap and skip instead.
+ */
+const MAX_OSC52_ENCODED_LENGTH = 100_000;
+function copyToX11Clipboard(options) {
+    try {
+        execSync("xclip -selection clipboard", options);
+    }
+    catch {
+        execSync("xsel --clipboard --input", options);
+    }
+}
+/**
+ * True when we appear to be running over SSH/Mosh, i.e. the host running this
+ * process is not the machine whose clipboard the user is looking at.
+ */
+function isRemoteSession(env = process.env) {
+    return Boolean(env.SSH_CONNECTION || env.SSH_CLIENT || env.MOSH_CONNECTION);
+}
+/**
+ * True when running inside a tmux session. tmux intercepts/relays terminal
+ * clipboard escapes, so OSC 52 is the reliable path to reach the outer
+ * terminal's clipboard (especially tmux-over-ssh). Native pbcopy still works
+ * locally, so we treat this as "also emit OSC 52", never as a replacement.
+ */
+function isTmuxSession(env = process.env) {
+    return Boolean(env.TMUX);
+}
+/**
+ * Build the OSC 52 escape sequence for the given text. Returns `null` when the
+ * base64 payload exceeds {@link MAX_OSC52_ENCODED_LENGTH}.
+ *
+ * Format: ESC ] 52 ; c ; <base64> BEL  =>  `\x1b]52;c;<base64>\x07`
+ *
+ * Exported for unit testing the encoding/cap logic in isolation.
+ */
+export function encodeOsc52(text) {
+    const encoded = Buffer.from(text).toString("base64");
+    if (encoded.length > MAX_OSC52_ENCODED_LENGTH) {
+        return null;
+    }
+    return `\x1b]52;c;${encoded}\x07`;
+}
+/**
+ * Write the OSC 52 sequence to stdout. Returns false (without writing) when the
+ * payload is too large to emit safely.
+ */
+function emitOsc52(text) {
+    const sequence = encodeOsc52(text);
+    if (sequence === null) {
+        return false;
+    }
+    process.stdout.write(sequence);
+    return true;
+}
+/**
+ * Copy `text` to the system clipboard. Resolves once a copy path succeeds and
+ * throws only when no path (native tools nor OSC 52) could place the text.
+ */
+export async function copyToClipboard(text) {
+    let copied = false;
+    const p = platform();
+    const options = { input: text, timeout: 5000, stdio: ["pipe", "ignore", "ignore"] };
+    try {
+        if (p === "darwin") {
+            execSync("pbcopy", options);
+            copied = true;
+        }
+        else if (p === "win32") {
+            execSync("clip", options);
+            copied = true;
+        }
+        else {
+            // Linux/other. Try Termux, Wayland, then X11 clipboard tools.
+            if (process.env.TERMUX_VERSION) {
+                try {
+                    execSync("termux-clipboard-set", options);
+                    copied = true;
+                }
+                catch {
+                    // Fall back to Wayland or X11 tools.
+                }
+            }
+            if (!copied) {
+                const hasWaylandDisplay = Boolean(process.env.WAYLAND_DISPLAY);
+                const hasX11Display = Boolean(process.env.DISPLAY);
+                if (hasWaylandDisplay) {
+                    try {
+                        // Verify wl-copy exists (spawn errors are async and won't be caught).
+                        execSync("which wl-copy", { stdio: "ignore" });
+                        // wl-copy with execSync hangs due to fork behavior; use spawn instead.
+                        const proc = spawn("wl-copy", [], { stdio: ["pipe", "ignore", "ignore"] });
+                        proc.stdin.on("error", () => {
+                            // Ignore EPIPE errors if wl-copy exits early.
+                        });
+                        proc.stdin.write(text);
+                        proc.stdin.end();
+                        proc.unref();
+                        copied = true;
+                    }
+                    catch {
+                        if (hasX11Display) {
+                            copyToX11Clipboard(options);
+                            copied = true;
+                        }
+                    }
+                }
+                else if (hasX11Display) {
+                    copyToX11Clipboard(options);
+                    copied = true;
+                }
+            }
+        }
+    }
+    catch {
+        // Fall through to the OSC 52 fallback.
+    }
+    // Emit OSC 52 when the native clipboard may be unreachable from this host
+    // (remote sessions, tmux relaying to an outer terminal) or when no native
+    // tool succeeded. This is additive — never throw if a native copy worked.
+    if (isRemoteSession() || isTmuxSession() || !copied) {
+        const osc52Copied = emitOsc52(text);
+        copied = copied || osc52Copied;
+    }
+    if (!copied) {
+        throw new Error("Failed to copy to clipboard");
+    }
+}

package/dist/config.d.ts

@@ -10,6 +10,7 @@ export type ThemeMode = "auto" | "light" | "dark";
 export interface ThemeConfig {
     mode: ThemeMode;
     overrides?: Record<string, string>;
+    explicit?: boolean;
 }
 export interface UserConfigData {
     defaultModel?: string;
@@ -65,5 +66,7 @@ export declare class UserConfig {
     getAgentCategories(): AgentCategoriesConfig;
     getSubagents(): SubagentsUserConfig;
 }
+export declare function shouldProbeTerminalTheme(config: ThemeConfig): boolean;
+export declare function effectiveThemeModeForTerminal(config: ThemeConfig, detectedTheme: Exclude<ThemeMode, "auto">): ThemeMode;
 /** Mask an API key for safe display. */
 export declare function maskKey(key: string): string;

package/dist/config.js

@@ -55,7 +55,7 @@ function sanitizeTheme(value) {
         return undefined;
     if (typeof value === "string") {
         return value === "auto" || value === "light" || value === "dark"
-            ? { mode: value }
+            ? { mode: value, explicit: true }
             : undefined;
     }
     if (typeof value !== "object" || Array.isArray(value))
@@ -68,7 +68,12 @@ function sanitizeTheme(value) {
         if (mode !== "auto" && mode !== "light" && mode !== "dark")
             return undefined;
         const overrides = isStringMap(maybeNew.overrides) ? maybeNew.overrides : undefined;
-        return overrides ? { mode, overrides } : { mode };
+        const explicit = maybeNew.explicit === true ? true : undefined;
+        return {
+            mode,
+            ...(overrides ? { overrides } : {}),
+            ...(explicit ? { explicit } : {}),
+        };
     }
     const overrides = pickStringEntries(value);
     if (Object.keys(overrides).length === 0)
@@ -188,15 +193,15 @@ export class UserConfig {
     setThemeMode(mode) {
         const current = this.getTheme();
         this.data.theme = current.overrides
-            ? { mode, overrides: current.overrides }
-            : { mode };
+            ? { mode, overrides: current.overrides, explicit: true }
+            : { mode, explicit: true };
         this.save();
     }
     setThemeOverrides(overrides) {
         const current = this.getTheme();
         this.data.theme = Object.keys(overrides).length === 0
-            ? { mode: current.mode }
-            : { mode: current.mode, overrides: { ...overrides } };
+            ? { mode: current.mode, ...(current.explicit ? { explicit: true } : {}) }
+            : { mode: current.mode, overrides: { ...overrides }, ...(current.explicit ? { explicit: true } : {}) };
         this.save();
     }
     getAgentCategories() {
@@ -206,6 +211,17 @@ export class UserConfig {
         return sanitizeSubagentsConfig(this.data.subagents) ?? {};
     }
 }
+export function shouldProbeTerminalTheme(config) {
+    return config.mode === "auto" || isLegacyBareDarkTheme(config);
+}
+export function effectiveThemeModeForTerminal(config, detectedTheme) {
+    if (isLegacyBareDarkTheme(config) && detectedTheme === "light")
+        return "auto";
+    return config.mode;
+}
+function isLegacyBareDarkTheme(config) {
+    return config.mode === "dark" && config.explicit !== true && !config.overrides;
+}
 /** Mask an API key for safe display. */
 export function maskKey(key) {
     if (key.length <= 12)

package/dist/goal/format.js

@@ -30,6 +30,20 @@ function trimZero(value) {
     return Number.isInteger(rounded) ? String(rounded) : rounded.toFixed(1);
 }
 function tokensPart(goal) {
+    const untracked = goal.untrackedTokenTurns ?? 0;
+    if (untracked > 0) {
+        const turns = `${untracked} ${untracked === 1 ? "turn" : "turns"}`;
+        if (goal.tokensUsed > 0) {
+            const budget = goal.tokenBudget !== undefined
+                ? `/${formatTokensCompact(goal.tokenBudget)}`
+                : "";
+            return `${formatTokensCompact(goal.tokensUsed)}${budget} tok tracked; usage unavailable for ${turns}`;
+        }
+        if (goal.tokenBudget !== undefined) {
+            return `usage unavailable for ${turns}; budget ${formatTokensCompact(goal.tokenBudget)} tok`;
+        }
+        return `usage unavailable for ${turns}`;
+    }
     if (goal.tokenBudget !== undefined) {
         return `${formatTokensCompact(goal.tokensUsed)}/${formatTokensCompact(goal.tokenBudget)} tok`;
     }
@@ -59,11 +73,27 @@ export function goalSummaryText(goal) {
  * update_goal tool can't report this — see goal/tools.ts).
  */
 export function goalCompleteNotice(goal) {
-    const tokens = goal.tokenBudget !== undefined
-        ? `${formatTokensCompact(goal.tokensUsed)}/${formatTokensCompact(goal.tokenBudget)} tok`
-        : `${formatTokensCompact(goal.tokensUsed)} tok`;
+    const tokens = completionTokenUsagePhrase(goal);
     const turns = `${goal.turnsSpent} ${goal.turnsSpent === 1 ? "turn" : "turns"}`;
-    return `Goal complete — ${tokens} used over ${turns}.`;
+    return `Goal complete — ${tokens} over ${turns}.`;
+}
+function completionTokenUsagePhrase(goal) {
+    const untracked = goal.untrackedTokenTurns ?? 0;
+    if (untracked > 0) {
+        if (goal.tokensUsed > 0) {
+            const budget = goal.tokenBudget !== undefined
+                ? `/${formatTokensCompact(goal.tokenBudget)}`
+                : "";
+            return `${formatTokensCompact(goal.tokensUsed)}${budget} tok used, plus unavailable usage`;
+        }
+        if (goal.tokenBudget !== undefined) {
+            return `token usage unavailable (budget ${formatTokensCompact(goal.tokenBudget)} tok)`;
+        }
+        return "token usage unavailable";
+    }
+    return goal.tokenBudget !== undefined
+        ? `${formatTokensCompact(goal.tokensUsed)}/${formatTokensCompact(goal.tokenBudget)} tok used`
+        : `${formatTokensCompact(goal.tokensUsed)} tok used`;
 }
 /** Compact single-line indicator for the status line / sidebar. */
 export function goalIndicatorLine(goal, maxObjective = 48) {

package/dist/goal/store.d.ts

@@ -15,6 +15,8 @@ export interface GoalState {
     /** Optional positive token budget; auto-continuation stops once reached. */
     tokenBudget?: number;
     tokensUsed: number;
+    /** Goal turns where the provider did not report token usage. */
+    untrackedTokenTurns?: number;
     /** Number of completed goal turns (including the initial turn). */
     turnsSpent: number;
     createdAt: number;
@@ -52,6 +54,7 @@ export declare class GoalStore {
     markBudgetLimited(): GoalState | null;
     private setStatus;
     addTokens(n: number): void;
+    markTokenUsageUnavailable(): void;
     incrementTurn(): void;
     /** True when a token budget is set and usage has reached or exceeded it. */
     isBudgetExceeded(): boolean;

package/dist/goal/store.js

@@ -54,6 +54,7 @@ export class GoalStore {
             status: "active",
             tokenBudget,
             tokensUsed: 0,
+            untrackedTokenTurns: 0,
             turnsSpent: 0,
             createdAt: ts,
             updatedAt: ts,
@@ -131,6 +132,13 @@ export class GoalStore {
         this.touch();
         this.emit();
     }
+    markTokenUsageUnavailable() {
+        if (!this.goal)
+            return;
+        this.goal.untrackedTokenTurns = (this.goal.untrackedTokenTurns ?? 0) + 1;
+        this.touch();
+        this.emit();
+    }
     incrementTurn() {
         if (!this.goal)
             return;
@@ -154,7 +162,12 @@ export class GoalStore {
             this.goal = null;
         }
         else {
-            this.goal = { ...state };
+            this.goal = {
+                ...state,
+                untrackedTokenTurns: state.untrackedTokenTurns !== undefined && state.untrackedTokenTurns > 0
+                    ? Math.round(state.untrackedTokenTurns)
+                    : 0,
+            };
         }
         this.emit();
     }

package/dist/goal/usage.d.ts

@@ -0,0 +1,2 @@
+import type { TokenUsage } from "../types.js";
+export declare function tokenUsageTotal(usage: TokenUsage): number;

package/dist/goal/usage.js

@@ -0,0 +1,3 @@
+export function tokenUsageTotal(usage) {
+    return usage.totalTokens ?? ((usage.promptTokens || 0) + (usage.completionTokens || 0));
+}

package/dist/main.js

@@ -6,7 +6,7 @@ import chalk from "chalk";
 import { Agent } from "./agent.js";
 import { BudgetLedger } from "./agent/budget-ledger.js";
 import { parseArgs, printHelp } from "./cli.js";
-import { UserConfig } from "./config.js";
+import { effectiveThemeModeForTerminal, shouldProbeTerminalTheme, UserConfig } from "./config.js";
 import { createProviderInstance, createUnavailableProvider } from "./provider.js";
 import { resolveConfiguredModel } from "./model-selection.js";
 import { getDefaultThinkingLevel } from "./provider-transform.js";
@@ -31,10 +31,6 @@ import { basename } from "node:path";
 import { normalizeSingleLine, truncateVisual } from "./text-display.js";
 import { BUBBLE_WORDMARK } from "./tui/wordmark.js";
 import { configureDebugTrace, summarizeAgentEventForTrace, summarizeTraceMessage, traceEvent, } from "./debug-trace.js";
-// OpenTUI is the default renderer. The React Ink implementation (alt-screen
-// viewport, src/tui-ink) is feature-complete but still maturing — opt in with
-// BUBBLE_TUI=ink.
-const USE_OPENTUI = process.env.BUBBLE_TUI !== "ink";
 async function main() {
     const args = parseArgs(process.argv.slice(2));
     if (process.argv.includes("-h") || process.argv.includes("--help")) {
@@ -229,21 +225,21 @@ async function main() {
         }
         else {
             const themeConfig = userConfig.getTheme();
-            if (themeConfig.mode === "auto") {
+            if (shouldProbeTerminalTheme(themeConfig)) {
                 const { detectTerminalTheme } = await import("./tui/detect-theme.js");
                 preResolvedTheme = await detectTerminalTheme();
             }
             else {
-                preResolvedTheme = themeConfig.mode;
+                preResolvedTheme = themeConfig.mode === "light" ? "light" : "dark";
             }
-            const { runSessionPicker } = USE_OPENTUI
-                ? await import("./tui-opentui/run-session-picker.js")
-                : await import("./tui-ink/run-session-picker.js");
+            const pickerThemeMode = effectiveThemeModeForTerminal(themeConfig, preResolvedTheme);
+            const pickerResolvedTheme = pickerThemeMode === "auto" ? preResolvedTheme : pickerThemeMode;
+            const { runSessionPicker } = await import("./tui-ink/run-session-picker.js");
             const picked = await runSessionPicker({
                 currentCwd: args.cwd,
                 currentSessions,
                 allSessions,
-                resolvedTheme: preResolvedTheme,
+                resolvedTheme: pickerResolvedTheme,
                 themeOverrides: themeConfig.overrides,
             });
             if (picked) {
@@ -317,7 +313,7 @@ async function main() {
         sessionFile: sessionManager?.getSessionFile(),
         provider: activeProviderId || "none",
         model: activeModel || "none",
-        renderer: printMode ? "print" : USE_OPENTUI ? "opentui-core" : "ink",
+        renderer: printMode ? "print" : "ink",
     });
     if (traceInfo.enabled) {
         traceEvent("run_start", {
@@ -508,15 +504,16 @@ async function main() {
         if (preResolvedTheme) {
             detectedTheme = preResolvedTheme;
         }
-        else if (themeConfig.mode === "auto") {
-            // Probe before OpenTUI owns stdin. OSC 11 needs raw mode, and the
+        else if (shouldProbeTerminalTheme(themeConfig)) {
+            // Probe before the renderer owns stdin. OSC 11 needs raw mode, and the
             // runtime renderer can consume the reply before startup code sees it.
             const { detectTerminalTheme } = await import("./tui/detect-theme.js");
             detectedTheme = await detectTerminalTheme();
         }
         else {
-            detectedTheme = themeConfig.mode;
+            detectedTheme = themeConfig.mode === "light" ? "light" : "dark";
         }
+        const effectiveThemeMode = effectiveThemeModeForTerminal(themeConfig, detectedTheme);
         // In-place session switch for the /session picker: rebind every closure
         // that persists to the session (onMessageAppend, markers, title updater)
         // by reassigning the outer `sessionManager`, then replace the agent's
@@ -572,33 +569,17 @@ async function main() {
         const { startStartupUpdateCheck } = await import("./update/index.js");
         const updateCheck = await startStartupUpdateCheck();
         const updateNotice = updateCheck.notice;
-        // Two explicit branches (not a dynamic ternary import) so TypeScript
-        // checks each renderer's RunTuiOptions shape independently.
-        let exitWallMs;
-        if (USE_OPENTUI) {
-            const { runTui } = await import("./tui/run.js");
-            await runTui(agent, args, {
-                ...commonOptions,
-                themeMode: themeConfig.mode,
-                themeOverrides: themeConfig.overrides,
-                detectedTheme,
-                onThemeModeChange: (mode) => userConfig.setThemeMode(mode),
-                updateNotice: updateNotice ?? undefined,
-                updateNoticeRefresh: updateCheck.refreshed,
-            });
-        }
-        else {
-            const { runTui } = await import("./tui-ink/run.js");
-            const summary = await runTui(agent, args, {
-                ...commonOptions,
-                themeMode: themeConfig.mode,
-                themeOverrides: themeConfig.overrides,
-                detectedTheme,
-                onThemeModeChange: (mode) => userConfig.setThemeMode(mode),
-                updateNotice: updateNotice ?? undefined,
-            });
-            exitWallMs = summary?.wallMs;
-        }
+        const { runTui } = await import("./tui-ink/run.js");
+        const summary = await runTui(agent, args, {
+            ...commonOptions,
+            themeMode: effectiveThemeMode,
+            themeOverrides: themeConfig.overrides,
+            detectedTheme,
+            onThemeModeChange: (mode) => userConfig.setThemeMode(mode),
+            updateNotice: updateNotice ?? undefined,
+            updateNoticeRefresh: updateCheck.refreshed,
+        });
+        const exitWallMs = summary?.wallMs;
         if (sessionManager) {
             printExitSummary(sessionManager, {
                 resumed: resumedExistingSession,

package/dist/model-catalog.d.ts

@@ -1,5 +1,5 @@
 import type { ReasoningEffort } from "./types.js";
-export type ProviderProtocol = "openai-chat" | "anthropic-messages";
+export type ProviderProtocol = "openai-chat" | "anthropic-messages" | "ark-responses";
 export interface BuiltinProviderDefinition {
     id: string;
     name: string;
@@ -13,6 +13,7 @@ export interface BuiltinModelDefinition {
     name: string;
     providerId: string;
     reasoningLevels: ReasoningEffort[];
+    defaultReasoningLevel?: ReasoningEffort;
     contextWindow?: number;
     /**
      * Server-declared cap on per-tool-output tokens. When set, the agent must
@@ -27,6 +28,7 @@ export declare const BUILTIN_MODELS: BuiltinModelDefinition[];
 export declare function listBuiltinModels(providerId: string): BuiltinModelDefinition[];
 export declare function registerDynamicModelMetadata(model: BuiltinModelDefinition): void;
 export declare function getBuiltinModel(providerId: string, modelId: string): BuiltinModelDefinition | undefined;
+export declare function getModelDefaultReasoningLevel(providerId: string, modelId: string): ReasoningEffort | undefined;
 export declare function getBuiltinProvider(providerId: string): BuiltinProviderDefinition | undefined;
 export declare function getModelContextWindow(providerId: string, modelId: string): number | undefined;
 export declare function getToolOutputTokenLimit(providerId: string, modelId: string): number | undefined;

package/dist/model-catalog.js

@@ -10,9 +10,9 @@ export const BUILTIN_PROVIDERS = [
     { id: "zai", name: "Z.AI", baseURL: "https://api.z.ai/api/paas/v4" },
     { id: "zai-coding-plan", name: "Z.AI Coding Plan", baseURL: "https://api.z.ai/api/coding/paas/v4" },
     { id: "alibaba", name: "Alibaba DashScope", baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1" },
+    { id: "doubao", name: "Doubao (Volcengine Ark)", baseURL: "https://ark.cn-beijing.volces.com/api/v3", protocol: "ark-responses" },
     { id: "minimax", name: "MiniMax Token Plan", baseURL: "https://api.minimaxi.com/anthropic", protocol: "anthropic-messages" },
-    { id: "minimax-openai", name: "MiniMax (OpenAI Compatible)", baseURL: "https://api.minimaxi.com/v1" },
-    { id: "minimax-anthropic", name: "MiniMax (Anthropic Compatible)", baseURL: "https://api.minimaxi.com/anthropic", protocol: "anthropic-messages", hidden: true },
+    { id: "minimax-anthropic", name: "MiniMax API", baseURL: "https://api.minimaxi.com/anthropic", protocol: "anthropic-messages" },
     { id: "stepfun", name: "StepFun Step Plan", baseURL: "https://api.stepfun.com/step_plan/v1" },
     { id: "moonshot-cn", name: "Moonshot (国内 platform.moonshot.cn)", baseURL: "https://api.moonshot.cn/v1" },
     { id: "moonshot-intl", name: "Moonshot (海外 platform.moonshot.ai)", baseURL: "https://api.moonshot.ai/v1" },
@@ -40,10 +40,16 @@ const GLM_5_2_LEVELS = ["high", "max", "off"];
 const KIMI_THINKING_ONLY_LEVELS = ["medium"];
 const DEEPSEEK_V4_LEVELS = ["high", "max"];
 const STEPFUN_REASONING_LEVELS = ["off", "low", "medium", "high"];
+const DOUBAO_SEED_REASONING_LEVELS = ["minimal", "low", "medium", "high"];
 const MINIMAX_M3_REASONING_LEVELS = ["off", "medium"];
 const MINIMAX_REASONING_LEVELS = ["medium"];
-const ANTHROPIC_ALWAYS_ADAPTIVE_LEVELS = ["medium"];
-const ANTHROPIC_ADAPTIVE_LEVELS = ["off", "medium"];
+// Anthropic exposes reasoning depth through output_config.effort (low | medium
+// | high | xhigh | max), not a token budget. xhigh is Opus 4.7+ only; max is
+// Opus 4.6+/Sonnet 4.6/Fable 5; Haiku 4.5 does not accept the effort param.
+// Fable 5 has thinking always on, so it has no "off". "off" disables thinking.
+const ANTHROPIC_OPUS_EFFORT_LEVELS = ["off", "low", "medium", "high", "xhigh", "max"];
+const ANTHROPIC_SONNET_EFFORT_LEVELS = ["off", "low", "medium", "high", "max"];
+const ANTHROPIC_FABLE_EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
 const ANTHROPIC_CHAT_LEVELS = ["off"];
 export const BUILTIN_MODELS = [
     { id: "gpt-5.5", name: "gpt-5.5", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000, toolOutputTokenLimit: 10000 },
@@ -61,9 +67,9 @@ export const BUILTIN_MODELS = [
     { id: "o1-preview", name: "o1-preview", providerId: "openai", reasoningLevels: ["off", "low", "medium", "high"], contextWindow: 128000 },
     { id: "o1-mini", name: "o1-mini", providerId: "openai", reasoningLevels: ["off", "low", "medium", "high"], contextWindow: 128000 },
     { id: "gpt-4-turbo", name: "gpt-4-turbo", providerId: "openai", reasoningLevels: OPENAI_CHAT_LEVELS, contextWindow: 128000 },
-    { id: "claude-fable-5", name: "Claude Fable 5", providerId: "anthropic", reasoningLevels: ANTHROPIC_ALWAYS_ADAPTIVE_LEVELS, contextWindow: 1000000 },
-    { id: "claude-opus-4-8", name: "Claude Opus 4.8", providerId: "anthropic", reasoningLevels: ANTHROPIC_ADAPTIVE_LEVELS, contextWindow: 1000000 },
-    { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6", providerId: "anthropic", reasoningLevels: ANTHROPIC_ADAPTIVE_LEVELS, contextWindow: 1000000 },
+    { id: "claude-fable-5", name: "Claude Fable 5", providerId: "anthropic", reasoningLevels: ANTHROPIC_FABLE_EFFORT_LEVELS, defaultReasoningLevel: "high", contextWindow: 1000000 },
+    { id: "claude-opus-4-8", name: "Claude Opus 4.8", providerId: "anthropic", reasoningLevels: ANTHROPIC_OPUS_EFFORT_LEVELS, defaultReasoningLevel: "high", contextWindow: 1000000 },
+    { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6", providerId: "anthropic", reasoningLevels: ANTHROPIC_SONNET_EFFORT_LEVELS, defaultReasoningLevel: "high", contextWindow: 1000000 },
     { id: "claude-haiku-4-5-20251001", name: "Claude Haiku 4.5", providerId: "anthropic", reasoningLevels: ANTHROPIC_CHAT_LEVELS, contextWindow: 200000 },
     { id: "deepseek-v4-flash", name: "deepseek-v4-flash", providerId: "deepseek", reasoningLevels: DEEPSEEK_V4_LEVELS, contextWindow: 1048576 },
     { id: "deepseek-v4-pro", name: "deepseek-v4-pro", providerId: "deepseek", reasoningLevels: DEEPSEEK_V4_LEVELS, contextWindow: 1048576 },
@@ -88,33 +94,13 @@ export const BUILTIN_MODELS = [
     { id: "glm-4.6", name: "GLM-4.6", providerId: "zai-coding-plan", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
     { id: "qwen3.6-plus", name: "Qwen3.6 Plus", providerId: "alibaba", reasoningLevels: ["off"], contextWindow: 1048576 },
     { id: "qwen3.7-max", name: "Qwen3.7 Max", providerId: "alibaba", reasoningLevels: ["off"], contextWindow: 1048576 },
+    { id: "doubao-seed-2-1-pro-260628", name: "Doubao Seed 2.1 Pro", providerId: "doubao", reasoningLevels: DOUBAO_SEED_REASONING_LEVELS, defaultReasoningLevel: "high" },
     { id: "MiniMax-M3", name: "MiniMax M3", providerId: "minimax", reasoningLevels: MINIMAX_M3_REASONING_LEVELS, contextWindow: 1000000 },
     { id: "MiniMax-M2.7", name: "MiniMax M2.7", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
     { id: "MiniMax-M2.7-highspeed", name: "MiniMax M2.7 Highspeed", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.5", name: "MiniMax M2.5", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.5-highspeed", name: "MiniMax M2.5 Highspeed", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.1", name: "MiniMax M2.1", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.1-highspeed", name: "MiniMax M2.1 Highspeed", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2", name: "MiniMax M2", providerId: "minimax", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "M2-her", name: "M2-her", providerId: "minimax", reasoningLevels: ["off"], contextWindow: 64000 },
-    { id: "MiniMax-M3", name: "MiniMax M3", providerId: "minimax-openai", reasoningLevels: MINIMAX_M3_REASONING_LEVELS, contextWindow: 1000000 },
-    { id: "MiniMax-M2.7", name: "MiniMax M2.7", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.7-highspeed", name: "MiniMax M2.7 Highspeed", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.5", name: "MiniMax M2.5", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.5-highspeed", name: "MiniMax M2.5 Highspeed", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.1", name: "MiniMax M2.1", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.1-highspeed", name: "MiniMax M2.1 Highspeed", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2", name: "MiniMax M2", providerId: "minimax-openai", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "M2-her", name: "M2-her", providerId: "minimax-openai", reasoningLevels: ["off"], contextWindow: 64000 },
     { id: "MiniMax-M3", name: "MiniMax M3", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_M3_REASONING_LEVELS, contextWindow: 1000000 },
     { id: "MiniMax-M2.7", name: "MiniMax M2.7", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
     { id: "MiniMax-M2.7-highspeed", name: "MiniMax M2.7 Highspeed", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.5", name: "MiniMax M2.5", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.5-highspeed", name: "MiniMax M2.5 Highspeed", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.1", name: "MiniMax M2.1", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2.1-highspeed", name: "MiniMax M2.1 Highspeed", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "MiniMax-M2", name: "MiniMax M2", providerId: "minimax-anthropic", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
-    { id: "M2-her", name: "M2-her", providerId: "minimax-anthropic", reasoningLevels: ["off"], contextWindow: 64000 },
     { id: "step-3.7-flash", name: "Step 3.7 Flash", providerId: "stepfun", reasoningLevels: STEPFUN_REASONING_LEVELS, contextWindow: 256000 },
     { id: "step-3.5-flash-2603", name: "Step 3.5 Flash 2603", providerId: "stepfun", reasoningLevels: STEPFUN_REASONING_LEVELS },
     { id: "step-3.5-flash", name: "Step 3.5 Flash", providerId: "stepfun", reasoningLevels: STEPFUN_REASONING_LEVELS },
@@ -171,6 +157,9 @@ export function getBuiltinModel(providerId, modelId) {
             ? BUILTIN_MODELS.find((model) => model.providerId === "openai-codex" && model.id === modelId)
             : undefined);
 }
+export function getModelDefaultReasoningLevel(providerId, modelId) {
+    return getBuiltinModel(providerId, modelId)?.defaultReasoningLevel;
+}
 export function getBuiltinProvider(providerId) {
     return BUILTIN_PROVIDERS.find((provider) => provider.id === providerId);
 }

package/dist/prompt/compose.js

@@ -84,7 +84,7 @@ function buildGuidelines(tools, extraGuidelines) {
         add("Skills may provide specialized workflows. When a task appears to match a specialized workflow, call skill_search to find relevant skills, then call skill with the exact name to load the selected skill before applying it");
     }
     if (tools.includes("todo_write")) {
-        add("Use todo_write to plan any task that needs three or more concrete steps before you start. Mark each item completed as soon as it is done; do not batch updates");
+        add("Default to just doing the work. Reach for todo_write only when tracking progress would genuinely help — multi-phase work with real dependencies, a long task spanning several areas, an explicit user request, or steps you discover mid-task. Don't make a list to pad a task you could just do; when in doubt, skip it. Mark each item completed as soon as it is done; do not batch updates");
     }
     for (const item of extraGuidelines) {
         add(item);

package/dist/provider-anthropic.d.ts

@@ -22,7 +22,11 @@ interface AnthropicRequest {
     thinking?: {
         type: "adaptive";
     };
+    output_config?: {
+        effort: AnthropicEffort;
+    };
 }
+type AnthropicEffort = "low" | "medium" | "high" | "xhigh" | "max";
 type AnthropicCacheControl = typeof ANTHROPIC_PROMPT_CACHE_CONTROL;
 interface AnthropicSystemBlock {
     type: "text";