@claudexor/schema 4.5.0 → 4.6.2

package/generated/HarnessManifest.schema.json

@@ -397,11 +397,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/HarnessStatusDto.schema.json

@@ -415,11 +415,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/McpAccountsToolResult.schema.json

@@ -978,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/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.5.0",
+  "version": "4.6.2",
   "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.5.0"
+    "@claudexor/util": "4.6.2"
   },
   "repository": {
     "type": "git",