@claudexor/schema 1.0.0 → 2.0.0

package/generated/ControlThreadTurnRequest.schema.json

@@ -0,0 +1,373 @@
+{
+  "$ref": "#/definitions/ControlThreadTurnRequest",
+  "definitions": {
+    "ControlThreadTurnRequest": {
+      "type": "object",
+      "properties": {
+        "prompt": {
+          "type": "string",
+          "default": "",
+          "description": "The user's prompt for the run."
+        },
+        "attachments": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "resourceId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Immutable daemon resource id returned by upload finalize."
+              }
+            },
+            "required": [
+              "resourceId"
+            ],
+            "additionalProperties": false,
+            "description": "Reference to an immutable daemon-owned uploaded resource."
+          },
+          "description": "Immutable daemon resource ids returned by upload finalize; paths and inline bytes are not accepted."
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "ask",
+            "plan",
+            "audit",
+            "agent",
+            "orchestrate"
+          ],
+          "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.",
+          "default": "agent"
+        },
+        "harnesses": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "\\S",
+            "description": "User-supplied string that must contain visible content, not just whitespace."
+          },
+          "description": "Eligible harness pool for the run; omitted = engine auto-pools."
+        },
+        "primaryHarness": {
+          "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items",
+          "description": "Primary harness the run should prefer."
+        },
+        "routingGoal": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "quality",
+            "economy"
+          ],
+          "description": "Routing objective: pace expiring quota, choose the highest declared quality tier, or minimize incremental paid spend."
+        },
+        "model": {
+          "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items",
+          "description": "Scalar model convenience: expands to the resolved primary harness only (never the pool); rejected with a multi-harness pool and no primary — use models instead."
+        },
+        "models": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items"
+          },
+          "propertyNames": {
+            "minLength": 1,
+            "pattern": "\\S"
+          },
+          "description": "Harness-scoped model map (harness id to model id); an entry here wins over the scalar model and over the per-harness settings default."
+        },
+        "effort": {
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "xhigh",
+            "max"
+          ],
+          "description": "Requested reasoning effort."
+        },
+        "reviewerModels": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items"
+          },
+          "propertyNames": {
+            "enum": [
+              "openai",
+              "anthropic",
+              "google",
+              "cursor",
+              "opencode",
+              "xai",
+              "local",
+              "unknown"
+            ]
+          },
+          "description": "Per-provider-family reviewer model overrides (legacy; reviewerPanel wins when present)."
+        },
+        "reviewerEfforts": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ControlThreadTurnRequest/properties/effort"
+          },
+          "propertyNames": {
+            "enum": [
+              "openai",
+              "anthropic",
+              "google",
+              "cursor",
+              "opencode",
+              "xai",
+              "local",
+              "unknown"
+            ]
+          },
+          "description": "Per-provider-family reviewer effort overrides (legacy; reviewerPanel wins when present)."
+        },
+        "n": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "Race width: number of best-of-N candidates."
+        },
+        "attempts": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Cap on convergence attempts; null = engine default."
+        },
+        "untilClean": {
+          "type": "boolean",
+          "description": "Agent flag: iterate until the convergence predicate is clean (no fixed cap)."
+        },
+        "swarm": {
+          "type": "boolean",
+          "description": "Audit flag: bounded read-only research swarm."
+        },
+        "create": {
+          "type": "boolean",
+          "description": "Agent flag: create-from-scratch intent."
+        },
+        "synthesis": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "always",
+            "never"
+          ],
+          "description": "Best-of-N synthesis policy: auto only synthesizes an extra candidate when n>=3 and candidates genuinely complement; always/never force it."
+        },
+        "paidBudget": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "unlimited"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "finite"
+                },
+                "maxUsd": {
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "kind",
+                "maxUsd"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "Explicit incremental-cash budget for the run."
+        },
+        "access": {
+          "type": "string",
+          "enum": [
+            "readonly",
+            "workspace_write",
+            "full",
+            "external_sandbox_full",
+            "inherit_native"
+          ],
+          "description": "Requested access profile; effective access is derived by the engine and never client-supplied."
+        },
+        "web": {
+          "type": "string",
+          "enum": [
+            "off",
+            "auto",
+            "cached",
+            "live"
+          ],
+          "description": "Web policy for the run (alias of externalContextPolicy; must match when both set)."
+        },
+        "externalContextPolicy": {
+          "$ref": "#/definitions/ControlThreadTurnRequest/properties/web",
+          "description": "External web/context policy for the run."
+        },
+        "browser": {
+          "type": "boolean",
+          "description": "Request the agent-driven browser; preflight records per-lane effectiveness and refuses when no selected lane can receive it."
+        },
+        "tests": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "program": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "Executable invoked directly without an implicit shell."
+              },
+              "args": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [],
+                "description": "Exact argv passed to the executable."
+              },
+              "cwd": {
+                "type": "string",
+                "description": "Optional project-relative working directory for the command."
+              },
+              "envAllowlist": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items"
+                },
+                "default": [],
+                "description": "Non-secret parent environment names explicitly forwarded to the command."
+              }
+            },
+            "required": [
+              "program"
+            ],
+            "additionalProperties": false,
+            "description": "Canonical deterministic command invocation; no implicit shell parsing."
+          },
+          "description": "Typed-argv commands to run as deterministic gates."
+        },
+        "protectedPathApprovals": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "Glob approved by the operator/user for this run; consumed only by the auto-protected gate/test path policy, not by built-in critical-path gates."
+              },
+              "reason": {
+                "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items",
+                "description": "Optional human-readable reason for the approval."
+              }
+            },
+            "required": [
+              "path"
+            ],
+            "additionalProperties": false,
+            "description": "Per-run typed operator approval allowing changes under an auto-protected gate/test path."
+          },
+          "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."
+        },
+        "reviewerPanel": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "harness": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "Explicit reviewer harness id; repeated harness ids are allowed so one provider can review through multiple requested models."
+              },
+              "model": {
+                "$ref": "#/definitions/ControlThreadTurnRequest/properties/harnesses/items",
+                "description": "Per-reviewer model hint, passed to that harness only."
+              },
+              "effort": {
+                "$ref": "#/definitions/ControlThreadTurnRequest/properties/effort",
+                "description": "Per-reviewer effort hint, passed to that harness only."
+              }
+            },
+            "required": [
+              "harness"
+            ],
+            "additionalProperties": false,
+            "description": "One reviewer of an explicit reviewer panel."
+          },
+          "minItems": 1,
+          "description": "Explicit reviewer panel; overrides the legacy reviewerModels/reviewerEfforts maps and preserves duplicate harness entries for multi-model same-provider reviews."
+        },
+        "authPreference": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "Per-run auth route override."
+        },
+        "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."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Client-settable thread-turn request; scope, execution and lineage are server-owned."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThreadTurnResponse.schema.json

@@ -0,0 +1,73 @@
+{
+  "$ref": "#/definitions/ControlThreadTurnResponse",
+  "definitions": {
+    "ControlThreadTurnResponse": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "jobId": {
+              "type": "string",
+              "description": "Daemon job id backing the run."
+            },
+            "runId": {
+              "type": "string",
+              "description": "Run id."
+            },
+            "taskId": {
+              "type": "string",
+              "description": "Task id, when already allocated."
+            },
+            "runDir": {
+              "type": "string",
+              "description": "On-disk run artifact directory."
+            },
+            "threadId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Non-empty identifier string."
+            },
+            "turnId": {
+              "$ref": "#/definitions/ControlThreadTurnResponse/anyOf/0/properties/threadId"
+            }
+          },
+          "required": [
+            "runId",
+            "runDir",
+            "threadId",
+            "turnId"
+          ],
+          "additionalProperties": false,
+          "description": "Response for a successfully enqueued run."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "jobId": {
+              "$ref": "#/definitions/ControlThreadTurnResponse/anyOf/0/properties/threadId"
+            },
+            "threadId": {
+              "$ref": "#/definitions/ControlThreadTurnResponse/anyOf/0/properties/threadId"
+            },
+            "turnId": {
+              "$ref": "#/definitions/ControlThreadTurnResponse/anyOf/0/properties/threadId"
+            },
+            "state": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "jobId",
+            "threadId",
+            "turnId",
+            "state"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "description": "Durable handle returned by thread turn create or Exact Retry."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThreadUpdateRequest.schema.json

@@ -14,7 +14,7 @@
             "active",
             "closed"
           ],
-          "description": "New thread state (active/closed)."
+          "description": "New open/archive state."
         },
         "primaryHarness": {
           "anyOf": [

package/generated/ControlTrustListResponse.schema.json

@@ -34,6 +34,12 @@
                   "inherit_native"
                 ],
                 "description": "Default access profile for runs in the repo."
+              },
+              "testCommandGrantCount": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Number of exact external test-command grants for this repo."
               }
             },
             "required": [

package/generated/ControlTrustState.schema.json

@@ -29,6 +29,12 @@
             "inherit_native"
           ],
           "description": "Default access profile for runs in the repo."
+        },
+        "testCommandGrantCount": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Number of exact external test-command grants for this repo."
         }
       },
       "required": [

package/generated/ControlTrustUpdateRequest.schema.json

@@ -12,14 +12,76 @@
         "allowFullAccess": {
           "type": "boolean",
           "description": "Grant (true) or revoke (false) unsandboxed full access for the repo."
+        },
+        "accessDefault": {
+          "type": "string",
+          "enum": [
+            "readonly",
+            "workspace_write"
+          ],
+          "description": "Default access profile for runs in the repo."
+        },
+        "grantTestCommand": {
+          "type": "object",
+          "properties": {
+            "program": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "\\S",
+              "description": "Executable invoked directly without an implicit shell."
+            },
+            "args": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Exact argv passed to the executable."
+            },
+            "cwd": {
+              "type": "string",
+              "description": "Optional project-relative working directory for the command."
+            },
+            "envAllowlist": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "User-supplied string that must contain visible content, not just whitespace."
+              },
+              "default": [],
+              "description": "Non-secret parent environment names explicitly forwarded to the command."
+            }
+          },
+          "required": [
+            "program"
+          ],
+          "additionalProperties": false,
+          "description": "Typed command to grant against the current project config and executable/script bytes."
+        },
+        "grantAccessProfile": {
+          "type": "string",
+          "enum": [
+            "readonly",
+            "workspace_write",
+            "full",
+            "external_sandbox_full",
+            "inherit_native"
+          ],
+          "description": "Effective access profile covered by grantTestCommand; defaults to the trust default."
+        },
+        "revokeTestCommandDigest": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Revoke grants for this canonical command digest."
         }
       },
       "required": [
-        "repoRoot",
-        "allowFullAccess"
+        "repoRoot"
       ],
       "additionalProperties": false,
-      "description": "Narrow trust update — the only trust field the control API exposes: grant or revoke unsandboxed full access for one repo in the user-level trust file."
+      "description": "User-level trust update: grant/revoke full access and/or set the readonly/workspace-write default."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/ControlUploadCreateRequest.schema.json

@@ -0,0 +1,37 @@
+{
+  "$ref": "#/definitions/ControlUploadCreateRequest",
+  "definitions": {
+    "ControlUploadCreateRequest": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "image",
+            "file"
+          ],
+          "description": "Kind of attached resource: image input or generic file bytes."
+        },
+        "mime": {
+          "type": "string",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "default": ""
+        },
+        "sizeBytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "kind",
+        "mime",
+        "sizeBytes"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlUploadFinalizeRequest.schema.json

@@ -0,0 +1,17 @@
+{
+  "$ref": "#/definitions/ControlUploadFinalizeRequest",
+  "definitions": {
+    "ControlUploadFinalizeRequest": {
+      "type": "object",
+      "properties": {
+        "expectedSha256": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlUploadStatus.schema.json

@@ -0,0 +1,40 @@
+{
+  "$ref": "#/definitions/ControlUploadStatus",
+  "definitions": {
+    "ControlUploadStatus": {
+      "type": "object",
+      "properties": {
+        "uploadId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "open",
+            "uploading",
+            "uploaded",
+            "cancelled"
+          ]
+        },
+        "receivedBytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "expectedBytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "uploadId",
+        "state",
+        "receivedBytes",
+        "expectedBytes"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/DecisionRecord.schema.json

@@ -25,13 +25,16 @@
             "ungated",
             "review_not_run",
             "blocked",
-            "not_converged",
-            "stuck_no_progress",
             "failed",
+            "interrupted_unknown",
+            "cost_unverifiable",
+            "exhausted_overshoot",
             "exhausted",
+            "not_converged",
+            "stuck_no_progress",
             "cancelled"
           ],
-          "description": "Terminal status of a run: success, no_op (nothing to change), ungated (no gates configured), review_not_run, blocked (accepted blocking findings), not_converged, stuck_no_progress, failed, exhausted (attempt/budget caps), or 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",