@ancplua/qyl-api-schema 0.5.10 → 0.5.12

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 (9) hide show
  1. package/api/routes.tsp +28 -0
  2. package/generated/json-schema/qyl-api-schema.json +679 -5
  3. package/generated/openapi/qyl.openapi.json +1751 -781
  4. package/generated/ts-runtime/api.d.ts +221 -1
  5. package/generated/ts-runtime/api.js +104 -0
  6. package/index.tsp +1 -0
  7. package/models/cost-etl-audit.tsp +461 -0
  8. package/models/session.tsp +0 -4
  9. package/package.json +3 -2
package/generated/openapi/qyl.openapi.json CHANGED
@@ -26,6 +26,9 @@
26
26
  {
27
27
  "name": "Sessions"
28
28
  },
29
+ {
30
+ "name": "GenAI cost"
31
+ },
29
32
  {
30
33
  "name": "Health"
31
34
  }
@@ -62,58 +65,13 @@
62
65
  ]
63
66
  }
64
67
  },
65
- "/api/v1/logs": {
68
+ "/api/v1/cost/etl-audit": {
66
69
  "get": {
67
- "operationId": "LogsApi_list",
70
+ "operationId": "GenAiEtlAuditApi_report",
68
71
  "parameters": [
69
72
  {
70
73
  "$ref": "#/components/parameters/ProjectScopeHeader"
71
74
  },
72
- {
73
- "name": "sessionId",
74
- "in": "query",
75
- "required": false,
76
- "schema": {
77
- "$ref": "#/components/schemas/Common.SessionId"
78
- },
79
- "explode": false
80
- },
81
- {
82
- "name": "serviceName",
83
- "in": "query",
84
- "required": false,
85
- "schema": {
86
- "type": "string"
87
- },
88
- "explode": false
89
- },
90
- {
91
- "name": "level",
92
- "in": "query",
93
- "required": false,
94
- "schema": {
95
- "type": "string"
96
- },
97
- "explode": false
98
- },
99
- {
100
- "name": "severityMin",
101
- "in": "query",
102
- "required": false,
103
- "schema": {
104
- "$ref": "#/components/schemas/OTel.Enums.SeverityNumber"
105
- },
106
- "explode": false
107
- },
108
- {
109
- "name": "traceId",
110
- "in": "query",
111
- "required": false,
112
- "schema": {
113
- "$ref": "#/components/schemas/Common.TraceId"
114
- },
115
- "explode": false
116
- },
117
75
  {
118
76
  "name": "startTime",
119
77
  "in": "query",
@@ -134,15 +92,6 @@
134
92
  },
135
93
  "explode": false
136
94
  },
137
- {
138
- "name": "query",
139
- "in": "query",
140
- "required": false,
141
- "schema": {
142
- "type": "string"
143
- },
144
- "explode": false
145
- },
146
95
  {
147
96
  "name": "limit",
148
97
  "in": "query",
@@ -151,8 +100,8 @@
151
100
  "type": "integer",
152
101
  "format": "int32",
153
102
  "minimum": 1,
154
- "maximum": 10000,
155
- "default": 100
103
+ "maximum": 100,
104
+ "default": 25
156
105
  },
157
106
  "explode": false
158
107
  }
@@ -163,33 +112,7 @@
163
112
  "content": {
164
113
  "application/json": {
165
114
  "schema": {
166
- "type": "object",
167
- "required": [
168
- "items",
169
- "has_more"
170
- ],
171
- "properties": {
172
- "items": {
173
- "type": "array",
174
- "items": {
175
- "$ref": "#/components/schemas/OTel.Logs.LogRecord"
176
- },
177
- "description": "List of items in this page"
178
- },
179
- "next_cursor": {
180
- "type": "string",
181
- "description": "Cursor for the next page (null if no more pages)"
182
- },
183
- "prev_cursor": {
184
- "type": "string",
185
- "description": "Cursor for the previous page (null if first page)"
186
- },
187
- "has_more": {
188
- "type": "boolean",
189
- "description": "Whether there are more items available"
190
- }
191
- },
192
- "description": "Cursor-based paginated response wrapper"
115
+ "$ref": "#/components/schemas/Cost.GenAiEtlAuditReport"
193
116
  }
194
117
  }
195
118
  }
@@ -281,7 +204,7 @@
281
204
  }
282
205
  },
283
206
  "tags": [
284
- "Logs"
207
+ "GenAI cost"
285
208
  ],
286
209
  "security": [
287
210
  {
@@ -290,59 +213,30 @@
290
213
  ]
291
214
  }
292
215
  },
293
- "/api/v1/profiles": {
294
- "get": {
295
- "operationId": "ProfilesApi_list",
216
+ "/api/v1/cost/etl-audit/evaluate": {
217
+ "post": {
218
+ "operationId": "GenAiEtlAuditApi_evaluate",
296
219
  "parameters": [
297
220
  {
298
221
  "$ref": "#/components/parameters/ProjectScopeHeader"
299
222
  },
300
223
  {
301
- "name": "sessionId",
302
- "in": "query",
303
- "required": false,
304
- "schema": {
305
- "$ref": "#/components/schemas/Common.SessionId"
306
- },
307
- "explode": false
308
- },
309
- {
310
- "name": "traceId",
311
- "in": "query",
312
- "required": false,
313
- "schema": {
314
- "$ref": "#/components/schemas/Common.TraceId"
315
- },
316
- "explode": false
317
- },
318
- {
319
- "name": "serviceName",
320
- "in": "query",
321
- "required": false,
322
- "schema": {
323
- "type": "string"
324
- },
325
- "explode": false
326
- },
327
- {
328
- "name": "sampleType",
224
+ "name": "startTime",
329
225
  "in": "query",
330
226
  "required": false,
331
227
  "schema": {
332
- "type": "string"
228
+ "type": "string",
229
+ "format": "date-time"
333
230
  },
334
231
  "explode": false
335
232
  },
336
233
  {
337
- "name": "limit",
234
+ "name": "endTime",
338
235
  "in": "query",
339
236
  "required": false,
340
237
  "schema": {
341
- "type": "integer",
342
- "format": "int32",
343
- "minimum": 1,
344
- "maximum": 1000,
345
- "default": 100
238
+ "type": "string",
239
+ "format": "date-time"
346
240
  },
347
241
  "explode": false
348
242
  }
@@ -353,10 +247,7 @@
353
247
  "content": {
354
248
  "application/json": {
355
249
  "schema": {
356
- "type": "array",
357
- "items": {
358
- "$ref": "#/components/schemas/OTel.Profiles.Profile"
359
- }
250
+ "$ref": "#/components/schemas/Cost.GenAiEtlAuditEvaluationResponse"
360
251
  }
361
252
  }
362
253
  }
@@ -448,8 +339,18 @@
448
339
  }
449
340
  },
450
341
  "tags": [
451
- "Profiles"
342
+ "GenAI cost"
452
343
  ],
344
+ "requestBody": {
345
+ "required": true,
346
+ "content": {
347
+ "application/json": {
348
+ "schema": {
349
+ "$ref": "#/components/schemas/Cost.GenAiEtlAuditEvaluationRequest"
350
+ }
351
+ }
352
+ }
353
+ },
453
354
  "security": [
454
355
  {
455
356
  "ApiKeyAuth": []
@@ -457,20 +358,86 @@
457
358
  ]
458
359
  }
459
360
  },
460
- "/api/v1/profiles/by-span/{spanId}": {
361
+ "/api/v1/logs": {
461
362
  "get": {
462
- "operationId": "ProfilesApi_getBySpan",
363
+ "operationId": "LogsApi_list",
463
364
  "parameters": [
464
365
  {
465
366
  "$ref": "#/components/parameters/ProjectScopeHeader"
466
367
  },
467
368
  {
468
- "name": "spanId",
469
- "in": "path",
470
- "required": true,
369
+ "name": "sessionId",
370
+ "in": "query",
371
+ "required": false,
471
372
  "schema": {
472
- "$ref": "#/components/schemas/Common.SpanId"
473
- }
373
+ "$ref": "#/components/schemas/Common.SessionId"
374
+ },
375
+ "explode": false
376
+ },
377
+ {
378
+ "name": "serviceName",
379
+ "in": "query",
380
+ "required": false,
381
+ "schema": {
382
+ "type": "string"
383
+ },
384
+ "explode": false
385
+ },
386
+ {
387
+ "name": "level",
388
+ "in": "query",
389
+ "required": false,
390
+ "schema": {
391
+ "type": "string"
392
+ },
393
+ "explode": false
394
+ },
395
+ {
396
+ "name": "severityMin",
397
+ "in": "query",
398
+ "required": false,
399
+ "schema": {
400
+ "$ref": "#/components/schemas/OTel.Enums.SeverityNumber"
401
+ },
402
+ "explode": false
403
+ },
404
+ {
405
+ "name": "traceId",
406
+ "in": "query",
407
+ "required": false,
408
+ "schema": {
409
+ "$ref": "#/components/schemas/Common.TraceId"
410
+ },
411
+ "explode": false
412
+ },
413
+ {
414
+ "name": "startTime",
415
+ "in": "query",
416
+ "required": false,
417
+ "schema": {
418
+ "type": "string",
419
+ "format": "date-time"
420
+ },
421
+ "explode": false
422
+ },
423
+ {
424
+ "name": "endTime",
425
+ "in": "query",
426
+ "required": false,
427
+ "schema": {
428
+ "type": "string",
429
+ "format": "date-time"
430
+ },
431
+ "explode": false
432
+ },
433
+ {
434
+ "name": "query",
435
+ "in": "query",
436
+ "required": false,
437
+ "schema": {
438
+ "type": "string"
439
+ },
440
+ "explode": false
474
441
  },
475
442
  {
476
443
  "name": "limit",
@@ -480,7 +447,7 @@
480
447
  "type": "integer",
481
448
  "format": "int32",
482
449
  "minimum": 1,
483
- "maximum": 1000,
450
+ "maximum": 10000,
484
451
  "default": 100
485
452
  },
486
453
  "explode": false
@@ -492,33 +459,56 @@
492
459
  "content": {
493
460
  "application/json": {
494
461
  "schema": {
495
- "type": "array",
496
- "items": {
497
- "$ref": "#/components/schemas/OTel.Profiles.Profile"
498
- }
499
- }
500
- }
501
- }
502
- },
503
- "400": {
504
- "description": "Bad request - validation failed (400)",
505
- "headers": {
506
- "X-Trace-Id": {
507
- "required": false,
508
- "description": "Trace ID for correlation",
509
- "schema": {
510
- "type": "string"
511
- }
512
- },
513
- "X-Request-Id": {
514
- "required": false,
515
- "description": "Request ID for support",
516
- "schema": {
517
- "type": "string"
518
- }
519
- }
520
- },
521
- "content": {
462
+ "type": "object",
463
+ "required": [
464
+ "items",
465
+ "has_more"
466
+ ],
467
+ "properties": {
468
+ "items": {
469
+ "type": "array",
470
+ "items": {
471
+ "$ref": "#/components/schemas/OTel.Logs.LogRecord"
472
+ },
473
+ "description": "List of items in this page"
474
+ },
475
+ "next_cursor": {
476
+ "type": "string",
477
+ "description": "Cursor for the next page (null if no more pages)"
478
+ },
479
+ "prev_cursor": {
480
+ "type": "string",
481
+ "description": "Cursor for the previous page (null if first page)"
482
+ },
483
+ "has_more": {
484
+ "type": "boolean",
485
+ "description": "Whether there are more items available"
486
+ }
487
+ },
488
+ "description": "Cursor-based paginated response wrapper"
489
+ }
490
+ }
491
+ }
492
+ },
493
+ "400": {
494
+ "description": "Bad request - validation failed (400)",
495
+ "headers": {
496
+ "X-Trace-Id": {
497
+ "required": false,
498
+ "description": "Trace ID for correlation",
499
+ "schema": {
500
+ "type": "string"
501
+ }
502
+ },
503
+ "X-Request-Id": {
504
+ "required": false,
505
+ "description": "Request ID for support",
506
+ "schema": {
507
+ "type": "string"
508
+ }
509
+ }
510
+ },
511
+ "content": {
522
512
  "application/problem+json": {
523
513
  "schema": {
524
514
  "$ref": "#/components/schemas/Common.Errors.ValidationError"
@@ -587,7 +577,7 @@
587
577
  }
588
578
  },
589
579
  "tags": [
590
- "Profiles"
580
+ "Logs"
591
581
  ],
592
582
  "security": [
593
583
  {
@@ -596,20 +586,48 @@
596
586
  ]
597
587
  }
598
588
  },
599
- "/api/v1/profiles/by-trace/{traceId}": {
589
+ "/api/v1/profiles": {
600
590
  "get": {
601
- "operationId": "ProfilesApi_getByTrace",
591
+ "operationId": "ProfilesApi_list",
602
592
  "parameters": [
603
593
  {
604
594
  "$ref": "#/components/parameters/ProjectScopeHeader"
605
595
  },
596
+ {
597
+ "name": "sessionId",
598
+ "in": "query",
599
+ "required": false,
600
+ "schema": {
601
+ "$ref": "#/components/schemas/Common.SessionId"
602
+ },
603
+ "explode": false
604
+ },
606
605
  {
607
606
  "name": "traceId",
608
- "in": "path",
609
- "required": true,
607
+ "in": "query",
608
+ "required": false,
610
609
  "schema": {
611
610
  "$ref": "#/components/schemas/Common.TraceId"
612
- }
611
+ },
612
+ "explode": false
613
+ },
614
+ {
615
+ "name": "serviceName",
616
+ "in": "query",
617
+ "required": false,
618
+ "schema": {
619
+ "type": "string"
620
+ },
621
+ "explode": false
622
+ },
623
+ {
624
+ "name": "sampleType",
625
+ "in": "query",
626
+ "required": false,
627
+ "schema": {
628
+ "type": "string"
629
+ },
630
+ "explode": false
613
631
  },
614
632
  {
615
633
  "name": "limit",
@@ -735,20 +753,33 @@
735
753
  ]
736
754
  }
737
755
  },
738
- "/api/v1/profiles/{profileId}": {
756
+ "/api/v1/profiles/by-span/{spanId}": {
739
757
  "get": {
740
- "operationId": "ProfilesApi_get",
758
+ "operationId": "ProfilesApi_getBySpan",
741
759
  "parameters": [
742
760
  {
743
761
  "$ref": "#/components/parameters/ProjectScopeHeader"
744
762
  },
745
763
  {
746
- "name": "profileId",
764
+ "name": "spanId",
747
765
  "in": "path",
748
766
  "required": true,
749
767
  "schema": {
750
- "type": "string"
768
+ "$ref": "#/components/schemas/Common.SpanId"
751
769
  }
770
+ },
771
+ {
772
+ "name": "limit",
773
+ "in": "query",
774
+ "required": false,
775
+ "schema": {
776
+ "type": "integer",
777
+ "format": "int32",
778
+ "minimum": 1,
779
+ "maximum": 1000,
780
+ "default": 100
781
+ },
782
+ "explode": false
752
783
  }
753
784
  ],
754
785
  "responses": {
@@ -757,21 +788,17 @@
757
788
  "content": {
758
789
  "application/json": {
759
790
  "schema": {
760
- "$ref": "#/components/schemas/OTel.Profiles.Profile"
791
+ "type": "array",
792
+ "items": {
793
+ "$ref": "#/components/schemas/OTel.Profiles.Profile"
794
+ }
761
795
  }
762
796
  }
763
797
  }
764
798
  },
765
- "401": {
766
- "description": "Unauthorized - authentication required (401)",
799
+ "400": {
800
+ "description": "Bad request - validation failed (400)",
767
801
  "headers": {
768
- "WWW-Authenticate": {
769
- "required": false,
770
- "description": "Authentication scheme expected",
771
- "schema": {
772
- "type": "string"
773
- }
774
- },
775
802
  "X-Trace-Id": {
776
803
  "required": false,
777
804
  "description": "Trace ID for correlation",
@@ -790,14 +817,21 @@
790
817
  "content": {
791
818
  "application/problem+json": {
792
819
  "schema": {
793
- "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
820
+ "$ref": "#/components/schemas/Common.Errors.ValidationError"
794
821
  }
795
822
  }
796
823
  }
797
824
  },
798
- "404": {
799
- "description": "Resource not found (404)",
825
+ "401": {
826
+ "description": "Unauthorized - authentication required (401)",
800
827
  "headers": {
828
+ "WWW-Authenticate": {
829
+ "required": false,
830
+ "description": "Authentication scheme expected",
831
+ "schema": {
832
+ "type": "string"
833
+ }
834
+ },
801
835
  "X-Trace-Id": {
802
836
  "required": false,
803
837
  "description": "Trace ID for correlation",
@@ -816,7 +850,7 @@
816
850
  "content": {
817
851
  "application/problem+json": {
818
852
  "schema": {
819
- "$ref": "#/components/schemas/Common.Errors.NotFoundError"
853
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
820
854
  }
821
855
  }
822
856
  }
@@ -858,41 +892,20 @@
858
892
  ]
859
893
  }
860
894
  },
861
- "/api/v1/sessions": {
895
+ "/api/v1/profiles/by-trace/{traceId}": {
862
896
  "get": {
863
- "operationId": "SessionsApi_list",
897
+ "operationId": "ProfilesApi_getByTrace",
864
898
  "parameters": [
865
899
  {
866
900
  "$ref": "#/components/parameters/ProjectScopeHeader"
867
901
  },
868
902
  {
869
- "name": "isActive",
870
- "in": "query",
871
- "required": false,
872
- "schema": {
873
- "type": "boolean"
874
- },
875
- "explode": false
876
- },
877
- {
878
- "name": "startTime",
879
- "in": "query",
880
- "required": false,
881
- "schema": {
882
- "type": "string",
883
- "format": "date-time"
884
- },
885
- "explode": false
886
- },
887
- {
888
- "name": "endTime",
889
- "in": "query",
890
- "required": false,
903
+ "name": "traceId",
904
+ "in": "path",
905
+ "required": true,
891
906
  "schema": {
892
- "type": "string",
893
- "format": "date-time"
894
- },
895
- "explode": false
907
+ "$ref": "#/components/schemas/Common.TraceId"
908
+ }
896
909
  },
897
910
  {
898
911
  "name": "limit",
@@ -906,15 +919,6 @@
906
919
  "default": 100
907
920
  },
908
921
  "explode": false
909
- },
910
- {
911
- "name": "cursor",
912
- "in": "query",
913
- "required": false,
914
- "schema": {
915
- "type": "string"
916
- },
917
- "explode": false
918
922
  }
919
923
  ],
920
924
  "responses": {
@@ -923,33 +927,10 @@
923
927
  "content": {
924
928
  "application/json": {
925
929
  "schema": {
926
- "type": "object",
927
- "required": [
928
- "items",
929
- "has_more"
930
- ],
931
- "properties": {
932
- "items": {
933
- "type": "array",
934
- "items": {
935
- "$ref": "#/components/schemas/Domains.Observe.Session.SessionEntity"
936
- },
937
- "description": "List of items in this page"
938
- },
939
- "next_cursor": {
940
- "type": "string",
941
- "description": "Cursor for the next page (null if no more pages)"
942
- },
943
- "prev_cursor": {
944
- "type": "string",
945
- "description": "Cursor for the previous page (null if first page)"
946
- },
947
- "has_more": {
948
- "type": "boolean",
949
- "description": "Whether there are more items available"
950
- }
951
- },
952
- "description": "Cursor-based paginated response wrapper"
930
+ "type": "array",
931
+ "items": {
932
+ "$ref": "#/components/schemas/OTel.Profiles.Profile"
933
+ }
953
934
  }
954
935
  }
955
936
  }
@@ -1041,7 +1022,7 @@
1041
1022
  }
1042
1023
  },
1043
1024
  "tags": [
1044
- "Sessions"
1025
+ "Profiles"
1045
1026
  ],
1046
1027
  "security": [
1047
1028
  {
@@ -1050,32 +1031,20 @@
1050
1031
  ]
1051
1032
  }
1052
1033
  },
1053
- "/api/v1/sessions/stats": {
1034
+ "/api/v1/profiles/{profileId}": {
1054
1035
  "get": {
1055
- "operationId": "SessionsApi_getStats",
1036
+ "operationId": "ProfilesApi_get",
1056
1037
  "parameters": [
1057
1038
  {
1058
1039
  "$ref": "#/components/parameters/ProjectScopeHeader"
1059
1040
  },
1060
1041
  {
1061
- "name": "startTime",
1062
- "in": "query",
1063
- "required": false,
1064
- "schema": {
1065
- "type": "string",
1066
- "format": "date-time"
1067
- },
1068
- "explode": false
1069
- },
1070
- {
1071
- "name": "endTime",
1072
- "in": "query",
1073
- "required": false,
1042
+ "name": "profileId",
1043
+ "in": "path",
1044
+ "required": true,
1074
1045
  "schema": {
1075
- "type": "string",
1076
- "format": "date-time"
1077
- },
1078
- "explode": false
1046
+ "type": "string"
1047
+ }
1079
1048
  }
1080
1049
  ],
1081
1050
  "responses": {
@@ -1084,22 +1053,29 @@
1084
1053
  "content": {
1085
1054
  "application/json": {
1086
1055
  "schema": {
1087
- "$ref": "#/components/schemas/Domains.Observe.Session.SessionStats"
1056
+ "$ref": "#/components/schemas/OTel.Profiles.Profile"
1088
1057
  }
1089
1058
  }
1090
1059
  }
1091
1060
  },
1092
- "400": {
1093
- "description": "Bad request - validation failed (400)",
1061
+ "401": {
1062
+ "description": "Unauthorized - authentication required (401)",
1094
1063
  "headers": {
1095
- "X-Trace-Id": {
1064
+ "WWW-Authenticate": {
1096
1065
  "required": false,
1097
- "description": "Trace ID for correlation",
1066
+ "description": "Authentication scheme expected",
1098
1067
  "schema": {
1099
1068
  "type": "string"
1100
1069
  }
1101
1070
  },
1102
- "X-Request-Id": {
1071
+ "X-Trace-Id": {
1072
+ "required": false,
1073
+ "description": "Trace ID for correlation",
1074
+ "schema": {
1075
+ "type": "string"
1076
+ }
1077
+ },
1078
+ "X-Request-Id": {
1103
1079
  "required": false,
1104
1080
  "description": "Request ID for support",
1105
1081
  "schema": {
@@ -1110,21 +1086,14 @@
1110
1086
  "content": {
1111
1087
  "application/problem+json": {
1112
1088
  "schema": {
1113
- "$ref": "#/components/schemas/Common.Errors.ValidationError"
1089
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1114
1090
  }
1115
1091
  }
1116
1092
  }
1117
1093
  },
1118
- "401": {
1119
- "description": "Unauthorized - authentication required (401)",
1094
+ "404": {
1095
+ "description": "Resource not found (404)",
1120
1096
  "headers": {
1121
- "WWW-Authenticate": {
1122
- "required": false,
1123
- "description": "Authentication scheme expected",
1124
- "schema": {
1125
- "type": "string"
1126
- }
1127
- },
1128
1097
  "X-Trace-Id": {
1129
1098
  "required": false,
1130
1099
  "description": "Trace ID for correlation",
@@ -1143,7 +1112,7 @@
1143
1112
  "content": {
1144
1113
  "application/problem+json": {
1145
1114
  "schema": {
1146
- "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1115
+ "$ref": "#/components/schemas/Common.Errors.NotFoundError"
1147
1116
  }
1148
1117
  }
1149
1118
  }
@@ -1176,7 +1145,7 @@
1176
1145
  }
1177
1146
  },
1178
1147
  "tags": [
1179
- "Sessions"
1148
+ "Profiles"
1180
1149
  ],
1181
1150
  "security": [
1182
1151
  {
@@ -1185,20 +1154,63 @@
1185
1154
  ]
1186
1155
  }
1187
1156
  },
1188
- "/api/v1/sessions/{sessionId}": {
1157
+ "/api/v1/sessions": {
1189
1158
  "get": {
1190
- "operationId": "SessionsApi_get",
1159
+ "operationId": "SessionsApi_list",
1191
1160
  "parameters": [
1192
1161
  {
1193
1162
  "$ref": "#/components/parameters/ProjectScopeHeader"
1194
1163
  },
1195
1164
  {
1196
- "name": "sessionId",
1197
- "in": "path",
1198
- "required": true,
1165
+ "name": "isActive",
1166
+ "in": "query",
1167
+ "required": false,
1199
1168
  "schema": {
1200
- "$ref": "#/components/schemas/Common.SessionId"
1201
- }
1169
+ "type": "boolean"
1170
+ },
1171
+ "explode": false
1172
+ },
1173
+ {
1174
+ "name": "startTime",
1175
+ "in": "query",
1176
+ "required": false,
1177
+ "schema": {
1178
+ "type": "string",
1179
+ "format": "date-time"
1180
+ },
1181
+ "explode": false
1182
+ },
1183
+ {
1184
+ "name": "endTime",
1185
+ "in": "query",
1186
+ "required": false,
1187
+ "schema": {
1188
+ "type": "string",
1189
+ "format": "date-time"
1190
+ },
1191
+ "explode": false
1192
+ },
1193
+ {
1194
+ "name": "limit",
1195
+ "in": "query",
1196
+ "required": false,
1197
+ "schema": {
1198
+ "type": "integer",
1199
+ "format": "int32",
1200
+ "minimum": 1,
1201
+ "maximum": 1000,
1202
+ "default": 100
1203
+ },
1204
+ "explode": false
1205
+ },
1206
+ {
1207
+ "name": "cursor",
1208
+ "in": "query",
1209
+ "required": false,
1210
+ "schema": {
1211
+ "type": "string"
1212
+ },
1213
+ "explode": false
1202
1214
  }
1203
1215
  ],
1204
1216
  "responses": {
@@ -1207,21 +1219,40 @@
1207
1219
  "content": {
1208
1220
  "application/json": {
1209
1221
  "schema": {
1210
- "$ref": "#/components/schemas/Domains.Observe.Session.SessionEntity"
1222
+ "type": "object",
1223
+ "required": [
1224
+ "items",
1225
+ "has_more"
1226
+ ],
1227
+ "properties": {
1228
+ "items": {
1229
+ "type": "array",
1230
+ "items": {
1231
+ "$ref": "#/components/schemas/Domains.Observe.Session.SessionEntity"
1232
+ },
1233
+ "description": "List of items in this page"
1234
+ },
1235
+ "next_cursor": {
1236
+ "type": "string",
1237
+ "description": "Cursor for the next page (null if no more pages)"
1238
+ },
1239
+ "prev_cursor": {
1240
+ "type": "string",
1241
+ "description": "Cursor for the previous page (null if first page)"
1242
+ },
1243
+ "has_more": {
1244
+ "type": "boolean",
1245
+ "description": "Whether there are more items available"
1246
+ }
1247
+ },
1248
+ "description": "Cursor-based paginated response wrapper"
1211
1249
  }
1212
1250
  }
1213
1251
  }
1214
1252
  },
1215
- "401": {
1216
- "description": "Unauthorized - authentication required (401)",
1253
+ "400": {
1254
+ "description": "Bad request - validation failed (400)",
1217
1255
  "headers": {
1218
- "WWW-Authenticate": {
1219
- "required": false,
1220
- "description": "Authentication scheme expected",
1221
- "schema": {
1222
- "type": "string"
1223
- }
1224
- },
1225
1256
  "X-Trace-Id": {
1226
1257
  "required": false,
1227
1258
  "description": "Trace ID for correlation",
@@ -1240,14 +1271,21 @@
1240
1271
  "content": {
1241
1272
  "application/problem+json": {
1242
1273
  "schema": {
1243
- "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1274
+ "$ref": "#/components/schemas/Common.Errors.ValidationError"
1244
1275
  }
1245
1276
  }
1246
1277
  }
1247
1278
  },
1248
- "404": {
1249
- "description": "Resource not found (404)",
1279
+ "401": {
1280
+ "description": "Unauthorized - authentication required (401)",
1250
1281
  "headers": {
1282
+ "WWW-Authenticate": {
1283
+ "required": false,
1284
+ "description": "Authentication scheme expected",
1285
+ "schema": {
1286
+ "type": "string"
1287
+ }
1288
+ },
1251
1289
  "X-Trace-Id": {
1252
1290
  "required": false,
1253
1291
  "description": "Trace ID for correlation",
@@ -1266,7 +1304,7 @@
1266
1304
  "content": {
1267
1305
  "application/problem+json": {
1268
1306
  "schema": {
1269
- "$ref": "#/components/schemas/Common.Errors.NotFoundError"
1307
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1270
1308
  }
1271
1309
  }
1272
1310
  }
@@ -1308,20 +1346,32 @@
1308
1346
  ]
1309
1347
  }
1310
1348
  },
1311
- "/api/v1/sessions/{sessionId}/traces": {
1349
+ "/api/v1/sessions/stats": {
1312
1350
  "get": {
1313
- "operationId": "SessionsApi_getTraces",
1351
+ "operationId": "SessionsApi_getStats",
1314
1352
  "parameters": [
1315
1353
  {
1316
1354
  "$ref": "#/components/parameters/ProjectScopeHeader"
1317
1355
  },
1318
1356
  {
1319
- "name": "sessionId",
1320
- "in": "path",
1321
- "required": true,
1357
+ "name": "startTime",
1358
+ "in": "query",
1359
+ "required": false,
1322
1360
  "schema": {
1323
- "$ref": "#/components/schemas/Common.SessionId"
1324
- }
1361
+ "type": "string",
1362
+ "format": "date-time"
1363
+ },
1364
+ "explode": false
1365
+ },
1366
+ {
1367
+ "name": "endTime",
1368
+ "in": "query",
1369
+ "required": false,
1370
+ "schema": {
1371
+ "type": "string",
1372
+ "format": "date-time"
1373
+ },
1374
+ "explode": false
1325
1375
  }
1326
1376
  ],
1327
1377
  "responses": {
@@ -1330,47 +1380,14 @@
1330
1380
  "content": {
1331
1381
  "application/json": {
1332
1382
  "schema": {
1333
- "type": "object",
1334
- "required": [
1335
- "items",
1336
- "has_more"
1337
- ],
1338
- "properties": {
1339
- "items": {
1340
- "type": "array",
1341
- "items": {
1342
- "$ref": "#/components/schemas/OTel.Traces.Trace"
1343
- },
1344
- "description": "List of items in this page"
1345
- },
1346
- "next_cursor": {
1347
- "type": "string",
1348
- "description": "Cursor for the next page (null if no more pages)"
1349
- },
1350
- "prev_cursor": {
1351
- "type": "string",
1352
- "description": "Cursor for the previous page (null if first page)"
1353
- },
1354
- "has_more": {
1355
- "type": "boolean",
1356
- "description": "Whether there are more items available"
1357
- }
1358
- },
1359
- "description": "Cursor-based paginated response wrapper"
1383
+ "$ref": "#/components/schemas/Domains.Observe.Session.SessionStats"
1360
1384
  }
1361
1385
  }
1362
1386
  }
1363
1387
  },
1364
- "401": {
1365
- "description": "Unauthorized - authentication required (401)",
1388
+ "400": {
1389
+ "description": "Bad request - validation failed (400)",
1366
1390
  "headers": {
1367
- "WWW-Authenticate": {
1368
- "required": false,
1369
- "description": "Authentication scheme expected",
1370
- "schema": {
1371
- "type": "string"
1372
- }
1373
- },
1374
1391
  "X-Trace-Id": {
1375
1392
  "required": false,
1376
1393
  "description": "Trace ID for correlation",
@@ -1389,14 +1406,21 @@
1389
1406
  "content": {
1390
1407
  "application/problem+json": {
1391
1408
  "schema": {
1392
- "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1409
+ "$ref": "#/components/schemas/Common.Errors.ValidationError"
1393
1410
  }
1394
1411
  }
1395
1412
  }
1396
1413
  },
1397
- "404": {
1398
- "description": "Resource not found (404)",
1414
+ "401": {
1415
+ "description": "Unauthorized - authentication required (401)",
1399
1416
  "headers": {
1417
+ "WWW-Authenticate": {
1418
+ "required": false,
1419
+ "description": "Authentication scheme expected",
1420
+ "schema": {
1421
+ "type": "string"
1422
+ }
1423
+ },
1400
1424
  "X-Trace-Id": {
1401
1425
  "required": false,
1402
1426
  "description": "Trace ID for correlation",
@@ -1415,7 +1439,7 @@
1415
1439
  "content": {
1416
1440
  "application/problem+json": {
1417
1441
  "schema": {
1418
- "$ref": "#/components/schemas/Common.Errors.NotFoundError"
1442
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1419
1443
  }
1420
1444
  }
1421
1445
  }
@@ -1457,126 +1481,31 @@
1457
1481
  ]
1458
1482
  }
1459
1483
  },
1460
- "/api/v1/stream/logs": {
1484
+ "/api/v1/sessions/{sessionId}": {
1461
1485
  "get": {
1462
- "operationId": "StreamingApi_streamLogs",
1486
+ "operationId": "SessionsApi_get",
1463
1487
  "parameters": [
1464
1488
  {
1465
1489
  "$ref": "#/components/parameters/ProjectScopeHeader"
1466
1490
  },
1467
1491
  {
1468
- "name": "Last-Event-ID",
1469
- "in": "header",
1470
- "required": false,
1492
+ "name": "sessionId",
1493
+ "in": "path",
1494
+ "required": true,
1471
1495
  "schema": {
1472
- "type": "string"
1473
- }
1474
- },
1475
- {
1476
- "name": "serviceName",
1477
- "in": "query",
1478
- "required": false,
1479
- "schema": {
1480
- "type": "string"
1481
- },
1482
- "explode": false
1483
- },
1484
- {
1485
- "name": "minSeverity",
1486
- "in": "query",
1487
- "required": false,
1488
- "schema": {
1489
- "type": "integer",
1490
- "format": "int32",
1491
- "minimum": 1,
1492
- "maximum": 24
1493
- },
1494
- "explode": false
1495
- },
1496
- {
1497
- "name": "query",
1498
- "in": "query",
1499
- "required": false,
1500
- "schema": {
1501
- "type": "string"
1502
- },
1503
- "explode": false
1504
- }
1505
- ],
1506
- "responses": {
1507
- "200": {
1508
- "description": "The request has succeeded.",
1509
- "content": {
1510
- "text/event-stream": {
1511
- "itemSchema": {
1512
- "type": "object",
1513
- "properties": {
1514
- "event": {
1515
- "type": "string"
1516
- },
1517
- "data": {
1518
- "type": "string"
1519
- }
1520
- },
1521
- "required": [
1522
- "event"
1523
- ],
1524
- "oneOf": [
1525
- {
1526
- "properties": {
1527
- "data": {
1528
- "contentMediaType": "application/json",
1529
- "contentSchema": {
1530
- "$ref": "#/components/schemas/Streaming.LogStreamEvent"
1531
- }
1532
- },
1533
- "event": {
1534
- "const": "log"
1535
- }
1536
- }
1537
- },
1538
- {
1539
- "properties": {
1540
- "data": {
1541
- "contentMediaType": "application/json",
1542
- "contentSchema": {
1543
- "$ref": "#/components/schemas/Streaming.HeartbeatEvent"
1544
- }
1545
- },
1546
- "event": {
1547
- "const": "heartbeat"
1548
- }
1549
- }
1550
- }
1551
- ]
1552
- }
1553
- }
1554
- }
1555
- },
1556
- "400": {
1557
- "description": "Bad request - validation failed (400)",
1558
- "headers": {
1559
- "X-Trace-Id": {
1560
- "required": false,
1561
- "description": "Trace ID for correlation",
1562
- "schema": {
1563
- "type": "string"
1564
- }
1565
- },
1566
- "X-Request-Id": {
1567
- "required": false,
1568
- "description": "Request ID for support",
1569
- "schema": {
1570
- "type": "string"
1571
- }
1572
- }
1573
- },
1574
- "content": {
1575
- "application/problem+json": {
1576
- "schema": {
1577
- "$ref": "#/components/schemas/Common.Errors.ValidationError"
1578
- }
1579
- }
1496
+ "$ref": "#/components/schemas/Common.SessionId"
1497
+ }
1498
+ }
1499
+ ],
1500
+ "responses": {
1501
+ "200": {
1502
+ "description": "The request has succeeded.",
1503
+ "content": {
1504
+ "application/json": {
1505
+ "schema": {
1506
+ "$ref": "#/components/schemas/Domains.Observe.Session.SessionEntity"
1507
+ }
1508
+ }
1580
1509
  }
1581
1510
  },
1582
1511
  "401": {
@@ -1612,8 +1541,8 @@
1612
1541
  }
1613
1542
  }
1614
1543
  },
1615
- "500": {
1616
- "description": "Internal server error (500)",
1544
+ "404": {
1545
+ "description": "Resource not found (404)",
1617
1546
  "headers": {
1618
1547
  "X-Trace-Id": {
1619
1548
  "required": false,
@@ -1633,22 +1562,14 @@
1633
1562
  "content": {
1634
1563
  "application/problem+json": {
1635
1564
  "schema": {
1636
- "$ref": "#/components/schemas/Common.Errors.InternalServerError"
1565
+ "$ref": "#/components/schemas/Common.Errors.NotFoundError"
1637
1566
  }
1638
1567
  }
1639
1568
  }
1640
1569
  },
1641
- "503": {
1642
- "description": "Service unavailable (503)",
1570
+ "500": {
1571
+ "description": "Internal server error (500)",
1643
1572
  "headers": {
1644
- "Retry-After": {
1645
- "required": false,
1646
- "description": "Expected availability time",
1647
- "schema": {
1648
- "type": "integer",
1649
- "format": "int32"
1650
- }
1651
- },
1652
1573
  "X-Trace-Id": {
1653
1574
  "required": false,
1654
1575
  "description": "Trace ID for correlation",
@@ -1667,14 +1588,14 @@
1667
1588
  "content": {
1668
1589
  "application/problem+json": {
1669
1590
  "schema": {
1670
- "$ref": "#/components/schemas/Common.Errors.ServiceUnavailableError"
1591
+ "$ref": "#/components/schemas/Common.Errors.InternalServerError"
1671
1592
  }
1672
1593
  }
1673
1594
  }
1674
1595
  }
1675
1596
  },
1676
1597
  "tags": [
1677
- "Streaming"
1598
+ "Sessions"
1678
1599
  ],
1679
1600
  "security": [
1680
1601
  {
@@ -1683,34 +1604,20 @@
1683
1604
  ]
1684
1605
  }
1685
1606
  },
1686
- "/api/v1/traces": {
1607
+ "/api/v1/sessions/{sessionId}/traces": {
1687
1608
  "get": {
1688
- "operationId": "TracesApi_list",
1609
+ "operationId": "SessionsApi_getTraces",
1689
1610
  "parameters": [
1690
1611
  {
1691
1612
  "$ref": "#/components/parameters/ProjectScopeHeader"
1692
1613
  },
1693
1614
  {
1694
- "name": "limit",
1695
- "in": "query",
1696
- "required": false,
1697
- "schema": {
1698
- "type": "integer",
1699
- "format": "int32",
1700
- "minimum": 1,
1701
- "maximum": 1000,
1702
- "default": 100
1703
- },
1704
- "explode": false
1705
- },
1706
- {
1707
- "name": "cursor",
1708
- "in": "query",
1709
- "required": false,
1615
+ "name": "sessionId",
1616
+ "in": "path",
1617
+ "required": true,
1710
1618
  "schema": {
1711
- "type": "string"
1712
- },
1713
- "explode": false
1619
+ "$ref": "#/components/schemas/Common.SessionId"
1620
+ }
1714
1621
  }
1715
1622
  ],
1716
1623
  "responses": {
@@ -1750,9 +1657,16 @@
1750
1657
  }
1751
1658
  }
1752
1659
  },
1753
- "400": {
1754
- "description": "Bad request - validation failed (400)",
1660
+ "401": {
1661
+ "description": "Unauthorized - authentication required (401)",
1755
1662
  "headers": {
1663
+ "WWW-Authenticate": {
1664
+ "required": false,
1665
+ "description": "Authentication scheme expected",
1666
+ "schema": {
1667
+ "type": "string"
1668
+ }
1669
+ },
1756
1670
  "X-Trace-Id": {
1757
1671
  "required": false,
1758
1672
  "description": "Trace ID for correlation",
@@ -1771,21 +1685,14 @@
1771
1685
  "content": {
1772
1686
  "application/problem+json": {
1773
1687
  "schema": {
1774
- "$ref": "#/components/schemas/Common.Errors.ValidationError"
1688
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1775
1689
  }
1776
1690
  }
1777
1691
  }
1778
1692
  },
1779
- "401": {
1780
- "description": "Unauthorized - authentication required (401)",
1693
+ "404": {
1694
+ "description": "Resource not found (404)",
1781
1695
  "headers": {
1782
- "WWW-Authenticate": {
1783
- "required": false,
1784
- "description": "Authentication scheme expected",
1785
- "schema": {
1786
- "type": "string"
1787
- }
1788
- },
1789
1696
  "X-Trace-Id": {
1790
1697
  "required": false,
1791
1698
  "description": "Trace ID for correlation",
@@ -1804,7 +1711,7 @@
1804
1711
  "content": {
1805
1712
  "application/problem+json": {
1806
1713
  "schema": {
1807
- "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
1714
+ "$ref": "#/components/schemas/Common.Errors.NotFoundError"
1808
1715
  }
1809
1716
  }
1810
1717
  }
@@ -1837,7 +1744,7 @@
1837
1744
  }
1838
1745
  },
1839
1746
  "tags": [
1840
- "Traces"
1747
+ "Sessions"
1841
1748
  ],
1842
1749
  "security": [
1843
1750
  {
@@ -1846,29 +1753,124 @@
1846
1753
  ]
1847
1754
  }
1848
1755
  },
1849
- "/api/v1/traces/{traceId}": {
1756
+ "/api/v1/stream/logs": {
1850
1757
  "get": {
1851
- "operationId": "TracesApi_get",
1758
+ "operationId": "StreamingApi_streamLogs",
1852
1759
  "parameters": [
1853
1760
  {
1854
1761
  "$ref": "#/components/parameters/ProjectScopeHeader"
1855
1762
  },
1856
1763
  {
1857
- "name": "traceId",
1858
- "in": "path",
1859
- "required": true,
1764
+ "name": "Last-Event-ID",
1765
+ "in": "header",
1766
+ "required": false,
1860
1767
  "schema": {
1861
- "$ref": "#/components/schemas/Common.TraceId"
1768
+ "type": "string"
1862
1769
  }
1770
+ },
1771
+ {
1772
+ "name": "serviceName",
1773
+ "in": "query",
1774
+ "required": false,
1775
+ "schema": {
1776
+ "type": "string"
1777
+ },
1778
+ "explode": false
1779
+ },
1780
+ {
1781
+ "name": "minSeverity",
1782
+ "in": "query",
1783
+ "required": false,
1784
+ "schema": {
1785
+ "type": "integer",
1786
+ "format": "int32",
1787
+ "minimum": 1,
1788
+ "maximum": 24
1789
+ },
1790
+ "explode": false
1791
+ },
1792
+ {
1793
+ "name": "query",
1794
+ "in": "query",
1795
+ "required": false,
1796
+ "schema": {
1797
+ "type": "string"
1798
+ },
1799
+ "explode": false
1863
1800
  }
1864
1801
  ],
1865
1802
  "responses": {
1866
1803
  "200": {
1867
1804
  "description": "The request has succeeded.",
1868
1805
  "content": {
1869
- "application/json": {
1870
- "schema": {
1871
- "$ref": "#/components/schemas/OTel.Traces.Trace"
1806
+ "text/event-stream": {
1807
+ "itemSchema": {
1808
+ "type": "object",
1809
+ "properties": {
1810
+ "event": {
1811
+ "type": "string"
1812
+ },
1813
+ "data": {
1814
+ "type": "string"
1815
+ }
1816
+ },
1817
+ "required": [
1818
+ "event"
1819
+ ],
1820
+ "oneOf": [
1821
+ {
1822
+ "properties": {
1823
+ "data": {
1824
+ "contentMediaType": "application/json",
1825
+ "contentSchema": {
1826
+ "$ref": "#/components/schemas/Streaming.LogStreamEvent"
1827
+ }
1828
+ },
1829
+ "event": {
1830
+ "const": "log"
1831
+ }
1832
+ }
1833
+ },
1834
+ {
1835
+ "properties": {
1836
+ "data": {
1837
+ "contentMediaType": "application/json",
1838
+ "contentSchema": {
1839
+ "$ref": "#/components/schemas/Streaming.HeartbeatEvent"
1840
+ }
1841
+ },
1842
+ "event": {
1843
+ "const": "heartbeat"
1844
+ }
1845
+ }
1846
+ }
1847
+ ]
1848
+ }
1849
+ }
1850
+ }
1851
+ },
1852
+ "400": {
1853
+ "description": "Bad request - validation failed (400)",
1854
+ "headers": {
1855
+ "X-Trace-Id": {
1856
+ "required": false,
1857
+ "description": "Trace ID for correlation",
1858
+ "schema": {
1859
+ "type": "string"
1860
+ }
1861
+ },
1862
+ "X-Request-Id": {
1863
+ "required": false,
1864
+ "description": "Request ID for support",
1865
+ "schema": {
1866
+ "type": "string"
1867
+ }
1868
+ }
1869
+ },
1870
+ "content": {
1871
+ "application/problem+json": {
1872
+ "schema": {
1873
+ "$ref": "#/components/schemas/Common.Errors.ValidationError"
1872
1874
  }
1873
1875
  }
1874
1876
  }
@@ -1906,8 +1908,8 @@
1906
1908
  }
1907
1909
  }
1908
1910
  },
1909
- "404": {
1910
- "description": "Resource not found (404)",
1911
+ "500": {
1912
+ "description": "Internal server error (500)",
1911
1913
  "headers": {
1912
1914
  "X-Trace-Id": {
1913
1915
  "required": false,
@@ -1927,14 +1929,22 @@
1927
1929
  "content": {
1928
1930
  "application/problem+json": {
1929
1931
  "schema": {
1930
- "$ref": "#/components/schemas/Common.Errors.NotFoundError"
1932
+ "$ref": "#/components/schemas/Common.Errors.InternalServerError"
1931
1933
  }
1932
1934
  }
1933
1935
  }
1934
1936
  },
1935
- "500": {
1936
- "description": "Internal server error (500)",
1937
+ "503": {
1938
+ "description": "Service unavailable (503)",
1937
1939
  "headers": {
1940
+ "Retry-After": {
1941
+ "required": false,
1942
+ "description": "Expected availability time",
1943
+ "schema": {
1944
+ "type": "integer",
1945
+ "format": "int32"
1946
+ }
1947
+ },
1938
1948
  "X-Trace-Id": {
1939
1949
  "required": false,
1940
1950
  "description": "Trace ID for correlation",
@@ -1953,14 +1963,14 @@
1953
1963
  "content": {
1954
1964
  "application/problem+json": {
1955
1965
  "schema": {
1956
- "$ref": "#/components/schemas/Common.Errors.InternalServerError"
1966
+ "$ref": "#/components/schemas/Common.Errors.ServiceUnavailableError"
1957
1967
  }
1958
1968
  }
1959
1969
  }
1960
1970
  }
1961
1971
  },
1962
1972
  "tags": [
1963
- "Traces"
1973
+ "Streaming"
1964
1974
  ],
1965
1975
  "security": [
1966
1976
  {
@@ -1969,20 +1979,34 @@
1969
1979
  ]
1970
1980
  }
1971
1981
  },
1972
- "/api/v1/traces/{traceId}/spans": {
1982
+ "/api/v1/traces": {
1973
1983
  "get": {
1974
- "operationId": "TracesApi_getSpans",
1984
+ "operationId": "TracesApi_list",
1975
1985
  "parameters": [
1976
1986
  {
1977
1987
  "$ref": "#/components/parameters/ProjectScopeHeader"
1978
1988
  },
1979
1989
  {
1980
- "name": "traceId",
1981
- "in": "path",
1982
- "required": true,
1990
+ "name": "limit",
1991
+ "in": "query",
1992
+ "required": false,
1983
1993
  "schema": {
1984
- "$ref": "#/components/schemas/Common.TraceId"
1985
- }
1994
+ "type": "integer",
1995
+ "format": "int32",
1996
+ "minimum": 1,
1997
+ "maximum": 1000,
1998
+ "default": 100
1999
+ },
2000
+ "explode": false
2001
+ },
2002
+ {
2003
+ "name": "cursor",
2004
+ "in": "query",
2005
+ "required": false,
2006
+ "schema": {
2007
+ "type": "string"
2008
+ },
2009
+ "explode": false
1986
2010
  }
1987
2011
  ],
1988
2012
  "responses": {
@@ -2000,7 +2024,7 @@
2000
2024
  "items": {
2001
2025
  "type": "array",
2002
2026
  "items": {
2003
- "$ref": "#/components/schemas/OTel.Traces.Span"
2027
+ "$ref": "#/components/schemas/OTel.Traces.Trace"
2004
2028
  },
2005
2029
  "description": "List of items in this page"
2006
2030
  },
@@ -2022,16 +2046,9 @@
2022
2046
  }
2023
2047
  }
2024
2048
  },
2025
- "401": {
2026
- "description": "Unauthorized - authentication required (401)",
2049
+ "400": {
2050
+ "description": "Bad request - validation failed (400)",
2027
2051
  "headers": {
2028
- "WWW-Authenticate": {
2029
- "required": false,
2030
- "description": "Authentication scheme expected",
2031
- "schema": {
2032
- "type": "string"
2033
- }
2034
- },
2035
2052
  "X-Trace-Id": {
2036
2053
  "required": false,
2037
2054
  "description": "Trace ID for correlation",
@@ -2050,14 +2067,21 @@
2050
2067
  "content": {
2051
2068
  "application/problem+json": {
2052
2069
  "schema": {
2053
- "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
2070
+ "$ref": "#/components/schemas/Common.Errors.ValidationError"
2054
2071
  }
2055
2072
  }
2056
2073
  }
2057
2074
  },
2058
- "404": {
2059
- "description": "Resource not found (404)",
2075
+ "401": {
2076
+ "description": "Unauthorized - authentication required (401)",
2060
2077
  "headers": {
2078
+ "WWW-Authenticate": {
2079
+ "required": false,
2080
+ "description": "Authentication scheme expected",
2081
+ "schema": {
2082
+ "type": "string"
2083
+ }
2084
+ },
2061
2085
  "X-Trace-Id": {
2062
2086
  "required": false,
2063
2087
  "description": "Trace ID for correlation",
@@ -2076,7 +2100,7 @@
2076
2100
  "content": {
2077
2101
  "application/problem+json": {
2078
2102
  "schema": {
2079
- "$ref": "#/components/schemas/Common.Errors.NotFoundError"
2103
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
2080
2104
  }
2081
2105
  }
2082
2106
  }
@@ -2118,47 +2142,19 @@
2118
2142
  ]
2119
2143
  }
2120
2144
  },
2121
- "/health": {
2145
+ "/api/v1/traces/{traceId}": {
2122
2146
  "get": {
2123
- "operationId": "health_ready",
2124
- "parameters": [],
2125
- "responses": {
2126
- "200": {
2127
- "description": "The request has succeeded.",
2128
- "content": {
2129
- "application/json": {
2130
- "schema": {
2131
- "$ref": "#/components/schemas/Health.HealthReport"
2132
- }
2133
- }
2134
- }
2135
- },
2136
- "503": {
2137
- "description": "Service unavailable.",
2138
- "content": {
2139
- "application/json": {
2140
- "schema": {
2141
- "$ref": "#/components/schemas/Health.HealthReport"
2142
- }
2143
- }
2144
- }
2145
- }
2146
- },
2147
- "tags": [
2148
- "Health"
2149
- ]
2150
- }
2151
- },
2152
- "/runner/mcp/{resource}/resources/read": {
2153
- "post": {
2154
- "operationId": "RunnerMcpApi_readResource",
2147
+ "operationId": "TracesApi_get",
2155
2148
  "parameters": [
2156
2149
  {
2157
- "name": "resource",
2150
+ "$ref": "#/components/parameters/ProjectScopeHeader"
2151
+ },
2152
+ {
2153
+ "name": "traceId",
2158
2154
  "in": "path",
2159
2155
  "required": true,
2160
2156
  "schema": {
2161
- "type": "string"
2157
+ "$ref": "#/components/schemas/Common.TraceId"
2162
2158
  }
2163
2159
  }
2164
2160
  ],
@@ -2168,14 +2164,21 @@
2168
2164
  "content": {
2169
2165
  "application/json": {
2170
2166
  "schema": {
2171
- "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpResourceReadResponse"
2167
+ "$ref": "#/components/schemas/OTel.Traces.Trace"
2172
2168
  }
2173
2169
  }
2174
2170
  }
2175
2171
  },
2176
- "400": {
2177
- "description": "Bad request - validation failed (400)",
2172
+ "401": {
2173
+ "description": "Unauthorized - authentication required (401)",
2178
2174
  "headers": {
2175
+ "WWW-Authenticate": {
2176
+ "required": false,
2177
+ "description": "Authentication scheme expected",
2178
+ "schema": {
2179
+ "type": "string"
2180
+ }
2181
+ },
2179
2182
  "X-Trace-Id": {
2180
2183
  "required": false,
2181
2184
  "description": "Trace ID for correlation",
@@ -2194,13 +2197,13 @@
2194
2197
  "content": {
2195
2198
  "application/problem+json": {
2196
2199
  "schema": {
2197
- "$ref": "#/components/schemas/Common.Errors.ValidationError"
2200
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
2198
2201
  }
2199
2202
  }
2200
2203
  }
2201
2204
  },
2202
- "403": {
2203
- "description": "Forbidden - insufficient permissions (403)",
2205
+ "404": {
2206
+ "description": "Resource not found (404)",
2204
2207
  "headers": {
2205
2208
  "X-Trace-Id": {
2206
2209
  "required": false,
@@ -2220,13 +2223,13 @@
2220
2223
  "content": {
2221
2224
  "application/problem+json": {
2222
2225
  "schema": {
2223
- "$ref": "#/components/schemas/Common.Errors.ForbiddenError"
2226
+ "$ref": "#/components/schemas/Common.Errors.NotFoundError"
2224
2227
  }
2225
2228
  }
2226
2229
  }
2227
2230
  },
2228
- "404": {
2229
- "description": "Resource not found (404)",
2231
+ "500": {
2232
+ "description": "Internal server error (500)",
2230
2233
  "headers": {
2231
2234
  "X-Trace-Id": {
2232
2235
  "required": false,
@@ -2246,14 +2249,85 @@
2246
2249
  "content": {
2247
2250
  "application/problem+json": {
2248
2251
  "schema": {
2249
- "$ref": "#/components/schemas/Common.Errors.NotFoundError"
2252
+ "$ref": "#/components/schemas/Common.Errors.InternalServerError"
2250
2253
  }
2251
2254
  }
2252
2255
  }
2256
+ }
2257
+ },
2258
+ "tags": [
2259
+ "Traces"
2260
+ ],
2261
+ "security": [
2262
+ {
2263
+ "ApiKeyAuth": []
2264
+ }
2265
+ ]
2266
+ }
2267
+ },
2268
+ "/api/v1/traces/{traceId}/spans": {
2269
+ "get": {
2270
+ "operationId": "TracesApi_getSpans",
2271
+ "parameters": [
2272
+ {
2273
+ "$ref": "#/components/parameters/ProjectScopeHeader"
2253
2274
  },
2254
- "409": {
2255
- "description": "Conflict - resource state conflict (409)",
2275
+ {
2276
+ "name": "traceId",
2277
+ "in": "path",
2278
+ "required": true,
2279
+ "schema": {
2280
+ "$ref": "#/components/schemas/Common.TraceId"
2281
+ }
2282
+ }
2283
+ ],
2284
+ "responses": {
2285
+ "200": {
2286
+ "description": "The request has succeeded.",
2287
+ "content": {
2288
+ "application/json": {
2289
+ "schema": {
2290
+ "type": "object",
2291
+ "required": [
2292
+ "items",
2293
+ "has_more"
2294
+ ],
2295
+ "properties": {
2296
+ "items": {
2297
+ "type": "array",
2298
+ "items": {
2299
+ "$ref": "#/components/schemas/OTel.Traces.Span"
2300
+ },
2301
+ "description": "List of items in this page"
2302
+ },
2303
+ "next_cursor": {
2304
+ "type": "string",
2305
+ "description": "Cursor for the next page (null if no more pages)"
2306
+ },
2307
+ "prev_cursor": {
2308
+ "type": "string",
2309
+ "description": "Cursor for the previous page (null if first page)"
2310
+ },
2311
+ "has_more": {
2312
+ "type": "boolean",
2313
+ "description": "Whether there are more items available"
2314
+ }
2315
+ },
2316
+ "description": "Cursor-based paginated response wrapper"
2317
+ }
2318
+ }
2319
+ }
2320
+ },
2321
+ "401": {
2322
+ "description": "Unauthorized - authentication required (401)",
2256
2323
  "headers": {
2324
+ "WWW-Authenticate": {
2325
+ "required": false,
2326
+ "description": "Authentication scheme expected",
2327
+ "schema": {
2328
+ "type": "string"
2329
+ }
2330
+ },
2257
2331
  "X-Trace-Id": {
2258
2332
  "required": false,
2259
2333
  "description": "Trace ID for correlation",
@@ -2272,13 +2346,13 @@
2272
2346
  "content": {
2273
2347
  "application/problem+json": {
2274
2348
  "schema": {
2275
- "$ref": "#/components/schemas/Common.Errors.ConflictError"
2349
+ "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
2276
2350
  }
2277
2351
  }
2278
2352
  }
2279
2353
  },
2280
- "500": {
2281
- "description": "Internal server error (500)",
2354
+ "404": {
2355
+ "description": "Resource not found (404)",
2282
2356
  "headers": {
2283
2357
  "X-Trace-Id": {
2284
2358
  "required": false,
@@ -2298,7 +2372,229 @@
2298
2372
  "content": {
2299
2373
  "application/problem+json": {
2300
2374
  "schema": {
2301
- "$ref": "#/components/schemas/Common.Errors.InternalServerError"
2375
+ "$ref": "#/components/schemas/Common.Errors.NotFoundError"
2376
+ }
2377
+ }
2378
+ }
2379
+ },
2380
+ "500": {
2381
+ "description": "Internal server error (500)",
2382
+ "headers": {
2383
+ "X-Trace-Id": {
2384
+ "required": false,
2385
+ "description": "Trace ID for correlation",
2386
+ "schema": {
2387
+ "type": "string"
2388
+ }
2389
+ },
2390
+ "X-Request-Id": {
2391
+ "required": false,
2392
+ "description": "Request ID for support",
2393
+ "schema": {
2394
+ "type": "string"
2395
+ }
2396
+ }
2397
+ },
2398
+ "content": {
2399
+ "application/problem+json": {
2400
+ "schema": {
2401
+ "$ref": "#/components/schemas/Common.Errors.InternalServerError"
2402
+ }
2403
+ }
2404
+ }
2405
+ }
2406
+ },
2407
+ "tags": [
2408
+ "Traces"
2409
+ ],
2410
+ "security": [
2411
+ {
2412
+ "ApiKeyAuth": []
2413
+ }
2414
+ ]
2415
+ }
2416
+ },
2417
+ "/health": {
2418
+ "get": {
2419
+ "operationId": "health_ready",
2420
+ "parameters": [],
2421
+ "responses": {
2422
+ "200": {
2423
+ "description": "The request has succeeded.",
2424
+ "content": {
2425
+ "application/json": {
2426
+ "schema": {
2427
+ "$ref": "#/components/schemas/Health.HealthReport"
2428
+ }
2429
+ }
2430
+ }
2431
+ },
2432
+ "503": {
2433
+ "description": "Service unavailable.",
2434
+ "content": {
2435
+ "application/json": {
2436
+ "schema": {
2437
+ "$ref": "#/components/schemas/Health.HealthReport"
2438
+ }
2439
+ }
2440
+ }
2441
+ }
2442
+ },
2443
+ "tags": [
2444
+ "Health"
2445
+ ]
2446
+ }
2447
+ },
2448
+ "/runner/mcp/{resource}/resources/read": {
2449
+ "post": {
2450
+ "operationId": "RunnerMcpApi_readResource",
2451
+ "parameters": [
2452
+ {
2453
+ "name": "resource",
2454
+ "in": "path",
2455
+ "required": true,
2456
+ "schema": {
2457
+ "type": "string"
2458
+ }
2459
+ }
2460
+ ],
2461
+ "responses": {
2462
+ "200": {
2463
+ "description": "The request has succeeded.",
2464
+ "content": {
2465
+ "application/json": {
2466
+ "schema": {
2467
+ "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpResourceReadResponse"
2468
+ }
2469
+ }
2470
+ }
2471
+ },
2472
+ "400": {
2473
+ "description": "Bad request - validation failed (400)",
2474
+ "headers": {
2475
+ "X-Trace-Id": {
2476
+ "required": false,
2477
+ "description": "Trace ID for correlation",
2478
+ "schema": {
2479
+ "type": "string"
2480
+ }
2481
+ },
2482
+ "X-Request-Id": {
2483
+ "required": false,
2484
+ "description": "Request ID for support",
2485
+ "schema": {
2486
+ "type": "string"
2487
+ }
2488
+ }
2489
+ },
2490
+ "content": {
2491
+ "application/problem+json": {
2492
+ "schema": {
2493
+ "$ref": "#/components/schemas/Common.Errors.ValidationError"
2494
+ }
2495
+ }
2496
+ }
2497
+ },
2498
+ "403": {
2499
+ "description": "Forbidden - insufficient permissions (403)",
2500
+ "headers": {
2501
+ "X-Trace-Id": {
2502
+ "required": false,
2503
+ "description": "Trace ID for correlation",
2504
+ "schema": {
2505
+ "type": "string"
2506
+ }
2507
+ },
2508
+ "X-Request-Id": {
2509
+ "required": false,
2510
+ "description": "Request ID for support",
2511
+ "schema": {
2512
+ "type": "string"
2513
+ }
2514
+ }
2515
+ },
2516
+ "content": {
2517
+ "application/problem+json": {
2518
+ "schema": {
2519
+ "$ref": "#/components/schemas/Common.Errors.ForbiddenError"
2520
+ }
2521
+ }
2522
+ }
2523
+ },
2524
+ "404": {
2525
+ "description": "Resource not found (404)",
2526
+ "headers": {
2527
+ "X-Trace-Id": {
2528
+ "required": false,
2529
+ "description": "Trace ID for correlation",
2530
+ "schema": {
2531
+ "type": "string"
2532
+ }
2533
+ },
2534
+ "X-Request-Id": {
2535
+ "required": false,
2536
+ "description": "Request ID for support",
2537
+ "schema": {
2538
+ "type": "string"
2539
+ }
2540
+ }
2541
+ },
2542
+ "content": {
2543
+ "application/problem+json": {
2544
+ "schema": {
2545
+ "$ref": "#/components/schemas/Common.Errors.NotFoundError"
2546
+ }
2547
+ }
2548
+ }
2549
+ },
2550
+ "409": {
2551
+ "description": "Conflict - resource state conflict (409)",
2552
+ "headers": {
2553
+ "X-Trace-Id": {
2554
+ "required": false,
2555
+ "description": "Trace ID for correlation",
2556
+ "schema": {
2557
+ "type": "string"
2558
+ }
2559
+ },
2560
+ "X-Request-Id": {
2561
+ "required": false,
2562
+ "description": "Request ID for support",
2563
+ "schema": {
2564
+ "type": "string"
2565
+ }
2566
+ }
2567
+ },
2568
+ "content": {
2569
+ "application/problem+json": {
2570
+ "schema": {
2571
+ "$ref": "#/components/schemas/Common.Errors.ConflictError"
2572
+ }
2573
+ }
2574
+ }
2575
+ },
2576
+ "500": {
2577
+ "description": "Internal server error (500)",
2578
+ "headers": {
2579
+ "X-Trace-Id": {
2580
+ "required": false,
2581
+ "description": "Trace ID for correlation",
2582
+ "schema": {
2583
+ "type": "string"
2584
+ }
2585
+ },
2586
+ "X-Request-Id": {
2587
+ "required": false,
2588
+ "description": "Request ID for support",
2589
+ "schema": {
2590
+ "type": "string"
2591
+ }
2592
+ }
2593
+ },
2594
+ "content": {
2595
+ "application/problem+json": {
2596
+ "schema": {
2597
+ "$ref": "#/components/schemas/Common.Errors.InternalServerError"
2302
2598
  }
2303
2599
  }
2304
2600
  }
@@ -4341,206 +4637,885 @@
4341
4637
  "format": "date-time",
4342
4638
  "description": "Include historical data from this timestamp"
4343
4639
  },
4344
- "trace_id": {
4345
- "type": "string",
4346
- "description": "Filter by trace ID"
4640
+ "trace_id": {
4641
+ "type": "string",
4642
+ "description": "Filter by trace ID"
4643
+ },
4644
+ "service_name": {
4645
+ "type": "string",
4646
+ "description": "Filter by service name"
4647
+ },
4648
+ "max_events_per_second": {
4649
+ "type": "integer",
4650
+ "format": "int32",
4651
+ "minimum": 1,
4652
+ "maximum": 1000,
4653
+ "description": "Maximum events per second (rate limiting)",
4654
+ "default": 100
4655
+ }
4656
+ },
4657
+ "description": "Streaming parameters for SSE endpoints"
4658
+ },
4659
+ "Common.Pagination.TimeBucket": {
4660
+ "type": "string",
4661
+ "enum": [
4662
+ "1m",
4663
+ "5m",
4664
+ "15m",
4665
+ "1h",
4666
+ "1d",
4667
+ "1w",
4668
+ "auto"
4669
+ ],
4670
+ "description": "Time bucket size for aggregations"
4671
+ },
4672
+ "Common.Pagination.TimeRangeParams": {
4673
+ "type": "object",
4674
+ "properties": {
4675
+ "start_time": {
4676
+ "type": "string",
4677
+ "format": "date-time",
4678
+ "description": "Start of time range (inclusive)"
4679
+ },
4680
+ "end_time": {
4681
+ "type": "string",
4682
+ "format": "date-time",
4683
+ "description": "End of time range (exclusive)"
4684
+ },
4685
+ "limit": {
4686
+ "type": "integer",
4687
+ "format": "int32",
4688
+ "minimum": 1,
4689
+ "maximum": 10000,
4690
+ "description": "Maximum number of items to return",
4691
+ "default": 1000
4692
+ }
4693
+ },
4694
+ "description": "Time-range based query parameters"
4695
+ },
4696
+ "Common.Percentage": {
4697
+ "type": "number",
4698
+ "format": "double",
4699
+ "minimum": 0,
4700
+ "maximum": 100,
4701
+ "description": "Percentage value (0.0 to 100.0)",
4702
+ "x-csharp-type": "double"
4703
+ },
4704
+ "Common.Port": {
4705
+ "type": "integer",
4706
+ "format": "int32",
4707
+ "minimum": 1,
4708
+ "maximum": 65535,
4709
+ "description": "Network port number (1-65535)",
4710
+ "x-csharp-type": "int"
4711
+ },
4712
+ "Common.Ratio": {
4713
+ "type": "number",
4714
+ "format": "double",
4715
+ "minimum": 0,
4716
+ "maximum": 1,
4717
+ "description": "Ratio value (0.0 to 1.0)",
4718
+ "x-csharp-type": "double"
4719
+ },
4720
+ "Common.SemVer": {
4721
+ "type": "string",
4722
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
4723
+ "description": "Semantic version string (e.g., 1.2.3)",
4724
+ "examples": [
4725
+ "2.1.0"
4726
+ ]
4727
+ },
4728
+ "Common.SessionId": {
4729
+ "type": "string",
4730
+ "minLength": 1,
4731
+ "maxLength": 128,
4732
+ "description": "Unique session identifier",
4733
+ "x-csharp-type": "SessionId",
4734
+ "x-csharp-struct": true
4735
+ },
4736
+ "Common.Sha256Hash": {
4737
+ "type": "string",
4738
+ "minLength": 64,
4739
+ "maxLength": 64,
4740
+ "pattern": "^[a-f0-9]{64}$",
4741
+ "description": "SHA-256 hash in lowercase hex"
4742
+ },
4743
+ "Common.SpanId": {
4744
+ "type": "string",
4745
+ "minLength": 16,
4746
+ "maxLength": 16,
4747
+ "pattern": "^[a-f0-9]{16}$",
4748
+ "description": "Unique span identifier (16 lowercase hex characters)",
4749
+ "examples": [
4750
+ "b7ad6b7169203331"
4751
+ ],
4752
+ "x-csharp-type": "SpanId",
4753
+ "x-csharp-struct": true
4754
+ },
4755
+ "Common.Temperature": {
4756
+ "type": "number",
4757
+ "format": "double",
4758
+ "minimum": 0,
4759
+ "maximum": 2,
4760
+ "description": "Temperature setting for LLM requests (0.0-2.0)",
4761
+ "x-csharp-type": "double"
4762
+ },
4763
+ "Common.Timestamp": {
4764
+ "type": "string",
4765
+ "format": "date-time",
4766
+ "description": "ISO 8601 timestamp with nanosecond precision (RFC 3339)"
4767
+ },
4768
+ "Common.TokenCount": {
4769
+ "type": "integer",
4770
+ "format": "int64",
4771
+ "minimum": 0,
4772
+ "description": "Token count (for LLM operations)",
4773
+ "x-csharp-type": "long"
4774
+ },
4775
+ "Common.TraceId": {
4776
+ "type": "string",
4777
+ "minLength": 32,
4778
+ "maxLength": 32,
4779
+ "pattern": "^[a-f0-9]{32}$",
4780
+ "description": "Unique trace identifier (32 lowercase hex characters)",
4781
+ "examples": [
4782
+ "0af7651916cd43dd8448eb211c80319c"
4783
+ ],
4784
+ "x-csharp-type": "TraceId",
4785
+ "x-csharp-struct": true
4786
+ },
4787
+ "Common.TraceParent": {
4788
+ "type": "string",
4789
+ "pattern": "^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$",
4790
+ "description": "W3C Trace Context traceparent header format",
4791
+ "examples": [
4792
+ "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
4793
+ ]
4794
+ },
4795
+ "Common.TraceState": {
4796
+ "type": "string",
4797
+ "description": "W3C Trace Context tracestate header (vendor-specific key-value pairs)",
4798
+ "examples": [
4799
+ "rojo=00f067aa0ba902b7,congo=t61rcWkgMzE"
4800
+ ]
4801
+ },
4802
+ "Common.UnixNanos": {
4803
+ "type": "integer",
4804
+ "format": "uint64",
4805
+ "minimum": 0,
4806
+ "description": "Unsigned Unix timestamp in nanoseconds since epoch",
4807
+ "x-csharp-type": "ulong"
4808
+ },
4809
+ "Common.UrlPath": {
4810
+ "type": "string",
4811
+ "description": "URL path component",
4812
+ "examples": [
4813
+ "/api/v1/users"
4814
+ ]
4815
+ },
4816
+ "Common.UrlQuery": {
4817
+ "type": "string",
4818
+ "description": "URL query string (without leading ?)",
4819
+ "examples": [
4820
+ "page=1&limit=100"
4821
+ ]
4822
+ },
4823
+ "Common.UrlString": {
4824
+ "type": "string",
4825
+ "format": "uri",
4826
+ "description": "URL string (absolute)"
4827
+ },
4828
+ "Common.UserAgent": {
4829
+ "type": "string",
4830
+ "description": "User agent string",
4831
+ "examples": [
4832
+ "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
4833
+ ]
4834
+ },
4835
+ "Common.UserId": {
4836
+ "type": "string",
4837
+ "minLength": 1,
4838
+ "maxLength": 256,
4839
+ "description": "User identifier (pseudonymized for privacy)"
4840
+ },
4841
+ "Cost.GenAiEtlAuditCluster": {
4842
+ "type": "object",
4843
+ "required": [
4844
+ "cluster_id",
4845
+ "workflow_key",
4846
+ "service_name",
4847
+ "span_name",
4848
+ "output_contract",
4849
+ "task_family",
4850
+ "call_count",
4851
+ "input_tokens",
4852
+ "output_tokens",
4853
+ "cache_read_input_tokens",
4854
+ "cache_creation_input_tokens",
4855
+ "reasoning_output_tokens",
4856
+ "error_count",
4857
+ "error_rate",
4858
+ "average_latency_ms",
4859
+ "p95_latency_ms",
4860
+ "cost_attribution",
4861
+ "candidate_path",
4862
+ "validation_metric",
4863
+ "residual_path",
4864
+ "evidence_signals",
4865
+ "missing_evidence",
4866
+ "promotion_gates"
4867
+ ],
4868
+ "properties": {
4869
+ "cluster_id": {
4870
+ "type": "string",
4871
+ "description": "Stable identifier derived from the privacy-safe cluster dimensions."
4872
+ },
4873
+ "workflow_key": {
4874
+ "type": "string",
4875
+ "description": "Privacy-safe workflow identity used to group repeated calls."
4876
+ },
4877
+ "service_name": {
4878
+ "type": "string"
4879
+ },
4880
+ "span_name": {
4881
+ "type": "string"
4882
+ },
4883
+ "operation_name": {
4884
+ "type": "string"
4885
+ },
4886
+ "provider": {
4887
+ "type": "string"
4888
+ },
4889
+ "model": {
4890
+ "type": "string"
4891
+ },
4892
+ "output_contract": {
4893
+ "$ref": "#/components/schemas/Cost.GenAiEtlOutputContract"
4894
+ },
4895
+ "task_family": {
4896
+ "$ref": "#/components/schemas/Cost.GenAiEtlTaskFamily"
4897
+ },
4898
+ "call_count": {
4899
+ "$ref": "#/components/schemas/Common.Count"
4900
+ },
4901
+ "input_tokens": {
4902
+ "$ref": "#/components/schemas/Common.TokenCount"
4903
+ },
4904
+ "output_tokens": {
4905
+ "$ref": "#/components/schemas/Common.TokenCount"
4906
+ },
4907
+ "cache_read_input_tokens": {
4908
+ "$ref": "#/components/schemas/Common.TokenCount"
4909
+ },
4910
+ "cache_creation_input_tokens": {
4911
+ "$ref": "#/components/schemas/Common.TokenCount"
4912
+ },
4913
+ "reasoning_output_tokens": {
4914
+ "$ref": "#/components/schemas/Common.TokenCount"
4915
+ },
4916
+ "error_count": {
4917
+ "$ref": "#/components/schemas/Common.Count"
4918
+ },
4919
+ "error_rate": {
4920
+ "$ref": "#/components/schemas/Common.Ratio"
4921
+ },
4922
+ "average_latency_ms": {
4923
+ "$ref": "#/components/schemas/Common.DurationMs"
4924
+ },
4925
+ "p95_latency_ms": {
4926
+ "$ref": "#/components/schemas/Common.DurationMs"
4927
+ },
4928
+ "observed_cost_usd": {
4929
+ "allOf": [
4930
+ {
4931
+ "$ref": "#/components/schemas/Common.CostUsd"
4932
+ }
4933
+ ],
4934
+ "description": "Provider-sourced cost attributable to this cluster, absent when attribution is not defensible."
4935
+ },
4936
+ "cost_per_call_usd": {
4937
+ "$ref": "#/components/schemas/Common.CostUsd"
4938
+ },
4939
+ "cost_attribution": {
4940
+ "$ref": "#/components/schemas/Cost.ProviderCostAttribution"
4941
+ },
4942
+ "spend_share": {
4943
+ "allOf": [
4944
+ {
4945
+ "$ref": "#/components/schemas/Common.Ratio"
4946
+ }
4947
+ ],
4948
+ "description": "Fraction of attributable spend represented by this cluster."
4949
+ },
4950
+ "measurable_coverage": {
4951
+ "allOf": [
4952
+ {
4953
+ "$ref": "#/components/schemas/Common.Ratio"
4954
+ }
4955
+ ],
4956
+ "description": "Fraction of calls with a task-specific correctness signal."
4957
+ },
4958
+ "safe_deferral_coverage": {
4959
+ "allOf": [
4960
+ {
4961
+ "$ref": "#/components/schemas/Common.Ratio"
4962
+ }
4963
+ ],
4964
+ "description": "Fraction of calls proven safe to route to a residual path."
4965
+ },
4966
+ "candidate_path": {
4967
+ "$ref": "#/components/schemas/Cost.GenAiEtlCandidatePath"
4968
+ },
4969
+ "validation_metric": {
4970
+ "$ref": "#/components/schemas/Cost.GenAiEtlValidationMetric"
4971
+ },
4972
+ "residual_path": {
4973
+ "$ref": "#/components/schemas/Cost.GenAiEtlResidualPath"
4974
+ },
4975
+ "evidence_signals": {
4976
+ "type": "array",
4977
+ "items": {
4978
+ "$ref": "#/components/schemas/Cost.GenAiEtlEvidenceSignal"
4979
+ }
4980
+ },
4981
+ "missing_evidence": {
4982
+ "type": "array",
4983
+ "items": {
4984
+ "$ref": "#/components/schemas/Cost.GenAiEtlEvidenceSignal"
4985
+ }
4986
+ },
4987
+ "promotion_gates": {
4988
+ "type": "array",
4989
+ "items": {
4990
+ "$ref": "#/components/schemas/Cost.GenAiEtlPromotionGate"
4991
+ }
4992
+ }
4993
+ },
4994
+ "description": "Observed economics and evidence for one repeated GenAI workflow cluster."
4995
+ },
4996
+ "Cost.GenAiEtlAuditEvaluationRequest": {
4997
+ "type": "object",
4998
+ "required": [
4999
+ "scenarios"
5000
+ ],
5001
+ "properties": {
5002
+ "scenarios": {
5003
+ "type": "array",
5004
+ "items": {
5005
+ "$ref": "#/components/schemas/Cost.GenAiEtlClusterScenario"
5006
+ },
5007
+ "minItems": 1,
5008
+ "maxItems": 100
5009
+ }
5010
+ },
5011
+ "description": "Batch of cluster scenarios evaluated against one audit period."
5012
+ },
5013
+ "Cost.GenAiEtlAuditEvaluationResponse": {
5014
+ "type": "object",
5015
+ "required": [
5016
+ "generated_at",
5017
+ "period_start",
5018
+ "period_end",
5019
+ "results"
5020
+ ],
5021
+ "properties": {
5022
+ "generated_at": {
5023
+ "type": "string",
5024
+ "format": "date-time"
5025
+ },
5026
+ "period_start": {
5027
+ "type": "string",
5028
+ "format": "date-time"
5029
+ },
5030
+ "period_end": {
5031
+ "type": "string",
5032
+ "format": "date-time"
5033
+ },
5034
+ "results": {
5035
+ "type": "array",
5036
+ "items": {
5037
+ "$ref": "#/components/schemas/Cost.GenAiEtlClusterEvaluation"
5038
+ }
5039
+ }
5040
+ },
5041
+ "description": "Batch result for ETL replacement scenarios."
5042
+ },
5043
+ "Cost.GenAiEtlAuditReport": {
5044
+ "type": "object",
5045
+ "required": [
5046
+ "generated_at",
5047
+ "period_start",
5048
+ "period_end",
5049
+ "summary",
5050
+ "cost_sources",
5051
+ "clusters"
5052
+ ],
5053
+ "properties": {
5054
+ "generated_at": {
5055
+ "type": "string",
5056
+ "format": "date-time"
5057
+ },
5058
+ "period_start": {
5059
+ "type": "string",
5060
+ "format": "date-time"
5061
+ },
5062
+ "period_end": {
5063
+ "type": "string",
5064
+ "format": "date-time"
5065
+ },
5066
+ "summary": {
5067
+ "$ref": "#/components/schemas/Cost.GenAiEtlAuditSummary"
5068
+ },
5069
+ "cost_sources": {
5070
+ "type": "array",
5071
+ "items": {
5072
+ "$ref": "#/components/schemas/Cost.ProviderCostSource"
5073
+ }
5074
+ },
5075
+ "clusters": {
5076
+ "type": "array",
5077
+ "items": {
5078
+ "$ref": "#/components/schemas/Cost.GenAiEtlAuditCluster"
5079
+ }
5080
+ }
5081
+ },
5082
+ "description": "Trace-level ETL audit for a bounded period."
5083
+ },
5084
+ "Cost.GenAiEtlAuditSummary": {
5085
+ "type": "object",
5086
+ "required": [
5087
+ "total_calls",
5088
+ "total_input_tokens",
5089
+ "total_output_tokens",
5090
+ "priced_call_coverage"
5091
+ ],
5092
+ "properties": {
5093
+ "total_calls": {
5094
+ "$ref": "#/components/schemas/Common.Count"
5095
+ },
5096
+ "total_input_tokens": {
5097
+ "$ref": "#/components/schemas/Common.TokenCount"
5098
+ },
5099
+ "total_output_tokens": {
5100
+ "$ref": "#/components/schemas/Common.TokenCount"
5101
+ },
5102
+ "attributed_cost_usd": {
5103
+ "allOf": [
5104
+ {
5105
+ "$ref": "#/components/schemas/Common.CostUsd"
5106
+ }
5107
+ ],
5108
+ "description": "Provider-sourced cost attributable to the returned trace population."
5109
+ },
5110
+ "priced_call_coverage": {
5111
+ "allOf": [
5112
+ {
5113
+ "$ref": "#/components/schemas/Common.Ratio"
5114
+ }
5115
+ ],
5116
+ "description": "Fraction of calls covered by provider cost attribution."
5117
+ },
5118
+ "economic_concentration": {
5119
+ "allOf": [
5120
+ {
5121
+ "$ref": "#/components/schemas/Common.Ratio"
5122
+ }
5123
+ ],
5124
+ "description": "Fraction of attributable spend represented by the returned top clusters."
5125
+ },
5126
+ "measurable_coverage": {
5127
+ "allOf": [
5128
+ {
5129
+ "$ref": "#/components/schemas/Common.Ratio"
5130
+ }
5131
+ ],
5132
+ "description": "Fraction of calls with a task-specific correctness signal."
5133
+ },
5134
+ "safe_deferral_coverage": {
5135
+ "allOf": [
5136
+ {
5137
+ "$ref": "#/components/schemas/Common.Ratio"
5138
+ }
5139
+ ],
5140
+ "description": "Fraction of calls proven safe to defer to a residual path."
5141
+ },
5142
+ "candidate_etl_spend_share": {
5143
+ "allOf": [
5144
+ {
5145
+ "$ref": "#/components/schemas/Common.Ratio"
5146
+ }
5147
+ ],
5148
+ "description": "Fraction of attributable spend attached to ETL-shaped candidates."
5149
+ }
5150
+ },
5151
+ "description": "Aggregate trace-level economics for the requested audit period."
5152
+ },
5153
+ "Cost.GenAiEtlCalculationStatus": {
5154
+ "type": "string",
5155
+ "enum": [
5156
+ "calculated",
5157
+ "missing_frontier_cost"
5158
+ ],
5159
+ "description": "Whether the replaceable-value formula had a defensible baseline cost."
5160
+ },
5161
+ "Cost.GenAiEtlCandidatePath": {
5162
+ "type": "string",
5163
+ "enum": [
5164
+ "exact_cache",
5165
+ "deterministic_code",
5166
+ "bounded_retrieval",
5167
+ "small_classifier_extractor",
5168
+ "smaller_generative_model",
5169
+ "frontier_model",
5170
+ "insufficient_evidence"
5171
+ ],
5172
+ "description": "Lowest-risk implementation class suggested by currently available evidence."
5173
+ },
5174
+ "Cost.GenAiEtlClusterEvaluation": {
5175
+ "type": "object",
5176
+ "required": [
5177
+ "cluster_id",
5178
+ "status",
5179
+ "call_count",
5180
+ "coverage",
5181
+ "served_call_count",
5182
+ "residual_call_count",
5183
+ "frontier_cost_basis",
5184
+ "alternative_cost_per_call_usd",
5185
+ "period_maintenance_cost_usd",
5186
+ "period_error_cost_usd"
5187
+ ],
5188
+ "properties": {
5189
+ "cluster_id": {
5190
+ "type": "string"
5191
+ },
5192
+ "status": {
5193
+ "$ref": "#/components/schemas/Cost.GenAiEtlCalculationStatus"
5194
+ },
5195
+ "call_count": {
5196
+ "$ref": "#/components/schemas/Common.Count"
5197
+ },
5198
+ "coverage": {
5199
+ "$ref": "#/components/schemas/Common.Ratio"
5200
+ },
5201
+ "served_call_count": {
5202
+ "type": "number",
5203
+ "format": "double"
5204
+ },
5205
+ "residual_call_count": {
5206
+ "type": "number",
5207
+ "format": "double"
5208
+ },
5209
+ "frontier_cost_per_call_usd": {
5210
+ "$ref": "#/components/schemas/Common.CostUsd"
5211
+ },
5212
+ "frontier_cost_basis": {
5213
+ "$ref": "#/components/schemas/Cost.ProviderCostAttribution"
5214
+ },
5215
+ "alternative_cost_per_call_usd": {
5216
+ "$ref": "#/components/schemas/Common.CostUsd"
5217
+ },
5218
+ "current_period_cost_usd": {
5219
+ "$ref": "#/components/schemas/Common.CostUsd"
5220
+ },
5221
+ "gross_replaceable_value_usd": {
5222
+ "type": "number",
5223
+ "format": "double"
5224
+ },
5225
+ "period_maintenance_cost_usd": {
5226
+ "$ref": "#/components/schemas/Common.CostUsd"
5227
+ },
5228
+ "period_error_cost_usd": {
5229
+ "$ref": "#/components/schemas/Common.CostUsd"
5230
+ },
5231
+ "net_replaceable_value_usd": {
5232
+ "type": "number",
5233
+ "format": "double",
5234
+ "description": "Net period value; this may be negative when maintenance or error cost exceeds gross savings."
5235
+ }
5236
+ },
5237
+ "description": "Result of replaceable_value = calls * coverage * (frontier - alternative) - maintenance - error."
5238
+ },
5239
+ "Cost.GenAiEtlClusterScenario": {
5240
+ "type": "object",
5241
+ "required": [
5242
+ "cluster_id",
5243
+ "coverage",
5244
+ "alternative_cost_per_call_usd",
5245
+ "period_maintenance_cost_usd",
5246
+ "period_error_cost_usd"
5247
+ ],
5248
+ "properties": {
5249
+ "cluster_id": {
5250
+ "type": "string"
5251
+ },
5252
+ "coverage": {
5253
+ "allOf": [
5254
+ {
5255
+ "$ref": "#/components/schemas/Common.Ratio"
5256
+ }
5257
+ ],
5258
+ "description": "Fraction of cluster calls the replacement is expected to serve safely."
5259
+ },
5260
+ "frontier_cost_per_call_usd": {
5261
+ "allOf": [
5262
+ {
5263
+ "$ref": "#/components/schemas/Common.CostUsd"
5264
+ }
5265
+ ],
5266
+ "description": "Explicit baseline cost per call. When absent, qyl uses provider-attributed cluster cost and otherwise fails closed."
4347
5267
  },
4348
- "service_name": {
4349
- "type": "string",
4350
- "description": "Filter by service name"
5268
+ "alternative_cost_per_call_usd": {
5269
+ "$ref": "#/components/schemas/Common.CostUsd"
4351
5270
  },
4352
- "max_events_per_second": {
4353
- "type": "integer",
4354
- "format": "int32",
4355
- "minimum": 1,
4356
- "maximum": 1000,
4357
- "description": "Maximum events per second (rate limiting)",
4358
- "default": 100
5271
+ "period_maintenance_cost_usd": {
5272
+ "$ref": "#/components/schemas/Common.CostUsd"
5273
+ },
5274
+ "period_error_cost_usd": {
5275
+ "$ref": "#/components/schemas/Common.CostUsd"
4359
5276
  }
4360
5277
  },
4361
- "description": "Streaming parameters for SSE endpoints"
5278
+ "description": "What-if assumptions for one workflow cluster over the requested period."
4362
5279
  },
4363
- "Common.Pagination.TimeBucket": {
5280
+ "Cost.GenAiEtlEvidenceSignal": {
4364
5281
  "type": "string",
4365
5282
  "enum": [
4366
- "1m",
4367
- "5m",
4368
- "15m",
4369
- "1h",
4370
- "1d",
4371
- "1w",
4372
- "auto"
5283
+ "workflow_identity",
5284
+ "output_contract",
5285
+ "provider_model",
5286
+ "token_usage",
5287
+ "provider_cost",
5288
+ "recurring_schema",
5289
+ "bounded_reference",
5290
+ "task_metric",
5291
+ "accepted_output_replay",
5292
+ "downstream_fate",
5293
+ "calibrated_confidence",
5294
+ "shadow_comparison",
5295
+ "fallback_policy"
5296
+ ],
5297
+ "description": "Observable evidence needed to promote an inferred replacement safely."
5298
+ },
5299
+ "Cost.GenAiEtlOutputContract": {
5300
+ "type": "string",
5301
+ "enum": [
5302
+ "prose",
5303
+ "label",
5304
+ "span_list",
5305
+ "record",
5306
+ "vector",
5307
+ "catalog_reference",
5308
+ "number",
5309
+ "boolean",
5310
+ "unknown"
4373
5311
  ],
4374
- "description": "Time bucket size for aggregations"
5312
+ "description": "Machine-readable output contract inferred for a workflow cluster."
4375
5313
  },
4376
- "Common.Pagination.TimeRangeParams": {
5314
+ "Cost.GenAiEtlPromotionGate": {
4377
5315
  "type": "object",
5316
+ "required": [
5317
+ "gate",
5318
+ "state"
5319
+ ],
4378
5320
  "properties": {
4379
- "start_time": {
4380
- "type": "string",
4381
- "format": "date-time",
4382
- "description": "Start of time range (inclusive)"
5321
+ "gate": {
5322
+ "$ref": "#/components/schemas/Cost.GenAiEtlPromotionGateKind"
4383
5323
  },
4384
- "end_time": {
4385
- "type": "string",
4386
- "format": "date-time",
4387
- "description": "End of time range (exclusive)"
5324
+ "state": {
5325
+ "$ref": "#/components/schemas/Cost.GenAiEtlPromotionGateState"
4388
5326
  },
4389
- "limit": {
4390
- "type": "integer",
4391
- "format": "int32",
4392
- "minimum": 1,
4393
- "maximum": 10000,
4394
- "description": "Maximum number of items to return",
4395
- "default": 1000
5327
+ "reason": {
5328
+ "type": "string",
5329
+ "description": "Stable evidence code explaining the current gate state."
4396
5330
  }
4397
5331
  },
4398
- "description": "Time-range based query parameters"
4399
- },
4400
- "Common.Percentage": {
4401
- "type": "number",
4402
- "format": "double",
4403
- "minimum": 0,
4404
- "maximum": 100,
4405
- "description": "Percentage value (0.0 to 100.0)",
4406
- "x-csharp-type": "double"
4407
- },
4408
- "Common.Port": {
4409
- "type": "integer",
4410
- "format": "int32",
4411
- "minimum": 1,
4412
- "maximum": 65535,
4413
- "description": "Network port number (1-65535)",
4414
- "x-csharp-type": "int"
4415
- },
4416
- "Common.Ratio": {
4417
- "type": "number",
4418
- "format": "double",
4419
- "minimum": 0,
4420
- "maximum": 1,
4421
- "description": "Ratio value (0.0 to 1.0)",
4422
- "x-csharp-type": "double"
4423
- },
4424
- "Common.SemVer": {
4425
- "type": "string",
4426
- "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
4427
- "description": "Semantic version string (e.g., 1.2.3)",
4428
- "examples": [
4429
- "2.1.0"
4430
- ]
4431
- },
4432
- "Common.SessionId": {
4433
- "type": "string",
4434
- "minLength": 1,
4435
- "maxLength": 128,
4436
- "description": "Unique session identifier",
4437
- "x-csharp-type": "SessionId",
4438
- "x-csharp-struct": true
4439
- },
4440
- "Common.Sha256Hash": {
4441
- "type": "string",
4442
- "minLength": 64,
4443
- "maxLength": 64,
4444
- "pattern": "^[a-f0-9]{64}$",
4445
- "description": "SHA-256 hash in lowercase hex"
5332
+ "description": "Promotion readiness for one gate."
4446
5333
  },
4447
- "Common.SpanId": {
5334
+ "Cost.GenAiEtlPromotionGateKind": {
4448
5335
  "type": "string",
4449
- "minLength": 16,
4450
- "maxLength": 16,
4451
- "pattern": "^[a-f0-9]{16}$",
4452
- "description": "Unique span identifier (16 lowercase hex characters)",
4453
- "examples": [
4454
- "b7ad6b7169203331"
5336
+ "enum": [
5337
+ "contract_stability",
5338
+ "offline_replay",
5339
+ "calibrated_confidence",
5340
+ "shadow_traffic",
5341
+ "limited_serving",
5342
+ "rollback_residual_policy"
4455
5343
  ],
4456
- "x-csharp-type": "SpanId",
4457
- "x-csharp-struct": true
4458
- },
4459
- "Common.Temperature": {
4460
- "type": "number",
4461
- "format": "double",
4462
- "minimum": 0,
4463
- "maximum": 2,
4464
- "description": "Temperature setting for LLM requests (0.0-2.0)",
4465
- "x-csharp-type": "double"
4466
- },
4467
- "Common.Timestamp": {
4468
- "type": "string",
4469
- "format": "date-time",
4470
- "description": "ISO 8601 timestamp with nanosecond precision (RFC 3339)"
4471
- },
4472
- "Common.TokenCount": {
4473
- "type": "integer",
4474
- "format": "int64",
4475
- "minimum": 0,
4476
- "description": "Token count (for LLM operations)",
4477
- "x-csharp-type": "long"
5344
+ "description": "Promotion gate from replay through limited serving and rollback."
4478
5345
  },
4479
- "Common.TraceId": {
5346
+ "Cost.GenAiEtlPromotionGateState": {
4480
5347
  "type": "string",
4481
- "minLength": 32,
4482
- "maxLength": 32,
4483
- "pattern": "^[a-f0-9]{32}$",
4484
- "description": "Unique trace identifier (32 lowercase hex characters)",
4485
- "examples": [
4486
- "0af7651916cd43dd8448eb211c80319c"
5348
+ "enum": [
5349
+ "passed",
5350
+ "failed",
5351
+ "not_evaluated",
5352
+ "blocked_missing_evidence"
4487
5353
  ],
4488
- "x-csharp-type": "TraceId",
4489
- "x-csharp-struct": true
5354
+ "description": "Evaluation state of a promotion gate."
4490
5355
  },
4491
- "Common.TraceParent": {
5356
+ "Cost.GenAiEtlResidualPath": {
4492
5357
  "type": "string",
4493
- "pattern": "^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$",
4494
- "description": "W3C Trace Context traceparent header format",
4495
- "examples": [
4496
- "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
4497
- ]
5358
+ "enum": [
5359
+ "frontier_model",
5360
+ "human_review",
5361
+ "retry",
5362
+ "degraded_response",
5363
+ "none",
5364
+ "undetermined"
5365
+ ],
5366
+ "description": "Fallback used for requests outside a promoted replacement's safe coverage."
4498
5367
  },
4499
- "Common.TraceState": {
5368
+ "Cost.GenAiEtlTaskFamily": {
4500
5369
  "type": "string",
4501
- "description": "W3C Trace Context tracestate header (vendor-specific key-value pairs)",
4502
- "examples": [
4503
- "rojo=00f067aa0ba902b7,congo=t61rcWkgMzE"
4504
- ]
4505
- },
4506
- "Common.UnixNanos": {
4507
- "type": "integer",
4508
- "format": "uint64",
4509
- "minimum": 0,
4510
- "description": "Unsigned Unix timestamp in nanoseconds since epoch",
4511
- "x-csharp-type": "ulong"
5370
+ "enum": [
5371
+ "open_reasoning_generation",
5372
+ "classification",
5373
+ "sequence_labeling",
5374
+ "structured_extraction",
5375
+ "retrieval_entity_resolution",
5376
+ "similarity_clustering",
5377
+ "normalization_transformation",
5378
+ "numeric_analytical",
5379
+ "unknown"
5380
+ ],
5381
+ "description": "Task family inferred for a repeated GenAI workflow cluster."
4512
5382
  },
4513
- "Common.UrlPath": {
5383
+ "Cost.GenAiEtlValidationMetric": {
4514
5384
  "type": "string",
4515
- "description": "URL path component",
4516
- "examples": [
4517
- "/api/v1/users"
4518
- ]
4519
- },
4520
- "Common.UrlQuery": {
5385
+ "enum": [
5386
+ "accuracy",
5387
+ "macro_f1",
5388
+ "span_f1",
5389
+ "field_exact_match",
5390
+ "schema_validity",
5391
+ "match_accuracy",
5392
+ "recall_at_k",
5393
+ "mean_reciprocal_rank",
5394
+ "exact_match",
5395
+ "numeric_tolerance",
5396
+ "human_preference",
5397
+ "task_success",
5398
+ "unavailable"
5399
+ ],
5400
+ "description": "Task-specific metric that can falsify a proposed replacement."
5401
+ },
5402
+ "Cost.ProviderCostAttribution": {
4521
5403
  "type": "string",
4522
- "description": "URL query string (without leading ?)",
4523
- "examples": [
4524
- "page=1&limit=100"
4525
- ]
5404
+ "enum": [
5405
+ "provider_model_period",
5406
+ "provider_period",
5407
+ "scenario",
5408
+ "unavailable"
5409
+ ],
5410
+ "description": "Granularity at which a cost value can be attributed to telemetry."
4526
5411
  },
4527
- "Common.UrlString": {
4528
- "type": "string",
4529
- "format": "uri",
4530
- "description": "URL string (absolute)"
5412
+ "Cost.ProviderCostSource": {
5413
+ "type": "object",
5414
+ "required": [
5415
+ "provider",
5416
+ "kind",
5417
+ "status",
5418
+ "source_endpoint",
5419
+ "attribution"
5420
+ ],
5421
+ "properties": {
5422
+ "provider": {
5423
+ "type": "string",
5424
+ "description": "Canonical GenAI provider or cloud billing system name."
5425
+ },
5426
+ "kind": {
5427
+ "allOf": [
5428
+ {
5429
+ "$ref": "#/components/schemas/Cost.ProviderCostSourceKind"
5430
+ }
5431
+ ],
5432
+ "description": "Whether the API returned billed cost or a public catalog price."
5433
+ },
5434
+ "status": {
5435
+ "allOf": [
5436
+ {
5437
+ "$ref": "#/components/schemas/Cost.ProviderCostSourceStatus"
5438
+ }
5439
+ ],
5440
+ "description": "Current synchronization and attribution state."
5441
+ },
5442
+ "source_endpoint": {
5443
+ "allOf": [
5444
+ {
5445
+ "$ref": "#/components/schemas/Common.UrlString"
5446
+ }
5447
+ ],
5448
+ "description": "Official provider-owned API endpoint used for the fetch."
5449
+ },
5450
+ "attribution": {
5451
+ "allOf": [
5452
+ {
5453
+ "$ref": "#/components/schemas/Cost.ProviderCostAttribution"
5454
+ }
5455
+ ],
5456
+ "description": "Attribution granularity supported by this source response."
5457
+ },
5458
+ "last_attempt_at": {
5459
+ "type": "string",
5460
+ "format": "date-time",
5461
+ "description": "UTC time of the latest fetch attempt."
5462
+ },
5463
+ "last_success_at": {
5464
+ "type": "string",
5465
+ "format": "date-time",
5466
+ "description": "UTC time of the latest successful fetch."
5467
+ },
5468
+ "period_start": {
5469
+ "type": "string",
5470
+ "format": "date-time",
5471
+ "description": "Start of the provider billing or catalog validity period."
5472
+ },
5473
+ "period_end": {
5474
+ "type": "string",
5475
+ "format": "date-time",
5476
+ "description": "End of the provider billing or catalog validity period."
5477
+ },
5478
+ "currency_code": {
5479
+ "type": "string",
5480
+ "description": "ISO 4217 currency code returned by the provider."
5481
+ },
5482
+ "reported_cost_usd": {
5483
+ "allOf": [
5484
+ {
5485
+ "$ref": "#/components/schemas/Common.CostUsd"
5486
+ }
5487
+ ],
5488
+ "description": "Cost returned by the provider for this period, converted from provider-declared USD units without rate inference."
5489
+ },
5490
+ "model": {
5491
+ "type": "string",
5492
+ "description": "Model identifier returned by the provider when the source supports it."
5493
+ },
5494
+ "failure_category": {
5495
+ "type": "string",
5496
+ "description": "Stable, non-sensitive failure category for the last attempt."
5497
+ }
5498
+ },
5499
+ "description": "Provenance for cost data fetched directly from a provider-owned API."
4531
5500
  },
4532
- "Common.UserAgent": {
5501
+ "Cost.ProviderCostSourceKind": {
4533
5502
  "type": "string",
4534
- "description": "User agent string",
4535
- "examples": [
4536
- "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
4537
- ]
5503
+ "enum": [
5504
+ "actual_billed_cost",
5505
+ "official_public_catalog"
5506
+ ],
5507
+ "description": "How a provider-owned API supplied a cost value."
4538
5508
  },
4539
- "Common.UserId": {
5509
+ "Cost.ProviderCostSourceStatus": {
4540
5510
  "type": "string",
4541
- "minLength": 1,
4542
- "maxLength": 256,
4543
- "description": "User identifier (pseudonymized for privacy)"
5511
+ "enum": [
5512
+ "unconfigured",
5513
+ "current",
5514
+ "stale",
5515
+ "sync_failed",
5516
+ "not_attributable"
5517
+ ],
5518
+ "description": "Current synchronization state for a provider-owned cost source."
4544
5519
  },
4545
5520
  "Domains.Observe.Session.DeviceType": {
4546
5521
  "type": "string",
@@ -4824,11 +5799,6 @@
4824
5799
  "type": "string"
4825
5800
  },
4826
5801
  "description": "Providers used in session"
4827
- },
4828
- "estimated_cost_usd": {
4829
- "type": "number",
4830
- "format": "double",
4831
- "description": "Estimated cost in USD"
4832
5802
  }
4833
5803
  },
4834
5804
  "description": "Session GenAI usage summary"