@claudexor/schema 3.1.1 → 3.1.2

package/generated/ControlHarnessListResponse.schema.json

@@ -254,12 +254,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,
@@ -721,6 +721,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/ControlRunAgainDraft.schema.json

@@ -393,7 +393,11 @@
             },
             "parentRunId": {
               "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
-              "description": "Run this turn follows up on."
+              "description": "Server-owned parent/follow-up lineage; rejected on direct POST /runs."
+            },
+            "delegatedFromRunId": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "description": "Internal belt-child provenance only; equals parentRunId and is rejected on direct POST /runs."
             },
             "retryOf": {
               "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
@@ -478,7 +482,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/ControlRunControlResponse.schema.json

@@ -24,6 +24,14 @@
           "minLength": 1,
           "description": "Run the control was applied to."
         },
+        "cascadeRunIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+          },
+          "default": [],
+          "description": "Active Claudexor Delegate descendants included in this cancellation."
+        },
         "message": {
           "type": "string",
           "description": "Human-readable detail."

package/generated/ControlRunDetail.schema.json

@@ -15,6 +15,87 @@
               "type": "string",
               "description": "Run id."
             },
+            "parentRunId": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Parent/follow-up run id, when any.",
+              "default": null
+            },
+            "delegatedFromRunId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Claudexor Delegate parent run id; null for ordinary runs and native vendor subagents.",
+              "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": "Durable Delegate requested/effective/used receipt projected from engine telemetry; null when legacy telemetry has no receipt.",
+              "default": null
+            },
             "taskId": {
               "type": "string",
               "description": "Task id, when allocated."
@@ -77,15 +158,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": {
@@ -365,7 +447,7 @@
             },
             "spendEstimated": {
               "type": "boolean",
-              "description": "True when spend is token-derived rather than natively reported."
+              "description": "True when settled cash is estimated rather than exact."
             },
             "inputTokens": {
               "anyOf": [
@@ -662,7 +744,8 @@
                     "type": "string",
                     "enum": [
                       "browser",
-                      "path_deny"
+                      "path_deny",
+                      "delegation"
                     ]
                   },
                   "harness_id": {
@@ -686,6 +769,7 @@
                       "manifest_unsupported",
                       "web_policy_off",
                       "access_profile_incompatible",
+                      "runtime_unavailable",
                       "postdiff_only"
                     ]
                   },
@@ -1073,9 +1157,7 @@
                     "order": {
                       "type": "array",
                       "items": {
-                        "type": "string",
-                        "minLength": 1,
-                        "description": "Non-empty identifier string."
+                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                       },
                       "default": [],
                       "description": "Final ranked order, harness ids."
@@ -1083,7 +1165,7 @@
                     "dropped": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                        "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                       },
                       "default": [],
                       "description": "Ids removed by paid_fallback or cooldown before ranking."
@@ -1096,6 +1178,8 @@
                         "quality_tier",
                         "expiring_quota_slack",
                         "all_incremental_cash_unknown",
+                        "delegate_effective_first",
+                        "explicit_primary",
                         "declared_order"
                       ],
                       "description": "Typed decisive reason the pool ranked the way it did (QA-034)."
@@ -1225,6 +1309,15 @@
           "additionalProperties": false,
           "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
         },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlRunDetail/properties/summary"
+          },
+          "maxItems": 8,
+          "default": [],
+          "description": "Direct Claudexor Delegate child runs, projected from persisted delegatedFromRunId lineage for reload-safe flat rows."
+        },
         "outcomeBanner": {
           "type": [
             "string",
@@ -1480,7 +1573,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",
@@ -1524,7 +1617,7 @@
                 "winner": {
                   "anyOf": [
                     {
-                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                      "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                     },
                     {
                       "type": "null"
@@ -1664,7 +1757,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": [
@@ -1681,6 +1774,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,
@@ -1874,7 +1976,7 @@
                   "description": "Task the work product came from."
                 },
                 "producer_attempt_id": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items",
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0",
                   "description": "Attempt that produced it, when known."
                 },
                 "evidence_dir": {
@@ -2194,7 +2296,7 @@
               "linked_acceptance_criteria": {
                 "type": "array",
                 "items": {
-                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/routingRationale/anyOf/0/properties/order/items"
+                  "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/parentRunId/anyOf/0"
                 },
                 "default": [],
                 "description": "Ids of acceptance criteria this finding relates to."

package/generated/ControlRunListResponse.schema.json

@@ -17,6 +17,87 @@
                 "type": "string",
                 "description": "Run id."
               },
+              "parentRunId": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Non-empty identifier string."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Parent/follow-up run id, when any.",
+                "default": null
+              },
+              "delegatedFromRunId": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Claudexor Delegate parent run id; null for ordinary runs and native vendor subagents.",
+                "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": "Durable Delegate requested/effective/used receipt projected from engine telemetry; null when legacy telemetry has no receipt.",
+                "default": null
+              },
               "taskId": {
                 "type": "string",
                 "description": "Task id, when allocated."
@@ -79,15 +160,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": {
@@ -367,7 +449,7 @@
               },
               "spendEstimated": {
                 "type": "boolean",
-                "description": "True when spend is token-derived rather than natively reported."
+                "description": "True when settled cash is estimated rather than exact."
               },
               "inputTokens": {
                 "anyOf": [
@@ -664,7 +746,8 @@
                       "type": "string",
                       "enum": [
                         "browser",
-                        "path_deny"
+                        "path_deny",
+                        "delegation"
                       ]
                     },
                     "harness_id": {
@@ -688,6 +771,7 @@
                         "manifest_unsupported",
                         "web_policy_off",
                         "access_profile_incompatible",
+                        "runtime_unavailable",
                         "postdiff_only"
                       ]
                     },
@@ -1075,9 +1159,7 @@
                       "order": {
                         "type": "array",
                         "items": {
-                          "type": "string",
-                          "minLength": 1,
-                          "description": "Non-empty identifier string."
+                          "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
                         },
                         "default": [],
                         "description": "Final ranked order, harness ids."
@@ -1085,7 +1167,7 @@
                       "dropped": {
                         "type": "array",
                         "items": {
-                          "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/routingRationale/anyOf/0/properties/order/items"
+                          "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/parentRunId/anyOf/0"
                         },
                         "default": [],
                         "description": "Ids removed by paid_fallback or cooldown before ranking."
@@ -1098,6 +1180,8 @@
                           "quality_tier",
                           "expiring_quota_slack",
                           "all_incremental_cash_unknown",
+                          "delegate_effective_first",
+                          "explicit_primary",
                           "declared_order"
                         ],
                         "description": "Typed decisive reason the pool ranked the way it did (QA-034)."

package/generated/ControlRunStartRequest.schema.json

@@ -386,7 +386,11 @@
         },
         "parentRunId": {
           "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
-          "description": "Run this turn follows up on."
+          "description": "Server-owned parent/follow-up lineage; rejected on direct POST /runs."
+        },
+        "delegatedFromRunId": {
+          "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
+          "description": "Internal belt-child provenance only; equals parentRunId and is rejected on direct POST /runs."
         },
         "retryOf": {
           "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
@@ -471,7 +475,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",