@claudexor/schema 3.3.15 → 3.4.0

package/generated/RunTelemetry.schema.json

@@ -73,7 +73,7 @@
         "web_required": {
           "type": "boolean",
           "default": false,
-          "description": "Whether the run required web evidence."
+          "description": "Explicit stored web requirement."
         },
         "final_attempt_id": {
           "anyOf": [
@@ -95,7 +95,7 @@
             "required": {
               "type": "boolean",
               "default": false,
-              "description": "Whether the run required web evidence."
+              "description": "Explicit stored web requirement."
             },
             "policy": {
               "type": "string",
@@ -121,7 +121,7 @@
             "satisfied": {
               "type": "boolean",
               "default": false,
-              "description": "Whether the web-evidence requirement was satisfied."
+              "description": "Completed without a typed failure; verification records retrieval-proof strength."
             },
             "status": {
               "type": "string",
@@ -132,7 +132,7 @@
                 "failed",
                 "unverified"
               ],
-              "description": "Web-evidence verdict for an attempt/run: none (no web activity), attempted, satisfied (required evidence produced), failed, or unverified.",
+              "description": "Observed web activity: none, attempted, satisfied, failed, or unverified.",
               "default": "none"
             },
             "verification": {
@@ -143,7 +143,7 @@
                 "none"
               ],
               "default": "none",
-              "description": "Retrieval strength of the web evidence: verified (typed retrieval), dispatched (completed but no typed outcome), or none."
+              "description": "Retrieval-proof strength of observed web activity: verified (typed successful retrieval; content proven), dispatched (operation completed but no typed retrieval outcome; content not proven), or none."
             },
             "tool": {
               "type": [
@@ -759,7 +759,7 @@
                   }
                 },
                 "additionalProperties": false,
-                "description": "Token usage summed from harness usage events; money is tracked separately in the budget ledger, not here. Each field is null until a harness reports it (cursor reports cost only; raw-api has no cached), so unreported never reads as 0. Do NOT sum into a grand total: codex cached is a subset of input while claude cached is disjoint from input.",
+                "description": "Token usage summed from harness usage events; money is tracked separately in the budget ledger, not here. Each field is null until a harness reports it, so unreported never reads as 0. The relation between cached_input_tokens and input_tokens is harness-specific; do not derive a grand total.",
                 "default": {}
               }
             },
@@ -846,7 +846,7 @@
         "usage_totals": {
           "$ref": "#/definitions/RunTelemetry/properties/attempts/items/properties/usage",
           "default": {},
-          "description": "Token usage summed from harness usage events; money is tracked separately in the budget ledger, not here. Each field is null until a harness reports it (cursor reports cost only; raw-api has no cached), so unreported never reads as 0. Do NOT sum into a grand total: codex cached is a subset of input while claude cached is disjoint from input."
+          "description": "Token usage summed from harness usage events; money is tracked separately in the budget ledger, not here. Each field is null until a harness reports it, so unreported never reads as 0. The relation between cached_input_tokens and input_tokens is harness-specific; do not derive a grand total."
         },
         "auth_route": {
           "anyOf": [

package/generated/TaskContract.schema.json

@@ -434,7 +434,7 @@
             "web_required": {
               "type": "boolean",
               "default": false,
-              "description": "Whether the task requires live web evidence."
+              "description": "Whether a persisted task contract explicitly requires web evidence; ordinary run policies keep this false."
             },
             "effective_mode": {
               "$ref": "#/definitions/TaskContract/properties/external_context/properties/policy",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "3.3.15",
+  "version": "3.4.0",
   "license": "MIT",
   "description": "Single source of truth for all Claudexor data shapes (Zod + generated JSON Schema).",
   "type": "module",
@@ -20,7 +20,7 @@
   "dependencies": {
     "zod": "^4.4.3",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "3.3.15"
+    "@claudexor/util": "3.4.0"
   },
   "repository": {
     "type": "git",