@claudexor/schema 3.0.3 → 3.1.0

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

@@ -91,6 +91,17 @@
           ],
           "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/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,6 +326,25 @@
               "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": {

package/generated/HarnessStatusDto.schema.json

@@ -344,6 +344,25 @@
                       "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": {