@claudexor/schema 3.9.8 → 3.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,464 @@
1
+ {
2
+ "$ref": "#/definitions/ControlModelOperationDetail",
3
+ "definitions": {
4
+ "ControlModelOperationDetail": {
5
+ "type": "object",
6
+ "properties": {
7
+ "id": {
8
+ "type": "string",
9
+ "minLength": 1,
10
+ "description": "Non-empty identifier string."
11
+ },
12
+ "state": {
13
+ "type": "string",
14
+ "enum": [
15
+ "queued",
16
+ "running",
17
+ "succeeded",
18
+ "failed",
19
+ "cancelled",
20
+ "interrupted"
21
+ ],
22
+ "description": "Run lifecycle: queued, running, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks, review, delivery) is orthogonal."
23
+ },
24
+ "createdAt": {
25
+ "type": "string",
26
+ "minLength": 1,
27
+ "description": "ISO-8601 timestamp string."
28
+ },
29
+ "startedAt": {
30
+ "anyOf": [
31
+ {
32
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
33
+ },
34
+ {
35
+ "type": "null"
36
+ }
37
+ ],
38
+ "description": "ISO-8601 timestamp string."
39
+ },
40
+ "finishedAt": {
41
+ "anyOf": [
42
+ {
43
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
44
+ },
45
+ {
46
+ "type": "null"
47
+ }
48
+ ],
49
+ "description": "ISO-8601 timestamp string."
50
+ },
51
+ "dispatch": {
52
+ "type": "object",
53
+ "properties": {
54
+ "state": {
55
+ "type": "string",
56
+ "enum": [
57
+ "not_started",
58
+ "started",
59
+ "response_received",
60
+ "unknown"
61
+ ]
62
+ },
63
+ "startedAt": {
64
+ "anyOf": [
65
+ {
66
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
67
+ },
68
+ {
69
+ "type": "null"
70
+ }
71
+ ],
72
+ "description": "ISO-8601 timestamp string."
73
+ },
74
+ "route": {
75
+ "anyOf": [
76
+ {
77
+ "type": "object",
78
+ "properties": {
79
+ "source": {
80
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/id"
81
+ },
82
+ "credentialProfileId": {
83
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/id"
84
+ },
85
+ "accountFingerprint": {
86
+ "type": [
87
+ "string",
88
+ "null"
89
+ ]
90
+ },
91
+ "model": {
92
+ "type": [
93
+ "string",
94
+ "null"
95
+ ]
96
+ }
97
+ },
98
+ "required": [
99
+ "source",
100
+ "credentialProfileId",
101
+ "accountFingerprint",
102
+ "model"
103
+ ],
104
+ "additionalProperties": false,
105
+ "description": "Selected route at dispatch; a result records the actually observed model, or null."
106
+ },
107
+ {
108
+ "type": "null"
109
+ }
110
+ ],
111
+ "description": "Selected route at dispatch; a result records the actually observed model, or null."
112
+ }
113
+ },
114
+ "required": [
115
+ "state",
116
+ "startedAt",
117
+ "route"
118
+ ],
119
+ "additionalProperties": false,
120
+ "description": "Started means the physical send may have begun, not proof the upstream accepted it."
121
+ },
122
+ "response": {
123
+ "anyOf": [
124
+ {
125
+ "type": "object",
126
+ "properties": {
127
+ "state": {
128
+ "type": "string",
129
+ "const": "absent"
130
+ }
131
+ },
132
+ "required": [
133
+ "state"
134
+ ],
135
+ "additionalProperties": false
136
+ },
137
+ {
138
+ "type": "object",
139
+ "properties": {
140
+ "state": {
141
+ "type": "string",
142
+ "const": "ready"
143
+ },
144
+ "ref": {
145
+ "type": "object",
146
+ "properties": {
147
+ "resourceId": {
148
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/id"
149
+ },
150
+ "sha256": {
151
+ "type": "string",
152
+ "pattern": "^sha256:[a-f0-9]{64}$"
153
+ },
154
+ "sizeBytes": {
155
+ "type": "integer",
156
+ "minimum": 0
157
+ }
158
+ },
159
+ "required": [
160
+ "resourceId",
161
+ "sha256",
162
+ "sizeBytes"
163
+ ],
164
+ "additionalProperties": false,
165
+ "description": "Digest-bound model-purpose resource; never an Agent attachment."
166
+ },
167
+ "readyAt": {
168
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
169
+ },
170
+ "expiresAt": {
171
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
172
+ }
173
+ },
174
+ "required": [
175
+ "state",
176
+ "ref",
177
+ "readyAt",
178
+ "expiresAt"
179
+ ],
180
+ "additionalProperties": false
181
+ },
182
+ {
183
+ "type": "object",
184
+ "properties": {
185
+ "state": {
186
+ "type": "string",
187
+ "const": "acknowledged"
188
+ },
189
+ "ref": {
190
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/response/anyOf/1/properties/ref"
191
+ },
192
+ "releasedAt": {
193
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
194
+ }
195
+ },
196
+ "required": [
197
+ "state",
198
+ "ref",
199
+ "releasedAt"
200
+ ],
201
+ "additionalProperties": false
202
+ },
203
+ {
204
+ "type": "object",
205
+ "properties": {
206
+ "state": {
207
+ "type": "string",
208
+ "const": "expired"
209
+ },
210
+ "ref": {
211
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/response/anyOf/1/properties/ref"
212
+ },
213
+ "releasedAt": {
214
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/createdAt"
215
+ }
216
+ },
217
+ "required": [
218
+ "state",
219
+ "ref",
220
+ "releasedAt"
221
+ ],
222
+ "additionalProperties": false
223
+ }
224
+ ],
225
+ "description": "Result GET does not acknowledge delivery. Acknowledged/expired bytes never cause another generation."
226
+ },
227
+ "usage": {
228
+ "type": "object",
229
+ "properties": {
230
+ "input_tokens": {
231
+ "anyOf": [
232
+ {
233
+ "type": "integer",
234
+ "minimum": 0
235
+ },
236
+ {
237
+ "type": "null"
238
+ }
239
+ ],
240
+ "default": null
241
+ },
242
+ "output_tokens": {
243
+ "anyOf": [
244
+ {
245
+ "type": "integer",
246
+ "minimum": 0
247
+ },
248
+ {
249
+ "type": "null"
250
+ }
251
+ ],
252
+ "default": null
253
+ },
254
+ "cached_input_tokens": {
255
+ "anyOf": [
256
+ {
257
+ "type": "integer",
258
+ "minimum": 0
259
+ },
260
+ {
261
+ "type": "null"
262
+ }
263
+ ],
264
+ "default": null
265
+ },
266
+ "cache_write_tokens": {
267
+ "anyOf": [
268
+ {
269
+ "type": "integer",
270
+ "minimum": 0
271
+ },
272
+ {
273
+ "type": "null"
274
+ }
275
+ ],
276
+ "default": null
277
+ },
278
+ "reasoning_tokens": {
279
+ "anyOf": [
280
+ {
281
+ "type": "integer",
282
+ "minimum": 0
283
+ },
284
+ {
285
+ "type": "null"
286
+ }
287
+ ],
288
+ "default": null
289
+ }
290
+ },
291
+ "additionalProperties": false,
292
+ "description": "Provider-reported counters for one generation; missing counters remain null."
293
+ },
294
+ "cost": {
295
+ "anyOf": [
296
+ {
297
+ "type": "object",
298
+ "properties": {
299
+ "knowledge": {
300
+ "type": "string",
301
+ "enum": [
302
+ "exact",
303
+ "estimated",
304
+ "unknown"
305
+ ],
306
+ "description": "Quality of incremental-cash cost evidence for an operation."
307
+ },
308
+ "billing": {
309
+ "type": "string",
310
+ "enum": [
311
+ "proven_zero",
312
+ "subscription_entitlement",
313
+ "metered",
314
+ "unknown"
315
+ ],
316
+ "description": "What is actually known about incremental billing; a native credential route alone never proves entitlement or zero cost."
317
+ },
318
+ "source": {
319
+ "type": "string",
320
+ "minLength": 1
321
+ },
322
+ "provenance": {
323
+ "type": "array",
324
+ "items": {
325
+ "type": "string",
326
+ "minLength": 1
327
+ },
328
+ "minItems": 1
329
+ },
330
+ "estimatedUsd": {
331
+ "anyOf": [
332
+ {
333
+ "type": "number",
334
+ "minimum": 0
335
+ },
336
+ {
337
+ "type": "null"
338
+ }
339
+ ],
340
+ "default": null
341
+ },
342
+ "cashUsd": {
343
+ "anyOf": [
344
+ {
345
+ "type": "number",
346
+ "minimum": 0
347
+ },
348
+ {
349
+ "type": "null"
350
+ }
351
+ ],
352
+ "default": null
353
+ },
354
+ "valuationUsd": {
355
+ "anyOf": [
356
+ {
357
+ "type": "number",
358
+ "minimum": 0
359
+ },
360
+ {
361
+ "type": "null"
362
+ }
363
+ ],
364
+ "default": null
365
+ },
366
+ "valuationKnowledge": {
367
+ "$ref": "#/definitions/ControlModelOperationDetail/properties/cost/anyOf/0/properties/knowledge",
368
+ "default": "unknown",
369
+ "description": "Quality of incremental-cash cost evidence for an operation."
370
+ }
371
+ },
372
+ "required": [
373
+ "knowledge",
374
+ "billing",
375
+ "source",
376
+ "provenance"
377
+ ],
378
+ "additionalProperties": false,
379
+ "description": "Incremental cash and token valuation are independent; subscription credentials alone never invent a cash receipt."
380
+ },
381
+ {
382
+ "type": "null"
383
+ }
384
+ ],
385
+ "description": "Incremental cash and token valuation are independent; subscription credentials alone never invent a cash receipt."
386
+ },
387
+ "problem": {
388
+ "anyOf": [
389
+ {
390
+ "type": "object",
391
+ "properties": {
392
+ "code": {
393
+ "type": "string",
394
+ "minLength": 1
395
+ },
396
+ "message": {
397
+ "type": "string"
398
+ },
399
+ "retryable": {
400
+ "type": "boolean"
401
+ },
402
+ "fieldErrors": {
403
+ "type": "object",
404
+ "additionalProperties": {
405
+ "type": "array",
406
+ "items": {
407
+ "type": "string"
408
+ }
409
+ },
410
+ "default": {}
411
+ },
412
+ "requiredActions": {
413
+ "type": "array",
414
+ "items": {
415
+ "type": "string",
416
+ "minLength": 1
417
+ },
418
+ "default": []
419
+ },
420
+ "evidenceRefs": {
421
+ "type": "array",
422
+ "items": {
423
+ "type": "string",
424
+ "minLength": 1
425
+ },
426
+ "default": []
427
+ },
428
+ "context": {
429
+ "type": "object",
430
+ "additionalProperties": {},
431
+ "default": {},
432
+ "description": "Typed route-specific recovery context; never a duplicate error message."
433
+ }
434
+ },
435
+ "required": [
436
+ "code",
437
+ "message",
438
+ "retryable"
439
+ ],
440
+ "additionalProperties": false
441
+ },
442
+ {
443
+ "type": "null"
444
+ }
445
+ ]
446
+ }
447
+ },
448
+ "required": [
449
+ "id",
450
+ "state",
451
+ "createdAt",
452
+ "startedAt",
453
+ "finishedAt",
454
+ "dispatch",
455
+ "response",
456
+ "usage",
457
+ "cost",
458
+ "problem"
459
+ ],
460
+ "additionalProperties": false
461
+ }
462
+ },
463
+ "$schema": "http://json-schema.org/draft-07/schema#"
464
+ }
@@ -0,0 +1,44 @@
1
+ {
2
+ "$ref": "#/definitions/ControlModelSourcesResponse",
3
+ "definitions": {
4
+ "ControlModelSourcesResponse": {
5
+ "type": "object",
6
+ "properties": {
7
+ "sources": {
8
+ "type": "array",
9
+ "items": {
10
+ "type": "object",
11
+ "properties": {
12
+ "id": {
13
+ "type": "string",
14
+ "minLength": 1,
15
+ "description": "Non-empty identifier string."
16
+ },
17
+ "label": {
18
+ "type": "string",
19
+ "minLength": 1,
20
+ "pattern": "\\S",
21
+ "description": "User-supplied string that must contain visible content, not just whitespace."
22
+ },
23
+ "credentialHarness": {
24
+ "$ref": "#/definitions/ControlModelSourcesResponse/properties/sources/items/properties/id"
25
+ }
26
+ },
27
+ "required": [
28
+ "id",
29
+ "label",
30
+ "credentialHarness"
31
+ ],
32
+ "additionalProperties": false
33
+ }
34
+ }
35
+ },
36
+ "required": [
37
+ "sources"
38
+ ],
39
+ "additionalProperties": false,
40
+ "description": "Available raw model transports, distinct from agent harness inventory."
41
+ }
42
+ },
43
+ "$schema": "http://json-schema.org/draft-07/schema#"
44
+ }
@@ -9,6 +9,11 @@
9
9
  "minLength": 1,
10
10
  "description": "Non-empty identifier string."
11
11
  },
12
+ "purpose": {
13
+ "type": "string",
14
+ "const": "model",
15
+ "description": "Immutable model-operation purpose; absent means a legacy or ordinary attachment."
16
+ },
12
17
  "kind": {
13
18
  "type": "string",
14
19
  "enum": [
@@ -4,6 +4,11 @@
4
4
  "ControlUploadCreateRequest": {
5
5
  "type": "object",
6
6
  "properties": {
7
+ "purpose": {
8
+ "type": "string",
9
+ "const": "model",
10
+ "description": "Model-operation payload, never an Agent attachment; absent preserves attachment semantics."
11
+ },
7
12
  "kind": {
8
13
  "type": "string",
9
14
  "enum": [