@claudexor/schema 4.2.0 → 4.3.0

package/generated/McpAccountsToolResult.schema.json

@@ -765,7 +765,7 @@
                                       "tool_policy",
                                       "none"
                                     ],
-                                    "description": "How workspace_write access is CONFINED for a harness: a filesystem/network sandbox (codex seatbelt), a tool-permission policy with no FS/network fence (claude — an allowed shell is unconfined), or none (write intent is advisory).",
+                                    "description": "How workspace_write access is CONFINED for a harness: a filesystem/network base sandbox (codex seatbelt; the harness's native automatic reviewer may still admit individual actions outside it, so fs_sandbox does not mean every admitted action stays inside), a tool-permission policy with no FS/network fence (claude — an allowed shell is unconfined), or none (write intent is advisory).",
                                     "default": "none"
                                   }
                                 },
@@ -1979,6 +1979,53 @@
                                 "items": {
                                   "type": "object",
                                   "properties": {
+                                    "scope": {
+                                      "type": "string",
+                                      "enum": [
+                                        "personal",
+                                        "team"
+                                      ]
+                                    },
+                                    "usage_kind": {
+                                      "type": "string",
+                                      "enum": [
+                                        "included",
+                                        "bonus",
+                                        "on_demand",
+                                        "total"
+                                      ]
+                                    },
+                                    "period": {
+                                      "type": "object",
+                                      "properties": {
+                                        "starts_at": {
+                                          "anyOf": [
+                                            {
+                                              "type": "string",
+                                              "format": "date-time"
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
+                                        "ends_at": {
+                                          "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
+                                        }
+                                      },
+                                      "required": [
+                                        "starts_at",
+                                        "ends_at"
+                                      ],
+                                      "additionalProperties": false
+                                    },
+                                    "fee_included": {
+                                      "type": [
+                                        "boolean",
+                                        "null"
+                                      ],
+                                      "description": "Whether the reported amount includes fees; null means the source did not establish this."
+                                    },
                                     "id": {
                                       "type": "string"
                                     },
@@ -2049,15 +2096,7 @@
                             ]
                           },
                           "observed_at": {
-                            "anyOf": [
-                              {
-                                "type": "string",
-                                "format": "date-time"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "freshness": {
                             "type": "string",
@@ -2068,7 +2107,7 @@
                             ]
                           },
                           "last_attempt_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "last_error": {
                             "type": [
@@ -2097,6 +2136,18 @@
                                 "items": {
                                   "type": "object",
                                   "properties": {
+                                    "scope": {
+                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/scope"
+                                    },
+                                    "usage_kind": {
+                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/usage_kind"
+                                    },
+                                    "period": {
+                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period"
+                                    },
+                                    "fee_included": {
+                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/fee_included"
+                                    },
                                     "id": {
                                       "type": "string"
                                     },
@@ -2142,7 +2193,7 @@
                                       ]
                                     },
                                     "resets_at": {
-                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                                     },
                                     "reason": {
                                       "type": [
@@ -2178,7 +2229,7 @@
                             ]
                           },
                           "observed_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "freshness": {
                             "type": "string",
@@ -2189,7 +2240,7 @@
                             ]
                           },
                           "last_attempt_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "last_error": {
                             "type": [
@@ -2267,7 +2318,7 @@
                                       ]
                                     },
                                     "resets_at": {
-                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                                      "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                                     },
                                     "weekly_limit_applies": {
                                       "type": "boolean"
@@ -2320,10 +2371,10 @@
                                                 ]
                                               },
                                               "starts_at": {
-                                                "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                                                "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                                               },
                                               "expires_at": {
-                                                "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                                                "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                                               },
                                               "clears": {
                                                 "type": "array",
@@ -2380,7 +2431,7 @@
                             ]
                           },
                           "observed_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "freshness": {
                             "type": "string",
@@ -2391,7 +2442,7 @@
                             ]
                           },
                           "last_attempt_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "last_error": {
                             "type": [
@@ -2449,7 +2500,7 @@
                             ]
                           },
                           "observed_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "freshness": {
                             "type": "string",
@@ -2460,7 +2511,7 @@
                             ]
                           },
                           "last_attempt_at": {
-                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/observed_at"
+                            "$ref": "#/definitions/McpAccountsToolResult/anyOf/2/properties/quota/properties/resources/items/properties/balances/properties/value/anyOf/0/items/properties/period/properties/starts_at"
                           },
                           "last_error": {
                             "type": [

package/generated/McpRunHandleResult.schema.json

@@ -131,6 +131,11 @@
                   },
                   "source": {
                     "$ref": "#/definitions/McpRunHandleResult/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                  },
+                  "debit": {
+                    "type": "string",
+                    "const": "unobserved",
+                    "description": "The route reports no actual cash or purchased-credit debit. Included service still admits the work, but its cash stays unknown instead of zero and is outside the finite cap; absence keeps proven ordinary inclusion as zero cash."
                   }
                 },
                 "required": [
@@ -177,7 +182,7 @@
                   "valuationKnowledge"
                 ],
                 "additionalProperties": false,
-                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash."
+                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash unless its route reports no actual debit."
               }
             },
             "required": [
@@ -1520,6 +1525,14 @@
                   "default": null,
                   "description": "CASH spend so far in USD; null when unknown."
                 },
+                "controllableSpendUsd": {
+                  "type": [
+                    "number",
+                    "null"
+                  ],
+                  "default": null,
+                  "description": "Cash governed by the finite cap: settled amounts on routes Claudexor controls; null when that cash is unknown. spendUsd can still be null when an included subscription reports no actual debit."
+                },
                 "valuationUsd": {
                   "type": [
                     "number",
@@ -1544,7 +1557,7 @@
                     "null"
                   ],
                   "default": null,
-                  "description": "Remaining budget in USD; null when no cap or unknown spend."
+                  "description": "Remaining finite cap after controllableSpendUsd; null when no cap or unknown."
                 },
                 "estimated": {
                   "type": "boolean",

package/generated/McpRunToolResult.schema.json

@@ -131,6 +131,11 @@
                   },
                   "source": {
                     "$ref": "#/definitions/McpRunToolResult/properties/attemptExecution/items/properties/processing/properties/submittedNative/anyOf/0"
+                  },
+                  "debit": {
+                    "type": "string",
+                    "const": "unobserved",
+                    "description": "The route reports no actual cash or purchased-credit debit. Included service still admits the work, but its cash stays unknown instead of zero and is outside the finite cap; absence keeps proven ordinary inclusion as zero cash."
                   }
                 },
                 "required": [
@@ -177,7 +182,7 @@
                   "valuationKnowledge"
                 ],
                 "additionalProperties": false,
-                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash."
+                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash unless its route reports no actual debit."
               }
             },
             "required": [

package/generated/ModelCallResult.schema.json

@@ -280,6 +280,11 @@
                 },
                 "source": {
                   "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_calls/items/properties/function/properties/name"
+                },
+                "debit": {
+                  "type": "string",
+                  "const": "unobserved",
+                  "description": "The route reports no actual cash or purchased-credit debit. Included service still admits the work, but its cash stays unknown instead of zero and is outside the finite cap; absence keeps proven ordinary inclusion as zero cash."
                 }
               },
               "required": [

package/generated/ProcessingCostBasis.schema.json

@@ -30,6 +30,11 @@
         },
         "source": {
           "$ref": "#/definitions/ProcessingCostBasis/properties/nativeMode/anyOf/0"
+        },
+        "debit": {
+          "type": "string",
+          "const": "unobserved",
+          "description": "The route reports no actual cash or purchased-credit debit. Included service still admits the work, but its cash stays unknown instead of zero and is outside the finite cap; absence keeps proven ordinary inclusion as zero cash."
         }
       },
       "required": [

package/generated/RunContinuityReceipt.schema.json

@@ -31,6 +31,7 @@
             "pool_exhausted",
             "pinned_limit",
             "transport",
+            "permission_denied",
             "context_exhausted",
             "wall_clock",
             "cancelled",
@@ -38,7 +39,7 @@
             "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."
+          "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), a confirmed native tool permission refusal, 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",

package/generated/RunEvent.schema.json

@@ -64,6 +64,7 @@
             "interaction.answered",
             "interaction.timeout",
             "interaction.answer_discarded",
+            "interaction.withdrawn",
             "message.accepted",
             "message.delivered",
             "message.refused",

package/generated/RunProcessingIntent.schema.json

@@ -0,0 +1,117 @@
+{
+  "$ref": "#/definitions/RunProcessingIntent",
+  "definitions": {
+    "RunProcessingIntent": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "harnesses": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "requested": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "standard",
+                      "fast",
+                      "economy"
+                    ],
+                    "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+              },
+              "submitted": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/RunProcessingIntent/properties/harnesses/additionalProperties/properties/requested/anyOf/0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Advisory service preference. Fast or Economy may use ordinary Standard service; fallback never introduces Fast. Omission preserves native defaults. Explicit native serviceTier takes precedence."
+              },
+              "submittedNative": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "pattern": "\\S",
+                    "description": "User-supplied string that must contain visible content, not just whitespace."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "User-supplied string that must contain visible content, not just whitespace."
+              },
+              "observed": {
+                "type": "string",
+                "enum": [
+                  "standard",
+                  "fast",
+                  "economy",
+                  "mixed",
+                  "unknown"
+                ]
+              },
+              "observedNative": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/RunProcessingIntent/properties/harnesses/additionalProperties/properties/submittedNative/anyOf/0"
+                }
+              },
+              "reason": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/RunProcessingIntent/properties/harnesses/additionalProperties/properties/submittedNative/anyOf/0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "User-supplied string that must contain visible content, not just whitespace."
+              },
+              "source": {
+                "$ref": "#/definitions/RunProcessingIntent/properties/harnesses/additionalProperties/properties/submittedNative/anyOf/0"
+              }
+            },
+            "required": [
+              "requested",
+              "submitted",
+              "submittedNative",
+              "observed",
+              "observedNative",
+              "reason",
+              "source"
+            ],
+            "additionalProperties": false,
+            "description": "Requested intent, submitted native control, and observed execution are independent facts. A submitted flag never proves observed service; mixed or missing session observations remain explicit."
+          },
+          "propertyNames": {
+            "minLength": 1,
+            "pattern": "\\S"
+          },
+          "description": "Routing-time receipt per routed harness; its source keeps the original provenance (for example codex.managed_config)."
+        }
+      },
+      "required": [
+        "schema_version",
+        "harnesses"
+      ],
+      "additionalProperties": false,
+      "description": "Speed each routed harness chose without a processing preference, written once at its first routing. Exact Retry keeps it instead of a changed or different account's native setting, and a retry records the intent it kept, so a retry chain keeps the original even after an ordinary fallback."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunResumable.schema.json

@@ -11,6 +11,7 @@
             "pool_exhausted",
             "pinned_limit",
             "transport",
+            "permission_denied",
             "context_exhausted",
             "wall_clock",
             "cancelled",
@@ -18,7 +19,7 @@
             "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."
+          "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), a confirmed native tool permission refusal, context exhaustion, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause."
         },
         "resetsAt": {
           "type": [

package/generated/RunTelemetry.schema.json

@@ -499,6 +499,11 @@
                   },
                   "source": {
                     "$ref": "#/definitions/RunTelemetry/properties/attempts/items/properties/effort_resolution/properties/requested/anyOf/0"
+                  },
+                  "debit": {
+                    "type": "string",
+                    "const": "unobserved",
+                    "description": "The route reports no actual cash or purchased-credit debit. Included service still admits the work, but its cash stays unknown instead of zero and is outside the finite cap; absence keeps proven ordinary inclusion as zero cash."
                   }
                 },
                 "required": [
@@ -545,7 +550,7 @@
                   "valuationKnowledge"
                 ],
                 "additionalProperties": false,
-                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash."
+                "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash unless its route reports no actual debit."
               },
               "attempt_id": {
                 "type": "string",

package/generated/RunTimeLimitRequest.schema.json

@@ -0,0 +1,92 @@
+{
+  "$ref": "#/definitions/RunTimeLimitRequest",
+  "definitions": {
+    "RunTimeLimitRequest": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "read"
+            }
+          },
+          "required": [
+            "action"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "set"
+            },
+            "seconds": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 604800
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "soft",
+                "hard"
+              ]
+            },
+            "expectedRevision": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "action",
+            "seconds",
+            "expectedRevision"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "extend"
+            },
+            "seconds": {
+              "$ref": "#/definitions/RunTimeLimitRequest/anyOf/1/properties/seconds"
+            },
+            "expectedRevision": {
+              "$ref": "#/definitions/RunTimeLimitRequest/anyOf/1/properties/expectedRevision"
+            }
+          },
+          "required": [
+            "action",
+            "seconds",
+            "expectedRevision"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "disable"
+            },
+            "expectedRevision": {
+              "$ref": "#/definitions/RunTimeLimitRequest/anyOf/1/properties/expectedRevision"
+            }
+          },
+          "required": [
+            "action",
+            "expectedRevision"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunTimeLimitSnapshot.schema.json

@@ -0,0 +1,61 @@
+{
+  "$ref": "#/definitions/RunTimeLimitSnapshot",
+  "definitions": {
+    "RunTimeLimitSnapshot": {
+      "type": "object",
+      "properties": {
+        "revision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "soft",
+            "hard"
+          ]
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "disabled",
+            "armed",
+            "reached",
+            "closed"
+          ]
+        },
+        "deadlineAt": {
+          "anyOf": [
+            {
+              "type": "string",
+              "format": "date-time"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "reachedAt": {
+          "anyOf": [
+            {
+              "type": "string",
+              "format": "date-time"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "revision",
+        "mode",
+        "state",
+        "deadlineAt",
+        "reachedAt"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/UsageCostSummary.schema.json

@@ -37,7 +37,7 @@
         "valuationKnowledge"
       ],
       "additionalProperties": false,
-      "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash."
+      "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash unless its route reports no actual debit."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/package.json

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