@claudexor/schema 3.23.2 → 3.24.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,298 @@
1
+ {
2
+ "$ref": "#/definitions/ControlHarnessMaintenanceOperation",
3
+ "definitions": {
4
+ "ControlHarnessMaintenanceOperation": {
5
+ "type": "object",
6
+ "properties": {
7
+ "phase": {
8
+ "type": "string",
9
+ "enum": [
10
+ "accepted",
11
+ "preparing",
12
+ "installing",
13
+ "settled"
14
+ ]
15
+ },
16
+ "mechanism": {
17
+ "anyOf": [
18
+ {
19
+ "type": "string",
20
+ "enum": [
21
+ "managed_npm",
22
+ "vendor_updater",
23
+ "vendor_script"
24
+ ],
25
+ "description": "managed_npm installs one exact registry version in place; vendor_updater runs the vendor's own `update` on its canonical launcher (latest only); vendor_script has no engine-run update."
26
+ },
27
+ {
28
+ "type": "null"
29
+ }
30
+ ],
31
+ "description": "managed_npm installs one exact registry version in place; vendor_updater runs the vendor's own `update` on its canonical launcher (latest only); vendor_script has no engine-run update."
32
+ },
33
+ "target": {
34
+ "type": "object",
35
+ "properties": {
36
+ "kind": {
37
+ "type": "string",
38
+ "enum": [
39
+ "latest",
40
+ "version",
41
+ "previous",
42
+ "baseline"
43
+ ]
44
+ },
45
+ "version": {
46
+ "type": [
47
+ "string",
48
+ "null"
49
+ ]
50
+ }
51
+ },
52
+ "required": [
53
+ "kind",
54
+ "version"
55
+ ],
56
+ "additionalProperties": false
57
+ },
58
+ "before": {
59
+ "anyOf": [
60
+ {
61
+ "type": "object",
62
+ "properties": {
63
+ "version": {
64
+ "type": [
65
+ "string",
66
+ "null"
67
+ ]
68
+ },
69
+ "binary": {
70
+ "type": [
71
+ "string",
72
+ "null"
73
+ ]
74
+ },
75
+ "selection": {
76
+ "type": "string",
77
+ "enum": [
78
+ "managed",
79
+ "override",
80
+ "path",
81
+ "missing"
82
+ ],
83
+ "description": "managed = Claudexor's managed npm copy; override = the explicit CLAUDEXOR_<HARNESS>_BIN program; path = another copy found on the harness PATH; missing = nothing launchable."
84
+ },
85
+ "proved": {
86
+ "type": "boolean"
87
+ }
88
+ },
89
+ "required": [
90
+ "version",
91
+ "binary",
92
+ "selection",
93
+ "proved"
94
+ ],
95
+ "additionalProperties": false
96
+ },
97
+ {
98
+ "type": "null"
99
+ }
100
+ ]
101
+ },
102
+ "after": {
103
+ "anyOf": [
104
+ {
105
+ "type": "object",
106
+ "properties": {
107
+ "version": {
108
+ "type": [
109
+ "string",
110
+ "null"
111
+ ]
112
+ },
113
+ "binary": {
114
+ "type": [
115
+ "string",
116
+ "null"
117
+ ]
118
+ },
119
+ "selected": {
120
+ "type": "boolean",
121
+ "description": "The harness now resolves this program."
122
+ },
123
+ "proved": {
124
+ "type": "boolean"
125
+ }
126
+ },
127
+ "required": [
128
+ "version",
129
+ "binary",
130
+ "selected",
131
+ "proved"
132
+ ],
133
+ "additionalProperties": false
134
+ },
135
+ {
136
+ "type": "null"
137
+ }
138
+ ]
139
+ },
140
+ "mutation": {
141
+ "type": "string",
142
+ "enum": [
143
+ "none",
144
+ "applied",
145
+ "unknown"
146
+ ],
147
+ "description": "Whether installed bytes could have changed."
148
+ },
149
+ "termination": {
150
+ "type": "string",
151
+ "enum": [
152
+ "not_applicable",
153
+ "confirmed",
154
+ "unconfirmed"
155
+ ]
156
+ },
157
+ "limitations": {
158
+ "type": "array",
159
+ "items": {
160
+ "type": "string"
161
+ }
162
+ },
163
+ "progress": {
164
+ "type": "array",
165
+ "items": {
166
+ "type": "string"
167
+ },
168
+ "maxItems": 40
169
+ },
170
+ "problem": {
171
+ "anyOf": [
172
+ {
173
+ "type": "object",
174
+ "properties": {
175
+ "code": {
176
+ "type": "string",
177
+ "minLength": 1
178
+ },
179
+ "message": {
180
+ "type": "string"
181
+ },
182
+ "retryable": {
183
+ "type": "boolean"
184
+ },
185
+ "fieldErrors": {
186
+ "type": "object",
187
+ "additionalProperties": {
188
+ "type": "array",
189
+ "items": {
190
+ "type": "string"
191
+ }
192
+ },
193
+ "default": {}
194
+ },
195
+ "requiredActions": {
196
+ "type": "array",
197
+ "items": {
198
+ "type": "string",
199
+ "minLength": 1
200
+ },
201
+ "default": []
202
+ },
203
+ "evidenceRefs": {
204
+ "type": "array",
205
+ "items": {
206
+ "type": "string",
207
+ "minLength": 1
208
+ },
209
+ "default": []
210
+ },
211
+ "context": {
212
+ "type": "object",
213
+ "additionalProperties": {},
214
+ "default": {},
215
+ "description": "Typed route-specific recovery context; never a duplicate error message."
216
+ }
217
+ },
218
+ "required": [
219
+ "code",
220
+ "message",
221
+ "retryable"
222
+ ],
223
+ "additionalProperties": false
224
+ },
225
+ {
226
+ "type": "null"
227
+ }
228
+ ]
229
+ },
230
+ "id": {
231
+ "type": "string"
232
+ },
233
+ "harness": {
234
+ "type": "string"
235
+ },
236
+ "state": {
237
+ "type": "string",
238
+ "enum": [
239
+ "queued",
240
+ "running",
241
+ "succeeded",
242
+ "failed",
243
+ "cancelled",
244
+ "interrupted"
245
+ ]
246
+ },
247
+ "createdAt": {
248
+ "type": "string",
249
+ "minLength": 1,
250
+ "description": "ISO-8601 timestamp string."
251
+ },
252
+ "startedAt": {
253
+ "anyOf": [
254
+ {
255
+ "$ref": "#/definitions/ControlHarnessMaintenanceOperation/properties/createdAt"
256
+ },
257
+ {
258
+ "type": "null"
259
+ }
260
+ ],
261
+ "description": "ISO-8601 timestamp string."
262
+ },
263
+ "finishedAt": {
264
+ "anyOf": [
265
+ {
266
+ "$ref": "#/definitions/ControlHarnessMaintenanceOperation/properties/createdAt"
267
+ },
268
+ {
269
+ "type": "null"
270
+ }
271
+ ],
272
+ "description": "ISO-8601 timestamp string."
273
+ }
274
+ },
275
+ "required": [
276
+ "phase",
277
+ "mechanism",
278
+ "target",
279
+ "before",
280
+ "after",
281
+ "mutation",
282
+ "termination",
283
+ "limitations",
284
+ "progress",
285
+ "problem",
286
+ "id",
287
+ "harness",
288
+ "state",
289
+ "createdAt",
290
+ "startedAt",
291
+ "finishedAt"
292
+ ],
293
+ "additionalProperties": false,
294
+ "description": "A durable harness maintenance operation; 202 on create is a handle, not success."
295
+ }
296
+ },
297
+ "$schema": "http://json-schema.org/draft-07/schema#"
298
+ }
@@ -125,7 +125,7 @@
125
125
  "type": "null"
126
126
  }
127
127
  ],
128
- "description": "Client version the transport declared when it read this catalog; the backend lists only models whose minimum client version is at or below it. Null for catalogs from an older engine.",
128
+ "description": "Client version the transport declared when it read this catalog; server discovery may vary with it. Null for catalogs from an older engine.",
129
129
  "default": null
130
130
  },
131
131
  "clientVersionSource": {
@@ -144,6 +144,27 @@
144
144
  "default": null,
145
145
  "description": "Where the declared client version came from: verified_transport (the version this Claudexor release verified its HTTP transport against) or installed_cli (a newer installed Codex CLI raised it). Null for catalogs from an older engine."
146
146
  },
147
+ "admission": {
148
+ "type": "object",
149
+ "properties": {
150
+ "requestedModel": {
151
+ "$ref": "#/definitions/ControlModelAccountCatalogResponse/properties/accounts/items/properties/catalog/anyOf/0/properties/clientVersion/anyOf/0"
152
+ },
153
+ "inventoryAbsence": {
154
+ "type": "string",
155
+ "enum": [
156
+ "authoritative",
157
+ "advisory"
158
+ ]
159
+ }
160
+ },
161
+ "required": [
162
+ "requestedModel",
163
+ "inventoryAbsence"
164
+ ],
165
+ "additionalProperties": false,
166
+ "description": "Negotiated selected-account admission for this exact model, after auth and model-scoped quota checks. A valid catalog miss may be advisory; no generation or entitlement is proved."
167
+ },
147
168
  "models": {
148
169
  "type": "array",
149
170
  "items": {
@@ -43,7 +43,7 @@
43
43
  "type": "null"
44
44
  }
45
45
  ],
46
- "description": "Client version the transport declared when it read this catalog; the backend lists only models whose minimum client version is at or below it. Null for catalogs from an older engine.",
46
+ "description": "Client version the transport declared when it read this catalog; server discovery may vary with it. Null for catalogs from an older engine.",
47
47
  "default": null
48
48
  },
49
49
  "clientVersionSource": {
@@ -62,6 +62,27 @@
62
62
  "default": null,
63
63
  "description": "Where the declared client version came from: verified_transport (the version this Claudexor release verified its HTTP transport against) or installed_cli (a newer installed Codex CLI raised it). Null for catalogs from an older engine."
64
64
  },
65
+ "admission": {
66
+ "type": "object",
67
+ "properties": {
68
+ "requestedModel": {
69
+ "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/clientVersion/anyOf/0"
70
+ },
71
+ "inventoryAbsence": {
72
+ "type": "string",
73
+ "enum": [
74
+ "authoritative",
75
+ "advisory"
76
+ ]
77
+ }
78
+ },
79
+ "required": [
80
+ "requestedModel",
81
+ "inventoryAbsence"
82
+ ],
83
+ "additionalProperties": false,
84
+ "description": "Negotiated selected-account admission for this exact model, after auth and model-scoped quota checks. A valid catalog miss may be advisory; no generation or entitlement is proved."
85
+ },
65
86
  "models": {
66
87
  "type": "array",
67
88
  "items": {
@@ -41,7 +41,7 @@
41
41
  "type": "null"
42
42
  }
43
43
  ],
44
- "description": "Client version the transport declared when it read this catalog; the backend lists only models whose minimum client version is at or below it. Null for catalogs from an older engine.",
44
+ "description": "Client version the transport declared when it read this catalog; server discovery may vary with it. Null for catalogs from an older engine.",
45
45
  "default": null
46
46
  },
47
47
  "clientVersionSource": {
@@ -60,6 +60,27 @@
60
60
  "default": null,
61
61
  "description": "Where the declared client version came from: verified_transport (the version this Claudexor release verified its HTTP transport against) or installed_cli (a newer installed Codex CLI raised it). Null for catalogs from an older engine."
62
62
  },
63
+ "admission": {
64
+ "type": "object",
65
+ "properties": {
66
+ "requestedModel": {
67
+ "$ref": "#/definitions/ControlModelCatalogResponse/properties/clientVersion/anyOf/0"
68
+ },
69
+ "inventoryAbsence": {
70
+ "type": "string",
71
+ "enum": [
72
+ "authoritative",
73
+ "advisory"
74
+ ]
75
+ }
76
+ },
77
+ "required": [
78
+ "requestedModel",
79
+ "inventoryAbsence"
80
+ ],
81
+ "additionalProperties": false,
82
+ "description": "Negotiated selected-account admission for this exact model, after auth and model-scoped quota checks. A valid catalog miss may be advisory; no generation or entitlement is proved."
83
+ },
63
84
  "models": {
64
85
  "type": "array",
65
86
  "items": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@claudexor/schema",
3
- "version": "3.23.2",
3
+ "version": "3.24.0",
4
4
  "license": "MIT",
5
5
  "description": "Single source of truth for all Claudexor data shapes (Zod + generated JSON Schema).",
6
6
  "type": "module",
@@ -20,7 +20,7 @@
20
20
  "dependencies": {
21
21
  "zod": "^4.6.5",
22
22
  "zod-to-json-schema": "^3.24.1",
23
- "@claudexor/util": "3.23.2"
23
+ "@claudexor/util": "3.24.0"
24
24
  },
25
25
  "repository": {
26
26
  "type": "git",