@linxiraos/pi-catalog 1.1.25 → 1.1.27

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## [Unreleased]
 
+## [1.1.27] - 2026-10-07
+
+- 版本线推进至 1.1.27；本版无独立用户可见变化。
+
+### Added
+
+- Added an optional `statefulResponses` compat field for OpenAI Responses models, kept through OpenRouter's Responses dispatch ([#13686](https://github.com/can1357/oh-my-pi/pull/13686) by [@alphastorm](https://github.com/alphastorm)).
+- Added 15 Snowflake Cortex models with account-specific endpoints, Cortex compatibility rules, and estimated account-billed pricing ([#14507](https://github.com/can1357/oh-my-pi/pull/14507) by [@jorgoose](https://github.com/jorgoose)).
+- Added the `image-tokenization` axis, which declares how GPT-5.2+, Claude and Gemini 3 lines bill input images on every host, with wire-API fallback rules for other models, plus `imageTokens()` to price one image ([#14286](https://github.com/can1357/oh-my-pi/pull/14286) by [@will-bogusz](https://github.com/will-bogusz)).
+
+### Changed
+
+- Changed OpenAI Responses endpoints other than OpenAI, Azure OpenAI, and Codex (custom and local servers, proxies including `azure`/`openai-codex` providers pointed at a non-Azure/non-Codex `baseUrl`, OpenRouter) to default `supportsImageDetailOriginal` to `false`, so snapcompact frames and computer screenshots go out as `detail: "auto"` instead of failing on servers that reject `original`; set `compat.supportsImageDetailOriginal: true` to opt a host in ([#13687](https://github.com/can1357/oh-my-pi/pull/13687) by [@alphastorm](https://github.com/alphastorm)).
+- Muse Code can now store Responses results on Meta's side (`store-responses`), so a turn whose connection drops can be recovered instead of re-run. Storage is opt-in via the omp setting `providers.muse-code.storeResponses` or `PI_MUSE_STORE_RESPONSES=1` ([#14293](https://github.com/can1357/oh-my-pi/pull/14293) and [#14534](https://github.com/can1357/oh-my-pi/pull/14534) by [@abilliontokens](https://github.com/abilliontokens)).
+
 ## [1.1.25] - 2026-10-03
 
 - 版本线推进至 1.1.25；本版无独立用户可见变化。

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" | "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";
+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" | "snowflake" | "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" | "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";
+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" | "snowflake" | "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/collapse.d.ts

@@ -102,6 +102,13 @@ export interface VariantCollapseTable {
  * Discovery uses this accessor to preserve injectable table seams.
  */
 export declare function reviewedCollapseTable(provider: string): VariantCollapseTable | undefined;
+/**
+ * Logical id of the reviewed `provider` family claiming `memberId` as a member
+ * or extra alias, or `undefined` when no reviewed family owns it. Cursor's rich
+ * discovery names lanes with it so they keep the id the legacy-slug collapse
+ * (and the bundled catalog) assigns.
+ */
+export declare function reviewedVariantFamilyId(provider: string, memberId: string): string | undefined;
 /**
  * The global automatic rule: derive an `X` + `X-thinking` family for every
  * pair where both ids are live in `specs` (trailing or infix token). Gates:

package/dist/types/compat/image-tokenization.d.ts

@@ -0,0 +1,52 @@
+import type { ModelIdentity } from "./types.js";
+/** OpenAI image `detail` levels; `undefined` means the provider default (`auto`). */
+export type ImageDetail = "auto" | "low" | "high" | "original";
+export interface ImageSize {
+    width: number;
+    height: number;
+}
+/** One OpenAI `detail` level's sizing: a pixel-dimension limit, then an optional patch budget. */
+export interface PatchSizing {
+    /** Longest side after the pixel-dimension fit. */
+    maxEdge: number;
+    /** Resizing patch budget; absent when the level keeps the image's size. */
+    patchBudget?: number;
+}
+/** OpenAI 32px patches × a per-model multiplier, sized per `detail` level. */
+export interface OpenAiPatchTokenization {
+    regime: "openai-patch";
+    multiplier: number;
+    low: PatchSizing;
+    high: PatchSizing;
+    original: PatchSizing;
+    /** The level `auto` (and an omitted `detail`) sizes like. */
+    auto: "high" | "original";
+}
+/** One model line's image billing rule: the vendor formula and its per-model numbers. */
+export type ImageTokenization = OpenAiPatchTokenization
+/** Anthropic 28px patches, resized to fit a padded-edge limit and a visual-token budget. */
+ | {
+    regime: "anthropic-patch";
+    maxEdge: number;
+    maxTokens: number;
+}
+/** A fixed per-image budget regardless of pixels (Gemini 3 `media_resolution`). */
+ | {
+    regime: "fixed";
+    tokens: number;
+};
+/** What reads the image: a built model, any `{ id }` with optional host and identity, or just a wire `{ api }`. */
+export interface ImageTokenizationTarget {
+    id?: string;
+    provider?: string;
+    api?: string;
+    identity?: Pick<ModelIdentity, "class" | "family" | "revision">;
+}
+/**
+ * The reader's image billing rule: its lineage rule, else its wire API's
+ * fallback; undefined when neither covers it (an unclassified model on an
+ * unregistered API).
+ */
+export declare function resolveImageTokenization(target: ImageTokenizationTarget): ImageTokenization | undefined;
+/** Billed input tokens for one image of `size` under `rule`; only `openai-patch` reads `detail`. */
+export declare function imageTokens(rule: ImageTokenization, size: ImageSize, detail?: ImageDetail): number;

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" | "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";
+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" | "snowflake" | "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/hosts.d.ts

@@ -15,6 +15,10 @@ export declare const KNOWN_HOSTS: {
         readonly providers: readonly ["openai"];
         readonly urlMarkers: readonly ["api.openai.com"];
     };
+    /** URL-only: a Codex provider rerouted through a proxy does not imply the subscription backend's capabilities. */
+    readonly openaiCodex: {
+        readonly urlMarkers: readonly ["chatgpt.com/backend-api", "chat.openai.com/backend-api"];
+    };
     readonly azureOpenAI: {
         readonly providers: readonly ["azure"];
         readonly urlMarkers: readonly [".openai.azure.com", "azure.com/openai", "models.inference.ai.azure.com"];

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

@@ -35,6 +35,12 @@ export interface CacheEntry<TApi extends Api = Api> {
      */
     staticFingerprint: string;
 }
+/**
+ * Closes the shared handle to the default `<agent-dir>/models.db`; the next
+ * default-path access reopens it. Call before deleting an agent directory the
+ * cache was opened under — Windows cannot remove a database that is still open.
+ */
+export declare function closeModelCache(): void;
 export declare function readModelCache<TApi extends Api>(providerId: string, ttlMs: number, now: () => number, dbPath?: string): CacheEntry<TApi> | null;
 /**
  * Persist a provider snapshot.

package/dist/types/provider-models/special.d.ts

@@ -24,6 +24,12 @@ export interface OpenAICodexModelManagerConfig {
      * keeps the previous/bundled catalog instead.
      */
     resolveAccounts?: () => Promise<readonly OpenAICodexAccount[] | null>;
+    /**
+     * Codex backend base URL (e.g. a Codex-compatible gateway from `models.yml`).
+     * Defaults to the official ChatGPT backend. Also scopes the discovery cache,
+     * so a gateway roster never serves the official endpoint and vice versa.
+     */
+    baseUrl?: string;
     clientVersion?: string;
     fetch?: FetchImpl;
 }

package/dist/types/types.d.ts

@@ -378,6 +378,8 @@ export interface OpenAICompat {
     supportsReasoningParams?: boolean;
     /** Whether Responses requests may include `reasoning.summary`. Default: true except on known incompatible hosts. */
     supportsReasoningSummary?: boolean;
+    /** Whether to chain OpenAI Responses turns using stored response ids. Unset uses the official-endpoint default; env and call options take precedence. */
+    statefulResponses?: boolean;
     /**
      * Whether the endpoint accepts explicit sampling parameters (`temperature`,
      * `top_p`, `top_k`, `min_p`, penalties). OpenAI proprietary reasoning models
@@ -398,7 +400,7 @@ export interface OpenAICompat {
     alwaysSendMaxTokens?: boolean;
     /** Whether Responses-API tool-call/result history must be strictly paired. Default: auto-detected (Azure OpenAI, GitHub Copilot). */
     strictResponsesPairing?: boolean;
-    /** Whether the Responses API accepts the `detail: "original"` image hint. Default: auto-detected (false for GitHub Copilot, which rejects it with a 400). */
+    /** Whether the Responses API accepts the `detail: "original"` image hint. Default: true for OpenAI, Azure OpenAI, and Codex; false for other hosts. Explicit overrides win. */
     supportsImageDetailOriginal?: boolean;
     /**
      * Whether the Responses endpoint accepts `configuration_update` input items
@@ -651,6 +653,12 @@ export interface BedrockCompat {
      * `PI_OPENAI_STREAM_IDLE_TIMEOUT_MS` alias, then the 300s default.
      */
     streamIdleTimeoutMs?: number;
+    /**
+     * Whether the served model accepts explicit sampling parameters
+     * (`temperature`, `topP`, …). Class rules set `false` for model lines that
+     * reject them on every host. Unassigned: accepted.
+     */
+    supportsSamplingParams?: boolean;
     /**
      * Whether the model accepts a forced `toolChoice` (`any` / `tool`). Claude
      * Opus/Sonnet 5.5 reject it outright; the request builder downgrades forced
@@ -666,6 +674,8 @@ export interface ResolvedBedrockCompat {
     supportsLongPromptCacheRetention: boolean;
     promptCacheMinimumTokens: number;
     promptCacheMaximumCheckpoints: number;
+    /** See {@link BedrockCompat.supportsSamplingParams}. */
+    supportsSamplingParams?: boolean;
     supportsForcedToolChoice: boolean;
     /**
      * Stream-watchdog idle-timeout fallback in ms for hosts with no keepalive
@@ -788,7 +798,7 @@ export interface ResolvedOpenAISharedCompat {
  * `buildModel`; request handlers read fields and never detect, resolve, or
  * allocate.
  */
-export type ResolvedOpenAICompat = ResolvedOpenAISharedCompat & Required<Omit<OpenAICompat, "supportsDeveloperRole" | "supportsReasoningEffort" | "reasoningEffortMap" | "supportsReasoningParams" | "supportsReasoningSummary" | "supportsSamplingParams" | "supportsPenaltyAndStopParams" | "thinkingFormat" | "kimiApiFormat" | "reasoningDisableMode" | "omitReasoningEffort" | "includeEncryptedReasoning" | "filterReasoningHistory" | "disableReasoningOnForcedToolChoice" | "disableReasoningOnToolChoice" | "disableReasoningWithTools" | "supportsToolChoice" | "supportsForcedToolChoice" | "supportsNamedToolChoice" | "reasoningContentField" | "mistralReasoningContentParts" | "requiresReasoningContentForToolCalls" | "requiresReasoningContentForAllAssistantTurns" | "allowsSyntheticReasoningContentForToolCalls" | "syntheticReasoningContentFallback" | "replayReasoningContent" | "qwenPreserveThinking" | "qwenTemplateReasoningEffort" | "requiresThinkingAsText" | "requiresMistralToolIds" | "requiresToolResultName" | "requiresAssistantAfterToolResult" | "requiresAssistantContentForToolCalls" | "stripDeepseekSpecialTokens" | "streamMarkupHealingPattern" | "reasoningDeltasMayBeCumulative" | "emptyLengthFinishIsContextError" | "usesOpenAIToolCallIdLimit" | "promptCacheSessionHeader" | "supportsPromptCacheBreakpoints" | "promptCacheBreakpointTtl" | "openRouterRouting" | "isOpenRouterHost" | "supportsStrictMode" | "supportsLongPromptCacheRetention" | "alwaysSendMaxTokens" | "clampOutputToModelMax" | "wireModelIdMode" | "vercelGatewayRouting" | "extraBody" | "toolStrictMode" | "toolSchemaFlavor" | "streamFirstEventTimeoutMs" | "streamIdleTimeoutMs" | "streamRevision" | "cacheControlFormat" | "thinkingKeep" | "strictResponsesPairing" | "supportsImageDetailOriginal" | "supportsConfigurationUpdate" | "supportsSteering" | "stripImageInput" | "thinkingLoopGuard" | "whenThinking">> & {
+export type ResolvedOpenAICompat = ResolvedOpenAISharedCompat & Required<Omit<OpenAICompat, "supportsDeveloperRole" | "supportsReasoningEffort" | "reasoningEffortMap" | "supportsReasoningParams" | "supportsReasoningSummary" | "statefulResponses" | "supportsSamplingParams" | "supportsPenaltyAndStopParams" | "thinkingFormat" | "kimiApiFormat" | "reasoningDisableMode" | "omitReasoningEffort" | "includeEncryptedReasoning" | "filterReasoningHistory" | "disableReasoningOnForcedToolChoice" | "disableReasoningOnToolChoice" | "disableReasoningWithTools" | "supportsToolChoice" | "supportsForcedToolChoice" | "supportsNamedToolChoice" | "reasoningContentField" | "mistralReasoningContentParts" | "requiresReasoningContentForToolCalls" | "requiresReasoningContentForAllAssistantTurns" | "allowsSyntheticReasoningContentForToolCalls" | "syntheticReasoningContentFallback" | "replayReasoningContent" | "qwenPreserveThinking" | "qwenTemplateReasoningEffort" | "requiresThinkingAsText" | "requiresMistralToolIds" | "requiresToolResultName" | "requiresAssistantAfterToolResult" | "requiresAssistantContentForToolCalls" | "stripDeepseekSpecialTokens" | "streamMarkupHealingPattern" | "reasoningDeltasMayBeCumulative" | "emptyLengthFinishIsContextError" | "usesOpenAIToolCallIdLimit" | "promptCacheSessionHeader" | "supportsPromptCacheBreakpoints" | "promptCacheBreakpointTtl" | "openRouterRouting" | "isOpenRouterHost" | "supportsStrictMode" | "supportsLongPromptCacheRetention" | "alwaysSendMaxTokens" | "clampOutputToModelMax" | "wireModelIdMode" | "vercelGatewayRouting" | "extraBody" | "toolStrictMode" | "toolSchemaFlavor" | "streamFirstEventTimeoutMs" | "streamIdleTimeoutMs" | "streamRevision" | "cacheControlFormat" | "thinkingKeep" | "strictResponsesPairing" | "supportsImageDetailOriginal" | "supportsConfigurationUpdate" | "supportsSteering" | "stripImageInput" | "thinkingLoopGuard" | "whenThinking">> & {
     vercelGatewayRouting?: OpenAICompat["vercelGatewayRouting"];
     extraBody?: OpenAICompat["extraBody"];
     cacheControlFormat?: OpenAICompat["cacheControlFormat"];
@@ -835,6 +845,16 @@ export interface ResolvedOpenAIResponsesCompat extends ResolvedOpenAISharedCompa
      * filling `"auto"`.
      */
     supportsReasoningSummary: boolean;
+    /** Optional chaining override; unset falls back to officialEndpoint at request time. */
+    statefulResponses?: boolean;
+    /**
+     * Whether the host can store Responses results server-side (`store: true`).
+     * Rule-owned: hosts that keep generating after a client disconnect so a
+     * dropped stream can resume via `GET /responses/{id}`. Storage is opt-in
+     * per request (`storeResponses` stream option, else
+     * `PI_MUSE_STORE_RESPONSES`); stored runs retain prompts and outputs on the provider.
+     */
+    storeResponses: boolean;
     streamIdleTimeoutMs?: number;
     vercelGatewayRouting?: OpenAICompat["vercelGatewayRouting"];
     /** The model sits behind Vercel AI Gateway's Responses endpoint. */
@@ -918,9 +938,11 @@ export interface DevinCompat {
     modelRouter?: boolean;
     /** Whether the upstream model supports native parallel tool calls. */
     supportsParallelToolCalls?: boolean;
+    /** See {@link BedrockCompat.supportsSamplingParams}. */
+    supportsSamplingParams?: boolean;
 }
 /** Fully-resolved devin-agent compat view. */
-export type ResolvedDevinCompat = Required<DevinCompat>;
+export type ResolvedDevinCompat = Required<Omit<DevinCompat, "supportsSamplingParams">> & Pick<DevinCompat, "supportsSamplingParams">;
 /**
  * Compatibility settings for the Google API family (google-generative-ai,
  * google-vertex, google-gemini-cli). Class-driven defaults come from the
@@ -955,13 +977,16 @@ export interface GoogleCompat {
     stripImageInput?: boolean;
     /** Thinking-loop watchdog guard family applied to streamed reasoning. */
     thinkingLoopGuard?: "gemini" | "deepseek" | "xai";
+    /** See {@link BedrockCompat.supportsSamplingParams}. */
+    supportsSamplingParams?: boolean;
 }
 /** Fully-resolved google-API compat view, materialized once by `buildModel`. */
-export type ResolvedGoogleCompat = Required<Omit<GoogleCompat, "streamFirstEventTimeoutMs" | "streamIdleTimeoutMs" | "thinkingLoopGuard" | "antigravityUsageLabel">> & {
+export type ResolvedGoogleCompat = Required<Omit<GoogleCompat, "streamFirstEventTimeoutMs" | "streamIdleTimeoutMs" | "thinkingLoopGuard" | "antigravityUsageLabel" | "supportsSamplingParams">> & {
     streamFirstEventTimeoutMs?: number;
     streamIdleTimeoutMs?: number;
     thinkingLoopGuard?: GoogleCompat["thinkingLoopGuard"];
     antigravityUsageLabel?: string;
+    supportsSamplingParams?: boolean;
 };
 /** Sparse, user-authored compat overrides for a given API (models.json / config vocabulary). */
 export type CompatConfigOf<TApi extends Api> = TApi extends "openai-completions" | "openrouter" | "openai-responses" | "azure-openai-responses" | "openai-codex-responses" ? OpenAICompat : TApi extends "anthropic-messages" ? AnthropicCompat : TApi extends "bedrock-converse-stream" ? BedrockCompat : TApi extends "devin-agent" ? DevinCompat : TApi extends "google-generative-ai" | "google-vertex" | "google-gemini-cli" ? GoogleCompat : undefined;

package/dist/types/wire/gemini-headers.d.ts

@@ -24,7 +24,7 @@ export declare const getGeminiCliHeaders: (modelId?: string) => {
  * client the version and manifest are captured from, independent of the host
  * platform. Overrides: PI_AI_ANTIGRAVITY_VERSION / _CL / _OS / _ARCH.
  */
-export declare const DEFAULT_ANTIGRAVITY_VERSION = "2.8.0";
+export declare const DEFAULT_ANTIGRAVITY_VERSION = "2.19.1";
 /** Current Antigravity client version: env override → manifest-discovered → pinned fallback. */
 export declare function getAntigravityVersion(): string;
 /**
@@ -35,8 +35,11 @@ export declare function parseAntigravityManifestVersion(yamlText: string): strin
 /**
  * Resolves the latest Antigravity release from the official update manifest.
  * Success is cached for the process lifetime; failures are silent (the pinned
- * fallback stays valid) and clear the in-flight cache so a later call retries.
- * Skipped entirely when PI_AI_ANTIGRAVITY_VERSION is set.
+ * fallback stays valid) and suppress further lookups for
+ * `ANTIGRAVITY_VERSION_RETRY_MS`. Skipped entirely when PI_AI_ANTIGRAVITY_VERSION is set.
+ *
+ * The lookup is shared by concurrent callers, so it is bounded only by its own
+ * timeout; `signal` ends this caller's wait without cancelling the lookup.
  */
 export declare function ensureAntigravityVersion(fetcher?: FetchImpl, signal?: AbortSignal): Promise<void>;
 /** Antigravity `User-Agent` header value; rebuilt when the discovered version changes. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@linxiraos/pi-catalog",
-	"version": "1.1.25",
+	"version": "1.1.27",
 	"description": "Model catalog for omp: bundled model database, provider discovery descriptors, model identity, classification, and equivalence",
 	"keywords": [
 		"ai",
@@ -90,12 +90,12 @@
 		"gen:proto": "bun scripts/generate-protocols.ts"
 	},
 	"dependencies": {
-		"@linxiraos/pi-omptype": "1.1.25",
-		"@linxiraos/pi-utils": "1.1.25"
+		"@linxiraos/pi-omptype": "1.1.27",
+		"@linxiraos/pi-utils": "1.1.27"
 	},
 	"devDependencies": {
 		"@bgotink/kdl": "0.4.0",
-		"@linxiraos/pi-ai": "1.1.25",
+		"@linxiraos/pi-ai": "1.1.27",
 		"@types/bun": "^1.3.14"
 	},
 	"engines": {

package/src/compat/auth-ids.ts

@@ -72,6 +72,7 @@ export type AuthProviderId =
 	| "siliconflow-cn"
 	| "singularityapi-dev"
 	| "singularityapi-tech"
+	| "snowflake"
 	| "stencil"
 	| "stepfun"
 	| "synthetic"
@@ -156,6 +157,7 @@ export type LoginProviderId =
 	| "siliconflow-cn"
 	| "singularityapi-dev"
 	| "singularityapi-tech"
+	| "snowflake"
 	| "stencil"
 	| "stepfun"
 	| "synthetic"

package/src/compat/axes.ts

@@ -169,6 +169,7 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	"requires-thinking-as-text": wire("requiresThinkingAsText", ["openai"]),
 	"requires-tool-result-name": wire("requiresToolResultName", ["openai"]),
 	"strict-responses-pairing": wire("strictResponsesPairing", ["openai-responses"]),
+	"stateful-responses": wire("statefulResponses", ["openai-responses"]),
 	"requires-reasoning-off-juice-instruction": wire("requiresReasoningOffJuiceInstruction", ["openai-responses"]),
 	"supports-all-turns-reasoning-context": wire("supportsAllTurnsReasoningContext", ["openai-responses"]),
 	"supports-configuration-update": wire("supportsConfigurationUpdate", ["openai-responses"]),
@@ -194,6 +195,7 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	"supports-reasoning-effort": wire("supportsReasoningEffort", OAI),
 	"supports-reasoning-params": wire("supportsReasoningParams", OAI),
 	"supports-reasoning-summary": wire("supportsReasoningSummary", ["openai-responses"]),
+	"store-responses": wire("storeResponses", ["openai-responses"]),
 	"supports-store": wire("supportsStore", ["openai"]),
 	"supports-strict-mode": wire("supportsStrictMode", OAI),
 	"supports-tool-choice": wire("supportsToolChoice", OAI),
@@ -293,7 +295,7 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	"stream-idle-timeout-ms": wire("streamIdleTimeoutMs", [...OAI, "anthropic", "bedrock", "google"]),
 	"strip-image-input": wire("stripImageInput", [...OAI, "anthropic", "google"]),
 	"supports-forced-tool-choice": wire("supportsForcedToolChoice", [...OAI, "anthropic", "bedrock"]),
-	"supports-sampling-params": wire("supportsSamplingParams", [...OAI, "anthropic"]),
+	"supports-sampling-params": wire("supportsSamplingParams", [...OAI, "anthropic", "bedrock", "devin", "google"]),
 	"thinking-loop-guard": wire("thinkingLoopGuard", [...OAI, "anthropic", "google"], "scalar", [
 		"gemini",
 		"deepseek",
@@ -304,7 +306,7 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	"thinking-default-level": { key: "defaultLevel", set: "thinking", shape: "scalar", values: EFFORTS },
 	"thinking-effort-budgets": { key: "effortBudgets", set: "thinking", shape: "object" },
 	"thinking-effort-map": { key: "effortMap", set: "thinking", shape: "object" },
-	"thinking-efforts": { key: "efforts", set: "thinking", shape: "array", values: EFFORTS },
+	"thinking-efforts": { key: "efforts", set: "thinking", shape: "array", values: EFFORTS, emptyArray: true },
 	"thinking-mode": {
 		key: "mode",
 		set: "thinking",
@@ -390,6 +392,8 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	},
 	"web-search-model": { key: "webSearchModel", set: "catalog", shape: "scalar" },
 	"hosted-image": { key: "hostedImage", set: "catalog", shape: "scalar", values: [true, false] },
+	/** How the model line bills an input image; shape and formulas in `./image-tokenization`. */
+	"image-tokenization": { key: "imageTokenization", set: "catalog", shape: "object" },
 	"image-model": { key: "imageModel", set: "catalog", shape: "scalar" },
 	"limits-patch": { key: "limitsPatch", set: "catalog", shape: "object" },
 	"long-context-cost": { key: "longContext", set: "catalog", shape: "object" },

package/src/compat/collapse.d.ts

@@ -102,6 +102,13 @@ export interface VariantCollapseTable {
  * Discovery uses this accessor to preserve injectable table seams.
  */
 export declare function reviewedCollapseTable(provider: string): VariantCollapseTable | undefined;
+/**
+ * Logical id of the reviewed `provider` family claiming `memberId` as a member
+ * or extra alias, or `undefined` when no reviewed family owns it. Cursor's rich
+ * discovery names lanes with it so they keep the id the legacy-slug collapse
+ * (and the bundled catalog) assigns.
+ */
+export declare function reviewedVariantFamilyId(provider: string, memberId: string): string | undefined;
 /**
  * The global automatic rule: derive an `X` + `X-thinking` family for every
  * pair where both ids are live in `specs` (trailing or infix token). Gates:

package/src/compat/collapse.ts

@@ -492,6 +492,17 @@ export function reviewedCollapseTable(provider: string): VariantCollapseTable |
 	return REVIEWED_COLLAPSE_TABLES[provider] ?? REVIEWED_COLLAPSE_TABLES[provider.toLowerCase()];
 }
 
+/**
+ * Logical id of the reviewed `provider` family claiming `memberId` as a member
+ * or extra alias, or `undefined` when no reviewed family owns it. Cursor's rich
+ * discovery names lanes with it so they keep the id the legacy-slug collapse
+ * (and the bundled catalog) assigns.
+ */
+export function reviewedVariantFamilyId(provider: string, memberId: string): string | undefined {
+	const table = reviewedCollapseTable(provider);
+	return table ? getAliasIndex(table).resolve(memberId.trim()) : undefined;
+}
+
 /**
  * The global automatic rule: derive an `X` + `X-thinking` family for every
  * pair where both ids are live in `specs` (trailing or infix token). Gates:

package/src/compat/image-tokenization.ts

@@ -0,0 +1,166 @@
+/**
+ * Billed input tokens per image, from the `image-tokenization` rules in the
+ * compat cascade: a model line's lineage rule (`rules/classes/*.kdl`) applies
+ * on every host, and readers without one fall back to the rule for the wire
+ * API carrying the request (`rules/providers/image-tokenization.kdl`).
+ */
+import { isRecord } from "@linxiraos/pi-utils/type-guards";
+import { classifyModel } from "../identity";
+import { resolveCascade } from "./cascade";
+import type { ModelIdentity } from "./types";
+
+/** OpenAI image `detail` levels; `undefined` means the provider default (`auto`). */
+export type ImageDetail = "auto" | "low" | "high" | "original";
+
+export interface ImageSize {
+	width: number;
+	height: number;
+}
+
+/** One OpenAI `detail` level's sizing: a pixel-dimension limit, then an optional patch budget. */
+export interface PatchSizing {
+	/** Longest side after the pixel-dimension fit. */
+	maxEdge: number;
+	/** Resizing patch budget; absent when the level keeps the image's size. */
+	patchBudget?: number;
+}
+
+/** OpenAI 32px patches × a per-model multiplier, sized per `detail` level. */
+export interface OpenAiPatchTokenization {
+	regime: "openai-patch";
+	multiplier: number;
+	low: PatchSizing;
+	high: PatchSizing;
+	original: PatchSizing;
+	/** The level `auto` (and an omitted `detail`) sizes like. */
+	auto: "high" | "original";
+}
+
+/** One model line's image billing rule: the vendor formula and its per-model numbers. */
+export type ImageTokenization =
+	| OpenAiPatchTokenization
+	/** Anthropic 28px patches, resized to fit a padded-edge limit and a visual-token budget. */
+	| { regime: "anthropic-patch"; maxEdge: number; maxTokens: number }
+	/** A fixed per-image budget regardless of pixels (Gemini 3 `media_resolution`). */
+	| { regime: "fixed"; tokens: number };
+
+/** A `class: "unknown"` identity for targets resolved by wire API alone. */
+const UNCLASSIFIED: Pick<ModelIdentity, "class"> = { class: "unknown" };
+
+function isImageTokenization(value: unknown): value is ImageTokenization {
+	return (
+		isRecord(value) &&
+		(value.regime === "openai-patch" || value.regime === "anthropic-patch" || value.regime === "fixed")
+	);
+}
+
+/** What reads the image: a built model, any `{ id }` with optional host and identity, or just a wire `{ api }`. */
+export interface ImageTokenizationTarget {
+	id?: string;
+	provider?: string;
+	api?: string;
+	identity?: Pick<ModelIdentity, "class" | "family" | "revision">;
+}
+
+/**
+ * The reader's image billing rule: its lineage rule, else its wire API's
+ * fallback; undefined when neither covers it (an unclassified model on an
+ * unregistered API).
+ */
+export function resolveImageTokenization(target: ImageTokenizationTarget): ImageTokenization | undefined {
+	const provider = target.provider ?? "";
+	const model = target.id ?? "";
+	const identity: Pick<ModelIdentity, "class" | "family" | "revision"> =
+		target.identity ?? (model ? classifyModel(provider, model, { lenient: true }) : UNCLASSIFIED);
+	const rule = resolveCascade({
+		provider,
+		api: target.api ?? "",
+		class: identity.class,
+		model,
+		reasoning: false,
+		...(identity.family !== undefined && { family: identity.family }),
+		...(identity.revision !== undefined && { revision: identity.revision }),
+	}).catalog.imageTokenization;
+	return isImageTokenization(rule) ? rule : undefined;
+}
+
+/** Scale `size` down (never up) so its longest side is at most `maxEdge`. */
+function fitLongEdge(size: ImageSize, maxEdge: number): ImageSize {
+	const longest = Math.max(size.width, size.height);
+	if (longest <= maxEdge) return size;
+	const scale = maxEdge / longest;
+	return {
+		width: Math.max(1, Math.round(size.width * scale)),
+		height: Math.max(1, Math.round(size.height * scale)),
+	};
+}
+
+const OPENAI_PATCH_PX = 32;
+
+/** <https://developers.openai.com/api/docs/guides/images-vision#patch-based-image-tokenization> */
+function openAiPatches(size: ImageSize, sizing: PatchSizing): number {
+	const { width, height } = fitLongEdge(size, sizing.maxEdge);
+	const patches = Math.ceil(width / OPENAI_PATCH_PX) * Math.ceil(height / OPENAI_PATCH_PX);
+	const budget = sizing.patchBudget;
+	if (budget === undefined || patches <= budget) return patches;
+
+	const shrink = Math.sqrt((OPENAI_PATCH_PX * OPENAI_PATCH_PX * budget) / (width * height));
+	const scaledW = (width * shrink) / OPENAI_PATCH_PX;
+	const scaledH = (height * shrink) / OPENAI_PATCH_PX;
+	const adjusted = shrink * Math.min(Math.floor(scaledW) / scaledW, Math.floor(scaledH) / scaledH);
+	const resizedW = Math.floor(width * adjusted);
+	const resizedH = Math.floor(height * adjusted);
+	if (resizedW <= 0 || resizedH <= 0) return budget;
+	return Math.min(budget, Math.ceil(resizedW / OPENAI_PATCH_PX) * Math.ceil(resizedH / OPENAI_PATCH_PX));
+}
+
+const ANTHROPIC_PATCH_PX = 28;
+
+/** Round half to even, like the API's resize (and Python's `round`). */
+function roundTiesToEven(value: number): number {
+	const floor = Math.floor(value);
+	if (value - floor !== 0.5) return Math.round(value);
+	return floor % 2 === 0 ? floor : floor + 1;
+}
+
+/**
+ * Anthropic visual tokens after the API's resize: the largest
+ * aspect-preserving size whose 28px-padded edges fit `maxEdge` and whose
+ * patch count fits `maxTokens`, found by bisecting the long edge. Port of the
+ * reference implementation:
+ * <https://platform.claude.com/docs/en/build-with-claude/vision-coordinates#resize-your-image-before-uploading>
+ */
+function anthropicTokens(size: ImageSize, maxEdge: number, maxTokens: number): number {
+	const long = Math.max(size.width, size.height);
+	const shortSide = Math.min(size.width, size.height);
+	const aspect = long / shortSide;
+	const patches = (l: number, s: number) => Math.ceil(l / ANTHROPIC_PATCH_PX) * Math.ceil(s / ANTHROPIC_PATCH_PX);
+	const fits = (l: number, s: number) =>
+		Math.ceil(l / ANTHROPIC_PATCH_PX) * ANTHROPIC_PATCH_PX <= maxEdge &&
+		Math.ceil(s / ANTHROPIC_PATCH_PX) * ANTHROPIC_PATCH_PX <= maxEdge &&
+		patches(l, s) <= maxTokens;
+	const short = (l: number) => Math.max(roundTiesToEven(l / aspect), 1);
+	if (fits(long, shortSide)) return patches(long, shortSide);
+	let lo = 1; // always fits
+	let hi = long; // never fits
+	while (lo + 1 < hi) {
+		const mid = Math.floor((lo + hi) / 2);
+		if (fits(mid, short(mid))) lo = mid;
+		else hi = mid;
+	}
+	return patches(lo, short(lo));
+}
+
+/** Billed input tokens for one image of `size` under `rule`; only `openai-patch` reads `detail`. */
+export function imageTokens(rule: ImageTokenization, size: ImageSize, detail?: ImageDetail): number {
+	switch (rule.regime) {
+		case "fixed":
+			return rule.tokens;
+		case "openai-patch": {
+			const level = detail === "low" || detail === "high" || detail === "original" ? detail : rule.auto;
+			return Math.ceil(openAiPatches(size, rule[level]) * rule.multiplier);
+		}
+		case "anthropic-patch":
+			return anthropicTokens(size, rule.maxEdge, rule.maxTokens);
+	}
+}

package/src/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" | "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";
+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" | "snowflake" | "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/src/compat/provider-ids.ts

@@ -66,6 +66,7 @@ export type KnownProvider =
 	| "siliconflow-cn"
 	| "singularityapi-dev"
 	| "singularityapi-tech"
+	| "snowflake"
 	| "stepfun"
 	| "synthetic"
 	| "together"