@claudexor/schema 3.20.1 → 3.22.0

package/generated/RunResumable.schema.json

@@ -0,0 +1,153 @@
+{
+  "$ref": "#/definitions/RunResumable",
+  "definitions": {
+    "RunResumable": {
+      "type": "object",
+      "properties": {
+        "cause": {
+          "type": "string",
+          "enum": [
+            "vendor_limit",
+            "pool_exhausted",
+            "pinned_limit",
+            "transport",
+            "context_exhausted",
+            "wall_clock",
+            "cancelled",
+            "host_restart",
+            "input_required",
+            "other"
+          ],
+          "description": "Typed reason the previous process stopped: a vendor limit (next account eligible), the whole pool spent, a pinned account's limit, a transport death (crash, timeout, watchdog), context exhaustion, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause."
+        },
+        "resetsAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "When the spent vendor window reopens, only from a vendor signal; never fabricated."
+        },
+        "limitWindow": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "The vendor's own name for the spent window (e.g. five_hour, seven_day_opus), when known."
+        },
+        "limitEvidence": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "window",
+                "unspecified"
+              ],
+              "description": "window: the vendor named the spent window (a reset instant or a constraint id); unspecified: a typed limit without a window — a bare backoff frame is transport, not a limit."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "window: the vendor named the spent window (a reset instant or a constraint id); unspecified: a typed limit without a window — a bare backoff frame is transport, not a limit."
+        },
+        "carriers": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "native",
+              "native_moved",
+              "packet"
+            ],
+            "description": "A continuity representation still available for a stopped run."
+          },
+          "description": "Continuity representations still available (NOT quota readiness; readiness is described by the limit facts)."
+        },
+        "limitCode": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "The typed vendor limit code that ended the work, when any."
+        },
+        "session": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "harness": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                "nativeSessionId": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "holderProfileId": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/RunResumable/properties/session/anyOf/0/properties/harness"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Non-empty identifier string."
+                }
+              },
+              "required": [
+                "harness",
+                "nativeSessionId",
+                "holderProfileId"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The native session a continuation can resume, when one exists."
+        },
+        "workspace": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "in_place",
+                "retained_envelope",
+                "none"
+              ]
+            },
+            "root": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "kind",
+            "root"
+          ],
+          "additionalProperties": false,
+          "description": "Where the stopped work's tree is: the live root, a retained envelope, or gone."
+        }
+      },
+      "required": [
+        "cause",
+        "resetsAt",
+        "limitWindow",
+        "limitEvidence",
+        "carriers",
+        "limitCode",
+        "session",
+        "workspace"
+      ],
+      "additionalProperties": false,
+      "description": "Terminal facts of a stopped run that can be continued: cause, limit evidence, available carriers, the native session and the workspace."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunTelemetry.schema.json

@@ -942,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",
@@ -998,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "3.20.1",
+  "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.20.1"
+    "@claudexor/util": "3.22.0"
   },
   "repository": {
     "type": "git",