@claudexor/schema 3.19.0 → 3.22.0

package/generated/RunContinuityReceipt.schema.json

@@ -0,0 +1,182 @@
+{
+  "$ref": "#/definitions/RunContinuityReceipt",
+  "definitions": {
+    "RunContinuityReceipt": {
+      "type": "object",
+      "properties": {
+        "tryIndex": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Native try within the attempt; joins the receipt to its try."
+        },
+        "attemptId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "carrier": {
+          "type": "string",
+          "enum": [
+            "native",
+            "native_moved",
+            "packet",
+            "fresh"
+          ],
+          "description": "Carrier of a continued try: native (the vendor's own session, same account), native_moved (the session file made visible in the next account's store, then resumed there), packet (a fresh session re-grounded by an evidence index), or fresh (nothing to carry — a replay of the original prompt)."
+        },
+        "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."
+        },
+        "from": {
+          "type": "object",
+          "properties": {
+            "runId": {
+              "$ref": "#/definitions/RunContinuityReceipt/properties/attemptId"
+            },
+            "attemptId": {
+              "$ref": "#/definitions/RunContinuityReceipt/properties/attemptId"
+            },
+            "profileId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/RunContinuityReceipt/properties/attemptId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            }
+          },
+          "required": [
+            "runId",
+            "attemptId",
+            "profileId"
+          ],
+          "additionalProperties": false
+        },
+        "to": {
+          "type": "object",
+          "properties": {
+            "profileId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/RunContinuityReceipt/properties/attemptId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            }
+          },
+          "required": [
+            "profileId"
+          ],
+          "additionalProperties": false
+        },
+        "workspace": {
+          "type": "string",
+          "enum": [
+            "same_root",
+            "different_root"
+          ],
+          "description": "Whether the continued try runs in the predecessor's execution root."
+        },
+        "memory": {
+          "type": "string",
+          "enum": [
+            "full",
+            "partial",
+            "unknown"
+          ],
+          "description": "Its own fact: a native resume carries the whole history (full); a packet re-brief is partial; a native resume that lost history (e.g. a rejected compacted item) is partial/unknown."
+        },
+        "instructions": {
+          "type": "string",
+          "enum": [
+            "as_sent",
+            "vendor_snapshot"
+          ],
+          "description": "as_sent: the successor's instructions equal the predecessor's; vendor_snapshot: they differ, and the vendor may resend its recorded system prompt instead (claude records it on the first request)."
+        },
+        "reingestedTokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Input + cache-creation tokens of the first resumed request, when known."
+        },
+        "observedModel": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "THIS try's attested model (never borrowed from another try)."
+        },
+        "modelMismatch": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "identityCheck": {
+          "type": "string",
+          "enum": [
+            "matched_before_effects",
+            "mismatch_before_effects",
+            "mismatch_after_possible_effects",
+            "not_applicable"
+          ],
+          "description": "Whether the resumed vendor session was the one requested, judged at the earliest handshake (codex thread/resume before turn/start; claude system/init): matched, mismatch caught before the child could act, mismatch caught after it may have acted, or not applicable (no resume was requested, or a harness without the continuity capability answered with another session id, which is recorded as before)."
+        },
+        "inputDelivery": {
+          "type": "string",
+          "enum": [
+            "confirmed",
+            "uncertain",
+            "not_applicable"
+          ],
+          "description": "Whether the predecessor's last input (its turn prompt or an admitted steering message) is known to be in the vendor history: confirmed, uncertain (carried in the notice as a reference to reconcile, never replayed blindly), or not applicable."
+        }
+      },
+      "required": [
+        "tryIndex",
+        "attemptId",
+        "carrier",
+        "cause",
+        "from",
+        "to",
+        "workspace",
+        "memory",
+        "instructions",
+        "reingestedTokens",
+        "observedModel",
+        "modelMismatch",
+        "identityCheck",
+        "inputDelivery"
+      ],
+      "additionalProperties": false,
+      "description": "Receipt of one continued try: carrier, cause, accounts, memory, model attestation."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunEvent.schema.json

@@ -101,7 +101,9 @@
             "run.completed",
             "run.failed",
             "run.continuation",
-            "run.continuation.denied"
+            "run.continuation.denied",
+            "run.continuity",
+            "workspace.retained"
           ],
           "description": "Type of an append-only run event, covering run lifecycle, contract/context creation, budget, routing fallbacks, harness activity, interactions, gates, review, arbitration, work products, and control verbs."
         },

package/generated/RunFacts.schema.json

@@ -116,7 +116,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",
@@ -172,6 +172,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/RunFailure.schema.json

@@ -5,66 +5,117 @@
       "type": "object",
       "properties": {
         "requestRefusal": {
-          "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."
+                },
+                "unit": {
+                  "type": "string",
+                  "const": "unicode_scalars"
+                },
+                "limit": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
                 },
-                {
-                  "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"
+                },
+                "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"
+                    }
+                  ]
                 },
-                {
-                  "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."
         },
         "phase": {
           "type": "string",
@@ -104,6 +155,7 @@
                 "subscription_window_exhausted",
                 "credential_pool_exhausted",
                 "input_too_large",
+                "vendor_cli_too_old",
                 "delegated_home_unavailable",
                 "delegated_confinement_unavailable",
                 "delegated_evidence_incomplete",

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#"
+}