@claudexor/schema 4.8.1 → 5.0.1

package/generated/ControlHarnessListResponse.schema.json

@@ -630,6 +630,63 @@
                             ],
                             "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."
                           },
+                          "model_routing_variants": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "suffix": {
+                                  "type": "string",
+                                  "pattern": "^:[a-z][a-z0-9_-]*$",
+                                  "description": "The suffix, colon included (e.g. ':nitro')."
+                                },
+                                "billing": {
+                                  "type": "string",
+                                  "enum": [
+                                    "base",
+                                    "service_tier"
+                                  ],
+                                  "description": "base = billed like the listed row; service_tier = the provider may serve it on another service tier billed at that tier's rate."
+                                }
+                              },
+                              "required": [
+                                "suffix",
+                                "billing"
+                              ],
+                              "additionalProperties": false,
+                              "description": "One declared request-time routing suffix and its billing effect."
+                            },
+                            "minItems": 1,
+                            "description": "Request-time routing suffixes this harness's provider accepts on a listed model id; an id ending in declared suffixes is admitted when the id without them is an exact catalog row. Omitted = exact catalog membership only."
+                          },
+                          "model_refused_variants": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "suffix": {
+                                  "type": "string",
+                                  "pattern": "^:[a-z][a-z0-9_-]*$",
+                                  "description": "The suffix, colon included (e.g. ':online')."
+                                },
+                                "reason": {
+                                  "type": "string",
+                                  "enum": [
+                                    "provider_web_search"
+                                  ],
+                                  "description": "provider_web_search = the provider would search the web for the request, outside this route's web policy."
+                                }
+                              },
+                              "required": [
+                                "suffix",
+                                "reason"
+                              ],
+                              "additionalProperties": false,
+                              "description": "One declared request-time suffix this harness refuses, and why."
+                            },
+                            "minItems": 1,
+                            "description": "Request-time suffixes this harness refuses in any position after the base id, whether or not a catalog lists the id or could be read. Omitted = none."
+                          },
                           "known_models": {
                             "type": "array",
                             "items": {
@@ -731,7 +788,7 @@
                   "type": "string"
                 },
                 "default": [],
-                "description": "Intents the gateway will route to this harness."
+                "description": "Intents an explicit selection of this harness may run: capability intents its doctor enables. A degraded harness keeps the intents its doctor still enables, with its reasons; an unavailable harness has none."
               },
               "routableIntents": {
                 "type": "array",
@@ -739,7 +796,7 @@
                   "type": "string"
                 },
                 "default": [],
-                "description": "Intents the harness is actually routable for right now (doctor-gated); the server-side availability truth surfaces must read instead of re-deriving."
+                "description": "Intents the automatic (Auto pool) routing may choose this harness for: enabledIntents while the doctor reports ok, empty for a degraded or unavailable harness. Explicit selection reads enabledIntents instead."
               },
               "disabledIntents": {
                 "type": "array",

package/generated/ControlHarnessModelsQueryResponse.schema.json

@@ -129,6 +129,19 @@
                     "default": null,
                     "description": "Context window in tokens; null when the enumeration source does not report it."
                   },
+                  "input_modalities": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/ControlHarnessModelsQueryResponse/anyOf/0/properties/models/items/properties/processing/properties/nativeModes/items/properties/id"
+                    },
+                    "minItems": 1,
+                    "description": "Input modalities the live catalog declares for this model, verbatim (e.g. text, image, file); absent = unknown, never an empty or 'none' claim. Declared metadata that refuses no request."
+                  },
+                  "max_output_tokens": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "description": "Largest completion the live catalog declares for this model (OpenRouter top_provider.max_completion_tokens); absent = unknown. Input and output share the context window, so the effective maximum can be lower."
+                  },
                   "routes": {
                     "anyOf": [
                       {
@@ -189,6 +202,89 @@
               ],
               "default": null,
               "description": "Vendor CLI version the manifest hints were last verified against; null for api/none sources."
+            },
+            "problem": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "message": {
+                  "type": "string"
+                },
+                "retryable": {
+                  "type": "boolean"
+                },
+                "fieldErrors": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "default": {}
+                },
+                "requiredActions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "default": []
+                },
+                "evidenceRefs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "default": []
+                },
+                "context": {
+                  "type": "object",
+                  "additionalProperties": {},
+                  "default": {},
+                  "description": "Typed route-specific recovery context; never a duplicate error message."
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "additionalProperties": false,
+              "description": "Present only when the live catalog read failed (code model_catalog_unavailable; context.cause names no_credential, auth_rejected, http_status, network, timeout, malformed or incomplete): models is then empty and is NOT an empty catalog."
+            },
+            "routingVariants": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "suffix": {
+                    "type": "string",
+                    "pattern": "^:[a-z][a-z0-9_-]*$",
+                    "description": "The suffix, colon included (e.g. ':nitro')."
+                  },
+                  "billing": {
+                    "type": "string",
+                    "enum": [
+                      "base",
+                      "service_tier"
+                    ],
+                    "description": "base = billed like the listed row; service_tier = the provider may serve it on another service tier billed at that tier's rate."
+                  }
+                },
+                "required": [
+                  "suffix",
+                  "billing"
+                ],
+                "additionalProperties": false,
+                "description": "One declared request-time routing suffix and its billing effect."
+              },
+              "minItems": 1,
+              "description": "The harness's declared request-time routing suffixes, so a surface finds the listed row of a variant id (#146); omitted when none are declared."
             }
           },
           "required": [
@@ -225,57 +321,7 @@
                   "problem": {
                     "anyOf": [
                       {
-                        "type": "object",
-                        "properties": {
-                          "code": {
-                            "type": "string",
-                            "minLength": 1
-                          },
-                          "message": {
-                            "type": "string"
-                          },
-                          "retryable": {
-                            "type": "boolean"
-                          },
-                          "fieldErrors": {
-                            "type": "object",
-                            "additionalProperties": {
-                              "type": "array",
-                              "items": {
-                                "type": "string"
-                              }
-                            },
-                            "default": {}
-                          },
-                          "requiredActions": {
-                            "type": "array",
-                            "items": {
-                              "type": "string",
-                              "minLength": 1
-                            },
-                            "default": []
-                          },
-                          "evidenceRefs": {
-                            "type": "array",
-                            "items": {
-                              "type": "string",
-                              "minLength": 1
-                            },
-                            "default": []
-                          },
-                          "context": {
-                            "type": "object",
-                            "additionalProperties": {},
-                            "default": {},
-                            "description": "Typed route-specific recovery context; never a duplicate error message."
-                          }
-                        },
-                        "required": [
-                          "code",
-                          "message",
-                          "retryable"
-                        ],
-                        "additionalProperties": false
+                        "$ref": "#/definitions/ControlHarnessModelsQueryResponse/anyOf/0/properties/problem"
                       },
                       {
                         "type": "null"

package/generated/ControlHarnessModelsResponse.schema.json

@@ -127,6 +127,19 @@
                 "default": null,
                 "description": "Context window in tokens; null when the enumeration source does not report it."
               },
+              "input_modalities": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/ControlHarnessModelsResponse/properties/models/items/properties/processing/properties/nativeModes/items/properties/id"
+                },
+                "minItems": 1,
+                "description": "Input modalities the live catalog declares for this model, verbatim (e.g. text, image, file); absent = unknown, never an empty or 'none' claim. Declared metadata that refuses no request."
+              },
+              "max_output_tokens": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "description": "Largest completion the live catalog declares for this model (OpenRouter top_provider.max_completion_tokens); absent = unknown. Input and output share the context window, so the effective maximum can be lower."
+              },
               "routes": {
                 "anyOf": [
                   {
@@ -187,6 +200,89 @@
           ],
           "default": null,
           "description": "Vendor CLI version the manifest hints were last verified against; null for api/none sources."
+        },
+        "problem": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string",
+              "minLength": 1
+            },
+            "message": {
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "fieldErrors": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "default": {}
+            },
+            "requiredActions": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "default": []
+            },
+            "evidenceRefs": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "default": []
+            },
+            "context": {
+              "type": "object",
+              "additionalProperties": {},
+              "default": {},
+              "description": "Typed route-specific recovery context; never a duplicate error message."
+            }
+          },
+          "required": [
+            "code",
+            "message",
+            "retryable"
+          ],
+          "additionalProperties": false,
+          "description": "Present only when the live catalog read failed (code model_catalog_unavailable; context.cause names no_credential, auth_rejected, http_status, network, timeout, malformed or incomplete): models is then empty and is NOT an empty catalog."
+        },
+        "routingVariants": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "suffix": {
+                "type": "string",
+                "pattern": "^:[a-z][a-z0-9_-]*$",
+                "description": "The suffix, colon included (e.g. ':nitro')."
+              },
+              "billing": {
+                "type": "string",
+                "enum": [
+                  "base",
+                  "service_tier"
+                ],
+                "description": "base = billed like the listed row; service_tier = the provider may serve it on another service tier billed at that tier's rate."
+              }
+            },
+            "required": [
+              "suffix",
+              "billing"
+            ],
+            "additionalProperties": false,
+            "description": "One declared request-time routing suffix and its billing effect."
+          },
+          "minItems": 1,
+          "description": "The harness's declared request-time routing suffixes, so a surface finds the listed row of a variant id (#146); omitted when none are declared."
         }
       },
       "required": [

package/generated/ControlProjectRemoveReceipt.schema.json

@@ -39,6 +39,42 @@
           "type": "string",
           "const": "snapshot",
           "description": "How the live/queued-run fence was evaluated. Always 'snapshot': the daemon reads its in-process activity projection and removes the project in the same synchronous turn, with no await between the snapshot and registry/partition mutation."
+        },
+        "purgedThreads": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "threadId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The thread that was in the project's trash and is now purged."
+              },
+              "cleanup": {
+                "type": "string",
+                "enum": [
+                  "completed",
+                  "pending"
+                ],
+                "description": "completed: every directory the thread purge owns is deleted. pending: the purge is committed but that deletion did not finish; the engine retries it when the daemon next starts."
+              },
+              "cleanupError": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Why the deletion did not finish; null when cleanup completed."
+              }
+            },
+            "required": [
+              "threadId",
+              "cleanup",
+              "cleanupError"
+            ],
+            "additionalProperties": false,
+            "description": "A trashed thread purged together with its project."
+          },
+          "description": "Present only when the request opted in with trashedThreads=purge: every thread that was in the project's trash, purged in the same store transaction that retired the project. Absent on a default removal."
         }
       },
       "required": [

package/generated/ControlQuotaQueryResponse.schema.json

@@ -406,8 +406,16 @@
                         "minLength": 1
                       },
                       "profile_id": {
-                        "type": "string",
-                        "minLength": 1
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Registered account id; null names the harness's default API-key route, which is not an account."
                       }
                     },
                     "required": [
@@ -416,6 +424,11 @@
                     ],
                     "additionalProperties": false
                   },
+                  "credential_fingerprint": {
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{16}$",
+                    "description": "Non-secret identity of the API key this row was read with. Present only on API-key rows; a row is published only while it matches the key requests would send now."
+                  },
                   "balances": {
                     "type": "object",
                     "properties": {
@@ -647,6 +660,37 @@
                                     "string",
                                     "null"
                                   ]
+                                },
+                                "capped": {
+                                  "type": [
+                                    "boolean",
+                                    "null"
+                                  ],
+                                  "description": "true: the provider reports a cap in limit; false: it reports no cap, so a null limit is not unknown and not unlimited money; null or absent: not established."
+                                },
+                                "remaining": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ],
+                                  "description": "Provider-reported amount left under limit in the current window, with its sign; null when not reported."
+                                },
+                                "window": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string",
+                                      "enum": [
+                                        "day",
+                                        "week",
+                                        "month",
+                                        "lifetime"
+                                      ]
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "description": "Provider calendar window that used counts (UTC); when capped, limit resets at its end and lifetime never resets. resets_at is set only from a provider-reported instant."
                                 }
                               },
                               "required": [

package/generated/ControlQuotaReadRequest.schema.json

@@ -24,6 +24,10 @@
             "constraint_freshness",
             "resources_freshness"
           ]
+        },
+        "includeApiKeys": {
+          "type": "boolean",
+          "description": "With a resources view, add API-key rows: registered API-key accounts and each harness's default API-key route (target.profile_id null)."
         }
       },
       "additionalProperties": false,

package/generated/ControlQuotaRefreshRequest.schema.json

@@ -12,15 +12,24 @@
               "minLength": 1
             },
             "profile_id": {
-              "type": "string",
-              "minLength": 1
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Registered account id; null names the harness's default API-key route, which is not an account."
             }
           },
           "required": [
             "harness",
             "profile_id"
           ],
-          "additionalProperties": false
+          "additionalProperties": false,
+          "description": "Exact refresh subject. A null profile_id (the default API-key route) and registered API-key accounts require includeApiKeys=true."
         },
         "requestKind": {
           "type": "string",