@molecule/api-resource-ai-models 1.2.2 → 1.2.4

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-15T19:37:59.137Z
+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

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

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;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,EAo5CnC,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
@@ -480,6 +480,11 @@ export const MODELS = [
         // Cached input 0.1× input; write premium reported 1.25× (see section note).
         cacheReadPricePerMTok: 0.02,
         cacheWritePricePerMTok: 0.25,
+        // The free-tier PLAN default (2026-08-18) — us-only OpenAI, so this carve-out
+        // is what lets `freeTierAllows` permit it for plan mode without making it
+        // outright `freeTier` (which would free it in every mode). Mirrors how
+        // minimax-m3 was scoped as the prior free planner.
+        freeTierRegions: ['us'],
         // Not published — best-effort estimate.
         knowledgeCutoff: '2026-03-01',
     },
@@ -896,35 +901,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
@@ -954,11 +955,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
@@ -982,28 +985,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',
@@ -1027,11 +1020,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
@@ -1053,22 +1048,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',
@@ -1271,15 +1259,13 @@ export const MODELS = [
         // US default. DeepInfra list matches native; only the cache write differs
         // (no premium → region input rate). Verified 2026-08-01.
         regions: ['us', 'cn'],
-        // The free tier PLANS with this model (molecule-dev FREE_TIER_MODELS.plan,
-        // 2026-08-14), so its default US region must be free-tier selectable. It
-        // took over from deepseek-v4-pro@cn: measured on the real starting-point
-        // selection it scored 8/8 against Pro's 7/8 — including the case Pro failed
-        // — at 1.28c/plan-turn flat versus Pro's 2.62c off-peak and 5.24c inside
-        // DeepSeek's Beijing-hours windows, and it adds vision, which Pro (text
-        // only) could not offer discovery. CN is NOT listed: it is dearer than US
-        // here, so free planning stays on the cheaper host.
-        freeTierRegions: ['us'],
+        // No freeTierRegions: the free tier stopped planning with this model on
+        // 2026-08-18 (gpt-5.6-luna took over as FREE_TIER_MODELS.plan). It had been
+        // the free planner since 2026-08-14, taking over from deepseek-v4-pro@cn.
+        // The carve-out only ever existed to keep the free tier's OWN plan default
+        // usable, and `freeTierAllows` checks `FREE_TIER_MODELS[mode] === modelId`
+        // before it looks at regions, so leaving it here would widen nothing — it
+        // would just claim a free-tier relationship that no longer exists.
         regionPricing: {
             // Verified 2026-08-14 against api.deepinfra.com/models/MiniMaxAI/MiniMax-M3
             // (cache read = 0.2 × input). Was 0.3/1.2/0.06 — DeepInfra had repriced

package/package.json

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