@claudexor/schema 4.8.2 → 5.0.2

package/generated/McpRunWaitResult.schema.json

@@ -344,7 +344,9 @@
                       "run.continuation",
                       "run.continuation.denied",
                       "run.continuity",
-                      "workspace.retained"
+                      "workspace.retained",
+                      "workspace.prepared",
+                      "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."
                   },

package/generated/RawContextPacket.schema.json

@@ -13,6 +13,104 @@
           "minLength": 1,
           "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
         },
+        "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."
+        },
         "base_commit_sha": {
           "type": "string",
           "minLength": 1

package/generated/RunContinuityReceipt.schema.json

@@ -157,6 +157,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": [

package/generated/RunEvent.schema.json

@@ -104,7 +104,9 @@
             "run.continuation",
             "run.continuation.denied",
             "run.continuity",
-            "workspace.retained"
+            "workspace.retained",
+            "workspace.prepared",
+            "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."
         },

package/generated/RunFacts.schema.json

@@ -91,6 +91,7 @@
                     "owner_task_gone",
                     "crash_interrupted",
                     "workspace_unavailable",
+                    "capture_refused",
                     "input_required",
                     "work_incomplete",
                     "context_capacity_exhausted",

package/generated/RunFailure.schema.json

@@ -146,6 +146,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": {
@@ -155,6 +217,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"
               ]
             },
@@ -179,6 +246,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": {
@@ -197,6 +280,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": [
@@ -243,6 +392,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",
@@ -326,6 +478,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": [
             {

package/generated/RunTelemetry.schema.json

@@ -159,7 +159,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."
             },
             "error_summary": {
               "type": [
@@ -668,6 +668,126 @@
                 "additionalProperties": false,
                 "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash unless its route reports no actual debit."
               },
+              "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": "Size of the raw-api request this attempt last prepared, from the status event that try emitted just before its POST (#147); not proof the provider received it. Absent for other transports."
+              },
               "attempt_id": {
                 "type": "string",
                 "minLength": 1,
@@ -919,7 +1039,7 @@
                         "null"
                       ],
                       "default": null,
-                      "description": "Redacted target of the tool use, when known."
+                      "description": "Target of the tool use as issued, when known."
                     },
                     "summary": {
                       "type": "string",
@@ -1802,6 +1922,7 @@
                             "owner_task_gone",
                             "crash_interrupted",
                             "workspace_unavailable",
+                            "capture_refused",
                             "input_required",
                             "work_incomplete",
                             "context_capacity_exhausted",