@mars-sea/dsh-commandcode-provider 0.6.0 → 0.6.2

package/lib/index.d.ts

@@ -24,7 +24,7 @@ declare const KNOWN_EFFORTS: Readonly<Record<string, readonly string[]>>;
  */
 declare const KNOWN_IMAGE_MODELS: ReadonlySet<string>;
 /**
- * Models the official CLI's model table (`ZA` in command-code@1.28.4) marks
+ * Models the official CLI's model table (`ZA` in command-code@1.31.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
@@ -32,7 +32,7 @@ declare const KNOWN_IMAGE_MODELS: ReadonlySet<string>;
  * effort levels, and this snapshot is not surfaced in the picker's compact
  * description — it exists for programmatic consumers.
  *
- * Source: the command-code@1.28.4 bundled model table (dist/cli.mjs, the `ZA`
+ * Source: the command-code@1.31.0 bundled model table (dist/cli.mjs, the `ZA`
  * object), cross-checked with https://commandcode.ai/docs/reference/cli/models.
  * Keep in sync via the dsh-commandcode-upstream skill.
  */
@@ -61,8 +61,9 @@ declare const PLAN_LABELS: Readonly<Record<string, string>>;
  */
 declare const PLAN_ORDER: Readonly<Record<string, number>>;
 /**
- * Comparator for the model picker: sort by plan tier (lowest first), then by
- * model name, then by id as a tiebreak. Models with no known plan sort last.
+ * 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;
@@ -73,7 +74,7 @@ declare function compareByPlan(a: {
 }): number;
 /**
  * Subscription plan table, synced from the official CLI bundle's plan maps
- * (`Nn`/`$n` in command-code@1.28.4 `dist/cli.mjs`): subscription `planId`
+ * (`Nn`/`$n` in command-code@1.31.0 `dist/cli.mjs`): 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.
@@ -172,7 +173,7 @@ declare function peakPricingState(modelId: string, now?: number): 'peak' | 'off-
  * for models without time-of-day pricing.
  */
 declare function peakPricingLabel(modelId: string, now?: number): string | undefined;
-declare const COMMAND_CODE_CLI_VERSION = "1.28.4";
+declare const COMMAND_CODE_CLI_VERSION = "1.31.0";
 declare const DEFAULT_API_BASE = "https://api.commandcode.ai";
 declare const DEFAULT_GENERATE_MAX_TOKENS = 64000;
 declare const DEFAULT_MAX_OUTPUT_TOKENS = 65536;
@@ -313,6 +314,12 @@ interface CommandCodePlan {
   /** Billing period end in millis; 0 when the endpoint did not report one. */
   currentPeriodEnd: number;
 }
+/**
+ * Why every account endpoint failed at once (the report then carries no data
+ * at all, so the degraded per-endpoint view would hide the root cause behind
+ * a generic "partial data" note). Undefined for partial failures.
+ */
+type UsageBlockReason = 'invalid-key' | 'service-unavailable' | 'network';
 /** Everything the usage endpoints report, fetched together. */
 interface CommandCodeUsageReport {
   account?: CommandCodeAccount;
@@ -321,6 +328,13 @@ interface CommandCodeUsageReport {
   plan?: CommandCodePlan;
   /** Endpoint failures degrade the report instead of failing it. */
   failures: string[];
+  /**
+   * The single reason every endpoint failed, when they all did: `invalid-key`
+   * (every call rejected with 401 — the stored key is wrong or expired),
+   * `service-unavailable` (every call answered 5xx), or `network` (no HTTP
+   * response at all). Undefined when any endpoint succeeded.
+   */
+  blocked?: UsageBlockReason;
 }
 declare class CommandCodeAdapter<C extends CommandCodeConnectionOptions = CommandCodeConnectionOptions> extends LlmAdapter {
   private readonly deps;
@@ -331,12 +345,21 @@ declare class CommandCodeAdapter<C extends CommandCodeConnectionOptions = Comman
   private readonly billingAccessInflight;
   constructor(deps: CommandCodeAdapterDeps<C>);
   /**
-   * Command Code is a metered subscription API: 429 (rate limit) and 5xx
-   * (transient server errors) are worth retrying at the agent-step boundary,
-   * which is where dsh-llm-retry executes the policy returned here. The
-   * default policy already retries `RATE_LIMIT` and `SERVER`; declaring it
-   * explicitly documents the intent and gives the plugin entry a stable hook
-   * to override (e.g. a stricter cap for a metered plan).
+   * Near-unbounded retry for transient failures only (`mode: 'normal'` with
+   * an explicit 1000-attempt cap — opencode-style persistence without the
+   * unbounded loop): `RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/
+   * `EMPTY_RESPONSE` retry up to 1000 times with waits doubling from 500 ms
+   * and capping at 15 minutes (±10% jitter), so an exhausted 5-hour window
+   * recovers in-session instead of failing after two tries. Permanent
+   * failures (an invalid key's `INVALID_CREDENTIAL`, `UNSUPPORTED_CONTENT`,
+   * plan rejections) are absent from the whitelist and surface immediately
+   * instead of looping. Waits the pool/adapter attach as
+   * `providerRetryAfterMs` are honored verbatim at or below the 15-minute
+   * cap and never attached above it (in normal mode a longer attached wait
+   * makes the executor abandon the retry outright — see RETRY_MAX_DELAY_MS).
+   *
+   * Captured once at route registration (dsh-llm snapshots this value), so a
+   * future config knob for it would apply on profile restart, not per request.
    */
   providerRetryPolicy(_provider: string): ResolvedRetryPolicy;
   /** Refresh the catalog (live fetch, cache fallback) and return it. */