@linxiraos/pi-catalog 1.1.23 → 1.1.25

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 ## [Unreleased]
 
-## [1.1.23] - 2026-10-01
+## [1.1.25] - 2026-10-03
+
+- 版本线推进至 1.1.25；本版无独立用户可见变化。
+
+## [1.1.24] - 2026-10-03
+
+- xai-oauth 模型目录对账（移除 v18.4.11 regen 未入种条目）；bundled==seeded 一致性测试加固。
 
 ## [1.1.22] - 2026-09-30
 

package/THIRD-PARTY-NOTICES.txt

@@ -1,7 +1,7 @@
-OMP THIRD-PARTY NOTICES
+ZETA THIRD-PARTY NOTICES
 =======================
 
-This generated, self-contained aggregate accompanies OMP release artifacts.
+This generated, self-contained aggregate accompanies Zeta release artifacts.
 It does not replace package-level license files. First-party licensing grants
 no rights in third-party code, fonts, data, or marks identified below.
 
@@ -1046,7 +1046,7 @@ These packages participate only in generation/web build tooling and are not ship
 
 SCOPED NON-PERMISSIVE PACKAGES
 ------------------------------
-The exact @img/sharp-libvips-* 1.2.4 all-target family is LGPL-3.0-or-later. It is not distributed in OMP npm bundles or standalone assets: @huggingface/transformers is always external, installed into a user-side versioned runtime on demand, and sharp is stubbed for speech/text. The dynamically loaded native library remains replaceable. Corresponding source is available from https://github.com/lovell/sharp-libvips.git and upstream libvips sources.
+The exact @img/sharp-libvips-* 1.2.4 all-target family is LGPL-3.0-or-later. It is not distributed in Zeta npm bundles or standalone assets: @huggingface/transformers is always external, installed into a user-side versioned runtime on demand, and sharp is stubbed for speech/text. The dynamically loaded native library remains replaceable. Corresponding source is available from https://github.com/lovell/sharp-libvips.git and upstream libvips sources.
 
 lightningcss 1.32.0 and its exact target leaves are MPL-2.0 build-only dependencies. MPL is not globally allowed and these packages are absent from runtime artifacts.
 

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

@@ -6,6 +6,12 @@
  * prefix check would accept lookalikes like `https://api.anthropic.com.evil.com`.
  */
 export declare function isOfficialAnthropicApiUrl(baseUrl?: string): boolean;
+/**
+ * Amazon Bedrock's Anthropic Messages API: the `/anthropic` path on the
+ * bedrock-runtime or bedrock-mantle endpoint. It rejects the tool `strict`
+ * field and enforces Anthropic signatures on replay.
+ */
+export declare function isBedrockAnthropicRoute(baseUrl?: string): boolean;
 /**
  * Azure AI Inference / Foundry Anthropic route
  * (`<resource>.inference.ai.azure.com`, `<resource>.services.ai.azure.com`).

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" | "apple" | "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" | "local" | "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" | "singularityapi-dev" | "singularityapi-tech" | "stencil" | "stepfun" | "synthetic" | "tavily" | "together" | "typesafe" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "web" | "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" | "apple" | "azure" | "baseten" | "bedrock-mantle" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "exa" | "factory-droid" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google" | "google-antigravity" | "google-gemini-cli" | "google-vertex" | "groq" | "helmcode" | "huggingface" | "kagi" | "kilo" | "kimi-code" | "litellm" | "llama.cpp" | "lm-studio" | "local" | "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" | "singularityapi-dev" | "singularityapi-tech" | "stencil" | "stepfun" | "synthetic" | "tavily" | "together" | "typesafe" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "web" | "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" | "singularityapi-dev" | "singularityapi-tech" | "stencil" | "stepfun" | "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";
+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" | "factory-droid" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google-antigravity" | "google-gemini-cli" | "helmcode" | "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" | "singularityapi-dev" | "singularityapi-tech" | "stencil" | "stepfun" | "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/axes.d.ts

@@ -16,7 +16,7 @@ export type AxisShape = "scalar" | "array" | "object";
 /** Axis namespace: request-wire compat, thinking control surface, or catalog metadata. */
 export type AxisSet = "wire" | "thinking" | "catalog";
 /** Resolved compat record families a wire axis may be assigned onto. */
-export type CompatRecordName = "openai" | "openai-responses" | "anthropic" | "bedrock" | "devin" | "google";
+export type CompatRecordName = "openai" | "openai-responses" | "anthropic" | "bedrock" | "devin" | "google" | "request";
 /** One axis definition: resolved key, namespace, shape, and applicability. */
 export interface AxisDef {
     /** Resolved camelCase field the directive assigns. */
@@ -33,6 +33,8 @@ export interface AxisDef {
      * that compile to camelCase resolved keys.
      */
     verbatimKeys?: true;
+    /** Array axes only: a bare directive assigns an empty list (an explicit "none"). */
+    emptyArray?: true;
 }
 /** Effort tiers accepted by taxonomy collapse/override vocabulary (`Effort` ∪ `"off"`). */
 export declare const EFFORT_TIERS: readonly string[];

package/dist/types/compat/factory-droid.d.ts

@@ -0,0 +1,65 @@
+import type { Api, ModelSpec } from "../types.js";
+import { type FactoryDroidRegion, type FactoryDroidWire } from "../wire/factory-droid.js";
+/** Native token limits for one inference region. */
+export interface FactoryDroidLimits {
+    contextWindow: number | null;
+    maxTokens: number | null;
+}
+/** Standard Credits rates: `input` is the per-token weight; `output` and `cacheRead` multiply it. */
+export interface FactoryDroidCreditRates {
+    input: number;
+    output?: number;
+    cacheRead?: number;
+}
+/** Account gates on one registry model (the `entitlement` axis). */
+export interface FactoryDroidEntitlement {
+    /** Feature flag that must be on for the account to see the model. */
+    featureFlag?: string;
+    /** Hard deprecation flag; when on, first-party clients hide the model. */
+    deprecationFlag?: string;
+    /** Hidden unless an org policy is known and does not require consent. */
+    requiresExplicitOptIn: boolean;
+    /** Base model this entry is the fast tier of; org policy can withdraw fast tiers as a class. */
+    baseVariant?: string;
+}
+/** Registry facts for one Factory model. */
+export interface FactoryDroidModelPolicy {
+    wire: FactoryDroidWire;
+    /** Registry upstream order; the first entry is the default `x-api-provider`. */
+    rotation: readonly string[];
+    /** Upstreams eligible per inference region; empty means the region does not serve the model. */
+    regionUpstreams: Readonly<Record<FactoryDroidRegion, readonly string[]>>;
+    /** Registry limits; EU entries override them where the region narrows the model. */
+    limits: FactoryDroidLimits;
+    euLimits: Partial<FactoryDroidLimits>;
+    creditRates?: FactoryDroidCreditRates;
+    /** Bundled catalog row whose list price the model shows. */
+    listPriceFrom?: {
+        provider: string;
+        modelId: string;
+    };
+    /** Provider family whose live routing defaults apply. */
+    routingFamily?: string;
+    /** Other ids organization policy may use for the model. */
+    policyAliases: readonly string[];
+    entitlement: FactoryDroidEntitlement;
+    /** Native default with no caller effort is thinking off. */
+    defaultReasoningOff: boolean;
+}
+/** One registry model: its roster row and resolved policy. */
+export interface FactoryDroidRegistryModel {
+    spec: ModelSpec<"factory-droid-agent">;
+    policy: FactoryDroidModelPolicy;
+}
+/** The registry roster in declaration order, each row with its resolved policy. */
+export declare const factoryDroidRegistry: () => readonly FactoryDroidRegistryModel[];
+/** Registry policy for a model (by its request id); undefined for ids outside the registry. */
+export declare function resolveFactoryDroidPolicy(model: Pick<ModelSpec<Api>, "id" | "requestModelId">): FactoryDroidModelPolicy | undefined;
+/**
+ * Effective upstream rotation for an inference region: the registry order,
+ * narrowed to the upstreams that region serves (or the model's own region
+ * override). An empty result means the region cannot serve the model.
+ */
+export declare function resolveFactoryDroidRotation(policy: FactoryDroidModelPolicy, region: string | undefined): readonly string[];
+/** Native limits for an inference region; EU overrides fall back to the registry defaults. */
+export declare function factoryDroidRegionalLimits(policy: FactoryDroidModelPolicy, region: string | undefined): FactoryDroidLimits;

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

@@ -1,2 +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" | "apple" | "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" | "local" | "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" | "singularityapi-dev" | "singularityapi-tech" | "stepfun" | "synthetic" | "together" | "typesafe" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "web" | "xai" | "xai-oauth" | "xiaomi" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-sgp" | "yolo-auto" | "zai" | "zenmux" | "zhipu-coding-plan";
+export type KnownProvider = "abliteration" | "aiand" | "aimlapi" | "alibaba-coding-plan" | "alibaba-token-plan" | "amazon-bedrock" | "anthropic" | "apple" | "azure" | "baseten" | "bedrock-mantle" | "cerebras" | "charm-hyper" | "cline-pass" | "cloudflare-ai-gateway" | "commandcode" | "coreweave" | "cursor" | "deepinfra" | "deepseek" | "devin" | "factory-droid" | "firepass" | "fireworks" | "github-copilot" | "gitlab-duo" | "gitlab-duo-agent" | "gmi-cloud" | "google" | "google-antigravity" | "google-gemini-cli" | "google-vertex" | "groq" | "helmcode" | "huggingface" | "kilo" | "kimi-code" | "litellm" | "lm-studio" | "local" | "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" | "singularityapi-dev" | "singularityapi-tech" | "stepfun" | "synthetic" | "together" | "typesafe" | "umans" | "venice" | "vercel-ai-gateway" | "vllm" | "wafer-serverless" | "web" | "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/resolve.d.ts

@@ -1,5 +1,5 @@
 import type { Api, CompatOf, ModelSpec, ThinkingConfig } from "../types.js";
-import type { ModelIdentity } from "./types.js";
+import type { ModelIdentity, RequestPolicy } from "./types.js";
 /** Result of resolving one model spec through the compat engine. */
 export interface ResolvedModelPolicy<TApi extends Api = Api> {
     identity: ModelIdentity;
@@ -7,6 +7,12 @@ export interface ResolvedModelPolicy<TApi extends Api = Api> {
     thinking: ThinkingConfig | undefined;
     /** Catalog-data axis assignments (longContext, priority, …) for generation. */
     catalog: Record<string, unknown>;
+    /** Request-shaping directives for the selected upstream. */
+    request: RequestPolicy;
+}
+/** Request routing context is separate from model identity and deployment. */
+export interface ResolveRoute {
+    upstream?: string;
 }
 /** Resolve the request adapter assigned to a discovery backend before materialization. */
 export declare function resolveDiscoveryApi(spec: ModelSpec<Api>, providerType: string): Api;
@@ -20,13 +26,13 @@ export declare function resolveCatalogAxes(spec: ModelSpec<Api>): Record<string,
  * Resolves the full policy surface for one model spec: structured identity,
  * complete compat record, thinking metadata, and catalog-data corrections.
  */
-export declare function resolveModelPolicy<TApi extends Api>(spec: ModelSpec<TApi>): ResolvedModelPolicy<TApi>;
+export declare function resolveModelPolicy<TApi extends Api>(spec: ModelSpec<TApi>, route?: ResolveRoute): 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
+ * Discovery uses this to tell "zeta knows this model's tiers" apart from "zeta
  * is guessing them", so catalog-published tiers can correct the guess without
  * ever overriding reviewed knowledge.
  */

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

@@ -190,6 +190,8 @@ export interface CompiledRule {
     providers?: string[];
     /** Request adapter identifiers matched by an `on-api` selector. */
     apis?: string[];
+    /** Selected upstream behind a deployment, matched by `on-upstream`. */
+    upstreams?: string[];
     family?: string;
     revision?: CompiledRevisionTerm[];
     models?: CompiledSelector[];
@@ -563,8 +565,9 @@ export interface CompiledAuth {
  * - `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.
+ * - `never`: runtime-only; the provider's model manager is the sole consumer.
  */
-export type SeedBundlePolicy = "always" | "fallback" | "empty";
+export type SeedBundlePolicy = "always" | "fallback" | "empty" | "never";
 /** Catalog-generation discovery settings (`discovery` node in `providers/<id>.kdl`). */
 export interface CompiledProviderDiscovery {
     /** Human-readable name for generator log messages. */
@@ -668,6 +671,8 @@ export interface ResolveTarget {
     provider: string;
     /** Request adapter used to serialize the model. */
     api: string;
+    /** Actual upstream chosen for this request, not the deployment provider. */
+    upstream?: string;
     /** Centrally classified vendor lineage. */
     class: string;
     /** Classified product family within the class, when known. */
@@ -693,4 +698,24 @@ export interface ResolvedAxes {
      */
     reasoning: boolean;
 }
+/** Selected-route request dialect. Absent fields impose no deployment override. */
+export interface RequestPolicy {
+    completionsReasoningMode?: "none" | "effort" | "opt-in" | "forced-on";
+    completionsReasoningHistory?: "omit" | "preserved" | "interleaved";
+    anthropicThinking?: "adaptive" | "adaptive-summarized" | "budget-interleaved" | "budget-effort";
+    /** Advertise `fine-grained-tool-streaming-2025-05-14` on requests that carry tools. */
+    anthropicToolStreamingBeta?: boolean;
+    /** `OpenAI-Platform` header value the route sends on OpenAI-family wires. */
+    openaiPlatformHeader?: string;
+    responsesCacheRetention?: boolean;
+    responsesVerbosity?: "low";
+    responsesServiceTier?: "priority";
+    responsesParallelToolCalls?: boolean;
+    responsesSafetyIdentifier?: boolean;
+    /** Default `tool_choice` to `auto` when the request carries tools and the caller picks none. */
+    responsesToolChoiceAuto?: boolean;
+    googleThinking?: "level" | "level-medium";
+    /** The route locks its upstream for the session (`x-provider-routing-source: session_lock`). */
+    routingSessionLock?: boolean;
+}
 export {};

package/dist/types/discovery/cursor-proto.d.ts

@@ -1,5 +1,5 @@
 /**
- * Cursor agent protocol declarations used by omp.
+ * Cursor agent protocol declarations used by zeta.
  *
  * Each declaration retains only fields consumed by the client or its protocol tests.
  */
@@ -17,12 +17,79 @@ export declare enum ConversationSearchSource {
     LOCAL = 1,
     CLOUD_CACHE = 2
 }
+/** Cursor agent enum CursorError. */
+export declare enum CursorError {
+    ERROR_UNSPECIFIED = 0,
+    ERROR_BAD_API_KEY = 1,
+    ERROR_NOT_LOGGED_IN = 2,
+    ERROR_INVALID_AUTH_ID = 3,
+    ERROR_NOT_HIGH_ENOUGH_PERMISSIONS = 4,
+    ERROR_BAD_MODEL_NAME = 5,
+    ERROR_USER_NOT_FOUND = 6,
+    ERROR_FREE_USER_RATE_LIMIT_EXCEEDED = 7,
+    ERROR_PRO_USER_RATE_LIMIT_EXCEEDED = 8,
+    ERROR_FREE_USER_USAGE_LIMIT = 9,
+    ERROR_PRO_USER_USAGE_LIMIT = 10,
+    ERROR_AUTH_TOKEN_NOT_FOUND = 11,
+    ERROR_AUTH_TOKEN_EXPIRED = 12,
+    ERROR_OPENAI = 13,
+    ERROR_OPENAI_RATE_LIMIT_EXCEEDED = 14,
+    ERROR_AGENT_REQUIRES_LOGIN = 18,
+    ERROR_MAX_TOKENS = 20,
+    ERROR_USER_ABORTED_REQUEST = 21,
+    ERROR_GENERIC_RATE_LIMIT_EXCEEDED = 22,
+    ERROR_PRO_USER_ONLY = 23,
+    ERROR_TIMEOUT = 25,
+    ERROR_GPT_4_VISION_PREVIEW_RATE_LIMIT = 28,
+    ERROR_CUSTOM_MESSAGE = 29,
+    ERROR_OUTDATED_CLIENT = 30,
+    ERROR_CLAUDE_IMAGE_TOO_LARGE = 31,
+    ERROR_FILE_NOT_FOUND = 33,
+    ERROR_API_KEY_RATE_LIMIT = 34,
+    ERROR_DEBOUNCED = 35,
+    ERROR_BAD_REQUEST = 36,
+    ERROR_REPOSITORY_SERVICE_REPOSITORY_IS_NOT_INITIALIZED = 37,
+    ERROR_UNAUTHORIZED = 38,
+    ERROR_NOT_FOUND = 39,
+    ERROR_DEPRECATED = 40,
+    ERROR_RESOURCE_EXHAUSTED = 41,
+    ERROR_BAD_USER_API_KEY = 42,
+    ERROR_CONVERSATION_TOO_LONG = 43,
+    ERROR_USAGE_PRICING_REQUIRED = 44,
+    ERROR_USAGE_PRICING_REQUIRED_CHANGEABLE = 45,
+    ERROR_GITHUB_NO_USER_CREDENTIALS = 46,
+    ERROR_GITHUB_USER_NO_ACCESS = 47,
+    ERROR_GITHUB_APP_NO_ACCESS = 48,
+    ERROR_GITHUB_MULTIPLE_OWNERS = 49,
+    ERROR_RATE_LIMITED = 50,
+    ERROR_RATE_LIMITED_CHANGEABLE = 51,
+    ERROR_CUSTOM = 52,
+    ERROR_HOOKS_BLOCKED = 53,
+    ERROR_SUSPICIOUS_USAGE_BLOCKED = 54,
+    ERROR_EXTENSION_HOST_TIMEOUT = 55,
+    ERROR_NETWORK_ERROR = 56,
+    ERROR_PROVIDER_ERROR = 57,
+    ERROR_MODEL_BLOCKED = 58,
+    ERROR_INTERNAL = 59,
+    ERROR_MAX_MODE_REQUIRED = 60,
+    ERROR_MODEL_NO_LONGER_SUPPORTED = 61,
+    ERROR_PRICING_WARNING = 62,
+    ERROR_SLOW_POOL = 63,
+    ERROR_UNSUPPORTED_REGION = 64,
+    ERROR_ACCOUNT_CLOSED = 65
+}
 /** Cursor agent enum CursorRuleSource. */
 export declare enum CursorRuleSource {
     UNSPECIFIED = 0,
     TEAM = 1,
     USER = 2
 }
+/** Cursor agent enum DegradationStatus. */
+export declare enum DegradationStatus {
+    UNSPECIFIED = 0,
+    DEGRADED = 1,
+    DISABLED = 2
+}
 /** Cursor agent enum DiagnosticSeverity. */
 export declare enum DiagnosticSeverity {
     UNSPECIFIED = 0,
@@ -57,6 +124,19 @@ export declare enum GitDiff_DiffType {
     DIFF_TO_HEAD = 1,
     DIFF_FROM_BRANCH_TO_MAIN = 2
 }
+/** Cursor agent enum ModelVendorId. */
+export declare enum ModelVendorId {
+    UNSPECIFIED = 0,
+    ANTHROPIC = 1,
+    OPENAI = 2,
+    GOOGLE = 3,
+    XAI = 4,
+    MOONSHOT = 5,
+    CURSOR = 6,
+    NVIDIA = 7,
+    ZAI = 8,
+    META = 9
+}
 /** Cursor agent enum ShellBackgroundReason. */
 export declare enum ShellBackgroundReason {
     UNSPECIFIED = 0,
@@ -378,6 +458,121 @@ export interface AsyncAskQuestionCompletionAction extends ProtoMessage {
     result?: AskQuestionResult;
 }
 export declare const AsyncAskQuestionCompletionActionSchema: MessageCodec<AsyncAskQuestionCompletionAction>;
+/** Cursor agent message aiserver.v1.AvailableModelsRequest. */
+export interface AvailableModelsRequest extends ProtoMessage {
+    isNightly: boolean;
+    includeLongContextModels: boolean;
+    excludeMaxNamedModels: boolean;
+    additionalModelNames: string[];
+    useModelParameters?: boolean;
+    includeHiddenModels?: boolean;
+    doNotUseMarkdown?: boolean;
+    variantsWillBeShownInExplodedList?: boolean;
+    forAutomations?: boolean;
+    scope?: number;
+    useReactModelPicker?: boolean;
+    useCloudAgentEffortModes?: boolean;
+    adminSettingsGroupPublicId?: string;
+    byokEnabled?: boolean;
+}
+export declare const AvailableModelsRequestSchema: MessageCodec<AvailableModelsRequest>;
+/** Cursor agent message aiserver.v1.AvailableModelsResponse. */
+export interface AvailableModelsResponse extends ProtoMessage {
+    modelNames: string[];
+    models: AvailableModelsResponse_ModelDetails[];
+    useModelParameters: boolean;
+}
+export declare const AvailableModelsResponseSchema: MessageCodec<AvailableModelsResponse>;
+/** Cursor agent message aiserver.v1.AvailableModelsResponse_ConfirmationDialogue. */
+export interface AvailableModelsResponse_ConfirmationDialogue extends ProtoMessage {
+    title: string;
+    body: string;
+    key: string;
+    blocksSubmission: boolean;
+}
+export declare const AvailableModelsResponse_ConfirmationDialogueSchema: MessageCodec<AvailableModelsResponse_ConfirmationDialogue>;
+/** Cursor agent message aiserver.v1.AvailableModelsResponse_ModelDetails. */
+export interface AvailableModelsResponse_ModelDetails extends ProtoMessage {
+    name: string;
+    defaultOn: boolean;
+    isLongContextOnly?: boolean;
+    isChatOnly?: boolean;
+    supportsAgent?: boolean;
+    degradationStatus?: DegradationStatus;
+    price?: number;
+    tooltipData?: AvailableModelsResponse_TooltipData;
+    supportsThinking?: boolean;
+    supportsImages?: boolean;
+    supportsAutoContext?: boolean;
+    autoContextMaxTokens?: number;
+    autoContextExtendedMaxTokens?: number;
+    supportsMaxMode?: boolean;
+    contextTokenLimit?: number;
+    contextTokenLimitForMaxMode?: number;
+    clientDisplayName?: string;
+    serverModelName?: string;
+    supportsNonMaxMode?: boolean;
+    tooltipDataForMaxMode?: AvailableModelsResponse_TooltipData;
+    isRecommendedForBackgroundComposer?: boolean;
+    supportsPlanMode?: boolean;
+    isUserAdded?: boolean;
+    inputboxShortModelName?: string;
+    supportsSandboxing?: boolean;
+    supportsCmdK?: boolean;
+    onlySupportsCmdK?: boolean;
+    backgroundComposerSortOrder?: number;
+    parameterDefinitions: ModelParameterDefinition[];
+    variants: AvailableModelsResponse_ModelVariantConfig[];
+    cloudAgentEffortMode?: number;
+    cloudMigrateToModel?: string;
+    upgradeModelId?: string;
+    isHidden?: boolean;
+    legacySlugs: string[];
+    idAliases: string[];
+    namedModelSectionIndex?: number;
+    tagline?: string;
+    visibleInRoutedModelView?: boolean;
+    vendorName?: string;
+    vendor?: AvailableModelsResponse_ModelVendor;
+    defaultDisabledInAdminAllowlist?: boolean;
+    cloudAgentEffortModes: number[];
+    supportsSmartModeClassifier?: boolean;
+    requiresDataRetention?: boolean;
+    reasonForZdrConsentBlock?: string;
+}
+export declare const AvailableModelsResponse_ModelDetailsSchema: MessageCodec<AvailableModelsResponse_ModelDetails>;
+/** Cursor agent message aiserver.v1.AvailableModelsResponse_ModelVariantConfig. */
+export interface AvailableModelsResponse_ModelVariantConfig extends ProtoMessage {
+    parameterValues: ModelParameterValue[];
+    displayName?: string;
+    isMaxMode?: boolean;
+    isDefaultMaxConfig?: boolean;
+    isDefaultNonMaxConfig?: boolean;
+    tooltipData?: AvailableModelsResponse_TooltipData;
+    tagline?: string;
+    displayNameOutsidePicker?: string;
+    variantStringRepresentation?: string;
+    confirmationDialogue?: AvailableModelsResponse_ConfirmationDialogue;
+    legacySlug?: string;
+}
+export declare const AvailableModelsResponse_ModelVariantConfigSchema: MessageCodec<AvailableModelsResponse_ModelVariantConfig>;
+/** Cursor agent message aiserver.v1.AvailableModelsResponse_ModelVendor. */
+export interface AvailableModelsResponse_ModelVendor extends ProtoMessage {
+    id: ModelVendorId;
+    displayName: string;
+}
+export declare const AvailableModelsResponse_ModelVendorSchema: MessageCodec<AvailableModelsResponse_ModelVendor>;
+/** Cursor agent message aiserver.v1.AvailableModelsResponse_TooltipData. */
+export interface AvailableModelsResponse_TooltipData extends ProtoMessage {
+    primaryText: string;
+    secondaryText: string;
+    secondaryWarningText: string;
+    icon: string;
+    tertiaryText: string;
+    tertiaryTextUrl?: string;
+    markdownContent?: string;
+}
+export declare const AvailableModelsResponse_TooltipDataSchema: MessageCodec<AvailableModelsResponse_TooltipData>;
 /** Cursor agent message agent.v1.AzureCredentials. */
 export interface AzureCredentials extends ProtoMessage {
     apiKey: string;
@@ -456,6 +651,19 @@ export interface BeforeSubmitPromptRequestResponse extends ProtoMessage {
     additionalContext?: string;
 }
 export declare const BeforeSubmitPromptRequestResponseSchema: MessageCodec<BeforeSubmitPromptRequestResponse>;
+/** Cursor agent message aiserver.v1.BidiAppendRequest. */
+export interface BidiAppendRequest extends ProtoMessage {
+    data: string;
+    requestId?: BidiRequestId;
+    appendSeqno: bigint;
+    dataBinary: Uint8Array;
+}
+export declare const BidiAppendRequestSchema: MessageCodec<BidiAppendRequest>;
+/** Cursor agent message agent.v1.BidiRequestId. */
+export interface BidiRequestId extends ProtoMessage {
+    requestId: string;
+}
+export declare const BidiRequestIdSchema: MessageCodec<BidiRequestId>;
 /** Cursor agent message agent.v1.CallFrame. */
 export interface CallFrame extends ProtoMessage {
     functionName?: string;
@@ -923,6 +1131,16 @@ export declare const CursorRuleTypeGlobalSchema: MessageCodec<CursorRuleTypeGlob
 export interface CursorRuleTypeManuallyAttached extends ProtoMessage {
 }
 export declare const CursorRuleTypeManuallyAttachedSchema: MessageCodec<CursorRuleTypeManuallyAttached>;
+/** Cursor agent message aiserver.v1.CustomErrorDetails. */
+export interface CustomErrorDetails extends ProtoMessage {
+    title: string;
+    detail: string;
+    allowCommandLinksPotentiallyUnsafePleaseOnlyUseForHandwrittenTrustedMarkdown?: boolean;
+    isRetryable?: boolean;
+    showRequestId?: boolean;
+    shouldShowImmediateError?: boolean;
+}
+export declare const CustomErrorDetailsSchema: MessageCodec<CustomErrorDetails>;
 /** Cursor agent message agent.v1.CustomSubagent. */
 export interface CustomSubagent extends ProtoMessage {
     fullPath: string;
@@ -1203,6 +1421,13 @@ export interface Error extends ProtoMessage {
     message: string;
 }
 export declare const ErrorSchema: MessageCodec<Error>;
+/** Cursor agent message aiserver.v1.ErrorDetails. */
+export interface ErrorDetails extends ProtoMessage {
+    error: CursorError;
+    details?: CustomErrorDetails;
+    isExpected?: boolean;
+}
+export declare const ErrorDetailsSchema: MessageCodec<ErrorDetails>;
 /** Cursor agent message agent.v1.ExaFetchArgs. */
 export interface ExaFetchArgs extends ProtoMessage {
     ids: string[];
@@ -1932,6 +2157,15 @@ export interface GetBlobResult extends ProtoMessage {
     blobData?: Uint8Array;
 }
 export declare const GetBlobResultSchema: MessageCodec<GetBlobResult>;
+/** Cursor agent message agent.v1.GetDefaultModelForCliRequest. */
+export interface GetDefaultModelForCliRequest extends ProtoMessage {
+}
+export declare const GetDefaultModelForCliRequestSchema: MessageCodec<GetDefaultModelForCliRequest>;
+/** Cursor agent message agent.v1.GetDefaultModelForCliResponse. */
+export interface GetDefaultModelForCliResponse extends ProtoMessage {
+    model?: ModelDetails;
+}
+export declare const GetDefaultModelForCliResponseSchema: MessageCodec<GetDefaultModelForCliResponse>;
 /** Cursor agent message agent.v1.GetDiffRequest. */
 export interface GetDiffRequest extends ProtoMessage {
     cwd: string;
@@ -2789,6 +3023,56 @@ export interface ModelDetails extends ProtoMessage {
     };
 }
 export declare const ModelDetailsSchema: MessageCodec<ModelDetails>;
+/** Cursor agent message aiserver.v1.ModelParameterDefinition. */
+export interface ModelParameterDefinition extends ProtoMessage {
+    id: string;
+    name: string;
+    markdownTooltip?: string;
+    parameterType?: ModelParameterDefinition_ModelParameterType;
+    isCycleableByHotkey?: boolean;
+}
+export declare const ModelParameterDefinitionSchema: MessageCodec<ModelParameterDefinition>;
+/** Cursor agent message aiserver.v1.ModelParameterDefinition_BooleanParameterDefinition. */
+export interface ModelParameterDefinition_BooleanParameterDefinition extends ProtoMessage {
+    values: ModelParameterDefinition_BooleanParameterDefinition_BooleanParameterValue[];
+}
+export declare const ModelParameterDefinition_BooleanParameterDefinitionSchema: MessageCodec<ModelParameterDefinition_BooleanParameterDefinition>;
+/** Cursor agent message aiserver.v1.ModelParameterDefinition_BooleanParameterDefinition_BooleanParameterValue. */
+export interface ModelParameterDefinition_BooleanParameterDefinition_BooleanParameterValue extends ProtoMessage {
+    value: string;
+    displayName?: string;
+    increasesModelCost?: boolean;
+    defaultBlockedInAdminAllowlist?: boolean;
+    hideFromUserPickerWhenAdminBlocked?: boolean;
+    blockedByAdminAllowlist?: boolean;
+}
+export declare const ModelParameterDefinition_BooleanParameterDefinition_BooleanParameterValueSchema: MessageCodec<ModelParameterDefinition_BooleanParameterDefinition_BooleanParameterValue>;
+/** Cursor agent message aiserver.v1.ModelParameterDefinition_EnumParameterDefinition. */
+export interface ModelParameterDefinition_EnumParameterDefinition extends ProtoMessage {
+    values: ModelParameterDefinition_EnumParameterDefinition_EnumParameterValue[];
+}
+export declare const ModelParameterDefinition_EnumParameterDefinitionSchema: MessageCodec<ModelParameterDefinition_EnumParameterDefinition>;
+/** Cursor agent message aiserver.v1.ModelParameterDefinition_EnumParameterDefinition_EnumParameterValue. */
+export interface ModelParameterDefinition_EnumParameterDefinition_EnumParameterValue extends ProtoMessage {
+    value: string;
+    displayName?: string;
+    increasesModelCost?: boolean;
+    blockedByAdminAllowlist?: boolean;
+    markdownTooltip?: string;
+}
+export declare const ModelParameterDefinition_EnumParameterDefinition_EnumParameterValueSchema: MessageCodec<ModelParameterDefinition_EnumParameterDefinition_EnumParameterValue>;
+/** Cursor agent message aiserver.v1.ModelParameterDefinition_ModelParameterType. */
+export interface ModelParameterDefinition_ModelParameterType extends ProtoMessage {
+    booleanParameter?: ModelParameterDefinition_BooleanParameterDefinition;
+    enumParameter?: ModelParameterDefinition_EnumParameterDefinition;
+}
+export declare const ModelParameterDefinition_ModelParameterTypeSchema: MessageCodec<ModelParameterDefinition_ModelParameterType>;
+/** Cursor agent message aiserver.v1.ModelParameterValue. */
+export interface ModelParameterValue extends ProtoMessage {
+    id: string;
+    value: string;
+}
+export declare const ModelParameterValueSchema: MessageCodec<ModelParameterValue>;
 /** Cursor agent message agent.v1.MouseDownAction. */
 export interface MouseDownAction extends ProtoMessage {
     button: number;

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

@@ -1,7 +1,5 @@
 import type { ModelSpec } from "../types.js";
-/**
- * Options for fetching dynamic Cursor models from `GetUsableModels`.
- */
+/** Options for authenticated Cursor model discovery. */
 export interface CursorModelDiscoveryOptions {
     /** Cursor access token used for bearer authentication. */
     apiKey: string;
@@ -15,10 +13,18 @@ export interface CursorModelDiscoveryOptions {
     customModelIds?: string[];
 }
 /**
- * Fetches Cursor models through `GetUsableModels` and normalizes them into canonical model entries.
+ * Joins Cursor's account-scoped model RPCs:
+ * - `AvailableModels` supplies rich base models, parameter axes, variants,
+ *   capabilities, aliases, and cost-multiplier metadata.
+ * - `GetUsableModels` supplies the exact legacy wire slugs the account can run.
+ * - `GetDefaultModelForCli` identifies the account's current default.
+ *
+ * Per-token rates come from the reviewed `providers/cursor.kdl` rate card and
+ * the bundled rows; discovery only scales them by a variant's declared multiplier.
  *
- * Returns `null` on request/decode failures.
- * Returns `[]` only when the endpoint responds successfully with no usable models.
+ * Returns `null` unless at least one model-list RPC (`GetUsableModels` or
+ * `AvailableModels`) decoded. A successful empty catalog returns `[]`,
+ * preserving model-manager retry and fallback semantics.
  */
 export declare function fetchCursorUsableModels(options: CursorModelDiscoveryOptions): Promise<ModelSpec<"cursor-agent">[] | null>;
 /**