@claudexor/schema 3.12.10 → 3.14.0

package/generated/ControlModelCatalogQueryResponse.schema.json

@@ -31,16 +31,44 @@
               "pattern": "\\S",
               "description": "provider_http means the catalog body was read and validated from a successful upstream HTTP response at observedAt. Other values do not certify provider contact."
             },
+            "clientVersion": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "pattern": "\\S",
+                  "description": "User-supplied string that must contain visible content, not just whitespace."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "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.",
+              "default": null
+            },
+            "clientVersionSource": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "verified_transport",
+                    "installed_cli"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "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."
+            },
             "models": {
               "type": "array",
               "items": {
                 "type": "object",
                 "properties": {
                   "id": {
-                    "type": "string",
-                    "minLength": 1,
-                    "pattern": "\\S",
-                    "description": "User-supplied string that must contain visible content, not just whitespace."
+                    "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/clientVersion/anyOf/0"
                   },
                   "label": {
                     "type": [
@@ -139,7 +167,7 @@
                               "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/models/items/properties/processing/properties/modes/anyOf/0/items"
                             },
                             "id": {
-                              "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/models/items/properties/id"
+                              "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/clientVersion/anyOf/0"
                             }
                           },
                           "required": [
@@ -152,7 +180,7 @@
                       "defaultNativeMode": {
                         "anyOf": [
                           {
-                            "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/models/items/properties/id"
+                            "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/clientVersion/anyOf/0"
                           },
                           {
                             "type": "null"
@@ -167,7 +195,7 @@
                         ]
                       },
                       "source": {
-                        "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/models/items/properties/id"
+                        "$ref": "#/definitions/ControlModelCatalogQueryResponse/anyOf/0/properties/clientVersion/anyOf/0"
                       },
                       "observedAt": {
                         "anyOf": [

package/generated/ControlModelCatalogResponse.schema.json

@@ -29,16 +29,44 @@
           "pattern": "\\S",
           "description": "provider_http means the catalog body was read and validated from a successful upstream HTTP response at observedAt. Other values do not certify provider contact."
         },
+        "clientVersion": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "\\S",
+              "description": "User-supplied string that must contain visible content, not just whitespace."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "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.",
+          "default": null
+        },
+        "clientVersionSource": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "verified_transport",
+                "installed_cli"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "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."
+        },
         "models": {
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
               "id": {
-                "type": "string",
-                "minLength": 1,
-                "pattern": "\\S",
-                "description": "User-supplied string that must contain visible content, not just whitespace."
+                "$ref": "#/definitions/ControlModelCatalogResponse/properties/clientVersion/anyOf/0"
               },
               "label": {
                 "type": [
@@ -137,7 +165,7 @@
                           "$ref": "#/definitions/ControlModelCatalogResponse/properties/models/items/properties/processing/properties/modes/anyOf/0/items"
                         },
                         "id": {
-                          "$ref": "#/definitions/ControlModelCatalogResponse/properties/models/items/properties/id"
+                          "$ref": "#/definitions/ControlModelCatalogResponse/properties/clientVersion/anyOf/0"
                         }
                       },
                       "required": [
@@ -150,7 +178,7 @@
                   "defaultNativeMode": {
                     "anyOf": [
                       {
-                        "$ref": "#/definitions/ControlModelCatalogResponse/properties/models/items/properties/id"
+                        "$ref": "#/definitions/ControlModelCatalogResponse/properties/clientVersion/anyOf/0"
                       },
                       {
                         "type": "null"
@@ -165,7 +193,7 @@
                     ]
                   },
                   "source": {
-                    "$ref": "#/definitions/ControlModelCatalogResponse/properties/models/items/properties/id"
+                    "$ref": "#/definitions/ControlModelCatalogResponse/properties/clientVersion/anyOf/0"
                   },
                   "observedAt": {
                     "anyOf": [

package/generated/ControlRunAgainDraft.schema.json

@@ -257,6 +257,8 @@
             },
             "n": {
               "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991,
               "exclusiveMinimum": 0,
               "description": "Race width: number of best-of-N candidates."
             },

package/generated/ControlRunDetail.schema.json

@@ -2899,7 +2899,7 @@
                 "requested": {
                   "type": "integer",
                   "exclusiveMinimum": 0,
-                  "description": "Requested member count (n; 2..4)."
+                  "description": "Requested member count (n; at least 2, up to the configured Council cap)."
                 },
                 "drafted": {
                   "type": "integer",

package/generated/ControlRunStartRequest.schema.json

@@ -249,6 +249,8 @@
         },
         "n": {
           "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
           "exclusiveMinimum": 0,
           "description": "Race width: number of best-of-N candidates."
         },

package/generated/ControlSettingsSnapshot.schema.json

@@ -207,6 +207,53 @@
               "default": 3600000,
               "description": "Inactivity watchdog for harness streams, in milliseconds."
             },
+            "concurrency": {
+              "type": "object",
+              "properties": {
+                "configured": {
+                  "type": "object",
+                  "properties": {
+                    "maxConcurrent": {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991,
+                      "exclusiveMinimum": 0
+                    },
+                    "maxParallelCandidates": {
+                      "$ref": "#/definitions/ControlSettingsSnapshot/properties/runtime/properties/concurrency/properties/configured/properties/maxConcurrent"
+                    },
+                    "maxDeepScanWidth": {
+                      "$ref": "#/definitions/ControlSettingsSnapshot/properties/runtime/properties/concurrency/properties/configured/properties/maxConcurrent"
+                    },
+                    "maxCouncilMembers": {
+                      "type": "integer",
+                      "minimum": 2,
+                      "maximum": 9007199254740991,
+                      "exclusiveMinimum": 0
+                    }
+                  },
+                  "required": [
+                    "maxConcurrent",
+                    "maxParallelCandidates",
+                    "maxDeepScanWidth",
+                    "maxCouncilMembers"
+                  ],
+                  "additionalProperties": false
+                },
+                "effective": {
+                  "$ref": "#/definitions/ControlSettingsSnapshot/properties/runtime/properties/concurrency/properties/configured"
+                },
+                "restartRequired": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "configured",
+                "effective",
+                "restartRequired"
+              ],
+              "additionalProperties": false
+            },
             "transientRetry": {
               "type": "object",
               "properties": {
@@ -356,6 +403,14 @@
           },
           "default": {},
           "description": "Per-harness settings keyed by harness id."
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Admission notes of this write (INV-104)."
         }
       },
       "additionalProperties": false,

package/generated/ControlThreadTurnRequest.schema.json

@@ -151,6 +151,8 @@
         },
         "n": {
           "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
           "exclusiveMinimum": 0,
           "description": "Race width: number of best-of-N candidates."
         },

package/generated/GlobalConfig.schema.json

@@ -237,6 +237,32 @@
               "exclusiveMinimum": 0,
               "default": 3600000,
               "description": "Inactivity watchdog for harness streams: no events for this window aborts the stream and fails the attempt with a typed timeout."
+            },
+            "max_concurrent": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991,
+              "exclusiveMinimum": 0,
+              "default": 24,
+              "description": "Regular daemon jobs per data root; applied at daemon startup."
+            },
+            "max_parallel_candidates": {
+              "$ref": "#/definitions/GlobalConfig/properties/runtime/properties/max_concurrent",
+              "default": 4,
+              "description": "Active best-of candidates or deep-scan scouts within one run."
+            },
+            "max_deep_scan_width": {
+              "$ref": "#/definitions/GlobalConfig/properties/runtime/properties/max_concurrent",
+              "default": 8,
+              "description": "Maximum scout count in one deep scan."
+            },
+            "max_council_members": {
+              "type": "integer",
+              "minimum": 2,
+              "maximum": 9007199254740991,
+              "exclusiveMinimum": 0,
+              "default": 4,
+              "description": "Maximum distinct Council members; Council requires at least two."
             }
           },
           "additionalProperties": false,

package/generated/HarnessManifest.schema.json

@@ -537,7 +537,7 @@
                 "authoritative",
                 "advisory"
               ],
-              "description": "Whether this harness's live models() answer proves a model is ABSENT; omitted = authoritative (an unlisted model is refused). advisory = absence is not proof, so an explicit model is forwarded to the vendor and disclosed instead of refused."
+              "description": "Whether an absence from this harness's model lists (the live models() answer and the manifest known_models alike) proves a model is ABSENT; omitted = authoritative (an unlisted model is refused). advisory = absence is not proof, so an explicit model is forwarded to the vendor and disclosed instead of refused."
             },
             "known_models": {
               "type": "array",
@@ -576,7 +576,7 @@
                 ]
               },
               "default": [],
-              "description": "Manifest-declared model ids/aliases this harness accepts (bare string = every credential route; object form scopes a model to specific routes), used as the model truth source when the adapter has no live inventory; explicit models outside the truth source are refused."
+              "description": "Manifest-declared model ids/aliases this harness accepts (bare string = every credential route; object form scopes a model to specific routes), used as the model truth source when the adapter has no live inventory and judged under model_inventory_absence: an authoritative harness refuses an explicit model outside it, an advisory harness forwards it with a note."
             },
             "known_models_verified_against": {
               "type": [

package/generated/HarnessModel.schema.json

@@ -136,6 +136,21 @@
           ],
           "default": null,
           "description": "Credential routes the model is scoped to; null = every route."
+        },
+        "origin": {
+          "type": "string",
+          "enum": [
+            "live",
+            "hint"
+          ],
+          "description": "Where this row came from: live = the vendor's own enumeration reported it; hint = a frozen known-model id the producer appends when its live answer lacks it or could not be read. Absent = live."
+        },
+        "resolved_model": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "For an alias row, the exact model id the vendor reported it resolves to at enumeration time; null or absent when the source reports none. The row id is what is sent; this is never substituted for it."
         }
       },
       "required": [

package/generated/HarnessStatusDto.schema.json

@@ -555,7 +555,7 @@
                         "authoritative",
                         "advisory"
                       ],
-                      "description": "Whether this harness's live models() answer proves a model is ABSENT; omitted = authoritative (an unlisted model is refused). advisory = absence is not proof, so an explicit model is forwarded to the vendor and disclosed instead of refused."
+                      "description": "Whether an absence from this harness's model lists (the live models() answer and the manifest known_models alike) proves a model is ABSENT; omitted = authoritative (an unlisted model is refused). advisory = absence is not proof, so an explicit model is forwarded to the vendor and disclosed instead of refused."
                     },
                     "known_models": {
                       "type": "array",
@@ -594,7 +594,7 @@
                         ]
                       },
                       "default": [],
-                      "description": "Manifest-declared model ids/aliases this harness accepts (bare string = every credential route; object form scopes a model to specific routes), used as the model truth source when the adapter has no live inventory; explicit models outside the truth source are refused."
+                      "description": "Manifest-declared model ids/aliases this harness accepts (bare string = every credential route; object form scopes a model to specific routes), used as the model truth source when the adapter has no live inventory and judged under model_inventory_absence: an authoritative harness refuses an explicit model outside it, an advisory harness forwards it with a note."
                     },
                     "known_models_verified_against": {
                       "type": [
@@ -835,7 +835,7 @@
                     "ok",
                     "rejected"
                   ],
-                  "description": "Whether the configured model passes the strict truth-source check."
+                  "description": "Whether the configured model is admitted (listed, or unlisted on an advisory harness) or refused by an authoritative list."
                 },
                 "message": {
                   "type": [
@@ -856,7 +856,7 @@
             }
           ],
           "default": null,
-          "description": "Strict truth-source check of configuredModel; null when no model is configured."
+          "description": "Truth-source check of configuredModel under the harness's own absence declaration; ok with a message is an advisory admission; null when no model is configured."
         },
         "delegation": {
           "anyOf": [

package/generated/McpRunHandleResult.schema.json

@@ -1087,7 +1087,7 @@
                 "requested": {
                   "type": "integer",
                   "exclusiveMinimum": 0,
-                  "description": "Requested member count (n; 2..4)."
+                  "description": "Requested member count (n; at least 2, up to the configured Council cap)."
                 },
                 "drafted": {
                   "type": "integer",

package/generated/McpRunToolResult.schema.json

@@ -1101,7 +1101,7 @@
                 "requested": {
                   "type": "integer",
                   "exclusiveMinimum": 0,
-                  "description": "Requested member count (n; 2..4)."
+                  "description": "Requested member count (n; at least 2, up to the configured Council cap)."
                 },
                 "drafted": {
                   "type": "integer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "3.12.10",
+  "version": "3.14.0",
   "license": "MIT",
   "description": "Single source of truth for all Claudexor data shapes (Zod + generated JSON Schema).",
   "type": "module",
@@ -20,7 +20,7 @@
   "dependencies": {
     "zod": "^4.4.3",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "3.12.10"
+    "@claudexor/util": "3.14.0"
   },
   "repository": {
     "type": "git",