@claudexor/schema 1.0.1 → 2.1.1

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,24 +310,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": [
@@ -451,6 +643,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": {},
@@ -564,6 +814,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 +885,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#"
+}