@mars-sea/dsh-commandcode-provider 0.10.0-alpha.5 → 0.10.0-alpha.6

package/lib/index.d.ts

@@ -7,194 +7,7 @@ import { Context } from "@deepseek-ai/cordis";
 import { AttachmentStore } from "@deepseek-ai/dsh-attachment";
 import { CommandDefinition } from "@deepseek-ai/dsh-commands";
 //#region src/adapter.d.ts
-declare const KNOWN_EFFORTS: Readonly<Record<string, readonly string[]>>;
-/**
- * Models whose Capabilities include Vision, per the official Command Code
- * model registry (`https://commandcode.ai/docs/reference/cli/models`, generated
- * from the same registry as `cmd --list-models` / the `/model` picker).
- *
- * The Provider API does not expose modality metadata, so this snapshot is the
- * source of truth for image-input gating. Command Code's own CLI falls back to
- * a client-side VISION side-call for text-only models; this adapter does not
- * reproduce that interactive feature, so images sent to a model outside this
- * list are refused loudly (`UNSUPPORTED_CONTENT`) instead of being dropped or
- * sent to a model that cannot read them.
- *
- * Keep in sync with the official registry when new models ship (see the
- * dsh-commandcode-upstream skill).
- */
-declare const KNOWN_IMAGE_MODELS: ReadonlySet<string>;
-/**
- * Models the official CLI's model table (command-code@1.40.1) marks
- * `reasoning:!0` but defines no selectable `reasoning_effort` levels — they
- * think automatically, with Command Code driving the depth. This is the
- * authoritative "thinks, effort not adjustable" set: `KNOWN_EFFORTS` (which
- * mirrors the CLI's effort map exactly) stays the sole source for selectable
- * effort levels, and this snapshot is not surfaced in the picker's compact
- * description — it exists for programmatic consumers.
- *
- * Source: the command-code@1.40.1 bundled model table (dist/cli.mjs),
- * cross-checked with https://commandcode.ai/docs/reference/cli/models.
- * (`stealth/ox-alpha` left this set in command-code@1.32.1, which gave it
- * selectable `['low', 'high', 'max']` efforts; the preview then ended in
- * 1.34.0, removing the model from the catalog entirely. `tencent/hy4-preview`
- * joined this set in command-code@1.37.0 — reasoning:!0, no efforts, 1M
- * context, routed through OpenRouter — then gained selectable
- * `['low', 'medium', 'high']` efforts in command-code@1.38.0 and moved to
- * `KNOWN_EFFORTS`. `moonshotai/Kimi-K3` followed the same path in
- * command-code@1.39.3 — it gained `['low', 'high', 'max']` efforts and moved
- * to `KNOWN_EFFORTS`.)
- * Keep in sync via the dsh-commandcode-upstream skill.
- */
-declare const KNOWN_THINKING_MODELS: ReadonlySet<string>;
-/**
- * The minimum subscription plan a model is included in, per the official plan
- * pages (`/docs/plans/go`, `/docs/plans/goat`, `/docs/plans/pro`, `/docs/plans/max`
- * and `/docs/resources/pricing-limits`). Each plan's model list is a superset of
- * the one below it: Go ⊂ GOAT ⊂ Pro ⊂ Provider/Max. Models absent from every
- * plan list (Claude Opus/Fable, Fugu Ultra) are Provider-tier.
- *
- * The Provider API exposes no plan metadata, so this snapshot is the source of
- * truth for the picker's plan annotation — it answers "which plan do I need to
- * actually use this model?" at a glance. Plan labels use the official tier
- * names (`Go`, `GOAT`, `Pro`, `Provider`), with `Max` implying Provider.
- *
- * Keep in sync with the official plan pages when they change (see the
- * dsh-commandcode-upstream skill).
- */
-declare const KNOWN_PLANS: Readonly<Record<string, string>>;
-/** Official display labels for each plan tier. */
-declare const PLAN_LABELS: Readonly<Record<string, string>>;
-/**
- * Plan-tier sort weights, low to high. Models outside the snapshot (unknown
- * plans) sort after every known tier, keeping known models predictable.
- */
-declare const PLAN_ORDER: Readonly<Record<string, number>>;
-/**
- * Comparator for the model picker: free models first (zero credit cost, usable
- * by every account), then by plan tier (lowest first), then by model name,
- * then by id as a tiebreak. Models with no known plan sort last.
- */
-declare function compareByPlan(a: {
-  id: string;
-  name: string;
-}, b: {
-  id: string;
-  name: string;
-}): number;
-/**
- * Subscription plan table, synced from the official CLI bundle's plan maps
- * (`Nn`/`$n` in command-code@1.31.0 `dist/cli.mjs`, re-verified unchanged
- * against 1.32.2 where they appear as `Zn`/`er`): subscription `planId`
- * prefix → display name and the plan's monthly credit total. This is the
- * account's own subscription (from `/alpha/billing/subscriptions`) — distinct
- * from {@link KNOWN_PLANS}, which maps catalog models to their minimum tier.
- *
- * `tierWeight` is plugin-added (not from the CLI maps): the plan's rank on
- * the {@link PLAN_ORDER} scale, used by the picker's plan filter
- * ({@link modelVisibleInPlan}) to hide models above the account's tier.
- */
-declare const KNOWN_SUBSCRIPTION_PLANS: Readonly<Record<string, {
-  name: string;
-  monthlyCredits: number;
-  tierWeight: number;
-}>>;
-/**
- * Resolve a subscription `planId` (e.g. `individual-pro-v1`) to its display
- * name and monthly credit total, mirroring the CLI's `getPlanInfo`:
- * normalize (lowercase, `_` → `-`), then longest-prefix match so
- * `individual-pro-v1` wins over `individual-pro`. Unknown ids return
- * `undefined`.
- */
-declare function subscriptionPlanInfo(planId: string): {
-  name: string;
-  monthlyCredits: number;
-  tierWeight: number;
-} | undefined;
-/**
- * The billing facts the picker's plan filter needs, fetched by mirroring the
- * CLI's `createBilling` flow (whoami → orgId, then `/alpha/billing/subscriptions`
- * for the plan id and `/alpha/billing/credits` for the on-demand balances).
- */
-interface CommandCodeBillingAccess {
-  /** Account plan tier weight on the {@link PLAN_ORDER} scale; undefined when the plan is unknown. */
-  tierWeight: number | undefined;
-  /**
-   * Purchased + free on-demand credit balance. The official access model
-   * (`evaluateModelAccess` in the CLI) allows every model when the account
-   * holds any on-demand credits — the plan gate only applies at zero balance.
-   */
-  onDemandCredits: number;
-}
-/**
- * Whether the picker lists `modelId` for an account with the given billing
- * access. Fails open at every uncertainty: no billing data, an unknown plan,
- * or a model outside {@link KNOWN_PLANS} all keep the model visible — the
- * server remains the final gate (`403 MODEL_NOT_IN_PLAN`).
- */
-declare function modelVisibleInPlan(modelId: string, access: CommandCodeBillingAccess | undefined): boolean;
-/**
- * Active pricing deals per the official pricing page
- * (`/docs/resources/pricing-limits#deals`). Each entry records the model's
- * promotional label and — critically — when it expires, so the picker never
- * shows a stale discount after the plugin's snapshot has gone out of date.
- *
- * - `expiresAt` is an ISO timestamp. When it is in the past (checked at
- *   render time against `Date.now()`), the deal label is hidden until the
- *   snapshot is refreshed from the official page. `undefined` means
- *   "no expiry" (permanent).
- * - `free` marks models whose requests cost no credits (Laguna S 2.1), shown
- *   as a `FREE` badge; it degrades to a plain discount once the deal lapses.
- *
- * Keep in sync with the official pricing page when deals change (see the
- * dsh-commandcode-upstream skill).
- */
-interface KnownDeal {
-  /** Promotional label, e.g. "50% off" or "2× usage". */
-  label: string;
-  /** Deal end date (ISO). `undefined` = permanent / no expiry. */
-  expiresAt?: string;
-  /** Model is free (requests cost no credits). */
-  free?: boolean;
-}
-declare const KNOWN_DEALS: Readonly<Record<string, KnownDeal>>;
-/**
- * Models with time-of-day (peak/off-peak) pricing, per the official pricing
- * page (`/docs/resources/pricing-limits`). Since 2026-08-16 16:00 UTC, DeepSeek
- * charges by the hour: peak hours are 01:00–04:00 and 06:00–10:00 UTC (7h/day,
- * full price); the other 17 hours are off-peak at half price. The V4 Flash
- * Vision (exp) variant (command-code@1.32.0) shares the V4 Flash windows and
- * peak prices ($0.44/$1.32) — each row's hover annotation states exactly 2×
- * that row's displayed off-peak prices. The picker shows the
- * *current* state as a compact
- * label (`Peak`/`Half`) matching the English noun style of the other markers
- * (`Image`, `FREE`), so a developer can tell at a glance whether calling the
- * model right now is cheap or expensive.
- *
- * Extraction caution: in the page's HTML each annotation div sits inside its
- * OWN row's container, immediately before the NEXT row starts — flattening
- * the page to text makes every annotation look like it belongs to the model
- * printed after it. Verify membership against the enclosing row and the 2×
- * price relation, not the flat-text neighbor.
- *
- * Keep in sync with the official pricing page when the model set or the peak
- * windows change (see the dsh-commandcode-upstream skill).
- */
-declare const KNOWN_PEAK_PRICING: ReadonlySet<string>;
-/**
- * Whether `now` (defaults to `Date.now()`) falls in a peak-pricing hour for
- * time-of-day-priced models. `undefined` for models outside the snapshot.
- */
-declare function peakPricingState(modelId: string, now?: number): 'peak' | 'off-peak' | undefined;
-/**
- * Compact label for the current peak/off-peak state: `Peak` (full price) or
- * `Half` (off-peak, half price). These English nouns match the picker's other
- * markers (`Go`, `Image`, `FREE`), and since they appear only on time-of-day
- * priced models they double as a "priced by the hour" signal. Returns undefined
- * for models without time-of-day pricing.
- */
-declare function peakPricingLabel(modelId: string, now?: number): string | undefined;
-declare const COMMAND_CODE_CLI_VERSION = "1.40.1";
+declare const COMMAND_CODE_CLI_VERSION = "1.44.0";
 declare const DEFAULT_API_BASE = "https://api.commandcode.ai";
 declare const DEFAULT_GENERATE_MAX_TOKENS = 64000;
 declare const DEFAULT_MAX_OUTPUT_TOKENS = 65536;
@@ -204,33 +17,6 @@ declare const BILLING_ACCESS_TTL_MS: number;
 declare const DEFAULT_REQUEST_TIMEOUT_MS = 60000;
 /** Stream idle timeout: a generation that stalls this long is a dead connection. */
 declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
-/**
- * Official display label for a model's minimum plan, or undefined for models
- * outside the snapshot (e.g. future catalog additions).
- */
-declare function planLabel(modelId: string): string | undefined;
-/**
- * The active deal label for a model, or undefined when the model has no deal
- * or the deal has expired. Expiry is judged against `now` (defaults to
- * `Date.now()`), so a snapshot that has gone stale stops showing its discount
- * the moment the official end date passes — the user never believes a lapsed
- * deal is still live. Permanent deals (no `expiresAt`) never lapse.
- */
-declare function dealLabel(modelId: string, now?: number): string | undefined;
-/**
- * Compact human-readable context window, e.g. `1_000_000 -> "1M"`,
- * `256_000 -> "256K"`, `262_144 -> "256K"` (floor to the nearest K).
- * Returns undefined for unknown/absent sizes.
- */
-declare function formatContext(contextWindow: number | undefined): string | undefined;
-/**
- * Compact one-line summary for the model picker: plan tier, then any active
- * deal (discount or FREE), then the current peak/off-peak state (`Peak`/`Half`)
- * for time-of-day-priced models, then `Image` for Vision-capable models, then
- * the context window. Text-only models simply omit the Image marker — "Text
- * only" adds nothing the picker needs to show.
- */
-declare function capabilityDescription(modelId: string, contextWindow?: number, now?: number): string;
 declare function projectSlugFromPath(pathName: string): string;
 /** Read a usable Command Code credential from the official CLI auth file. */
 declare function resolveAuthFileApiKey(): string | undefined;
@@ -619,6 +405,254 @@ declare class CommandCodeAccountPool {
   private pick;
 }
 //#endregion
+//#region src/capabilities.d.ts
+/**
+ * Static capability snapshot for the Command Code provider: model →
+ * reasoning-effort levels, vision/thinking flags, model → minimum plan tier,
+ * subscription-plan labels, deals, and hourly (peak/off-peak) pricing.
+ *
+ * Everything in this module is synced from official sources (the command-code
+ * CLI bundle's model table and the official plan/pricing/model docs — see the
+ * dsh-commandcode-upstream skill for the exact extraction procedures), and
+ * changes whenever an upstream CLI release reshuffles models/plans/prices.
+ * Keeping the snapshot in its own module confines those frequent sync diffs
+ * here: src/adapter.ts holds only the stable wire/runtime logic and imports
+ * these tables + read helpers.
+ *
+ * Snapshot read helpers (planLabel, dealLabel, formatContext,
+ * capabilityDescription, peakPricing*, compareByPlan, modelVisibleInPlan,
+ * subscriptionPlanInfo, isFreeModel) live here too — they exist only to read
+ * the tables, so a sync never has to touch src/adapter.ts.
+ *
+ * Ported from pi-commandcode-provider (MIT); originally part of src/adapter.ts
+ * and split out so upstream syncs stay reviewable.
+ */
+declare const KNOWN_EFFORTS: Readonly<Record<string, readonly string[]>>;
+/**
+ * Models whose Capabilities include Vision, per the official Command Code
+ * model registry (`https://commandcode.ai/docs/reference/cli/models`, generated
+ * from the same registry as `cmd --list-models` / the `/model` picker).
+ *
+ * The Provider API does not expose modality metadata, so this snapshot is the
+ * source of truth for image-input gating. Command Code's own CLI falls back to
+ * a client-side VISION side-call for text-only models; this adapter does not
+ * reproduce that interactive feature, so images sent to a model outside this
+ * list are refused loudly (`UNSUPPORTED_CONTENT`) instead of being dropped or
+ * sent to a model that cannot read them.
+ *
+ * Keep in sync with the official registry when new models ship (see the
+ * dsh-commandcode-upstream skill).
+ */
+declare const KNOWN_IMAGE_MODELS: ReadonlySet<string>;
+/**
+ * Models the official CLI's model table (command-code@1.44.0) marks
+ * `reasoning:!0` but defines no selectable `reasoning_effort` levels — they
+ * think automatically, with Command Code driving the depth. This is the
+ * authoritative "thinks, effort not adjustable" set: `KNOWN_EFFORTS` (which
+ * mirrors the CLI's effort map exactly) stays the sole source for selectable
+ * effort levels, and this snapshot is not surfaced in the picker's compact
+ * description — it exists for programmatic consumers.
+ *
+ * Source: the command-code@1.44.0 bundled model table (dist/cli.mjs),
+ * cross-checked with https://commandcode.ai/docs/reference/cli/models.
+ * (`stealth/ox-alpha` left this set in command-code@1.32.1, which gave it
+ * selectable `['low', 'high', 'max']` efforts; the preview then ended in
+ * 1.34.0, removing the model from the catalog entirely. `tencent/hy4-preview`
+ * joined this set in command-code@1.37.0 — reasoning:!0, no efforts, 1M
+ * context, routed through OpenRouter — then gained selectable
+ * `['low', 'medium', 'high']` efforts in command-code@1.38.0 and moved to
+ * `KNOWN_EFFORTS`. `moonshotai/Kimi-K3` followed the same path in
+ * command-code@1.39.3 — it gained `['low', 'high', 'max']` efforts and moved
+ * to `KNOWN_EFFORTS`. command-code@1.42.0 added `meituan/LongCat-2.0:free`
+ * (reasoning:!0, no efforts) and command-code@1.44.0 added both
+ * `meta/muse-spark-1.3` variants — all think automatically with no
+ * selectable levels.)
+ * Keep in sync via the dsh-commandcode-upstream skill.
+ */
+declare const KNOWN_THINKING_MODELS: ReadonlySet<string>;
+/**
+ * The minimum subscription plan a model is included in, per the official plan
+ * pages (`/docs/plans/go`, `/docs/plans/goat`, `/docs/plans/pro`, `/docs/plans/max`
+ * and `/docs/resources/pricing-limits`). Each plan's model list is a superset of
+ * the one below it: Go ⊂ GOAT ⊂ Pro ⊂ Provider/Max. Models absent from every
+ * plan list (Claude Opus/Fable, Fugu Ultra) are Provider-tier.
+ * `claude-fable-5-1` (Claude Fable 5.1, added in command-code@1.40.0) is
+ * Provider/Max-tier exactly like `claude-fable-5` — its availability matrix on
+ * the official plan/pricing pages grants individual-provider/max/ultra and
+ * teams-pro only, and the CLI's plan-access map blocks it on Go/GOAT/Pro.
+ * command-code@1.41.0 added `Qwen/Qwen3.8-Max-0902` (Go) and 1.42.0 added
+ * `meituan/LongCat-2.0:free` (Go, free promo); command-code@1.43.0 added
+ * `google/gemini-3.8-flash` (GOAT) and 1.44.0 added `meta/muse-spark-1.3`
+ * (GOAT) plus its Contributor sibling (Go).
+ *
+ * The Provider API exposes no plan metadata, so this snapshot is the source of
+ * truth for the picker's plan annotation — it answers "which plan do I need to
+ * actually use this model?" at a glance. Plan labels use the official tier
+ * names (`Go`, `GOAT`, `Pro`, `Provider`), with `Max` implying Provider.
+ *
+ * Keep in sync with the official plan pages when they change (see the
+ * dsh-commandcode-upstream skill).
+ */
+declare const KNOWN_PLANS: Readonly<Record<string, string>>;
+/** Official display labels for each plan tier. */
+declare const PLAN_LABELS: Readonly<Record<string, string>>;
+/**
+ * Plan-tier sort weights, low to high. Models outside the snapshot (unknown
+ * plans) sort after every known tier, keeping known models predictable.
+ */
+declare const PLAN_ORDER: Readonly<Record<string, number>>;
+/**
+ * Comparator for the model picker: free models first (zero credit cost, usable
+ * by every account), then by plan tier (lowest first), then by model name,
+ * then by id as a tiebreak. Models with no known plan sort last.
+ */
+declare function compareByPlan(a: {
+  id: string;
+  name: string;
+}, b: {
+  id: string;
+  name: string;
+}): number;
+/**
+ * Subscription plan table, synced from the official CLI bundle's plan maps
+ * (`Nn`/`$n` in command-code@1.31.0 `dist/cli.mjs`, re-verified unchanged
+ * against 1.32.2 where they appear as `Zn`/`er`): subscription `planId`
+ * prefix → display name and the plan's monthly credit total. This is the
+ * account's own subscription (from `/alpha/billing/subscriptions`) — distinct
+ * from {@link KNOWN_PLANS}, which maps catalog models to their minimum tier.
+ *
+ * `tierWeight` is plugin-added (not from the CLI maps): the plan's rank on
+ * the {@link PLAN_ORDER} scale, used by the picker's plan filter
+ * ({@link modelVisibleInPlan}) to hide models above the account's tier.
+ */
+declare const KNOWN_SUBSCRIPTION_PLANS: Readonly<Record<string, {
+  name: string;
+  monthlyCredits: number;
+  tierWeight: number;
+}>>;
+/**
+ * Resolve a subscription `planId` (e.g. `individual-pro-v1`) to its display
+ * name and monthly credit total, mirroring the CLI's `getPlanInfo`:
+ * normalize (lowercase, `_` → `-`), then longest-prefix match so
+ * `individual-pro-v1` wins over `individual-pro`. Unknown ids return
+ * `undefined`.
+ */
+declare function subscriptionPlanInfo(planId: string): {
+  name: string;
+  monthlyCredits: number;
+  tierWeight: number;
+} | undefined;
+/**
+ * The billing facts the picker's plan filter needs, fetched by mirroring the
+ * CLI's `createBilling` flow (whoami → orgId, then `/alpha/billing/subscriptions`
+ * for the plan id and `/alpha/billing/credits` for the on-demand balances).
+ */
+interface CommandCodeBillingAccess {
+  /** Account plan tier weight on the {@link PLAN_ORDER} scale; undefined when the plan is unknown. */
+  tierWeight: number | undefined;
+  /**
+   * Purchased + free on-demand credit balance. The official access model
+   * (`evaluateModelAccess` in the CLI) allows every model when the account
+   * holds any on-demand credits — the plan gate only applies at zero balance.
+   */
+  onDemandCredits: number;
+}
+/**
+ * Whether the picker lists `modelId` for an account with the given billing
+ * access. Fails open at every uncertainty: no billing data, an unknown plan,
+ * or a model outside {@link KNOWN_PLANS} all keep the model visible — the
+ * server remains the final gate (`403 MODEL_NOT_IN_PLAN`).
+ */
+declare function modelVisibleInPlan(modelId: string, access: CommandCodeBillingAccess | undefined): boolean;
+/**
+ * Active pricing deals per the official pricing page
+ * (`/docs/resources/pricing-limits#deals`). Each entry records the model's
+ * promotional label and — critically — when it expires, so the picker never
+ * shows a stale discount after the plugin's snapshot has gone out of date.
+ *
+ * - `expiresAt` is an ISO timestamp. When it is in the past (checked at
+ *   render time against `Date.now()`), the deal label is hidden until the
+ *   snapshot is refreshed from the official page. `undefined` means
+ *   "no expiry" (permanent).
+ * - `free` marks models whose requests cost no credits (Laguna S 2.1), shown
+ *   as a `FREE` badge; it degrades to a plain discount once the deal lapses.
+ *
+ * Keep in sync with the official pricing page when deals change (see the
+ * dsh-commandcode-upstream skill).
+ */
+interface KnownDeal {
+  /** Promotional label, e.g. "50% off" or "2× usage". */
+  label: string;
+  /** Deal end date (ISO). `undefined` = permanent / no expiry. */
+  expiresAt?: string;
+  /** Model is free (requests cost no credits). */
+  free?: boolean;
+}
+declare const KNOWN_DEALS: Readonly<Record<string, KnownDeal>>;
+/**
+ * Models with time-of-day (peak/off-peak) pricing, per the official pricing
+ * page (`/docs/resources/pricing-limits`). Since 2026-08-16 16:00 UTC, DeepSeek
+ * charges by the hour: peak hours are 01:00–04:00 and 06:00–10:00 UTC (7h/day,
+ * full price); the other 17 hours are off-peak at half price. The V4 Flash
+ * Vision (exp) variant (command-code@1.32.0) shares the V4 Flash windows and
+ * peak prices ($0.44/$1.32) — each row's hover annotation states exactly 2×
+ * that row's displayed off-peak prices. The picker shows the
+ * *current* state as a compact
+ * label (`Peak`/`Half`) matching the English noun style of the other markers
+ * (`Image`, `FREE`), so a developer can tell at a glance whether calling the
+ * model right now is cheap or expensive.
+ *
+ * Extraction caution: in the page's HTML each annotation div sits inside its
+ * OWN row's container, immediately before the NEXT row starts — flattening
+ * the page to text makes every annotation look like it belongs to the model
+ * printed after it. Verify membership against the enclosing row and the 2×
+ * price relation, not the flat-text neighbor.
+ *
+ * Keep in sync with the official pricing page when the model set or the peak
+ * windows change (see the dsh-commandcode-upstream skill).
+ */
+declare const KNOWN_PEAK_PRICING: ReadonlySet<string>;
+/**
+ * Whether `now` (defaults to `Date.now()`) falls in a peak-pricing hour for
+ * time-of-day-priced models. `undefined` for models outside the snapshot.
+ */
+declare function peakPricingState(modelId: string, now?: number): 'peak' | 'off-peak' | undefined;
+/**
+ * Compact label for the current peak/off-peak state: `Peak` (full price) or
+ * `Half` (off-peak, half price). These English nouns match the picker's other
+ * markers (`Go`, `Image`, `FREE`), and since they appear only on time-of-day
+ * priced models they double as a "priced by the hour" signal. Returns undefined
+ * for models without time-of-day pricing.
+ */
+declare function peakPricingLabel(modelId: string, now?: number): string | undefined;
+/**
+ * Official display label for a model's minimum plan, or undefined for models
+ * outside the snapshot (e.g. future catalog additions).
+ */
+declare function planLabel(modelId: string): string | undefined;
+/**
+ * The active deal label for a model, or undefined when the model has no deal
+ * or the deal has expired. Expiry is judged against `now` (defaults to
+ * `Date.now()`), so a snapshot that has gone stale stops showing its discount
+ * the moment the official end date passes — the user never believes a lapsed
+ * deal is still live. Permanent deals (no `expiresAt`) never lapse.
+ */
+declare function dealLabel(modelId: string, now?: number): string | undefined;
+/**
+ * Compact human-readable context window, e.g. `1_000_000 -> "1M"`,
+ * `256_000 -> "256K"`, `262_144 -> "256K"` (floor to the nearest K).
+ * Returns undefined for unknown/absent sizes.
+ */
+declare function formatContext(contextWindow: number | undefined): string | undefined;
+/**
+ * Compact one-line summary for the model picker: plan tier, then any active
+ * deal (discount or FREE), then the current peak/off-peak state (`Peak`/`Half`)
+ * for time-of-day-priced models, then `Image` for Vision-capable models, then
+ * the context window. Text-only models simply omit the Image marker — "Text
+ * only" adds nothing the picker needs to show.
+ */
+declare function capabilityDescription(modelId: string, contextWindow?: number, now?: number): string;
+//#endregion
 //#region src/usage-wire.d.ts
 /** One account's usage entry in the multi-account report. */
 interface CommandCodeAccountUsage {