@claudexor/schema 4.1.1 → 4.3.0

package/generated/ControlRunDetail.schema.json

@@ -131,6 +131,11 @@
                   },
                   "source": {
                     "$ref": "#/definitions/ControlRunDetail/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": [
@@ -302,6 +307,7 @@
                         "pool_exhausted",
                         "pinned_limit",
                         "transport",
+                        "permission_denied",
                         "context_exhausted",
                         "wall_clock",
                         "cancelled",
@@ -309,7 +315,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": [
@@ -804,6 +810,65 @@
                       ],
                       "description": "Vendor-attested request refusal that another account cannot repair; input and executable causes carry their own evidence."
                     },
+                    "captureFailure": {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "type": "string",
+                          "enum": [
+                            "capture_output_exceeded",
+                            "capture_output_incomplete",
+                            "capture_preview_truncated",
+                            "capture_failed"
+                          ]
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "causeCode": {
+                          "type": "string"
+                        },
+                        "bufferBudgetBytes": {
+                          "type": "integer",
+                          "minimum": 0
+                        },
+                        "stream": {
+                          "type": "string",
+                          "enum": [
+                            "stdout",
+                            "stderr"
+                          ]
+                        },
+                        "drain": {
+                          "type": "string",
+                          "const": "truncated"
+                        },
+                        "cleanup": {
+                          "type": "object",
+                          "properties": {
+                            "code": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "message": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "code",
+                            "message"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "code",
+                        "message"
+                      ],
+                      "additionalProperties": false
+                    },
                     "phase": {
                       "type": "string",
                       "default": "unknown",
@@ -975,6 +1040,109 @@
                       "description": "The vendor's own typed failure for the attempt this record speaks for, or null when no vendor-typed evidence exists (every harness without such a channel, and any unreadable record). Facts only: carries no remedy.",
                       "default": null
                     },
+                    "poolAttempts": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "harnessId": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Harness the try ran on."
+                          },
+                          "profileId": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "description": "Account row the try ran on; null = the harness default route."
+                          },
+                          "profileDisplayName": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "description": "The row's display name at try time (redacted); null for the default route."
+                          },
+                          "requestedModel": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "description": "Model the try asked for; null = the harness default model."
+                          },
+                          "attemptId": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Attempt the try belongs to."
+                          },
+                          "tryIndex": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "description": "Zero-based try index within the attempt."
+                          },
+                          "observedAt": {
+                            "type": "string",
+                            "format": "date-time",
+                            "description": "When the try's first error was observed."
+                          },
+                          "phase": {
+                            "type": "string",
+                            "enum": [
+                              "pre_start",
+                              "pre_progress",
+                              "after_progress"
+                            ],
+                            "description": "How far the try got: before a typed session start, after start but before agent progress, or after progress."
+                          },
+                          "category": {
+                            "type": "string",
+                            "enum": [
+                              "timeout",
+                              "rate_limited",
+                              "auth_failed",
+                              "capability_refused",
+                              "process_crash",
+                              "config_error",
+                              "unknown_harness_error"
+                            ],
+                            "description": "Typed failure category of the try; untyped errors are unknown_harness_error."
+                          },
+                          "error": {
+                            "type": "string",
+                            "description": "The try's own error text with its original wording and whitespace, redacted."
+                          },
+                          "vendorFailure": {
+                            "anyOf": [
+                              {
+                                "$ref": "#/definitions/ControlRunDetail/properties/summary/properties/failure/anyOf/0/properties/vendorFailure/anyOf/0"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "The vendor's own typed failure for this try, when the adapter attached one."
+                          }
+                        },
+                        "required": [
+                          "harnessId",
+                          "profileId",
+                          "profileDisplayName",
+                          "requestedModel",
+                          "attemptId",
+                          "tryIndex",
+                          "observedAt",
+                          "phase",
+                          "category",
+                          "error",
+                          "vendorFailure"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Per-try account attribution of a failed execution try (diagnostic evidence only)."
+                      },
+                      "default": [],
+                      "description": "Every failed execution try in order, each with its own account and error text; empty when no try failed (and for records written before this field existed)."
+                    },
                     "nextActions": {
                       "type": "array",
                       "items": {
@@ -2918,6 +3086,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",
@@ -2942,7 +3118,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",
@@ -3139,7 +3315,14 @@
                         "null"
                       ],
                       "default": null,
-                      "description": "Settled cash spend in USD (0 on native-subscription routes); null when unknown."
+                      "description": "Settled cash spend in USD (0 on proven included routes); null when unknown, including an included subscription that reports no actual debit."
+                    },
+                    "controllable_cash_usd": {
+                      "type": [
+                        "number",
+                        "null"
+                      ],
+                      "description": "Cash governed by the finite cap: settled amounts on routes Claudexor controls; null when that cash is unknown. spend_usd and cash_usd stay null when an included subscription reports no actual debit. Absent on legacy decisions."
                     },
                     "valuation_usd": {
                       "type": [

package/generated/ControlRunListResponse.schema.json

@@ -122,6 +122,7 @@
                           "pool_exhausted",
                           "pinned_limit",
                           "transport",
+                          "permission_denied",
                           "context_exhausted",
                           "wall_clock",
                           "cancelled",
@@ -129,7 +130,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": [
@@ -624,6 +625,65 @@
                         ],
                         "description": "Vendor-attested request refusal that another account cannot repair; input and executable causes carry their own evidence."
                       },
+                      "captureFailure": {
+                        "type": "object",
+                        "properties": {
+                          "code": {
+                            "type": "string",
+                            "enum": [
+                              "capture_output_exceeded",
+                              "capture_output_incomplete",
+                              "capture_preview_truncated",
+                              "capture_failed"
+                            ]
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "causeCode": {
+                            "type": "string"
+                          },
+                          "bufferBudgetBytes": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "stream": {
+                            "type": "string",
+                            "enum": [
+                              "stdout",
+                              "stderr"
+                            ]
+                          },
+                          "drain": {
+                            "type": "string",
+                            "const": "truncated"
+                          },
+                          "cleanup": {
+                            "type": "object",
+                            "properties": {
+                              "code": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "message": {
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "code",
+                              "message"
+                            ],
+                            "additionalProperties": false
+                          }
+                        },
+                        "required": [
+                          "code",
+                          "message"
+                        ],
+                        "additionalProperties": false
+                      },
                       "phase": {
                         "type": "string",
                         "default": "unknown",
@@ -795,6 +855,109 @@
                         "description": "The vendor's own typed failure for the attempt this record speaks for, or null when no vendor-typed evidence exists (every harness without such a channel, and any unreadable record). Facts only: carries no remedy.",
                         "default": null
                       },
+                      "poolAttempts": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "harnessId": {
+                              "type": "string",
+                              "minLength": 1,
+                              "description": "Harness the try ran on."
+                            },
+                            "profileId": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "Account row the try ran on; null = the harness default route."
+                            },
+                            "profileDisplayName": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "The row's display name at try time (redacted); null for the default route."
+                            },
+                            "requestedModel": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "Model the try asked for; null = the harness default model."
+                            },
+                            "attemptId": {
+                              "type": "string",
+                              "minLength": 1,
+                              "description": "Attempt the try belongs to."
+                            },
+                            "tryIndex": {
+                              "type": "integer",
+                              "minimum": 0,
+                              "description": "Zero-based try index within the attempt."
+                            },
+                            "observedAt": {
+                              "type": "string",
+                              "format": "date-time",
+                              "description": "When the try's first error was observed."
+                            },
+                            "phase": {
+                              "type": "string",
+                              "enum": [
+                                "pre_start",
+                                "pre_progress",
+                                "after_progress"
+                              ],
+                              "description": "How far the try got: before a typed session start, after start but before agent progress, or after progress."
+                            },
+                            "category": {
+                              "type": "string",
+                              "enum": [
+                                "timeout",
+                                "rate_limited",
+                                "auth_failed",
+                                "capability_refused",
+                                "process_crash",
+                                "config_error",
+                                "unknown_harness_error"
+                              ],
+                              "description": "Typed failure category of the try; untyped errors are unknown_harness_error."
+                            },
+                            "error": {
+                              "type": "string",
+                              "description": "The try's own error text with its original wording and whitespace, redacted."
+                            },
+                            "vendorFailure": {
+                              "anyOf": [
+                                {
+                                  "$ref": "#/definitions/ControlRunListResponse/properties/runs/items/properties/failure/anyOf/0/properties/vendorFailure/anyOf/0"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "The vendor's own typed failure for this try, when the adapter attached one."
+                            }
+                          },
+                          "required": [
+                            "harnessId",
+                            "profileId",
+                            "profileDisplayName",
+                            "requestedModel",
+                            "attemptId",
+                            "tryIndex",
+                            "observedAt",
+                            "phase",
+                            "category",
+                            "error",
+                            "vendorFailure"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Per-try account attribution of a failed execution try (diagnostic evidence only)."
+                        },
+                        "default": [],
+                        "description": "Every failed execution try in order, each with its own account and error text; empty when no try failed (and for records written before this field existed)."
+                      },
                       "nextActions": {
                         "type": "array",
                         "items": {

package/generated/ControlRunStartRequest.schema.json

@@ -549,7 +549,15 @@
           "type": "integer",
           "exclusiveMinimum": 0,
           "maximum": 604800,
-          "description": "Hard wall-clock deadline for the whole run (seconds, from scheduler start, max 7 days); on expiry the run is cancelled with reason wall_clock_exceeded and partial artifacts are kept."
+          "description": "Wall-clock limit for the whole run (seconds, max seven days). Omission disables the clock. Explicit limits cancel by default; soft mode warns and continues."
+        },
+        "timeLimitMode": {
+          "type": "string",
+          "enum": [
+            "soft",
+            "hard"
+          ],
+          "description": "Initial timer mode: soft warns and continues; hard cancels. Omission is hard with maxSeconds and soft without it."
         },
         "denyPaths": {
           "type": "array",

package/generated/ControlRunSummary.schema.json

@@ -117,6 +117,7 @@
                     "pool_exhausted",
                     "pinned_limit",
                     "transport",
+                    "permission_denied",
                     "context_exhausted",
                     "wall_clock",
                     "cancelled",
@@ -124,7 +125,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": [
@@ -619,6 +620,65 @@
                   ],
                   "description": "Vendor-attested request refusal that another account cannot repair; input and executable causes carry their own evidence."
                 },
+                "captureFailure": {
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "capture_output_exceeded",
+                        "capture_output_incomplete",
+                        "capture_preview_truncated",
+                        "capture_failed"
+                      ]
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "causeCode": {
+                      "type": "string"
+                    },
+                    "bufferBudgetBytes": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "stream": {
+                      "type": "string",
+                      "enum": [
+                        "stdout",
+                        "stderr"
+                      ]
+                    },
+                    "drain": {
+                      "type": "string",
+                      "const": "truncated"
+                    },
+                    "cleanup": {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "code",
+                        "message"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "code",
+                    "message"
+                  ],
+                  "additionalProperties": false
+                },
                 "phase": {
                   "type": "string",
                   "default": "unknown",
@@ -790,6 +850,109 @@
                   "description": "The vendor's own typed failure for the attempt this record speaks for, or null when no vendor-typed evidence exists (every harness without such a channel, and any unreadable record). Facts only: carries no remedy.",
                   "default": null
                 },
+                "poolAttempts": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "harnessId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Harness the try ran on."
+                      },
+                      "profileId": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "Account row the try ran on; null = the harness default route."
+                      },
+                      "profileDisplayName": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "The row's display name at try time (redacted); null for the default route."
+                      },
+                      "requestedModel": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "Model the try asked for; null = the harness default model."
+                      },
+                      "attemptId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Attempt the try belongs to."
+                      },
+                      "tryIndex": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Zero-based try index within the attempt."
+                      },
+                      "observedAt": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "When the try's first error was observed."
+                      },
+                      "phase": {
+                        "type": "string",
+                        "enum": [
+                          "pre_start",
+                          "pre_progress",
+                          "after_progress"
+                        ],
+                        "description": "How far the try got: before a typed session start, after start but before agent progress, or after progress."
+                      },
+                      "category": {
+                        "type": "string",
+                        "enum": [
+                          "timeout",
+                          "rate_limited",
+                          "auth_failed",
+                          "capability_refused",
+                          "process_crash",
+                          "config_error",
+                          "unknown_harness_error"
+                        ],
+                        "description": "Typed failure category of the try; untyped errors are unknown_harness_error."
+                      },
+                      "error": {
+                        "type": "string",
+                        "description": "The try's own error text with its original wording and whitespace, redacted."
+                      },
+                      "vendorFailure": {
+                        "anyOf": [
+                          {
+                            "$ref": "#/definitions/ControlRunSummary/properties/failure/anyOf/0/properties/vendorFailure/anyOf/0"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "The vendor's own typed failure for this try, when the adapter attached one."
+                      }
+                    },
+                    "required": [
+                      "harnessId",
+                      "profileId",
+                      "profileDisplayName",
+                      "requestedModel",
+                      "attemptId",
+                      "tryIndex",
+                      "observedAt",
+                      "phase",
+                      "category",
+                      "error",
+                      "vendorFailure"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Per-try account attribution of a failed execution try (diagnostic evidence only)."
+                  },
+                  "default": [],
+                  "description": "Every failed execution try in order, each with its own account and error text; empty when no try failed (and for records written before this field existed)."
+                },
                 "nextActions": {
                   "type": "array",
                   "items": {