@bubblebrain-ai/bubble 0.0.33 → 0.0.35

package/dist/config.js

@@ -45,9 +45,6 @@ function sanitizeSubagentsConfig(value) {
     if (typeof raw.maxActiveSubagents === "number" && Number.isFinite(raw.maxActiveSubagents)) {
         out.maxActiveSubagents = Math.max(1, Math.floor(raw.maxActiveSubagents));
     }
-    if (typeof raw.childTokenCap === "number" && Number.isFinite(raw.childTokenCap)) {
-        out.childTokenCap = Math.max(1_000, Math.floor(raw.childTokenCap));
-    }
     return Object.keys(out).length > 0 ? out : undefined;
 }
 function sanitizeTheme(value) {
@@ -211,8 +208,12 @@ export class UserConfig {
         return sanitizeSubagentsConfig(this.data.subagents) ?? {};
     }
 }
-export function shouldProbeTerminalTheme(config) {
-    return config.mode === "auto" || isLegacyBareDarkTheme(config);
+export function shouldProbeTerminalTheme(_config) {
+    // Always probe: even a forced theme needs the real terminal background to
+    // decide between inheriting it (theme matches the terminal) and painting
+    // its own canvas (forced theme mismatching the terminal, where the
+    // palette's foregrounds would otherwise be unreadable).
+    return true;
 }
 export function effectiveThemeModeForTerminal(config, detectedTheme) {
     if (isLegacyBareDarkTheme(config) && detectedTheme === "light")

package/dist/context/overflow.js

@@ -12,6 +12,8 @@ const OVERFLOW_PATTERNS = [
     /prompt is too long/i,
     /maximum context length/i,
     /too many tokens/i,
+    // Gemini: "The input token count (N) exceeds the maximum number of tokens allowed (M)."
+    /input token count.*exceeds the maximum/i,
 ];
 export function isContextOverflowError(error) {
     if (!error)

package/dist/main.js

@@ -235,12 +235,20 @@ async function main() {
             const pickerThemeMode = effectiveThemeModeForTerminal(themeConfig, preResolvedTheme);
             const pickerResolvedTheme = pickerThemeMode === "auto" ? preResolvedTheme : pickerThemeMode;
             const { runSessionPicker } = await import("./tui-ink/run-session-picker.js");
+            const { canvasBackgroundFor } = await import("./tui-ink/theme.js");
+            // Same rule as the main TUI: a forced theme mismatching the terminal
+            // paints its canvas so its foregrounds stay readable.
+            const pickerCanvas = themeConfig.overrides?.background
+                ? undefined
+                : canvasBackgroundFor(pickerThemeMode, pickerResolvedTheme, preResolvedTheme);
             const picked = await runSessionPicker({
                 currentCwd: args.cwd,
                 currentSessions,
                 allSessions,
                 resolvedTheme: pickerResolvedTheme,
-                themeOverrides: themeConfig.overrides,
+                themeOverrides: pickerCanvas
+                    ? { ...themeConfig.overrides, background: pickerCanvas }
+                    : themeConfig.overrides,
             });
             if (picked) {
                 sessionManager = new SessionManager(picked);

package/dist/model-catalog.d.ts

@@ -1,5 +1,5 @@
 import type { ReasoningEffort } from "./types.js";
-export type ProviderProtocol = "openai-chat" | "anthropic-messages" | "ark-responses";
+export type ProviderProtocol = "openai-chat" | "anthropic-messages" | "ark-responses" | "ai-sdk";
 export interface BuiltinProviderDefinition {
     id: string;
     name: string;

package/dist/model-catalog.js

@@ -4,7 +4,10 @@ export const BUILTIN_PROVIDERS = [
     { id: "openai-codex", name: "OpenAI Codex (ChatGPT)", baseURL: "https://chatgpt.com/backend-api" },
     { id: "anthropic", name: "Anthropic", baseURL: "https://api.anthropic.com", protocol: "anthropic-messages" },
     { id: "deepseek", name: "DeepSeek", baseURL: "https://api.deepseek.com" },
-    { id: "google", name: "Google", baseURL: "https://generativelanguage.googleapis.com/v1beta/openai" },
+    // Native Gemini API via the AI SDK google provider. Users who configured the
+    // old OpenAI-compat endpoint can keep it by setting protocol "openai-chat"
+    // and the /openai baseURL explicitly in models.json.
+    { id: "google", name: "Google Gemini", baseURL: "https://generativelanguage.googleapis.com/v1beta", protocol: "ai-sdk" },
     { id: "zhipuai", name: "Zhipu AI", baseURL: "https://open.bigmodel.cn/api/paas/v4" },
     { id: "zhipuai-coding-plan", name: "Zhipu AI Coding Plan", baseURL: "https://open.bigmodel.cn/api/coding/paas/v4" },
     { id: "zai", name: "Z.AI", baseURL: "https://api.z.ai/api/paas/v4" },
@@ -27,6 +30,8 @@ const GPT51_LEVELS = ["off", "low", "medium", "high"];
 const GPT51_CODEX_MAX_LEVELS = ["off", "low", "medium", "high", "xhigh"];
 const GPT51_CODEX_MINI_LEVELS = ["off", "medium", "high"];
 const OPENAI_CHAT_LEVELS = ["off"];
+// Internal representation for APIs that expose thinking as enabled/disabled.
+// UI code must render supported toggle models as on/off, not as "medium" effort.
 const TOGGLE_THINKING_LEVELS = ["off", "medium"];
 // GLM-5.2 is the first GLM to accept OpenAI-style `reasoning_effort`. The API
 // enum is none/minimal/low/medium/high/xhigh/max; we expose high and max (the
@@ -35,8 +40,8 @@ const TOGGLE_THINKING_LEVELS = ["off", "medium"];
 // is first so it is the default (getDefaultThinkingLevel falls back to levels[0]
 // when "medium" is absent), since GLM-5.2 is a thinking-on-by-default model.
 const GLM_5_2_LEVELS = ["high", "max", "off"];
-// kimi-k2.7-code only supports thinking mode (disabling it errors), so "off" is
-// not offered — the model is always in its thinking variant.
+// Kimi K2.7 Code variants only support thinking mode (disabling it errors), so
+// "off" is not offered — the model is always in its thinking variant.
 const KIMI_THINKING_ONLY_LEVELS = ["medium"];
 const DEEPSEEK_V4_LEVELS = ["high", "max"];
 const STEPFUN_REASONING_LEVELS = ["off", "low", "medium", "high"];
@@ -51,6 +56,10 @@ const ANTHROPIC_OPUS_EFFORT_LEVELS = ["off", "low", "medium", "high", "xhigh", "
 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"];
+const GEMINI_3_LEVELS = ["low", "medium", "high"];
+const GEMINI_3_FLASH_LEVELS = ["minimal", "low", "medium", "high"];
+const GEMINI_25_PRO_LEVELS = ["low", "medium", "high"];
+const GEMINI_25_FLASH_LEVELS = ["off", "low", "medium", "high"];
 export const BUILTIN_MODELS = [
     { id: "gpt-5.5", name: "gpt-5.5", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000, toolOutputTokenLimit: 10000 },
     { id: "gpt-5.4", name: "gpt-5.4", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
@@ -73,9 +82,15 @@ export const BUILTIN_MODELS = [
     { 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 },
-    { id: "gemini-2.5-pro-preview-03-25", name: "gemini-2.5-pro-preview-03-25", providerId: "google", reasoningLevels: ["off", "low", "high"], contextWindow: 128000 },
-    { id: "gemini-2.0-flash-001", name: "gemini-2.0-flash-001", providerId: "google", reasoningLevels: ["off"], contextWindow: 128000 },
-    { id: "gemini-1.5-pro-latest", name: "gemini-1.5-pro-latest", providerId: "google", reasoningLevels: ["off"], contextWindow: 128000 },
+    // Offline/no-key fallback only: with an API key the registry replaces this
+    // list via fetchGeminiModels (GET /v1beta/models, newest five). Gemini 3
+    // exposes thinking_level (minimal/low/medium/high); 2.5 Pro cannot disable
+    // thinking (no "off"), 2.5 Flash can (thinkingBudget 0).
+    { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash", providerId: "google", reasoningLevels: GEMINI_3_FLASH_LEVELS, contextWindow: 1048576 },
+    { id: "gemini-3.1-pro-preview", name: "Gemini 3.1 Pro", providerId: "google", reasoningLevels: GEMINI_3_LEVELS, defaultReasoningLevel: "high", contextWindow: 1048576 },
+    { id: "gemini-3-flash-preview", name: "Gemini 3 Flash", providerId: "google", reasoningLevels: GEMINI_3_FLASH_LEVELS, contextWindow: 1048576 },
+    { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro", providerId: "google", reasoningLevels: GEMINI_25_PRO_LEVELS, defaultReasoningLevel: "high", contextWindow: 1048576 },
+    { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash", providerId: "google", reasoningLevels: GEMINI_25_FLASH_LEVELS, contextWindow: 1048576 },
     { id: "glm-5.2", name: "GLM-5.2", providerId: "zhipuai", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
     { id: "glm-5.1", name: "GLM-5.1", providerId: "zhipuai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
     { id: "glm-4.7", name: "GLM-4.7", providerId: "zhipuai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
@@ -106,25 +121,17 @@ export const BUILTIN_MODELS = [
     { id: "step-3.5-flash", name: "Step 3.5 Flash", providerId: "stepfun", reasoningLevels: STEPFUN_REASONING_LEVELS },
     { id: "step-router-v1", name: "Step Router V1", providerId: "stepfun", reasoningLevels: STEPFUN_REASONING_LEVELS },
     { id: "kimi-k2.7-code", name: "Kimi K2.7 Code", providerId: "moonshot-cn", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
+    { id: "kimi-k2.7-code-highspeed", name: "Kimi K2.7 Code Highspeed", providerId: "moonshot-cn", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
     { id: "kimi-k2.6", name: "Kimi K2.6", providerId: "moonshot-cn", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
-    { id: "k2.6-code-preview", name: "Kimi K2.6 Code Preview", providerId: "moonshot-cn", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
     { id: "kimi-k2.5", name: "Kimi K2.5", providerId: "moonshot-cn", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
-    { id: "kimi-k2-turbo-preview", name: "Kimi K2 Turbo", providerId: "moonshot-cn", reasoningLevels: ["off"], contextWindow: 256000 },
-    { id: "kimi-k2-0905-preview", name: "Kimi K2 0905", providerId: "moonshot-cn", reasoningLevels: ["off"], contextWindow: 256000 },
-    { id: "kimi-k2-thinking", name: "Kimi K2 Thinking", providerId: "moonshot-cn", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
     { id: "kimi-k2.7-code", name: "Kimi K2.7 Code", providerId: "moonshot-intl", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
+    { id: "kimi-k2.7-code-highspeed", name: "Kimi K2.7 Code Highspeed", providerId: "moonshot-intl", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
     { id: "kimi-k2.6", name: "Kimi K2.6", providerId: "moonshot-intl", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
-    { id: "k2.6-code-preview", name: "Kimi K2.6 Code Preview", providerId: "moonshot-intl", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
     { id: "kimi-k2.5", name: "Kimi K2.5", providerId: "moonshot-intl", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
-    { id: "kimi-k2-turbo-preview", name: "Kimi K2 Turbo", providerId: "moonshot-intl", reasoningLevels: ["off"], contextWindow: 256000 },
-    { id: "kimi-k2-0905-preview", name: "Kimi K2 0905", providerId: "moonshot-intl", reasoningLevels: ["off"], contextWindow: 256000 },
-    { id: "kimi-k2-thinking", name: "Kimi K2 Thinking", providerId: "moonshot-intl", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
     { id: "kimi-k2.7-code", name: "Kimi K2.7 Code", providerId: "kimi-for-coding", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
+    { id: "kimi-k2.7-code-highspeed", name: "Kimi K2.7 Code Highspeed", providerId: "kimi-for-coding", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
     { id: "kimi-k2.6", name: "Kimi K2.6", providerId: "kimi-for-coding", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
-    { id: "k2.6-code-preview", name: "Kimi K2.6 Code Preview", providerId: "kimi-for-coding", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
-    { id: "kimi-k2-turbo-preview", name: "Kimi K2 Turbo", providerId: "kimi-for-coding", reasoningLevels: ["off"], contextWindow: 256000 },
-    { id: "kimi-k2-0905-preview", name: "Kimi K2 0905", providerId: "kimi-for-coding", reasoningLevels: ["off"], contextWindow: 256000 },
-    { id: "kimi-k2-thinking", name: "Kimi K2 Thinking", providerId: "kimi-for-coding", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
+    { id: "kimi-k2.5", name: "Kimi K2.5", providerId: "kimi-for-coding", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 256000 },
     { id: "llama-3.3-70b-versatile", name: "llama-3.3-70b-versatile", providerId: "groq", reasoningLevels: ["off"], contextWindow: 32768 },
     { id: "mixtral-8x7b-32768", name: "mixtral-8x7b-32768", providerId: "groq", reasoningLevels: ["off"], contextWindow: 32768 },
     { id: "gemma-2-9b-it", name: "gemma-2-9b-it", providerId: "groq", reasoningLevels: ["off"], contextWindow: 32768 },

package/dist/orchestrator/default-hooks.js

@@ -5,7 +5,7 @@ import { ExecutionGovernor } from "../agent/execution-governor.js";
 import { DiscoveryBarrier } from "../agent/discovery-barrier.js";
 import { arbitrateToolCall } from "../agent/tool-arbiter.js";
 import { buildEditRetryEscalationReminder, buildSmallTaskHint, buildTaskSummaryReminder, buildWorkflowPhaseReminder, } from "../prompt/reminders.js";
-import { reminderForTaskType } from "../prompt/task-reminders.js";
+import { orchestrationRequestReminder, reminderForTaskType } from "../prompt/task-reminders.js";
 import { formatCoverageSummary, resolveWorkflowPhase } from "./workflow.js";
 import { buildSubagentLifecycleReminder } from "../agent/subagent-lifecycle-reminder.js";
 export function createDefaultHooks() {
@@ -28,6 +28,12 @@ export function createDefaultHooks() {
                 if (taskReminder) {
                     ctx.queueReminder(taskReminder);
                 }
+                // User named the mechanism ("agent team" / workflow / 编排): remind at
+                // the decision turn, where it outweighs the parallel-spawns prior.
+                const orchestrationReminder = orchestrationRequestReminder(ctx.input, ctx.agent.hasToolAvailable("run_workflow"));
+                if (orchestrationReminder) {
+                    ctx.queueReminder(orchestrationReminder);
+                }
                 // Small-task hint: counterweight to the default protocol's exploration
                 // bias, only fires once per run on focused one-shot requests like
                 // "写个 HTML 介绍元旦". Don't issue for the same input twice.

package/dist/prompt/delegation.d.ts

@@ -5,7 +5,7 @@
  * and read-only-scoped, negative clauses get equal weight — the user's hard
  * constraint is "proactive, but never delegate-everything". Gated on the
  * delegation tools being present, so child agents (whose tool sets never
- * include spawn_agent/agent_team) never see it.
+ * include spawn_agent/run_workflow) never see it.
  */
 /**
  * Returns the delegation policy section when the agent actually has the

package/dist/prompt/delegation.js

@@ -5,12 +5,19 @@
  * and read-only-scoped, negative clauses get equal weight — the user's hard
  * constraint is "proactive, but never delegate-everything". Gated on the
  * delegation tools being present, so child agents (whose tool sets never
- * include spawn_agent/agent_team) never see it.
+ * include spawn_agent/run_workflow) never see it.
  */
 const DELEGATION_POLICY = `## Delegation policy (subagents)
 
-You can delegate work to background subagents (spawn_agent) and batch
-fan-outs (agent_team). Delegate deliberately, not by default.
+You can delegate work two ways: a single background subagent (spawn_agent),
+or an orchestration script coordinating many subagents (run_workflow).
+Delegate deliberately, not by default.
+
+Explicit requests win, before any other rule: when the user names a
+coordinated multi-agent run in any phrasing — a workflow, an orchestration,
+an agent team, "fan out agents" — that means run_workflow, NOT a row of
+spawn_agent calls. When they ask for a subagent, spawn one. Only when the
+user has not named a mechanism do you choose by shape (below).
 
 Delegate when:
 - An investigation will clearly require more than four search or read
@@ -18,9 +25,16 @@ Delegate when:
   needs the conclusion — delegate to a subagent so the intermediate noise
   stays out of the main context. Launch multiple subagents concurrently for
   independent questions.
-- The task naturally splits into the same read-only investigation or
-  analysis (review, audit, summarize) over several independent items (files,
-  modules, endpoints) — use agent_team.
+- The task fans out over many independent items (review, audit, summarize
+  across files, modules, endpoints) or needs staged orchestration — consider
+  run_workflow. Choose by shape, not by rule: a handful of subagents whose
+  results you want to read and react to individually favor spawn_agent; a
+  uniform sweep over many items, results that should be aggregated or
+  filtered before they reach this conversation, or control flow between
+  stages (pipelines, loops, retry rounds) favor a run_workflow script — each
+  member's full handoff stays out of your context and the script returns one
+  digested result. Failed agent() calls resolve to null, so report which
+  items came back null instead of silently dropping them.
 - A side-investigation is independent of your current main-line work and can
   run in the background while you continue.
 
@@ -51,7 +65,7 @@ Do NOT delegate when:
 When in doubt about a one-off task, do it yourself. When a task is clearly
 the same read-only operation over three or more independent items — where
 each item alone would take more than a couple of tool calls — prefer
-agent_team over doing them sequentially yourself. For just two small items,
+run_workflow over doing them sequentially yourself. For just two small items,
 do them yourself with parallel tool calls.`;
 /**
  * Returns the delegation policy section when the agent actually has the

package/dist/prompt/task-reminders.d.ts

@@ -4,3 +4,4 @@ export interface TaskReminderOptions {
     canDelegate?: boolean;
 }
 export declare function reminderForTaskType(taskType: TaskType, options?: TaskReminderOptions): string | undefined;
+export declare function orchestrationRequestReminder(input: string | import("../types.js").ContentPart[], canRunWorkflow: boolean): string | undefined;

package/dist/prompt/task-reminders.js

@@ -6,7 +6,7 @@ import { wrapInSystemReminder } from "./reminders.js";
  * keeps it away from ordinary implementation/debugging turns, so it cannot
  * amplify over-delegation.
  */
-const DELEGATION_NUDGE = "- If answering needs scanning many files and only the conclusion matters, delegate to a background subagent (spawn_agent); when it is the same read-only question over several independent items, fan out with agent_team.";
+const DELEGATION_NUDGE = "- If answering needs scanning many files and only the conclusion matters, delegate to a background subagent (spawn_agent); when it is the same read-only question over several independent items, fan out with a run_workflow script.";
 export function reminderForTaskType(taskType, options = {}) {
     switch (taskType) {
         case "debugging":
@@ -62,3 +62,26 @@ Product discussion workflow:
             return undefined;
     }
 }
+/**
+ * Deterministic detector for an explicit user request for a coordinated
+ * multi-agent run. Three rounds of prompt wording lost to the model's
+ * "agent team = parallel spawns" prior in live tests (opus-4.8, 2026-07-06);
+ * per the task-reminder principle above, a reminder injected at the decision
+ * turn is the lever that actually works — the harness remembers so the model
+ * does not have to.
+ */
+const ORCHESTRATION_REQUEST = /\b(?:workflows?|orchestrat\w*|agent[ -]?teams?|fan[ -]?out)\b|工作流|编排|(?:智能体|代理|agent)\s*(?:团队|小队)/i;
+export function orchestrationRequestReminder(input, canRunWorkflow) {
+    if (!canRunWorkflow)
+        return undefined;
+    const text = typeof input === "string"
+        ? input
+        : input.map((part) => ("text" in part ? String(part.text ?? "") : "")).join(" ");
+    if (!ORCHESTRATION_REQUEST.test(text))
+        return undefined;
+    return [
+        "- This message explicitly asks for a coordinated multi-agent run (a workflow / orchestration / agent team).",
+        "Honor it with ONE run_workflow call whose script covers the whole fan-out.",
+        "Do not substitute parallel spawn_agent calls this turn — the user named the mechanism.",
+    ].join(" ");
+}

package/dist/provider-ai-sdk.d.ts

@@ -0,0 +1,56 @@
+/**
+ * AI SDK provider backend ("ai-sdk" protocol).
+ *
+ * Consumes AI SDK provider packages at the LanguageModelV3 spec layer
+ * (`model.doStream`) rather than through the high-level `streamText` API:
+ * pre-stream HTTP errors throw natively (which our retry/rate-limit contract
+ * needs), tool-call inputs arrive as JSON strings (matching `argumentsFull`),
+ * and no step machinery or extra dependencies come along.
+ *
+ * Registered providers: google (Gemini native API). Adding another AI SDK
+ * provider is one entry in AI_SDK_PROVIDER_FACTORIES.
+ */
+import { type ProviderFetch } from "./network/provider-transport.js";
+import type { Provider, ReasoningEffort, ThinkingLevel } from "./types.js";
+export interface AiSdkProviderOptions {
+    providerId?: string;
+    apiKey: string;
+    baseURL?: string;
+    thinkingLevel?: ThinkingLevel;
+    /** Transport override for tests; defaults to the shared provider fetch. */
+    fetch?: ProviderFetch;
+}
+export declare function isAiSdkProviderId(providerId: string | undefined): boolean;
+export declare function createAiSdkProvider(options: AiSdkProviderOptions): Provider;
+export interface GeminiModelDescriptor {
+    id: string;
+    name: string;
+    contextWindow?: number;
+    reasoningLevels: ReasoningEffort[];
+    defaultReasoningLevel?: ReasoningEffort;
+}
+interface GeminiModelListEntry {
+    name?: string;
+    displayName?: string;
+    inputTokenLimit?: number;
+    supportedGenerationMethods?: string[];
+}
+/**
+ * Fetch Google's model list and keep the newest general-purpose text models.
+ * Newly released Gemini versions appear without a catalog change; the static
+ * BUILTIN_MODELS entries stay as the offline/no-key fallback.
+ */
+export declare function fetchGeminiModels(options: {
+    apiKey: string;
+    baseURL?: string;
+    fetch?: ProviderFetch;
+    limit?: number;
+}): Promise<GeminiModelDescriptor[]>;
+/**
+ * Ranking: one entry per (version, tier) family — GA ids beat dated previews —
+ * then newest version first, pro before flash before flash-lite, top N.
+ */
+export declare function selectLatestGeminiModels(entries: GeminiModelListEntry[], limit?: number): GeminiModelDescriptor[];
+/** Mirrors the static catalog's per-family thinking support. */
+export declare function geminiReasoningLevels(modelId: string): ReasoningEffort[];
+export {};