@claudexor/schema 4.8.1 → 5.0.1

package/generated/HarnessEvent.schema.json

@@ -492,6 +492,31 @@
           "type": "boolean",
           "description": "True on the harness's typed final-answer message (vendor terminal result); mid-run narration never sets it."
         },
+        "speech": {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Opaque adapter-issued key of one observed text block; equality only."
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "fragment",
+                "complete",
+                "abandoned"
+              ],
+              "description": "fragment: a verbatim streamed piece of the keyed text block; complete: the harness's complete text of that block (at most once per key); abandoned: the harness stated the block will never be completed (partial fragments stay as emitted)."
+            }
+          },
+          "required": [
+            "key",
+            "op"
+          ],
+          "additionalProperties": false,
+          "description": "Adapter-issued speech identity of a text event (fragment/complete on messages, abandoned on a status event); absent when no block lifecycle was exactly observed. A typed final never carries it unless the adapter proves the link."
+        },
         "tool": {
           "type": "object",
           "properties": {
@@ -518,7 +543,7 @@
             },
             "target": {
               "type": "string",
-              "description": "Redacted, bounded human-readable target (query/url/path/command)."
+              "description": "Bounded human-readable target (query/url/path/command), as the agent issued it."
             },
             "status": {
               "type": "string",
@@ -530,18 +555,74 @@
               ],
               "description": "Outcome of the tool use; required on tool_result events (a missing status is never treated as ok)."
             },
+            "phase": {
+              "type": "string",
+              "enum": [
+                "started",
+                "completed"
+              ],
+              "description": "Native lifecycle frame of a file_change (started or completed); absent when the adapter does not type it. Completion is not success: the outcome stays in status."
+            },
             "error_summary": {
               "type": "string",
-              "description": "Redacted, bounded error detail for status=error results."
+              "description": "Error detail for status=error results: the tool's own output, unmasked, within the adapter's bound and whitespace normalization."
             },
             "content_summary": {
               "type": "string",
-              "description": "Redacted, bounded content detail for results (success or failure)."
+              "description": "Content detail for results (success or failure), unmasked, within the adapter's bound and whitespace normalization."
             },
             "exit_code": {
               "type": "integer",
               "description": "Process exit code for command tools, when known."
             },
+            "command_outcome": {
+              "type": "object",
+              "properties": {
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "exited",
+                    "timed_out",
+                    "backgrounded",
+                    "unknown"
+                  ],
+                  "description": "exited: the tool observed the command end; timed_out: the tool's timeout elapsed before an observed end (the process may still run or may have been signalled); backgrounded: the command was handed to a background shell and was still running when the result returned; unknown: the native result established none of these."
+                },
+                "signal": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Vendor-reported signal name of an exited command."
+                },
+                "timeout_ms": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The elapsed tool timeout behind timed_out or a timeout-driven background handoff."
+                },
+                "background_reason": {
+                  "type": "string",
+                  "enum": [
+                    "timeout",
+                    "requested"
+                  ],
+                  "description": "Why a backgrounded command left the foreground: its timeout or a request."
+                },
+                "shell_id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Vendor handle of the background shell that kept the command."
+                },
+                "pid": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Vendor-reported process id."
+                }
+              },
+              "required": [
+                "state"
+              ],
+              "additionalProperties": false,
+              "description": "Command process facts (#450), separate from status; absent means not reported."
+            },
             "web_retrieval": {
               "type": "string",
               "enum": [
@@ -723,10 +804,131 @@
             "raw_patch_stale_preimage",
             "raw_patch_binary_unsupported",
             "raw_patch_truncated",
-            "raw_patch_apply_failed"
+            "raw_patch_apply_failed",
+            "raw_context_exceeds_window"
           ],
           "description": "Typed refusal code for a rejected raw patch contract."
         },
+        "raw_context": {
+          "type": "object",
+          "properties": {
+            "model": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Model the request named."
+            },
+            "estimated_request_tokens": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Estimated tokens of the whole rendered request (chars/4, plus a fixed figure per image); never a tokenizer count."
+            },
+            "budget": {
+              "type": "object",
+              "properties": {
+                "estimator": {
+                  "type": "string",
+                  "const": "chars_div_4"
+                },
+                "basis": {
+                  "type": "string",
+                  "enum": [
+                    "model_context_window",
+                    "assumed_ceiling"
+                  ]
+                },
+                "model": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Model whose catalog row was consulted; null when the producer reported none."
+                },
+                "context_window": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "output_allowance_tokens": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "framing_tokens": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Estimated tokens of the request outside this packet; null when unmeasured."
+                },
+                "selection_limit_tokens": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Limit the optional selection honoured: the packet's share of the window, or the assumed ceiling on file contents."
+                },
+                "estimated_packet_tokens": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "omitted_for_budget": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Optional files left out to honour selection_limit_tokens (listed in omissions)."
+                },
+                "mandatory_paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "description": "Project mandatory files, each delivered complete in readable_files."
+                }
+              },
+              "required": [
+                "estimator",
+                "basis",
+                "model",
+                "context_window",
+                "output_allowance_tokens",
+                "framing_tokens",
+                "selection_limit_tokens",
+                "estimated_packet_tokens",
+                "omitted_for_budget",
+                "mandatory_paths"
+              ],
+              "additionalProperties": false,
+              "description": "Sizing evidence for a raw context packet; disclosed, never a tokenizer count."
+            }
+          },
+          "required": [
+            "model",
+            "estimated_request_tokens",
+            "budget"
+          ],
+          "additionalProperties": false,
+          "description": "Set on the status event that discloses, just before the POST, how a raw-api request was sized (#147)."
+        },
         "permission_denial": {
           "type": "object",
           "properties": {
@@ -1153,7 +1355,14 @@
                   "type": "null"
                 }
               ],
-              "description": "Canonical model ids/aliases this rejection applies to; omitted/null means every model."
+              "description": "Canonical model ids/aliases this rejection applies to; omitted/null (with no prefixes) means every model."
+            },
+            "applies_to_model_prefixes": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/HarnessEvent/properties/credential_profile_id"
+              },
+              "description": "Producer-declared model-family prefixes this rejection also applies to, as on QuotaConstraint."
             },
             "resets_at": {
               "type": [

package/generated/HarnessManifest.schema.json

@@ -607,6 +607,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": {

package/generated/HarnessModel.schema.json

@@ -118,6 +118,19 @@
           "default": null,
           "description": "Context window in tokens; null when the enumeration source does not report it."
         },
+        "input_modalities": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/HarnessModel/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": [
             {

package/generated/HarnessStatusDto.schema.json

@@ -625,6 +625,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": {
@@ -726,7 +783,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",
@@ -734,7 +791,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/JournaledRunCreatedPayload.schema.json

@@ -16,12 +16,12 @@
         "prompt_sha256": {
           "type": "string",
           "pattern": "^[0-9a-f]{64}$",
-          "description": "sha256 hex digest of the redacted prompt text."
+          "description": "sha256 hex digest of the prompt text."
         },
         "prompt_bytes": {
           "type": "integer",
           "minimum": 0,
-          "description": "UTF-8 byte length of the redacted prompt text."
+          "description": "UTF-8 byte length of the prompt text."
         }
       },
       "required": [

package/generated/McpAccountsToolResult.schema.json

@@ -1188,6 +1188,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": {
@@ -1289,7 +1346,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",
@@ -1297,7 +1354,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",
@@ -2043,8 +2100,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": [
@@ -2053,6 +2118,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": {
@@ -2284,6 +2354,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": [