@claudexor/schema 3.1.1 → 3.2.0

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": [
@@ -498,6 +580,14 @@
                         ],
                         "default": null
                       },
+                      "profileId": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Credential profile the deciding attempt ran under; null = engine-default credentials."
+                      },
                       "modelMismatch": {
                         "anyOf": [
                           {
@@ -664,7 +754,8 @@
                       "type": "string",
                       "enum": [
                         "browser",
-                        "path_deny"
+                        "path_deny",
+                        "delegation"
                       ]
                     },
                     "harness_id": {
@@ -688,6 +779,7 @@
                         "manifest_unsupported",
                         "web_policy_off",
                         "access_profile_incompatible",
+                        "runtime_unavailable",
                         "postdiff_only"
                       ]
                     },
@@ -901,6 +993,7 @@
                               "wall_clock_exceeded",
                               "user_cancelled",
                               "crash_interrupted",
+                              "workspace_unavailable",
                               "input_required",
                               "work_incomplete",
                               "context_capacity_exhausted",
@@ -935,7 +1028,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",
@@ -1008,7 +1101,7 @@
               "waitingOnUser": {
                 "type": "boolean",
                 "default": false,
-                "description": "True while at least one interactive question is awaiting the user's answer."
+                "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
               },
               "route": {
                 "anyOf": [
@@ -1075,9 +1168,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 +1176,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 +1189,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",
@@ -446,7 +450,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",
@@ -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",

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": {
@@ -362,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": [
@@ -493,6 +575,14 @@
                   ],
                   "default": null
                 },
+                "profileId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Credential profile the deciding attempt ran under; null = engine-default credentials."
+                },
                 "modelMismatch": {
                   "anyOf": [
                     {
@@ -659,7 +749,8 @@
                 "type": "string",
                 "enum": [
                   "browser",
-                  "path_deny"
+                  "path_deny",
+                  "delegation"
                 ]
               },
               "harness_id": {
@@ -683,6 +774,7 @@
                   "manifest_unsupported",
                   "web_policy_off",
                   "access_profile_incompatible",
+                  "runtime_unavailable",
                   "postdiff_only"
                 ]
               },
@@ -896,6 +988,7 @@
                         "wall_clock_exceeded",
                         "user_cancelled",
                         "crash_interrupted",
+                        "workspace_unavailable",
                         "input_required",
                         "work_incomplete",
                         "context_capacity_exhausted",
@@ -930,7 +1023,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",
@@ -1003,7 +1096,7 @@
         "waitingOnUser": {
           "type": "boolean",
           "default": false,
-          "description": "True while at least one interactive question is awaiting the user's answer."
+          "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
         },
         "route": {
           "anyOf": [
@@ -1070,9 +1163,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."
@@ -1080,7 +1171,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."
@@ -1093,6 +1184,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/ControlSettingsSnapshot.schema.json

@@ -13,10 +13,19 @@
           "description": "Config file paths that contributed to the snapshot."
         },
         "interactionTimeoutMs": {
-          "type": "integer",
-          "exclusiveMinimum": 0,
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 8000000000000000,
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
           "default": 900000,
-          "description": "How long a run waits for an interactive answer before a benign decline, in milliseconds."
+          "description": "Automatic-expiry policy for an interactive answer: positive milliseconds deliver a benign decline at the deadline; null disables automatic expiry."
         },
         "routing": {
           "type": "object",

package/generated/ControlSettingsUpdateRequest.schema.json

@@ -78,9 +78,18 @@
           "description": "Per-intent quality tiers ordered highest to lowest; no provider or benchmark priors are inferred."
         },
         "interactionTimeoutMs": {
-          "type": "integer",
-          "exclusiveMinimum": 0,
-          "description": "New interactive-answer timeout, in milliseconds."
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 8000000000000000,
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New interactive-answer timeout in milliseconds; null disables automatic expiry."
         },
         "primaryHarness": {
           "anyOf": [

package/generated/ControlSetupJob.schema.json

@@ -23,6 +23,15 @@
           "const": "login",
           "description": "The daemon-managed native-login action."
         },
+        "transport": {
+          "type": "string",
+          "enum": [
+            "daemon",
+            "client_pty"
+          ],
+          "description": "Who owns the interactive terminal: daemon opens a local Terminal, or the client attaches its PTY.",
+          "default": "daemon"
+        },
         "profileId": {
           "type": [
             "string",

package/generated/ControlSetupJobCreateRequest.schema.json

@@ -35,6 +35,15 @@
             "browser_redirect"
           ],
           "description": "Codex-only: device_auth (default; app-server device-code, isolated browser window), browser_callback (app-server browser-callback opt-in), or browser_redirect (legacy Terminal localhost callback / fallback)."
+        },
+        "transport": {
+          "type": "string",
+          "enum": [
+            "daemon",
+            "client_pty"
+          ],
+          "description": "Additive terminal handoff. client_pty prepares a sealed login job for `claudexor setup attach`.",
+          "default": "daemon"
         }
       },
       "required": [