@claudexor/schema 3.0.4 → 3.1.1

package/generated/ControlRunListResponse.schema.json

@@ -59,6 +59,7 @@
                           "auth",
                           "harness_unavailable",
                           "harness_error",
+                          "config_error",
                           "budget",
                           "policy",
                           "cancelled",
@@ -66,7 +67,28 @@
                           "unknown"
                         ],
                         "default": "unknown",
-                        "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+                        "description": "Typed failure category (validation, project, auth, harness, config, budget, policy, cancelled, internal, unknown). config_error is a settings/routing misconfiguration (e.g. quality routing with no comparable tier), corrected by changing configuration, not by re-auth or waiting for a harness."
+                      },
+                      "code": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "finite_zero",
+                              "hard_cap",
+                              "estimate_headroom",
+                              "unknown_paid_in_flight",
+                              "budget_overshoot",
+                              "cost_unverifiable"
+                            ],
+                            "description": "Machine-readable failure sub-code within a RunFailure category (today the typed budget-denial reasons produced by the budget ledger)."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Machine-readable failure sub-code within the category (today the typed budget-denial reason from the ledger); null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                        "default": null
                       },
                       "harnessId": {
                         "type": [
@@ -258,13 +280,9 @@
                     },
                     "effort": {
                       "type": "string",
-                      "enum": [
-                        "low",
-                        "medium",
-                        "high",
-                        "xhigh",
-                        "max"
-                      ],
+                      "minLength": 1,
+                      "maxLength": 32,
+                      "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
                       "description": "Per-reviewer effort hint, passed to that harness only."
                     }
                   },
@@ -882,7 +900,11 @@
                               "stuck_no_progress",
                               "wall_clock_exceeded",
                               "user_cancelled",
-                              "crash_interrupted"
+                              "crash_interrupted",
+                              "input_required",
+                              "work_incomplete",
+                              "context_capacity_exhausted",
+                              "work_report_contract"
                             ],
                             "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
                           },
@@ -892,6 +914,82 @@
                         ],
                         "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
                         "default": null
+                      },
+                      "work_state": {
+                        "type": "object",
+                        "properties": {
+                          "state": {
+                            "type": "string",
+                            "enum": [
+                              "completed",
+                              "needs_input",
+                              "incomplete",
+                              "unverified"
+                            ],
+                            "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                          },
+                          "source": {
+                            "type": "string",
+                            "enum": [
+                              "constrained",
+                              "validated",
+                              "absent"
+                            ],
+                            "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                          },
+                          "required_inputs": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "enum": [
+                                    "file",
+                                    "context",
+                                    "credential",
+                                    "permission",
+                                    "decision",
+                                    "external_dependency"
+                                  ],
+                                  "description": "Category of a missing input a needs_input/incomplete report lists: a file, additional context, a credential, a permission, a human decision, or an external dependency."
+                                },
+                                "locator": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string",
+                                      "maxLength": 512
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "default": null,
+                                  "description": "Concrete pointer to the missing thing (path/url/name); null when unnameable."
+                                },
+                                "description": {
+                                  "type": "string",
+                                  "maxLength": 1024,
+                                  "description": "Human-readable description of what is needed and why."
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "description"
+                              ],
+                              "additionalProperties": false,
+                              "description": "One blocking input a needs_input/incomplete WorkReport lists."
+                            },
+                            "maxItems": 16,
+                            "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                          }
+                        },
+                        "required": [
+                          "state",
+                          "source"
+                        ],
+                        "additionalProperties": false,
+                        "description": "D-16 model-attested work outcome, orthogonal to lifecycle; a needs_input/incomplete state vetoes applyability and exit 0. Absent on runs with no work_report transport."
                       }
                     },
                     "required": [
@@ -957,6 +1055,117 @@
                 "description": "Route evidence from telemetry; null when no telemetry exists (legacy runs).",
                 "default": null
               },
+              "routingRationale": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "goal": {
+                        "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/routingGoal"
+                      },
+                      "paid_fallback": {
+                        "type": "string",
+                        "enum": [
+                          "never",
+                          "when_unavailable",
+                          "allowed_within_cap"
+                        ],
+                        "description": "When a route with incremental paid spend may be used."
+                      },
+                      "order": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Non-empty identifier string."
+                        },
+                        "default": [],
+                        "description": "Final ranked order, harness ids."
+                      },
+                      "dropped": {
+                        "type": "array",
+                        "items": {
+                          "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/routingRationale/anyOf/0/properties/order/items"
+                        },
+                        "default": [],
+                        "description": "Ids removed by paid_fallback or cooldown before ranking."
+                      },
+                      "reason": {
+                        "type": "string",
+                        "enum": [
+                          "subscription_entitlement_first",
+                          "lowest_incremental_cash",
+                          "quality_tier",
+                          "expiring_quota_slack",
+                          "all_incremental_cash_unknown",
+                          "declared_order"
+                        ],
+                        "description": "Typed decisive reason the pool ranked the way it did (QA-034)."
+                      },
+                      "entries": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "harness_id": {
+                              "type": "string",
+                              "minLength": 1,
+                              "description": "Candidate harness id."
+                            },
+                            "billing_knowledge": {
+                              "type": "string",
+                              "enum": [
+                                "proven_zero",
+                                "subscription_entitlement",
+                                "metered",
+                                "unknown"
+                              ],
+                              "description": "Effective billing knowledge used to rank it."
+                            },
+                            "incremental_cost_usd": {
+                              "anyOf": [
+                                {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "default": null,
+                              "description": "Known incremental cash cost, when any; null when unknown."
+                            },
+                            "eligible": {
+                              "type": "boolean",
+                              "description": "Whether the candidate survived paid_fallback/cooldown filtering."
+                            }
+                          },
+                          "required": [
+                            "harness_id",
+                            "billing_knowledge",
+                            "eligible"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Per-candidate billing/cost tuple in the routing rationale (QA-034)."
+                        },
+                        "default": []
+                      }
+                    },
+                    "required": [
+                      "goal",
+                      "paid_fallback",
+                      "reason"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Typed routing rationale recorded once at pool ordering (QA-034)."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Typed routing rationale (QA-034) projected from telemetry; null when no ranking was computed or on legacy runs.",
+                "default": null
+              },
               "tests": {
                 "type": "array",
                 "items": {
@@ -1019,10 +1228,23 @@
             "description": "Run summary row served by GET /runs and embedded in run detail: state, routing, budget, policies, and honest outcome."
           },
           "default": []
+        },
+        "nextCursor": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Opaque keyset cursor for the next (older) page under the current filter; null on the final page. Pass verbatim as the `cursor` query param."
+        },
+        "hasMore": {
+          "type": "boolean",
+          "default": false,
+          "description": "True when more matching runs exist beyond this page."
         }
       },
       "additionalProperties": false,
-      "description": "All durable run summaries visible to the daemon."
+      "description": "A bounded, newest-first, keyset-paginated page of durable run summaries visible to the daemon (QA-052)."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/ControlRunStartRequest.schema.json

@@ -150,15 +150,22 @@
         },
         "effort": {
           "type": "string",
-          "enum": [
-            "low",
-            "medium",
-            "high",
-            "xhigh",
-            "max"
-          ],
+          "minLength": 1,
+          "maxLength": 32,
+          "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
           "description": "Requested reasoning effort."
         },
+        "efforts": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ControlRunStartRequest/properties/effort"
+          },
+          "propertyNames": {
+            "minLength": 1,
+            "pattern": "\\S"
+          },
+          "description": "Harness-scoped effort map (harness id to effort); an entry here wins over the scalar effort and the per-harness settings default."
+        },
         "reviewerModels": {
           "type": "object",
           "additionalProperties": {

package/generated/ControlRunSummary.schema.json

@@ -54,6 +54,7 @@
                     "auth",
                     "harness_unavailable",
                     "harness_error",
+                    "config_error",
                     "budget",
                     "policy",
                     "cancelled",
@@ -61,7 +62,28 @@
                     "unknown"
                   ],
                   "default": "unknown",
-                  "description": "Typed failure category (validation, project, auth, harness, budget, policy, cancelled, internal, unknown)."
+                  "description": "Typed failure category (validation, project, auth, harness, config, budget, policy, cancelled, internal, unknown). config_error is a settings/routing misconfiguration (e.g. quality routing with no comparable tier), corrected by changing configuration, not by re-auth or waiting for a harness."
+                },
+                "code": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "finite_zero",
+                        "hard_cap",
+                        "estimate_headroom",
+                        "unknown_paid_in_flight",
+                        "budget_overshoot",
+                        "cost_unverifiable"
+                      ],
+                      "description": "Machine-readable failure sub-code within a RunFailure category (today the typed budget-denial reasons produced by the budget ledger)."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Machine-readable failure sub-code within the category (today the typed budget-denial reason from the ledger); null when the category alone is sufficient. Surfaces choose remediation from this, never by parsing safeMessage.",
+                  "default": null
                 },
                 "harnessId": {
                   "type": [
@@ -253,13 +275,9 @@
               },
               "effort": {
                 "type": "string",
-                "enum": [
-                  "low",
-                  "medium",
-                  "high",
-                  "xhigh",
-                  "max"
-                ],
+                "minLength": 1,
+                "maxLength": 32,
+                "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
                 "description": "Per-reviewer effort hint, passed to that harness only."
               }
             },
@@ -877,7 +895,11 @@
                         "stuck_no_progress",
                         "wall_clock_exceeded",
                         "user_cancelled",
-                        "crash_interrupted"
+                        "crash_interrupted",
+                        "input_required",
+                        "work_incomplete",
+                        "context_capacity_exhausted",
+                        "work_report_contract"
                       ],
                       "description": "Typed reason qualifying a non-clean terminal; null on a clean success."
                     },
@@ -887,6 +909,82 @@
                   ],
                   "description": "Typed reason qualifying a non-clean terminal; null on a clean success.",
                   "default": null
+                },
+                "work_state": {
+                  "type": "object",
+                  "properties": {
+                    "state": {
+                      "type": "string",
+                      "enum": [
+                        "completed",
+                        "needs_input",
+                        "incomplete",
+                        "unverified"
+                      ],
+                      "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                    },
+                    "source": {
+                      "type": "string",
+                      "enum": [
+                        "constrained",
+                        "validated",
+                        "absent"
+                      ],
+                      "description": "Provenance of a WorkReport: constrained (native schema transport), validated (whole-answer JSON), or absent (no transport could carry one — a disclosed absence, not a failure)."
+                    },
+                    "required_inputs": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "enum": [
+                              "file",
+                              "context",
+                              "credential",
+                              "permission",
+                              "decision",
+                              "external_dependency"
+                            ],
+                            "description": "Category of a missing input a needs_input/incomplete report lists: a file, additional context, a credential, a permission, a human decision, or an external dependency."
+                          },
+                          "locator": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "maxLength": 512
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "default": null,
+                            "description": "Concrete pointer to the missing thing (path/url/name); null when unnameable."
+                          },
+                          "description": {
+                            "type": "string",
+                            "maxLength": 1024,
+                            "description": "Human-readable description of what is needed and why."
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "description"
+                        ],
+                        "additionalProperties": false,
+                        "description": "One blocking input a needs_input/incomplete WorkReport lists."
+                      },
+                      "maxItems": 16,
+                      "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "source"
+                  ],
+                  "additionalProperties": false,
+                  "description": "D-16 model-attested work outcome, orthogonal to lifecycle; a needs_input/incomplete state vetoes applyability and exit 0. Absent on runs with no work_report transport."
                 }
               },
               "required": [
@@ -952,6 +1050,117 @@
           "description": "Route evidence from telemetry; null when no telemetry exists (legacy runs).",
           "default": null
         },
+        "routingRationale": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "goal": {
+                  "$ref": "#/definitions/ControlRunSummary/properties/routingGoal"
+                },
+                "paid_fallback": {
+                  "type": "string",
+                  "enum": [
+                    "never",
+                    "when_unavailable",
+                    "allowed_within_cap"
+                  ],
+                  "description": "When a route with incremental paid spend may be used."
+                },
+                "order": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Non-empty identifier string."
+                  },
+                  "default": [],
+                  "description": "Final ranked order, harness ids."
+                },
+                "dropped": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/ControlRunSummary/properties/routingRationale/anyOf/0/properties/order/items"
+                  },
+                  "default": [],
+                  "description": "Ids removed by paid_fallback or cooldown before ranking."
+                },
+                "reason": {
+                  "type": "string",
+                  "enum": [
+                    "subscription_entitlement_first",
+                    "lowest_incremental_cash",
+                    "quality_tier",
+                    "expiring_quota_slack",
+                    "all_incremental_cash_unknown",
+                    "declared_order"
+                  ],
+                  "description": "Typed decisive reason the pool ranked the way it did (QA-034)."
+                },
+                "entries": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harness_id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Candidate harness id."
+                      },
+                      "billing_knowledge": {
+                        "type": "string",
+                        "enum": [
+                          "proven_zero",
+                          "subscription_entitlement",
+                          "metered",
+                          "unknown"
+                        ],
+                        "description": "Effective billing knowledge used to rank it."
+                      },
+                      "incremental_cost_usd": {
+                        "anyOf": [
+                          {
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "default": null,
+                        "description": "Known incremental cash cost, when any; null when unknown."
+                      },
+                      "eligible": {
+                        "type": "boolean",
+                        "description": "Whether the candidate survived paid_fallback/cooldown filtering."
+                      }
+                    },
+                    "required": [
+                      "harness_id",
+                      "billing_knowledge",
+                      "eligible"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Per-candidate billing/cost tuple in the routing rationale (QA-034)."
+                  },
+                  "default": []
+                }
+              },
+              "required": [
+                "goal",
+                "paid_fallback",
+                "reason"
+              ],
+              "additionalProperties": false,
+              "description": "Typed routing rationale recorded once at pool ordering (QA-034)."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Typed routing rationale (QA-034) projected from telemetry; null when no ranking was computed or on legacy runs.",
+          "default": null
+        },
         "tests": {
           "type": "array",
           "items": {

package/generated/ControlSettingsSnapshot.schema.json

@@ -96,14 +96,10 @@
                       },
                       "effort": {
                         "type": "string",
-                        "enum": [
-                          "low",
-                          "medium",
-                          "high",
-                          "xhigh",
-                          "max"
-                        ],
-                        "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                        "minLength": 1,
+                        "maxLength": 32,
+                        "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                        "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                       }
                     },
                     "required": [

package/generated/ControlSettingsUpdateRequest.schema.json

@@ -42,14 +42,10 @@
                   },
                   "effort": {
                     "type": "string",
-                    "enum": [
-                      "low",
-                      "medium",
-                      "high",
-                      "xhigh",
-                      "max"
-                    ],
-                    "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+                    "minLength": 1,
+                    "maxLength": 32,
+                    "pattern": "^[a-z0-9]+(?:[_-][a-z0-9]+)*$",
+                    "description": "Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen."
                   }
                 },
                 "required": [

package/generated/ControlSetupJobCreateRequest.schema.json

@@ -31,9 +31,10 @@
           "type": "string",
           "enum": [
             "device_auth",
+            "browser_callback",
             "browser_redirect"
           ],
-          "description": "Codex-only: device_auth (default; complete it in an isolated browser window) or browser_redirect (explicit opt-in localhost callback)."
+          "description": "Codex-only: device_auth (default; app-server device-code, isolated browser window), browser_callback (app-server browser-callback opt-in), or browser_redirect (legacy Terminal localhost callback / fallback)."
         }
       },
       "required": [