@claudexor/schema 3.1.0 → 3.1.2

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": {
@@ -278,13 +360,9 @@
                   },
                   "effort": {
                     "type": "string",
-                    "enum": [
-                      "low",
-                      "medium",
-                      "high",
-                      "xhigh",
-                      "max"
-                    ],
+                    "minLength": 1,
+                    "maxLength": 32,
+                    "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
                     "description": "Per-reviewer effort hint, passed to that harness only."
                   }
                 },
@@ -369,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": [
@@ -666,7 +744,8 @@
                     "type": "string",
                     "enum": [
                       "browser",
-                      "path_deny"
+                      "path_deny",
+                      "delegation"
                     ]
                   },
                   "harness_id": {
@@ -690,6 +769,7 @@
                       "manifest_unsupported",
                       "web_policy_off",
                       "access_profile_incompatible",
+                      "runtime_unavailable",
                       "postdiff_only"
                     ]
                   },
@@ -1077,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."
@@ -1087,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."
@@ -1100,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)."
@@ -1229,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",
@@ -1484,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",
@@ -1528,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"
@@ -1668,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": [
@@ -1685,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,
@@ -1878,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": {
@@ -2198,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": {
@@ -280,13 +362,9 @@
                     },
                     "effort": {
                       "type": "string",
-                      "enum": [
-                        "low",
-                        "medium",
-                        "high",
-                        "xhigh",
-                        "max"
-                      ],
+                      "minLength": 1,
+                      "maxLength": 32,
+                      "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
                       "description": "Per-reviewer effort hint, passed to that harness only."
                     }
                   },
@@ -371,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": [
@@ -668,7 +746,8 @@
                       "type": "string",
                       "enum": [
                         "browser",
-                        "path_deny"
+                        "path_deny",
+                        "delegation"
                       ]
                     },
                     "harness_id": {
@@ -692,6 +771,7 @@
                         "manifest_unsupported",
                         "web_policy_off",
                         "access_profile_incompatible",
+                        "runtime_unavailable",
                         "postdiff_only"
                       ]
                     },
@@ -1079,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."
@@ -1089,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."
@@ -1102,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

@@ -150,13 +150,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": {
@@ -390,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",
@@ -475,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",

package/generated/ControlRunSummary.schema.json

@@ -12,6 +12,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/ControlRunSummary/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."
@@ -74,15 +155,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": {
@@ -275,13 +357,9 @@
               },
               "effort": {
                 "type": "string",
-                "enum": [
-                  "low",
-                  "medium",
-                  "high",
-                  "xhigh",
-                  "max"
-                ],
+                "minLength": 1,
+                "maxLength": 32,
+                "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
                 "description": "Per-reviewer effort hint, passed to that harness only."
               }
             },
@@ -366,7 +444,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": [
@@ -663,7 +741,8 @@
                 "type": "string",
                 "enum": [
                   "browser",
-                  "path_deny"
+                  "path_deny",
+                  "delegation"
                 ]
               },
               "harness_id": {
@@ -687,6 +766,7 @@
                   "manifest_unsupported",
                   "web_policy_off",
                   "access_profile_incompatible",
+                  "runtime_unavailable",
                   "postdiff_only"
                 ]
               },
@@ -1074,9 +1154,7 @@
                 "order": {
                   "type": "array",
                   "items": {
-                    "type": "string",
-                    "minLength": 1,
-                    "description": "Non-empty identifier string."
+                    "$ref": "#/definitions/ControlRunSummary/properties/parentRunId/anyOf/0"
                   },
                   "default": [],
                   "description": "Final ranked order, harness ids."
@@ -1084,7 +1162,7 @@
                 "dropped": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/definitions/ControlRunSummary/properties/routingRationale/anyOf/0/properties/order/items"
+                    "$ref": "#/definitions/ControlRunSummary/properties/parentRunId/anyOf/0"
                   },
                   "default": [],
                   "description": "Ids removed by paid_fallback or cooldown before ranking."
@@ -1097,6 +1175,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)."