@claudexor/schema 4.4.0 → 4.6.1

package/generated/McpAccountsToolResult.schema.json

@@ -381,6 +381,72 @@
             "routingEvidence": {
               "type": "object",
               "properties": {
+                "capabilities": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harness_id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Harness family of the account."
+                      },
+                      "profile_id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Account row that refused this model before generation started."
+                      },
+                      "requested_model": {
+                        "type": "string",
+                        "description": "Model the refused request named."
+                      },
+                      "account_fingerprint": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "Provider account identity the mark is bound to; null when the adapter has none."
+                      },
+                      "provider_reason": {
+                        "type": "string",
+                        "description": "Latest refusal diagnostic, redacted and at most 1024 characters: the provider's reason for a recognized refusal, the engine's message and vendor code otherwise."
+                      },
+                      "observed_at": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Start of this mark's episode, when its row was created (a recognized refusal, or the service elsewhere that confirmed an unrecognized one); renewals and probes keep it."
+                      },
+                      "expires_at": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Probe becomes eligible at this time; not a vendor reset."
+                      },
+                      "state": {
+                        "type": "string",
+                        "enum": [
+                          "provisional",
+                          "confirmed",
+                          "probe_due",
+                          "probing"
+                        ],
+                        "description": "provisional = refused here; confirmed = another account then served the correlated retry; probe_due = expired, the next selection may probe it; probing = one operation holds that probe."
+                      }
+                    },
+                    "required": [
+                      "harness_id",
+                      "profile_id",
+                      "requested_model",
+                      "account_fingerprint",
+                      "provider_reason",
+                      "observed_at",
+                      "expires_at",
+                      "state"
+                    ],
+                    "additionalProperties": false,
+                    "description": "A temporary capability mark for one account and one model. It only orders auto selection: the account stays enabled and usable as a last fallback."
+                  },
+                  "description": "Temporary capability marks; absent from engines that predate them. A mark clears on a success there or a catalog or credential change; after expires_at one operation may probe the account."
+                },
                 "refusals": {
                   "type": "array",
                   "items": {
@@ -912,11 +978,23 @@
                                 ],
                                 "description": "How a live message enters a running session: mid_turn (consumed inside the active turn), next_tool_boundary (queued until the same turn's next tool boundary), none (no truthful channel; the engine answers unsupported).",
                                 "default": "none"
+                              },
+                              "prompt_cache_ttls": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string",
+                                  "enum": [
+                                    "5m",
+                                    "1h"
+                                  ],
+                                  "description": "Native prompt-cache lifetime for the main conversation and helper requests of a harness that declares it. Omission sends no override: native defaults, profile settings and the inherited environment stay in effect."
+                                },
+                                "description": "Prompt-cache lifetimes this adapter translates into native controls; a requested lifetime outside the list (or with the list absent) is disclosed as ignored."
                               }
                             },
                             "additionalProperties": false,
                             "default": {},
-                            "description": "Structured per-harness facts the engine consumes: auth routing, isolation containment, readonly mechanism, finite attachment inputs, MCP injection, and live input into a running session."
+                            "description": "Structured per-harness facts the engine consumes: auth routing, isolation containment, readonly mechanism, finite attachment inputs, MCP injection, live input into a running session, and translated prompt-cache lifetimes."
                           },
                           "capabilities": {
                             "type": "object",

package/generated/ModelCallRequest.schema.json

@@ -52,7 +52,11 @@
               "additionalProperties": false
             }
           ],
-          "description": "Auto keeps a usable prior account; pin never selects another account."
+          "description": "Auto text operations prefer preferredProfileId among unmarked accounts of the same catalog tier (listed before unlisted); a listed alternative, a mark or a recent refusal outranks it. History bound to that account keeps it first over a catalog miss only while it has neither a mark nor a recent refusal. Image operations order accounts by the pool alone. Pin never selects another account."
+        },
+        "retryOfOperationId": {
+          "$ref": "#/definitions/ModelCallRequest/properties/source",
+          "description": "One host-owned capability retry of a failed auto operation with otherwise identical generation input. No engine re-dispatch; unavailable after daemon restart or four hours."
         },
         "messages": {
           "type": "array",

package/generated/ModelCallResult.schema.json

@@ -4,6 +4,61 @@
     "ModelCallResult": {
       "type": "object",
       "properties": {
+        "routing": {
+          "type": "object",
+          "properties": {
+            "selectionReason": {
+              "type": "string",
+              "enum": [
+                "listed",
+                "unlisted_fallback",
+                "marked_fallback",
+                "preferred",
+                "pinned",
+                "probe"
+              ]
+            },
+            "retryOfOperationId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Non-empty identifier string."
+            },
+            "differentialOutcome": {
+              "type": "string",
+              "enum": [
+                "provisional",
+                "confirmed",
+                "equivalent_refusal",
+                "inconclusive"
+              ]
+            },
+            "poolEvents": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string"
+                  },
+                  "payload": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  }
+                },
+                "required": [
+                  "type",
+                  "payload"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "selectionReason",
+            "poolEvents"
+          ],
+          "additionalProperties": false
+        },
         "outcome": {
           "type": "string",
           "enum": [
@@ -53,8 +108,7 @@
                   "type": "string"
                 },
                 "tool_call_id": {
-                  "type": "string",
-                  "minLength": 1,
+                  "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId",
                   "description": "Non-empty identifier string."
                 },
                 "tool_calls": {
@@ -63,7 +117,7 @@
                     "type": "object",
                     "properties": {
                       "id": {
-                        "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_call_id"
+                        "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId"
                       },
                       "type": {
                         "type": "string",
@@ -104,10 +158,10 @@
                       "type": "object",
                       "properties": {
                         "source": {
-                          "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_call_id"
+                          "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId"
                         },
                         "credentialProfileId": {
-                          "$ref": "#/definitions/ModelCallResult/properties/message/anyOf/0/properties/tool_call_id"
+                          "$ref": "#/definitions/ModelCallResult/properties/routing/properties/retryOfOperationId"
                         },
                         "accountFingerprint": {
                           "type": [

package/generated/PromptCacheTtl.schema.json

@@ -0,0 +1,14 @@
+{
+  "$ref": "#/definitions/PromptCacheTtl",
+  "definitions": {
+    "PromptCacheTtl": {
+      "type": "string",
+      "enum": [
+        "5m",
+        "1h"
+      ],
+      "description": "Native prompt-cache lifetime for the main conversation and helper requests of a harness that declares it. Omission sends no override: native defaults, profile settings and the inherited environment stay in effect."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/PromptCacheTtlReceipt.schema.json

@@ -0,0 +1,96 @@
+{
+  "$ref": "#/definitions/PromptCacheTtlReceipt",
+  "definitions": {
+    "PromptCacheTtlReceipt": {
+      "type": "object",
+      "properties": {
+        "requested": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "5m",
+                "1h"
+              ],
+              "description": "Native prompt-cache lifetime for the main conversation and helper requests of a harness that declares it. Omission sends no override: native defaults, profile settings and the inherited environment stay in effect."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Lifetime the engine routed to this session: the run's captured value where this adapter declares it, otherwise null (Default, or an undeclared value disclosed as ignored). The captured intent itself is the task contract's prompt_cache_ttl."
+        },
+        "submitted": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PromptCacheTtlReceipt/properties/requested/anyOf/0"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Value set on the native lifetime controls of this process, null when none was set. Configuration, not proof that the provider applied it."
+        },
+        "reason": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "\\S",
+              "description": "User-supplied string that must contain visible content, not just whitespace."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Known reason the submitted value cannot govern this session (a forcing or disabling native control in effect, or a CLI that predates the controls); null when none is known."
+        },
+        "observed": {
+          "type": "string",
+          "enum": [
+            "5m",
+            "1h",
+            "mixed",
+            "none",
+            "unknown"
+          ],
+          "description": "Lifetime split of the cache writes reported by the native result usage; it does not establish which request buckets that usage aggregates. none = no observed writes (not disabled caching); unknown = a result did not report the split."
+        },
+        "write_5m_tokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Reported five-minute cache-write tokens summed over results; null when any result omitted the split."
+        },
+        "write_1h_tokens": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PromptCacheTtlReceipt/properties/write_5m_tokens/anyOf/0"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Reported one-hour cache-write tokens summed over results; null when any result omitted the split."
+        }
+      },
+      "required": [
+        "requested",
+        "submitted",
+        "reason",
+        "observed",
+        "write_5m_tokens",
+        "write_1h_tokens"
+      ],
+      "additionalProperties": false,
+      "description": "Requested, configured and observed prompt-cache lifetime facts for one attempt. Lifecycle, outcome and cost are separate facts and never derive from this receipt."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/RunTelemetry.schema.json

@@ -514,6 +514,93 @@
                 "additionalProperties": false,
                 "description": "Mode-qualified billing evidence for an existing cost record. Authentication alone does not establish included premium service; credits, cash, and token valuation stay distinct."
               },
+              "prompt_cache_ttl": {
+                "type": "object",
+                "properties": {
+                  "requested": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "5m",
+                          "1h"
+                        ],
+                        "description": "Native prompt-cache lifetime for the main conversation and helper requests of a harness that declares it. Omission sends no override: native defaults, profile settings and the inherited environment stay in effect."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Lifetime the engine routed to this session: the run's captured value where this adapter declares it, otherwise null (Default, or an undeclared value disclosed as ignored). The captured intent itself is the task contract's prompt_cache_ttl."
+                  },
+                  "submitted": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/RunTelemetry/properties/attempts/items/properties/prompt_cache_ttl/properties/requested/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Value set on the native lifetime controls of this process, null when none was set. Configuration, not proof that the provider applied it."
+                  },
+                  "reason": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/RunTelemetry/properties/attempts/items/properties/effort_resolution/properties/requested/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Known reason the submitted value cannot govern this session (a forcing or disabling native control in effect, or a CLI that predates the controls); null when none is known."
+                  },
+                  "observed": {
+                    "type": "string",
+                    "enum": [
+                      "5m",
+                      "1h",
+                      "mixed",
+                      "none",
+                      "unknown"
+                    ],
+                    "description": "Lifetime split of the cache writes reported by the native result usage; it does not establish which request buckets that usage aggregates. none = no observed writes (not disabled caching); unknown = a result did not report the split."
+                  },
+                  "write_5m_tokens": {
+                    "anyOf": [
+                      {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Reported five-minute cache-write tokens summed over results; null when any result omitted the split."
+                  },
+                  "write_1h_tokens": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/RunTelemetry/properties/attempts/items/properties/prompt_cache_ttl/properties/write_5m_tokens/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Reported one-hour cache-write tokens summed over results; null when any result omitted the split."
+                  }
+                },
+                "required": [
+                  "requested",
+                  "submitted",
+                  "reason",
+                  "observed",
+                  "write_5m_tokens",
+                  "write_1h_tokens"
+                ],
+                "additionalProperties": false,
+                "description": "Requested, configured and observed prompt-cache lifetime facts for one attempt. Lifecycle, outcome and cost are separate facts and never derive from this receipt."
+              },
               "usage_cost": {
                 "type": "object",
                 "properties": {

package/generated/TaskContract.schema.json

@@ -561,6 +561,14 @@
           ],
           "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."
         },
+        "prompt_cache_ttl": {
+          "type": "string",
+          "enum": [
+            "5m",
+            "1h"
+          ],
+          "description": "Native prompt-cache lifetime for the main conversation and helper requests of a harness that declares it. Omission sends no override: native defaults, profile settings and the inherited environment stay in effect."
+        },
         "routing_efforts": {
           "type": "object",
           "additionalProperties": {

package/package.json

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