@claudexor/schema 3.19.0 → 3.22.0

package/generated/RunTelemetry.schema.json

@@ -179,66 +179,117 @@
             "type": "object",
             "properties": {
               "request_refusal": {
-                "type": "object",
-                "properties": {
-                  "scope": {
-                    "type": "string",
-                    "const": "turn_text",
-                    "description": "All text input items in one native turn; separate instructions are excluded."
-                  },
-                  "unit": {
-                    "type": "string",
-                    "const": "unicode_scalars"
-                  },
-                  "limit": {
-                    "anyOf": [
-                      {
-                        "type": "integer",
-                        "exclusiveMinimum": 0,
-                        "minimum": -9007199254740991,
-                        "maximum": 9007199254740991
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "scope": {
+                        "type": "string",
+                        "const": "turn_text",
+                        "description": "All text input items in one native turn; separate instructions are excluded."
                       },
-                      {
-                        "type": "null"
+                      "unit": {
+                        "type": "string",
+                        "const": "unicode_scalars"
+                      },
+                      "limit": {
+                        "anyOf": [
+                          {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "minimum": -9007199254740991,
+                            "maximum": 9007199254740991
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "source": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "kind": {
+                        "type": "string",
+                        "const": "input_too_large"
+                      },
+                      "actual": {
+                        "anyOf": [
+                          {
+                            "type": "integer",
+                            "minimum": -9007199254740991,
+                            "maximum": 9007199254740991
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "native_code": {
+                        "type": "string",
+                        "minLength": 1
                       }
-                    ]
-                  },
-                  "source": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "kind": {
-                    "type": "string",
-                    "const": "input_too_large"
+                    },
+                    "required": [
+                      "scope",
+                      "unit",
+                      "limit",
+                      "source",
+                      "kind",
+                      "actual",
+                      "native_code"
+                    ],
+                    "additionalProperties": false
                   },
-                  "actual": {
-                    "anyOf": [
-                      {
-                        "type": "integer",
-                        "minimum": -9007199254740991,
-                        "maximum": 9007199254740991
+                  {
+                    "type": "object",
+                    "properties": {
+                      "kind": {
+                        "type": "string",
+                        "const": "vendor_cli_too_old"
                       },
-                      {
-                        "type": "null"
+                      "native_code": {
+                        "type": "string",
+                        "const": "claude_code_version_too_old"
+                      },
+                      "source": {
+                        "type": "string",
+                        "const": "claude_stdout"
+                      },
+                      "binary_path": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "installed_version": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
                       }
-                    ]
-                  },
-                  "native_code": {
-                    "type": "string",
-                    "minLength": 1
+                    },
+                    "required": [
+                      "kind",
+                      "native_code",
+                      "source",
+                      "binary_path",
+                      "installed_version"
+                    ],
+                    "additionalProperties": false
                   }
-                },
-                "required": [
-                  "scope",
-                  "unit",
-                  "limit",
-                  "source",
-                  "kind",
-                  "actual",
-                  "native_code"
                 ],
-                "additionalProperties": false,
-                "description": "Vendor-typed physical input refusal; the same input cannot be repaired by changing this harness's account or model."
+                "description": "Vendor-attested request refusal that another account cannot repair; input and executable causes carry their own evidence."
               },
               "effort_resolution": {
                 "type": "object",
@@ -891,7 +942,7 @@
                           "incomplete",
                           "unverified"
                         ],
-                        "description": "Folded work state: the WorkReport state, or unverified when no report was obtainable (transport unsupported / lane gated)."
+                        "description": "Folded work state: the WorkReport state, or unverified when no valid report was obtained (transport unsupported / lane gated, or an instructed footer missing or broken)."
                       },
                       "source": {
                         "type": "string",
@@ -947,6 +998,19 @@
                         },
                         "maxItems": 16,
                         "description": "Carried through from a needs_input/incomplete WorkReport for honest disclosure."
+                      },
+                      "unverified_reason": {
+                        "type": "string",
+                        "enum": [
+                          "footer_missing",
+                          "footer_not_json",
+                          "footer_not_object",
+                          "report_missing",
+                          "report_malformed",
+                          "report_contradictory",
+                          "legacy_output_invalid"
+                        ],
+                        "description": "Present only with state unverified on a validated (instructed footer) source: the disclosed cause of the missing report."
                       }
                     },
                     "required": [

package/generated/SessionCapsule.schema.json

@@ -0,0 +1,78 @@
+{
+  "$ref": "#/definitions/SessionCapsule",
+  "definitions": {
+    "SessionCapsule": {
+      "type": "object",
+      "properties": {
+        "harness": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Harness that owns the session."
+        },
+        "nativeSessionId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The vendor's own session/thread id."
+        },
+        "holderProfileId": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "description": "Non-empty identifier string."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Credential profile whose store currently holds the session; null = the harness default store."
+        },
+        "file": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Absolute path of the located history file (the holder); null until located."
+        },
+        "mtimeMs": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "description": "Modification time of the located file (newest wins on a tie); null until located."
+        },
+        "sidecars": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Absolute paths of sibling state a move must carry (claude `<sid>/` tool-results and subagents; codex rollout parts)."
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Working directory the session was created under."
+        },
+        "requestedModel": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "The model the spec requested; null = the harness default."
+        }
+      },
+      "required": [
+        "harness",
+        "nativeSessionId",
+        "holderProfileId",
+        "file",
+        "mtimeMs",
+        "cwd",
+        "requestedModel"
+      ],
+      "additionalProperties": false,
+      "description": "Durable per-attempt record of the native vendor session and its holder file."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/TaskContract.schema.json

@@ -568,7 +568,7 @@
             "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."
+            "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, places a word the vendor order lacks by the shared preference order (none < minimal < low < medium < high < xhigh < max < ultra) onto an advertised level, and refuses words neither order places."
           },
           "default": {},
           "description": "Resolved harness-scoped reasoning-effort map for this run (harness id to effort), frozen so an Exact Retry replays the same effort instead of re-resolving current settings."

package/generated/Thread.schema.json

@@ -59,6 +59,21 @@
           "default": null,
           "description": "Thread title; null until set."
         },
+        "folder": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "description": "User-visible thread folder name."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Optional server-owned sidebar folder; null means ungrouped.",
+          "default": null
+        },
         "mode": {
           "type": "string",
           "enum": [
@@ -228,7 +243,7 @@
               "type": "null"
             }
           ],
-          "description": "Earliest automatic purge time; 30 days after trash.",
+          "description": "End of the 30-day trash window: restore is refused after it, and the daemon's next retention pass (startup or claudexor gc) purges the thread.",
           "default": null
         },
         "pre_trash_state": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "3.19.0",
+  "version": "3.22.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.6.5",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "3.19.0"
+    "@claudexor/util": "3.22.0"
   },
   "repository": {
     "type": "git",