@claudexor/schema 4.8.2 → 5.0.1

package/generated/ControlAccountResourcesFreshnessResponse.schema.json

@@ -391,8 +391,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": [
@@ -401,6 +409,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": {
@@ -632,6 +645,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/ControlAccountResourcesResponse.schema.json

@@ -381,8 +381,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": [
@@ -391,6 +399,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": {
@@ -622,6 +635,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/ControlApplyCheckResponse.schema.json

@@ -24,6 +24,53 @@
           "type": "boolean",
           "default": false,
           "description": "True when the clean check is an already-applied idempotent no-op."
+        },
+        "refusal": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string",
+              "enum": [
+                "result_objects_missing",
+                "delivery_conflict",
+                "delivery_pairing_mismatch",
+                "delivery_target_changed",
+                "delivery_path_occupied",
+                "delivery_outside_sparse_checkout",
+                "delivery_content_mismatch",
+                "revert_conflict",
+                "revert_target_changed",
+                "pr_unrendered_result",
+                "result_path_encoding",
+                "space_insufficient",
+                "git_stalled",
+                "git_signal",
+                "git_failed"
+              ]
+            },
+            "message": {
+              "type": "string"
+            },
+            "paths": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "maxItems": 200,
+              "default": []
+            },
+            "pathCount": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "additionalProperties": false,
+          "description": "Typed reason an object result's dry run refused (code, message, bounded paths); absent otherwise."
         }
       },
       "required": [

package/generated/ControlCredentialProfilesQueryResponse.schema.json

@@ -1023,6 +1023,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": {
@@ -1124,7 +1181,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",
@@ -1132,7 +1189,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",
@@ -1872,8 +1929,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": [
@@ -1882,6 +1947,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": {
@@ -2113,6 +2183,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/ControlCredentialProfilesResourcesResponse.schema.json

@@ -1002,6 +1002,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": {
@@ -1103,7 +1160,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",
@@ -1111,7 +1168,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",
@@ -1793,8 +1850,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": [
@@ -1803,6 +1868,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": {
@@ -2034,6 +2104,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/ControlCredentialProfilesSnapshotResponse.schema.json

@@ -1002,6 +1002,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": {
@@ -1103,7 +1160,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",
@@ -1111,7 +1168,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",