@oh-my-pi/pi-catalog 18.1.17 → 18.1.19

package/CHANGELOG.md

@@ -2,10 +2,30 @@
 
 ## [Unreleased]
 
+## [18.1.19] - 2026-09-12
+
+### Added
+
+- Added Charm Hyper as a built-in provider with API-key login, live model discovery, and per-model pricing, effort ladders, and limits read straight from its catalog ([#11656](https://github.com/can1357/oh-my-pi/pull/11656) by [@oldschoola](https://github.com/oldschoola)).
+
+## [18.1.18] - 2026-09-11
+
+### Added
+
+- `supports-server-compaction` compat axis (`compat.supportsServerCompaction`): whether a model line accepts Anthropic server-side compaction (`compact-2026-01-12`). Class rules enable it for Opus 4.6+, Sonnet 4.6+, and Fable/Mythos 5 on every Anthropic-messages host; the default is `false`.
+
+### Fixed
+
+- OpenCode Go's DeepSeek Flash lanes (`deepseek-flash`, `deepseek-v4.1-flash`) now declare image input. The gateway serves them with vision despite the IDs carrying no vision suffix, so the class-wide `strip-image-input` rule was dropping attachments the endpoint reads; the modality is declared too, since live discovery seeds these lanes text-only ([#11774](https://github.com/can1357/oh-my-pi/pull/11774) by [@STRML](https://github.com/STRML)).
+- Amazon Bedrock OpenAI models, plus unclassified profiles such as opaque application-inference-profile ARNs, now carry the compatibility policy required to preserve image-bearing tool results ([#11681](https://github.com/can1357/oh-my-pi/issues/11681)).
+- DeepSeek V4.1 Flash requests now honor the documented 384K output maximum instead of being capped at 64K ([#11769](https://github.com/can1357/oh-my-pi/issues/11769)).
+- Fixed the first-party `deepseek-flash` alias missing the V4.1 Flash wire contract: it now sends `max_tokens` with `reasoning_content` and replays reasoning and assistant content on tool calls with no tool choice ([#11799](https://github.com/can1357/oh-my-pi/pull/11799) by [@brit](https://github.com/brit)).
+
 ## [18.1.17] - 2026-09-10
 
 ### Added
 
+- Added DeepSeek V4.1 Flash on OpenRouter with image input and low/high/max reasoning levels ([#11592](https://github.com/can1357/oh-my-pi/pull/11592) by [@mazzanfar](https://github.com/mazzanfar)).
 - Added DeepSeek cost estimates that follow published peak/off-peak rates.
 - Added dated, announced price changes to the catalog, so rates switch on their effective date (e.g. DeepSeek Pro moving to Flash rates).
 - Added Command Code as a built-in provider with API-key login, live model discovery, per-model pricing, native OpenAI/Anthropic-compatible routing, cache-aware token usage, and TTFT metrics ([#11391](https://github.com/can1357/oh-my-pi/pull/11391) by [@CherkaSSH](https://github.com/CherkaSSH)).

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" | "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" | "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";
 /** Providers whose policy declares a `login` flow (the `/login` roster). */
-export type LoginProviderId = "abliteration" | "aiand" | "alibaba-coding-plan" | "alibaba-token-plan" | "anthropic" | "baseten" | "cerebras" | "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" | "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";

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

@@ -88,6 +88,14 @@ export declare const CATALOG_PROVIDERS: readonly [{
     readonly catalogDiscovery: {
         readonly label: "Cerebras";
     };
+}, {
+    readonly id: "charm-hyper";
+    readonly defaultModel: "glm-5.3";
+    readonly envVars: readonly ["CHARM_HYPER_API_KEY", "HYPER_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("../index.js").ModelManagerOptions<"openai-completions", unknown>;
+    readonly allowUnauthenticated: true;
+    readonly dynamicModelsAuthoritative: true;
+    readonly skipCrossProviderReferenceFills: true;
 }, {
     readonly id: "cloudflare-ai-gateway";
     readonly defaultModel: "anthropic/claude-opus-4-8";

package/dist/types/provider-models/openai-compat.d.ts

@@ -745,3 +745,22 @@ export interface CommandCodeModelManagerConfig {
  * or context window.
  */
 export declare function commandCodeModelManagerOptions(config?: CommandCodeModelManagerConfig): ModelManagerOptions<Api>;
+/**
+ * Configuration for the Charm Hyper model manager.
+ *
+ * `baseUrl` overrides the gateway root for tests and self-hosted proxies; a
+ * value that omits the `/v1` surface gains one, so a host-only override
+ * behaves like every sibling provider's.
+ */
+export interface CharmHyperModelManagerConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: FetchImpl;
+}
+/**
+ * Charm Hyper's gateway catalog. `/v1/models` is public and carries the live
+ * tariff, so discovery runs with or without a key and the snapshot is
+ * authoritative: a model the gateway stops serving is pruned rather than kept
+ * alive by a stale bundled row.
+ */
+export declare function charmHyperModelManagerOptions(config?: CharmHyperModelManagerConfig): ModelManagerOptions<"openai-completions">;

package/dist/types/types.d.ts

@@ -409,6 +409,20 @@ export interface OpenAICompat {
 export interface AnthropicCompat {
     /** Whether thinking requests may include `context_management` and its beta header. Default: true. */
     supportsContextManagement?: boolean;
+    /**
+     * Whether the model lineage supports Anthropic server-side compaction
+     * (`compact-2026-01-12`: the `compact_20260112` edit and replayed
+     * `compaction` blocks). Rule-owned per model line; the beta covers the
+     * adaptive-thinking generation onward and rejects older lines. Default: false.
+     */
+    supportsServerCompaction?: boolean;
+    /**
+     * Whether the model is served by the first-party Anthropic provider (its
+     * default route is the official API). Rule-owned on the provider; the
+     * compaction transport pairs it with a per-request effective-URL check
+     * because reroutes leave it stale-true. Default: false.
+     */
+    firstPartyProvider?: boolean;
     /**
      * Whether requests may carry `output_config.effort` (and its effort beta
      * header). Vertex AI rejects the field/header. Default: true.
@@ -756,6 +770,13 @@ export type ResolvedAnthropicCompat = Required<Omit<AnthropicCompat, "streamIdle
      * env headers, and cache-TTL shaping without per-request URL parsing.
      */
     officialEndpoint: boolean;
+    /**
+     * The model is served by the first-party Anthropic provider. Unlike
+     * `officialEndpoint` (URL-derived per deployment), this is provider
+     * identity for compaction gating, always paired with a per-request
+     * effective-URL check.
+     */
+    firstPartyProvider: boolean;
 };
 /**
  * Compatibility settings for the devin-agent (Codeium Cascade) API. Cascade
@@ -910,6 +931,8 @@ export interface Model<TApi extends Api = Api> {
     requiresGlyphTokenization?: boolean;
     /** Whether this model requires Cursor's tool-schema combiner projection. */
     requiresCursorToolSchemaProjection?: boolean;
+    /** Whether this model requires tool-result images hoisted into sibling user content blocks. */
+    requiresToolResultImageHoisting?: boolean;
     /**
      * Model id to send on the wire when it differs from `id`. Used by catalog
      * variants that present one upstream model under several local entries —
@@ -1083,7 +1106,7 @@ export interface Model<TApi extends Api = Api> {
  * vocabulary of `buildModel`. Identical to `Model` except `compat` carries the
  * sparse override shape and nothing is resolved yet.
  */
-export interface ModelSpec<TApi extends Api = Api> extends Omit<Model<TApi>, "compat" | "identity" | "compatConfig" | "requiresGlyphTokenization" | "requiresCursorToolSchemaProjection" | "supportsComputerUseConfig"> {
+export interface ModelSpec<TApi extends Api = Api> extends Omit<Model<TApi>, "compat" | "identity" | "compatConfig" | "requiresGlyphTokenization" | "requiresCursorToolSchemaProjection" | "requiresToolResultImageHoisting" | "supportsComputerUseConfig"> {
     /** Sparse compatibility overrides; resolved into `Model.compat` by `buildModel`. */
     compat?: CompatConfigOf<TApi>;
 }

package/dist/types/wire/charm-hyper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Charm Hyper gateway endpoint, shared so a host migration — or a self-hosted
+ * proxy override — touches a single module.
+ */
+export declare const CHARM_HYPER_API_BASE_URL = "https://hyper.charm.land/v1";
+/**
+ * Resolve a configured Charm Hyper base URL onto the gateway's `/v1` surface.
+ *
+ * Every consumer must agree on this, because they key different things off the
+ * result: inference and discovery target it, `/usage` sends a bearer token to
+ * it, and the model cache namespace is hashed from it. Three separate copies
+ * previously disagreed for a blank value — the model manager treated it as
+ * absent and used the canonical host, while the others produced a bare `/v1` —
+ * so a whitespace-only override silently split inference, balance checks and
+ * caching across different endpoints.
+ *
+ * A blank or whitespace-only value therefore means "not configured" and
+ * resolves to the canonical host; anything else keeps its host and gains the
+ * `/v1` segment if it omits one.
+ */
+export declare function normalizeCharmHyperBaseUrl(baseUrl?: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-catalog",
-	"version": "18.1.17",
+	"version": "18.1.19",
 	"description": "Model catalog for omp: bundled model database, provider discovery descriptors, model identity, classification, and equivalence",
 	"homepage": "https://omp.sh",
 	"author": "Stencil Labs, Inc.",
@@ -35,12 +35,12 @@
 		"gen:proto": "bun scripts/generate-protocols.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.1.17",
-		"@oh-my-pi/pi-utils": "18.1.17"
+		"@oh-my-pi/omptype": "18.1.19",
+		"@oh-my-pi/pi-utils": "18.1.19"
 	},
 	"devDependencies": {
 		"@bgotink/kdl": "0.4.0",
-		"@oh-my-pi/pi-ai": "18.1.17",
+		"@oh-my-pi/pi-ai": "18.1.19",
 		"@types/bun": "^1.3.14"
 	},
 	"engines": {

package/src/build.ts

@@ -34,8 +34,8 @@ function isInputModalities(value: unknown): value is ("text" | "image")[] {
  * corrections (`cost-patch`, `limits-patch`, `long-context-cost`,
  * `context-window-floor`) overwrite upstream values; selection metadata
  * (`priority`, `apply-patch-tool-type`, `service-tier-cost`,
- * `requires-cursor-tool-schema-projection`) is rule-owned;
- * `context-promotion-target` fills only when the spec left it unset.
+ * `requires-cursor-tool-schema-projection`, `requires-tool-result-image-hoisting`)
+ * is rule-owned; `context-promotion-target` fills only when the spec left it unset.
  */
 function applyCatalogAssignments<TApi extends Api>(model: Model<TApi>, catalog: Record<string, unknown>): void {
 	const serviceTierCost = objectPayload(catalog.serviceTierCost);
@@ -63,6 +63,12 @@ function applyCatalogAssignments<TApi extends Api>(model: Model<TApi>, catalog:
 	} else {
 		delete model.requiresCursorToolSchemaProjection;
 	}
+	const requiresToolResultImageHoisting = catalog.requiresToolResultImageHoisting;
+	if (requiresToolResultImageHoisting === true) {
+		model.requiresToolResultImageHoisting = true;
+	} else {
+		delete model.requiresToolResultImageHoisting;
+	}
 	const contextPromotionTarget = catalog.contextPromotionTarget;
 	if (typeof contextPromotionTarget === "string" && model.contextPromotionTarget === undefined) {
 		model.contextPromotionTarget = contextPromotionTarget;

package/src/compat/auth-ids.ts

@@ -13,6 +13,7 @@ export type AuthProviderId =
 	| "baseten"
 	| "bedrock-mantle"
 	| "cerebras"
+	| "charm-hyper"
 	| "cline-pass"
 	| "cloudflare-ai-gateway"
 	| "commandcode"
@@ -94,6 +95,7 @@ export type LoginProviderId =
 	| "anthropic"
 	| "baseten"
 	| "cerebras"
+	| "charm-hyper"
 	| "cline-pass"
 	| "cloudflare-ai-gateway"
 	| "commandcode"

package/src/compat/axes.ts

@@ -192,6 +192,7 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	"disable-adaptive-thinking": wire("disableAdaptiveThinking", ["anthropic"]),
 	"disable-strict-tools": wire("disableStrictTools", ["anthropic"]),
 	"escape-builtin-tool-names": wire("escapeBuiltinToolNames", ["anthropic"]),
+	"first-party-provider": wire("firstPartyProvider", ["anthropic"]),
 	"inject-claude-code-instruction": wire("injectClaudeCodeInstruction", ["anthropic"]),
 	"official-endpoint": wire("officialEndpoint", ["anthropic", "openai-responses"]),
 	"replay-unsigned-thinking": wire("replayUnsignedThinking", ["anthropic"]),
@@ -205,6 +206,7 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 	"supports-mid-conversation-system": wire("supportsMidConversationSystem", ["anthropic"]),
 	"supports-mid-conversation-tool-changes": wire("supportsMidConversationToolChanges", ["anthropic"]),
 	"supports-per-message-effort": wire("supportsPerMessageEffort", ["anthropic"]),
+	"supports-server-compaction": wire("supportsServerCompaction", ["anthropic"]),
 	"supports-thinking-binding-controls": wire("supportsThinkingBindingControls", ["anthropic"]),
 	"supports-turn-scoped-system": wire("supportsTurnScopedSystem", ["anthropic"]),
 
@@ -285,6 +287,11 @@ export const AXES: Readonly<Record<string, AxisDef>> = {
 		set: "catalog",
 		shape: "scalar",
 	},
+	"requires-tool-result-image-hoisting": {
+		key: "requiresToolResultImageHoisting",
+		set: "catalog",
+		shape: "scalar",
+	},
 	priority: { key: "priority", set: "catalog", shape: "scalar" },
 	"service-tier-cost": { key: "serviceTierCost", set: "catalog", shape: "object" },
 	"time-based-cost": { key: "timeBased", set: "catalog", shape: "object" },

package/src/compat/resolve.ts

@@ -843,6 +843,8 @@ function resolveAnthropicPolicy(
 		officialEndpoint: official,
 		signingEndpoint,
 		supportsContextManagement: true,
+		supportsServerCompaction: false,
+		firstPartyProvider: false,
 		supportsOutputEffort: true,
 		disableStrictTools: isAzure,
 		disableAdaptiveThinking: false,

package/src/compat/rules/auth/_order.kdl

@@ -5,7 +5,7 @@ login-order "openai-codex" "anthropic" "zai" "zai-coding-plan" "kimi-code" "open
 	"cursor" "devin" "google-antigravity" "google-gemini-cli" "openai-codex-device" "xai" "xai-oauth" \
 	"gitlab-duo" "gitlab-duo-agent" "alibaba-coding-plan" "alibaba-token-plan" "aiand" "abliteration" "zhipu-coding-plan" \
 	"umans" "qwen-portal" "sakana" "minimax-code" "minimax-code-cn" "xiaomi" "xiaomi-token-plan-sgp" \
-	"xiaomi-token-plan-ams" "xiaomi-token-plan-cn" "firepass" "cline-pass" "commandcode" "deepseek" "muse-code" "meta" "moonshot" \
+	"xiaomi-token-plan-ams" "xiaomi-token-plan-cn" "firepass" "cline-pass" "commandcode" "charm-hyper" "deepseek" "muse-code" "meta" "moonshot" \
 	"cerebras" "baseten" "fireworks" "together" "nvidia" "novita" "deepinfra" "huggingface" "perplexity" \
 	"qianfan" "venice" "siliconflow" "siliconflow-cn" "synthetic" "nanogpt" "wafer-serverless" "coreweave" \
 	"vercel-ai-gateway" "cloudflare-ai-gateway" "litellm" "kilo" "zenmux" "opencode-zen" "opencode-go" \

package/src/compat/rules/auth/charm-hyper.kdl

@@ -0,0 +1,19 @@
+// Validation targets `/v1/credits`, not `/v1/models`: the models endpoint is
+// public and answers 200 with no credentials or a bogus key (verified
+// 2026-09-11), so a models-endpoint probe against it could never reject a bad
+// key. `/v1/credits` is an authenticated, non-billable GET that returns the
+// account balance on success and 401 `{"error":"authentication failed"}`
+// otherwise — the same trick cline-pass uses to validate against its own
+// `/users/me`, and cheaper than a chat-completions probe that would bill the
+// key on every login.
+auth "charm-hyper" {
+	name "Charm Hyper"
+	env "CHARM_HYPER_API_KEY" "HYPER_API_KEY"
+	login "api-key" {
+		auth-url "https://hyper.charm.land/"
+		instructions "Create or copy an API key from the Charm Hyper dashboard"
+		prompt "Paste your Charm Hyper API key" placeholder="sk-hyper-..."
+		normalize "strip-bearer"
+		validate "models-endpoint" label="Charm Hyper" url="https://hyper.charm.land/v1/credits"
+	}
+}

package/src/compat/rules/classes/anthropic.kdl

@@ -7,6 +7,30 @@ class "anthropic" {
 			thinking-prefix-binding #true
 		}
 	}
+	// Server-side compaction (compact-2026-01-12) is a lineage capability: the
+	// documented model list is the adaptive-thinking generation onward (Opus
+	// 4.6+, Sonnet 4.6+, Fable/Mythos 5+). Whether a host delivers the beta is
+	// decided at request time from the effective endpoint, not here.
+	family "fable" {
+		revision ">=5" {
+			supports-server-compaction #true
+		}
+	}
+	family "mythos" {
+		revision ">=5" {
+			supports-server-compaction #true
+		}
+	}
+	family "opus" {
+		revision ">=4.6" {
+			supports-server-compaction #true
+		}
+	}
+	family "sonnet" {
+		revision ">=4.6" {
+			supports-server-compaction #true
+		}
+	}
 	on "anthropic" "cloudflare-ai-gateway" "google-vertex" {
 		family "fable" {
 			revision ">=5" {

package/src/compat/rules/classes/minimax.kdl

@@ -28,8 +28,10 @@ class "minimax" {
 	}
 	// MiniMax-M3: 512K is the standard pricing-tier boundary leaked into
 	// upstream metadata, not the model ceiling (documented: 1M in / 128K out).
-	on "minimax" "minimax-cn" "minimax-code" "minimax-code-cn" {
-		models "MiniMax-M3" {
+	// Exact selectors are case-sensitive, so both served spellings are listed:
+	// MiniMax hosts publish `MiniMax-M3`, Charm Hyper publishes `minimax-m3`.
+	on "charm-hyper" "minimax" "minimax-cn" "minimax-code" "minimax-code-cn" {
+		models "MiniMax-M3" "minimax-m3" {
 			limits-patch {
 				context-window 1000000
 				max-tokens 128000

package/src/compat/rules/providers/amazon-bedrock.kdl

@@ -15,6 +15,8 @@ provider "amazon-bedrock" {
 	}
 	class "openai" {
 		thinking-mode "effort"
+		// OpenAI models reject Converse image blocks nested inside toolResult content.
+		requires-tool-result-image-hoisting #true
 	}
 	class "deepseek" {
 		requires-reasoning-content-for-all-assistant-turns #true
@@ -28,6 +30,11 @@ provider "amazon-bedrock" {
 	class "unknown" {
 		thinking-efforts "minimal" "low" "medium" "high"
 		thinking-mode "budget"
+		// Opaque application-inference-profile ARNs carry no vendor signal, so an
+		// OpenAI-backed profile classifies here and would otherwise nest images in
+		// toolResult content and hit the same rejection. Hoisting is accepted by
+		// every Converse model measured, so it is the safe default for unknowns.
+		requires-tool-result-image-hoisting #true
 	}
 	// residue: taxonomy ranks and exact globs do not isolate these models.
 	models "moonshot.kimi-k2-thinking" {

package/src/compat/rules/providers/anthropic.kdl

@@ -1,6 +1,14 @@
 // Provider-wire compat for "anthropic"; regenerated from the frozen census using deployment contract selectors.
 
 provider "anthropic" {
+	// First-party provider: models served through this provider reach the
+	// official API unless rerouted. A dedicated axis rather than
+	// `official-endpoint`, which stays URL-derived: a custom `baseUrl` on this
+	// provider must keep `officialEndpoint: false` (SDK `X-Api-Key`
+	// suppression and friends read that flag). The compaction transport
+	// combines this fact with a per-request effective-URL check, so it never
+	// authorizes a block on its own.
+	first-party-provider #true
 	class "anthropic" {
 		revision ">=3.7 <4.6" {
 			thinking-efforts "minimal" "low" "medium" "high" "xhigh"

package/src/compat/rules/providers/charm-hyper.kdl

@@ -0,0 +1,82 @@
+// Charm Hyper gateway deployment contract.
+//
+// Capability data is NOT restated here: `GET /v1/models` publishes each row's
+// context window, output cap, vision flag, effort vocabulary and per-million
+// tariff, and `charmHyperModelManagerOptions` maps all of it verbatim —
+// including `reasoningDisableMode`, which is derived per model from whether
+// the advertised vocabulary contains `none`. Only facts the gateway does not
+// publish, or publishes wrongly, belong in this file.
+provider "charm-hyper" {
+	// OpenAI-dialect gateway in front of open-weight and third-party models.
+	// `developer` and `store` are accepted (HTTP 200) but the gateway accepts
+	// every unknown field it is handed, so acceptance is not evidence the
+	// semantics are honored; both stay off and system prompts ride the
+	// `system` role, matching every sibling gateway. The wire takes
+	// `max_tokens` (verified 2026-09-11).
+	supports-developer-role #false
+	supports-store #false
+	max-tokens-field "max_tokens"
+	thinking-mode "effort"
+	// Reasoning arrives as `reasoning_content` on both the streamed delta and
+	// the final message (verified 2026-09-11).
+	reasoning-content-field "reasoning_content"
+	// ---------------------------------------------------------------------------
+	// Blockless rows are left non-reasoning on purpose.
+	//
+	// Four ids serve a thinking model while publishing no `reasoning` block:
+	// glm-5, glm-5.1, kimi-k2-thinking and minimax-m2.7 each returned
+	// populated `reasoning_content` and non-zero `reasoning_tokens` on a
+	// multi-step prompt (2026-09-11). The other blockless rows
+	// (gemma-4-26b-a4b-it, kimi-k2.5, kimi-k2.7-code, llama-3.3-70b-instruct,
+	// llama-4-maverick-17b-128e-instruct-fp8,
+	// qwen3-coder-480b-a35b-instruct-int4-mixed-ar, qwen3-next-80b-a3b-instruct)
+	// returned none.
+	//
+	// No rule restores them, because none can be written honestly. Those four
+	// expose no effort dial, and `ThinkingConfig.efforts` is documented as
+	// never empty — a reasoning model without a controllable surface carries
+	// `thinking: undefined`, which no KDL axis can express (the only upgrade
+	// path is an exact `thinking-efforts` ladder). Synthesizing a ladder would
+	// add silent no-op rungs: the gateway answers 200 to efforts it never
+	// advertised and simply ignores them, and a repeat measurement of effort
+	// sensitivity on these ids came back non-monotonic, i.e. sampling noise
+	// rather than a hidden dial.
+	//
+	// The cost is narrow and was checked: streamed `reasoning_content` is
+	// parsed and displayed with no `model.reasoning` gate, the effort
+	// parameter is moot without a dial, and the developer-role and
+	// zai-replay paths are already disabled for this provider.
+	// ---------------------------------------------------------------------------
+	// Residue: misreported output caps. The gateway derives
+	// `max_output_tokens` as a flat fraction of the context window rather
+	// than reporting a real ceiling — 10% on 9 rows, the dominant
+	// convention — and the values are advisory, not enforced: glm-5.1
+	// publishes 3276 yet produced 14066 tokens, and minimax-m2.7 publishes
+	// 6553 yet produced 8418, both stopping on `finish_reason: "stop"`
+	// rather than `length`. An over-stated cap is never rejected either
+	// (`max_tokens: 200000` returns 200), so the risk is one-sided:
+	// over-stating costs only the context share 10% already reserves
+	// everywhere else, while under-stating truncates real output.
+	//
+	// Both corrections take a same-window peer's published value rather than
+	// inventing a ceiling, and both clear the measured floor:
+	//   glm-5.1      (202750) is 1.6%; sibling glm-5 (202752) publishes 20275.
+	//   minimax-m2.7 (262100) is 2.5%, the lone outlier in its window class;
+	//                kimi-k2.5 (262144), kimi-k2.6 (262000) and
+	//                qwen3-next-80b (262144) all publish 26214.
+	//
+	// deepseek-v4.1-flash is the only other 2.5% row and is deliberately left
+	// alone: its 1M window has no peer group that agrees on a fraction, and a
+	// long generation stopped naturally at 8504, well inside the published
+	// 26214. Measured 2026-09-11.
+	models "glm-5.1" {
+		limits-patch {
+			max-tokens 20275
+		}
+	}
+	models "minimax-m2.7" {
+		limits-patch {
+			max-tokens 26214
+		}
+	}
+}

package/src/compat/rules/providers/deepseek.kdl

@@ -16,6 +16,7 @@ provider "deepseek" {
 	// bare alias carries no family, and the retired `v4-flash`/`-vision-exp` ids
 	// are still accepted and billed at the Flash card.
 	models "deepseek-flash" "deepseek-v4-flash" "deepseek-v4-flash-vision-exp" {
+		clamp-output-to-model-max #true
 		time-based-cost {
 			off-peak-multiplier 0.5
 			peak-windows {
@@ -81,11 +82,22 @@ provider "deepseek" {
 		}
 	}
 	// residue: taxonomy ranks and exact globs do not isolate these models.
-	models "deepseek-v4-flash" "deepseek-v4.1-flash-expires-on-0910" {
+	// The bare `deepseek-flash` alias serves DeepSeek-V4.1-Flash, so it shares
+	// the V4.1 wire contract: max_tokens + reasoning_content, mandatory replay
+	// (synthetic placeholders rejected upstream), no tool choice, and the
+	// low/high/max effort ladder the bare alias cannot inherit by family.
+	models "deepseek-flash" "deepseek-v4-flash" "deepseek-v4.1-flash-expires-on-0910" {
+		// Stale source capability data: discovery reports the bare alias as
+		// non-reasoning, so opt into the cascade upgrade for the exact ladder.
+		thinking-upgrade-neutral #true
 		max-tokens-field "max_tokens"
 		reasoning-content-field "reasoning_content"
 		requires-assistant-content-for-tool-calls #true
 		requires-reasoning-content-for-tool-calls #true
+		allows-synthetic-reasoning-content-for-tool-calls #false
 		supports-tool-choice #false
+		// The bare alias carries no taxonomy family, so it cannot inherit the
+		// flash ladder; the exact rule owns it instead.
+		thinking-efforts "low" "high" "max"
 	}
 }

package/src/compat/rules/providers/opencode-go.kdl

@@ -1,6 +1,16 @@
 // Provider-wire compat for "opencode-go"; regenerated from the frozen census using deployment contract selectors.
 
 provider "opencode-go" {
+	// The Flash lanes accept images despite their IDs lacking a vision suffix;
+	// verified against the gateway (unguessable pixel-rendered text read back
+	// verbatim). Mirrors the OpenRouter carve-out for deepseek-v4.1-flash.
+	// The modality is declared here as well: live gateway discovery seeds
+	// `input: ["text"]`, and the wire guard requires the declared modality, so
+	// clearing `strip-image-input` alone would leave the lane text-only.
+	models "deepseek-flash" "deepseek-v4.1-flash" {
+		input-modalities "text" "image"
+		strip-image-input #false
+	}
 	// Replaces the OpenCode reasoning-model whenThinking fallback object.
 	when-thinking {
 		requires-reasoning-content-for-tool-calls #true

package/src/compat/rules/providers/openrouter.kdl

@@ -1,6 +1,10 @@
 // Provider-wire compat for "openrouter"; regenerated from the frozen census using deployment contract selectors.
 
 provider "openrouter" {
+	// V4.1 Flash accepts images despite its ID lacking a vision suffix.
+	models "deepseek/deepseek-v4.1-flash" {
+		strip-image-input #false
+	}
 	// Replaces the OpenRouter provider wire-model-id dispatch branch.
 	wire-model-id-mode "openrouter"
 	// Replaces the strict-mode provider whitelist entry.