@linxiraos/pi-catalog 1.1.15 → 1.1.16

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## [Unreleased]
 
-## [1.1.15] - 2026-09-16
+## [1.1.16] - 2026-09-19
 
-- 上游 v18.1.17–v18.1.21 同步:DeepSeek V4.1 Flash 原生多模态保留图片输入;GitHub Copilot OAuth 公共 GitHub/GHE 双 client-id;renovate 系模型目录配置面。
+- 上游 v18.2.5 同步:Astra 分类的确定性 override 处理。
 

package/THIRD-PARTY-NOTICES.txt

@@ -10843,7 +10843,7 @@ RUST RUNTIME DEPENDENCY LICENSES
 
 Generated from Cargo.lock by cargo-about 0.8.2 in locked, offline, workspace, all-feature, all-target mode, then restricted using cargo metadata to normal and build edges reachable from the workspace (development-only edges are excluded). cargo-deny independently evaluates the complete all-target graph.
 
-Native Opus (audiopus/audiopus_sys) and PCRE2 (pcre2/pcre2-sys) are covered by the exact crate license payloads below. inferno 0.12.8 is package-scoped as CDDL-1.0: its CDDL-covered source remains available in the locked crates.io source archive at https://crates.io/crates/inferno/0.12.8 and https://github.com/jonhoo/inferno. The full locked license text follows below.
+Native Opus (opus/opusic-sys) and PCRE2 (pcre2/pcre2-sys) are covered by the exact crate license payloads below. inferno 0.12.8 is package-scoped as CDDL-1.0: its CDDL-covered source remains available in the locked crates.io source archive at https://crates.io/crates/inferno/0.12.8 and https://github.com/jonhoo/inferno. The full locked license text follows below.
 
 -------------------------------------------------------------------------------
 License: Apache License 2.0 (Apache-2.0)
@@ -12509,6 +12509,58 @@ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+-------------------------------------------------------------------------------
+License: BSD 3-Clause "New" or "Revised" License (BSD-3-Clause)
+Used by:
+- opusic-sys 0.7.5 (https://github.com/DoumanAsh/opusic-sys)
+
+Full license text:
+
+Copyright 2001-2023 Xiph.Org, Skype Limited, Octasic,
+                    Jean-Marc Valin, Timothy B. Terriberry,
+                    CSIRO, Gregory Maxwell, Mark Borgerding,
+                    Erik de Castro Lopo, Mozilla, Amazon
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+- Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+- Neither the name of Internet Society, IETF or IETF Trust, nor the
+names of specific contributors, may be used to endorse or promote
+products derived from this software without specific prior written
+permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Opus is subject to the royalty-free patent licenses which are
+specified at:
+
+Xiph.Org Foundation:
+https://datatracker.ietf.org/ipr/1524/
+
+Microsoft Corporation:
+https://datatracker.ietf.org/ipr/1914/
+
+Broadcom Corporation:
+https://datatracker.ietf.org/ipr/1526/
+
 -------------------------------------------------------------------------------
 License: BSD 3-Clause "New" or "Revised" License (BSD-3-Clause)
 Used by:
@@ -13290,29 +13342,6 @@ jurisdiction of the Federal Courts of the Northern District of
 California and the state courts of the State of California, with
 venue lying in Santa Clara County, California.
 
--------------------------------------------------------------------------------
-License: ISC License (ISC)
-Used by:
-- audiopus_sys 0.2.2 (https://github.com/lakelezz/audiopus_sys.git)
-
-Full license text:
-
-ISC License
-
-Copyright (c) 2019, Lakelezz
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
 -------------------------------------------------------------------------------
 License: ISC License (ISC)
 Used by:
@@ -18734,7 +18763,7 @@ DEALINGS IN THE SOFTWARE.
 -------------------------------------------------------------------------------
 License: MIT License (MIT)
 Used by:
-- opus 0.3.1 (https://github.com/SpaceManiac/opus-rs)
+- opus 0.4.0 (https://github.com/SpaceManiac/opus-rs)
 
 Full license text:
 

package/dist/types/compat/auth-ids.d.ts

@@ -1,4 +1,4 @@
 /** Every provider with an `auth/<id>.kdl` policy. */
-export type AuthProviderId = "abliteration" | "aiand" | "aimlapi" | "alibaba-coding-plan" | "alibaba-token-plan" | "amazon-bedrock" | "anthropic" | "azure" | "baseten" | "bedrock-mantle" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "exa" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google" | "google-antigravity" | "google-gemini-cli" | "google-vertex" | "groq" | "huggingface" | "kagi" | "kilo" | "kimi-code" | "litellm" | "llama.cpp" | "lm-studio" | "meta" | "minimax" | "minimax-code" | "minimax-code-cn" | "mistral" | "moonshot" | "muse-code" | "nanogpt" | "novita" | "nvidia" | "ollama" | "ollama-cloud" | "openai" | "openai-codex" | "openai-codex-device" | "opencode-go" | "opencode-zen" | "openrouter" | "parallel" | "perplexity" | "qianfan" | "qwen-portal" | "sakana" | "siliconflow" | "siliconflow-cn" | "synthetic" | "tavily" | "together" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "xai" | "xai-oauth" | "xiaomi" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-sgp" | "yolo-auto" | "zai" | "zai-coding-plan" | "zenmux" | "zhipu-coding-plan";
+export type AuthProviderId = "abliteration" | "aiand" | "aimlapi" | "alibaba-coding-plan" | "alibaba-token-plan" | "amazon-bedrock" | "anthropic" | "azure" | "baseten" | "bedrock-mantle" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "exa" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google" | "google-antigravity" | "google-gemini-cli" | "google-vertex" | "groq" | "huggingface" | "kagi" | "kilo" | "kimi-code" | "litellm" | "llama.cpp" | "lm-studio" | "meta" | "minimax" | "minimax-code" | "minimax-code-cn" | "mistral" | "moonshot" | "muse-code" | "nanogpt" | "novita" | "nvidia" | "ollama" | "ollama-cloud" | "openai" | "openai-codex" | "openai-codex-device" | "opencode-go" | "opencode-zen" | "openrouter" | "parallel" | "perplexity" | "qianfan" | "qwen-portal" | "sakana" | "siliconflow" | "siliconflow-cn" | "stencil" | "synthetic" | "tavily" | "together" | "typesafe" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "xai" | "xai-oauth" | "xiaomi" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-sgp" | "yolo-auto" | "zai" | "zai-coding-plan" | "zenmux" | "zhipu-coding-plan";
 /** Providers whose policy declares a `login` flow (the `/login` roster). */
-export type LoginProviderId = "abliteration" | "aiand" | "alibaba-coding-plan" | "alibaba-token-plan" | "anthropic" | "baseten" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "exa" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google-antigravity" | "google-gemini-cli" | "huggingface" | "kagi" | "kilo" | "kimi-code" | "litellm" | "llama.cpp" | "lm-studio" | "meta" | "minimax-code" | "minimax-code-cn" | "moonshot" | "muse-code" | "nanogpt" | "novita" | "nvidia" | "ollama" | "ollama-cloud" | "openai-codex" | "openai-codex-device" | "opencode-go" | "opencode-zen" | "openrouter" | "parallel" | "perplexity" | "qianfan" | "qwen-portal" | "sakana" | "siliconflow" | "siliconflow-cn" | "synthetic" | "tavily" | "together" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "xai" | "xai-oauth" | "xiaomi" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-sgp" | "yolo-auto" | "zai" | "zai-coding-plan" | "zenmux" | "zhipu-coding-plan";
+export type LoginProviderId = "abliteration" | "aiand" | "alibaba-coding-plan" | "alibaba-token-plan" | "anthropic" | "baseten" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "exa" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google-antigravity" | "google-gemini-cli" | "huggingface" | "kagi" | "kilo" | "kimi-code" | "litellm" | "llama.cpp" | "lm-studio" | "meta" | "minimax-code" | "minimax-code-cn" | "moonshot" | "muse-code" | "nanogpt" | "novita" | "nvidia" | "ollama" | "ollama-cloud" | "openai-codex" | "openai-codex-device" | "opencode-go" | "opencode-zen" | "openrouter" | "parallel" | "perplexity" | "qianfan" | "qwen-portal" | "sakana" | "siliconflow" | "siliconflow-cn" | "stencil" | "synthetic" | "tavily" | "together" | "typesafe" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "xai" | "xai-oauth" | "xiaomi" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-sgp" | "yolo-auto" | "zai" | "zai-coding-plan" | "zenmux" | "zhipu-coding-plan";

package/dist/types/compat/behavior.d.ts

@@ -29,6 +29,8 @@ export declare function cursorModelParameters(model: string): readonly {
  * preserve quota semantics for newly discovered ids.
  */
 export declare function quotaTierFor(provider: string, model: string): string | undefined;
+/** UTC offset for a provider's timezone-naive absolute retry-reset timestamps. */
+export declare function retryResetTimezoneOffsetFor(provider: string): string | undefined;
 /** Whether a provider has catalog-authored model quota scopes. */
 export declare function hasQuotaTierPolicy(provider: string): boolean;
 /** The provider-default wire model for a model-less hosted operation. */
@@ -55,11 +57,20 @@ export declare function modelLimitsFor(provider: string, model: string): {
 } | undefined;
 /** Whether a provider roster entry is a declared non-chat/unsupported SKU. */
 export declare function isExcludedModel(provider: string, model: string): boolean;
+/** Whether an exact upstream discovery mode is excluded from a provider's coding-model roster. */
+export declare function isExcludedDiscoveryMode(provider: string, mode: string): boolean;
 /**
  * Whether a provider is retired: its entire roster is excluded from the
  * generated bundle and must never be resurrected from the previous snapshot.
  */
 export declare function isRetiredProvider(provider: string): boolean;
+/**
+ * Whether a provider's bundled rows may seed cross-provider bare-id enrichment
+ * references. Gateway-namespaced providers (ClinePass) are isolated so their
+ * limits, pricing, and reasoning controls never contaminate an unrelated proxy
+ * model that happens to advertise the same bare id.
+ */
+export declare function isBareIdReferenceProvider(provider: string): boolean;
 /** The declared subscription tier required to use a provider model id, if any. */
 export declare function planRequirementFor(provider: string, model: string): string | undefined;
 /** Cross-provider pricing-peer resolution for one provider model id. */

package/dist/types/compat/cascade.d.ts

@@ -12,26 +12,27 @@ export declare class AmbiguousOverlapError extends Error {
     readonly second: string;
     constructor(provider: string, model: string, axis: string, first: string, second: string);
 }
-/**
- * Anchored `*`-wildcard match; both sides must be pre-lowercased. `*` spans
- * any substring; non-wildcard text stays anchored in order.
- */
 export declare function globMatch(pattern: string, value: string): boolean;
 /**
- * Resolves wire, thinking, and catalog assignments for one structured target.
- *
- * Thinking axes are gated on `target.reasoning`, except that an exact model
- * selector declaring `thinking-efforts` upgrades the target (a reviewed
- * correction to stale capability metadata). Family and revision selectors
- * never match targets missing that identity rank. Unmatched targets resolve
- * to empty maps.
+ * Resolve wire, thinking, and catalog assignments for one structured target.
+ * Exact model effort corrections can enable reasoning; absent family/revision
+ * facts never satisfy selectors that require them. Returned axes are caller-owned.
  *
- * @throws AmbiguousOverlapError when two equal-rank rules contest one axis.
+ * @throws AmbiguousOverlapError when equal-rank rules contest one axis.
  */
 export declare function resolveCascade(target: ResolveTarget): ResolvedAxes;
 /**
- * Resolves a target against an arbitrary compiled cascade (test seam and
- * scratch evaluations); `resolveCascade` delegates here with the bundled
- * rule index.
+ * Resolve a target against a caller-owned compiled cascade without memoizing
+ * mutable rule data. Bundled target lookups use {@link resolveCascade}.
  */
 export declare function resolveCascadeRules(cascade: CompiledCascade, target: ResolveTarget): ResolvedAxes;
+/**
+ * Whether the effort ladder this target resolves to comes from a rule scoped
+ * to the model's identity (a recognized class, family, revision, or an explicit
+ * model selector), rather than a provider/api-wide or fallback unknown-class
+ * rule that any unrecognized id at that provider inherits.
+ *
+ * Discovery reads this to tell reviewed tiers apart from a blanket default, so
+ * catalog-published tiers can correct the latter and never the former.
+ */
+export declare function hasModelScopedEffortsRule(target: ResolveTarget): boolean;

package/dist/types/compat/collapse.d.ts

@@ -124,6 +124,14 @@ export declare function deriveThinkingPairFamilies<TSpec extends VariantSpecLike
  * unrelated carriers (GitHub Copilot `-1m` context variants) never match.
  */
 export declare function isCollapsedVariantSpec(spec: VariantSpecLike): boolean;
+/**
+ * Whether a Cursor wire id names an extended tier that upstream serves only in
+ * max mode. The compiled taxonomy identifies `xhigh`/`extra-high`/`max`
+ * efforts and their optional service lanes. This is an inference, not an
+ * upstream marker: it is the only per-tier signal available for bundled rows
+ * and for routes live discovery never advertised.
+ */
+export declare function isCursorMaxModeWireId(wireModelId: string): boolean;
 /**
  * Collapse a full mixed-provider list: per provider, the compiled reviewed table, Cursor's
  * conservative live effort-sibling rule, and the automatic `X`/`X-thinking`

package/dist/types/compat/context-window.d.ts

@@ -1,7 +1,32 @@
 import type { Model } from "../types.js";
 /**
- * Maximum prompt window for extended context. Live discovery takes precedence
- * over rule-owned fallbacks for older bundled or cached model metadata. Resolve
- * at catalog composition time so frozen bundled rows need no runtime mutation.
+ * Extended-context capacity. Curated maxima correct stale lower discovery
+ * values; a higher live maximum still wins. The registry applies this capacity
+ * only when extended context is enabled, before explicit user overrides.
  */
 export declare function resolveMaxContextWindow(model: Model): number | undefined;
+/**
+ * Override ceiling for Codex models. Upstream clamps `model_context_window`
+ * to `min(override, max_context_window)` (`with_config_overrides` in
+ * `models-manager/src/model_info.rs`); the ceiling here is stale-aware — the
+ * curated maximum corrects a lower server value (Astra reports a stale 872K
+ * maximum; OpenAI documents at most 922K input) while a higher live maximum
+ * still wins. No curated or live maximum means no ceiling: overrides pass
+ * through, matching upstream's unclamped branch.
+ */
+export declare function codexOverrideCeiling(model: Model): number | undefined;
+/**
+ * Whether explicit context-window overrides for this model clamp to the
+ * server-honored ceiling. KDL-owned (`clamp-context-override`): branching on
+ * it here keeps provider deployment contracts out of TypeScript.
+ */
+export declare function clampsContextOverride(model: Model): boolean;
+/**
+ * Clamp a requested Codex context window to the override ceiling, mirroring
+ * upstream. `model` is the pre-override model: the ceiling never shrinks the
+ * request below the window that already works, so a stale-low live maximum
+ * (e.g. 128K base with a 64K advertised maximum) cannot punish an explicit
+ * override. Returns the request unchanged when no ceiling applies or it
+ * already fits.
+ */
+export declare function clampCodexContextWindow(model: Model, requested: number): number;

package/dist/types/compat/delegation.d.ts

@@ -15,5 +15,9 @@ export type DelegationBias = (typeof DELEGATION_BIASES)[number];
 /**
  * Delegation bias for a built model; `eager` when no rule assigns one.
  * Callers: system-prompt and tool-description rendering in the coding agent.
+ *
+ * Results are cached by model object. Every cascade input is checked before a
+ * hit, including fields on a reused/mutated identity object, so model metadata
+ * refreshes and policy-relevant replacements cannot return stale bias.
  */
 export declare function resolveDelegationBias(model: Model): DelegationBias;

package/dist/types/compat/provider-ids.d.ts

@@ -0,0 +1,2 @@
+/** Every chat-model provider with a catalog entry (`default-model` in its provider rules). */
+export type KnownProvider = "abliteration" | "aiand" | "aimlapi" | "alibaba-coding-plan" | "alibaba-token-plan" | "amazon-bedrock" | "anthropic" | "azure" | "baseten" | "bedrock-mantle" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google" | "google-antigravity" | "google-gemini-cli" | "google-vertex" | "groq" | "huggingface" | "kilo" | "kimi-code" | "litellm" | "lm-studio" | "meta" | "minimax" | "minimax-code" | "minimax-code-cn" | "mistral" | "moonshot" | "muse-code" | "nanogpt" | "novita" | "nvidia" | "ollama" | "ollama-cloud" | "openai" | "openai-codex" | "opencode-go" | "opencode-zen" | "openrouter" | "qianfan" | "qwen-portal" | "sakana" | "siliconflow" | "siliconflow-cn" | "synthetic" | "together" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "xai" | "xai-oauth" | "xiaomi" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-sgp" | "yolo-auto" | "zai" | "zenmux" | "zhipu-coding-plan";

package/dist/types/compat/providers.d.ts

@@ -0,0 +1,11 @@
+import type { Api, ModelSpec } from "../types.js";
+import type { CompiledProvider } from "./types.js";
+/** Every catalog provider entry keyed by id (sorted). */
+export declare function providerEntries(): Readonly<Record<string, CompiledProvider>>;
+/** One provider's catalog entry, or `undefined` for ids without one. */
+export declare function providerEntry(provider: string): CompiledProvider | undefined;
+/**
+ * The authored seed rows for one provider (empty when it has none). Rows are
+ * the compiled JSON verbatim; callers that mutate must copy.
+ */
+export declare function seedModels<TApi extends Api = Api>(provider: string): readonly ModelSpec<TApi>[];

package/dist/types/compat/resolve.d.ts

@@ -13,3 +13,13 @@ export interface ResolvedModelPolicy<TApi extends Api = Api> {
  * complete compat record, thinking metadata, and catalog-data corrections.
  */
 export declare function resolveModelPolicy<TApi extends Api>(spec: ModelSpec<TApi>): ResolvedModelPolicy<TApi>;
+/**
+ * Whether reviewed rules know THIS model's effort ladder, as opposed to it
+ * inheriting a provider-wide default or {@link resolveThinkingPolicy} falling
+ * through to the neutral wire ladder.
+ *
+ * Discovery uses this to tell "omp knows this model's tiers" apart from "omp
+ * is guessing them", so catalog-published tiers can correct the guess without
+ * ever overriding reviewed knowledge.
+ */
+export declare function hasModelScopedEffortLadder<TApi extends Api>(spec: ModelSpec<TApi>): boolean;

package/dist/types/compat/seeds-tmp.d.ts

@@ -0,0 +1 @@
+export declare function allSeeds(): never[];

package/dist/types/compat/taxonomy.d.ts

@@ -52,13 +52,6 @@ export declare function collapseVariantId(provider: string, model: string): Coll
  * `non-thinking` and `no-thinking` are not variants.
  */
 export declare function stripThinkingVariantSuffix(model: string): string | undefined;
-/**
- * Classifies a model into its structured identity: reviewed override first,
- * then suffix collapse, then class/family/revision ranks over the logical id.
- *
- * @throws AmbiguousIdentityError on equal-rank cross-class or cross-family
- * matches unless `opts.lenient`.
- */
 export declare function classifyModel(provider: string, modelId: string, opts?: ClassifyOptions): ModelIdentity;
 /**
  * Strips a declared billing-variant suffix (`-free`, `-contributor`) from a

package/dist/types/compat/types.d.ts

@@ -5,7 +5,7 @@
  * `behavior.ts`, `resolve.ts`) exposes to consumers.
  */
 import type { Effort } from "../effort.js";
-import type { ThinkingControlMode } from "../types.js";
+import type { KnownApi, ThinkingControlMode, TokenCost } from "../types.js";
 import type { RevisionOp } from "./revision.js";
 /** Class-membership matcher kinds, most to least specific. */
 export type MatcherKind = "exact" | "bounded" | "namespace" | "prefix" | "glob";
@@ -272,6 +272,11 @@ export interface CompiledExcludeModels {
     provider: string;
     match: CompiledMatchList;
 }
+/** Exact upstream discovery modes excluded from one provider's coding-model roster. */
+export interface CompiledExcludeDiscoveryModes {
+    provider: string;
+    modes: string[];
+}
 /** Provider plan-requirement tiers keyed by matcher token lists. */
 export interface CompiledPlanRequirement {
     provider: string;
@@ -289,6 +294,11 @@ export interface CompiledPricingPeer {
         peerId: string;
     }[];
 }
+/** Provider timezone assumption for offset-less absolute retry-reset timestamps. */
+export interface CompiledRetryResetTimezone {
+    provider: string;
+    offset: string;
+}
 /** Compiled runtime behavior vocabulary (`runtime/behavior.kdl`). */
 export interface CompiledBehavior {
     openaiResponsesHeuristic?: CompiledResponsesHeuristic;
@@ -299,10 +309,13 @@ export interface CompiledBehavior {
     hostedDefaults: CompiledHostedDefault[];
     apiRoutes: CompiledApiRoutes[];
     modelLimits: CompiledModelLimits[];
+    excludeDiscoveryModes: CompiledExcludeDiscoveryModes[];
     excludeModels: CompiledExcludeModels[];
     planRequirements: CompiledPlanRequirement[];
     pricingPeers: CompiledPricingPeer[];
+    retryResetTimezones: CompiledRetryResetTimezone[];
     retiredProviders: string[];
+    referenceIsolatedProviders: string[];
 }
 /**
  * A string setting from `auth/*.kdl` that may be overridden by environment
@@ -426,6 +439,10 @@ export interface CompiledOAuthCodeLogin {
     kind: "oauth-code";
     clientId?: CompiledAuthValue;
     clientSecret?: CompiledAuthValue;
+    /** `{base}` placeholder source (the provider's API origin). */
+    baseUrl?: CompiledAuthValue;
+    /** `{auth}` placeholder source for the authorize, token, and userinfo URLs when the issuer is a separate host. */
+    authUrl?: CompiledAuthValue;
     authorizeUrl: CompiledAuthValue;
     scopes: string[];
     scopeSeparator: string;
@@ -505,6 +522,8 @@ export interface CompiledAuthProvider {
         hook: string;
     };
     allowsMissingApiKey?: boolean;
+    /** APIs whose provider transport resolves credentials without a stored account. */
+    nativeAuthApis?: string[];
     available?: boolean;
     showInLoginList?: boolean;
     storeAs?: string;
@@ -521,6 +540,80 @@ export interface CompiledAuthProvider {
 export interface CompiledAuth {
     providers: CompiledAuthProvider[];
 }
+/**
+ * When a provider's seed rows enter the generated bundle:
+ * - `always`: every regeneration; same-id upstream/discovery rows win dedup.
+ * - `fallback`: only when authoritative catalog discovery did not succeed.
+ * - `empty`: only when no other source produced a row for the provider.
+ */
+export type SeedBundlePolicy = "always" | "fallback" | "empty";
+/** Catalog-generation discovery settings (`discovery` node in `providers/<id>.kdl`). */
+export interface CompiledProviderDiscovery {
+    /** Human-readable name for generator log messages. */
+    label: string;
+    /** Env vars checked for a generation-time API key; defaults to the provider's `env`. */
+    envVars?: string[];
+    /** OAuth provider whose stored credential may stand in for an API key. */
+    oauthProvider?: string;
+    /** Discovery proceeds without credentials. */
+    allowUnauthenticated?: boolean;
+}
+/**
+ * One authored seed row: the intrinsic `ModelSpec` fields plus optional
+ * explicit `thinking` / `compat` overrides compiled from the axis vocabulary
+ * (keyed by resolved field, value-validated at compile time). `seeds.ts`
+ * projects rows to `ModelSpec` at the JSON boundary.
+ */
+export interface CompiledSeedModel {
+    id: string;
+    name: string;
+    api: KnownApi;
+    provider: string;
+    baseUrl: string;
+    reasoning: boolean;
+    input: ("text" | "image")[];
+    supportsTools?: boolean;
+    cost: TokenCost;
+    contextWindow: number | null;
+    maxTokens: number | null;
+    thinking?: Record<string, unknown>;
+    compat?: Record<string, unknown>;
+}
+/** A provider's authored seed rows (`seed` node in `providers/<id>.kdl`). */
+export interface CompiledSeed {
+    bundle: SeedBundlePolicy;
+    /**
+     * `seed`: rows are prepended after upstream merging so they outrank same-id
+     * rows and never receive cross-provider reference fills. `upstream`
+     * (default): rows are appended and same-id upstream rows win.
+     */
+    precedence: "upstream" | "seed";
+    /** Rows in declaration order (inherited `models-from` rows appended last). */
+    models: CompiledSeedModel[];
+}
+/**
+ * One chat-model provider's catalog entry: the non-code half of what the
+ * runtime and generator know about a provider. A `providers/<id>.kdl` file
+ * declares one by carrying `default-model`; files without it are wire-compat
+ * only (custom provider ids such as `llama.cpp`).
+ */
+export interface CompiledProvider {
+    id: string;
+    /** Preferred model id when no explicit selection is made. */
+    defaultModel: string;
+    /** Env vars consulted, in order, for the runtime API-key fallback. */
+    envVars?: string[];
+    /** The runtime creates a model manager even without a valid API key. */
+    allowUnauthenticated?: boolean;
+    /** Successful runtime discovery replaces bundled provider models instead of merging. */
+    dynamicModelsAuthoritative?: boolean;
+    /** Generator backfills never copy reasoning/input/limits from same-id rows on other hosts. */
+    skipCrossProviderReferenceFills?: boolean;
+    /** Present only for providers enrolled in `generate-models.ts` discovery. */
+    discovery?: CompiledProviderDiscovery;
+    /** Authored bundled rows, when the provider cannot be discovered at generation time. */
+    seed?: CompiledSeed;
+}
 /** The complete compiled rule tree persisted as `rules.json`. */
 export interface CompiledCompatRules {
     /** Compiled-format version; bump on incompatible shape changes. */
@@ -531,6 +624,8 @@ export interface CompiledCompatRules {
     cascade: CompiledCascade;
     behavior: CompiledBehavior;
     auth: CompiledAuth;
+    /** Catalog provider entries keyed by provider id, sorted. */
+    providers: Record<string, CompiledProvider>;
 }
 /** Structured identity of one classified model. */
 export interface ModelIdentity {
@@ -569,4 +664,12 @@ export interface ResolvedAxes {
     wire: Record<string, unknown>;
     thinking: Record<string, unknown>;
     catalog: Record<string, unknown>;
+    /**
+     * Reasoning capability after the exact-model effort upgrade: `true` when the
+     * target reported reasoning or an exact rule declares a ladder for it (the
+     * reviewed correction to metadata-less discovery rows). Compat resolvers
+     * read this instead of the raw spec flag, or one id resolves two different
+     * wire contracts depending on whether it came from discovery or the bake.
+     */
+    reasoning: boolean;
 }

package/dist/types/discovery/antigravity.d.ts

@@ -1,3 +1,4 @@
+import type { FetchImpl } from "@linxiraos/pi-utils";
 import { type VariantCollapseTable } from "../compat/collapse.js";
 import type { ModelSpec } from "../types.js";
 export declare const ANTIGRAVITY_PRIMARY_ENDPOINT = "https://daily-cloudcode-pa.googleapis.com";
@@ -37,6 +38,7 @@ export interface AntigravityDiscoveryAgentModelSort {
 export interface AntigravityDiscoveryApiResponse {
     models?: Record<string, AntigravityDiscoveryApiModel>;
     agentModelSorts?: AntigravityDiscoveryAgentModelSort[];
+    imageGenerationModelIds?: string[];
 }
 /**
  * Options for fetching Antigravity discovery models.
@@ -53,7 +55,7 @@ export interface FetchAntigravityDiscoveryModelsOptions {
     /** Optional abort signal for request cancellation. */
     signal?: AbortSignal;
     /** Optional fetch implementation override for tests. */
-    fetcher?: typeof fetch;
+    fetcher?: FetchImpl;
     /**
      * Hand collapse table to apply to the discovered list. Defaults to the
      * Antigravity (budget-transport) table; `googleGeminiCli` passes the
@@ -68,3 +70,10 @@ export interface FetchAntigravityDiscoveryModelsOptions {
  * Returns `[]` only when the endpoint responds successfully with no usable models.
  */
 export declare function fetchAntigravityDiscoveryModels(options: FetchAntigravityDiscoveryModelsOptions): Promise<ModelSpec<"google-gemini-cli">[] | null>;
+/** Advertised image model and serving endpoint for one Antigravity account. */
+export interface AntigravityImageModel {
+    id: string;
+    endpoint: string;
+}
+/** Resolves the first image-generation model advertised by an Antigravity account. */
+export declare function fetchAntigravityImageModel(options: FetchAntigravityDiscoveryModelsOptions): Promise<AntigravityImageModel | null>;

package/dist/types/discovery/gitlab-duo-workflow.d.ts

@@ -26,5 +26,5 @@ export declare function discoverGitLabDuoWorkflowNamespace(config: GitLabDuoWork
 export declare function discoverGitLabDuoWorkflowRuntimeNamespace(config: GitLabDuoWorkflowDiscoveryConfig): Promise<GitLabDuoWorkflowNamespaceSelection>;
 export declare function fetchGitLabDuoWorkflowModels(config: GitLabDuoWorkflowDiscoveryConfig): Promise<readonly ModelSpec<"gitlab-duo-agent">[] | null>;
 export declare function buildGitLabDuoWorkflowModelSpec(model: GitLabDuoWorkflowModelRef, baseUrl?: string, rootNamespaceId?: string): ModelSpec<"gitlab-duo-agent">;
-export declare function buildGitLabDuoWorkflowFallbackModel(id?: string, name?: string, baseUrl?: string): ModelSpec<"gitlab-duo-agent">;
+export declare function buildGitLabDuoWorkflowFallbackModel(baseUrl?: string): ModelSpec<"gitlab-duo-agent">;
 export {};

package/dist/types/model-cache.d.ts

@@ -1,6 +1,8 @@
-import type { Api, Model, ModelSpec } from "./types.js";
-interface CacheEntry<TApi extends Api = Api> {
-    models: ModelSpec<TApi>[];
+import type { Api, Model } from "./types.js";
+/** Materialized provider snapshot with freshness and header-restoration provenance. */
+export interface CacheEntry<TApi extends Api = Api> {
+    /** Trusted, fully materialized rows; request headers remain omitted. */
+    models: Model<TApi>[];
     fresh: boolean;
     authoritative: boolean;
     updatedAt: number;
@@ -20,4 +22,3 @@ interface CacheEntry<TApi extends Api = Api> {
 }
 export declare function readModelCache<TApi extends Api>(providerId: string, ttlMs: number, now: () => number, dbPath?: string): CacheEntry<TApi> | null;
 export declare function writeModelCache<TApi extends Api>(providerId: string, updatedAt: number, models: Model<TApi>[], authoritative: boolean, staticFingerprint: string, dbPath?: string, staticHeaderSources?: readonly Model<TApi>[], restorableHeaderFallback?: Record<string, string>): void;
-export {};

package/dist/types/model-manager.d.ts

@@ -20,8 +20,13 @@ export interface ModelsDevFallback<TApi extends Api = Api, TPayload = unknown> {
 export interface ModelManagerOptions<TApi extends Api = Api, TModelsDevPayload = unknown> {
     /** Provider id used for static lookup and cache namespacing. */
     providerId: Provider;
-    /** Optional static list override. When omitted, bundled models.json is used. */
-    staticModels?: readonly ModelSpec<TApi>[];
+    /**
+     * Optional static override. Raw ModelSpec rows are materialized with
+     * `buildModel`; explicitly prebuilt Model rows are consumed as trusted
+     * materializations. When omitted, generator-materialized models.json rows
+     * are consumed directly.
+     */
+    staticModels?: readonly (ModelSpec<TApi> | Model<TApi>)[];
     /** Optional override for the cache database path. Default: <agent-dir>/models.db. */
     cacheDbPath?: string;
     /** Optional provider id override for cache namespacing. Defaults to providerId. */
@@ -40,6 +45,13 @@ export interface ModelManagerOptions<TApi extends Api = Api, TModelsDevPayload =
      * bearer header comes from the current local config.
      */
     restorableHeaderFallback?: Record<string, string>;
+    /**
+     * Reconstruct omitted request headers from authoritative local configuration
+     * when no trusted static source remains. Return undefined to keep the row
+     * unavailable. This hook must not perform I/O; attach `resolveHeaders` for
+     * command-backed credentials that must wait until an actual request.
+     */
+    restoreCachedHeaders?: (model: Readonly<Model>) => Pick<Model, "headers" | "resolveHeaders"> | undefined;
     /** Optional dynamic endpoint fetcher. */
     fetchDynamicModels?: () => Promise<readonly ModelSpec<TApi>[] | null>;
     /** Optional stencil.so fallback hook. */
@@ -86,8 +98,8 @@ export declare function createModelManager<TApi extends Api = Api, TModelsDevPay
  */
 export declare function resolveProviderModels<TApi extends Api = Api, TModelsDevPayload = unknown>(options: ModelManagerOptions<TApi, TModelsDevPayload>, strategy?: ModelRefreshStrategy): Promise<ModelResolutionResult<TApi>>;
 /**
- * Return the versioned, low-collision model-cache identity for a static provider
- * slice. Results are cached by array reference so repeat cold-start paths skip
- * the JSON serialization and hash.
+ * Return the versioned content identity for a static provider slice. Callers
+ * may mutate or freeze their arrays, so every call observes current content
+ * and never attaches a stale sidecar fingerprint to caller-owned data.
  */
 export declare function fingerprintStaticModels<TApi extends Api>(models: readonly (ModelSpec<TApi> | Model<TApi>)[], dynamicModelsAuthoritative?: boolean): string;

package/dist/types/model-thinking.d.ts

@@ -35,6 +35,13 @@ export declare function mapEffortToGoogleThinkingLevel<TApi extends Api>(effort:
 /**
  * Maps a normalized thinking effort to Anthropic adaptive effort values via
  * the model's baked `thinking.effortMap` (identity for unmapped efforts).
+ *
+ * The Anthropic adaptive wire vocabulary has no `minimal` tier (valid values:
+ * `low`, `medium`, `high`, `xhigh`, `max`); a model ladder that exposes
+ * `minimal` — custom `anthropic-messages` providers do, unlike the built-in
+ * Claude ladders — would otherwise serialize `output_config.effort: "minimal"`
+ * and 400 (`level "minimal" not supported`). Clamp it to the lowest real tier,
+ * mirroring {@link mapEffortToGoogleThinkingLevel}'s `minimal` handling.
  */
 export declare function mapEffortToAnthropicAdaptiveEffort<TApi extends Api>(model: ApiModel<TApi>, effort: Effort): "low" | "medium" | "high" | "xhigh" | "max" | "adaptive";
 /**

package/dist/types/model-tokenizer.d.ts

@@ -5,4 +5,4 @@ import type { ModelTokenizer } from "./types.js";
  * This is catalog policy, not a runtime caller heuristic: [`buildModel`](./build.ts)
  * materializes the result as `Model.tokenizer`; consumers read that property.
  */
-export declare function resolveModelTokenizer(modelId: string): ModelTokenizer | undefined;
+export declare function resolveModelTokenizer(modelId: string, provider?: string): ModelTokenizer | undefined;