@claudexor/schema 1.0.1 → 2.0.0

package/generated/ControlRunAgainDraft.schema.json

@@ -0,0 +1,499 @@
+{
+  "$ref": "#/definitions/ControlRunAgainDraft",
+  "definitions": {
+    "ControlRunAgainDraft": {
+      "type": "object",
+      "properties": {
+        "sourceRunId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "request": {
+          "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"
+            },
+            "scope": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "project"
+                    },
+                    "root": {
+                      "type": "string",
+                      "description": "Absolute path of the project root."
+                    },
+                    "context": {
+                      "type": "string",
+                      "enum": [
+                        "auto"
+                      ],
+                      "description": "Project context depth; auto is the only mode.",
+                      "default": "auto"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "root"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Run anchored to a project."
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "none"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Run with no project (pure ask)."
+                }
+              ],
+              "description": "What the run operates on: a project (with root) or nothing.",
+              "default": {
+                "kind": "none"
+              }
+            },
+            "execution": {
+              "type": "object",
+              "properties": {
+                "isolation": {
+                  "type": "string",
+                  "enum": [
+                    "envelope",
+                    "live"
+                  ],
+                  "default": "envelope",
+                  "description": "Run isolation: envelope (isolated worktree in the external per-project runtime namespace, the default) or live (the project tree itself)."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Execution isolation settings for a run.",
+              "default": {
+                "isolation": "envelope"
+              }
+            },
+            "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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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/ControlRunAgainDraft/properties/request/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": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "description": "Thread this run is a turn of."
+            },
+            "turnId": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "description": "Internal daemon handoff only; rejected (400) when supplied by a client on POST /runs — use POST /threads/:id/turns instead."
+            },
+            "parentRunId": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "description": "Run this turn follows up on."
+            },
+            "retryOf": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "description": "Server-owned Exact Retry lineage; direct POST /runs rejects it."
+            },
+            "planRunId": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "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/ControlRunAgainDraft/properties/request/properties/harnesses/items",
+                    "description": "Per-reviewer model hint, passed to that harness only."
+                  },
+                  "effort": {
+                    "$ref": "#/definitions/ControlRunAgainDraft/properties/request/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": "Request body for POST /runs: prompt, mode, scope, routing, strategy flags, budget, policies, and spec/thread linkage."
+        },
+        "differences": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "field": {
+                "type": "string",
+                "minLength": 1
+              },
+              "change": {
+                "type": "string",
+                "const": "omitted"
+              },
+              "reason": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "field",
+              "change",
+              "reason"
+            ],
+            "additionalProperties": false
+          },
+          "default": []
+        }
+      },
+      "required": [
+        "sourceRunId",
+        "request"
+      ],
+      "additionalProperties": false,
+      "description": "Editable Run Again draft copied from a prior run with explicit omissions."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}