@ancplua/qyl-api-schema 1.0.2 → 1.0.3

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.
@@ -1029,1929 +1029,6 @@
1029
1029
  "maxLength": 256,
1030
1030
  "description": "User identifier (pseudonymized for privacy)"
1031
1031
  },
1032
- "Cost.GenAiEtlAuditCluster": {
1033
- "type": "object",
1034
- "required": [
1035
- "cluster_id",
1036
- "workflow_key",
1037
- "service_name",
1038
- "output_contract",
1039
- "task_family",
1040
- "call_count",
1041
- "input_tokens",
1042
- "output_tokens",
1043
- "cache_read_input_tokens",
1044
- "cache_creation_input_tokens",
1045
- "reasoning_output_tokens",
1046
- "error_count",
1047
- "error_rate",
1048
- "average_latency_ms",
1049
- "p95_latency_ms",
1050
- "catalog_token_estimate",
1051
- "candidate_status",
1052
- "candidate_path",
1053
- "validation_metrics",
1054
- "residual_path",
1055
- "evidence_signals",
1056
- "missing_evidence",
1057
- "promotion_gates"
1058
- ],
1059
- "properties": {
1060
- "cluster_id": {
1061
- "type": "string",
1062
- "description": "Stable identifier derived from the privacy-safe cluster dimensions."
1063
- },
1064
- "workflow_key": {
1065
- "type": "string",
1066
- "description": "Privacy-safe derived grouping identity used to group repeated calls."
1067
- },
1068
- "service_name": {
1069
- "type": "string"
1070
- },
1071
- "span_name": {
1072
- "type": "string",
1073
- "description": "Present only when an upstream source proves or canonicalizes a low-cardinality, privacy-safe span name."
1074
- },
1075
- "operation_name": {
1076
- "type": "string"
1077
- },
1078
- "provider": {
1079
- "type": "string"
1080
- },
1081
- "model": {
1082
- "type": "string"
1083
- },
1084
- "output_contract": {
1085
- "$ref": "#/$defs/Cost.GenAiEtlOutputContract"
1086
- },
1087
- "task_family": {
1088
- "$ref": "#/$defs/Cost.GenAiEtlTaskFamily"
1089
- },
1090
- "call_count": {
1091
- "$ref": "#/$defs/Common.Count"
1092
- },
1093
- "input_tokens": {
1094
- "$ref": "#/$defs/Common.TokenCount"
1095
- },
1096
- "output_tokens": {
1097
- "$ref": "#/$defs/Common.TokenCount"
1098
- },
1099
- "cache_read_input_tokens": {
1100
- "$ref": "#/$defs/Common.TokenCount"
1101
- },
1102
- "cache_creation_input_tokens": {
1103
- "$ref": "#/$defs/Common.TokenCount"
1104
- },
1105
- "reasoning_output_tokens": {
1106
- "$ref": "#/$defs/Common.TokenCount"
1107
- },
1108
- "error_count": {
1109
- "$ref": "#/$defs/Common.Count"
1110
- },
1111
- "error_rate": {
1112
- "$ref": "#/$defs/Common.Ratio"
1113
- },
1114
- "average_latency_ms": {
1115
- "$ref": "#/$defs/Common.DurationMs"
1116
- },
1117
- "p95_latency_ms": {
1118
- "$ref": "#/$defs/Common.DurationMs"
1119
- },
1120
- "catalog_token_estimate": {
1121
- "allOf": [
1122
- {
1123
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenCostEstimate"
1124
- }
1125
- ],
1126
- "description": "Outcome and, when calculated, detailed current-catalog token-and-request estimate for this cluster. Aggregate provider billing is never attributed to a cluster."
1127
- },
1128
- "measurable_coverage": {
1129
- "allOf": [
1130
- {
1131
- "$ref": "#/$defs/Common.Ratio"
1132
- }
1133
- ],
1134
- "description": "Fraction of calls with a task-specific correctness signal."
1135
- },
1136
- "safe_deferral_coverage": {
1137
- "allOf": [
1138
- {
1139
- "$ref": "#/$defs/Common.Ratio"
1140
- }
1141
- ],
1142
- "description": "Fraction of calls proven safe to route to a residual path."
1143
- },
1144
- "candidate_status": {
1145
- "allOf": [
1146
- {
1147
- "$ref": "#/$defs/Cost.GenAiEtlCandidateStatus"
1148
- }
1149
- ],
1150
- "description": "Evidence status qualifying the proposed candidate path."
1151
- },
1152
- "candidate_path": {
1153
- "$ref": "#/$defs/Cost.GenAiEtlCandidatePath"
1154
- },
1155
- "validation_metrics": {
1156
- "type": "array",
1157
- "items": {
1158
- "$ref": "#/$defs/Cost.GenAiEtlValidationMetric"
1159
- },
1160
- "minItems": 1,
1161
- "description": "Task-specific metrics required to falsify the proposed replacement."
1162
- },
1163
- "residual_path": {
1164
- "$ref": "#/$defs/Cost.GenAiEtlResidualPath"
1165
- },
1166
- "evidence_signals": {
1167
- "type": "array",
1168
- "items": {
1169
- "$ref": "#/$defs/Cost.GenAiEtlEvidenceSignal"
1170
- }
1171
- },
1172
- "missing_evidence": {
1173
- "type": "array",
1174
- "items": {
1175
- "$ref": "#/$defs/Cost.GenAiEtlEvidenceSignal"
1176
- }
1177
- },
1178
- "promotion_gates": {
1179
- "type": "array",
1180
- "items": {
1181
- "$ref": "#/$defs/Cost.GenAiEtlPromotionGate"
1182
- }
1183
- }
1184
- },
1185
- "unevaluatedProperties": {
1186
- "not": {}
1187
- },
1188
- "description": "Observed economics and evidence for one repeated GenAI workflow cluster."
1189
- },
1190
- "Cost.GenAiEtlAuditEvaluationRequest": {
1191
- "type": "object",
1192
- "required": [
1193
- "scenarios"
1194
- ],
1195
- "properties": {
1196
- "scenarios": {
1197
- "type": "array",
1198
- "items": {
1199
- "$ref": "#/$defs/Cost.GenAiEtlClusterScenario"
1200
- },
1201
- "minItems": 1,
1202
- "maxItems": 100
1203
- }
1204
- },
1205
- "unevaluatedProperties": {
1206
- "not": {}
1207
- },
1208
- "description": "Batch of cluster scenarios evaluated against one audit period."
1209
- },
1210
- "Cost.GenAiEtlAuditEvaluationResponse": {
1211
- "type": "object",
1212
- "required": [
1213
- "generated_at",
1214
- "period_start",
1215
- "period_end",
1216
- "results"
1217
- ],
1218
- "properties": {
1219
- "generated_at": {
1220
- "type": "string",
1221
- "format": "date-time"
1222
- },
1223
- "period_start": {
1224
- "type": "string",
1225
- "format": "date-time"
1226
- },
1227
- "period_end": {
1228
- "type": "string",
1229
- "format": "date-time"
1230
- },
1231
- "results": {
1232
- "type": "array",
1233
- "items": {
1234
- "$ref": "#/$defs/Cost.GenAiEtlClusterEvaluation"
1235
- }
1236
- }
1237
- },
1238
- "unevaluatedProperties": {
1239
- "not": {}
1240
- },
1241
- "description": "Batch result for ETL replacement scenarios."
1242
- },
1243
- "Cost.GenAiEtlAuditReport": {
1244
- "type": "object",
1245
- "required": [
1246
- "generated_at",
1247
- "period_start",
1248
- "period_end",
1249
- "summary",
1250
- "billing_sources",
1251
- "catalog_sources",
1252
- "clusters"
1253
- ],
1254
- "properties": {
1255
- "generated_at": {
1256
- "type": "string",
1257
- "format": "date-time"
1258
- },
1259
- "period_start": {
1260
- "type": "string",
1261
- "format": "date-time"
1262
- },
1263
- "period_end": {
1264
- "type": "string",
1265
- "format": "date-time"
1266
- },
1267
- "summary": {
1268
- "$ref": "#/$defs/Cost.GenAiEtlAuditSummary"
1269
- },
1270
- "billing_sources": {
1271
- "type": "array",
1272
- "items": {
1273
- "$ref": "#/$defs/Cost.ProviderBillingSource"
1274
- },
1275
- "description": "Provider-owned aggregate billing sources. These totals are not attributed to clusters or used as evaluation baselines."
1276
- },
1277
- "catalog_sources": {
1278
- "type": "array",
1279
- "items": {
1280
- "$ref": "#/$defs/Cost.ModelCatalogSource"
1281
- },
1282
- "description": "Configured live model catalog sources and their current synchronization state."
1283
- },
1284
- "clusters": {
1285
- "type": "array",
1286
- "items": {
1287
- "$ref": "#/$defs/Cost.GenAiEtlAuditCluster"
1288
- }
1289
- }
1290
- },
1291
- "unevaluatedProperties": {
1292
- "not": {}
1293
- },
1294
- "description": "Trace-level ETL audit for a bounded period."
1295
- },
1296
- "Cost.GenAiEtlAuditSummary": {
1297
- "type": "object",
1298
- "required": [
1299
- "total_calls",
1300
- "total_input_tokens",
1301
- "total_output_tokens",
1302
- "catalog_token_priced_call_coverage"
1303
- ],
1304
- "properties": {
1305
- "total_calls": {
1306
- "$ref": "#/$defs/Common.Count"
1307
- },
1308
- "total_input_tokens": {
1309
- "$ref": "#/$defs/Common.TokenCount"
1310
- },
1311
- "total_output_tokens": {
1312
- "$ref": "#/$defs/Common.TokenCount"
1313
- },
1314
- "estimated_catalog_token_cost_usd": {
1315
- "allOf": [
1316
- {
1317
- "$ref": "#/$defs/Common.CostUsd"
1318
- }
1319
- ],
1320
- "description": "Counterfactual token and request cost of the full observed audit population before the cluster response limit is applied, using the current live catalog snapshot; this is not an official billed total or a historical price claim."
1321
- },
1322
- "catalog_token_priced_call_coverage": {
1323
- "allOf": [
1324
- {
1325
- "$ref": "#/$defs/Common.Ratio"
1326
- }
1327
- ],
1328
- "description": "Fraction of observed calls covered by all-or-nothing calculated token-and-request estimates; missing pricing is not treated as zero."
1329
- },
1330
- "estimated_token_economic_concentration": {
1331
- "allOf": [
1332
- {
1333
- "$ref": "#/$defs/Common.Ratio"
1334
- }
1335
- ],
1336
- "description": "Returned top-cluster token-and-request estimate divided by estimated_catalog_token_cost_usd for the full observed audit population."
1337
- },
1338
- "measurable_coverage": {
1339
- "allOf": [
1340
- {
1341
- "$ref": "#/$defs/Common.Ratio"
1342
- }
1343
- ],
1344
- "description": "Fraction of calls with a task-specific correctness signal."
1345
- },
1346
- "safe_deferral_coverage": {
1347
- "allOf": [
1348
- {
1349
- "$ref": "#/$defs/Common.Ratio"
1350
- }
1351
- ],
1352
- "description": "Fraction of calls proven safe to defer to a residual path."
1353
- },
1354
- "candidate_etl_estimated_token_spend_share": {
1355
- "allOf": [
1356
- {
1357
- "$ref": "#/$defs/Common.Ratio"
1358
- }
1359
- ],
1360
- "description": "Fraction of estimated current-catalog token-and-request spend attached to ETL-shaped candidates."
1361
- }
1362
- },
1363
- "unevaluatedProperties": {
1364
- "not": {}
1365
- },
1366
- "description": "Aggregate trace-level economics for the requested audit period."
1367
- },
1368
- "Cost.GenAiEtlCalculatedClusterEvaluationBase": {
1369
- "type": "object",
1370
- "required": [
1371
- "status",
1372
- "frontier_cost_per_call_usd",
1373
- "current_period_cost_usd",
1374
- "gross_replaceable_value_usd",
1375
- "net_replaceable_value_usd"
1376
- ],
1377
- "properties": {
1378
- "status": {
1379
- "type": "string",
1380
- "enum": [
1381
- "calculated"
1382
- ]
1383
- },
1384
- "frontier_cost_per_call_usd": {
1385
- "$ref": "#/$defs/Common.CostUsd"
1386
- },
1387
- "current_period_cost_usd": {
1388
- "$ref": "#/$defs/Common.CostUsd"
1389
- },
1390
- "gross_replaceable_value_usd": {
1391
- "type": "number",
1392
- "format": "double"
1393
- },
1394
- "net_replaceable_value_usd": {
1395
- "type": "number",
1396
- "format": "double",
1397
- "description": "Net period value; this may be negative when maintenance or error cost exceeds gross savings."
1398
- }
1399
- },
1400
- "allOf": [
1401
- {
1402
- "$ref": "#/$defs/Cost.GenAiEtlClusterEvaluationBase"
1403
- }
1404
- ]
1405
- },
1406
- "Cost.GenAiEtlCandidatePath": {
1407
- "type": "string",
1408
- "enum": [
1409
- "exact_cache",
1410
- "deterministic_code",
1411
- "bounded_retrieval",
1412
- "small_classifier_extractor",
1413
- "smaller_generative_model",
1414
- "frontier_model",
1415
- "insufficient_evidence"
1416
- ],
1417
- "description": "Lowest-risk implementation class suggested by currently available evidence."
1418
- },
1419
- "Cost.GenAiEtlCandidateStatus": {
1420
- "type": "string",
1421
- "enum": [
1422
- "hypothesis_only",
1423
- "insufficient_evidence"
1424
- ],
1425
- "description": "Evidence status of the proposed replacement path."
1426
- },
1427
- "Cost.GenAiEtlCatalogTokenAmbiguousModelEstimate": {
1428
- "type": "object",
1429
- "required": [
1430
- "status"
1431
- ],
1432
- "properties": {
1433
- "status": {
1434
- "type": "string",
1435
- "enum": [
1436
- "ambiguous_model"
1437
- ]
1438
- }
1439
- },
1440
- "unevaluatedProperties": {
1441
- "not": {}
1442
- },
1443
- "allOf": [
1444
- {
1445
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1446
- }
1447
- ]
1448
- },
1449
- "Cost.GenAiEtlCatalogTokenCalculatedEstimate": {
1450
- "type": "object",
1451
- "required": [
1452
- "status",
1453
- "estimated_catalog_token_cost_usd",
1454
- "estimated_catalog_token_cost_per_call_usd",
1455
- "provenance",
1456
- "components"
1457
- ],
1458
- "properties": {
1459
- "status": {
1460
- "type": "string",
1461
- "enum": [
1462
- "calculated"
1463
- ]
1464
- },
1465
- "estimated_catalog_token_cost_usd": {
1466
- "allOf": [
1467
- {
1468
- "$ref": "#/$defs/Common.CostUsd"
1469
- }
1470
- ],
1471
- "description": "Estimated token and request cost for the reported cluster period using the current catalog snapshot; this is counterfactual for historical periods and is not an official billed total."
1472
- },
1473
- "estimated_catalog_token_cost_per_call_usd": {
1474
- "allOf": [
1475
- {
1476
- "$ref": "#/$defs/Common.CostUsd"
1477
- }
1478
- ],
1479
- "description": "Estimated token and request cost per observed cluster call; this is not an official billed total."
1480
- },
1481
- "provenance": {
1482
- "allOf": [
1483
- {
1484
- "$ref": "#/$defs/Cost.ModelCatalogPriceProvenance"
1485
- }
1486
- ],
1487
- "description": "Exact catalog snapshot and model-match evidence."
1488
- },
1489
- "components": {
1490
- "type": "array",
1491
- "items": {
1492
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateComponent"
1493
- },
1494
- "minItems": 1,
1495
- "description": "Included token or request usage and rate contributions. Ordered source overrides carry conditional evidence; ordinary inclusive subtype replacements do not require it."
1496
- },
1497
- "exclusions": {
1498
- "type": "array",
1499
- "items": {
1500
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateExclusion"
1501
- },
1502
- "minItems": 1,
1503
- "description": "Meters or conditional adjustments explicitly omitted from this calculated estimate."
1504
- }
1505
- },
1506
- "unevaluatedProperties": {
1507
- "not": {}
1508
- },
1509
- "description": "Calculated all-or-nothing current-catalog token and request estimate for a complete workflow cluster."
1510
- },
1511
- "Cost.GenAiEtlCatalogTokenClusterEvaluation": {
1512
- "type": "object",
1513
- "required": [
1514
- "frontier_cost_basis",
1515
- "catalog_provenance"
1516
- ],
1517
- "properties": {
1518
- "frontier_cost_basis": {
1519
- "type": "string",
1520
- "enum": [
1521
- "catalog_token_estimate"
1522
- ]
1523
- },
1524
- "catalog_provenance": {
1525
- "allOf": [
1526
- {
1527
- "$ref": "#/$defs/Cost.ModelCatalogPriceProvenance"
1528
- }
1529
- ],
1530
- "description": "Exact live-catalog snapshot and model-match evidence used for the calculated frontier cost."
1531
- }
1532
- },
1533
- "unevaluatedProperties": {
1534
- "not": {}
1535
- },
1536
- "allOf": [
1537
- {
1538
- "$ref": "#/$defs/Cost.GenAiEtlCalculatedClusterEvaluationBase"
1539
- }
1540
- ]
1541
- },
1542
- "Cost.GenAiEtlCatalogTokenConditionalPricingUnresolvableEstimate": {
1543
- "type": "object",
1544
- "required": [
1545
- "status"
1546
- ],
1547
- "properties": {
1548
- "status": {
1549
- "type": "string",
1550
- "enum": [
1551
- "conditional_pricing_unresolvable"
1552
- ]
1553
- }
1554
- },
1555
- "unevaluatedProperties": {
1556
- "not": {}
1557
- },
1558
- "allOf": [
1559
- {
1560
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1561
- }
1562
- ]
1563
- },
1564
- "Cost.GenAiEtlCatalogTokenCostEstimate": {
1565
- "oneOf": [
1566
- {
1567
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenCalculatedEstimate"
1568
- },
1569
- {
1570
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenSourceUnavailableEstimate"
1571
- },
1572
- {
1573
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenStaleSourceEstimate"
1574
- },
1575
- {
1576
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenMissingModelIdentityEstimate"
1577
- },
1578
- {
1579
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenModelNotFoundEstimate"
1580
- },
1581
- {
1582
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenAmbiguousModelEstimate"
1583
- },
1584
- {
1585
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenIncompleteUsageEstimate"
1586
- },
1587
- {
1588
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenConditionalPricingUnresolvableEstimate"
1589
- },
1590
- {
1591
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenUnsupportedPricingEstimate"
1592
- }
1593
- ],
1594
- "description": "All-or-nothing current-catalog token and request estimate. The status literal selects the complete calculated or fail-closed response shape."
1595
- },
1596
- "Cost.GenAiEtlCatalogTokenEstimateFailureBase": {
1597
- "type": "object",
1598
- "properties": {
1599
- "exclusions": {
1600
- "type": "array",
1601
- "items": {
1602
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateExclusion"
1603
- },
1604
- "minItems": 1,
1605
- "description": "Available meter or conditional evidence explaining why the cluster estimate failed closed."
1606
- }
1607
- }
1608
- },
1609
- "Cost.GenAiEtlCatalogTokenIncompleteUsageEstimate": {
1610
- "type": "object",
1611
- "required": [
1612
- "status"
1613
- ],
1614
- "properties": {
1615
- "status": {
1616
- "type": "string",
1617
- "enum": [
1618
- "incomplete_usage"
1619
- ]
1620
- }
1621
- },
1622
- "unevaluatedProperties": {
1623
- "not": {}
1624
- },
1625
- "allOf": [
1626
- {
1627
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1628
- }
1629
- ]
1630
- },
1631
- "Cost.GenAiEtlCatalogTokenMissingModelIdentityEstimate": {
1632
- "type": "object",
1633
- "required": [
1634
- "status"
1635
- ],
1636
- "properties": {
1637
- "status": {
1638
- "type": "string",
1639
- "enum": [
1640
- "missing_model_identity"
1641
- ]
1642
- }
1643
- },
1644
- "unevaluatedProperties": {
1645
- "not": {}
1646
- },
1647
- "allOf": [
1648
- {
1649
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1650
- }
1651
- ]
1652
- },
1653
- "Cost.GenAiEtlCatalogTokenModelNotFoundEstimate": {
1654
- "type": "object",
1655
- "required": [
1656
- "status"
1657
- ],
1658
- "properties": {
1659
- "status": {
1660
- "type": "string",
1661
- "enum": [
1662
- "model_not_found"
1663
- ]
1664
- }
1665
- },
1666
- "unevaluatedProperties": {
1667
- "not": {}
1668
- },
1669
- "allOf": [
1670
- {
1671
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1672
- }
1673
- ]
1674
- },
1675
- "Cost.GenAiEtlCatalogTokenSourceUnavailableEstimate": {
1676
- "type": "object",
1677
- "required": [
1678
- "status"
1679
- ],
1680
- "properties": {
1681
- "status": {
1682
- "type": "string",
1683
- "enum": [
1684
- "source_unavailable"
1685
- ]
1686
- }
1687
- },
1688
- "unevaluatedProperties": {
1689
- "not": {}
1690
- },
1691
- "allOf": [
1692
- {
1693
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1694
- }
1695
- ]
1696
- },
1697
- "Cost.GenAiEtlCatalogTokenStaleSourceEstimate": {
1698
- "type": "object",
1699
- "required": [
1700
- "status"
1701
- ],
1702
- "properties": {
1703
- "status": {
1704
- "type": "string",
1705
- "enum": [
1706
- "stale_source"
1707
- ]
1708
- }
1709
- },
1710
- "unevaluatedProperties": {
1711
- "not": {}
1712
- },
1713
- "allOf": [
1714
- {
1715
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1716
- }
1717
- ]
1718
- },
1719
- "Cost.GenAiEtlCatalogTokenUnsupportedPricingEstimate": {
1720
- "type": "object",
1721
- "required": [
1722
- "status"
1723
- ],
1724
- "properties": {
1725
- "status": {
1726
- "type": "string",
1727
- "enum": [
1728
- "unsupported_pricing"
1729
- ]
1730
- }
1731
- },
1732
- "unevaluatedProperties": {
1733
- "not": {}
1734
- },
1735
- "allOf": [
1736
- {
1737
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenEstimateFailureBase"
1738
- }
1739
- ]
1740
- },
1741
- "Cost.GenAiEtlClusterEvaluation": {
1742
- "oneOf": [
1743
- {
1744
- "$ref": "#/$defs/Cost.GenAiEtlScenarioClusterEvaluation"
1745
- },
1746
- {
1747
- "$ref": "#/$defs/Cost.GenAiEtlCatalogTokenClusterEvaluation"
1748
- },
1749
- {
1750
- "$ref": "#/$defs/Cost.GenAiEtlUnavailableClusterEvaluation"
1751
- }
1752
- ],
1753
- "description": "Result of replaceable_value = calls * coverage * (frontier - alternative) - maintenance - error. The frontier_cost_basis literal selects a complete calculated result or a fail-closed unavailable result."
1754
- },
1755
- "Cost.GenAiEtlClusterEvaluationBase": {
1756
- "type": "object",
1757
- "required": [
1758
- "cluster_id",
1759
- "call_count",
1760
- "coverage",
1761
- "served_call_count",
1762
- "residual_call_count",
1763
- "alternative_cost_per_call_usd",
1764
- "period_maintenance_cost_usd",
1765
- "period_error_cost_usd"
1766
- ],
1767
- "properties": {
1768
- "cluster_id": {
1769
- "type": "string"
1770
- },
1771
- "call_count": {
1772
- "$ref": "#/$defs/Common.Count"
1773
- },
1774
- "coverage": {
1775
- "$ref": "#/$defs/Common.Ratio"
1776
- },
1777
- "served_call_count": {
1778
- "type": "number",
1779
- "format": "double"
1780
- },
1781
- "residual_call_count": {
1782
- "type": "number",
1783
- "format": "double"
1784
- },
1785
- "alternative_cost_per_call_usd": {
1786
- "$ref": "#/$defs/Common.CostUsd"
1787
- },
1788
- "period_maintenance_cost_usd": {
1789
- "$ref": "#/$defs/Common.CostUsd"
1790
- },
1791
- "period_error_cost_usd": {
1792
- "$ref": "#/$defs/Common.CostUsd"
1793
- }
1794
- }
1795
- },
1796
- "Cost.GenAiEtlClusterScenario": {
1797
- "type": "object",
1798
- "required": [
1799
- "cluster_id",
1800
- "coverage",
1801
- "alternative_cost_per_call_usd",
1802
- "period_maintenance_cost_usd",
1803
- "period_error_cost_usd"
1804
- ],
1805
- "properties": {
1806
- "cluster_id": {
1807
- "type": "string"
1808
- },
1809
- "coverage": {
1810
- "allOf": [
1811
- {
1812
- "$ref": "#/$defs/Common.Ratio"
1813
- }
1814
- ],
1815
- "description": "Fraction of cluster calls the replacement is expected to serve safely."
1816
- },
1817
- "frontier_cost_per_call_usd": {
1818
- "allOf": [
1819
- {
1820
- "$ref": "#/$defs/Common.CostUsd"
1821
- }
1822
- ],
1823
- "description": "Explicit scenario baseline cost per call. It wins over a calculated catalog estimate; when both are absent, evaluation fails closed."
1824
- },
1825
- "alternative_cost_per_call_usd": {
1826
- "$ref": "#/$defs/Common.CostUsd"
1827
- },
1828
- "period_maintenance_cost_usd": {
1829
- "$ref": "#/$defs/Common.CostUsd"
1830
- },
1831
- "period_error_cost_usd": {
1832
- "$ref": "#/$defs/Common.CostUsd"
1833
- }
1834
- },
1835
- "unevaluatedProperties": {
1836
- "not": {}
1837
- },
1838
- "description": "What-if assumptions for one workflow cluster over the requested period."
1839
- },
1840
- "Cost.GenAiEtlEvidenceSignal": {
1841
- "type": "string",
1842
- "enum": [
1843
- "workflow_identity",
1844
- "output_contract",
1845
- "provider_model",
1846
- "token_usage",
1847
- "catalog_token_estimate",
1848
- "recurring_schema",
1849
- "bounded_reference",
1850
- "task_metric",
1851
- "accepted_output_replay",
1852
- "downstream_fate",
1853
- "calibrated_confidence",
1854
- "shadow_comparison",
1855
- "fallback_policy"
1856
- ],
1857
- "description": "Observable evidence needed to promote an inferred replacement safely."
1858
- },
1859
- "Cost.GenAiEtlFrontierCostBasis": {
1860
- "type": "string",
1861
- "enum": [
1862
- "scenario",
1863
- "catalog_token_estimate",
1864
- "unavailable"
1865
- ],
1866
- "description": "Evidence basis for the frontier cost used in a replacement-value calculation."
1867
- },
1868
- "Cost.GenAiEtlOutputContract": {
1869
- "type": "string",
1870
- "enum": [
1871
- "prose",
1872
- "label",
1873
- "span_list",
1874
- "record",
1875
- "vector",
1876
- "catalog_reference",
1877
- "number",
1878
- "boolean",
1879
- "unknown"
1880
- ],
1881
- "description": "Machine-readable output contract inferred for a workflow cluster."
1882
- },
1883
- "Cost.GenAiEtlPromotionGate": {
1884
- "type": "object",
1885
- "required": [
1886
- "gate",
1887
- "state"
1888
- ],
1889
- "properties": {
1890
- "gate": {
1891
- "$ref": "#/$defs/Cost.GenAiEtlPromotionGateKind"
1892
- },
1893
- "state": {
1894
- "$ref": "#/$defs/Cost.GenAiEtlPromotionGateState"
1895
- },
1896
- "reason": {
1897
- "type": "string",
1898
- "description": "Stable evidence code explaining the current gate state."
1899
- }
1900
- },
1901
- "unevaluatedProperties": {
1902
- "not": {}
1903
- },
1904
- "description": "Promotion readiness for one gate."
1905
- },
1906
- "Cost.GenAiEtlPromotionGateKind": {
1907
- "type": "string",
1908
- "enum": [
1909
- "contract_stability",
1910
- "offline_replay",
1911
- "calibrated_confidence",
1912
- "shadow_traffic",
1913
- "limited_serving",
1914
- "rollback_residual_policy"
1915
- ],
1916
- "description": "Promotion gate from replay through limited serving and rollback."
1917
- },
1918
- "Cost.GenAiEtlPromotionGateState": {
1919
- "type": "string",
1920
- "enum": [
1921
- "passed",
1922
- "failed",
1923
- "not_evaluated",
1924
- "blocked_missing_evidence"
1925
- ],
1926
- "description": "Evaluation state of a promotion gate."
1927
- },
1928
- "Cost.GenAiEtlResidualPath": {
1929
- "type": "string",
1930
- "enum": [
1931
- "frontier_model",
1932
- "human_review",
1933
- "retry",
1934
- "degraded_response",
1935
- "none",
1936
- "undetermined"
1937
- ],
1938
- "description": "Fallback used for requests outside a promoted replacement's safe coverage."
1939
- },
1940
- "Cost.GenAiEtlScenarioClusterEvaluation": {
1941
- "type": "object",
1942
- "required": [
1943
- "frontier_cost_basis"
1944
- ],
1945
- "properties": {
1946
- "frontier_cost_basis": {
1947
- "type": "string",
1948
- "enum": [
1949
- "scenario"
1950
- ]
1951
- }
1952
- },
1953
- "unevaluatedProperties": {
1954
- "not": {}
1955
- },
1956
- "allOf": [
1957
- {
1958
- "$ref": "#/$defs/Cost.GenAiEtlCalculatedClusterEvaluationBase"
1959
- }
1960
- ]
1961
- },
1962
- "Cost.GenAiEtlTaskFamily": {
1963
- "type": "string",
1964
- "enum": [
1965
- "open_reasoning_generation",
1966
- "classification",
1967
- "sequence_labeling",
1968
- "structured_extraction",
1969
- "retrieval_entity_resolution",
1970
- "similarity_clustering",
1971
- "normalization_transformation",
1972
- "numeric_analytical",
1973
- "unknown"
1974
- ],
1975
- "description": "Task family inferred for a repeated GenAI workflow cluster."
1976
- },
1977
- "Cost.GenAiEtlUnavailableClusterEvaluation": {
1978
- "type": "object",
1979
- "required": [
1980
- "status",
1981
- "frontier_cost_basis"
1982
- ],
1983
- "properties": {
1984
- "status": {
1985
- "type": "string",
1986
- "enum": [
1987
- "missing_frontier_cost"
1988
- ]
1989
- },
1990
- "frontier_cost_basis": {
1991
- "type": "string",
1992
- "enum": [
1993
- "unavailable"
1994
- ]
1995
- }
1996
- },
1997
- "unevaluatedProperties": {
1998
- "not": {}
1999
- },
2000
- "allOf": [
2001
- {
2002
- "$ref": "#/$defs/Cost.GenAiEtlClusterEvaluationBase"
2003
- }
2004
- ]
2005
- },
2006
- "Cost.GenAiEtlValidationMetric": {
2007
- "type": "string",
2008
- "enum": [
2009
- "accuracy",
2010
- "macro_f1",
2011
- "calibration_error",
2012
- "span_precision",
2013
- "span_recall",
2014
- "span_f1",
2015
- "field_exact_match",
2016
- "schema_validity",
2017
- "match_accuracy",
2018
- "recall_at_k",
2019
- "mean_reciprocal_rank",
2020
- "exact_match",
2021
- "numeric_tolerance",
2022
- "human_preference",
2023
- "task_success",
2024
- "unavailable"
2025
- ],
2026
- "description": "Task-specific metrics that can falsify a proposed replacement."
2027
- },
2028
- "Cost.ModelCatalogAdditiveSurchargeEvidence": {
2029
- "type": "object",
2030
- "required": [
2031
- "rate_relation"
2032
- ],
2033
- "properties": {
2034
- "rate_relation": {
2035
- "type": "string",
2036
- "enum": [
2037
- "additive_surcharge"
2038
- ]
2039
- }
2040
- },
2041
- "unevaluatedProperties": {
2042
- "not": {}
2043
- }
2044
- },
2045
- "Cost.ModelCatalogBaseRateEvidence": {
2046
- "type": "object",
2047
- "required": [
2048
- "rate_relation"
2049
- ],
2050
- "properties": {
2051
- "rate_relation": {
2052
- "type": "string",
2053
- "enum": [
2054
- "base_rate"
2055
- ]
2056
- }
2057
- },
2058
- "unevaluatedProperties": {
2059
- "not": {}
2060
- }
2061
- },
2062
- "Cost.ModelCatalogBillingMode": {
2063
- "type": "string",
2064
- "enum": [
2065
- "per_unit",
2066
- "per_request"
2067
- ],
2068
- "description": "How a catalog rate charges its measured quantity."
2069
- },
2070
- "Cost.ModelCatalogConditionalAdjustmentNotAppliedExclusion": {
2071
- "type": "object",
2072
- "required": [
2073
- "reason"
2074
- ],
2075
- "properties": {
2076
- "reason": {
2077
- "type": "string",
2078
- "enum": [
2079
- "conditional_adjustment_not_applied"
2080
- ]
2081
- }
2082
- },
2083
- "unevaluatedProperties": {
2084
- "not": {}
2085
- },
2086
- "allOf": [
2087
- {
2088
- "$ref": "#/$defs/Cost.ModelCatalogConditionalExclusionBase"
2089
- }
2090
- ]
2091
- },
2092
- "Cost.ModelCatalogConditionalExclusionBase": {
2093
- "type": "object",
2094
- "required": [
2095
- "component",
2096
- "usage_dimension",
2097
- "unit",
2098
- "source_billing_mode",
2099
- "rate_evidence"
2100
- ],
2101
- "properties": {
2102
- "component": {
2103
- "type": "string"
2104
- },
2105
- "usage_dimension": {
2106
- "type": "string"
2107
- },
2108
- "unit": {
2109
- "type": "string"
2110
- },
2111
- "source_billing_mode": {
2112
- "type": "string",
2113
- "description": "Source-specific billing mode retained from the catalog or deterministically derived from the provider-defined meter."
2114
- },
2115
- "billing_mode": {
2116
- "allOf": [
2117
- {
2118
- "$ref": "#/$defs/Cost.ModelCatalogBillingMode"
2119
- }
2120
- ],
2121
- "description": "Normalized billing mode when qyl recognizes the conditional source meter; absent when the source meter has no supported normalization."
2122
- },
2123
- "rate_evidence": {
2124
- "allOf": [
2125
- {
2126
- "$ref": "#/$defs/Cost.ModelCatalogPublishedReplacementEvidence"
2127
- }
2128
- ],
2129
- "description": "The ordered source override that was not applied or was superseded."
2130
- },
2131
- "unit_price_usd": {
2132
- "allOf": [
2133
- {
2134
- "$ref": "#/$defs/Common.CostUsd"
2135
- }
2136
- ],
2137
- "description": "Catalog rate omitted from the estimate, when the source supplied one."
2138
- }
2139
- }
2140
- },
2141
- "Cost.ModelCatalogConditionalRateEvidence": {
2142
- "type": "object",
2143
- "required": [
2144
- "source_order",
2145
- "condition_usage_dimension",
2146
- "exclusive_minimum_quantity",
2147
- "observed_per_call_quantity"
2148
- ],
2149
- "properties": {
2150
- "source_order": {
2151
- "allOf": [
2152
- {
2153
- "$ref": "#/$defs/Cost.ModelCatalogSourceOrder"
2154
- }
2155
- ],
2156
- "description": "One-based position of this override in the source response; later matching overrides win. Tier zero is reserved for the published base rate and is not a source override."
2157
- },
2158
- "condition_usage_dimension": {
2159
- "type": "string",
2160
- "description": "Observed per-call usage dimension evaluated by the source condition."
2161
- },
2162
- "exclusive_minimum_quantity": {
2163
- "type": "number",
2164
- "format": "double",
2165
- "minimum": 0,
2166
- "description": "Exclusive minimum quantity declared by the source condition."
2167
- },
2168
- "observed_per_call_quantity": {
2169
- "type": "number",
2170
- "format": "double",
2171
- "minimum": 0,
2172
- "description": "Observed per-call quantity compared with the exclusive minimum."
2173
- }
2174
- },
2175
- "unevaluatedProperties": {
2176
- "not": {}
2177
- },
2178
- "description": "Ordered evidence proving whether a conditional catalog override applied to an observed request quantity."
2179
- },
2180
- "Cost.ModelCatalogExclusionRateEvidence": {
2181
- "oneOf": [
2182
- {
2183
- "$ref": "#/$defs/Cost.ModelCatalogBaseRateEvidence"
2184
- },
2185
- {
2186
- "$ref": "#/$defs/Cost.ModelCatalogAdditiveSurchargeEvidence"
2187
- },
2188
- {
2189
- "$ref": "#/$defs/Cost.ModelCatalogInclusiveReplacementEvidence"
2190
- },
2191
- {
2192
- "$ref": "#/$defs/Cost.ModelCatalogPublishedReplacementEvidence"
2193
- }
2194
- ],
2195
- "description": "Relation-specific evidence for a catalog rate omitted from a token-and-request estimate. The rate_relation literal selects the required target and ordered evidence shape."
2196
- },
2197
- "Cost.ModelCatalogInclusiveReplacementEvidence": {
2198
- "type": "object",
2199
- "required": [
2200
- "rate_relation",
2201
- "replaces_usage_dimension"
2202
- ],
2203
- "properties": {
2204
- "rate_relation": {
2205
- "type": "string",
2206
- "enum": [
2207
- "replaces_inclusive_base_rate"
2208
- ]
2209
- },
2210
- "replaces_usage_dimension": {
2211
- "type": "string",
2212
- "description": "Inclusive base usage dimension replaced by this subtype rate."
2213
- },
2214
- "conditional_evidence": {
2215
- "allOf": [
2216
- {
2217
- "$ref": "#/$defs/Cost.ModelCatalogConditionalRateEvidence"
2218
- }
2219
- ],
2220
- "description": "Ordered evidence when a source override altered the selected subtype rate."
2221
- }
2222
- },
2223
- "unevaluatedProperties": {
2224
- "not": {}
2225
- }
2226
- },
2227
- "Cost.ModelCatalogMatchKind": {
2228
- "type": "string",
2229
- "enum": [
2230
- "exact_model_id",
2231
- "exact_canonical_slug"
2232
- ],
2233
- "description": "Deterministic exact match used to resolve an observed model identity to a catalog record. Fuzzy, prefix, suffix, date, and alias matching are not permitted."
2234
- },
2235
- "Cost.ModelCatalogObservedIdentityBasis": {
2236
- "type": "string",
2237
- "enum": [
2238
- "response_model",
2239
- "request_model_fallback"
2240
- ],
2241
- "description": "Telemetry attribute used as the observed model identity for an exact catalog match."
2242
- },
2243
- "Cost.ModelCatalogOptionallyNormalizedBillingExclusionBase": {
2244
- "type": "object",
2245
- "properties": {
2246
- "billing_mode": {
2247
- "allOf": [
2248
- {
2249
- "$ref": "#/$defs/Cost.ModelCatalogBillingMode"
2250
- }
2251
- ],
2252
- "description": "Normalized billing mode when qyl recognizes the source meter; absent when the source meter has no supported normalization."
2253
- }
2254
- },
2255
- "allOf": [
2256
- {
2257
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateExclusionBase"
2258
- }
2259
- ]
2260
- },
2261
- "Cost.ModelCatalogOutsideTokenScopeExclusion": {
2262
- "type": "object",
2263
- "required": [
2264
- "reason"
2265
- ],
2266
- "properties": {
2267
- "reason": {
2268
- "type": "string",
2269
- "enum": [
2270
- "outside_token_estimate_scope"
2271
- ]
2272
- }
2273
- },
2274
- "unevaluatedProperties": {
2275
- "not": {}
2276
- },
2277
- "allOf": [
2278
- {
2279
- "$ref": "#/$defs/Cost.ModelCatalogOptionallyNormalizedBillingExclusionBase"
2280
- }
2281
- ]
2282
- },
2283
- "Cost.ModelCatalogPriceProvenance": {
2284
- "type": "object",
2285
- "required": [
2286
- "source_id",
2287
- "source_endpoint",
2288
- "snapshot_id",
2289
- "price_model_id",
2290
- "observed_model_id",
2291
- "observed_model_identity_basis",
2292
- "model_match_kind",
2293
- "retrieved_at",
2294
- "price_semantics"
2295
- ],
2296
- "properties": {
2297
- "source_id": {
2298
- "type": "string",
2299
- "description": "Unique stable identifier of the configured catalog source."
2300
- },
2301
- "source_endpoint": {
2302
- "allOf": [
2303
- {
2304
- "$ref": "#/$defs/Common.UrlString"
2305
- }
2306
- ],
2307
- "description": "Configured API endpoint from which the catalog was retrieved."
2308
- },
2309
- "snapshot_id": {
2310
- "type": "string",
2311
- "description": "Content-addressed identifier of the exact catalog snapshot used for this estimate."
2312
- },
2313
- "price_model_id": {
2314
- "type": "string",
2315
- "description": "Exact model identifier selected from the source catalog."
2316
- },
2317
- "observed_model_id": {
2318
- "type": "string",
2319
- "description": "Exact observed telemetry value compared with the selected catalog record."
2320
- },
2321
- "observed_model_identity_basis": {
2322
- "$ref": "#/$defs/Cost.ModelCatalogObservedIdentityBasis"
2323
- },
2324
- "model_match_kind": {
2325
- "$ref": "#/$defs/Cost.ModelCatalogMatchKind"
2326
- },
2327
- "retrieved_at": {
2328
- "type": "string",
2329
- "format": "date-time",
2330
- "description": "UTC time when the current catalog snapshot used for this counterfactual estimate was retrieved. For historical audit periods, this is not evidence of the price that applied historically."
2331
- },
2332
- "price_semantics": {
2333
- "$ref": "#/$defs/Cost.ModelCatalogPriceSemantics"
2334
- }
2335
- },
2336
- "unevaluatedProperties": {
2337
- "not": {}
2338
- },
2339
- "description": "Provenance for the live catalog rates used to estimate one cluster."
2340
- },
2341
- "Cost.ModelCatalogPriceSemantics": {
2342
- "type": "string",
2343
- "enum": [
2344
- "minimum_available_rate",
2345
- "published_rate"
2346
- ],
2347
- "description": "How a live catalog rate was selected when estimating cluster cost."
2348
- },
2349
- "Cost.ModelCatalogPublishedReplacementEvidence": {
2350
- "type": "object",
2351
- "required": [
2352
- "rate_relation",
2353
- "replaces_usage_dimension",
2354
- "conditional_evidence"
2355
- ],
2356
- "properties": {
2357
- "rate_relation": {
2358
- "type": "string",
2359
- "enum": [
2360
- "replaces_published_rate"
2361
- ]
2362
- },
2363
- "replaces_usage_dimension": {
2364
- "type": "string",
2365
- "description": "Published usage dimension whose prior base, surcharge, or subtype rate was replaced."
2366
- },
2367
- "conditional_evidence": {
2368
- "$ref": "#/$defs/Cost.ModelCatalogConditionalRateEvidence"
2369
- }
2370
- },
2371
- "unevaluatedProperties": {
2372
- "not": {}
2373
- }
2374
- },
2375
- "Cost.ModelCatalogRateRelation": {
2376
- "type": "string",
2377
- "enum": [
2378
- "base_rate",
2379
- "additive_surcharge",
2380
- "replaces_inclusive_base_rate",
2381
- "replaces_published_rate"
2382
- ],
2383
- "description": "How a selected catalog rate relates to the source's published base rate for the same component."
2384
- },
2385
- "Cost.ModelCatalogSource": {
2386
- "type": "object",
2387
- "required": [
2388
- "source_id",
2389
- "priority",
2390
- "status",
2391
- "source_endpoint"
2392
- ],
2393
- "properties": {
2394
- "source_id": {
2395
- "type": "string",
2396
- "description": "Unique stable identifier of the configured catalog source."
2397
- },
2398
- "priority": {
2399
- "allOf": [
2400
- {
2401
- "$ref": "#/$defs/Common.Count"
2402
- }
2403
- ],
2404
- "description": "Configured source priority used for deterministic selection when multiple current catalogs match. Zero is highest priority; lower values win."
2405
- },
2406
- "status": {
2407
- "$ref": "#/$defs/Cost.ModelCatalogSourceStatus"
2408
- },
2409
- "price_semantics": {
2410
- "allOf": [
2411
- {
2412
- "$ref": "#/$defs/Cost.ModelCatalogPriceSemantics"
2413
- }
2414
- ],
2415
- "description": "Rate-selection semantics published by this source's active snapshot."
2416
- },
2417
- "source_endpoint": {
2418
- "allOf": [
2419
- {
2420
- "$ref": "#/$defs/Common.UrlString"
2421
- }
2422
- ],
2423
- "description": "Configured API endpoint used to fetch the live model catalog."
2424
- },
2425
- "last_attempt_at": {
2426
- "type": "string",
2427
- "format": "date-time",
2428
- "description": "UTC time of the latest fetch attempt."
2429
- },
2430
- "last_verified_at": {
2431
- "type": "string",
2432
- "format": "date-time",
2433
- "description": "UTC time when the source was last verified successfully, including a verification that retained unchanged content."
2434
- },
2435
- "retrieved_at": {
2436
- "type": "string",
2437
- "format": "date-time",
2438
- "description": "UTC time when the content of the currently retained catalog snapshot was retrieved."
2439
- },
2440
- "active_snapshot_id": {
2441
- "type": "string",
2442
- "description": "Content-addressed identifier of the catalog snapshot currently used for estimates."
2443
- },
2444
- "model_count": {
2445
- "allOf": [
2446
- {
2447
- "$ref": "#/$defs/Common.Count"
2448
- }
2449
- ],
2450
- "description": "Number of model records in the active catalog snapshot."
2451
- },
2452
- "failure_category": {
2453
- "type": "string",
2454
- "description": "Stable, non-sensitive failure category for the last attempt."
2455
- }
2456
- },
2457
- "unevaluatedProperties": {
2458
- "not": {}
2459
- },
2460
- "description": "Synchronization metadata for one configurable live model catalog source."
2461
- },
2462
- "Cost.ModelCatalogSourceOrder": {
2463
- "type": "integer",
2464
- "format": "int64",
2465
- "minimum": 1,
2466
- "description": "One-based position of a conditional override in its source response."
2467
- },
2468
- "Cost.ModelCatalogSourceStatus": {
2469
- "type": "string",
2470
- "enum": [
2471
- "unconfigured",
2472
- "pending",
2473
- "current",
2474
- "stale",
2475
- "sync_failed"
2476
- ],
2477
- "description": "Current synchronization state for a configured live model catalog."
2478
- },
2479
- "Cost.ModelCatalogSupersededOverrideExclusion": {
2480
- "type": "object",
2481
- "required": [
2482
- "reason"
2483
- ],
2484
- "properties": {
2485
- "reason": {
2486
- "type": "string",
2487
- "enum": [
2488
- "superseded_by_later_override"
2489
- ]
2490
- }
2491
- },
2492
- "unevaluatedProperties": {
2493
- "not": {}
2494
- },
2495
- "allOf": [
2496
- {
2497
- "$ref": "#/$defs/Cost.ModelCatalogConditionalExclusionBase"
2498
- }
2499
- ]
2500
- },
2501
- "Cost.ModelCatalogSupportedBillingExclusionBase": {
2502
- "type": "object",
2503
- "required": [
2504
- "billing_mode"
2505
- ],
2506
- "properties": {
2507
- "billing_mode": {
2508
- "$ref": "#/$defs/Cost.ModelCatalogBillingMode"
2509
- }
2510
- },
2511
- "allOf": [
2512
- {
2513
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateExclusionBase"
2514
- }
2515
- ]
2516
- },
2517
- "Cost.ModelCatalogTokenAdditiveSurchargeComponent": {
2518
- "type": "object",
2519
- "required": [
2520
- "rate_relation"
2521
- ],
2522
- "properties": {
2523
- "rate_relation": {
2524
- "type": "string",
2525
- "enum": [
2526
- "additive_surcharge"
2527
- ]
2528
- }
2529
- },
2530
- "unevaluatedProperties": {
2531
- "not": {}
2532
- },
2533
- "allOf": [
2534
- {
2535
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateComponentBase"
2536
- }
2537
- ]
2538
- },
2539
- "Cost.ModelCatalogTokenBaseRateComponent": {
2540
- "type": "object",
2541
- "required": [
2542
- "rate_relation"
2543
- ],
2544
- "properties": {
2545
- "rate_relation": {
2546
- "type": "string",
2547
- "enum": [
2548
- "base_rate"
2549
- ]
2550
- }
2551
- },
2552
- "unevaluatedProperties": {
2553
- "not": {}
2554
- },
2555
- "allOf": [
2556
- {
2557
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateComponentBase"
2558
- }
2559
- ]
2560
- },
2561
- "Cost.ModelCatalogTokenConditionalOverrideRateComponent": {
2562
- "type": "object",
2563
- "required": [
2564
- "rate_relation",
2565
- "replaces_usage_dimension",
2566
- "conditional_evidence"
2567
- ],
2568
- "properties": {
2569
- "rate_relation": {
2570
- "type": "string",
2571
- "enum": [
2572
- "replaces_published_rate"
2573
- ]
2574
- },
2575
- "replaces_usage_dimension": {
2576
- "type": "string",
2577
- "description": "Published usage dimension whose prior base, surcharge, or subtype rate was replaced."
2578
- },
2579
- "conditional_evidence": {
2580
- "$ref": "#/$defs/Cost.ModelCatalogConditionalRateEvidence"
2581
- }
2582
- },
2583
- "unevaluatedProperties": {
2584
- "not": {}
2585
- },
2586
- "allOf": [
2587
- {
2588
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateComponentBase"
2589
- }
2590
- ]
2591
- },
2592
- "Cost.ModelCatalogTokenEstimateComponent": {
2593
- "oneOf": [
2594
- {
2595
- "$ref": "#/$defs/Cost.ModelCatalogTokenBaseRateComponent"
2596
- },
2597
- {
2598
- "$ref": "#/$defs/Cost.ModelCatalogTokenAdditiveSurchargeComponent"
2599
- },
2600
- {
2601
- "$ref": "#/$defs/Cost.ModelCatalogTokenInclusiveReplacementRateComponent"
2602
- },
2603
- {
2604
- "$ref": "#/$defs/Cost.ModelCatalogTokenConditionalOverrideRateComponent"
2605
- }
2606
- ],
2607
- "description": "One evidenced token or request component contributing to a current-catalog estimate. The rate_relation literal selects the required evidence shape."
2608
- },
2609
- "Cost.ModelCatalogTokenEstimateComponentBase": {
2610
- "type": "object",
2611
- "required": [
2612
- "component",
2613
- "usage_dimension",
2614
- "unit",
2615
- "source_billing_mode",
2616
- "billing_mode",
2617
- "quantity",
2618
- "unit_price_usd",
2619
- "estimated_cost_usd"
2620
- ],
2621
- "properties": {
2622
- "component": {
2623
- "type": "string",
2624
- "description": "Source-defined pricing component, such as prompt, completion, request, cache read, cache write, or internal reasoning."
2625
- },
2626
- "usage_dimension": {
2627
- "type": "string",
2628
- "description": "Qyl-observed usage dimension to which this rate was applied, such as input_tokens or output_tokens."
2629
- },
2630
- "unit": {
2631
- "type": "string",
2632
- "description": "Source-declared unit represented by the rate."
2633
- },
2634
- "source_billing_mode": {
2635
- "type": "string",
2636
- "description": "Source-specific billing mode retained from the catalog or deterministically derived from the provider-defined meter."
2637
- },
2638
- "billing_mode": {
2639
- "$ref": "#/$defs/Cost.ModelCatalogBillingMode"
2640
- },
2641
- "quantity": {
2642
- "type": "number",
2643
- "format": "double",
2644
- "minimum": 0,
2645
- "description": "Measured quantity to which the catalog unit price was applied."
2646
- },
2647
- "unit_price_usd": {
2648
- "allOf": [
2649
- {
2650
- "$ref": "#/$defs/Common.CostUsd"
2651
- }
2652
- ],
2653
- "description": "Catalog price in USD per source-defined unit."
2654
- },
2655
- "estimated_cost_usd": {
2656
- "allOf": [
2657
- {
2658
- "$ref": "#/$defs/Common.CostUsd"
2659
- }
2660
- ],
2661
- "description": "Estimated USD contribution of this component for the reported cluster period."
2662
- }
2663
- },
2664
- "description": "Fields shared by every included token or request pricing component."
2665
- },
2666
- "Cost.ModelCatalogTokenEstimateExclusion": {
2667
- "oneOf": [
2668
- {
2669
- "$ref": "#/$defs/Cost.ModelCatalogUsageNotObservedExclusion"
2670
- },
2671
- {
2672
- "$ref": "#/$defs/Cost.ModelCatalogConditionalAdjustmentNotAppliedExclusion"
2673
- },
2674
- {
2675
- "$ref": "#/$defs/Cost.ModelCatalogSupersededOverrideExclusion"
2676
- },
2677
- {
2678
- "$ref": "#/$defs/Cost.ModelCatalogOutsideTokenScopeExclusion"
2679
- },
2680
- {
2681
- "$ref": "#/$defs/Cost.ModelCatalogUnsupportedUsageExclusion"
2682
- },
2683
- {
2684
- "$ref": "#/$defs/Cost.ModelCatalogUnsupportedBillingExclusion"
2685
- }
2686
- ],
2687
- "description": "Auditable catalog meter or conditional adjustment excluded from a token-and-request estimate. The reason literal selects the required evidence shape."
2688
- },
2689
- "Cost.ModelCatalogTokenEstimateExclusionBase": {
2690
- "type": "object",
2691
- "required": [
2692
- "component",
2693
- "usage_dimension",
2694
- "unit",
2695
- "source_billing_mode",
2696
- "rate_evidence"
2697
- ],
2698
- "properties": {
2699
- "component": {
2700
- "type": "string"
2701
- },
2702
- "usage_dimension": {
2703
- "type": "string"
2704
- },
2705
- "unit": {
2706
- "type": "string"
2707
- },
2708
- "source_billing_mode": {
2709
- "type": "string",
2710
- "description": "Source-specific billing mode retained from the catalog or deterministically derived from the provider-defined meter, including unsupported modes."
2711
- },
2712
- "rate_evidence": {
2713
- "allOf": [
2714
- {
2715
- "$ref": "#/$defs/Cost.ModelCatalogExclusionRateEvidence"
2716
- }
2717
- ],
2718
- "description": "Relation, replacement target, and ordered override evidence for the omitted rate."
2719
- },
2720
- "unit_price_usd": {
2721
- "allOf": [
2722
- {
2723
- "$ref": "#/$defs/Common.CostUsd"
2724
- }
2725
- ],
2726
- "description": "Catalog rate omitted from the estimate, when the source supplied one."
2727
- }
2728
- },
2729
- "description": "Fields shared by every catalog meter or conditional adjustment excluded from a token-and-request estimate."
2730
- },
2731
- "Cost.ModelCatalogTokenExclusionReason": {
2732
- "type": "string",
2733
- "enum": [
2734
- "usage_not_observed",
2735
- "conditional_adjustment_not_applied",
2736
- "superseded_by_later_override",
2737
- "outside_token_estimate_scope",
2738
- "unsupported_usage_dimension",
2739
- "unsupported_billing_mode"
2740
- ],
2741
- "description": "Why a catalog meter or conditional adjustment was not included in a token-and-request estimate."
2742
- },
2743
- "Cost.ModelCatalogTokenInclusiveReplacementRateComponent": {
2744
- "type": "object",
2745
- "required": [
2746
- "rate_relation",
2747
- "replaces_usage_dimension"
2748
- ],
2749
- "properties": {
2750
- "rate_relation": {
2751
- "type": "string",
2752
- "enum": [
2753
- "replaces_inclusive_base_rate"
2754
- ]
2755
- },
2756
- "replaces_usage_dimension": {
2757
- "type": "string",
2758
- "description": "Inclusive base usage dimension replaced by this subtype rate."
2759
- },
2760
- "conditional_evidence": {
2761
- "allOf": [
2762
- {
2763
- "$ref": "#/$defs/Cost.ModelCatalogConditionalRateEvidence"
2764
- }
2765
- ],
2766
- "description": "Ordered override evidence when the source conditionally altered this subtype rate."
2767
- }
2768
- },
2769
- "unevaluatedProperties": {
2770
- "not": {}
2771
- },
2772
- "allOf": [
2773
- {
2774
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateComponentBase"
2775
- }
2776
- ]
2777
- },
2778
- "Cost.ModelCatalogUnsupportedBillingExclusion": {
2779
- "type": "object",
2780
- "required": [
2781
- "reason"
2782
- ],
2783
- "properties": {
2784
- "billing_mode": {
2785
- "allOf": [
2786
- {
2787
- "$ref": "#/$defs/Cost.ModelCatalogBillingMode"
2788
- }
2789
- ],
2790
- "description": "Normalized billing mode when the source mode has a partial known mapping; absent when no supported normalization exists."
2791
- },
2792
- "reason": {
2793
- "type": "string",
2794
- "enum": [
2795
- "unsupported_billing_mode"
2796
- ]
2797
- }
2798
- },
2799
- "unevaluatedProperties": {
2800
- "not": {}
2801
- },
2802
- "allOf": [
2803
- {
2804
- "$ref": "#/$defs/Cost.ModelCatalogTokenEstimateExclusionBase"
2805
- }
2806
- ]
2807
- },
2808
- "Cost.ModelCatalogUnsupportedUsageExclusion": {
2809
- "type": "object",
2810
- "required": [
2811
- "reason"
2812
- ],
2813
- "properties": {
2814
- "reason": {
2815
- "type": "string",
2816
- "enum": [
2817
- "unsupported_usage_dimension"
2818
- ]
2819
- }
2820
- },
2821
- "unevaluatedProperties": {
2822
- "not": {}
2823
- },
2824
- "allOf": [
2825
- {
2826
- "$ref": "#/$defs/Cost.ModelCatalogOptionallyNormalizedBillingExclusionBase"
2827
- }
2828
- ]
2829
- },
2830
- "Cost.ModelCatalogUsageNotObservedExclusion": {
2831
- "type": "object",
2832
- "required": [
2833
- "reason"
2834
- ],
2835
- "properties": {
2836
- "reason": {
2837
- "type": "string",
2838
- "enum": [
2839
- "usage_not_observed"
2840
- ]
2841
- }
2842
- },
2843
- "unevaluatedProperties": {
2844
- "not": {}
2845
- },
2846
- "allOf": [
2847
- {
2848
- "$ref": "#/$defs/Cost.ModelCatalogSupportedBillingExclusionBase"
2849
- }
2850
- ]
2851
- },
2852
- "Cost.ProviderBillingAttribution": {
2853
- "type": "string",
2854
- "enum": [
2855
- "provider_model_period",
2856
- "provider_period",
2857
- "unavailable"
2858
- ],
2859
- "description": "Granularity at which official provider-billed cost can be attributed to telemetry."
2860
- },
2861
- "Cost.ProviderBillingSource": {
2862
- "type": "object",
2863
- "required": [
2864
- "provider",
2865
- "status",
2866
- "source_endpoint",
2867
- "attribution"
2868
- ],
2869
- "properties": {
2870
- "provider": {
2871
- "type": "string",
2872
- "description": "Canonical GenAI provider or cloud billing system name."
2873
- },
2874
- "status": {
2875
- "allOf": [
2876
- {
2877
- "$ref": "#/$defs/Cost.ProviderBillingSourceStatus"
2878
- }
2879
- ],
2880
- "description": "Current billing synchronization state."
2881
- },
2882
- "source_endpoint": {
2883
- "allOf": [
2884
- {
2885
- "$ref": "#/$defs/Common.UrlString"
2886
- }
2887
- ],
2888
- "description": "Official provider-owned API endpoint used for the fetch."
2889
- },
2890
- "attribution": {
2891
- "allOf": [
2892
- {
2893
- "$ref": "#/$defs/Cost.ProviderBillingAttribution"
2894
- }
2895
- ],
2896
- "description": "Attribution granularity supported by this source response."
2897
- },
2898
- "last_attempt_at": {
2899
- "type": "string",
2900
- "format": "date-time",
2901
- "description": "UTC time of the latest fetch attempt."
2902
- },
2903
- "last_success_at": {
2904
- "type": "string",
2905
- "format": "date-time",
2906
- "description": "UTC time of the latest successful fetch."
2907
- },
2908
- "period_start": {
2909
- "type": "string",
2910
- "format": "date-time",
2911
- "description": "Start of the provider billing period."
2912
- },
2913
- "period_end": {
2914
- "type": "string",
2915
- "format": "date-time",
2916
- "description": "End of the provider billing period."
2917
- },
2918
- "currency_code": {
2919
- "type": "string",
2920
- "description": "ISO 4217 currency code returned by the provider."
2921
- },
2922
- "reported_cost_usd": {
2923
- "allOf": [
2924
- {
2925
- "$ref": "#/$defs/Common.CostUsd"
2926
- }
2927
- ],
2928
- "description": "Cost returned by the provider for this period, converted from provider-declared USD units without rate inference."
2929
- },
2930
- "model": {
2931
- "type": "string",
2932
- "description": "Model identifier returned by the provider when the source supports it."
2933
- },
2934
- "failure_category": {
2935
- "type": "string",
2936
- "description": "Stable, non-sensitive failure category for the last attempt."
2937
- }
2938
- },
2939
- "unevaluatedProperties": {
2940
- "not": {}
2941
- },
2942
- "description": "Provenance for billed cost data fetched directly from a provider-owned API."
2943
- },
2944
- "Cost.ProviderBillingSourceStatus": {
2945
- "type": "string",
2946
- "enum": [
2947
- "unconfigured",
2948
- "pending",
2949
- "current",
2950
- "stale",
2951
- "sync_failed"
2952
- ],
2953
- "description": "Current synchronization state for a provider-owned billing source."
2954
- },
2955
1032
  "Domains.Observe.Session.DeviceType": {
2956
1033
  "type": "string",
2957
1034
  "enum": [
@@ -9163,33 +7240,6 @@
9163
7240
  },
9164
7241
  "description": "One log delivered by the collector's live stream."
9165
7242
  },
9166
- "Operations.GenAiEtlAuditApi_evaluate.Request": {
9167
- "$ref": "#/$defs/Cost.GenAiEtlAuditEvaluationRequest"
9168
- },
9169
- "Operations.GenAiEtlAuditApi_evaluate.Response.200": {
9170
- "$ref": "#/$defs/Cost.GenAiEtlAuditEvaluationResponse"
9171
- },
9172
- "Operations.GenAiEtlAuditApi_evaluate.Response.400": {
9173
- "$ref": "#/$defs/Common.Errors.ValidationError"
9174
- },
9175
- "Operations.GenAiEtlAuditApi_evaluate.Response.401": {
9176
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9177
- },
9178
- "Operations.GenAiEtlAuditApi_evaluate.Response.500": {
9179
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9180
- },
9181
- "Operations.GenAiEtlAuditApi_report.Response.200": {
9182
- "$ref": "#/$defs/Cost.GenAiEtlAuditReport"
9183
- },
9184
- "Operations.GenAiEtlAuditApi_report.Response.400": {
9185
- "$ref": "#/$defs/Common.Errors.ValidationError"
9186
- },
9187
- "Operations.GenAiEtlAuditApi_report.Response.401": {
9188
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9189
- },
9190
- "Operations.GenAiEtlAuditApi_report.Response.500": {
9191
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9192
- },
9193
7243
  "Operations.LogsApi_list.Response.200": {
9194
7244
  "type": "object",
9195
7245
  "required": [