@molecule/api-resource-ai-models 1.21.0 → 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
3
3
  Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
4
4
  Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
5
5
  To change this document, edit the module-level JSDoc in src/index.ts.
6
- Generated: 2026-11-04T14:19:59.553Z
6
+ Generated: 2026-11-18T16:18:51.959Z
7
7
  -->
8
8
 
9
9
  # @molecule/api-resource-ai-models
@@ -112,9 +112,15 @@ interface ModelDefinition {
112
112
  webSearchToolType?: string
113
113
  /** USD per 1,000 web searches the provider bills on top of tokens, applied to `TokenUsage.webSearchRequests`. */
114
114
  webSearchPricePer1k?: number
115
- /** Provider-specific server tool type for code execution (e.g. `'code_execution_20250825'`). */
115
+ /**
116
+ * Provider-specific server tool type for code execution (e.g. `'code_execution_20250825'`).
117
+ * Omit if the model / provider does not support native code execution.
118
+ */
116
119
  codeExecutionToolType?: string
117
- /** Provider-specific server tool type for web fetch / URL context (e.g. `'web_fetch_20260209'`). */
120
+ /**
121
+ * Provider-specific server tool type for web fetch / URL context (e.g. `'web_fetch_20260209'`).
122
+ * Omit if the model / provider does not support native web fetch.
123
+ */
118
124
  webFetchToolType?: string
119
125
  /** Whether this model is available on the free tier (only one model should be true). */
120
126
  freeTier?: boolean
@@ -170,7 +176,11 @@ interface ModelDefinition {
170
176
  excludedDatesUtc?: string[]
171
177
  rule?: { url: string; text: string }
172
178
  }
173
- /** Long-context band from `effectiveFrom` (omitted → the model's existing band carries through unchanged). */
179
+ /**
180
+ * Long-context band from `effectiveFrom` (omitted → the model's existing
181
+ * band carries through unchanged). Indexed off the model-level field so
182
+ * the two shapes can never drift apart.
183
+ */
174
184
  longContextPricing?: ModelDefinition['longContextPricing']
175
185
  /** Where the change was announced, for the re-verify pass after it lands. */
176
186
  source?: string
@@ -210,7 +220,7 @@ interface ModelDefinition {
210
220
  }
211
221
  ```
212
222
 
213
- _(Member comments are shortened to their first sentence to fit; the full declaration is in `node_modules/@molecule/api-resource-ai-models/dist/types.d.ts`.)_
223
+ _(The 21 longest member comments are shortened to their first sentence to fit; the full declaration is in `node_modules/@molecule/api-resource-ai-models/dist/types.d.ts`.)_
214
224
 
215
225
  #### `ModeModelDefaults`
216
226
 
package/dist/models.d.ts CHANGED
@@ -186,6 +186,28 @@ import type { ModelDefinition } from './types.js';
186
186
  * the Responses API" — the same shape as gpt-6.1-sol, served by the bond's
187
187
  * /v1/responses calls. Supersedes gpt-5.6-terra, same tier at $2/$12,
188
188
  * repointed from gpt-6.1-sol.)
189
+ * (verified 2026-11-18 on the pricing page + the gpt-6.2-astra model page:
190
+ * ADDED gpt-6.2-astra ($8/$40, cached $0.40 — 5% of input — cache writes
191
+ * $10; >272K band $16/$60, cached $0.80, writes $20 not modeled; 1.05M ctx /
192
+ * 128K out; image input; knowledge cutoff May 18 2026; effort
193
+ * low|medium|high|xhigh|max with NO 'none' — live-probed on /v1/responses
194
+ * with tools at every level 2026-11-18, and the 'none' rejection's error
195
+ * names exactly those five; temperature → 400; forced tool_choice → 200).
196
+ * It supersedes gpt-6-astra (the same flagship tier at $10/$50). The 5.6-sol
197
+ * promo footnote now reads "available until November 30, 2026" — the
198
+ * KNOWN_DIVERGENCES expiry in check-model-freshness.mjs was extended to
199
+ * match. Web search stays $10/1k calls on reasoning models.)
200
+ * (verified 2026-11-18 on the pricing page + the gpt-6.2-sol model page:
201
+ * ADDED gpt-6.2-sol ($2/$10, cached $0.10 — 5% of input — cache writes
202
+ * $2.50; >272K band $4/$15, cached $0.20, writes $5 not modeled; 1.05M ctx /
203
+ * 128K out; image input; knowledge cutoff Jun 1 2026; effort
204
+ * low|medium|high|xhigh|max with NO 'none' — the model page states the API
205
+ * rejects 'none', and all five levels were probed live with tools on
206
+ * /v1/responses 2026-11-18; temperature → 400; forced tool_choice → 200).
207
+ * It supersedes gpt-6.1-sol (same $2/$10 tier, newer generation); gpt-6-sol
208
+ * / 5.6-sol / 5.5 / 5.4 repointed one hop to it. No GPT-6.2 terra or luna id
209
+ * exists on either page. The 5.6-sol promo footnote ("until November 30,
210
+ * 2026") and web-search price are unchanged.)
189
211
  * - Google: https://ai.google.dev/gemini-api/docs/pricing (gemini-3.6-flash GA
190
212
  * 2026-07-21 $1.50/$7.50 supersedes 3.5-flash as the agentic flagship;
191
213
  * gemini-3.1-pro-preview still the pro tier — "3.5 Pro" has NOT shipped as
@@ -1 +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;AAwEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6bG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAmvFnC,CAAA"}
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;AAwEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmdG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAs1FnC,CAAA"}
package/dist/models.js CHANGED
@@ -251,6 +251,28 @@ const CHINA_PUBLIC_HOLIDAYS = [
251
251
  * the Responses API" — the same shape as gpt-6.1-sol, served by the bond's
252
252
  * /v1/responses calls. Supersedes gpt-5.6-terra, same tier at $2/$12,
253
253
  * repointed from gpt-6.1-sol.)
254
+ * (verified 2026-11-18 on the pricing page + the gpt-6.2-astra model page:
255
+ * ADDED gpt-6.2-astra ($8/$40, cached $0.40 — 5% of input — cache writes
256
+ * $10; >272K band $16/$60, cached $0.80, writes $20 not modeled; 1.05M ctx /
257
+ * 128K out; image input; knowledge cutoff May 18 2026; effort
258
+ * low|medium|high|xhigh|max with NO 'none' — live-probed on /v1/responses
259
+ * with tools at every level 2026-11-18, and the 'none' rejection's error
260
+ * names exactly those five; temperature → 400; forced tool_choice → 200).
261
+ * It supersedes gpt-6-astra (the same flagship tier at $10/$50). The 5.6-sol
262
+ * promo footnote now reads "available until November 30, 2026" — the
263
+ * KNOWN_DIVERGENCES expiry in check-model-freshness.mjs was extended to
264
+ * match. Web search stays $10/1k calls on reasoning models.)
265
+ * (verified 2026-11-18 on the pricing page + the gpt-6.2-sol model page:
266
+ * ADDED gpt-6.2-sol ($2/$10, cached $0.10 — 5% of input — cache writes
267
+ * $2.50; >272K band $4/$15, cached $0.20, writes $5 not modeled; 1.05M ctx /
268
+ * 128K out; image input; knowledge cutoff Jun 1 2026; effort
269
+ * low|medium|high|xhigh|max with NO 'none' — the model page states the API
270
+ * rejects 'none', and all five levels were probed live with tools on
271
+ * /v1/responses 2026-11-18; temperature → 400; forced tool_choice → 200).
272
+ * It supersedes gpt-6.1-sol (same $2/$10 tier, newer generation); gpt-6-sol
273
+ * / 5.6-sol / 5.5 / 5.4 repointed one hop to it. No GPT-6.2 terra or luna id
274
+ * exists on either page. The 5.6-sol promo footnote ("until November 30,
275
+ * 2026") and web-search price are unchanged.)
254
276
  * - Google: https://ai.google.dev/gemini-api/docs/pricing (gemini-3.6-flash GA
255
277
  * 2026-07-21 $1.50/$7.50 supersedes 3.5-flash as the agentic flagship;
256
278
  * gemini-3.1-pro-preview still the pro tier — "3.5 Pro" has NOT shipped as
@@ -1102,7 +1124,58 @@ export const MODELS = [
1102
1124
  // /v1/responses calls, so it too needs no `toolsRequireReasoningOff` pin.
1103
1125
  // At $1/$5 it is 5.6-terra's tier at half the price, so 5.6-terra repoints
1104
1126
  // to it.
1127
+ //
1128
+ // gpt-6.2-astra (released 2026-11-17, added 2026-11-18) is astra's own
1129
+ // successor at $8/$40 with cached input at 5% of input (the 6.1-family
1130
+ // ratio, not the 10% GPT-6 carried). Like gpt-6-astra it has no 'none'
1131
+ // effort — the API rejects it and the error names low|medium|high|xhigh|max,
1132
+ // all five verified live with tools on /v1/responses (2026-11-18) —
1133
+ // temperature is rejected like the rest of the family, and a forced
1134
+ // tool_choice returns 200, so it needs no pins at all.
1135
+ //
1136
+ // gpt-6.2-sol (released 2026-11-17, added 2026-11-18) is sol's own successor:
1137
+ // the same $2/$10 list as gpt-6.1-sol with the same 5% cached-input ratio and
1138
+ // $2.50 cache writes, cutoff Jun 1 2026. Identical probe shape to
1139
+ // gpt-6.2-astra: no 'none' effort (the rejection's error names exactly
1140
+ // low|medium|high|xhigh|max), all five levels verified live with tools on
1141
+ // /v1/responses (2026-11-18), temperature → 400, forced tool_choice → 200 —
1142
+ // no pins. It supersedes gpt-6.1-sol (same tier, same price, newer
1143
+ // generation); no GPT-6.2 terra or luna id exists.
1105
1144
  // ---------------------------------------------------------------------------
1145
+ {
1146
+ id: 'gpt-6.2-astra',
1147
+ provider: 'openai',
1148
+ label: 'GPT-6.2 Astra',
1149
+ description: 'OpenAI flagship — the hardest reasoning & coding work',
1150
+ // Documented as 1.05M; floored to 1M like the other OpenAI entries.
1151
+ contextWindow: 1_000_000,
1152
+ maxOutputTokens: 128_000,
1153
+ supportsThinking: true,
1154
+ thinkingBudgetTokens: 16_000,
1155
+ thinkingConfigurable: true,
1156
+ // No 'none' on this model. All five levels verified accepted with tools on
1157
+ // /v1/responses (2026-11-18) — the 'none' rejection's own error message
1158
+ // lists exactly these values.
1159
+ supportedEffortLevels: ['low', 'medium', 'high', 'xhigh', 'max'],
1160
+ defaultEffortLevel: 'medium',
1161
+ // temperature → 400 "Unsupported parameter: 'temperature' is not supported
1162
+ // with this model" (probed live 2026-11-18).
1163
+ rejectsTemperature: true,
1164
+ supportsVision: true,
1165
+ supportsPromptCaching: true,
1166
+ supportsTools: true,
1167
+ webSearchToolType: 'web_search',
1168
+ // $10 per 1,000 web_search_call items (pricing page tool table, reasoning
1169
+ // models); search-result tokens bill as input.
1170
+ webSearchPricePer1k: 10,
1171
+ codeExecutionToolType: 'code_interpreter',
1172
+ // Standard tier; >272K band ($16/$60, cached $0.80, writes $20) not modeled.
1173
+ inputPricePerMTok: 8,
1174
+ outputPricePerMTok: 40,
1175
+ cacheReadPricePerMTok: 0.4,
1176
+ cacheWritePricePerMTok: 10,
1177
+ knowledgeCutoff: '2026-05-18',
1178
+ },
1106
1179
  {
1107
1180
  id: 'gpt-6-astra',
1108
1181
  provider: 'openai',
@@ -1135,6 +1208,47 @@ export const MODELS = [
1135
1208
  cacheReadPricePerMTok: 1,
1136
1209
  cacheWritePricePerMTok: 12.5,
1137
1210
  knowledgeCutoff: '2026-04-30',
1211
+ // Superseded by gpt-6.2-astra — the same flagship tier at $8/$40 with a
1212
+ // fifth of the cached-input rate. Still served and priceable — just not
1213
+ // offered in the picker.
1214
+ deprecatedAt: '2026-11-18',
1215
+ supersededBy: 'gpt-6.2-astra',
1216
+ },
1217
+ {
1218
+ id: 'gpt-6.2-sol',
1219
+ provider: 'openai',
1220
+ label: 'GPT-6.2 Sol',
1221
+ description: 'OpenAI for complex coding & agentic work',
1222
+ // Documented as 1.05M; floored to 1M like the other OpenAI entries.
1223
+ contextWindow: 1_000_000,
1224
+ maxOutputTokens: 128_000,
1225
+ supportsThinking: true,
1226
+ thinkingBudgetTokens: 16_000,
1227
+ thinkingConfigurable: true,
1228
+ // No 'none' on this model (model page: "The API rejects requests that set
1229
+ // reasoning effort to `none`."). All five levels verified accepted with
1230
+ // tools on /v1/responses (2026-11-18) — the 'none' rejection's own error
1231
+ // message lists exactly these values.
1232
+ supportedEffortLevels: ['low', 'medium', 'high', 'xhigh', 'max'],
1233
+ defaultEffortLevel: 'medium',
1234
+ // temperature → 400 "Unsupported parameter: 'temperature' is not supported
1235
+ // with this model" (probed live 2026-11-18).
1236
+ rejectsTemperature: true,
1237
+ supportsVision: true,
1238
+ supportsPromptCaching: true,
1239
+ supportsTools: true,
1240
+ webSearchToolType: 'web_search',
1241
+ // $10 per 1,000 web_search_call items (pricing page tool table, reasoning
1242
+ // models); search-result tokens bill as input.
1243
+ webSearchPricePer1k: 10,
1244
+ codeExecutionToolType: 'code_interpreter',
1245
+ // Standard tier. Cached input is 5% of input like the 6.1 family; >272K
1246
+ // band ($4/$15, cached $0.20, writes $5) not modeled.
1247
+ inputPricePerMTok: 2,
1248
+ outputPricePerMTok: 10,
1249
+ cacheReadPricePerMTok: 0.1,
1250
+ cacheWritePricePerMTok: 2.5,
1251
+ knowledgeCutoff: '2026-06-01',
1138
1252
  },
1139
1253
  {
1140
1254
  id: 'gpt-6.1-sol',
@@ -1166,6 +1280,11 @@ export const MODELS = [
1166
1280
  cacheReadPricePerMTok: 0.1,
1167
1281
  cacheWritePricePerMTok: 2.5,
1168
1282
  knowledgeCutoff: '2026-04-30',
1283
+ // Superseded by gpt-6.2-sol — the same $2/$10 tier with a newer
1284
+ // generation (cutoff Jun 1 2026 vs Apr 30 2026). Still served and
1285
+ // priceable — just not offered in the picker.
1286
+ deprecatedAt: '2026-11-18',
1287
+ supersededBy: 'gpt-6.2-sol',
1169
1288
  },
1170
1289
  {
1171
1290
  id: 'gpt-6.1-terra',
@@ -1232,10 +1351,11 @@ export const MODELS = [
1232
1351
  cacheReadPricePerMTok: 0.2,
1233
1352
  cacheWritePricePerMTok: 2.5,
1234
1353
  knowledgeCutoff: '2026-04-20',
1235
- // Superseded by gpt-6.1-sol (same $2/$10, cached input $0.10 vs $0.20).
1236
- // Still served and priceable — just not offered in the picker.
1354
+ // Superseded by gpt-6.2-sol (via gpt-6.1-sol: same $2/$10, cached input
1355
+ // $0.10 vs $0.20). Still served and priceable — just not offered in the
1356
+ // picker.
1237
1357
  deprecatedAt: '2026-09-30',
1238
- supersededBy: 'gpt-6.1-sol',
1358
+ supersededBy: 'gpt-6.2-sol',
1239
1359
  },
1240
1360
  {
1241
1361
  id: 'gpt-6-luna',
@@ -1297,10 +1417,11 @@ export const MODELS = [
1297
1417
  codeExecutionToolType: 'code_interpreter',
1298
1418
  // LIST price. OpenAI ran a >20% PROMO from 2026-08-22 ($4/$20, cache read
1299
1419
  // $0.40, cache write $5) — "GPT-5.6 Sol's promotional pricing is available
1300
- // at least through November 21, 2026" per the pricing page's own footnote.
1420
+ // until November 30, 2026" per the pricing page's own footnote (re-read
1421
+ // 2026-11-18; it previously said "at least through November 21, 2026").
1301
1422
  // Billed here at list so metering never under-charges when it lapses; same
1302
1423
  // policy as the gemini-flash and claude-sonnet-5 promos, and recorded in
1303
- // check-model-freshness.mjs KNOWN_DIVERGENCES (expires 2026-11-21).
1424
+ // check-model-freshness.mjs KNOWN_DIVERGENCES (expires 2026-11-30).
1304
1425
  inputPricePerMTok: 5,
1305
1426
  outputPricePerMTok: 30,
1306
1427
  // Cached input 0.1× input, cache write 1.25× input (see section note).
@@ -1309,10 +1430,10 @@ export const MODELS = [
1309
1430
  // Not published — best-effort estimate.
1310
1431
  knowledgeCutoff: '2026-03-01',
1311
1432
  // Superseded by gpt-6-sol ($2/$10 vs $5/$30 list); points one hop to
1312
- // gpt-6.1-sol since 2026-09-30, when gpt-6-sol was superseded. Still served and
1313
- // priceable — just not offered in the picker.
1433
+ // gpt-6.2-sol since 2026-11-18, when gpt-6.1-sol was itself superseded.
1434
+ // Still served and priceable — just not offered in the picker.
1314
1435
  deprecatedAt: '2026-09-23',
1315
- supersededBy: 'gpt-6.1-sol',
1436
+ supersededBy: 'gpt-6.2-sol',
1316
1437
  },
1317
1438
  {
1318
1439
  id: 'gpt-5.6-terra',
@@ -1426,11 +1547,11 @@ export const MODELS = [
1426
1547
  cacheWritePricePerMTok: 5,
1427
1548
  knowledgeCutoff: '2025-12-01',
1428
1549
  // Superseded by gpt-5.6-sol (same frontier tier, same $5/$30), and since
1429
- // 2026-09-23 points one hop to gpt-6-sol, 5.6-sol's own successor (gpt-6.1-sol
1430
- // since 2026-09-30). Still
1431
- // listed as current by OpenAI, so it stays priceable — just not offered.
1550
+ // 2026-09-23 points one hop to the sol line's current generation (gpt-6.2-sol
1551
+ // since 2026-11-18). Still listed as current by OpenAI, so it stays
1552
+ // priceable — just not offered.
1432
1553
  deprecatedAt: '2026-07-09',
1433
- supersededBy: 'gpt-6.1-sol',
1554
+ supersededBy: 'gpt-6.2-sol',
1434
1555
  },
1435
1556
  {
1436
1557
  id: 'gpt-5.4',
@@ -1464,9 +1585,9 @@ export const MODELS = [
1464
1585
  // offers only the 5.6 generation (this is OUR taxonomy, not OpenAI's
1465
1586
  // deprecations page; the model stays priceable). Points one hop to
1466
1587
  // gpt-6-sol since 2026-09-23, when 5.6-terra was itself superseded, and to
1467
- // gpt-6.1-sol since 2026-09-30.
1588
+ // the sol line's current generation since 2026-11-18.
1468
1589
  deprecatedAt: '2026-07-28',
1469
- supersededBy: 'gpt-6.1-sol',
1590
+ supersededBy: 'gpt-6.2-sol',
1470
1591
  },
1471
1592
  {
1472
1593
  id: 'gpt-5.4-mini',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@molecule/api-resource-ai-models",
3
- "version": "1.21.0",
3
+ "version": "1.22.0",
4
4
  "description": "Server-side AI model catalog plus GET /ai/models endpoint",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",