@claudexor/schema 1.0.1 → 2.0.0

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

@@ -14,46 +14,19 @@
           "items": {
             "type": "object",
             "properties": {
-              "kind": {
+              "resourceId": {
                 "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": {
-                "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 +99,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 +122,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 +233,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 +296,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 +388,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."

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#"
+}

package/generated/ControlRunSummary.schema.json

@@ -28,12 +28,14 @@
             "review_not_run",
             "failed",
             "cancelled",
-            "interrupted",
+            "interrupted_unknown",
+            "cost_unverifiable",
+            "exhausted_overshoot",
             "exhausted",
             "not_converged",
             "stuck_no_progress"
           ],
-          "description": "Control-plane run state: queued/running while live; blocked awaiting a human; then a terminal outcome (succeeded, no_op, ungated, review_not_run, failed, cancelled, interrupted, 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."
         },
         "runDir": {
           "type": "string",
@@ -230,20 +232,14 @@
           "type": "string",
           "description": "Primary harness the run preferred."
         },
-        "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": {
           "type": "string",
@@ -314,12 +310,41 @@
           "type": "integer",
           "description": "Race width, when the run was a race."
         },
-        "maxUsd": {
-          "type": [
-            "number",
-            "null"
+        "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": "USD cap for the run; null = no cap."
+          "description": "Explicit incremental-cash budget for the run."
         },
         "spendUsd": {
           "type": [
@@ -451,6 +476,60 @@
           "description": "Web evidence projected onto a run summary from the telemetry artifact.",
           "default": {}
         },
+        "requestRequirements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "capability": {
+                "type": "string",
+                "const": "browser"
+              },
+              "harness_id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "eligible": {
+                "type": "boolean"
+              },
+              "requested": {
+                "type": "boolean"
+              },
+              "effective": {
+                "type": "boolean"
+              },
+              "reason": {
+                "type": "string",
+                "enum": [
+                  "not_requested",
+                  "effective",
+                  "manifest_unsupported",
+                  "web_policy_off",
+                  "access_profile_incompatible"
+                ]
+              },
+              "evidence_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": []
+              }
+            },
+            "required": [
+              "capability",
+              "harness_id",
+              "eligible",
+              "requested",
+              "effective",
+              "reason"
+            ],
+            "additionalProperties": false,
+            "description": "Preflight resolution of one requested capability on one selected harness lane."
+          },
+          "default": [],
+          "description": "Engine-computed requested/effective capability receipts for selected harness lanes."
+        },
         "toolPermissionPolicy": {
           "type": "object",
           "additionalProperties": {},
@@ -564,6 +643,14 @@
               "default": null,
               "description": "Tree SHA right after this turn's mutation; revert refuses if the working tree has diverged from this since."
             },
+            "revertAnchorId": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "GC-independent revert anchor."
+            },
             "revertable": {
               "type": "boolean",
               "default": false,
@@ -627,9 +714,42 @@
         "tests": {
           "type": "array",
           "items": {
-            "type": "string"
+            "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/ControlRunSummary/properties/reviewerPanel/items/properties/model"
+                },
+                "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 configured as gates."
+          "description": "Typed argv gates."
         },
         "specId": {
           "type": "string",

package/generated/ControlSecretListResponse.schema.json

@@ -6,11 +6,8 @@
       "properties": {
         "backend": {
           "type": "string",
-          "enum": [
-            "keychain",
-            "file"
-          ],
-          "description": "Active secret store backend."
+          "const": "file",
+          "description": "Active Claudexor v2 file secret store."
         },
         "secrets": {
           "type": "array",
@@ -23,16 +20,13 @@
               },
               "backend": {
                 "type": "string",
-                "enum": [
-                  "keychain",
-                  "file"
-                ],
-                "description": "Where the secret is stored: the OS keychain or a file store."
+                "const": "file",
+                "description": "Claudexor v2 file secret store."
               },
               "present": {
                 "type": "boolean",
                 "default": true,
-                "description": "Whether a value is actually stored."
+                "description": "Whether a value is stored."
               }
             },
             "required": [
@@ -40,17 +34,17 @@
               "backend"
             ],
             "additionalProperties": false,
-            "description": "Secret list row: name, storage backend, and presence — never the value."
+            "description": "Secret metadata; never the value."
           },
           "default": [],
-          "description": "Stored secrets (metadata only, never values)."
+          "description": "Stored secret metadata."
         }
       },
       "required": [
         "backend"
       ],
       "additionalProperties": false,
-      "description": "Response for listing stored secrets (metadata only)."
+      "description": "Metadata-only response for listing stored secrets."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/ControlSecretMutationResponse.schema.json

@@ -0,0 +1,32 @@
+{
+  "$ref": "#/definitions/ControlSecretMutationResponse",
+  "definitions": {
+    "ControlSecretMutationResponse": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "backend": {
+          "type": "string",
+          "const": "file"
+        },
+        "stored": {
+          "type": "boolean"
+        },
+        "deleted": {
+          "type": "boolean"
+        },
+        "warning": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false,
+      "description": "Managed-secret mutation receipt; never contains the value."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSecretSetRequest.schema.json

@@ -0,0 +1,27 @@
+{
+  "$ref": "#/definitions/ControlSecretSetRequest",
+  "definitions": {
+    "ControlSecretSetRequest": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Managed secret reference name."
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Value accepted only by the non-journaled secret route."
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ],
+      "additionalProperties": false,
+      "description": "Write one managed secret through the daemon-owned store."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}