@claudexor/schema 3.0.4 → 3.1.1

package/generated/ControlSetupJobEvent.schema.json

@@ -902,6 +902,34 @@
           ],
           "additionalProperties": false,
           "description": "Full authoritative setup-job snapshot at this cursor."
+        },
+        "deviceCode": {
+          "type": "object",
+          "properties": {
+            "flow": {
+              "type": "string",
+              "enum": [
+                "chatgptDeviceCode",
+                "chatgpt"
+              ]
+            },
+            "verificationUrl": {
+              "type": "string",
+              "format": "uri",
+              "description": "Where the operator completes the sign-in."
+            },
+            "userCode": {
+              "type": "string",
+              "description": "Transient one-time code (empty for the browser-callback flow); never journaled."
+            }
+          },
+          "required": [
+            "flow",
+            "verificationUrl",
+            "userCode"
+          ],
+          "additionalProperties": false,
+          "description": "Transient device-code disclosure overlaid at read time from the runner sidecar; never part of the journaled job."
         }
       },
       "required": [

package/generated/ControlSetupJobSnapshot.schema.json

@@ -864,6 +864,34 @@
           "minimum": -9007199254740991,
           "maximum": 9007199254740991,
           "description": "Global partition sequence fenced by the snapshot."
+        },
+        "deviceCode": {
+          "type": "object",
+          "properties": {
+            "flow": {
+              "type": "string",
+              "enum": [
+                "chatgptDeviceCode",
+                "chatgpt"
+              ]
+            },
+            "verificationUrl": {
+              "type": "string",
+              "format": "uri",
+              "description": "Where the operator completes the sign-in."
+            },
+            "userCode": {
+              "type": "string",
+              "description": "Transient one-time code (empty for the browser-callback flow); never journaled."
+            }
+          },
+          "required": [
+            "flow",
+            "verificationUrl",
+            "userCode"
+          ],
+          "additionalProperties": false,
+          "description": "Transient device-code disclosure overlaid at read time from the runner sidecar; never part of the journaled job."
         }
       },
       "required": [

package/generated/ControlThreadApplyResponse.schema.json

@@ -69,6 +69,20 @@
                 "refused": {
                   "type": "boolean"
                 },
+                "alreadyApplied": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True when delivery was an idempotent already-applied no-op (no files changed)."
+                },
+                "deliveryStatus": {
+                  "type": "string",
+                  "enum": [
+                    "applied",
+                    "already_applied",
+                    "refused"
+                  ],
+                  "description": "Coarse typed delivery disposition (applied / already_applied / refused)."
+                },
                 "finalVerify": {
                   "type": "object",
                   "properties": {

package/generated/ControlThreadDetail.schema.json

@@ -296,6 +296,19 @@
                 "description": "Set when this turn implements an approved plan from an earlier run.",
                 "default": null
               },
+              "planHash": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "SHA-256 of the frozen plan bytes this Implement turn materialized (INV-081); null on non-Implement/legacy turns (QA-046)."
+              },
+              "planReadinessOverridden": {
+                "type": "boolean",
+                "default": false,
+                "description": "True when the operator implemented a not-ready plan over open questions (INV-081); recorded for provenance, rendered on the card (QA-046)."
+              },
               "kind": {
                 "type": "string",
                 "enum": [
@@ -519,7 +532,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."
                                   },
@@ -529,6 +546,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": [

package/generated/ControlThreadTurnRequest.schema.json

@@ -82,15 +82,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/ControlThreadTurnRequest/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/DecisionRecord.schema.json

@@ -71,7 +71,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."
                 },
@@ -81,6 +85,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": [
@@ -102,6 +182,84 @@
           "default": {},
           "description": "Per-candidate reasons the others lost, keyed by candidate id."
         },
+        "ranking_policy_version": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 1,
+          "description": "Version of the ranking axis registry the scorecard was produced under."
+        },
+        "score_axes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Every compared ranking axis key, in precedence (best-first) order."
+        },
+        "ranking_scorecard": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "attempt_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Candidate attempt id (stable key; labels may localize)."
+              },
+              "label": {
+                "type": "string",
+                "description": "Anonymized candidate label shown to the arbiter."
+              },
+              "axes": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Formatted value for every ranking axis, keyed by axis key."
+              }
+            },
+            "required": [
+              "attempt_id",
+              "label",
+              "axes"
+            ],
+            "additionalProperties": false
+          },
+          "default": [],
+          "description": "Per-candidate full ranking scorecard, in final ranking order."
+        },
+        "decisive_axis": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "key": {
+                  "type": "string",
+                  "description": "The first ranking axis that separated winner from runner-up."
+                },
+                "winner_value": {
+                  "type": "string",
+                  "description": "The winner's formatted value on the decisive axis."
+                },
+                "runner_up_value": {
+                  "type": "string",
+                  "description": "The runner-up's formatted value on the decisive axis."
+                }
+              },
+              "required": [
+                "key",
+                "winner_value",
+                "runner_up_value"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The axis that actually decided the winner vs the runner-up; null on an exact tie (route order decided, disclosed in final_checks)."
+        },
         "accepted_risks": {
           "type": "array",
           "items": {
@@ -141,12 +299,30 @@
               "type": "boolean",
               "default": false,
               "description": "True when any of the spend is token-derived rather than natively reported."
+            },
+            "cash_usd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "Settled cash spend in USD (0 on native-subscription routes); null when unknown."
+            },
+            "valuation_usd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "Settled subscription-equivalent valuation in USD (includes the reviewer panel); null when unknown."
             }
           },
           "additionalProperties": false,
           "default": {
             "spend_usd": null,
-            "estimated": false
+            "estimated": false,
+            "cash_usd": null,
+            "valuation_usd": null
           },
           "description": "Settled spend for the run; estimates are disclosed, never presented as exact."
         },

package/generated/GlobalConfig.schema.json

@@ -94,14 +94,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/HarnessEvent.schema.json

@@ -18,9 +18,10 @@
             "usage",
             "error",
             "status",
+            "context",
             "completed"
           ],
-          "description": "Normalized event type covering session lifecycle, output, tool use, interaction, file changes, usage, transient status, and errors."
+          "description": "Normalized event type covering session lifecycle, output, tool use, interaction, file changes, usage, transient status, context-management signals, and errors."
         },
         "session_id": {
           "type": "string",
@@ -88,6 +89,15 @@
             "exit_code": {
               "type": "integer",
               "description": "Process exit code for command tools, when known."
+            },
+            "web_retrieval": {
+              "type": "string",
+              "enum": [
+                "verified",
+                "dispatched",
+                "failed"
+              ],
+              "description": "Adapter-stamped web/browser retrieval outcome (verified/dispatched/failed), distinct from the tool-call status lifecycle."
             }
           },
           "required": [
@@ -581,6 +591,74 @@
           "additionalProperties": false,
           "description": "Typed transient-failure signal set by the adapter from native CLI/API error shapes, consumed for bounded retry policy."
         },
+        "context": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "compaction_started",
+                "compaction_completed",
+                "capacity_exhausted"
+              ],
+              "description": "Kind of context signal: a compaction boundary starting/completing, or terminal capacity exhaustion."
+            },
+            "cause": {
+              "type": "string",
+              "enum": [
+                "prompt_too_long",
+                "repeated_refill",
+                "blocking_limit",
+                "window_exceeded",
+                "unknown"
+              ],
+              "default": "unknown",
+              "description": "Why the context signal fired, mapped onto a typed cause (never prose)."
+            },
+            "native_code": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "The vendor's own terminal/context code passed verbatim as evidence; null when none."
+            },
+            "trigger": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "manual",
+                    "auto"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Whether the compaction was manually or automatically triggered; null when unreported."
+            },
+            "pre_tokens": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Token count before the compaction/exhaustion, when the vendor reports it; null otherwise."
+            }
+          },
+          "required": [
+            "kind"
+          ],
+          "additionalProperties": false,
+          "description": "Typed context-management signal (compaction boundary / capacity exhaustion) set by the adapter; orthogonal to the transient-retry taxonomy."
+        },
         "error": {
           "type": "string",
           "description": "Error text for error events."

package/generated/HarnessManifest.schema.json

@@ -326,21 +326,76 @@
               "default": false,
               "description": "The harness can constrain its final message to a caller-supplied JSON Schema (native structured-output flag)."
             },
+            "work_report_transport": {
+              "type": "string",
+              "enum": [
+                "constrained",
+                "validated",
+                "unsupported"
+              ],
+              "default": "unsupported",
+              "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (whole-answer JSON), or unsupported (work_state stays unverified)."
+            },
+            "structured_output_channel": {
+              "type": "string",
+              "enum": [
+                "side_tool",
+                "final_message"
+              ],
+              "default": "final_message",
+              "description": "Where a schema-constrained answer surfaces: side_tool (rides a tool; final message stays markdown) or final_message (constrains the final message itself)."
+            },
             "effort_levels": {
               "type": "array",
               "items": {
                 "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."
               },
               "default": [],
-              "description": "Ordered (weakest to strongest) reasoning-effort levels this harness actually accepts; empty means effort is not a tunable surface."
+              "description": "Ordered (weakest to strongest) reasoning-effort levels this harness accepts across all its models; empty means effort is not a tunable surface."
+            },
+            "model_effort_levels": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "levels": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/HarnessManifest/properties/capabilities/properties/effort_levels/items"
+                    },
+                    "default": [],
+                    "description": "Ordered (weakest to strongest) reasoning-effort levels this model advertises, in the vendor's own order."
+                  },
+                  "default": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/HarnessManifest/properties/capabilities/properties/effort_levels/items"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "The effort level the vendor uses for this model when none is requested.",
+                    "default": null
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Reasoning-effort vocabulary a single model advertises."
+              },
+              "default": {},
+              "description": "Per-model advertised reasoning-effort vocabulary keyed by model id; a model absent here falls back to the harness-wide effort_levels union."
+            },
+            "effort_levels_verified_against": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Vendor CLI version the effort ladders were last verified against; null = never verified / not applicable."
             },
             "known_models": {
               "type": "array",