@claudexor/schema 1.0.1 → 2.1.1

package/generated/ControlRunRetryResponse.schema.json

@@ -0,0 +1,54 @@
+{
+  "$ref": "#/definitions/ControlRunRetryResponse",
+  "definitions": {
+    "ControlRunRetryResponse": {
+      "type": "object",
+      "properties": {
+        "retryOf": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "jobId": {
+          "$ref": "#/definitions/ControlRunRetryResponse/properties/retryOf"
+        },
+        "runId": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlRunRetryResponse/properties/retryOf"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Non-empty identifier string.",
+          "default": null
+        },
+        "turnId": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlRunRetryResponse/properties/retryOf"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Non-empty identifier string.",
+          "default": null
+        },
+        "state": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "retryOf",
+        "jobId",
+        "state"
+      ],
+      "additionalProperties": false,
+      "description": "Durable handle returned by Exact Retry for a fresh command attempt."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlRunStartRequest.schema.json

@@ -9,51 +9,28 @@
           "default": "",
           "description": "The user's prompt for the run."
         },
+        "instructions": {
+          "type": "string",
+          "description": "System-level instructions layered onto every task-producing lane; delivered natively (append-system-prompt / developer_instructions) or as a delimited prompt prefix."
+        },
         "attachments": {
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
-              "kind": {
-                "type": "string",
-                "enum": [
-                  "image",
-                  "file"
-                ],
-                "description": "Kind of attachment: image (vision input) or file (generic bytes).",
-                "default": "file"
-              },
-              "mime": {
-                "type": "string",
-                "default": "application/octet-stream",
-                "description": "MIME type of the attachment content."
-              },
-              "name": {
+              "resourceId": {
                 "type": "string",
-                "default": "",
-                "description": "Original file name for the attachment."
-              },
-              "data": {
-                "type": [
-                  "string",
-                  "null"
-                ],
-                "default": null,
-                "description": "Base64-inline attachment bytes for a fresh upload; null when path is used instead."
-              },
-              "path": {
-                "type": [
-                  "string",
-                  "null"
-                ],
-                "default": null,
-                "description": "Absolute existing file path to read bytes from; null when data is used instead."
+                "minLength": 1,
+                "description": "Immutable daemon resource id returned by upload finalize."
               }
             },
+            "required": [
+              "resourceId"
+            ],
             "additionalProperties": false,
-            "description": "Inbound attachment on a control request; exactly one of data (base64-inline) or path (absolute existing file) is expected, resolved by the daemon into a durable Attachment."
+            "description": "Reference to an immutable daemon-owned uploaded resource."
           },
-          "description": "Inbound files/images for this turn; the daemon resolves each to a scoped on-disk attachment before the run spec is built."
+          "description": "Immutable daemon resource ids returned by upload finalize; paths and inline bytes are not accepted."
         },
         "mode": {
           "type": "string",
@@ -126,7 +103,7 @@
                 "live"
               ],
               "default": "envelope",
-              "description": "Run isolation: envelope (isolated worktree under .claudexor/workspaces, the default) or live (the project tree itself)."
+              "description": "Run isolation: envelope (isolated worktree in the external per-project runtime namespace, the default) or live (the project tree itself)."
             }
           },
           "additionalProperties": false,
@@ -149,20 +126,14 @@
           "$ref": "#/definitions/ControlRunStartRequest/properties/harnesses/items",
           "description": "Primary harness the run should prefer."
         },
-        "portfolio": {
+        "routingGoal": {
           "type": "string",
           "enum": [
-            "daily-rich",
-            "balanced",
-            "cheapest",
-            "strongest",
-            "burn",
-            "subscription-first",
-            "api-overflow",
-            "conserve-claude",
-            "conserve-codex"
+            "auto",
+            "quality",
+            "economy"
           ],
-          "description": "Budget portfolio weighting the harness router's quality/cost/latency and subscription-vs-API preferences (e.g. cheapest minimizes spend, burn maximizes quality, conserve-* deprioritizes one vendor)."
+          "description": "Routing objective: pace expiring quota, choose the highest declared quality tier, or minimize incremental paid spend."
         },
         "model": {
           "$ref": "#/definitions/ControlRunStartRequest/properties/harnesses/items",
@@ -266,17 +237,41 @@
           ],
           "description": "Best-of-N synthesis policy: auto only synthesizes an extra candidate when n>=3 and candidates genuinely complement; always/never force it."
         },
-        "maxUsd": {
+        "paidBudget": {
           "anyOf": [
             {
-              "type": "number",
-              "minimum": 0
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "unlimited"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false
             },
             {
-              "type": "null"
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "finite"
+                },
+                "maxUsd": {
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "kind",
+                "maxUsd"
+              ],
+              "additionalProperties": false
             }
           ],
-          "description": "USD cap for the run; null = no cap."
+          "description": "Explicit incremental-cash budget for the run."
         },
         "access": {
           "type": "string",
@@ -305,14 +300,47 @@
         },
         "browser": {
           "type": "boolean",
-          "description": "Opt this run into the agent-driven browser; honored only for browser-capable harnesses when web policy is not off."
+          "description": "Request the agent-driven browser; preflight records per-lane effectiveness and refuses when no selected lane can receive it."
         },
         "tests": {
           "type": "array",
           "items": {
-            "$ref": "#/definitions/ControlRunStartRequest/properties/harnesses/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/ControlRunStartRequest/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": "Test commands to run as deterministic gates."
+          "description": "Typed-argv commands to run as deterministic gates."
         },
         "protectedPathApprovals": {
           "type": "array",
@@ -364,6 +392,10 @@
           "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
           "description": "Run this turn follows up on."
         },
+        "retryOf": {
+          "$ref": "#/definitions/ControlRunStartRequest/properties/threadId",
+          "description": "Server-owned Exact Retry lineage; direct POST /runs rejects it."
+        },
         "planRunId": {
           "$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."
@@ -406,6 +438,18 @@
           ],
           "description": "Per-run auth route override."
         },
+        "credentialProfileId": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "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": [
@@ -419,6 +463,30 @@
           "type": "integer",
           "exclusiveMinimum": 0,
           "description": "Cap on orchestrate plan tool calls; only meaningful for mode=orchestrate."
+        },
+        "maxSeconds": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 604800,
+          "description": "Hard wall-clock deadline for the whole run (seconds, from scheduler start, max 7 days); on expiry the run is cancelled with reason wall_clock_exceeded and partial artifacts are kept."
+        },
+        "denyPaths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Per-run globs no candidate may touch at all; envelope-only (in-place runs are refused), enforced by the engine post-diff gate, disclosed per lane via path_deny receipts. accept_risk may still deliver (INV-111)."
+        },
+        "outputSchema": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "JSON Schema for the run's final answer; mandatory (incapable lane => preflight refusal), engine-validated into final/output.json with a typed outputConformance receipt."
+        },
+        "maxTurns": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "Per-run turn cap (beats per-harness settings)."
         }
       },
       "additionalProperties": false,

package/generated/ControlRunStartResponse.schema.json

@@ -0,0 +1,78 @@
+{
+  "$ref": "#/definitions/ControlRunStartResponse",
+  "definitions": {
+    "ControlRunStartResponse": {
+      "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."
+            }
+          },
+          "required": [
+            "runId",
+            "runDir"
+          ],
+          "additionalProperties": false,
+          "description": "Response for a successfully enqueued run."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "jobId": {
+              "type": "string",
+              "description": "Daemon job id."
+            },
+            "state": {
+              "type": "string",
+              "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"
+              ],
+              "description": "Control-plane run state: queued/running while live, then an honest success, block, failure, interruption, cost, exhaustion, non-convergence, or cancellation terminal."
+            },
+            "error": {
+              "type": "string",
+              "description": "Error message, when the job failed."
+            }
+          },
+          "required": [
+            "jobId",
+            "state"
+          ],
+          "additionalProperties": false,
+          "description": "Compact state of a queued/running daemon job."
+        }
+      ],
+      "description": "Immediate or queued durable handle returned by POST /runs."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}