@claudexor/schema 2.1.3 → 3.0.0

package/generated/ControlThreadDetail.schema.json

@@ -33,9 +33,7 @@
               "enum": [
                 "ask",
                 "plan",
-                "audit",
-                "agent",
-                "orchestrate"
+                "agent"
               ],
               "description": "Default mode for new turns."
             },
@@ -88,6 +86,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": [
@@ -303,25 +321,16 @@
                         "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."
                       },
                       "mode": {
                         "$ref": "#/definitions/ControlThreadDetail/properties/thread/properties/mode",
-                        "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": [
@@ -331,7 +340,7 @@
                               "race",
                               "attempts",
                               "until_clean",
-                              "swarm",
+                              "deep_scan",
                               "create"
                             ]
                           },
@@ -454,6 +463,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) for the turn; null while non-terminal.",
+                        "default": null
+                      },
                       "spendUsd": {
                         "type": [
                           "number",
@@ -539,6 +629,74 @@
                 "default": null,
                 "description": "Why this turn has no run (enqueue/preflight refusal); null once a run binds."
               },
+              "continuity": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "native_resume",
+                          "packet",
+                          "fresh"
+                        ],
+                        "description": "How a turn's lane was continued: native_resume (the lane's own vendor session already held the delta), packet (a continuation packet hydrated a lane switch/gap), or fresh (nothing to carry — the thread's first turn on any lane)."
+                      },
+                      "packetTurns": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "default": 0,
+                        "description": "Delta turns carried in the continuation packet (0 for native_resume/fresh)."
+                      },
+                      "summarized": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "True when the packet collapsed an older prefix (mechanical fallback)."
+                      },
+                      "laneSwitchedFrom": {
+                        "anyOf": [
+                          {
+                            "type": "object",
+                            "properties": {
+                              "harness": {
+                                "type": "string",
+                                "description": "Harness of the lane switched away from."
+                              },
+                              "profileId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ],
+                                "default": null,
+                                "description": "Profile of the lane switched away from (null = engine default)."
+                              }
+                            },
+                            "required": [
+                              "harness"
+                            ],
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "default": null,
+                        "description": "The lane this turn switched away from; null for an in-lane continuation."
+                      }
+                    },
+                    "required": [
+                      "kind"
+                    ],
+                    "additionalProperties": false
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "How this turn's lane was continued (native resume / packet / fresh); null until stamped."
+              },
               "createdAt": {
                 "type": "string",
                 "description": "When the turn was created."

package/generated/ControlThreadListResponse.schema.json

@@ -35,9 +35,7 @@
                 "enum": [
                   "ask",
                   "plan",
-                  "audit",
-                  "agent",
-                  "orchestrate"
+                  "agent"
                 ],
                 "description": "Default mode for new turns."
               },
@@ -90,6 +88,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": [
@@ -161,6 +179,45 @@
           },
           "default": [],
           "description": "All threads."
+        },
+        "problems": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "projectId": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "The registered project that was skipped."
+              },
+              "root": {
+                "type": "string",
+                "description": "The project root that could not be listed."
+              },
+              "code": {
+                "type": "string",
+                "enum": [
+                  "project_root_missing"
+                ],
+                "description": "Why skipped (root no longer exists)."
+              },
+              "message": {
+                "type": "string",
+                "description": "Human-readable disclosure of why it was skipped."
+              }
+            },
+            "required": [
+              "projectId",
+              "root",
+              "code",
+              "message"
+            ],
+            "additionalProperties": false,
+            "description": "A project skipped during thread listing, disclosed rather than failing it."
+          },
+          "default": [],
+          "description": "Projects skipped because their root is no longer usable (F2 disclosure)."
         }
       },
       "additionalProperties": false,

package/generated/ControlThreadTurnRequest.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"
         },
         "harnesses": {
@@ -152,14 +150,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": [
@@ -298,24 +300,34 @@
           },
           "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/ControlThreadTurnRequest/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."
-        },
         "planRunId": {
           "type": "string",
           "minLength": 1,
           "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/ControlThreadTurnRequest/properties/planRunId"
+            },
+            "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": {
@@ -340,10 +352,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",
@@ -366,19 +378,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",
@@ -403,6 +405,10 @@
           "type": "integer",
           "exclusiveMinimum": 0,
           "description": "Per-run turn cap (beats per-harness settings)."
+        },
+        "overridePlanReadiness": {
+          "type": "boolean",
+          "description": "Implement a not-ready plan anyway; recorded on the turn."
         }
       },
       "additionalProperties": false,

package/generated/ControlThreadUpdateRequest.schema.json

@@ -47,6 +47,25 @@
             "$ref": "#/definitions/ControlThreadUpdateRequest/properties/primaryHarness/anyOf/0"
           },
           "description": "New sticky eligible harness pool."
+        },
+        "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": "New sticky write scope; null clears back to the repo trust default."
         }
       },
       "additionalProperties": false,

package/generated/DecisionRecord.schema.json

@@ -17,36 +17,77 @@
           ],
           "description": "Winning attempt/candidate id; null when nothing won."
         },
-        "status": {
-          "type": "string",
-          "enum": [
-            "success",
-            "no_op",
-            "ungated",
-            "review_not_run",
-            "blocked",
-            "failed",
-            "interrupted_unknown",
-            "cost_unverifiable",
-            "exhausted_overshoot",
-            "exhausted",
-            "not_converged",
-            "stuck_no_progress",
-            "cancelled"
-          ],
-          "description": "Terminal status of a run, including truthful blocked, interrupted-unknown, cost-unverifiable, overshoot, exhaustion, non-convergence, failure, and cancellation outcomes."
-        },
-        "outcome": {
-          "type": "string",
-          "enum": [
-            "ready",
-            "no_op",
-            "ungated",
-            "review_not_run",
-            "blocked"
+        "facts": {
+          "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"
           ],
-          "description": "Arbitration outcome for the winning candidate: ready (verified applyable), no_op (no changes), ungated (no gates configured), review_not_run, or blocked.",
-          "default": "blocked"
+          "additionalProperties": false,
+          "description": "Independent terminal outcome axes of a run (D8/D18)."
         },
         "why_winner": {
           "type": "string",
@@ -115,10 +156,9 @@
             "apply",
             "inspect",
             "continue",
-            "split_task",
             "human_review"
           ],
-          "description": "Recommended next action for the run's work product: apply it, inspect first, continue working, split the task, or get human review.",
+          "description": "Recommended next action for the run's work product: apply it, inspect first, continue working, or get human review.",
           "default": "inspect"
         },
         "verification_basis": {
@@ -225,10 +265,10 @@
       },
       "required": [
         "winner",
-        "status"
+        "facts"
       ],
       "additionalProperties": false,
-      "description": "The arbitration decision for a run: winner, status/outcome, reasons, spend, and the verification that backs applyability."
+      "description": "The arbitration decision for a run: winner, outcome axes, reasons, spend, and the verification that backs applyability."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/GateResult.schema.json

@@ -29,10 +29,9 @@
           "enum": [
             "passed",
             "failed",
-            "skipped",
             "timed_out"
           ],
-          "description": "Outcome of a deterministic gate: passed, failed, skipped, or timed_out."
+          "description": "Outcome of a deterministic gate: passed, failed, or timed_out."
         },
         "duration_ms": {
           "type": "integer",