@claudexor/schema 2.1.3 → 3.0.1

package/generated/ControlRunListResponse.schema.json

@@ -26,21 +26,12 @@
                 "enum": [
                   "queued",
                   "running",
-                  "blocked",
                   "succeeded",
-                  "no_op",
-                  "ungated",
-                  "review_not_run",
                   "failed",
                   "cancelled",
-                  "interrupted_unknown",
-                  "cost_unverifiable",
-                  "exhausted_overshoot",
-                  "exhausted",
-                  "not_converged",
-                  "stuck_no_progress"
+                  "interrupted"
                 ],
-                "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
+                "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
               },
               "runDir": {
                 "type": "string",
@@ -198,11 +189,9 @@
                 "enum": [
                   "ask",
                   "plan",
-                  "audit",
-                  "agent",
-                  "orchestrate"
+                  "agent"
                 ],
-                "description": "Canonical run mode: ask, plan, and audit are read-only; agent writes; orchestrate is the autonomous coordinator intent. Engine strategies (race, attempts, swarm, create) are flags on a mode, not modes."
+                "description": "Canonical run mode: ask and plan are read-only, agent writes. Engine strategies (race width, attempts, deep_scan, create, delegate) are flags on a mode, not modes."
               },
               "strategy": {
                 "anyOf": [
@@ -212,7 +201,7 @@
                       "race",
                       "attempts",
                       "until_clean",
-                      "swarm",
+                      "deep_scan",
                       "create"
                     ]
                   },
@@ -220,7 +209,7 @@
                     "type": "null"
                   }
                 ],
-                "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / swarm / create); flags, not modes."
+                "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / deep-scan / create); flags, not modes."
               },
               "prompt": {
                 "type": "string",
@@ -283,7 +272,7 @@
                     "harness"
                   ],
                   "additionalProperties": false,
-                  "description": "One reviewer of an explicit reviewer panel."
+                  "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`)."
                 },
                 "description": "Explicit reviewer panel used for the run."
               },
@@ -837,6 +826,87 @@
                 "description": "Honest terminal outcome of a run (what the turn actually did), projected from the work product and answer artifacts.",
                 "default": {}
               },
+              "outcomeFacts": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "lifecycle": {
+                        "type": "string",
+                        "enum": [
+                          "succeeded",
+                          "failed",
+                          "cancelled",
+                          "interrupted"
+                        ],
+                        "description": "Terminal lifecycle of the run."
+                      },
+                      "noChanges": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "True when the run finished without changing any files (the ex no_op fact)."
+                      },
+                      "checks": {
+                        "type": "string",
+                        "enum": [
+                          "passed",
+                          "failed",
+                          "not_configured"
+                        ],
+                        "description": "Deterministic checks axis: configured project checks passed, failed, or none are configured (a named state, never a stand-in for review results).",
+                        "default": "not_configured"
+                      },
+                      "review": {
+                        "type": "string",
+                        "enum": [
+                          "approved",
+                          "blocked",
+                          "not_run"
+                        ],
+                        "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
+                        "default": "not_run"
+                      },
+                      "reason": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "harness_failed",
+                              "no_changes",
+                              "review_blocked",
+                              "checks_failed",
+                              "budget_exhausted",
+                              "budget_overshoot",
+                              "cost_unverifiable",
+                              "not_converged",
+                              "stuck_no_progress",
+                              "wall_clock_exceeded",
+                              "user_cancelled",
+                              "crash_interrupted"
+                            ],
+                            "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
+                        "default": null
+                      }
+                    },
+                    "required": [
+                      "lifecycle"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Independent terminal outcome axes of a run (D8/D18)."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "D8 terminal outcome axes (checks/review/reason/noChanges) projected from decision.facts or derived from the failure; null while non-terminal.",
+                "default": null
+              },
               "waitingOnUser": {
                 "type": "boolean",
                 "default": false,
@@ -927,15 +997,6 @@
                 },
                 "description": "Typed argv gates."
               },
-              "specId": {
-                "type": "string",
-                "description": "SpecPack id the run was held to."
-              },
-              "specHash": {
-                "type": "string",
-                "minLength": 1,
-                "description": "Content hash of the SpecPack the run was held to."
-              },
               "createdAt": {
                 "type": "string",
                 "description": "When the run was created."

package/generated/ControlRunStartRequest.schema.json

@@ -37,11 +37,9 @@
           "enum": [
             "ask",
             "plan",
-            "audit",
-            "agent",
-            "orchestrate"
+            "agent"
           ],
-          "description": "Canonical run mode: ask, plan, and audit are read-only; agent writes; orchestrate is the autonomous coordinator intent. Engine strategies (race, attempts, swarm, create) are flags on a mode, not modes.",
+          "description": "Canonical run mode: ask and plan are read-only, agent writes. Engine strategies (race width, attempts, deep_scan, create, delegate) are flags on a mode, not modes.",
           "default": "agent"
         },
         "scope": {
@@ -220,14 +218,18 @@
           "type": "boolean",
           "description": "Agent flag: iterate until the convergence predicate is clean (no fixed cap)."
         },
-        "swarm": {
+        "deepScan": {
           "type": "boolean",
-          "description": "Audit flag: bounded read-only research swarm."
+          "description": "Ask flag: bounded multi-scout research sweep with synthesis."
         },
         "create": {
           "type": "boolean",
           "description": "Agent flag: create-from-scratch intent."
         },
+        "council": {
+          "type": "boolean",
+          "description": "Plan strategy: N harnesses draft plans in parallel, the primary merges into one unified plan + one question set. Plan mode only."
+        },
         "synthesis": {
           "type": "string",
           "enum": [
@@ -366,19 +368,6 @@
           },
           "description": "Typed per-run approvals for changing auto-protected gate/test paths; does not bypass built-in critical/security path human gates."
         },
-        "specPath": {
-          "$ref": "#/definitions/ControlRunStartRequest/properties/harnesses/items",
-          "description": "Path to a frozen SpecPack the run is held to."
-        },
-        "specId": {
-          "type": "string",
-          "description": "Id of the SpecPack the run is held to."
-        },
-        "specHash": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Content hash of the SpecPack the run is held to."
-        },
         "threadId": {
           "type": "string",
           "minLength": 1,
@@ -400,6 +389,29 @@
           "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
           "description": "Internal daemon handoff only; rejected (400) on POST /runs. When set, the turn implements an approved plan from that run."
         },
+        "planRef": {
+          "type": "object",
+          "properties": {
+            "runId": {
+              "$ref": "#/definitions/ControlRunStartRequest/properties/threadId"
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            },
+            "path": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "runId",
+            "sha256",
+            "path"
+          ],
+          "additionalProperties": false,
+          "description": "Internal daemon handoff only; rejected (400) on POST /runs. Frozen-plan reference delivered to the executor as a file."
+        },
         "reviewerPanel": {
           "type": "array",
           "items": {
@@ -424,10 +436,10 @@
               "harness"
             ],
             "additionalProperties": false,
-            "description": "One reviewer of an explicit reviewer panel."
+            "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; overrides the legacy reviewerModels/reviewerEfforts maps and preserves duplicate harness entries for multi-model same-provider reviews."
+          "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."
         },
         "authPreference": {
           "type": "string",
@@ -450,19 +462,9 @@
           ],
           "description": "Explicit per-run credential profile id; null FORCES the engine-default ladder past a thread-sticky profile; unknown/disabled ids refuse, never default."
         },
-        "autonomy": {
-          "type": "string",
-          "enum": [
-            "suggest",
-            "auto_safe",
-            "auto_full"
-          ],
-          "description": "Autonomy level for the orchestrate planner; only meaningful for mode=orchestrate."
-        },
-        "maxToolCalls": {
-          "type": "integer",
-          "exclusiveMinimum": 0,
-          "description": "Cap on orchestrate plan tool calls; only meaningful for mode=orchestrate."
+        "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."
         },
         "maxSeconds": {
           "type": "integer",
@@ -490,7 +492,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Request body for POST /runs: prompt, mode, scope, routing, strategy flags, budget, policies, and spec/thread linkage."
+      "description": "Request body for POST /runs: prompt, mode, scope, routing, strategy flags, budget, policies, and thread linkage."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/ControlRunStartResponse.schema.json

@@ -42,21 +42,12 @@
               "enum": [
                 "queued",
                 "running",
-                "blocked",
                 "succeeded",
-                "no_op",
-                "ungated",
-                "review_not_run",
                 "failed",
                 "cancelled",
-                "interrupted_unknown",
-                "cost_unverifiable",
-                "exhausted_overshoot",
-                "exhausted",
-                "not_converged",
-                "stuck_no_progress"
+                "interrupted"
               ],
-              "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
+              "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
             },
             "error": {
               "type": "string",

package/generated/ControlRunSummary.schema.json

@@ -21,21 +21,12 @@
           "enum": [
             "queued",
             "running",
-            "blocked",
             "succeeded",
-            "no_op",
-            "ungated",
-            "review_not_run",
             "failed",
             "cancelled",
-            "interrupted_unknown",
-            "cost_unverifiable",
-            "exhausted_overshoot",
-            "exhausted",
-            "not_converged",
-            "stuck_no_progress"
+            "interrupted"
           ],
-          "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
+          "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
         },
         "runDir": {
           "type": "string",
@@ -193,11 +184,9 @@
           "enum": [
             "ask",
             "plan",
-            "audit",
-            "agent",
-            "orchestrate"
+            "agent"
           ],
-          "description": "Canonical run mode: ask, plan, and audit are read-only; agent writes; orchestrate is the autonomous coordinator intent. Engine strategies (race, attempts, swarm, create) are flags on a mode, not modes."
+          "description": "Canonical run mode: ask and plan are read-only, agent writes. Engine strategies (race width, attempts, deep_scan, create, delegate) are flags on a mode, not modes."
         },
         "strategy": {
           "anyOf": [
@@ -207,7 +196,7 @@
                 "race",
                 "attempts",
                 "until_clean",
-                "swarm",
+                "deep_scan",
                 "create"
               ]
             },
@@ -215,7 +204,7 @@
               "type": "null"
             }
           ],
-          "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / swarm / create); flags, not modes."
+          "description": "Engine strategy flag on the mode (race width / attempt caps / until-clean / deep-scan / create); flags, not modes."
         },
         "prompt": {
           "type": "string",
@@ -278,7 +267,7 @@
               "harness"
             ],
             "additionalProperties": false,
-            "description": "One reviewer of an explicit reviewer panel."
+            "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`)."
           },
           "description": "Explicit reviewer panel used for the run."
         },
@@ -832,6 +821,87 @@
           "description": "Honest terminal outcome of a run (what the turn actually did), projected from the work product and answer artifacts.",
           "default": {}
         },
+        "outcomeFacts": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "lifecycle": {
+                  "type": "string",
+                  "enum": [
+                    "succeeded",
+                    "failed",
+                    "cancelled",
+                    "interrupted"
+                  ],
+                  "description": "Terminal lifecycle of the run."
+                },
+                "noChanges": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when the run finished without changing any files (the ex no_op fact)."
+                },
+                "checks": {
+                  "type": "string",
+                  "enum": [
+                    "passed",
+                    "failed",
+                    "not_configured"
+                  ],
+                  "description": "Deterministic checks axis: configured project checks passed, failed, or none are configured (a named state, never a stand-in for review results).",
+                  "default": "not_configured"
+                },
+                "review": {
+                  "type": "string",
+                  "enum": [
+                    "approved",
+                    "blocked",
+                    "not_run"
+                  ],
+                  "description": "Review axis: approved (clean cross-family verified review), blocked (open accepted findings), or not_run.",
+                  "default": "not_run"
+                },
+                "reason": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "harness_failed",
+                        "no_changes",
+                        "review_blocked",
+                        "checks_failed",
+                        "budget_exhausted",
+                        "budget_overshoot",
+                        "cost_unverifiable",
+                        "not_converged",
+                        "stuck_no_progress",
+                        "wall_clock_exceeded",
+                        "user_cancelled",
+                        "crash_interrupted"
+                      ],
+                      "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
+                  "default": null
+                }
+              },
+              "required": [
+                "lifecycle"
+              ],
+              "additionalProperties": false,
+              "description": "Independent terminal outcome axes of a run (D8/D18)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "D8 terminal outcome axes (checks/review/reason/noChanges) projected from decision.facts or derived from the failure; null while non-terminal.",
+          "default": null
+        },
         "waitingOnUser": {
           "type": "boolean",
           "default": false,
@@ -922,15 +992,6 @@
           },
           "description": "Typed argv gates."
         },
-        "specId": {
-          "type": "string",
-          "description": "SpecPack id the run was held to."
-        },
-        "specHash": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Content hash of the SpecPack the run was held to."
-        },
         "createdAt": {
           "type": "string",
           "description": "When the run was created."

package/generated/ControlSettingsSnapshot.schema.json

@@ -21,15 +21,6 @@
         "routing": {
           "type": "object",
           "properties": {
-            "defaultPolicy": {
-              "type": "string",
-              "enum": [
-                "auto",
-                "primary"
-              ],
-              "default": "auto",
-              "description": "Default routing policy."
-            },
             "primaryHarness": {
               "type": [
                 "string",
@@ -138,8 +129,7 @@
                   "verify",
                   "synthesize",
                   "explain",
-                  "audit",
-                  "orchestrate"
+                  "audit"
                 ]
               },
               "default": {},
@@ -253,6 +243,11 @@
                 "default": true,
                 "description": "Whether the harness participates in routing."
               },
+              "nativeCredentialsEnabled": {
+                "type": "boolean",
+                "default": true,
+                "description": "Whether the native/CLI login participates in this harness's credential ladder."
+              },
               "defaultModel": {
                 "type": [
                   "string",

package/generated/ControlSettingsUpdateRequest.schema.json

@@ -75,8 +75,7 @@
               "verify",
               "synthesize",
               "explain",
-              "audit",
-              "orchestrate"
+              "audit"
             ]
           },
           "default": {},
@@ -87,14 +86,6 @@
           "exclusiveMinimum": 0,
           "description": "New interactive-answer timeout, in milliseconds."
         },
-        "routingPolicy": {
-          "type": "string",
-          "enum": [
-            "auto",
-            "primary"
-          ],
-          "description": "New default routing policy."
-        },
         "primaryHarness": {
           "anyOf": [
             {
@@ -178,6 +169,10 @@
                 "type": "boolean",
                 "description": "Enable/disable the harness for routing."
               },
+              "nativeCredentialsEnabled": {
+                "type": "boolean",
+                "description": "Whether the native/CLI login participates in this harness's credential ladder."
+              },
               "defaultModel": {
                 "anyOf": [
                   {

package/generated/ControlThread.schema.json

@@ -30,9 +30,7 @@
           "enum": [
             "ask",
             "plan",
-            "audit",
-            "agent",
-            "orchestrate"
+            "agent"
           ],
           "description": "Default mode for new turns."
         },
@@ -85,6 +83,26 @@
           "description": "Sticky credential profile for the thread; per-turn selection wins, null = engine-default credentials.",
           "default": null
         },
+        "access": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "readonly",
+                "workspace_write",
+                "full",
+                "external_sandbox_full",
+                "inherit_native"
+              ],
+              "description": "Filesystem/command access profile for a run: readonly (no writes), workspace_write (writes inside the workspace only), full (unrestricted; requires the per-repo trust allow), external_sandbox_full (full access inside an external sandbox), inherit_native (defer to the harness's own native sandbox settings)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Sticky write scope for write turns; null = the repo trust default.",
+          "default": null
+        },
         "state": {
           "type": "string",
           "enum": [

package/generated/ControlThreadApplyResponse.schema.json

@@ -42,7 +42,6 @@
                 "mode": {
                   "type": "string",
                   "enum": [
-                    "artifact_only",
                     "apply",
                     "branch",
                     "commit",

package/generated/ControlThreadCreateRequest.schema.json

@@ -62,9 +62,7 @@
           "enum": [
             "ask",
             "plan",
-            "audit",
-            "agent",
-            "orchestrate"
+            "agent"
           ],
           "description": "Default mode for new turns."
         },
@@ -101,6 +99,17 @@
             "$ref": "#/definitions/ControlThreadCreateRequest/properties/credentialProfileId"
           },
           "description": "Sticky eligible harness pool; turns inherit it when unset."
+        },
+        "access": {
+          "type": "string",
+          "enum": [
+            "readonly",
+            "workspace_write",
+            "full",
+            "external_sandbox_full",
+            "inherit_native"
+          ],
+          "description": "Sticky write scope for the thread's write turns; omit = the repo trust default."
         }
       },
       "additionalProperties": false,