@claudexor/schema 4.8.1 → 5.0.1

package/generated/McpRunHandleResult.schema.json

@@ -488,6 +488,7 @@
                             "owner_task_gone",
                             "crash_interrupted",
                             "workspace_unavailable",
+                            "capture_refused",
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",
@@ -1172,6 +1173,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": {
@@ -1181,6 +1244,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"
                       ]
                     },
@@ -1205,6 +1273,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": {
@@ -1223,6 +1307,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": [
@@ -1269,6 +1419,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",
@@ -1352,6 +1505,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": [
                     {
@@ -2182,6 +2384,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": [
@@ -2382,13 +2592,80 @@
                 "exactPatchRecorded"
               ],
               "additionalProperties": false,
-              "description": "What a run's saved copies hide: secret-like strings kept in the work, hidden on disk."
+              "description": "What a historical (INV-062) run's saved copies hide: secret-like strings kept in the work, hidden on disk."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Historical disclosure of a run written under the retired INV-062 that hid secret-like strings in its saved copies (paths and counts only); null for current runs, which save exact bytes.",
+          "default": null
+        },
+        "objectResult": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "digest": {
+                  "type": "string",
+                  "pattern": "^sha256:[0-9a-f]{64}$",
+                  "description": "Result digest v1 (sha256 of the canonical object descriptor)."
+                },
+                "patchView": {
+                  "type": "string",
+                  "enum": [
+                    "rendered",
+                    "unavailable"
+                  ],
+                  "description": "Whether final/patch.diff holds a rendered view of the result."
+                },
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Why no view was rendered (for example exceeds_view_limit); null when rendered."
+                },
+                "estimatedBytes": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Estimate of the view size from blob sizes, not an upper bound; just above the view limit when the render itself overflowed; null when rendered or unknown."
+                },
+                "changedFiles": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Changed paths of an unrendered result (from its inventory); null otherwise."
+                }
+              },
+              "required": [
+                "digest",
+                "patchView",
+                "reason",
+                "estimatedBytes",
+                "changedFiles"
+              ],
+              "additionalProperties": false,
+              "description": "The exact object result of a run and whether its patch view exists."
             },
             {
               "type": "null"
             }
           ],
-          "description": "INV-062 disclosure: secret-like strings kept in the work but hidden in saved copies (paths and counts only); null when nothing was hidden.",
+          "description": "#535: the exact Git-object result and whether its patch view exists; null for a run without an object result.",
           "default": null
         }
       },

package/generated/McpRunToolResult.schema.json

@@ -503,6 +503,7 @@
                             "owner_task_gone",
                             "crash_interrupted",
                             "workspace_unavailable",
+                            "capture_refused",
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",
@@ -1166,6 +1167,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": {
@@ -1175,6 +1238,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"
                       ]
                     },
@@ -1199,6 +1267,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": {
@@ -1217,6 +1301,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": [
@@ -1263,6 +1413,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",
@@ -1346,6 +1499,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": [
                     {
@@ -1772,6 +1974,73 @@
           ],
           "description": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output.",
           "default": null
+        },
+        "objectResult": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "digest": {
+                  "type": "string",
+                  "pattern": "^sha256:[0-9a-f]{64}$",
+                  "description": "Result digest v1 (sha256 of the canonical object descriptor)."
+                },
+                "patchView": {
+                  "type": "string",
+                  "enum": [
+                    "rendered",
+                    "unavailable"
+                  ],
+                  "description": "Whether final/patch.diff holds a rendered view of the result."
+                },
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Why no view was rendered (for example exceeds_view_limit); null when rendered."
+                },
+                "estimatedBytes": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Estimate of the view size from blob sizes, not an upper bound; just above the view limit when the render itself overflowed; null when rendered or unknown."
+                },
+                "changedFiles": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Changed paths of an unrendered result (from its inventory); null otherwise."
+                }
+              },
+              "required": [
+                "digest",
+                "patchView",
+                "reason",
+                "estimatedBytes",
+                "changedFiles"
+              ],
+              "additionalProperties": false,
+              "description": "The exact object result of a run and whether its patch view exists."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "#535: the exact Git-object result and whether its patch view exists; null for a run without an object result.",
+          "default": null
         }
       },
       "required": [

package/generated/McpRunWaitResult.schema.json

@@ -344,7 +344,8 @@
                       "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."
                   },