@claudexor/schema 3.1.1 → 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",
@@ -667,6 +668,70 @@
                         ],
                         "default": null,
                         "description": "When the run finished; null while live."
+                      },
+                      "delegation": {
+                        "anyOf": [
+                          {
+                            "type": "object",
+                            "properties": {
+                              "requested": {
+                                "type": "boolean",
+                                "default": false
+                              },
+                              "effective": {
+                                "type": "boolean",
+                                "default": false
+                              },
+                              "used": {
+                                "type": "boolean",
+                                "default": false
+                              },
+                              "reason": {
+                                "type": "string",
+                                "enum": [
+                                  "pending",
+                                  "not_requested",
+                                  "injected_unused",
+                                  "used",
+                                  "runtime_unavailable",
+                                  "manifest_unsupported",
+                                  "access_profile_incompatible",
+                                  "partially_degraded",
+                                  "startup_failed"
+                                ],
+                                "default": "not_requested"
+                              },
+                              "remediation": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "minLength": 1
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "default": null
+                              }
+                            },
+                            "additionalProperties": false,
+                            "description": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Durable Delegate outcome receipt; null for ordinary and legacy turns.",
+                        "default": null
+                      },
+                      "delegatedChildRunIds": {
+                        "type": "array",
+                        "items": {
+                          "$ref": "#/definitions/ControlThreadDetail/properties/thread/properties/credentialProfileId/anyOf/0"
+                        },
+                        "maxItems": 8,
+                        "default": [],
+                        "description": "At most eight server-owned direct Delegate child ids for whole-thread workspace aggregation."
                       }
                     },
                     "required": [
@@ -704,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",
@@ -387,7 +364,7 @@
         },
         "delegate": {
           "type": "boolean",
-          "description": "Agent-only: inject the Claudexor delegation belt so the harness can spawn bounded isolated sub-runs; refused on non-agent modes or harnesses without mcp_injection."
+          "description": "Agent-only: inject the Claudexor delegation belt so the harness can spawn bounded isolated sub-runs; non-agent modes refuse, while known belt or harness unavailability degrades before start to ordinary Agent with a durable warning."
         },
         "maxSeconds": {
           "type": "integer",

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",
@@ -298,7 +299,7 @@
             "estimated": {
               "type": "boolean",
               "default": false,
-              "description": "True when any of the spend is token-derived rather than natively reported."
+              "description": "True when settled cash is estimated rather than exact."
             },
             "cash_usd": {
               "type": [
@@ -315,6 +316,15 @@
               ],
               "default": null,
               "description": "Settled subscription-equivalent valuation in USD (includes the reviewer panel); null when unknown."
+            },
+            "valuation_knowledge": {
+              "type": "string",
+              "enum": [
+                "exact",
+                "estimated",
+                "unknown"
+              ],
+              "description": "Certainty of valuation_usd, independent from the settled-cash estimated flag. Absent only on legacy decisions."
             }
           },
           "additionalProperties": false,

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

@@ -231,12 +231,12 @@
             "mcp_injection": {
               "type": "boolean",
               "default": false,
-              "description": "The adapter can inject engine-owned MCP servers into the harness sandbox (browser tool, delegation belt); false = extra_mcp_servers and the delegate toggle are refused."
+              "description": "The adapter can inject engine-owned MCP servers into the harness sandbox (browser tool, delegation belt); false = browser MCP is refused and Delegate degrades to ordinary Agent with a durable typed receipt."
             },
             "mcp_injection_requires_full_access": {
               "type": "boolean",
               "default": false,
-              "description": "An injected MCP server can only reach the daemon (belt) at full access; below it the harness sandbox cancels the call. true => --delegate below full access is refused for this harness."
+              "description": "An injected MCP server can only reach the daemon (belt) at full access; below it the harness sandbox cancels the call. true => Delegate below full access degrades to ordinary Agent with a durable typed receipt."
             }
           },
           "additionalProperties": false,
@@ -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

@@ -249,12 +249,12 @@
                     "mcp_injection": {
                       "type": "boolean",
                       "default": false,
-                      "description": "The adapter can inject engine-owned MCP servers into the harness sandbox (browser tool, delegation belt); false = extra_mcp_servers and the delegate toggle are refused."
+                      "description": "The adapter can inject engine-owned MCP servers into the harness sandbox (browser tool, delegation belt); false = browser MCP is refused and Delegate degrades to ordinary Agent with a durable typed receipt."
                     },
                     "mcp_injection_requires_full_access": {
                       "type": "boolean",
                       "default": false,
-                      "description": "An injected MCP server can only reach the daemon (belt) at full access; below it the harness sandbox cancels the call. true => --delegate below full access is refused for this harness."
+                      "description": "An injected MCP server can only reach the daemon (belt) at full access; below it the harness sandbox cancels the call. true => Delegate below full access degrades to ordinary Agent with a durable typed receipt."
                     }
                   },
                   "additionalProperties": false,
@@ -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",
@@ -716,6 +716,52 @@
           ],
           "default": null,
           "description": "Strict truth-source check of configuredModel; null when no model is configured."
+        },
+        "delegation": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "available": {
+                  "type": "boolean",
+                  "description": "Whether this harness can receive the packaged delegation belt."
+                },
+                "reason": {
+                  "type": "string",
+                  "enum": [
+                    "ready",
+                    "runtime_unavailable",
+                    "manifest_unsupported"
+                  ],
+                  "description": "Stable reason for the current delegation capability verdict."
+                },
+                "remediation": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Concrete update/repair guidance when unavailable; null when ready."
+                },
+                "requiresFullAccess": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Whether this harness can reach the belt only under a full-access profile."
+                }
+              },
+              "required": [
+                "available",
+                "reason"
+              ],
+              "additionalProperties": false,
+              "description": "Engine-owned Delegate capability projection for one harness and installed runtime."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Engine-owned Delegate capability for this harness and installed runtime; null on legacy status rows.",
+          "default": null
         }
       },
       "required": [