@trazum/core 2.7.12 → 3.0.1

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.
Files changed (65) hide show
  1. package/dist/advisories.d.ts +14 -7
  2. package/dist/advisories.d.ts.map +1 -1
  3. package/dist/advisories.js +27 -20
  4. package/dist/advisories.js.map +1 -1
  5. package/dist/i18n/en.js +2 -2
  6. package/dist/i18n/en.js.map +1 -1
  7. package/dist/i18n/es.js +2 -2
  8. package/dist/i18n/es.js.map +1 -1
  9. package/dist/i18n/types.d.ts +2 -1
  10. package/dist/i18n/types.d.ts.map +1 -1
  11. package/dist/index.d.ts +3 -1
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +2 -1
  14. package/dist/index.js.map +1 -1
  15. package/dist/openrouter.d.ts +1 -1
  16. package/dist/openrouter.d.ts.map +1 -1
  17. package/dist/openrouter.js +1 -2
  18. package/dist/openrouter.js.map +1 -1
  19. package/dist/pricing-overlay.d.ts +1 -1
  20. package/dist/pricing-overlay.d.ts.map +1 -1
  21. package/dist/pricing-overlay.js +19 -9
  22. package/dist/pricing-overlay.js.map +1 -1
  23. package/dist/pricing.d.ts +8 -5
  24. package/dist/pricing.d.ts.map +1 -1
  25. package/dist/pricing.js +11 -99
  26. package/dist/pricing.js.map +1 -1
  27. package/dist/review.js +2 -1
  28. package/dist/review.js.map +1 -1
  29. package/dist/segment.d.ts +31 -1
  30. package/dist/segment.d.ts.map +1 -1
  31. package/dist/segment.js +52 -4
  32. package/dist/segment.js.map +1 -1
  33. package/dist/structure.d.ts +34 -0
  34. package/dist/structure.d.ts.map +1 -1
  35. package/dist/structure.js +143 -12
  36. package/dist/structure.js.map +1 -1
  37. package/dist/types.d.ts +6 -6
  38. package/dist/types.d.ts.map +1 -1
  39. package/dist/usage.js +11 -11
  40. package/dist/watch.d.ts +11 -1
  41. package/dist/watch.d.ts.map +1 -1
  42. package/dist/watch.js.map +1 -1
  43. package/dist/weekly.d.ts +140 -0
  44. package/dist/weekly.d.ts.map +1 -0
  45. package/dist/weekly.js +176 -0
  46. package/dist/weekly.js.map +1 -0
  47. package/dist/write.js +2 -2
  48. package/dist/write.js.map +1 -1
  49. package/package.json +1 -1
  50. package/src/advisories.ts +41 -25
  51. package/src/i18n/en.ts +2 -2
  52. package/src/i18n/es.ts +2 -2
  53. package/src/i18n/types.ts +2 -1
  54. package/src/index.ts +4 -2
  55. package/src/openrouter.ts +1 -2
  56. package/src/pricing-overlay.ts +21 -12
  57. package/src/pricing.ts +13 -101
  58. package/src/review.ts +1 -1
  59. package/src/segment.ts +50 -6
  60. package/src/structure.ts +152 -13
  61. package/src/types.ts +6 -6
  62. package/src/usage.ts +11 -11
  63. package/src/watch.ts +12 -1
  64. package/src/weekly.ts +281 -0
  65. package/src/write.ts +2 -2
package/dist/pricing.js CHANGED
@@ -404,7 +404,6 @@ export const MODELS = [
404
404
  */
405
405
  tiers: [{ id: 'fast', when: { kind: 'speed', speed: 'fast' }, inputPerMTok: 16, outputPerMTok: 80 }],
406
406
  capability: 'frontier',
407
- tier: 'frontier',
408
407
  notes: 'Cache hits cost 2.5% of the input price ($0.20). Fast mode (usage.speed "fast") bills $16/$80.'
409
408
  + ' Requires 30-day data retention.',
410
409
  },
@@ -431,7 +430,6 @@ export const MODELS = [
431
430
  multipliers: { cacheRead: 0.025, cacheWrite5m: 1.25, cacheWrite1h: 2, batch: 0.5 },
432
431
  tiers: [{ id: 'fast', when: { kind: 'speed', speed: 'fast' }, inputPerMTok: 16, outputPerMTok: 80 }],
433
432
  capability: 'frontier',
434
- tier: 'frontier',
435
433
  notes: 'Available only to organizations verified through Anthropic\'s verification programs.'
436
434
  + ' Fast mode (usage.speed "fast") bills $16/$80. Requires 30-day data retention.',
437
435
  },
@@ -458,7 +456,6 @@ export const MODELS = [
458
456
  cacheMinTokens: 512,
459
457
  multipliers: { cacheRead: 0.025, cacheWrite5m: 1.25, cacheWrite1h: 2, batch: 0.5 },
460
458
  capability: 'frontier',
461
- tier: 'frontier',
462
459
  notes: 'Legacy: superseded by Claude Fable 5.2, which costs less ($8/$40). Cache hits cost 2.5% of the input'
463
460
  + ' price ($0.25). Requires 30-day data retention.',
464
461
  },
@@ -480,7 +477,6 @@ export const MODELS = [
480
477
  cacheMinTokens: 512,
481
478
  multipliers: { cacheRead: 0.025, cacheWrite5m: 1.25, cacheWrite1h: 2, batch: 0.5 },
482
479
  capability: 'frontier',
483
- tier: 'frontier',
484
480
  notes: 'Available only to organizations verified through Anthropic\'s verification programs.'
485
481
  + ' Requires 30-day data retention.',
486
482
  },
@@ -495,7 +491,6 @@ export const MODELS = [
495
491
  contextWindow: 1_000_000,
496
492
  cacheMinTokens: 512,
497
493
  capability: 'frontier',
498
- tier: 'frontier',
499
494
  notes: 'Legacy: superseded by Claude Fable 5.1 at the same prices. Requires 30-day data retention.',
500
495
  },
501
496
  {
@@ -510,7 +505,6 @@ export const MODELS = [
510
505
  contextWindow: 1_000_000,
511
506
  cacheMinTokens: 512,
512
507
  capability: 'frontier',
513
- tier: 'frontier',
514
508
  notes: 'Available only to organizations verified through Anthropic\'s verification programs.'
515
509
  + ' Requires 30-day data retention.',
516
510
  },
@@ -540,7 +534,6 @@ export const MODELS = [
540
534
  */
541
535
  tiers: [{ id: 'fast', when: { kind: 'speed', speed: 'fast' }, inputPerMTok: 8, outputPerMTok: 40 }],
542
536
  capability: 'large',
543
- tier: 'opus',
544
537
  notes: 'Cache hits cost 5% of the input price ($0.20), against 10% on Opus 5 and earlier.'
545
538
  + ' Fast mode (usage.speed "fast") bills $8/$40.',
546
539
  },
@@ -557,7 +550,6 @@ export const MODELS = [
557
550
  // Fast mode in research preview, $10/$50; same sources as Opus 5.5's.
558
551
  tiers: [{ id: 'fast', when: { kind: 'speed', speed: 'fast' }, inputPerMTok: 10, outputPerMTok: 50 }],
559
552
  capability: 'large',
560
- tier: 'opus',
561
553
  notes: '512-token cache minimum: caches prompts that would miss on Opus 4.6. Fast mode bills $10/$50.',
562
554
  },
563
555
  {
@@ -577,7 +569,6 @@ export const MODELS = [
577
569
  */
578
570
  tiers: [{ id: 'fast', when: { kind: 'speed', speed: 'fast' }, inputPerMTok: 10, outputPerMTok: 50 }],
579
571
  capability: 'large',
580
- tier: 'opus',
581
572
  notes: 'Fast mode bills $10/$50 until it is removed from this model on 2026-11-30.',
582
573
  },
583
574
  {
@@ -591,7 +582,6 @@ export const MODELS = [
591
582
  contextWindow: 1_000_000,
592
583
  cacheMinTokens: 2048,
593
584
  capability: 'large',
594
- tier: 'opus',
595
585
  },
596
586
  {
597
587
  id: 'claude-opus-4-6',
@@ -604,7 +594,6 @@ export const MODELS = [
604
594
  contextWindow: 1_000_000,
605
595
  cacheMinTokens: 4096,
606
596
  capability: 'large',
607
- tier: 'opus',
608
597
  },
609
598
  {
610
599
  /*
@@ -625,7 +614,6 @@ export const MODELS = [
625
614
  contextWindow: 200_000,
626
615
  cacheMinTokens: 4096,
627
616
  capability: 'large',
628
- tier: 'opus',
629
617
  notes: '200K context window and a 64K output cap.',
630
618
  },
631
619
  {
@@ -651,7 +639,6 @@ export const MODELS = [
651
639
  contextWindow: 200_000,
652
640
  cacheMinTokens: 1024,
653
641
  capability: 'large',
654
- tier: 'opus',
655
642
  notes: 'Retired on the Claude API on 2026-08-05; still served on Google Cloud (Google managed) and Bedrock.'
656
643
  + ' Anthropic names Claude Opus 4.8 as the replacement.',
657
644
  },
@@ -671,7 +658,6 @@ export const MODELS = [
671
658
  contextWindow: 200_000,
672
659
  cacheMinTokens: 1024,
673
660
  capability: 'large',
674
- tier: 'opus',
675
661
  notes: 'Retired on the Claude API on 2026-06-15; still served on Google Cloud (Google managed).'
676
662
  + ' Anthropic names Claude Opus 4.8 as the replacement.',
677
663
  },
@@ -692,7 +678,6 @@ export const MODELS = [
692
678
  cacheMinTokens: 512,
693
679
  multipliers: { cacheRead: 0.05, cacheWrite5m: 1.25, cacheWrite1h: 2, batch: 0.5 },
694
680
  capability: 'mid',
695
- tier: 'sonnet',
696
681
  notes: 'Cache hits cost 5% of the input price ($0.10), against 10% ($0.20) on Sonnet 5.',
697
682
  },
698
683
  {
@@ -706,7 +691,6 @@ export const MODELS = [
706
691
  contextWindow: 1_000_000,
707
692
  cacheMinTokens: 1024,
708
693
  capability: 'mid',
709
- tier: 'sonnet',
710
694
  notes: 'Launched with 2/10 as introductory pricing through 2026-08-31; the scheduled'
711
695
  + ' increase to 3/15 on 2026-09-01 was cancelled and 2/10 is the standard price.',
712
696
  },
@@ -721,7 +705,6 @@ export const MODELS = [
721
705
  contextWindow: 1_000_000,
722
706
  cacheMinTokens: 1024,
723
707
  capability: 'mid',
724
- tier: 'sonnet',
725
708
  },
726
709
  {
727
710
  /*
@@ -744,7 +727,6 @@ export const MODELS = [
744
727
  contextWindow: 200_000,
745
728
  cacheMinTokens: 1024,
746
729
  capability: 'mid',
747
- tier: 'sonnet',
748
730
  notes: 'Deprecated; retires 2026-11-30. Recommended replacement: Claude Sonnet 5.5.',
749
731
  },
750
732
  {
@@ -767,7 +749,6 @@ export const MODELS = [
767
749
  contextWindow: 200_000,
768
750
  cacheMinTokens: 1024,
769
751
  capability: 'mid',
770
- tier: 'sonnet',
771
752
  notes: 'Retired on the Claude API on 2026-06-15; still served on Google Cloud (Google managed) and Bedrock.'
772
753
  + ' Anthropic names Claude Sonnet 5.5 as the replacement.',
773
754
  },
@@ -807,7 +788,6 @@ export const MODELS = [
807
788
  },
808
789
  ],
809
790
  capability: 'small',
810
- tier: 'haiku',
811
791
  notes: 'Priced per request by prompt length: $0.10/$0.50 up to 100,000 input tokens, cache reads'
812
792
  + ' and writes included, and $0.50/$2.50 over it.',
813
793
  },
@@ -825,7 +805,6 @@ export const MODELS = [
825
805
  contextWindow: 200_000,
826
806
  cacheMinTokens: 4096,
827
807
  capability: 'small',
828
- tier: 'haiku',
829
808
  notes: '200K context window and a 64K output cap, smaller than the rest.',
830
809
  },
831
810
  {
@@ -847,7 +826,6 @@ export const MODELS = [
847
826
  contextWindow: 200_000,
848
827
  cacheMinTokens: 2048,
849
828
  capability: 'small',
850
- tier: 'haiku',
851
829
  notes: 'Retired on the Claude API on 2026-02-19; still served on Google Cloud (Google managed).'
852
830
  + ' Anthropic names Claude Haiku 4.5 as the replacement.',
853
831
  },
@@ -916,7 +894,6 @@ export const MODELS = [
916
894
  ultrafast: { inputPerMTok: 60, outputPerMTok: 300, tiers: openAiLongBand(120, 450) },
917
895
  },
918
896
  capability: 'frontier',
919
- tier: 'frontier',
920
897
  notes: OPENAI_CURRENT_NOTE,
921
898
  },
922
899
  {
@@ -944,7 +921,6 @@ export const MODELS = [
944
921
  ultrafast: { inputPerMTok: 12, outputPerMTok: 60, tiers: openAiLongBand(24, 90) },
945
922
  },
946
923
  capability: 'large',
947
- tier: 'opus',
948
924
  notes: OPENAI_CURRENT_NOTE,
949
925
  },
950
926
  {
@@ -977,7 +953,6 @@ export const MODELS = [
977
953
  fast: { inputPerMTok: 2, outputPerMTok: 10, tiers: openAiLongBand(4, 15) },
978
954
  },
979
955
  capability: 'mid',
980
- tier: 'sonnet',
981
956
  notes: OPENAI_CURRENT_NOTE,
982
957
  },
983
958
  {
@@ -1004,7 +979,6 @@ export const MODELS = [
1004
979
  fast: { inputPerMTok: 4, outputPerMTok: 20, tiers: openAiLongBand(8, 30) },
1005
980
  },
1006
981
  capability: 'large',
1007
- tier: 'opus',
1008
982
  notes: OPENAI_CURRENT_NOTE,
1009
983
  },
1010
984
  {
@@ -1031,7 +1005,6 @@ export const MODELS = [
1031
1005
  fast: { inputPerMTok: 0.2, outputPerMTok: 1, tiers: openAiLongBand(0.4, 1.5) },
1032
1006
  },
1033
1007
  capability: 'small',
1034
- tier: 'haiku',
1035
1008
  notes: OPENAI_CURRENT_NOTE,
1036
1009
  },
1037
1010
  {
@@ -1072,7 +1045,6 @@ export const MODELS = [
1072
1045
  fast: { inputPerMTok: 8, outputPerMTok: 40, tiers: openAiLongBand(16, 60) },
1073
1046
  },
1074
1047
  capability: 'large',
1075
- tier: 'opus',
1076
1048
  notes: OPENAI_CURRENT_NOTE
1077
1049
  + ' $4/$20 is promotional until 2026-11-30, and OpenAI has not published the price after it as a figure.',
1078
1050
  },
@@ -1100,7 +1072,6 @@ export const MODELS = [
1100
1072
  fast: { inputPerMTok: 4, outputPerMTok: 24, tiers: openAiLongBand(8, 36) },
1101
1073
  },
1102
1074
  capability: 'mid',
1103
- tier: 'sonnet',
1104
1075
  notes: OPENAI_CURRENT_NOTE,
1105
1076
  },
1106
1077
  {
@@ -1127,7 +1098,6 @@ export const MODELS = [
1127
1098
  fast: { inputPerMTok: 0.4, outputPerMTok: 2.4, tiers: openAiLongBand(0.8, 3.6) },
1128
1099
  },
1129
1100
  capability: 'small',
1130
- tier: 'haiku',
1131
1101
  notes: OPENAI_CURRENT_NOTE,
1132
1102
  },
1133
1103
  {
@@ -1158,7 +1128,6 @@ export const MODELS = [
1158
1128
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1.25, cacheWrite1h: 2.5, batch: null },
1159
1129
  cacheTtl: OPENAI_CACHE_TTL,
1160
1130
  capability: 'large',
1161
- tier: 'opus',
1162
1131
  notes: 'Needs approval through the Daybreak programme. At most 272,000 input tokens, Responses API only, no batch.'
1163
1132
  + ' Cache writes cost 1.25x input for the default 30-minute entry and 2.5x for a 12-hour one.',
1164
1133
  },
@@ -1184,7 +1153,6 @@ export const MODELS = [
1184
1153
  fast: { inputPerMTok: 2.5, outputPerMTok: 20 },
1185
1154
  },
1186
1155
  capability: 'frontier',
1187
- tier: 'frontier',
1188
1156
  notes: OPENAI_GPT5_NOTE + OPENAI_DEPRECATED_SUFFIX,
1189
1157
  },
1190
1158
  {
@@ -1204,7 +1172,6 @@ export const MODELS = [
1204
1172
  fast: { inputPerMTok: 0.45, outputPerMTok: 3.6 },
1205
1173
  },
1206
1174
  capability: 'mid',
1207
- tier: 'sonnet',
1208
1175
  notes: OPENAI_GPT5_NOTE + OPENAI_DEPRECATED_SUFFIX,
1209
1176
  },
1210
1177
  {
@@ -1223,7 +1190,6 @@ export const MODELS = [
1223
1190
  flex: { inputPerMTok: 0.025, outputPerMTok: 0.2 },
1224
1191
  },
1225
1192
  capability: 'small',
1226
- tier: 'haiku',
1227
1193
  notes: OPENAI_GPT5_NOTE + OPENAI_DEPRECATED_SUFFIX,
1228
1194
  },
1229
1195
  // ------------------------------------------------------------------------
@@ -1266,7 +1232,6 @@ export const MODELS = [
1266
1232
  fast: { inputPerMTok: 12.5, outputPerMTok: 75 },
1267
1233
  },
1268
1234
  capability: 'frontier',
1269
- tier: 'frontier',
1270
1235
  notes: OPENAI_EARLIER_LONG_NOTE,
1271
1236
  },
1272
1237
  {
@@ -1292,7 +1257,6 @@ export const MODELS = [
1292
1257
  flex: { inputPerMTok: 15, outputPerMTok: 90 },
1293
1258
  },
1294
1259
  capability: 'frontier',
1295
- tier: 'frontier',
1296
1260
  notes: OPENAI_EARLIER_LONG_NOTE,
1297
1261
  },
1298
1262
  {
@@ -1319,7 +1283,6 @@ export const MODELS = [
1319
1283
  fast: { inputPerMTok: 5, outputPerMTok: 30 },
1320
1284
  },
1321
1285
  capability: 'frontier',
1322
- tier: 'frontier',
1323
1286
  notes: OPENAI_EARLIER_LONG_NOTE,
1324
1287
  },
1325
1288
  {
@@ -1345,7 +1308,6 @@ export const MODELS = [
1345
1308
  flex: { inputPerMTok: 15, outputPerMTok: 90, tiers: openAiLongBand(30, 135) },
1346
1309
  },
1347
1310
  capability: 'frontier',
1348
- tier: 'frontier',
1349
1311
  notes: OPENAI_EARLIER_LONG_NOTE,
1350
1312
  },
1351
1313
  {
@@ -1364,7 +1326,6 @@ export const MODELS = [
1364
1326
  fast: { inputPerMTok: 1.5, outputPerMTok: 9 },
1365
1327
  },
1366
1328
  capability: 'mid',
1367
- tier: 'sonnet',
1368
1329
  notes: OPENAI_EARLIER_NOTE,
1369
1330
  },
1370
1331
  {
@@ -1383,7 +1344,6 @@ export const MODELS = [
1383
1344
  flex: { inputPerMTok: 0.1, outputPerMTok: 0.625 },
1384
1345
  },
1385
1346
  capability: 'small',
1386
- tier: 'haiku',
1387
1347
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1388
1348
  },
1389
1349
  {
@@ -1402,7 +1362,6 @@ export const MODELS = [
1402
1362
  fast: { inputPerMTok: 3.5, outputPerMTok: 28 },
1403
1363
  },
1404
1364
  capability: 'frontier',
1405
- tier: 'frontier',
1406
1365
  notes: OPENAI_EARLIER_NOTE,
1407
1366
  },
1408
1367
  {
@@ -1417,7 +1376,6 @@ export const MODELS = [
1417
1376
  caching: 'none',
1418
1377
  multipliers: { batch: 0.5 },
1419
1378
  capability: 'frontier',
1420
- tier: 'frontier',
1421
1379
  notes: OPENAI_EARLIER_NO_CACHE_NOTE,
1422
1380
  },
1423
1381
  {
@@ -1437,7 +1395,6 @@ export const MODELS = [
1437
1395
  fast: { inputPerMTok: 2.5, outputPerMTok: 20 },
1438
1396
  },
1439
1397
  capability: 'frontier',
1440
- tier: 'frontier',
1441
1398
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1442
1399
  },
1443
1400
  {
@@ -1453,7 +1410,6 @@ export const MODELS = [
1453
1410
  caching: 'none',
1454
1411
  multipliers: { batch: 0.5 },
1455
1412
  capability: 'frontier',
1456
- tier: 'frontier',
1457
1413
  notes: OPENAI_EARLIER_NO_CACHE_NOTE + OPENAI_DEPRECATED_SUFFIX,
1458
1414
  },
1459
1415
  {
@@ -1472,7 +1428,6 @@ export const MODELS = [
1472
1428
  fast: { inputPerMTok: 3.5, outputPerMTok: 14 },
1473
1429
  },
1474
1430
  capability: 'large',
1475
- tier: 'opus',
1476
1431
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1477
1432
  },
1478
1433
  {
@@ -1491,7 +1446,6 @@ export const MODELS = [
1491
1446
  fast: { inputPerMTok: 0.7, outputPerMTok: 2.8 },
1492
1447
  },
1493
1448
  capability: 'mid',
1494
- tier: 'sonnet',
1495
1449
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1496
1450
  },
1497
1451
  {
@@ -1510,7 +1464,6 @@ export const MODELS = [
1510
1464
  fast: { inputPerMTok: 4.25, outputPerMTok: 17 },
1511
1465
  },
1512
1466
  capability: 'large',
1513
- tier: 'opus',
1514
1467
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1515
1468
  },
1516
1469
  {
@@ -1529,7 +1482,6 @@ export const MODELS = [
1529
1482
  fast: { inputPerMTok: 0.25, outputPerMTok: 1 },
1530
1483
  },
1531
1484
  capability: 'small',
1532
- tier: 'haiku',
1533
1485
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1534
1486
  },
1535
1487
  {
@@ -1549,7 +1501,6 @@ export const MODELS = [
1549
1501
  fast: { inputPerMTok: 3.5, outputPerMTok: 14 },
1550
1502
  },
1551
1503
  capability: 'frontier',
1552
- tier: 'frontier',
1553
1504
  notes: OPENAI_EARLIER_NOTE + OPENAI_DEPRECATED_SUFFIX,
1554
1505
  },
1555
1506
  {
@@ -1565,7 +1516,6 @@ export const MODELS = [
1565
1516
  caching: 'none',
1566
1517
  multipliers: { batch: 0.5 },
1567
1518
  capability: 'frontier',
1568
- tier: 'frontier',
1569
1519
  notes: OPENAI_EARLIER_NO_CACHE_NOTE + OPENAI_DEPRECATED_SUFFIX,
1570
1520
  },
1571
1521
  // ------------------------------------------------------------------------
@@ -1597,7 +1547,6 @@ export const MODELS = [
1597
1547
  // The pricing page's specialized "Fast" table: $3.50/$28, cached $0.35.
1598
1548
  serviceTiers: { fast: { inputPerMTok: 3.5, outputPerMTok: 28 } },
1599
1549
  capability: 'frontier',
1600
- tier: 'frontier',
1601
1550
  notes: OPENAI_CODEX_NOTE + ' At most 272,000 input tokens.' + OPENAI_DEPRECATED_SUFFIX,
1602
1551
  },
1603
1552
  {
@@ -1612,7 +1561,6 @@ export const MODELS = [
1612
1561
  caching: 'automatic',
1613
1562
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1614
1563
  capability: 'frontier',
1615
- tier: 'frontier',
1616
1564
  notes: OPENAI_CODEX_NOTE + ' At most 272,000 input tokens.' + OPENAI_SHUT_DOWN_SUFFIX,
1617
1565
  },
1618
1566
  {
@@ -1627,7 +1575,6 @@ export const MODELS = [
1627
1575
  caching: 'automatic',
1628
1576
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1629
1577
  capability: 'frontier',
1630
- tier: 'frontier',
1631
1578
  notes: OPENAI_CODEX_NOTE + OPENAI_SHUT_DOWN_SUFFIX,
1632
1579
  },
1633
1580
  {
@@ -1642,7 +1589,6 @@ export const MODELS = [
1642
1589
  caching: 'automatic',
1643
1590
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1644
1591
  capability: 'frontier',
1645
- tier: 'frontier',
1646
1592
  notes: OPENAI_CODEX_NOTE + OPENAI_SHUT_DOWN_SUFFIX,
1647
1593
  },
1648
1594
  {
@@ -1657,7 +1603,6 @@ export const MODELS = [
1657
1603
  caching: 'automatic',
1658
1604
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1659
1605
  capability: 'mid',
1660
- tier: 'sonnet',
1661
1606
  notes: OPENAI_CODEX_NOTE + OPENAI_SHUT_DOWN_SUFFIX,
1662
1607
  },
1663
1608
  {
@@ -1672,7 +1617,6 @@ export const MODELS = [
1672
1617
  caching: 'automatic',
1673
1618
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1674
1619
  capability: 'frontier',
1675
- tier: 'frontier',
1676
1620
  notes: OPENAI_CODEX_NOTE + ' At most 272,000 input tokens.' + OPENAI_SHUT_DOWN_SUFFIX,
1677
1621
  },
1678
1622
  {
@@ -1687,7 +1631,6 @@ export const MODELS = [
1687
1631
  caching: 'automatic',
1688
1632
  multipliers: { cacheRead: 0.25, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1689
1633
  capability: 'mid',
1690
- tier: 'sonnet',
1691
1634
  notes: OPENAI_CODEX_NOTE + ' A cache read costs 0.25x input.' + OPENAI_SHUT_DOWN_SUFFIX,
1692
1635
  },
1693
1636
  {
@@ -1702,7 +1645,6 @@ export const MODELS = [
1702
1645
  caching: 'automatic',
1703
1646
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
1704
1647
  capability: 'large',
1705
- tier: 'opus',
1706
1648
  notes: 'Points at the model ChatGPT currently uses, so it is priced and never recommended. Caching is automatic; a write costs what input costs. At most 272,000 input tokens, and no batch.',
1707
1649
  },
1708
1650
  // ------------------------------------------------------------------------
@@ -1754,7 +1696,6 @@ export const MODELS = [
1754
1696
  because: 'This model models/gemini-2.5-pro is no longer available to new users. Please update your code to use models/gemini-3.1-pro-preview for the latest features and improvements. We recommend you to use the Interactions API.',
1755
1697
  },
1756
1698
  capability: 'large',
1757
- tier: 'opus',
1758
1699
  notes: 'From 2026-12-01 Google routes this id to Gemini 3.8 Flash and bills it at 3.8 Flash rates.'
1759
1700
  + ' Before then it bills $1.25/$10, and $2.50/$15.00 for a prompt over 200k tokens; this row prices every prompt'
1760
1701
  + ' before then at the up-to-200k rate, because no log Trazum prices says how long each prompt was. Implicit caching'
@@ -1801,7 +1742,6 @@ export const MODELS = [
1801
1742
  because: 'This model models/gemini-2.5-flash is no longer available to new users. Please update your code to use models/gemini-3.6-flash for the latest features and improvements. We recommend you to use the Interactions API.',
1802
1743
  },
1803
1744
  capability: 'mid',
1804
- tier: 'sonnet',
1805
1745
  notes: 'From 2026-12-01 Google routes this id to Gemini 3.5 Flash-Lite and bills it at 3.5 Flash-Lite rates,'
1806
1746
  + ' which for text are the $0.30/$2.50 and $0.03 cached this row carries.',
1807
1747
  },
@@ -1843,7 +1783,6 @@ export const MODELS = [
1843
1783
  */
1844
1784
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
1845
1785
  capability: 'mid',
1846
- tier: 'sonnet',
1847
1786
  notes: 'Implicit caching is automatic above 4,096 tokens. Explicit caching is also billed for storage:'
1848
1787
  + ' $0.50 per 1M tokens per hour through 2026-12-31, $1.00 after.',
1849
1788
  },
@@ -1871,7 +1810,6 @@ export const MODELS = [
1871
1810
  /* $0.075 / $0.75 = 0.1 (and $0.15 / $1.50); batch $0.375 / $0.75 = 0.5 (and $1.875 / $3.75). */
1872
1811
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
1873
1812
  capability: 'mid',
1874
- tier: 'sonnet',
1875
1813
  notes: 'Implicit caching is automatic above 4,096 tokens. Explicit caching is also billed for storage:'
1876
1814
  + ' $0.50 per 1M tokens per hour through 2026-12-31, $1.00 after.',
1877
1815
  },
@@ -1915,7 +1853,6 @@ export const MODELS = [
1915
1853
  },
1916
1854
  ],
1917
1855
  capability: 'large',
1918
- tier: 'opus',
1919
1856
  notes: 'Priced per request by prompt length: $2/$12 up to 200,000 input tokens and $4/$18 over it.'
1920
1857
  + ' Implicit caching is automatic above 4,096 tokens; explicit caching is also billed for storage,'
1921
1858
  + ' $4.50 per 1M tokens per hour.',
@@ -1960,7 +1897,6 @@ export const MODELS = [
1960
1897
  caching: 'automatic',
1961
1898
  multipliers: { cacheRead: 0.05, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
1962
1899
  capability: 'frontier',
1963
- tier: 'frontier',
1964
1900
  notes: GEMINI_4_NOTE,
1965
1901
  },
1966
1902
  {
@@ -1975,7 +1911,6 @@ export const MODELS = [
1975
1911
  caching: 'automatic',
1976
1912
  multipliers: { cacheRead: 0.05, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
1977
1913
  capability: 'frontier',
1978
- tier: 'frontier',
1979
1914
  notes: GEMINI_4_NOTE,
1980
1915
  },
1981
1916
  {
@@ -1989,7 +1924,6 @@ export const MODELS = [
1989
1924
  caching: 'automatic',
1990
1925
  multipliers: { cacheRead: 0.05, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
1991
1926
  capability: 'mid',
1992
- tier: 'sonnet',
1993
1927
  notes: GEMINI_4_NOTE,
1994
1928
  },
1995
1929
  {
@@ -2014,7 +1948,6 @@ export const MODELS = [
2014
1948
  caching: 'automatic',
2015
1949
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
2016
1950
  capability: 'small',
2017
- tier: 'haiku',
2018
1951
  notes: 'Implicit caching is automatic, and no minimum prefix length is published for this model. Explicit caching is'
2019
1952
  + ' also billed for storage, $1.00 per 1M tokens per hour.',
2020
1953
  },
@@ -2054,7 +1987,6 @@ export const MODELS = [
2054
1987
  caching: 'automatic',
2055
1988
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 2, batch: 0.6 },
2056
1989
  capability: 'frontier',
2057
- tier: 'frontier',
2058
1990
  notes: 'Cache writes are billed as their own line: 1x input for a 5-minute entry, 2x for an hour.'
2059
1991
  + ` ${NO_PUBLISHED_CACHE_MINIMUM}`,
2060
1992
  },
@@ -2073,7 +2005,6 @@ export const MODELS = [
2073
2005
  caching: 'automatic',
2074
2006
  multipliers: { cacheRead: 0.05, cacheWrite5m: 1, cacheWrite1h: 2, batch: null },
2075
2007
  capability: 'frontier',
2076
- tier: 'frontier',
2077
2008
  notes: 'Cache writes are billed as their own line: 1x input for a 5-minute entry, 2x for an hour.'
2078
2009
  + ` No batch API for this model. ${NO_PUBLISHED_CACHE_MINIMUM}`,
2079
2010
  },
@@ -2088,7 +2019,6 @@ export const MODELS = [
2088
2019
  caching: 'automatic',
2089
2020
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 2, batch: 0.6 },
2090
2021
  capability: 'frontier',
2091
- tier: 'frontier',
2092
2022
  notes: 'Cache writes are billed as their own line: 1x input for a 5-minute entry, 2x for an hour.'
2093
2023
  + ` Batch at 60% since the batch page listed it (read 2026-11-05). ${NO_PUBLISHED_CACHE_MINIMUM}`,
2094
2024
  },
@@ -2106,7 +2036,6 @@ export const MODELS = [
2106
2036
  /* $0.19 on a hit against $0.95; batch $0.57 / $2.40, 60%. */
2107
2037
  multipliers: { cacheRead: 0.2, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.6 },
2108
2038
  capability: 'mid',
2109
- tier: 'sonnet',
2110
2039
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2111
2040
  },
2112
2041
  {
@@ -2123,7 +2052,6 @@ export const MODELS = [
2123
2052
  /* $0.38 on a hit against $1.90; no batch API for this variant. */
2124
2053
  multipliers: { cacheRead: 0.2, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2125
2054
  capability: 'mid',
2126
- tier: 'sonnet',
2127
2055
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2128
2056
  },
2129
2057
  {
@@ -2140,7 +2068,6 @@ export const MODELS = [
2140
2068
  /* $0.16 on a hit against $0.95, written as the ratio so the product is the page's figure. */
2141
2069
  multipliers: { cacheRead: 0.16 / 0.95, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.6 },
2142
2070
  capability: 'mid',
2143
- tier: 'sonnet',
2144
2071
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2145
2072
  },
2146
2073
  {
@@ -2163,7 +2090,6 @@ export const MODELS = [
2163
2090
  */
2164
2091
  recommendable: false,
2165
2092
  capability: 'mid',
2166
- tier: 'sonnet',
2167
2093
  notes: 'Discontinued by Moonshot on 2026-05-25; priced at the last rate it published. No batch API.'
2168
2094
  + ` ${NO_PUBLISHED_CACHE_MINIMUM}`,
2169
2095
  },
@@ -2186,7 +2112,6 @@ export const MODELS = [
2186
2112
  because: 'The supported API model names are deepseek-v4-pro, deepseek-v4-flash, and deepseek-v4-flash-vision-exp, but you passed deepseek-v3.',
2187
2113
  },
2188
2114
  capability: 'mid',
2189
- tier: 'sonnet',
2190
2115
  },
2191
2116
  {
2192
2117
  /*
@@ -2243,7 +2168,6 @@ export const MODELS = [
2243
2168
  /* $0.003 cache hit against $0.15 input off-peak, $0.006 against $0.30 at peak. */
2244
2169
  multipliers: { cacheRead: 0.02, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2245
2170
  capability: 'mid',
2246
- tier: 'sonnet',
2247
2171
  notes: 'Retired 2026-09-10: the id is still accepted, served by V4.1 Flash and billed at the deepseek-flash price.'
2248
2172
  + ' Maximum output 384K tokens. Peak excludes Chinese public holidays, which this table cannot express.',
2249
2173
  },
@@ -2276,7 +2200,6 @@ export const MODELS = [
2276
2200
  caching: 'automatic',
2277
2201
  multipliers: { cacheRead: 0.02, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2278
2202
  capability: 'mid',
2279
- tier: 'sonnet',
2280
2203
  notes: 'Maximum output 384K tokens. Peak excludes Chinese public holidays, which this table cannot express:'
2281
2204
  + ' on a weekday holiday it charges peak where DeepSeek charges off-peak.',
2282
2205
  },
@@ -2301,7 +2224,6 @@ export const MODELS = [
2301
2224
  /* $0.022 cache hit against $0.66 input off-peak. */
2302
2225
  multipliers: { cacheRead: 0.0333, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2303
2226
  capability: 'large',
2304
- tier: 'opus',
2305
2227
  notes: 'Maximum output 384K tokens.',
2306
2228
  },
2307
2229
  // ------------------------------------------------------------------------
@@ -2329,7 +2251,6 @@ export const MODELS = [
2329
2251
  multipliers: { cacheRead: 0.25, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2330
2252
  tiers: [GROK_LONG(4, 12)],
2331
2253
  capability: 'frontier',
2332
- tier: 'frontier',
2333
2254
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2334
2255
  },
2335
2256
  {
@@ -2344,7 +2265,6 @@ export const MODELS = [
2344
2265
  multipliers: { cacheRead: 0.25, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2345
2266
  tiers: [GROK_LONG(4, 12)],
2346
2267
  capability: 'large',
2347
- tier: 'opus',
2348
2268
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2349
2269
  },
2350
2270
  {
@@ -2360,7 +2280,6 @@ export const MODELS = [
2360
2280
  multipliers: { cacheRead: 0.15, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2361
2281
  tiers: [GROK_LONG(4, 12)],
2362
2282
  capability: 'large',
2363
- tier: 'opus',
2364
2283
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2365
2284
  },
2366
2285
  {
@@ -2376,7 +2295,6 @@ export const MODELS = [
2376
2295
  multipliers: { cacheRead: 0.16, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.8 },
2377
2296
  tiers: [GROK_LONG(2.5, 5)],
2378
2297
  capability: 'mid',
2379
- tier: 'sonnet',
2380
2298
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2381
2299
  },
2382
2300
  {
@@ -2392,7 +2310,6 @@ export const MODELS = [
2392
2310
  multipliers: { cacheRead: 0.16, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.8 },
2393
2311
  tiers: [GROK_LONG(2.5, 5)],
2394
2312
  capability: 'mid',
2395
- tier: 'sonnet',
2396
2313
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2397
2314
  },
2398
2315
  {
@@ -2408,7 +2325,6 @@ export const MODELS = [
2408
2325
  multipliers: { cacheRead: 0.16, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.8 },
2409
2326
  tiers: [GROK_LONG(2.5, 5)],
2410
2327
  capability: 'mid',
2411
- tier: 'sonnet',
2412
2328
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2413
2329
  },
2414
2330
  {
@@ -2424,7 +2340,6 @@ export const MODELS = [
2424
2340
  multipliers: { cacheRead: 0.16, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.8 },
2425
2341
  tiers: [GROK_LONG(2.5, 5)],
2426
2342
  capability: 'mid',
2427
- tier: 'sonnet',
2428
2343
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2429
2344
  },
2430
2345
  {
@@ -2439,7 +2354,6 @@ export const MODELS = [
2439
2354
  multipliers: { cacheRead: 0.2, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
2440
2355
  tiers: [GROK_LONG(2, 4)],
2441
2356
  capability: 'mid',
2442
- tier: 'sonnet',
2443
2357
  notes: NO_PUBLISHED_CACHE_MINIMUM,
2444
2358
  },
2445
2359
  {
@@ -2472,7 +2386,6 @@ export const MODELS = [
2472
2386
  ],
2473
2387
  recommendable: false,
2474
2388
  capability: 'large',
2475
- tier: 'opus',
2476
2389
  notes: 'Retired by xAI on 2026-05-15 and redirected to Grok 4.3, whose price it bills at from then;'
2477
2390
  + ` $3/$15 before. ${NO_PUBLISHED_CACHE_MINIMUM}`,
2478
2391
  },
@@ -2495,7 +2408,6 @@ export const MODELS = [
2495
2408
  because: 'Invalid model: mistral-large-2',
2496
2409
  },
2497
2410
  capability: 'large',
2498
- tier: 'opus',
2499
2411
  notes: 'No prompt caching: reordering still helps readability but saves nothing here.',
2500
2412
  },
2501
2413
  {
@@ -2526,7 +2438,6 @@ export const MODELS = [
2526
2438
  caching: 'unknown',
2527
2439
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
2528
2440
  capability: 'large',
2529
- tier: 'opus',
2530
2441
  notes: MISTRAL_CACHE_NOTE,
2531
2442
  },
2532
2443
  {
@@ -2554,7 +2465,6 @@ export const MODELS = [
2554
2465
  caching: 'unknown',
2555
2466
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
2556
2467
  capability: 'mid',
2557
- tier: 'sonnet',
2558
2468
  notes: MISTRAL_CACHE_NOTE,
2559
2469
  },
2560
2470
  {
@@ -2570,7 +2480,6 @@ export const MODELS = [
2570
2480
  caching: 'unknown',
2571
2481
  multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
2572
2482
  capability: 'small',
2573
- tier: 'haiku',
2574
2483
  notes: MISTRAL_CACHE_NOTE,
2575
2484
  },
2576
2485
  ];
@@ -2634,12 +2543,15 @@ export function modelFrom(catalogue, id) {
2634
2543
  return model;
2635
2544
  }
2636
2545
  /**
2637
- * Cheapest model of a tier within a catalogue.
2546
+ * Cheapest model of a capability within a catalogue.
2547
+ *
2548
+ * Takes the names `recommendTier` answers in, which are the names of the
2549
+ * `capability` a model carries.
2638
2550
  *
2639
2551
  * Compared on the **effective** price, so a model in a promotional window is
2640
2552
  * ranked at what it actually costs today rather than at its list price.
2641
2553
  */
2642
- export function cheapestOfTierIn(catalogue, tier, on = new Date(),
2554
+ export function cheapestOfCapabilityIn(catalogue, capability, on = new Date(),
2643
2555
  /**
2644
2556
  * Restrict to one provider. Omit to search the whole catalogue, which is what
2645
2557
  * this did before other providers existed — kept as the default so the
@@ -2647,12 +2559,12 @@ export function cheapestOfTierIn(catalogue, tier, on = new Date(),
2647
2559
  * vendor is a migration, not a cheaper model.
2648
2560
  */
2649
2561
  provider) {
2650
- const candidates = catalogue.models.filter((m) => m.tier === tier &&
2562
+ const candidates = catalogue.models.filter((m) => m.capability === capability &&
2651
2563
  isOffered(m) &&
2652
2564
  (provider === undefined || m.provider === provider));
2653
2565
  const first = candidates[0];
2654
2566
  if (!first)
2655
- throw new Error(`No models for tier "${tier}"`);
2567
+ throw new Error(`No models for capability "${capability}"`);
2656
2568
  return candidates.reduce((best, m) => effectivePricing(m, on).inputPerMTok < effectivePricing(best, on).inputPerMTok ? m : best, first);
2657
2569
  }
2658
2570
  export function getModel(id) {
@@ -3045,12 +2957,12 @@ export function reviewedForModels(models, catalogue) {
3045
2957
  date stands rather than an absence being read as freshness. */
3046
2958
  return oldest ?? catalogue.lastReviewed;
3047
2959
  }
3048
- /** Cheapest model of each capability tier, for recommendations. */
3049
- export function cheapestOfTier(tier) {
3050
- const candidates = MODELS.filter((m) => m.tier === tier && isOffered(m));
2960
+ /** Cheapest model of a capability across the bundled catalogue, for recommendations. */
2961
+ export function cheapestOfCapability(capability) {
2962
+ const candidates = MODELS.filter((m) => m.capability === capability && isOffered(m));
3051
2963
  const first = candidates[0];
3052
2964
  if (!first)
3053
- throw new Error(`No models for tier "${tier}"`);
2965
+ throw new Error(`No models for capability "${capability}"`);
3054
2966
  return candidates.reduce((best, m) => (m.inputPerMTok < best.inputPerMTok ? m : best), first);
3055
2967
  }
3056
2968
  /**