@bubblebrain-ai/bubble 0.0.35 → 0.0.37

package/dist/memory/phase2.js

@@ -2,7 +2,8 @@ import { randomUUID } from "node:crypto";
 import { MemoryDatabase } from "./db.js";
 import { getMemoryPaths } from "./paths.js";
 import { buildConsolidationMessages, parseJsonObject } from "./prompts.js";
-import { rebuildRawMemories, syncRolloutSummaries, writeConsolidatedMemory } from "./storage.js";
+import { classifyMemorySession } from "./session-policy.js";
+import { clearGeneratedMemoryOutputs, rebuildRawMemories, syncRolloutSummaries, writeConsolidatedMemory, } from "./storage.js";
 const DEFAULT_SELECTION_LIMIT = 40;
 export async function runMemoryPhase2(options) {
     if (!options.model) {
@@ -17,8 +18,26 @@ export async function runMemoryPhase2(options) {
         return { status: "skipped", reason: claim.reason ?? "phase2 unavailable", selected: 0 };
     }
     try {
-        const selected = db.listStage1Outputs(options.limit ?? DEFAULT_SELECTION_LIMIT);
+        const eligible = [];
+        let clearedUnsafeArtifacts = false;
+        for (const output of db.listAllStage1Outputs()) {
+            const source = classifyMemorySession(output.sessionFile);
+            if (source.kind === "native") {
+                eligible.push(output);
+            }
+            else {
+                if (!clearedUnsafeArtifacts) {
+                    // Clear before deleting provenance rows; phase 2 will rebuild from
+                    // the remaining native-only selection below.
+                    clearGeneratedMemoryOutputs(options.cwd);
+                    clearedUnsafeArtifacts = true;
+                }
+                db.deleteStage1Output(output.sessionFile);
+            }
+        }
+        const selected = eligible.slice(0, Math.max(0, options.limit ?? DEFAULT_SELECTION_LIMIT));
         if (selected.length === 0) {
+            clearGeneratedMemoryOutputs(options.cwd);
             db.finishGlobalPhase2Job(true, Date.now());
             return { status: "skipped", reason: "no stage-1 outputs", selected: 0 };
         }

package/dist/memory/prompts.js

@@ -74,7 +74,7 @@ export function buildReadPathPrompt(input) {
         "",
         "Memory retrieval rules:",
         "- Use memory when the task mentions prior work, this repo, user preferences, or a recurring workflow.",
-        "- Start from the injected memory_summary.md below; use memory_search or memory_read_summary when more detail is needed.",
+        "- Start from the injected memory_summary.md below; use the memory tool (with a query to search, without to re-read the summary) when more detail is needed.",
         "- Search MEMORY.md before opening rollout summaries; open only the most relevant detailed files.",
         "- Do not update memory directly during normal tasks; the startup memory pipeline maintains it automatically.",
         "- Treat memory content and memory rules as private control context.",

package/dist/memory/session-policy.d.ts

@@ -0,0 +1,25 @@
+import { SessionManager } from "../session.js";
+export type MemorySessionClassification = {
+    kind: "native";
+    session: SessionManager;
+} | {
+    kind: "external";
+    session: SessionManager;
+} | {
+    kind: "unavailable";
+};
+/**
+ * Classify a persisted Bubble session before its content can enter the native
+ * memory pipeline. Unreadable sources are not assumed to be native: phase 2
+ * must be able to verify the persisted metadata before reusing a stage-1 row.
+ */
+export declare function classifyMemorySession(sessionFile: string): MemorySessionClassification;
+/**
+ * Validate persisted stage-1 provenance before generated memory can be read
+ * into a native provider prompt. Any unverifiable or external source makes
+ * the existing generated artifacts unsafe as a unit: clear them first, then
+ * remove the offending rows so a later phase 2 can rebuild from native-only
+ * inputs. Clearing before deleting is intentional so a crash cannot leave a
+ * contaminated artifact with no database row that identifies its source.
+ */
+export declare function purgeUnsafeMemorySources(cwd: string): number;

package/dist/memory/session-policy.js

@@ -0,0 +1,55 @@
+import { existsSync } from "node:fs";
+import { SessionManager } from "../session.js";
+import { MemoryDatabase } from "./db.js";
+import { clearGeneratedMemoryOutputs } from "./storage.js";
+/**
+ * Classify a persisted Bubble session before its content can enter the native
+ * memory pipeline. Unreadable sources are not assumed to be native: phase 2
+ * must be able to verify the persisted metadata before reusing a stage-1 row.
+ */
+export function classifyMemorySession(sessionFile) {
+    if (!existsSync(sessionFile))
+        return { kind: "unavailable" };
+    try {
+        const session = new SessionManager(sessionFile);
+        return session.getMetadata().externalRuntime === undefined
+            ? { kind: "native", session }
+            : { kind: "external", session };
+    }
+    catch {
+        return { kind: "unavailable" };
+    }
+}
+/**
+ * Validate persisted stage-1 provenance before generated memory can be read
+ * into a native provider prompt. Any unverifiable or external source makes
+ * the existing generated artifacts unsafe as a unit: clear them first, then
+ * remove the offending rows so a later phase 2 can rebuild from native-only
+ * inputs. Clearing before deleting is intentional so a crash cannot leave a
+ * contaminated artifact with no database row that identifies its source.
+ */
+export function purgeUnsafeMemorySources(cwd) {
+    let db;
+    try {
+        db = new MemoryDatabase(cwd);
+        const outputs = db.listAllStage1Outputs();
+        const unsafe = outputs.filter((output) => classifyMemorySession(output.sessionFile).kind !== "native");
+        if (unsafe.length === 0) {
+            if (outputs.length === 0)
+                clearGeneratedMemoryOutputs(cwd);
+            return 0;
+        }
+        clearGeneratedMemoryOutputs(cwd);
+        for (const output of unsafe)
+            db.deleteStage1Output(output.sessionFile);
+        return unsafe.length;
+    }
+    catch {
+        // Generated memory without verifiable provenance must never be injected.
+        clearGeneratedMemoryOutputs(cwd);
+        return 0;
+    }
+    finally {
+        db?.close();
+    }
+}

package/dist/memory/storage.d.ts

@@ -6,5 +6,6 @@ export declare function writeConsolidatedMemory(cwd: string, input: {
     memoryMd: string;
     memorySummaryMd: string;
 }): void;
+export declare function clearGeneratedMemoryOutputs(cwd: string): void;
 export declare function resetMemoryWorkspace(cwd: string): void;
 export declare function rolloutSummaryFileName(output: Stage1Output): string;

package/dist/memory/storage.js

@@ -57,6 +57,19 @@ export function writeConsolidatedMemory(cwd, input) {
     writeFileSync(paths.globalMemory, normalizeMemoryMarkdown(input.memoryMd), "utf-8");
     writeFileSync(paths.globalSummary, normalizeSummaryMarkdown(input.memorySummaryMd), "utf-8");
 }
+export function clearGeneratedMemoryOutputs(cwd) {
+    const paths = getMemoryPaths(cwd);
+    rmSync(paths.globalRawMemories, { force: true });
+    rmSync(paths.globalMemory, { force: true });
+    rmSync(paths.globalSummary, { force: true });
+    if (!existsSync(paths.globalRolloutSummaries))
+        return;
+    for (const file of readdirSync(paths.globalRolloutSummaries)) {
+        if (file.endsWith(".md")) {
+            rmSync(join(paths.globalRolloutSummaries, file), { force: true });
+        }
+    }
+}
 export function resetMemoryWorkspace(cwd) {
     const paths = getMemoryPaths(cwd);
     rmSync(paths.globalRoot, { recursive: true, force: true });

package/dist/model-catalog.d.ts

@@ -8,13 +8,23 @@ export interface BuiltinProviderDefinition {
     hidden?: boolean;
     supportsOAuth?: boolean;
 }
+/**
+ * Relative capability/cost tier within one provider's lineup (never a
+ * cross-provider comparison). Drives rank-guarded category routing and the
+ * routing menu (docs/model-routing-design.md §2). Untiered models never
+ * participate in automatic routing but stay reachable by explicit name.
+ */
+export type ModelTier = "fast" | "balanced" | "strong";
 export interface BuiltinModelDefinition {
     id: string;
     name: string;
     providerId: string;
     reasoningLevels: ReasoningEffort[];
     defaultReasoningLevel?: ReasoningEffort;
+    tier?: ModelTier;
     contextWindow?: number;
+    /** Routes this model through the Codex Responses Lite backend when true. */
+    useResponsesLite?: boolean;
     /**
      * Server-declared cap on per-tool-output tokens. When set, the agent must
      * truncate each tool result to this token budget before adding it to history
@@ -27,6 +37,14 @@ export declare const BUILTIN_PROVIDERS: BuiltinProviderDefinition[];
 export declare const BUILTIN_MODELS: BuiltinModelDefinition[];
 export declare function listBuiltinModels(providerId: string): BuiltinModelDefinition[];
 export declare function registerDynamicModelMetadata(model: BuiltinModelDefinition): void;
+export declare function clearDynamicModelMetadata(providerId: string): void;
+export declare function replaceDynamicModelMetadata(providerId: string, models: readonly BuiltinModelDefinition[]): void;
+/**
+ * All dynamic-overlay entries for a provider (openai includes its
+ * openai-codex catalog alias). The overlay was previously visible only via
+ * getBuiltinModel point lookups; the routing snapshot builder needs the list.
+ */
+export declare function listDynamicModelMetadata(providerId: string): BuiltinModelDefinition[];
 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;

package/dist/model-catalog.js

@@ -2,6 +2,9 @@ export const BUILTIN_PROVIDERS = [
     { id: "openrouter", name: "OpenRouter", baseURL: "https://openrouter.ai/api/v1" },
     { id: "openai", name: "OpenAI", baseURL: "https://api.openai.com/v1", supportsOAuth: true },
     { id: "openai-codex", name: "OpenAI Codex (ChatGPT)", baseURL: "https://chatgpt.com/backend-api" },
+    // Grok subscription models via the CLI chat proxy. OAuth-only: the proxy
+    // accepts xAI session bearers (from /login grok), not api.x.ai API keys.
+    { id: "grok", name: "Grok Subscription", baseURL: "https://cli-chat-proxy.grok.com/v1", supportsOAuth: true },
     { id: "anthropic", name: "Anthropic", baseURL: "https://api.anthropic.com", protocol: "anthropic-messages" },
     { id: "deepseek", name: "DeepSeek", baseURL: "https://api.deepseek.com" },
     // Native Gemini API via the AI SDK google provider. Users who configured the
@@ -26,6 +29,8 @@ export const BUILTIN_PROVIDERS = [
     { id: "local", name: "Local (OpenAI-compatible)", baseURL: "http://localhost:11434/v1" },
 ];
 const ALL_OPENAI_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
+const GPT56_LEVELS = ["low", "medium", "high", "xhigh", "max", "ultra"];
+const GPT56_LUNA_LEVELS = ["low", "medium", "high", "xhigh", "max"];
 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"];
@@ -56,80 +61,88 @@ 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"];
+// Grok 4.5 exposes low/medium/high effort with no "off" (thinking always on);
+// the composer model declares no effort support at all.
+const GROK_45_LEVELS = ["low", "medium", "high"];
 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 },
-    { id: "gpt-5.4-mini", name: "gpt-5.4-mini", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
+    { id: "gpt-5.6-sol", name: "GPT-5.6-Sol", providerId: "openai-codex", tier: "balanced", reasoningLevels: GPT56_LEVELS, defaultReasoningLevel: "low", contextWindow: 372000, useResponsesLite: true, toolOutputTokenLimit: 10000 },
+    { id: "gpt-5.6-terra", name: "GPT-5.6-Terra", providerId: "openai-codex", tier: "strong", reasoningLevels: GPT56_LEVELS, defaultReasoningLevel: "medium", contextWindow: 372000, useResponsesLite: true, toolOutputTokenLimit: 10000 },
+    { id: "gpt-5.6-luna", name: "GPT-5.6-Luna", providerId: "openai-codex", tier: "strong", reasoningLevels: GPT56_LUNA_LEVELS, defaultReasoningLevel: "medium", contextWindow: 372000, useResponsesLite: true, toolOutputTokenLimit: 10000 },
+    { id: "gpt-5.5", name: "gpt-5.5", providerId: "openai-codex", tier: "strong", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000, toolOutputTokenLimit: 10000 },
+    { id: "gpt-5.4", name: "gpt-5.4", providerId: "openai-codex", tier: "balanced", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
+    { id: "gpt-5.4-mini", name: "gpt-5.4-mini", providerId: "openai-codex", tier: "fast", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
     { id: "gpt-5.3-codex", name: "gpt-5.3-codex", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
     { id: "gpt-5.3-codex-spark", name: "gpt-5.3-codex-spark", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
     { id: "gpt-5.2-codex", name: "gpt-5.2-codex", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
     { id: "gpt-5.2", name: "gpt-5.2", providerId: "openai-codex", reasoningLevels: ALL_OPENAI_LEVELS, contextWindow: 272000 },
     { id: "gpt-5.1-codex-max", name: "gpt-5.1-codex-max", providerId: "openai-codex", reasoningLevels: GPT51_CODEX_MAX_LEVELS, contextWindow: 272000 },
-    { id: "gpt-5.1-codex-mini", name: "gpt-5.1-codex-mini", providerId: "openai-codex", reasoningLevels: GPT51_CODEX_MINI_LEVELS, contextWindow: 272000 },
+    { id: "gpt-5.1-codex-mini", name: "gpt-5.1-codex-mini", providerId: "openai-codex", tier: "fast", reasoningLevels: GPT51_CODEX_MINI_LEVELS, contextWindow: 272000 },
     { id: "gpt-5.1", name: "gpt-5.1", providerId: "openai-codex", reasoningLevels: GPT51_LEVELS, contextWindow: 272000 },
-    { id: "gpt-4o", name: "gpt-4o", providerId: "openai", reasoningLevels: OPENAI_CHAT_LEVELS, contextWindow: 128000 },
-    { id: "gpt-4o-mini", name: "gpt-4o-mini", providerId: "openai", reasoningLevels: OPENAI_CHAT_LEVELS, contextWindow: 128000 },
-    { 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: "grok-4.5", name: "Grok 4.5", providerId: "grok", tier: "strong", reasoningLevels: GROK_45_LEVELS, defaultReasoningLevel: "high", contextWindow: 500000 },
+    { id: "grok-composer-2.5-fast", name: "Grok Composer 2.5 Fast", providerId: "grok", tier: "fast", reasoningLevels: OPENAI_CHAT_LEVELS, contextWindow: 200000 },
+    { id: "gpt-4o", name: "gpt-4o", providerId: "openai", tier: "balanced", reasoningLevels: OPENAI_CHAT_LEVELS, contextWindow: 128000 },
+    { id: "gpt-4o-mini", name: "gpt-4o-mini", providerId: "openai", tier: "fast", reasoningLevels: OPENAI_CHAT_LEVELS, contextWindow: 128000 },
+    { id: "o1-preview", name: "o1-preview", providerId: "openai", tier: "strong", reasoningLevels: ["off", "low", "medium", "high"], contextWindow: 128000 },
+    { id: "o1-mini", name: "o1-mini", providerId: "openai", tier: "fast", 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_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 },
+    { id: "claude-fable-5", name: "Claude Fable 5", providerId: "anthropic", tier: "strong", reasoningLevels: ANTHROPIC_FABLE_EFFORT_LEVELS, defaultReasoningLevel: "high", contextWindow: 1000000 },
+    { id: "claude-opus-4-8", name: "Claude Opus 4.8", providerId: "anthropic", tier: "strong", reasoningLevels: ANTHROPIC_OPUS_EFFORT_LEVELS, defaultReasoningLevel: "high", contextWindow: 1000000 },
+    { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6", providerId: "anthropic", tier: "balanced", reasoningLevels: ANTHROPIC_SONNET_EFFORT_LEVELS, defaultReasoningLevel: "high", contextWindow: 1000000 },
+    { id: "claude-haiku-4-5-20251001", name: "Claude Haiku 4.5", providerId: "anthropic", tier: "fast", reasoningLevels: ANTHROPIC_CHAT_LEVELS, contextWindow: 200000 },
+    { id: "deepseek-v4-flash", name: "deepseek-v4-flash", providerId: "deepseek", tier: "fast", reasoningLevels: DEEPSEEK_V4_LEVELS, contextWindow: 1048576 },
+    { id: "deepseek-v4-pro", name: "deepseek-v4-pro", providerId: "deepseek", tier: "strong", reasoningLevels: DEEPSEEK_V4_LEVELS, contextWindow: 1048576 },
     // 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: "gemini-3.5-flash", name: "Gemini 3.5 Flash", providerId: "google", tier: "fast", reasoningLevels: GEMINI_3_FLASH_LEVELS, contextWindow: 1048576 },
+    { id: "gemini-3.1-pro-preview", name: "Gemini 3.1 Pro", providerId: "google", tier: "strong", reasoningLevels: GEMINI_3_LEVELS, defaultReasoningLevel: "high", contextWindow: 1048576 },
+    { id: "gemini-3-flash-preview", name: "Gemini 3 Flash", providerId: "google", tier: "fast", reasoningLevels: GEMINI_3_FLASH_LEVELS, contextWindow: 1048576 },
+    { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro", providerId: "google", tier: "strong", reasoningLevels: GEMINI_25_PRO_LEVELS, defaultReasoningLevel: "high", contextWindow: 1048576 },
+    { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash", providerId: "google", tier: "fast", reasoningLevels: GEMINI_25_FLASH_LEVELS, contextWindow: 1048576 },
+    { id: "glm-5.2", name: "GLM-5.2", providerId: "zhipuai", tier: "strong", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
+    { id: "glm-5.1", name: "GLM-5.1", providerId: "zhipuai", tier: "balanced", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
     { id: "glm-4.7", name: "GLM-4.7", providerId: "zhipuai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
     { id: "glm-4.6", name: "GLM-4.6", providerId: "zhipuai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
-    { id: "glm-5.2", name: "GLM-5.2", providerId: "zhipuai-coding-plan", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
-    { id: "glm-5.1", name: "GLM-5.1", providerId: "zhipuai-coding-plan", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
+    { id: "glm-5.2", name: "GLM-5.2", providerId: "zhipuai-coding-plan", tier: "strong", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
+    { id: "glm-5.1", name: "GLM-5.1", providerId: "zhipuai-coding-plan", tier: "balanced", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
     { id: "glm-4.7", name: "GLM-4.7", providerId: "zhipuai-coding-plan", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
     { id: "glm-4.6", name: "GLM-4.6", providerId: "zhipuai-coding-plan", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
-    { id: "glm-5.2", name: "GLM-5.2", providerId: "zai", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
-    { id: "glm-5.1", name: "GLM-5.1", providerId: "zai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
+    { id: "glm-5.2", name: "GLM-5.2", providerId: "zai", tier: "strong", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
+    { id: "glm-5.1", name: "GLM-5.1", providerId: "zai", tier: "balanced", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
     { id: "glm-4.7", name: "GLM-4.7", providerId: "zai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
     { id: "glm-4.6", name: "GLM-4.6", providerId: "zai", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
-    { id: "glm-5.2", name: "GLM-5.2", providerId: "zai-coding-plan", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
-    { id: "glm-5-turbo", name: "GLM-5-Turbo", providerId: "zai-coding-plan", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
+    { id: "glm-5.2", name: "GLM-5.2", providerId: "zai-coding-plan", tier: "strong", reasoningLevels: GLM_5_2_LEVELS, contextWindow: 1000000 },
+    { id: "glm-5-turbo", name: "GLM-5-Turbo", providerId: "zai-coding-plan", tier: "fast", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 200000 },
     { id: "glm-4.7", name: "GLM-4.7", providerId: "zai-coding-plan", reasoningLevels: TOGGLE_THINKING_LEVELS, contextWindow: 204800 },
     { 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: "qwen3.6-plus", name: "Qwen3.6 Plus", providerId: "alibaba", tier: "balanced", reasoningLevels: ["off"], contextWindow: 1048576 },
+    { id: "qwen3.7-max", name: "Qwen3.7 Max", providerId: "alibaba", tier: "strong", 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-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-M3", name: "MiniMax M3", providerId: "minimax", tier: "strong", reasoningLevels: MINIMAX_M3_REASONING_LEVELS, contextWindow: 1000000 },
+    { id: "MiniMax-M2.7", name: "MiniMax M2.7", providerId: "minimax", tier: "balanced", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
+    { id: "MiniMax-M2.7-highspeed", name: "MiniMax M2.7 Highspeed", providerId: "minimax", tier: "fast", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
+    { id: "MiniMax-M3", name: "MiniMax M3", providerId: "minimax-anthropic", tier: "strong", reasoningLevels: MINIMAX_M3_REASONING_LEVELS, contextWindow: 1000000 },
+    { id: "MiniMax-M2.7", name: "MiniMax M2.7", providerId: "minimax-anthropic", tier: "balanced", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
+    { id: "MiniMax-M2.7-highspeed", name: "MiniMax M2.7 Highspeed", providerId: "minimax-anthropic", tier: "fast", reasoningLevels: MINIMAX_REASONING_LEVELS, contextWindow: 204800 },
     { 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 },
     { 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.7-code", name: "Kimi K2.7 Code", providerId: "moonshot-cn", tier: "strong", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
+    { id: "kimi-k2.7-code-highspeed", name: "Kimi K2.7 Code Highspeed", providerId: "moonshot-cn", tier: "fast", 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: "kimi-k2.5", name: "Kimi K2.5", 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.7-code", name: "Kimi K2.7 Code", providerId: "moonshot-intl", tier: "strong", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
+    { id: "kimi-k2.7-code-highspeed", name: "Kimi K2.7 Code Highspeed", providerId: "moonshot-intl", tier: "fast", 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: "kimi-k2.5", name: "Kimi K2.5", 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.7-code", name: "Kimi K2.7 Code", providerId: "kimi-for-coding", tier: "strong", reasoningLevels: KIMI_THINKING_ONLY_LEVELS, contextWindow: 262144 },
+    { id: "kimi-k2.7-code-highspeed", name: "Kimi K2.7 Code Highspeed", providerId: "kimi-for-coding", tier: "fast", 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: "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 },
@@ -154,6 +167,39 @@ function overlayKey(providerId, modelId) {
 export function registerDynamicModelMetadata(model) {
     dynamicOverlay.set(overlayKey(model.providerId, model.id), model);
 }
+export function clearDynamicModelMetadata(providerId) {
+    const providerIds = providerId === "openai"
+        ? ["openai", "openai-codex"]
+        : [providerId];
+    for (const key of dynamicOverlay.keys()) {
+        if (providerIds.some((id) => key.startsWith(`${id}:`)))
+            dynamicOverlay.delete(key);
+    }
+}
+export function replaceDynamicModelMetadata(providerId, models) {
+    clearDynamicModelMetadata(providerId);
+    const acceptedProviderIds = providerId === "openai"
+        ? new Set(["openai", "openai-codex"])
+        : new Set([providerId]);
+    for (const model of models) {
+        if (acceptedProviderIds.has(model.providerId))
+            registerDynamicModelMetadata(model);
+    }
+}
+/**
+ * All dynamic-overlay entries for a provider (openai includes its
+ * openai-codex catalog alias). The overlay was previously visible only via
+ * getBuiltinModel point lookups; the routing snapshot builder needs the list.
+ */
+export function listDynamicModelMetadata(providerId) {
+    const providerIds = providerId === "openai" ? ["openai", "openai-codex"] : [providerId];
+    const out = [];
+    for (const [key, model] of dynamicOverlay) {
+        if (providerIds.some((id) => key.startsWith(`${id}:`)))
+            out.push(model);
+    }
+    return out;
+}
 export function getBuiltinModel(providerId, modelId) {
     const overlayHit = dynamicOverlay.get(overlayKey(providerId, modelId))
         || (providerId === "openai" ? dynamicOverlay.get(overlayKey("openai-codex", modelId)) : undefined);

package/dist/model-config.d.ts

@@ -4,7 +4,7 @@
  * Users can define providers, API keys, base URLs, and custom models
  * in ~/.bubble/models.json.
  */
-import type { ProviderProtocol } from "./model-catalog.js";
+import type { ModelTier, ProviderProtocol } from "./model-catalog.js";
 import type { ModelInfo } from "./provider-registry.js";
 export interface ProviderModelConfig {
     baseURL?: string;
@@ -13,6 +13,8 @@ export interface ProviderModelConfig {
     models?: Array<{
         id: string;
         name?: string;
+        tier?: ModelTier;
+        routingPriority?: number;
     }>;
 }
 export interface ModelsConfig {

package/dist/model-config.js

@@ -8,6 +8,15 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 const MODELS_PATH = join(homedir(), ".bubble", "models.json");
+const MODEL_TIERS = ["fast", "balanced", "strong"];
+function sanitizeTier(value) {
+    return typeof value === "string" && MODEL_TIERS.includes(value)
+        ? value
+        : undefined;
+}
+function sanitizeRoutingPriority(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
 export class ModelConfig {
     data;
     loadError;
@@ -48,6 +57,8 @@ export class ModelConfig {
             id: m.id,
             name: m.name || m.id,
             providerId,
+            tier: sanitizeTier(m.tier),
+            routingPriority: sanitizeRoutingPriority(m.routingPriority),
         }));
     }
     getApiKey(providerId) {

package/dist/oauth/grok.d.ts

@@ -0,0 +1,25 @@
+/**
+ * xAI Grok subscription OAuth login (PKCE + local callback).
+ *
+ * Mirrors the public OAuth client used by the official Grok CLI so a Grok
+ * subscription can drive Bubble's native agent loop the same way ChatGPT
+ * OAuth does: browser sign-in once, then bearer + refresh tokens stored in
+ * ~/.bubble/auth.json.
+ */
+import type { OAuthTokens } from "./types.js";
+import { type ChatGptFetch } from "../network/chatgpt-transport.js";
+export interface GrokLoginCallbacks {
+    onStatus: (message: string) => void;
+}
+export declare function loginGrok(callbacks?: GrokLoginCallbacks, options?: {
+    fetch?: ChatGptFetch;
+}): Promise<OAuthTokens>;
+export declare function refreshGrok(refreshToken: string, options?: {
+    fetch?: ChatGptFetch;
+}): Promise<OAuthTokens>;
+/**
+ * One-time credential import from the official Grok CLI's auth store (either
+ * Bubble's isolated runtime profile or the user's real ~/.grok). Users who
+ * already completed `grok login` skip the browser round-trip entirely.
+ */
+export declare function importGrokCliCredentials(bubbleHome?: string): OAuthTokens | undefined;