@claudexor/schema 3.1.2 → 3.2.0

package/generated/ControlThreadDetail.schema.json

@@ -533,6 +533,7 @@
                                       "wall_clock_exceeded",
                                       "user_cancelled",
                                       "crash_interrupted",
+                                      "workspace_unavailable",
                                       "input_required",
                                       "work_incomplete",
                                       "context_capacity_exhausted",
@@ -567,7 +568,7 @@
                                       "validated",
                                       "absent"
                                     ],
-                                    "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                                    "description": "Provenance of a WorkReport: constrained (native schema transport), validated (instructed terminal metadata), or absent (no transport could carry one — a disclosed absence, not a failure)."
                                   },
                                   "required_inputs": {
                                     "type": "array",
@@ -768,6 +769,23 @@
                         "default": true,
                         "description": "False when no recorded job exists to replay — surfaces offer a new message instead of a doomed retry."
                       },
+                      "requiredActions": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 512
+                        },
+                        "maxItems": 16,
+                        "default": [],
+                        "description": "Bounded user actions that may make an exact retry succeed."
+                      },
+                      "context": {
+                        "type": "object",
+                        "additionalProperties": {},
+                        "default": {},
+                        "description": "Bounded typed recovery context for exact retry."
+                      },
                       "failedAt": {
                         "type": "string",
                         "description": "When the enqueue failed."

package/generated/ControlThreadTurnRequest.schema.json

@@ -312,29 +312,6 @@
           "minLength": 1,
           "description": "Internal daemon handoff only; rejected (400) on POST /runs. When set, the turn implements an approved plan from that run."
         },
-        "planRef": {
-          "type": "object",
-          "properties": {
-            "runId": {
-              "$ref": "#/definitions/ControlThreadTurnRequest/properties/planRunId"
-            },
-            "sha256": {
-              "type": "string",
-              "pattern": "^[0-9a-f]{64}$"
-            },
-            "path": {
-              "type": "string",
-              "minLength": 1
-            }
-          },
-          "required": [
-            "runId",
-            "sha256",
-            "path"
-          ],
-          "additionalProperties": false,
-          "description": "Internal daemon handoff only; rejected (400) on POST /runs. Frozen-plan reference delivered to the executor as a file."
-        },
         "reviewerPanel": {
           "type": "array",
           "items": {
@@ -362,7 +339,7 @@
             "description": "One reviewer of an explicit reviewer panel — a harness plus optional model and effort. The CLI spells one entry `harness=model:effort` (e.g. `claude=claude-opus-4-8:max`)."
           },
           "minItems": 1,
-          "description": "Explicit reviewer panel — who reviews the change, one entry per reviewer as `harness=model:effort` (CLI `--reviewers \"claude=claude-opus-4-8:max,cursor=gemini-3.1-pro\"`). Duplicate harness entries are kept so one provider can review through several models; overrides the legacy reviewerModels/reviewerEfforts maps."
+          "description": "Explicit Agent reviewer panel — who reviews the change, one entry per reviewer as `harness=model:effort` (CLI `--reviewer-panel \"claude=claude-opus-4-8:max,cursor=gemini-3.1-pro\"`). Duplicate harness entries are kept so one provider can review through several models; overrides the legacy reviewerModels/reviewerEfforts maps."
         },
         "authPreference": {
           "type": "string",

package/generated/DecisionRecord.schema.json

@@ -72,6 +72,7 @@
                     "wall_clock_exceeded",
                     "user_cancelled",
                     "crash_interrupted",
+                    "workspace_unavailable",
                     "input_required",
                     "work_incomplete",
                     "context_capacity_exhausted",
@@ -106,7 +107,7 @@
                     "validated",
                     "absent"
                   ],
-                  "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                  "description": "Provenance of a WorkReport: constrained (native schema transport), validated (instructed terminal metadata), or absent (no transport could carry one — a disclosed absence, not a failure)."
                 },
                 "required_inputs": {
                   "type": "array",

package/generated/GitCapability.schema.json

@@ -0,0 +1,46 @@
+{
+  "$ref": "#/definitions/GitCapability",
+  "definitions": {
+    "GitCapability": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "available",
+            "missing",
+            "developer_tools_stub",
+            "failed"
+          ]
+        },
+        "version": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "detail": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "remediation": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "status",
+        "version",
+        "detail",
+        "remediation"
+      ],
+      "additionalProperties": false,
+      "description": "Live Git executable readiness for workspace/envelope operations."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/GlobalConfig.schema.json

@@ -11,10 +11,19 @@
           "description": "Config format version."
         },
         "interaction_timeout_ms": {
-          "type": "integer",
-          "exclusiveMinimum": 0,
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 8000000000000000,
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
           "default": 900000,
-          "description": "How long an interactive run waits for the user's answer to a harness question before delivering a benign decline and letting the model continue."
+          "description": "Automatic-expiry policy for an interactive answer: positive milliseconds deliver a benign decline at the deadline; null disables automatic expiry."
         },
         "routing": {
           "type": "object",
@@ -180,7 +189,7 @@
               "type": "number",
               "minimum": 0,
               "default": 0.05,
-              "description": "Per-candidate USD reservation floor held against the run cap for every race-wave slot after the first, so a parallel wave cannot blow past the cap between settlements."
+              "description": "USD reservation floor for later parallel race candidates, deep-scan scouts, and Council members; the Deep Scan reducer; the one-shot enveloped candidate continuation; and every paid attempt inside a Delegate child. The first ordinary top-level attempt remains unreserved."
             }
           },
           "additionalProperties": false,

package/generated/HarnessEvent.schema.json

@@ -548,9 +548,10 @@
                 "model_not_found",
                 "server_error",
                 "max_output_tokens",
+                "timeout",
                 "unknown"
               ],
-              "description": "Vendor's error category mapped onto the documented enum; unrecognized values collapse to 'unknown' (never free-form prose)."
+              "description": "Vendor error category mapped onto the normalized enum; unrecognized values collapse to 'unknown' (never free-form prose)."
             }
           },
           "required": [

package/generated/HarnessManifest.schema.json

@@ -334,7 +334,7 @@
                 "unsupported"
               ],
               "default": "unsupported",
-              "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (whole-answer JSON), or unsupported (work_state stays unverified)."
+              "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (instructed terminal metadata), or unsupported (work_state stays unverified)."
             },
             "structured_output_channel": {
               "type": "string",

package/generated/HarnessStatusDto.schema.json

@@ -352,7 +352,7 @@
                         "unsupported"
                       ],
                       "default": "unsupported",
-                      "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (whole-answer JSON), or unsupported (work_state stays unverified)."
+                      "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (instructed terminal metadata), or unsupported (work_state stays unverified)."
                     },
                     "structured_output_channel": {
                       "type": "string",

package/generated/McpRunHandleResult.schema.json

@@ -110,6 +110,7 @@
                         "wall_clock_exceeded",
                         "user_cancelled",
                         "crash_interrupted",
+                        "workspace_unavailable",
                         "input_required",
                         "work_incomplete",
                         "context_capacity_exhausted",
@@ -144,7 +145,7 @@
                         "validated",
                         "absent"
                       ],
-                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (instructed terminal metadata), or absent (no transport could carry one — a disclosed absence, not a failure)."
                     },
                     "required_inputs": {
                       "type": "array",
@@ -214,6 +215,130 @@
           "description": "The D8 terminal outcome axes (checks/review/reason/noChanges), when terminal.",
           "default": null
         },
+        "failure": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "phase": {
+                  "type": "string",
+                  "default": "unknown",
+                  "description": "Pipeline phase where the failure happened."
+                },
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "validation",
+                    "project",
+                    "auth",
+                    "harness_unavailable",
+                    "harness_error",
+                    "config_error",
+                    "budget",
+                    "policy",
+                    "cancelled",
+                    "internal",
+                    "unknown"
+                  ],
+                  "default": "unknown",
+                  "description": "Typed failure category (validation, project, auth, harness, config, budget, policy, cancelled, internal, unknown). config_error is a settings/routing misconfiguration (e.g. quality routing with no comparable tier), corrected by changing configuration, not by re-auth or waiting for a harness."
+                },
+                "code": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "finite_zero",
+                        "hard_cap",
+                        "estimate_headroom",
+                        "unknown_paid_in_flight",
+                        "budget_overshoot",
+                        "cost_unverifiable",
+                        "delegation_child_drain_timeout"
+                      ],
+                      "description": "Machine-readable failure sub-code within a RunFailure category (budget-denial reasons and Delegate child-drain timeout)."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Machine-readable failure sub-code within the category; null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                  "default": null
+                },
+                "harnessId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Harness involved in the failure, when known."
+                },
+                "attemptId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Attempt involved in the failure, when known."
+                },
+                "safeMessage": {
+                  "type": "string",
+                  "description": "Redacted human-readable failure message."
+                },
+                "rawDetailRef": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Artifact path holding the raw (redacted) failure detail."
+                },
+                "logRefs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Log artifact paths relevant to the failure."
+                },
+                "eventRefs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Event references relevant to the failure."
+                },
+                "runDir": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Run artifact directory."
+                },
+                "nextActions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Suggested operator next actions."
+                }
+              },
+              "required": [
+                "safeMessage"
+              ],
+              "additionalProperties": false,
+              "description": "Typed failure record for a run: phase, category, evidence references, and suggested next actions."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed terminal failure detail and recovery actions; null for non-failed runs.",
+          "default": null
+        },
         "outcomeBanner": {
           "type": [
             "string",
@@ -577,6 +702,45 @@
           ],
           "description": "Typed Delegate receipt; null when unavailable or legacy.",
           "default": null
+        },
+        "detailProblem": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Stable machine code of the detail problem, if any."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable description of the detail problem."
+                },
+                "retryable": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Whether retrying the detail read may help."
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "additionalProperties": false,
+              "description": "Typed failure of a post-run detail read whose durable run result still survives."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed post-terminal detail-read problem (the durable run handle survives); null when the detail read succeeded.",
+          "default": null
         }
       },
       "required": [

package/generated/McpRunToolResult.schema.json

@@ -86,6 +86,7 @@
                         "wall_clock_exceeded",
                         "user_cancelled",
                         "crash_interrupted",
+                        "workspace_unavailable",
                         "input_required",
                         "work_incomplete",
                         "context_capacity_exhausted",
@@ -120,7 +121,7 @@
                         "validated",
                         "absent"
                       ],
-                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (instructed terminal metadata), or absent (no transport could carry one — a disclosed absence, not a failure)."
                     },
                     "required_inputs": {
                       "type": "array",
@@ -190,6 +191,130 @@
           "description": "The D8 terminal outcome axes (checks/review/reason/noChanges); null for non-terminal or read-only routes.",
           "default": null
         },
+        "failure": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "phase": {
+                  "type": "string",
+                  "default": "unknown",
+                  "description": "Pipeline phase where the failure happened."
+                },
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "validation",
+                    "project",
+                    "auth",
+                    "harness_unavailable",
+                    "harness_error",
+                    "config_error",
+                    "budget",
+                    "policy",
+                    "cancelled",
+                    "internal",
+                    "unknown"
+                  ],
+                  "default": "unknown",
+                  "description": "Typed failure category (validation, project, auth, harness, config, budget, policy, cancelled, internal, unknown). config_error is a settings/routing misconfiguration (e.g. quality routing with no comparable tier), corrected by changing configuration, not by re-auth or waiting for a harness."
+                },
+                "code": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "finite_zero",
+                        "hard_cap",
+                        "estimate_headroom",
+                        "unknown_paid_in_flight",
+                        "budget_overshoot",
+                        "cost_unverifiable",
+                        "delegation_child_drain_timeout"
+                      ],
+                      "description": "Machine-readable failure sub-code within a RunFailure category (budget-denial reasons and Delegate child-drain timeout)."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Machine-readable failure sub-code within the category; null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                  "default": null
+                },
+                "harnessId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Harness involved in the failure, when known."
+                },
+                "attemptId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Attempt involved in the failure, when known."
+                },
+                "safeMessage": {
+                  "type": "string",
+                  "description": "Redacted human-readable failure message."
+                },
+                "rawDetailRef": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Artifact path holding the raw (redacted) failure detail."
+                },
+                "logRefs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Log artifact paths relevant to the failure."
+                },
+                "eventRefs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Event references relevant to the failure."
+                },
+                "runDir": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Run artifact directory."
+                },
+                "nextActions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [],
+                  "description": "Suggested operator next actions."
+                }
+              },
+              "required": [
+                "safeMessage"
+              ],
+              "additionalProperties": false,
+              "description": "Typed failure record for a run: phase, category, evidence references, and suggested next actions."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed terminal failure detail and recovery actions; null for non-failed runs.",
+          "default": null
+        },
         "applyEligibility": {
           "anyOf": [
             {
@@ -277,6 +402,45 @@
           "description": "Derived plan readiness for plan tools (D17); null for non-plan tools.",
           "default": null
         },
+        "detailProblem": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Stable machine code of the detail problem, if any."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable description of the detail problem."
+                },
+                "retryable": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Whether retrying the detail read may help."
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "additionalProperties": false,
+              "description": "Typed failure of a post-run detail read whose durable run result still survives."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed post-terminal detail-read problem (the run result survives; its detail projections are absent for this reason); null when the detail read succeeded.",
+          "default": null
+        },
         "council": {
           "anyOf": [
             {

package/generated/OutputReadyPayload.schema.json

@@ -0,0 +1,44 @@
+{
+  "$ref": "#/definitions/OutputReadyPayload",
+  "definitions": {
+    "OutputReadyPayload": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "answer",
+            "report",
+            "plan",
+            "summary",
+            "patch",
+            "structured_output",
+            "artifact"
+          ],
+          "description": "Kind of materialized output announced by this receipt."
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Run-relative path of the materialized output artifact."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "ready",
+            "diagnostic"
+          ],
+          "default": "ready",
+          "description": "Whether the announced artifact is normal output or diagnostic output."
+        }
+      },
+      "required": [
+        "kind",
+        "path"
+      ],
+      "additionalProperties": false,
+      "description": "Validated payload of an output.ready run event."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}