@claudexor/schema 1.0.1 → 2.1.1

package/generated/ControlRunDetail.schema.json

@@ -31,12 +31,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",
@@ -233,20 +235,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",
@@ -317,24 +313,220 @@
               "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": [
                 "number",
                 "null"
               ],
-              "description": "Settled spend in USD; null when unknown."
+              "description": "Settled cash in USD; null when unknown."
             },
             "spendEstimated": {
               "type": "boolean",
               "description": "True when spend is token-derived rather than natively reported."
             },
+            "inputTokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Input tokens summed across all attempts; null when no harness reported them."
+            },
+            "outputTokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Output tokens summed across all attempts; null when no harness reported them."
+            },
+            "cachedInputTokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Cached input tokens summed across all attempts; null when no harness reported them."
+            },
+            "outputConformance": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "passed",
+                    "failed"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Structured-output conformance receipt (passed/failed); null when the run had no outputSchema."
+            },
+            "authRoute": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "requested": {
+                      "type": "string",
+                      "enum": [
+                        "subscription",
+                        "api_key",
+                        "auto"
+                      ],
+                      "description": "Preferred auth route: subscription (native/OAuth session), api_key (a stored API key), or auto (engine picks subscription-first with policy fallback). A preference, not a secret."
+                    },
+                    "effective": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "local_session",
+                            "api_key",
+                            "unknown"
+                          ],
+                          "description": "Auth mode a route runs under: a native local session, an API key, or unknown."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Auth mode a route runs under: a native local session, an API key, or unknown.",
+                      "default": null
+                    },
+                    "source": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "native_session",
+                            "oauth_token_env",
+                            "api_key_env",
+                            "api_key_flag",
+                            "provider_auth_file",
+                            "none"
+                          ],
+                          "description": "Concrete credential source used or probed by a harness."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Concrete credential source used or probed by a harness.",
+                      "default": null
+                    },
+                    "reason": {
+                      "type": "string",
+                      "enum": [
+                        "as_requested",
+                        "native_first",
+                        "no_native_session_fallback",
+                        "requested_route_unavailable",
+                        "undisclosed"
+                      ],
+                      "description": "Deterministic reason for the effective auth route: as_requested, native_first (auto, INV-061), no_native_session_fallback (auto downgraded to api_key), requested_route_unavailable (explicit preference contradicted), or undisclosed."
+                    },
+                    "harnessId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null
+                    },
+                    "attemptId": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null
+                    },
+                    "modelMismatch": {
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "requested": {
+                              "type": "string"
+                            },
+                            "observed": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "requested",
+                            "observed"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null,
+                      "description": "Requested-vs-observed model mismatch; null when none."
+                    }
+                  },
+                  "required": [
+                    "requested",
+                    "reason"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Auth route receipt (requested/effective/source/reason + disclosing attempt), projected verbatim from telemetry; null when unavailable."
+            },
             "access": {
               "type": "string",
               "enum": [
@@ -454,6 +646,64 @@
               "description": "Web evidence projected onto a run summary from the telemetry artifact.",
               "default": {}
             },
+            "requestRequirements": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "capability": {
+                    "type": "string",
+                    "enum": [
+                      "browser",
+                      "path_deny"
+                    ]
+                  },
+                  "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",
+                      "postdiff_only"
+                    ]
+                  },
+                  "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": {},
@@ -567,6 +817,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,
@@ -630,9 +888,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/ControlRunDetail/properties/summary/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",
@@ -720,9 +1011,10 @@
                     "plan",
                     "summary",
                     "patch",
-                    "diagnostic"
+                    "diagnostic",
+                    "structured_output"
                   ],
-                  "description": "What kind of output this is: answer, report, plan, summary, patch, or diagnostic."
+                  "description": "What kind of output this is: answer, report, plan, summary, patch, diagnostic, or structured_output (schema-conformant final/output.json)."
                 },
                 "path": {
                   "type": "string",
@@ -853,13 +1145,12 @@
         "budget": {
           "type": "object",
           "properties": {
-            "maxUsd": {
-              "type": [
-                "number",
-                "null"
-              ],
-              "default": null,
-              "description": "USD cap for the run; null = no cap."
+            "paidBudget": {
+              "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/paidBudget",
+              "default": {
+                "kind": "unlimited"
+              },
+              "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap."
             },
             "spendUsd": {
               "type": [
@@ -867,7 +1158,7 @@
                 "null"
               ],
               "default": null,
-              "description": "Spend so far in USD; null when unknown."
+              "description": "CASH spend so far in USD; null when unknown."
             },
             "remainingUsd": {
               "type": [
@@ -932,13 +1223,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",
@@ -1678,6 +1972,51 @@
                         ],
                         "description": "Executor status of one plan step: pending, running, done, skipped, blocked (risky step awaiting a human), or failed."
                       },
+                      "required": {
+                        "type": "boolean",
+                        "default": true
+                      },
+                      "terminal_status": {
+                        "anyOf": [
+                          {
+                            "$ref": "#/definitions/ControlRunDetail/properties/decision/anyOf/0/properties/status"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Actual child/delivery terminal used by the parent outcome reducer.",
+                        "default": null
+                      },
+                      "terminal_source": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "executor",
+                              "subrun",
+                              "review",
+                              "delivery",
+                              "policy",
+                              "budget"
+                            ]
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "default": null,
+                        "description": "Authority that produced terminal_status."
+                      },
+                      "evidence_refs": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "default": [],
+                        "description": "Immutable run artifact or delivery receipt references."
+                      },
                       "run_id": {
                         "type": [
                           "string",