@claudexor/schema 4.8.2 → 5.0.1

package/generated/ControlRunDetail.schema.json

@@ -592,6 +592,14 @@
                       "not_applicable"
                     ],
                     "description": "Whether the predecessor's last input (its turn prompt or an admitted steering message) is known to be in the vendor history: confirmed, uncertain (carried in the notice as a reference to reconcile, never replayed blindly), or not applicable."
+                  },
+                  "sourceRetirement": {
+                    "type": "string",
+                    "enum": [
+                      "retired",
+                      "not_confirmed"
+                    ],
+                    "description": "After a native_moved carrier published the new holder: retired (the adapter removed the source copy) or not_confirmed (removal failed, possibly part-way). Absent = no move retired a source for this try."
                   }
                 },
                 "required": [
@@ -839,6 +847,68 @@
                       ],
                       "description": "Vendor-attested request refusal that stops retries and account rotation on its harness; input, executable and credential-source causes carry their own evidence."
                     },
+                    "rawContextShortfall": {
+                      "type": "object",
+                      "properties": {
+                        "model": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Model whose window was checked."
+                        },
+                        "context_window": {
+                          "type": "integer",
+                          "exclusiveMinimum": 0
+                        },
+                        "packet_tokens": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "description": "The packet with every optional file omitted: mandatory files, file manifest and metadata."
+                        },
+                        "framing_tokens": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "description": "The request outside the packet: instructions, user text, patch protocol and attachments."
+                        },
+                        "output_allowance_tokens": {
+                          "type": "integer",
+                          "minimum": 0,
+                          "description": "Tokens kept free for the answer."
+                        },
+                        "mandatory_files": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "path": {
+                                "type": "string",
+                                "minLength": 1
+                              },
+                              "estimated_tokens": {
+                                "type": "integer",
+                                "minimum": 0,
+                                "description": "This file's share of packet_tokens: its packet entry with content and evidence."
+                              }
+                            },
+                            "required": [
+                              "path",
+                              "estimated_tokens"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "description": "Every mandatory file, largest first."
+                        }
+                      },
+                      "required": [
+                        "model",
+                        "context_window",
+                        "packet_tokens",
+                        "framing_tokens",
+                        "output_allowance_tokens",
+                        "mandatory_files"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Typed sizes behind code raw_context_exceeds_window: the window, the request's parts and every mandatory file, so surfaces never read them from safeMessage."
+                    },
                     "captureFailure": {
                       "type": "object",
                       "properties": {
@@ -848,6 +918,11 @@
                             "capture_output_exceeded",
                             "capture_output_incomplete",
                             "capture_preview_truncated",
+                            "capture_space_insufficient",
+                            "capture_git_stalled",
+                            "capture_git_signal",
+                            "capture_read_failed",
+                            "capture_object_missing",
                             "capture_failed"
                           ]
                         },
@@ -872,6 +947,22 @@
                           "type": "string",
                           "const": "truncated"
                         },
+                        "requiredBytes": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "availableBytes": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "signal": {
+                          "type": "string",
+                          "maxLength": 32
+                        },
+                        "stallMs": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
                         "cleanup": {
                           "type": "object",
                           "properties": {
@@ -890,6 +981,72 @@
                             "message"
                           ],
                           "additionalProperties": false
+                        },
+                        "inventory": {
+                          "type": "object",
+                          "properties": {
+                            "exact": {
+                              "type": "boolean",
+                              "const": false,
+                              "description": "Always false: an inventory names files; it is not the exact change."
+                            },
+                            "changedFiles": {
+                              "type": "integer",
+                              "minimum": 0,
+                              "description": "Changed paths the pass counted."
+                            },
+                            "largest": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "path": {
+                                    "type": "string",
+                                    "maxLength": 1024,
+                                    "description": "Top-relative changed path, exact within the length cap."
+                                  },
+                                  "change": {
+                                    "type": "string",
+                                    "enum": [
+                                      "added",
+                                      "modified",
+                                      "deleted",
+                                      "type_changed"
+                                    ],
+                                    "description": "What happened to the path between the turn's base and the uncaptured tree."
+                                  },
+                                  "sizeBytes": {
+                                    "anyOf": [
+                                      {
+                                        "type": "integer",
+                                        "minimum": 0
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ],
+                                    "description": "Size of the new blob (of the old blob for a deletion); null when Git could not size it."
+                                  }
+                                },
+                                "required": [
+                                  "path",
+                                  "change",
+                                  "sizeBytes"
+                                ],
+                                "additionalProperties": false,
+                                "description": "One changed path of a non-exact capture inventory."
+                              },
+                              "maxItems": 20,
+                              "description": "The largest changed files, largest first."
+                            }
+                          },
+                          "required": [
+                            "exact",
+                            "changedFiles",
+                            "largest"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Bounded non-exact inventory of the changed files behind a refused capture."
                         }
                       },
                       "required": [
@@ -936,6 +1093,9 @@
                             "subscription_window_exhausted",
                             "credential_pool_exhausted",
                             "input_too_large",
+                            "raw_context_mandatory_unavailable",
+                            "raw_context_exceeds_window",
+                            "model_catalog_unavailable",
                             "vendor_cli_too_old",
                             "credential_source_unconfirmed",
                             "delegated_home_unavailable",
@@ -1019,6 +1179,55 @@
                       "default": null,
                       "description": "When the refused window reopens (a spent subscription quota window), or null when the failure has no such time. Callers schedule a retry off this field, never off safeMessage."
                     },
+                    "quotaRefusal": {
+                      "type": "object",
+                      "properties": {
+                        "basis": {
+                          "type": "string",
+                          "enum": [
+                            "owner_reserve",
+                            "provider_window",
+                            "provider_cooldown"
+                          ],
+                          "description": "owner_reserve: usage reached the saved headroom_threshold below 100% while the provider reports quota left; provider_window: the provider reports the window spent; provider_cooldown: a provider rate-limit cooldown is in force."
+                        },
+                        "constraintId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "description": "The refusing quota window, when known."
+                        },
+                        "usedRatio": {
+                          "anyOf": [
+                            {
+                              "type": "number",
+                              "minimum": 0,
+                              "maximum": 1
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Its observed usage, when known."
+                        },
+                        "threshold": {
+                          "type": [
+                            "number",
+                            "null"
+                          ],
+                          "description": "The headroom_threshold the decision applied, when it applied one."
+                        }
+                      },
+                      "required": [
+                        "basis",
+                        "constraintId",
+                        "usedRatio",
+                        "threshold"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Present when quota admission refused the account (code subscription_window_exhausted): separates the owner's saved reserve from provider exhaustion. Absent on other failures and on records written before this field existed."
+                    },
                     "vendorFailure": {
                       "anyOf": [
                         {
@@ -1730,7 +1939,7 @@
                     "null"
                   ],
                   "default": null,
-                  "description": "Redacted target (query/url) of the web activity, when any."
+                  "description": "Target (query/url) of the web activity as issued, when any."
                 },
                 "errorSummary": {
                   "type": [
@@ -1746,7 +1955,7 @@
                     "null"
                   ],
                   "default": null,
-                  "description": "Artifact path holding the raw (redacted) evidence detail."
+                  "description": "Artifact path holding the full evidence record."
                 },
                 "available": {
                   "type": "boolean",
@@ -2018,6 +2227,7 @@
                             "owner_task_gone",
                             "crash_interrupted",
                             "workspace_unavailable",
+                            "capture_refused",
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",
@@ -2358,6 +2568,135 @@
               "description": "Typed routing rationale (QA-034) projected from telemetry; null when no ranking was computed or on legacy runs.",
               "default": null
             },
+            "rawContext": {
+              "anyOf": [
+                {
+                  "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": "Estimated size of one raw-api request as prepared just before its POST, and the budget its packet honoured; not proof the provider received it."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Size of the raw-api request the final attempt last prepared, as receipted just before its POST (#147); null otherwise.",
+              "default": null
+            },
             "tests": {
               "type": "array",
               "items": {
@@ -3183,7 +3522,7 @@
                   "null"
                 ],
                 "default": null,
-                "description": "Human-readable event detail. For typed harness text, the complete redacted text with original whitespace; title may be abbreviated."
+                "description": "Human-readable event detail. For typed harness text, the complete text as journaled, with original whitespace; title may be abbreviated."
               },
               "textKind": {
                 "anyOf": [
@@ -3261,7 +3600,7 @@
                   "null"
                 ],
                 "default": null,
-                "description": "Redacted tool target for tool events."
+                "description": "Tool target for tool events, bounded, as the agent issued it."
               },
               "errorSummary": {
                 "type": [
@@ -3269,7 +3608,7 @@
                   "null"
                 ],
                 "default": null,
-                "description": "Redacted error detail for error events."
+                "description": "Error detail: a failed tool's own output, unmasked; for an error event, its masked diagnostic."
               },
               "ignoredSettings": {
                 "type": "array",

package/generated/ControlRunEventPart.schema.json

@@ -91,14 +91,15 @@
             "run.continuation",
             "run.continuation.denied",
             "run.continuity",
-            "workspace.retained"
+            "workspace.retained",
+            "workspace.settlement_failed"
           ],
           "description": "Type of an append-only run event, covering run lifecycle, contract/context creation, budget, routing fallbacks, harness activity, interactions, gates, review, arbitration, work products, and control verbs."
         },
         "totalBytes": {
           "type": "integer",
           "exclusiveMinimum": 0,
-          "description": "UTF-8 byte length of the event's complete stream serialization: the redacted JSON line the run event stream delivers."
+          "description": "UTF-8 byte length of the event's complete stream serialization: the stored JSON line the run event stream delivers."
         },
         "sha256": {
           "type": "string",