@oh-my-pi/pi-coding-agent 15.5.4 → 15.5.7

package/CHANGELOG.md

@@ -2,10 +2,48 @@
 
 ## [Unreleased]
 
+## [15.5.7] - 2026-05-27
+### Added
+- `providers.openrouterVariant` setting (Settings → Providers → "OpenRouter Routing") to default OpenRouter requests to a routing-variant suffix (`:nitro`, `:floor`, `:online`, `:exacto`). Selectors that already name a variant (e.g. `openrouter/anthropic/claude-haiku:nitro`) keep precedence.
+
+- `generate_image` supports xAI Grok Imagine via `providers.image=xai`. Supports `grok-imagine-image` (default) and `grok-imagine-image-quality` at aspect ratios `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`. Uses the xAI Grok OAuth credential when available, otherwise `XAI_API_KEY`.
+- New `tts` tool synthesises speech via xAI Grok Voice behind the disabled-by-default `tts.enabled` setting. Built-in voices `ara`, `eve` (default), `leo`, `rex`, `sal`; custom voice IDs also accepted. Output codec inferred from the `output_path` suffix (`.wav` → `wav`, else `mp3`). Up to 15,000 characters per request.
+
+### Fixed
+
+- Fixed plan-mode re-entry after approval reopening a fresh `local://PLAN.md` instead of the approved titled plan artifact, which could duplicate plan content and fail approval on an existing destination.
+- Fixed `read` URL reader mode aborting after a stalled Jina request instead of falling back to trafilatura/lynx/native: Jina (and Parallel extract) now have their own per-attempt sub-budget capped at 10s, the catch handler honours only real user cancellation, and the in-process native renderer is always attempted on already-loaded HTML ([#1449](https://github.com/can1357/oh-my-pi/issues/1449))
+
+## [15.5.6] - 2026-05-27
+### Added
+
+- Support for multi-range line selectors on URLs (e.g., `:5-10,20-30`) to fetch and display multiple non-contiguous sections
+- Support for combining `:raw` mode with line range selectors on URLs (e.g., `:raw:1-120` or `:1-120:raw`)
+- Support for line range selectors on directory listings (e.g., `:30-40` to view lines 30–40 of a directory tree)
+- Clear error message when requesting a line offset beyond the end of a directory listing
+
+### Changed
+
+- URL selector parsing now supports multiple trailing selector tokens (e.g., `:raw:N-M`), applying them left-to-right
+
+### Fixed
+
+- Fixed `:raw` selector being ignored for JSON and feed URLs, causing them to be pretty-printed or converted to markdown instead of returning raw content
+- Fixed directory listing line selectors silently dropping the offset parameter and only applying the limit
+
+## [15.5.5] - 2026-05-27
+
+### Changed
+
+- Removed the model-facing `path` property from hashline edit tool parameters; hashline edit targets now come from `¶PATH` headers in `input`.
+
+### Fixed
+
+- Fixed legacy pi-* extension loading regression where `import { Type } from "@(scope)/pi-ai"` (e.g. `@earendil-works/pi-ai` used by `@plannotator/pi-extension`) failed with `Export named 'Type' not found` after pi-ai 15.1.0 removed the root `Type` runtime export; the legacy-pi compat layer now redirects bare `@oh-my-pi/pi-ai` root imports through a sibling shim that re-exports the canonical pi-ai surface plus the Zod-backed `Type` runtime from the same TypeBox shim served to `@sinclair/typebox` imports ([#1437](https://github.com/can1357/oh-my-pi/issues/1437))
+
 ## [15.5.4] - 2026-05-27
 
 ### Breaking Changes
-
 - Removed the package root `hashline` export so imports from the top-level entrypoint can no longer access `hashline` helpers directly
 
 ### Added
@@ -31,6 +69,10 @@
 
 - Fixed `omp` startup and `/changelog` reading the host project's `CHANGELOG.md` as omp's — `getPackageDir()` no longer falls back to the user's `cwd` when no owning `package.json` is locatable, preventing spurious `lastChangelogVersion` writes ([#1423](https://github.com/can1357/oh-my-pi/issues/1423))
 
+### Fixed
+
+- Fixed hashline session-chain replay silently overwriting in-session edits when the model re-targeted a previously rewritten line with a stale file hash; replay now refuses unless every edit's anchor line content matches between the snapshot and the current file ([#1422](https://github.com/can1357/oh-my-pi/pull/1422))
+
 ## [15.5.3] - 2026-05-27
 ### Breaking Changes
 
@@ -40,6 +82,10 @@
 
 - Warned when legacy inline `LINE:TEXT` lines are accepted as payload continuations only when inside a pending multi-line `A-B:` replacement
 
+### Fixed
+
+- Fixed runtime model registry refresh and cache loading so providers with authoritative dynamic catalogs, including Synthetic, do not re-add deprecated bundled model IDs after discovery ([#1417](https://github.com/can1357/oh-my-pi/issues/1417)).
+
 ## [15.5.2] - 2026-05-26
 ### Breaking Changes
 
@@ -8841,4 +8887,4 @@ Initial public release.
 - Git branch display in footer
 - Message queueing during streaming responses
 - OAuth integration for Gmail and Google Calendar access
-- HTML export with syntax highlighting and collapsible sections
+- HTML export with syntax highlighting and collapsible sections

package/dist/types/config/settings-schema.d.ts

@@ -2393,6 +2393,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the calculator tool for basic calculations";
         };
     };
+    readonly "tts.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Text-to-Speech";
+            readonly description: "Enable the tts tool for xAI Grok Voice speech synthesis";
+        };
+    };
     readonly "recipe.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -3118,7 +3127,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "providers.image": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "openai", "gemini", "openrouter"];
+        readonly values: readonly ["auto", "openai", "antigravity", "xai", "gemini", "openrouter"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
@@ -3127,11 +3136,19 @@ export declare const SETTINGS_SCHEMA: {
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
-                readonly description: "Priority: GPT model image tool > Antigravity > OpenRouter > Gemini";
+                readonly description: "Priority: GPT model image tool > Antigravity > xAI > OpenRouter > Gemini";
             }, {
                 readonly value: "openai";
                 readonly label: "OpenAI";
                 readonly description: "Uses the active GPT Responses/Codex model";
+            }, {
+                readonly value: "antigravity";
+                readonly label: "Antigravity";
+                readonly description: "Requires google-antigravity OAuth";
+            }, {
+                readonly value: "xai";
+                readonly label: "xAI Grok Imagine";
+                readonly description: "Requires xAI Grok OAuth or XAI_API_KEY";
             }, {
                 readonly value: "gemini";
                 readonly label: "Gemini";
@@ -3185,6 +3202,37 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "providers.openrouterVariant": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "nitro", "floor", "online", "exacto"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "OpenRouter Routing";
+            readonly description: "Default routing-variant suffix appended to OpenRouter model IDs (overridden when the selector already names a variant)";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "No suffix; use OpenRouter's default routing";
+            }, {
+                readonly value: "nitro";
+                readonly label: ":nitro";
+                readonly description: "Prioritize throughput / lowest latency";
+            }, {
+                readonly value: "floor";
+                readonly label: ":floor";
+                readonly description: "Prioritize cheapest available provider";
+            }, {
+                readonly value: "online";
+                readonly label: ":online";
+                readonly description: "Enable OpenRouter's web-search plugin";
+            }, {
+                readonly value: "exacto";
+                readonly label: ":exacto";
+                readonly description: "Cherry-picked high-quality providers (only defined for select models)";
+            }];
+        };
+    };
     readonly "providers.parallelFetch": {
         readonly type: "boolean";
         readonly default: true;

package/dist/types/edit/hashline/diff.d.ts

@@ -12,6 +12,12 @@
 import { type PatchSection } from "@oh-my-pi/hashline";
 export interface HashlineDiffOptions {
     autoDropPureInsertDuplicates?: boolean;
+    /**
+     * Use the streaming-tolerant applier ({@link PatchSection.applyPartialTo})
+     * so trailing in-flight ops do not throw or emit phantom edits. Streaming
+     * preview path only.
+     */
+    streaming?: boolean;
 }
 export declare function computeHashlineSectionDiff(section: PatchSection, cwd: string, options?: HashlineDiffOptions): Promise<{
     diff: string;
@@ -21,7 +27,6 @@ export declare function computeHashlineSectionDiff(section: PatchSection, cwd: s
 }>;
 export declare function computeHashlineDiff(input: {
     input: string;
-    path?: string;
 }, cwd: string, options?: HashlineDiffOptions): Promise<{
     diff: string;
     firstChangedLine: number | undefined;

package/dist/types/edit/hashline/execute.d.ts

@@ -1,6 +1,6 @@
 /**
  * Coding-agent runner that drives the hashline {@link Patcher} on behalf of
- * the `edit` tool. Converts a `{input, path?}` tool-call payload into a
+ * the `edit` tool. Converts a `{input}` tool-call payload into a
  * fully-applied patch, wraps the result in the agent's
  * {@link AgentToolResult} shape, and attaches LSP diagnostics + `outputMeta`
  * for the renderer.
@@ -19,7 +19,6 @@ import { type HashlineParams, hashlineEditParamsSchema } from "./params";
 export interface ExecuteHashlineSingleOptions {
     session: ToolSession;
     input: string;
-    path?: string;
     signal?: AbortSignal;
     batchRequest?: LspBatchRequest;
     writethrough: WritethroughCallback;

package/dist/types/edit/hashline/params.d.ts

@@ -1,12 +1,11 @@
 /**
  * Zod schema for the `edit` tool's hashline mode payload. The schema is
  * deliberately permissive (`.passthrough()`) so providers can attach extra
- * keys without rejection; only `input` is required and `path` is an
- * optional fallback used when the input lacks a `¶PATH#HASH` header.
+ * keys without rejection; only `input` is required. `_input` is accepted as a
+ * provider-emitted alias for `input`.
  */
 import * as z from "zod/v4";
-export declare const hashlineEditParamsSchema: z.ZodObject<{
+export declare const hashlineEditParamsSchema: z.ZodPreprocess<z.ZodObject<{
     input: z.ZodString;
-    path: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
+}, z.core.$loose>>;
 export type HashlineParams = z.infer<typeof hashlineEditParamsSchema>;

package/dist/types/extensibility/legacy-pi-ai-shim.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Compatibility shim for legacy extensions importing the package root of
+ * `@oh-my-pi/pi-ai` (or one of its aliased scopes like `@earendil-works/pi-ai`
+ * or `@mariozechner/pi-ai`).
+ *
+ * pi-ai 15.1.0 removed the historical TypeBox root exports (`Type`, plus the
+ * runtime-relevant half of the `Static`/`TSchema` pair) from the package
+ * entrypoint. Legacy extensions still author parameter schemas as
+ * `Type.Object({ ... })`, so this file is served by `legacy-pi-compat.ts` in
+ * place of the real pi-ai entrypoint whenever a legacy extension imports the
+ * bare package root. Subpath imports (`@oh-my-pi/pi-ai/utils/oauth`, etc.)
+ * continue to resolve directly against the bundled pi-ai package.
+ *
+ * The `Type` runtime is borrowed from the Zod-backed TypeBox shim that
+ * already serves bare `@sinclair/typebox` imports for the same extension
+ * class, keeping the legacy-compat surface internally consistent.
+ *
+ * Type-level `Static` and `TSchema` continue to come from pi-ai's own
+ * `types.ts` via the `export *` below — pi-ai still exports both as types,
+ * only the runtime `Type` builder was removed.
+ */
+export * from "@oh-my-pi/pi-ai";
+export { Type } from "./typebox";

package/dist/types/lib/xai-http.d.ts

@@ -0,0 +1,40 @@
+import type { ModelRegistry } from "../config/model-registry";
+interface XAICredentials {
+    provider: "xai-oauth" | "xai";
+    apiKey: string;
+    baseURL: string;
+}
+export declare function ohMyPiXAIUserAgent(): string;
+/**
+ * Resolve xAI credentials for HTTP tool calls.
+ *
+ * Credential priority:
+ *   1. xai-oauth — only when a *dedicated* xai-oauth source exists. Composed
+ *      of two checks against the registry layer:
+ *        a. `authStorage.hasNonEnvCredential("xai-oauth")` covers stored
+ *           credentials (OAuth or api_key), runtime overrides (CLI
+ *           `--api-key` for xai-oauth), config overrides (models.yml
+ *           `providers.xai-oauth.apiKey`), and fallback resolvers.
+ *        b. `$env.XAI_OAUTH_TOKEN` covers the xai-oauth-specific env var.
+ *      `XAI_API_KEY` is intentionally NOT a signal here, even though the
+ *      env-fallback map (`stream.ts: "xai-oauth"`) lets xai-oauth borrow it
+ *      as a back-compat convenience: the borrow lets API-key-only setups
+ *      satisfy the xai-oauth branch and then resolve baseUrl under
+ *      xai-oauth instead of xai, silently bypassing `providers.xai.baseUrl`
+ *      overrides for image/TTS traffic. The gate routes the borrow case to
+ *      step 2 while preserving every dedicated xai-oauth path.
+ *   2. xai (plain API key). Delegates to ModelRegistry.getApiKeyForProvider
+ *      which runs AuthStorage.getApiKey's full cascade: runtime override →
+ *      models.yml config override → stored api_key credential → OAuth
+ *      resolution → XAI_API_KEY env var → custom fallback resolver.
+ *
+ * baseURL: see `resolveXAIBaseURL` above. Resolved AFTER the credential
+ * decision so the scoped (provider, id) lookup is unambiguous. `modelId`
+ * is optional; probes / tool-availability checks pass `undefined` and fall
+ * through to env/default.
+ *
+ * Returns null when neither credential is available. Caller is responsible
+ * for surfacing an actionable error message in that case.
+ */
+export declare function resolveXAIHttpCredentials(modelRegistry: ModelRegistry, modelId?: string): Promise<XAICredentials | null>;
+export {};

package/dist/types/session/agent-session.d.ts

@@ -454,6 +454,7 @@ export declare class AgentSession {
     get goalRuntime(): GoalRuntime;
     markPlanReferenceSent(): void;
     setPlanReferencePath(path: string): void;
+    getPlanReferencePath(): string;
     get clientBridge(): ClientBridge | undefined;
     setClientBridge(bridge: ClientBridge | undefined): void;
     getCheckpointState(): CheckpointState | undefined;

package/dist/types/tools/fetch.d.ts

@@ -1,17 +1,36 @@
 import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
 import { type Component } from "@oh-my-pi/pi-tui";
+import type { Settings } from "../config/settings";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
 import type { ToolSession } from "../sdk";
+import type { AgentStorage } from "../session/agent-storage";
 import { type OutputMeta } from "./output-meta";
+import { type LineRange } from "./path-utils";
 export declare function isReadableUrlPath(value: string): boolean;
 export interface ParsedReadUrlTarget {
     path: string;
     raw: boolean;
     offset?: number;
     limit?: number;
+    /** Populated only when the selector carries 2+ ranges. Single-range stays on offset/limit. */
+    ranges?: readonly LineRange[];
 }
 export declare function parseReadUrlTarget(readPath: string): ParsedReadUrlTarget | null;
+/**
+ * Render HTML to markdown using Parallel, jina, trafilatura, lynx, then the
+ * in-process native converter. The overall `timeout` budget bounds the call,
+ * but remote reader requests are additionally capped at `REMOTE_READER_MAX_MS`
+ * so that a hung remote endpoint cannot prevent local fallbacks from running.
+ * Only a real `userSignal` cancellation aborts the chain — remote per-attempt
+ * timeouts and the overall reader-mode timeout still allow later renderers
+ * (especially the purely-local native converter) to be tried.
+ */
+export declare function renderHtmlToText(url: string, html: string, timeout: number, settings: Settings, userSignal: AbortSignal | undefined, storage: AgentStorage | null): Promise<{
+    content: string;
+    ok: boolean;
+    method: string;
+}>;
 interface FetchImagePayload {
     data: string;
     mimeType: string;

package/dist/types/tools/find.d.ts

@@ -23,6 +23,13 @@ export type FindToolInput = z.infer<typeof findSchema>;
  * must pass through.
  */
 export declare function validateFindPathInputs(paths: readonly string[]): void;
+/**
+ * Group find matches by their directory so the model doesn't pay repeated
+ * tokens for shared path prefixes. Preserves the input order: groups appear in
+ * the order their first member was emitted (mtime-desc for native glob), and
+ * within a group entries keep their relative order.
+ */
+export declare function formatFindGroupedOutput(paths: readonly string[]): string;
 export interface FindToolDetails {
     truncation?: TruncationResult;
     resultLimitReached?: number;

package/dist/types/tools/image-gen.d.ts

@@ -2,7 +2,8 @@ import { type Model } from "@oh-my-pi/pi-ai";
 import * as z from "zod/v4";
 import { type ModelRegistry } from "../config/model-registry";
 import type { CustomTool } from "../extensibility/custom-tools/types";
-type ImageProvider = "antigravity" | "gemini" | "openai" | "openai-codex" | "openrouter";
+export type ImageProvider = "antigravity" | "gemini" | "openai" | "openai-codex" | "openrouter" | "xai";
+export type ImageProviderPreference = Exclude<ImageProvider, "openai-codex"> | "auto";
 declare const responseModalitySchema: z.ZodEnum<{
     IMAGE: "IMAGE";
     TEXT: "TEXT";
@@ -19,6 +20,8 @@ export declare const imageGenSchema: z.ZodObject<{
     aspect_ratio: z.ZodOptional<z.ZodEnum<{
         "16:9": "16:9";
         "1:1": "1:1";
+        "2:3": "2:3";
+        "3:2": "3:2";
         "3:4": "3:4";
         "4:3": "4:3";
         "9:16": "9:16";
@@ -70,8 +73,9 @@ interface InlineImageData {
     data: string;
     mimeType: string;
 }
+export declare function isImageProviderPreference(value: unknown): value is ImageProviderPreference;
 /** Set the preferred image provider from settings */
-export declare function setPreferredImageProvider(provider: ImageProvider | "auto"): void;
+export declare function setPreferredImageProvider(provider: ImageProviderPreference): void;
 export declare const imageGenTool: CustomTool<typeof imageGenSchema, ImageGenToolDetails>;
 export declare function getImageGenTools(modelRegistry?: ModelRegistry, activeModel?: Model): Promise<Array<CustomTool<typeof imageGenSchema, ImageGenToolDetails>>>;
 export declare function getImageGenToolsWithRegistry(modelRegistry: ModelRegistry, activeModel?: Model): Promise<Array<CustomTool<typeof imageGenSchema, ImageGenToolDetails>>>;

package/dist/types/tools/index.d.ts

@@ -54,6 +54,7 @@ export * from "./search";
 export * from "./search-tool-bm25";
 export * from "./ssh";
 export * from "./todo-write";
+export * from "./tts";
 export * from "./write";
 export * from "./yield";
 /** Tool type (AgentTool from pi-ai) */

package/dist/types/tools/plan-mode-guard.d.ts

@@ -2,12 +2,11 @@ import type { ToolSession } from ".";
 /**
  * Resolve a write/edit target to its absolute filesystem path.
  *
- * In plan mode, transparently redirects targets whose basename matches the
- * plan file's basename (e.g. a bare `PLAN.md` or `./PLAN.md`) to the canonical
- * plan file location at `state.planFilePath`. This lets `write` and `edit`
- * accept the unqualified plan filename and have the change land at the
- * session-scoped `local://PLAN.md` artifact instead of a stray cwd-relative
- * file the plan-mode guard would otherwise reject.
+ * In plan mode, transparently redirects `PLAN.md` aliases and targets whose
+ * basename matches the plan file's basename to the canonical plan file
+ * location at `state.planFilePath`. This lets `write` and `edit` accept the
+ * habitual plan filename after approval even when the active artifact has a
+ * titled path such as `local://APPROVED.md`.
  *
  * Outside plan mode (or when the basename does not match) this is a no-op.
  */

package/dist/types/tools/tts.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod/v4";
+import type { CustomTool } from "../extensibility/custom-tools/types";
+type TtsCodec = "mp3" | "wav";
+declare const ttsSchema: z.ZodObject<{
+    text: z.ZodString;
+    voice_id: z.ZodDefault<z.ZodString>;
+    language: z.ZodDefault<z.ZodString>;
+    output_path: z.ZodString;
+    sample_rate: z.ZodOptional<z.ZodNumber>;
+    bit_rate: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+interface TtsToolDetails {
+    bytes: number;
+    voiceId: string;
+    codec: TtsCodec;
+}
+export declare const ttsTool: CustomTool<typeof ttsSchema, TtsToolDetails>;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.5.4",
+	"version": "15.5.7",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,13 +47,13 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.5.4",
-		"@oh-my-pi/omp-stats": "15.5.4",
-		"@oh-my-pi/pi-agent-core": "15.5.4",
-		"@oh-my-pi/pi-ai": "15.5.4",
-		"@oh-my-pi/pi-natives": "15.5.4",
-		"@oh-my-pi/pi-tui": "15.5.4",
-		"@oh-my-pi/pi-utils": "15.5.4",
+		"@oh-my-pi/hashline": "15.5.7",
+		"@oh-my-pi/omp-stats": "15.5.7",
+		"@oh-my-pi/pi-agent-core": "15.5.7",
+		"@oh-my-pi/pi-ai": "15.5.7",
+		"@oh-my-pi/pi-natives": "15.5.7",
+		"@oh-my-pi/pi-tui": "15.5.7",
+		"@oh-my-pi/pi-utils": "15.5.7",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/build-binary.ts

@@ -56,6 +56,17 @@ async function main(): Promise<void> {
 					"../stats/src/sync-worker.ts",
 					"./src/tools/browser/tab-worker-entry.ts",
 					"./src/eval/js/worker-entry.ts",
+					// Legacy pi-* extension compat shims served by `legacy-pi-compat.ts`.
+					// Both are reached only via the computed `TYPEBOX_SHIM_PATH` /
+					// `LEGACY_PI_AI_SHIM_PATH` constants (which `--compile`'s static
+					// analyzer cannot trace), so each shim must be listed here to land
+					// in bunfs alongside the workers above. The bunfs entry path is
+					// `--root`-relative with a `.js` extension, e.g.
+					// `/$bunfs/root/packages/coding-agent/src/extensibility/typebox.js`,
+					// which is what the `isCompiledBinary()` branch in
+					// `legacy-pi-compat.ts` resolves to at runtime.
+					"./src/extensibility/typebox.ts",
+					"./src/extensibility/legacy-pi-ai-shim.ts",
 					"--outfile",
 					"dist/omp",
 				],

package/src/config/model-registry.ts

@@ -291,6 +291,12 @@ export function mergeDiscoveredModel<TApi extends Api>(
 	return model;
 }
 
+const AUTHORITATIVE_RUNTIME_CATALOG_PROVIDERS = new Set<string>(
+	PROVIDER_DESCRIPTORS.filter(descriptor => descriptor.dynamicModelsAuthoritative).map(
+		descriptor => descriptor.providerId,
+	),
+);
+
 function isAuthoritativeProjectCatalogModel(model: Model<Api>): boolean {
 	return (
 		model.provider === "google-vertex" &&
@@ -323,6 +329,11 @@ interface DiscoveryProviderConfig {
 	optional?: boolean;
 }
 
+interface BuiltInDiscoveryResult {
+	models: Model<Api>[];
+	authoritativeProviders: Set<string>;
+}
+
 export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
 
 export interface ProviderDiscoveryState {
@@ -914,6 +925,11 @@ export class ModelRegistry {
 				cachedAuthoritativeProviders.add(provider);
 			}
 		}
+		for (const provider of cachedStandardResult.authoritativeFreshProviders) {
+			if (AUTHORITATIVE_RUNTIME_CATALOG_PROVIDERS.has(provider)) {
+				cachedAuthoritativeProviders.add(provider);
+			}
+		}
 		if (cachedAuthoritativeProviders.size > 0) {
 			builtInModels = dropProviderModels(builtInModels, cachedAuthoritativeProviders);
 		}
@@ -1253,12 +1269,12 @@ export class ModelRegistry {
 				: Promise.all(
 						selectedDiscoverableProviders.map(provider => this.#discoverProviderModels(provider, strategy)),
 					).then(results => results.flat());
-		const [configuredDiscovered, builtInDiscovered] = await Promise.all([
+		const [configuredDiscovered, builtInDiscovery] = await Promise.all([
 			configuredDiscoveriesPromise,
 			this.#discoverBuiltInProviderModels(strategy, providerFilter),
 		]);
-		const discovered = [...configuredDiscovered, ...builtInDiscovered];
-		if (discovered.length === 0) {
+		const discovered = [...configuredDiscovered, ...builtInDiscovery.models];
+		if (discovered.length === 0 && builtInDiscovery.authoritativeProviders.size === 0) {
 			return;
 		}
 		const discoveredModels = this.#applyHardcodedModelPolicies(
@@ -1271,6 +1287,9 @@ export class ModelRegistry {
 			),
 		);
 		const authoritativeProviders = providersWithAuthoritativeProjectCatalog(discoveredModels);
+		for (const provider of builtInDiscovery.authoritativeProviders) {
+			authoritativeProviders.add(provider);
+		}
 		const baseModels =
 			authoritativeProviders.size > 0 ? dropProviderModels(this.#models, authoritativeProviders) : this.#models;
 		const resolved = this.#mergeResolvedModels(baseModels, discoveredModels);
@@ -1385,7 +1404,7 @@ export class ModelRegistry {
 	async #discoverBuiltInProviderModels(
 		strategy: ModelRefreshStrategy,
 		providerFilter?: ReadonlySet<string>,
-	): Promise<Model<Api>[]> {
+	): Promise<BuiltInDiscoveryResult> {
 		// Skip providers already handled by configured discovery (e.g. user-configured ollama with discovery.type)
 		const configuredDiscoveryProviders = new Set(this.#discoverableProviders.map(p => p.provider));
 		const managerOptions = (await this.#collectBuiltInModelManagerOptions()).filter(opts => {
@@ -1395,12 +1414,20 @@ export class ModelRegistry {
 			return providerFilter ? providerFilter.has(opts.providerId) : true;
 		});
 		if (managerOptions.length === 0) {
-			return [];
+			return { models: [], authoritativeProviders: new Set() };
 		}
 		const discoveries = await Promise.all(
 			managerOptions.map(options => this.#discoverWithModelManager(options, strategy)),
 		);
-		return discoveries.flat();
+		const authoritativeProviders = new Set<string>();
+		const models: Model<Api>[] = [];
+		for (const discovery of discoveries) {
+			models.push(...discovery.models);
+			for (const provider of discovery.authoritativeProviders) {
+				authoritativeProviders.add(provider);
+			}
+		}
+		return { models, authoritativeProviders };
 	}
 
 	async #collectBuiltInModelManagerOptions(): Promise<ModelManagerOptions<Api>[]> {
@@ -1482,19 +1509,24 @@ export class ModelRegistry {
 	async #discoverWithModelManager(
 		options: ModelManagerOptions<Api>,
 		strategy: ModelRefreshStrategy,
-	): Promise<Model<Api>[]> {
+	): Promise<BuiltInDiscoveryResult> {
 		try {
 			const manager = createModelManager({ ...options, cacheDbPath: this.#cacheDbPath });
 			const result = await manager.refresh(strategy);
-			return result.models.map(model =>
+			const models = result.models.map(model =>
 				model.provider === options.providerId ? model : { ...model, provider: options.providerId },
 			);
+			const authoritativeProviders = new Set<string>();
+			if (options.dynamicModelsAuthoritative && !result.stale) {
+				authoritativeProviders.add(options.providerId);
+			}
+			return { models, authoritativeProviders };
 		} catch (error) {
 			logger.warn("model discovery failed for provider", {
 				provider: options.providerId,
 				error: error instanceof Error ? error.message : String(error),
 			});
-			return [];
+			return { models: [], authoritativeProviders: new Set() };
 		}
 	}