@molecule/api-resource-ai-models 1.2.1 → 1.2.3

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-08-13T22:10:11.926Z
+Generated: 2026-08-18T03:40:46.175Z
 -->
 
 # @molecule/api-resource-ai-models
@@ -789,12 +789,12 @@ Sources (verified 2026-07-28; OpenAI re-verified 2026-07-31 after the
   grok-4.3 still served at $1.25/$2.50 with the bigger 1M window;
   grok-code-fast-1 no longer listed — retires 2026-08-15)
 - DeepSeek: https://api-docs.deepseek.com/quick_start/pricing (verified
-  2026-08-14; legacy deepseek-chat/-reasoner ids fully retired 2026-07-24 —
-  never in this catalog. V4-Pro GA on 2026-08-13 came with a price RISE
-  effective 2026-08-16T16:00Z plus the long-announced peak-hour 2×: both
-  entries carry it as `scheduledPricing`, so today's rates bill until that
-  instant and the new ones after. Re-verify weekday-vs-daily peak windows and
-  the CN/US region default once it lands — see the entries.)
+  2026-08-18; legacy deepseek-chat/-reasoner ids fully retired 2026-07-24 —
+  never in this catalog. The V4-Pro-GA price RISE effective 2026-08-16T16:00Z
+  has LANDED and is folded into the base fields, along with the peak-hour 2×
+  the same card introduced. The rate card gives the peak windows as
+  "01:00 - 04:00 and 06:00 - 10:00 UTC (all other hours are off-peak)" with
+  no day qualifier — DAILY, as `peakPricing` models them.)
 - Moonshot: https://platform.kimi.ai/docs/models + DeepInfra's model API for
   the US re-host (kimi-k3 flagship 2026-07-16
   — 2.8T MoE, 1M ctx, $3/$15 — NOT added: thinking is forced-on with
@@ -817,6 +817,16 @@ Sources (verified 2026-07-28; OpenAI re-verified 2026-07-31 after the
   125%) — the EN edition of that doc simply lags (zero qwen3.8 mentions),
   which an earlier pass misread as "excepted/console-only". qwen3.7-max
   still runs its 50%-off promo — billed here at list, $2.50/$7.50)
+  (re-verified 2026-08-15 against api.deepinfra.com/models/: qwen3.8-max's US
+  re-host rates are unchanged — $1.65/$4.951, cache read 0.1248× input =
+  $0.206. DeepInfra also began serving `Qwen/Qwen3.8-2.4T-A95B` on
+  2026-08-12; by DeepInfra's own description it is the OPEN-WEIGHT variant of
+  Qwen3.8 Max (2.4T MoE, 95B active), 262,144 ctx / 131,072 out, $2/$6 with
+  cache read 0.1× input. NOT added: it is the same tier as qwen3.8-max, which
+  the catalog already offers, and it costs MORE on that very host ($2/$6 vs
+  $1.65/$4.951), so nothing would ever select it — and carrying both would
+  put two selectable Alibaba flagships in one family. Revisit only if Alibaba
+  publishes it as a distinct first-party DashScope model id.)
 - Zhipu: https://docs.z.ai/guides/overview/pricing (unchanged; glm-5.2 is
   the newest — "GLM-5.3/5.5" rumors have no released ids as of 2026-07-28)
 

package/dist/models.d.ts

@@ -73,12 +73,12 @@ import type { ModelDefinition } from './types.js';
  *   grok-4.3 still served at $1.25/$2.50 with the bigger 1M window;
  *   grok-code-fast-1 no longer listed — retires 2026-08-15)
  * - DeepSeek: https://api-docs.deepseek.com/quick_start/pricing (verified
- *   2026-08-14; legacy deepseek-chat/-reasoner ids fully retired 2026-07-24 —
- *   never in this catalog. V4-Pro GA on 2026-08-13 came with a price RISE
- *   effective 2026-08-16T16:00Z plus the long-announced peak-hour 2×: both
- *   entries carry it as `scheduledPricing`, so today's rates bill until that
- *   instant and the new ones after. Re-verify weekday-vs-daily peak windows and
- *   the CN/US region default once it lands — see the entries.)
+ *   2026-08-18; legacy deepseek-chat/-reasoner ids fully retired 2026-07-24 —
+ *   never in this catalog. The V4-Pro-GA price RISE effective 2026-08-16T16:00Z
+ *   has LANDED and is folded into the base fields, along with the peak-hour 2×
+ *   the same card introduced. The rate card gives the peak windows as
+ *   "01:00 - 04:00 and 06:00 - 10:00 UTC (all other hours are off-peak)" with
+ *   no day qualifier — DAILY, as `peakPricing` models them.)
  * - Moonshot: https://platform.kimi.ai/docs/models + DeepInfra's model API for
  *   the US re-host (kimi-k3 flagship 2026-07-16
  *   — 2.8T MoE, 1M ctx, $3/$15 — NOT added: thinking is forced-on with
@@ -101,6 +101,16 @@ import type { ModelDefinition } from './types.js';
  *   125%) — the EN edition of that doc simply lags (zero qwen3.8 mentions),
  *   which an earlier pass misread as "excepted/console-only". qwen3.7-max
  *   still runs its 50%-off promo — billed here at list, $2.50/$7.50)
+ *   (re-verified 2026-08-15 against api.deepinfra.com/models/: qwen3.8-max's US
+ *   re-host rates are unchanged — $1.65/$4.951, cache read 0.1248× input =
+ *   $0.206. DeepInfra also began serving `Qwen/Qwen3.8-2.4T-A95B` on
+ *   2026-08-12; by DeepInfra's own description it is the OPEN-WEIGHT variant of
+ *   Qwen3.8 Max (2.4T MoE, 95B active), 262,144 ctx / 131,072 out, $2/$6 with
+ *   cache read 0.1× input. NOT added: it is the same tier as qwen3.8-max, which
+ *   the catalog already offers, and it costs MORE on that very host ($2/$6 vs
+ *   $1.65/$4.951), so nothing would ever select it — and carrying both would
+ *   put two selectable Alibaba flagships in one family. Revisit only if Alibaba
+ *   publishes it as a distinct first-party DashScope model id.)
  * - Zhipu: https://docs.z.ai/guides/overview/pricing (unchanged; glm-5.2 is
  *   the newest — "GLM-5.3/5.5" rumors have no released ids as of 2026-07-28)
  *

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAk6CnC,CAAA"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAi5CnC,CAAA"}

package/dist/models.js

@@ -72,12 +72,12 @@
  *   grok-4.3 still served at $1.25/$2.50 with the bigger 1M window;
  *   grok-code-fast-1 no longer listed — retires 2026-08-15)
  * - DeepSeek: https://api-docs.deepseek.com/quick_start/pricing (verified
- *   2026-08-14; legacy deepseek-chat/-reasoner ids fully retired 2026-07-24 —
- *   never in this catalog. V4-Pro GA on 2026-08-13 came with a price RISE
- *   effective 2026-08-16T16:00Z plus the long-announced peak-hour 2×: both
- *   entries carry it as `scheduledPricing`, so today's rates bill until that
- *   instant and the new ones after. Re-verify weekday-vs-daily peak windows and
- *   the CN/US region default once it lands — see the entries.)
+ *   2026-08-18; legacy deepseek-chat/-reasoner ids fully retired 2026-07-24 —
+ *   never in this catalog. The V4-Pro-GA price RISE effective 2026-08-16T16:00Z
+ *   has LANDED and is folded into the base fields, along with the peak-hour 2×
+ *   the same card introduced. The rate card gives the peak windows as
+ *   "01:00 - 04:00 and 06:00 - 10:00 UTC (all other hours are off-peak)" with
+ *   no day qualifier — DAILY, as `peakPricing` models them.)
  * - Moonshot: https://platform.kimi.ai/docs/models + DeepInfra's model API for
  *   the US re-host (kimi-k3 flagship 2026-07-16
  *   — 2.8T MoE, 1M ctx, $3/$15 — NOT added: thinking is forced-on with
@@ -100,6 +100,16 @@
  *   125%) — the EN edition of that doc simply lags (zero qwen3.8 mentions),
  *   which an earlier pass misread as "excepted/console-only". qwen3.7-max
  *   still runs its 50%-off promo — billed here at list, $2.50/$7.50)
+ *   (re-verified 2026-08-15 against api.deepinfra.com/models/: qwen3.8-max's US
+ *   re-host rates are unchanged — $1.65/$4.951, cache read 0.1248× input =
+ *   $0.206. DeepInfra also began serving `Qwen/Qwen3.8-2.4T-A95B` on
+ *   2026-08-12; by DeepInfra's own description it is the OPEN-WEIGHT variant of
+ *   Qwen3.8 Max (2.4T MoE, 95B active), 262,144 ctx / 131,072 out, $2/$6 with
+ *   cache read 0.1× input. NOT added: it is the same tier as qwen3.8-max, which
+ *   the catalog already offers, and it costs MORE on that very host ($2/$6 vs
+ *   $1.65/$4.951), so nothing would ever select it — and carrying both would
+ *   put two selectable Alibaba flagships in one family. Revisit only if Alibaba
+ *   publishes it as a distinct first-party DashScope model id.)
  * - Zhipu: https://docs.z.ai/guides/overview/pricing (unchanged; glm-5.2 is
  *   the newest — "GLM-5.3/5.5" rumors have no released ids as of 2026-07-28)
  *
@@ -886,35 +896,31 @@ export const MODELS = [
     // DeepSeek
     // Verified: https://api-docs.deepseek.com/quick_start/pricing
     //           https://api-docs.deepseek.com/guides/thinking_mode
-    //           https://api-docs.deepseek.com/updates/ (2026-08-14)
+    //           https://api-docs.deepseek.com/updates/ (2026-08-18)
     // 2026-08-13: V4-Pro GA — and with it the price rise that the "coming soon"
-    // note below had been waiting on. It is STAGED, not applied: both models
-    // carry `scheduledPricing` effective 2026-08-16T16:00Z, so the catalog bills
-    // today's verified rates until that instant and the new ones after it, with
-    // nobody landing an edit at 16:00 UTC on a Sunday. The new card is
-    // off-peak/peak (peak = exactly 2× off-peak), so it maps onto base rates +
-    // `peakPricing` multiplier 2 — which is why the peak windows removed below
-    // come back here rather than as flat rates.
+    // note below had been waiting on. It was staged as `scheduledPricing`
+    // effective 2026-08-16T16:00Z; that instant has PASSED and the rates are now
+    // folded into the base fields, re-verified 2026-08-18 against the live rate
+    // card. The card is off-peak/peak with peak exactly 2× off-peak, so it maps
+    // onto base rates + `peakPricing` multiplier 2 — which is why the peak
+    // windows removed in July come back here rather than as flat rates.
     //   pro   off-peak 0.66 / 1.98, cache hit 0.022  (peak 1.32 / 3.96 / 0.044)
     //   flash off-peak 0.22 / 0.66, cache hit 0.007  (peak 0.44 / 1.32 / 0.014)
-    // Cache HITS are the real move — pro 0.003625 → 0.022 (6.1×) off-peak, 0.044
-    // (12.1×) at peak — and agentic input is ~94% cache hits, so effective input
-    // cost rises far more than the list prices suggest. Both are free-tier models
-    // (flash is `freeTier`, pro is the free-tier planner) on the CN default.
-    // TWO things to re-verify once it lands (2026-08-17):
-    //   1. WEEKDAYS OR DAILY. The rate card says only "Peak hours are 01:00 -
-    //      04:00 and 06:00 - 10:00 UTC (all other hours are off-peak)" with no
-    //      day qualifier, so the windows below are DAILY per the provider's own
-    //      doc; press coverage described them as weekday-only. `peakPricing` has
-    //      no day-of-week concept, so if it is weekday-only this over-bills every
-    //      weekend peak window and needs the field extended, not the numbers
-    //      nudged.
-    //   2. THE CN-VS-US DEFAULT. `regions: ['cn', 'us']` defaults to CN on an
-    //      owner decision (2026-08-01) taken when CN ran ~5.7× cheaper on real
-    //      traffic. Post-change DeepInfra's US flash rates (0.08/0.18/0.016) are
-    //      BELOW CN's new off-peak on both input and output — CN wins only on
-    //      cache reads. Re-derive against measured cache-hit ratios before
-    //      leaving the default where it is.
+    // Cache HITS were the real move — pro 0.003625 → 0.022 (6.1×) off-peak,
+    // 0.044 (12.1×) at peak — and agentic input is ~94% cache hits, so effective
+    // input cost rose far more than the list prices suggest. Both are free-tier
+    // models (flash is `freeTier`, pro is the free-tier planner).
+    // The two post-landing re-verifications, both settled 2026-08-18:
+    //   1. WEEKDAYS OR DAILY — DAILY. The rate card still says only "Peak hours
+    //      are 01:00 - 04:00 and 06:00 - 10:00 UTC (all other hours are
+    //      off-peak)" with no day qualifier (press coverage had described them as
+    //      weekday-only). `peakPricing` has no day-of-week concept, so if the
+    //      provider ever qualifies these by day this over-bills every weekend
+    //      peak window and needs the FIELD extended, not the numbers nudged.
+    //   2. THE CN-VS-US DEFAULT — settled per model, and they differ. Post-rise
+    //      DeepInfra's US flash rates (0.08/0.18/0.016) are BELOW CN's off-peak
+    //      on both input and output, so Flash defaults US; Pro's US re-host still
+    //      bills ~2.3× its native card, so Pro stays CN. See each entry.
     // 2026-07-31: DeepSeek-V4-Flash OFFICIAL API launched in public beta — the
     // SAME `deepseek-v4-flash` id now serves the re-post-trained 0731 build
     // (same architecture/size; much stronger agent benchmarks — beats
@@ -944,11 +950,13 @@ export const MODELS = [
         supportsVision: false,
         supportsPromptCaching: true,
         supportsTools: true,
-        inputPricePerMTok: 0.435,
-        outputPricePerMTok: 0.87,
+        // Off-peak rates; peak is `peakPricing.multiplier` × these (see below).
+        inputPricePerMTok: 0.66,
+        outputPricePerMTok: 1.98,
         // DeepSeek automatic context cache: absolute cache-hit price ($/M).
-        cacheReadPricePerMTok: 0.003625,
-        cacheWritePricePerMTok: 0.435,
+        cacheReadPricePerMTok: 0.022,
+        // DeepSeek charges no cache-write premium — write bills at input.
+        cacheWritePricePerMTok: 0.66,
         // Native-China DEFAULT (owner decision 2026-08-01, re-derived 2026-08-14):
         // the US re-host (DeepInfra) bills ~3× list and ~28× cache reads, and
         // agentic input is ~94% cache hits, so US processing ran ~5.7× native on
@@ -972,28 +980,18 @@ export const MODELS = [
         regionPricing: {
             us: { inputPricePerMTok: 1.3, outputPricePerMTok: 2.6, cacheReadPricePerMTok: 0.1 },
         },
-        // The peak-hour 2× surcharge is now ON the rate card with a dated switch
-        // (2026-08-13 announcement, effective 2026-08-16T16:00Z) — so it is staged
-        // below rather than live. The previously pre-wired windows had been REMOVED
-        // for over-billing every peak-window turn 2× for weeks against a rate card
-        // that showed a single flat rate; staging is what keeps this from repeating
-        // in the other direction. Peak = 01:00-04:00 and 06:00-10:00 UTC (Beijing
-        // business hours), which is 2× the off-peak rates exactly.
-        scheduledPricing: {
-            effectiveFrom: '2026-08-16T16:00:00Z',
-            inputPricePerMTok: 0.66,
-            outputPricePerMTok: 1.98,
-            cacheReadPricePerMTok: 0.022,
-            // DeepSeek charges no cache-write premium — write bills at input.
-            cacheWritePricePerMTok: 0.66,
-            peakPricing: {
-                windows: [
-                    { startMinuteUtc: 60, endMinuteUtc: 240 },
-                    { startMinuteUtc: 360, endMinuteUtc: 600 },
-                ],
-                multiplier: 2,
-            },
-            source: 'https://api-docs.deepseek.com/quick_start/pricing/',
+        // The peak-hour 2× surcharge is ON the rate card and LIVE since
+        // 2026-08-16T16:00Z. Peak = 01:00-04:00 and 06:00-10:00 UTC (Beijing
+        // business hours), daily, at exactly 2× the off-peak rates above. Windows
+        // like these were once pre-wired ahead of the card and over-billed every
+        // peak-window turn for weeks — hence the rule that they only exist here
+        // once the provider's own page shows them, which it now does.
+        peakPricing: {
+            windows: [
+                { startMinuteUtc: 60, endMinuteUtc: 240 },
+                { startMinuteUtc: 360, endMinuteUtc: 600 },
+            ],
+            multiplier: 2,
         },
         // Not published by DeepSeek — best-effort estimate.
         knowledgeCutoff: '2025-07-01',
@@ -1017,11 +1015,13 @@ export const MODELS = [
         // executor — the model the IDE picks when none is chosen. Exactly one model
         // in this catalog may carry freeTier (enforced by lookup.test.ts).
         freeTier: true,
-        inputPricePerMTok: 0.14,
-        outputPricePerMTok: 0.28,
+        // Off-peak rates; peak is `peakPricing.multiplier` × these (see below).
+        inputPricePerMTok: 0.22,
+        outputPricePerMTok: 0.66,
         // DeepSeek automatic context cache: absolute cache-hit price ($/M).
-        cacheReadPricePerMTok: 0.0028,
-        cacheWritePricePerMTok: 0.14,
+        cacheReadPricePerMTok: 0.007,
+        // DeepSeek charges no cache-write premium — write bills at input.
+        cacheWritePricePerMTok: 0.22,
         // US (DeepInfra) DEFAULT as of 2026-08-16 — flipped from CN when DeepSeek's
         // rise landed (owner decision 2026-08-14). CN was cheaper on real traffic
         // only because of its cache reads; the rise takes those from $0.0028 to
@@ -1043,22 +1043,15 @@ export const MODELS = [
         regionPricing: {
             us: { inputPricePerMTok: 0.08, outputPricePerMTok: 0.18, cacheReadPricePerMTok: 0.016 },
         },
-        // Peak-hour surcharge staged, not live (see deepseek-v4-pro).
-        scheduledPricing: {
-            effectiveFrom: '2026-08-16T16:00:00Z',
-            inputPricePerMTok: 0.22,
-            outputPricePerMTok: 0.66,
-            cacheReadPricePerMTok: 0.007,
-            // DeepSeek charges no cache-write premium — write bills at input.
-            cacheWritePricePerMTok: 0.22,
-            peakPricing: {
-                windows: [
-                    { startMinuteUtc: 60, endMinuteUtc: 240 },
-                    { startMinuteUtc: 360, endMinuteUtc: 600 },
-                ],
-                multiplier: 2,
-            },
-            source: 'https://api-docs.deepseek.com/quick_start/pricing/',
+        // Peak-hour surcharge live since 2026-08-16T16:00Z (see deepseek-v4-pro).
+        // It applies to the NATIVE CN card only — this model defaults to the US
+        // re-host, which is flat, so most turns never take it.
+        peakPricing: {
+            windows: [
+                { startMinuteUtc: 60, endMinuteUtc: 240 },
+                { startMinuteUtc: 360, endMinuteUtc: 600 },
+            ],
+            multiplier: 2,
         },
         // Not published by DeepSeek — best-effort estimate.
         knowledgeCutoff: '2025-07-01',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-resource-ai-models",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "AI model catalog — server-side source of truth plus an authentication-gated discovery endpoint",
   "type": "module",
   "main": "dist/index.js",