@claudexor/schema 4.8.2 → 5.0.2

package/generated/ControlRunSummary.schema.json

@@ -402,6 +402,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": [
@@ -649,6 +657,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": {
@@ -658,6 +728,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"
                       ]
                     },
@@ -682,6 +757,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": {
@@ -700,6 +791,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": [
@@ -746,6 +903,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",
@@ -829,6 +989,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": [
                     {
@@ -1547,7 +1756,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": [
@@ -1563,7 +1772,7 @@
                 "null"
               ],
               "default": null,
-              "description": "Artifact path holding the raw (redacted) evidence detail."
+              "description": "Artifact path holding the full evidence record."
             },
             "available": {
               "type": "boolean",
@@ -1835,6 +2044,7 @@
                         "owner_task_gone",
                         "crash_interrupted",
                         "workspace_unavailable",
+                        "capture_refused",
                         "input_required",
                         "work_incomplete",
                         "context_capacity_exhausted",
@@ -2175,6 +2385,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": {

package/generated/ControlThreadApplyResponse.schema.json

@@ -75,6 +75,72 @@
                 "refused": {
                   "type": "boolean"
                 },
+                "publicationRefusal": {
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "publication_scan_findings",
+                        "publication_scan_unavailable",
+                        "publication_scan_failed"
+                      ],
+                      "description": "findings = the scanner reported secret-like content; unavailable = no pinned scanner; failed = the scan could not prove its result."
+                    },
+                    "detail": {
+                      "type": "string",
+                      "description": "Human-readable refusal, without any matched value."
+                    },
+                    "findings": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "ruleId": {
+                            "type": "string",
+                            "description": "Scanner rule that matched."
+                          },
+                          "location": {
+                            "type": "string",
+                            "description": "Outgoing file path or metadata label."
+                          },
+                          "line": {
+                            "anyOf": [
+                              {
+                                "type": "integer"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "1-based line, when known."
+                          },
+                          "commit": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "description": "Outgoing commit holding the finding."
+                          }
+                        },
+                        "required": [
+                          "ruleId",
+                          "location",
+                          "line",
+                          "commit"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "Present for publication_scan_findings."
+                    }
+                  },
+                  "required": [
+                    "code",
+                    "detail"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Set when the publication scanner refused a `pr` delivery before any branch, commit or push."
+                },
                 "alreadyApplied": {
                   "type": "boolean",
                   "default": false,
@@ -178,6 +244,94 @@
                 "targetPreimageSha": {
                   "type": "string",
                   "description": "Target snapshot verified immediately before delivery."
+                },
+                "refusal": {
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "result_objects_missing",
+                        "delivery_conflict",
+                        "delivery_pairing_mismatch",
+                        "delivery_target_changed",
+                        "delivery_path_occupied",
+                        "delivery_outside_sparse_checkout",
+                        "delivery_content_mismatch",
+                        "revert_conflict",
+                        "revert_target_changed",
+                        "pr_unrendered_result",
+                        "result_path_encoding",
+                        "space_insufficient",
+                        "git_stalled",
+                        "git_signal",
+                        "git_failed"
+                      ]
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "paths": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "maxItems": 200,
+                      "default": []
+                    },
+                    "pathCount": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    }
+                  },
+                  "required": [
+                    "code",
+                    "message"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Typed refusal of an object-result delivery (code, message, bounded paths); absent on success or a legacy patch refusal."
+                },
+                "deliveryPair": {
+                  "type": "object",
+                  "properties": {
+                    "schema": {
+                      "type": "string",
+                      "const": "git_objects/v1"
+                    },
+                    "object_format": {
+                      "type": "string",
+                      "enum": [
+                        "sha1",
+                        "sha256"
+                      ],
+                      "description": "Object format of the repository whose objects the result names."
+                    },
+                    "pre_commit": {
+                      "type": "string",
+                      "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$",
+                      "description": "Target snapshot commit (T) the delivery started from."
+                    },
+                    "pre_tree": {
+                      "type": "string",
+                      "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$",
+                      "description": "Tree of T."
+                    },
+                    "post_tree": {
+                      "type": "string",
+                      "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$",
+                      "description": "Tree the delivery wrote (M)."
+                    }
+                  },
+                  "required": [
+                    "schema",
+                    "object_format",
+                    "pre_commit",
+                    "pre_tree",
+                    "post_tree"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Pre/post trees of an object-result delivery whose write is on the target (revert runs on this pair); absent when nothing of it stayed, and for a legacy patch delivery."
                 }
               },
               "required": [

package/generated/ControlThreadDetail.schema.json

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

package/generated/DecisionRecord.schema.json

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