@claudexor/schema 3.9.8 → 3.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist/attachment.d.ts +6 -0
  2. package/dist/attachment.d.ts.map +1 -1
  3. package/dist/attachment.js +8 -0
  4. package/dist/attachment.js.map +1 -1
  5. package/dist/control-gc.d.ts +21 -0
  6. package/dist/control-gc.d.ts.map +1 -1
  7. package/dist/control-gc.js +12 -0
  8. package/dist/control-gc.js.map +1 -1
  9. package/dist/index.d.ts +1 -0
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +1 -0
  12. package/dist/index.js.map +1 -1
  13. package/dist/model-operation.d.ts +2158 -0
  14. package/dist/model-operation.d.ts.map +1 -0
  15. package/dist/model-operation.js +230 -0
  16. package/dist/model-operation.js.map +1 -0
  17. package/dist/quota.d.ts +4 -7
  18. package/dist/quota.d.ts.map +1 -1
  19. package/dist/quota.js +13 -11
  20. package/dist/quota.js.map +1 -1
  21. package/generated/ControlCredentialProfilesQueryResponse.schema.json +3 -3
  22. package/generated/ControlCredentialProfilesSnapshotResponse.schema.json +3 -3
  23. package/generated/ControlGcReceipt.schema.json +23 -0
  24. package/generated/ControlGcRequest.schema.json +4 -0
  25. package/generated/ControlModelCatalogResponse.schema.json +137 -0
  26. package/generated/ControlModelOperationAckRequest.schema.json +19 -0
  27. package/generated/ControlModelOperationControlRequest.schema.json +27 -0
  28. package/generated/ControlModelOperationCreateRequest.schema.json +40 -0
  29. package/generated/ControlModelOperationDetail.schema.json +464 -0
  30. package/generated/ControlModelSourcesResponse.schema.json +44 -0
  31. package/generated/ControlQuotaResponse.schema.json +3 -3
  32. package/generated/ControlResource.schema.json +5 -0
  33. package/generated/ControlUploadCreateRequest.schema.json +5 -0
  34. package/generated/ModelCallRequest.schema.json +316 -0
  35. package/generated/ModelCallResult.schema.json +419 -0
  36. package/package.json +2 -2
@@ -0,0 +1,27 @@
1
+ {
2
+ "$ref": "#/definitions/ControlModelOperationControlRequest",
3
+ "definitions": {
4
+ "ControlModelOperationControlRequest": {
5
+ "type": "object",
6
+ "properties": {
7
+ "action": {
8
+ "type": "string",
9
+ "const": "cancel"
10
+ },
11
+ "reasonCode": {
12
+ "type": "string",
13
+ "enum": [
14
+ "user_cancelled",
15
+ "host_cancelled",
16
+ "owner_task_gone"
17
+ ]
18
+ }
19
+ },
20
+ "required": [
21
+ "action"
22
+ ],
23
+ "additionalProperties": false
24
+ }
25
+ },
26
+ "$schema": "http://json-schema.org/draft-07/schema#"
27
+ }
@@ -0,0 +1,40 @@
1
+ {
2
+ "$ref": "#/definitions/ControlModelOperationCreateRequest",
3
+ "definitions": {
4
+ "ControlModelOperationCreateRequest": {
5
+ "type": "object",
6
+ "properties": {
7
+ "request": {
8
+ "type": "object",
9
+ "properties": {
10
+ "resourceId": {
11
+ "type": "string",
12
+ "minLength": 1,
13
+ "description": "Non-empty identifier string."
14
+ },
15
+ "sha256": {
16
+ "type": "string",
17
+ "pattern": "^sha256:[a-f0-9]{64}$"
18
+ },
19
+ "sizeBytes": {
20
+ "type": "integer",
21
+ "minimum": 0
22
+ }
23
+ },
24
+ "required": [
25
+ "resourceId",
26
+ "sha256",
27
+ "sizeBytes"
28
+ ],
29
+ "additionalProperties": false,
30
+ "description": "Digest-bound model-purpose resource; never an Agent attachment."
31
+ }
32
+ },
33
+ "required": [
34
+ "request"
35
+ ],
36
+ "additionalProperties": false
37
+ }
38
+ },
39
+ "$schema": "http://json-schema.org/draft-07/schema#"
40
+ }
@@ -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
+ }
@@ -271,7 +271,7 @@
271
271
  "poll_paced",
272
272
  "credential_profile_ambiguous"
273
273
  ],
274
- "description": "Why a registered subject has no quota snapshot, in the source's own vocabulary."
274
+ "description": "Why a registered subject has no fresh quota snapshot, in the source's own vocabulary."
275
275
  },
276
276
  "detail": {
277
277
  "type": [
@@ -295,10 +295,10 @@
295
295
  "observed_at"
296
296
  ],
297
297
  "additionalProperties": false,
298
- "description": "A registered subject's typed missing-snapshot — absence is stated, never inferred."
298
+ "description": "A registered subject's typed quota observation gap; may accompany stale last-known data."
299
299
  },
300
300
  "default": [],
301
- "description": "Every registered subject reports either a snapshot or a typed absence — absence is never silent emptiness (zen: absence ≠ empty)."
301
+ "description": "Every registered subject reports a snapshot or a typed absence; a refresh gap may coexist with a stale last-known snapshot."
302
302
  },
303
303
  "refreshed_at": {
304
304
  "anyOf": [
@@ -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": [