@claudexor/schema 3.1.0 → 3.1.2

package/generated/ControlSettingsSnapshot.schema.json

@@ -96,14 +96,10 @@
                       },
                       "effort": {
                         "type": "string",
-                        "enum": [
-                          "low",
-                          "medium",
-                          "high",
-                          "xhigh",
-                          "max"
-                        ],
-                        "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                        "minLength": 1,
+                        "maxLength": 32,
+                        "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                       }
                     },
                     "required": [

package/generated/ControlSettingsUpdateRequest.schema.json

@@ -42,14 +42,10 @@
                   },
                   "effort": {
                     "type": "string",
-                    "enum": [
-                      "low",
-                      "medium",
-                      "high",
-                      "xhigh",
-                      "max"
-                    ],
-                    "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                    "minLength": 1,
+                    "maxLength": 32,
+                    "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                    "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                   }
                 },
                 "required": [

package/generated/ControlThreadDetail.schema.json

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

package/generated/ControlThreadTurnRequest.schema.json

@@ -82,13 +82,9 @@
         },
         "effort": {
           "type": "string",
-          "enum": [
-            "low",
-            "medium",
-            "high",
-            "xhigh",
-            "max"
-          ],
+          "minLength": 1,
+          "maxLength": 32,
+          "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
           "description": "Requested reasoning effort."
         },
         "efforts": {
@@ -391,7 +387,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

@@ -298,7 +298,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 +315,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/GlobalConfig.schema.json

@@ -94,14 +94,10 @@
                       },
                       "effort": {
                         "type": "string",
-                        "enum": [
-                          "low",
-                          "medium",
-                          "high",
-                          "xhigh",
-                          "max"
-                        ],
-                        "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                        "minLength": 1,
+                        "maxLength": 32,
+                        "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                       }
                     },
                     "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,
@@ -349,17 +349,53 @@
               "type": "array",
               "items": {
                 "type": "string",
-                "enum": [
-                  "low",
-                  "medium",
-                  "high",
-                  "xhigh",
-                  "max"
-                ],
-                "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                "minLength": 1,
+                "maxLength": 32,
+                "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
               },
               "default": [],
-              "description": "Ordered (weakest to strongest) reasoning-effort levels this harness actually accepts; empty means effort is not a tunable surface."
+              "description": "Ordered (weakest to strongest) reasoning-effort levels this harness accepts across all its models; empty means effort is not a tunable surface."
+            },
+            "model_effort_levels": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "levels": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/HarnessManifest/properties/capabilities/properties/effort_levels/items"
+                    },
+                    "default": [],
+                    "description": "Ordered (weakest to strongest) reasoning-effort levels this model advertises, in the vendor's own order."
+                  },
+                  "default": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/HarnessManifest/properties/capabilities/properties/effort_levels/items"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "The effort level the vendor uses for this model when none is requested.",
+                    "default": null
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Reasoning-effort vocabulary a single model advertises."
+              },
+              "default": {},
+              "description": "Per-model advertised reasoning-effort vocabulary keyed by model id; a model absent here falls back to the harness-wide effort_levels union."
+            },
+            "effort_levels_verified_against": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Vendor CLI version the effort ladders were last verified against; null = never verified / not applicable."
             },
             "known_models": {
               "type": "array",

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,
@@ -367,17 +367,53 @@
                       "type": "array",
                       "items": {
                         "type": "string",
-                        "enum": [
-                          "low",
-                          "medium",
-                          "high",
-                          "xhigh",
-                          "max"
-                        ],
-                        "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                        "minLength": 1,
+                        "maxLength": 32,
+                        "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                       },
                       "default": [],
-                      "description": "Ordered (weakest to strongest) reasoning-effort levels this harness actually accepts; empty means effort is not a tunable surface."
+                      "description": "Ordered (weakest to strongest) reasoning-effort levels this harness accepts across all its models; empty means effort is not a tunable surface."
+                    },
+                    "model_effort_levels": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "object",
+                        "properties": {
+                          "levels": {
+                            "type": "array",
+                            "items": {
+                              "$ref": "#/definitions/HarnessStatusDto/properties/manifest/anyOf/0/properties/capabilities/properties/effort_levels/items"
+                            },
+                            "default": [],
+                            "description": "Ordered (weakest to strongest) reasoning-effort levels this model advertises, in the vendor's own order."
+                          },
+                          "default": {
+                            "anyOf": [
+                              {
+                                "$ref": "#/definitions/HarnessStatusDto/properties/manifest/anyOf/0/properties/capabilities/properties/effort_levels/items"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "The effort level the vendor uses for this model when none is requested.",
+                            "default": null
+                          }
+                        },
+                        "additionalProperties": false,
+                        "description": "Reasoning-effort vocabulary a single model advertises."
+                      },
+                      "default": {},
+                      "description": "Per-model advertised reasoning-effort vocabulary keyed by model id; a model absent here falls back to the harness-wide effort_levels union."
+                    },
+                    "effort_levels_verified_against": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Vendor CLI version the effort ladders were last verified against; null = never verified / not applicable."
                     },
                     "known_models": {
                       "type": "array",
@@ -680,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": [

package/generated/McpRunHandleResult.schema.json

@@ -473,7 +473,7 @@
                 "estimated": {
                   "type": "boolean",
                   "default": false,
-                  "description": "True when spend is token-derived rather than natively reported."
+                  "description": "True when settled cash is estimated rather than exact; subscription valuation confidence is reported separately."
                 },
                 "source": {
                   "type": "string",
@@ -506,6 +506,77 @@
           ],
           "description": "Run budget snapshot (cash + subscription valuation, QA-023c); null when unavailable.",
           "default": null
+        },
+        "parentRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Server-owned ordinary parent/follow-up run id, when present."
+        },
+        "delegatedFromRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Claudexor Delegate parent id; null for ordinary runs and native subagents."
+        },
+        "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": "Typed Delegate receipt; null when unavailable or legacy.",
+          "default": null
         }
       },
       "required": [

package/generated/McpRunToolResult.schema.json

@@ -366,6 +366,75 @@
           ],
           "description": "Council membership + merge disclosure (QA-023b); null for solo/non-plan tools or deferred handles.",
           "default": null
+        },
+        "parentRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null
+        },
+        "delegatedFromRunId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null
+        },
+        "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": "Engine-owned Delegate requested/effective/used receipt; surfaces project it without parsing model output.",
+          "default": null
         }
       },
       "required": [

package/generated/ProjectConfig.schema.json

@@ -112,6 +112,32 @@
           "additionalProperties": false,
           "default": {},
           "description": "Safe project routing preference; paid fallback remains user-global."
+        },
+        "constraints": {
+          "type": "object",
+          "properties": {
+            "protected_paths": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "allOf": [
+                  {
+                    "pattern": "\\S"
+                  },
+                  {
+                    "pattern": "^(?!\\/)(?![A-Za-z]:)(?!.*\\\\)(?!.*\\0)(?!.*\\/\\/)(?!.*\\/$)(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))\\S(?:.*\\S)?$"
+                  }
+                ],
+                "description": "Canonical repo-relative glob whose matching changes require human approval before apply."
+              },
+              "default": [],
+              "description": "Restriction-only repo-relative globs whose matching changes require a human decision before apply; empty by default."
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Safe project restrictions that can only narrow what an unattended run may apply."
         }
       },
       "additionalProperties": false,

package/generated/RunEvent.schema.json

@@ -69,9 +69,11 @@
             "council.merged",
             "budget.quota_pressure",
             "delegation.belt.unavailable",
+            "delegation.belt.degraded",
             "output.ready",
             "gate.started",
             "gate.completed",
+            "review.preflight",
             "review.started",
             "review.skipped",
             "reviewer.started",

package/generated/RunFailure.schema.json

@@ -37,15 +37,16 @@
                 "estimate_headroom",
                 "unknown_paid_in_flight",
                 "budget_overshoot",
-                "cost_unverifiable"
+                "cost_unverifiable",
+                "delegation_child_drain_timeout"
               ],
-              "description": "Machine-readable failure sub-code within a RunFailure category (today the typed budget-denial reasons produced by the budget ledger)."
+              "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 (today the typed budget-denial reason from the ledger); null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+          "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": {