@claudexor/schema 4.8.2 → 5.0.2

package/generated/ControlProjectRemoveReceipt.schema.json

@@ -39,6 +39,42 @@
           "type": "string",
           "const": "snapshot",
           "description": "How the live/queued-run fence was evaluated. Always 'snapshot': the daemon reads its in-process activity projection and removes the project in the same synchronous turn, with no await between the snapshot and registry/partition mutation."
+        },
+        "purgedThreads": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "threadId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The thread that was in the project's trash and is now purged."
+              },
+              "cleanup": {
+                "type": "string",
+                "enum": [
+                  "completed",
+                  "pending"
+                ],
+                "description": "completed: every directory the thread purge owns is deleted. pending: the purge is committed but that deletion did not finish; the engine retries it when the daemon next starts."
+              },
+              "cleanupError": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "description": "Why the deletion did not finish; null when cleanup completed."
+              }
+            },
+            "required": [
+              "threadId",
+              "cleanup",
+              "cleanupError"
+            ],
+            "additionalProperties": false,
+            "description": "A trashed thread purged together with its project."
+          },
+          "description": "Present only when the request opted in with trashedThreads=purge: every thread that was in the project's trash, purged in the same store transaction that retired the project. Absent on a default removal."
         }
       },
       "required": [

package/generated/ControlQuotaQueryResponse.schema.json

@@ -406,8 +406,16 @@
                         "minLength": 1
                       },
                       "profile_id": {
-                        "type": "string",
-                        "minLength": 1
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Registered account id; null names the harness's default API-key route, which is not an account."
                       }
                     },
                     "required": [
@@ -416,6 +424,11 @@
                     ],
                     "additionalProperties": false
                   },
+                  "credential_fingerprint": {
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{16}$",
+                    "description": "Non-secret identity of the API key this row was read with. Present only on API-key rows; a row is published only while it matches the key requests would send now."
+                  },
                   "balances": {
                     "type": "object",
                     "properties": {
@@ -647,6 +660,37 @@
                                     "string",
                                     "null"
                                   ]
+                                },
+                                "capped": {
+                                  "type": [
+                                    "boolean",
+                                    "null"
+                                  ],
+                                  "description": "true: the provider reports a cap in limit; false: it reports no cap, so a null limit is not unknown and not unlimited money; null or absent: not established."
+                                },
+                                "remaining": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ],
+                                  "description": "Provider-reported amount left under limit in the current window, with its sign; null when not reported."
+                                },
+                                "window": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string",
+                                      "enum": [
+                                        "day",
+                                        "week",
+                                        "month",
+                                        "lifetime"
+                                      ]
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "description": "Provider calendar window that used counts (UTC); when capped, limit resets at its end and lifetime never resets. resets_at is set only from a provider-reported instant."
                                 }
                               },
                               "required": [

package/generated/ControlQuotaReadRequest.schema.json

@@ -24,6 +24,10 @@
             "constraint_freshness",
             "resources_freshness"
           ]
+        },
+        "includeApiKeys": {
+          "type": "boolean",
+          "description": "With a resources view, add API-key rows: registered API-key accounts and each harness's default API-key route (target.profile_id null)."
         }
       },
       "additionalProperties": false,

package/generated/ControlQuotaRefreshRequest.schema.json

@@ -12,15 +12,24 @@
               "minLength": 1
             },
             "profile_id": {
-              "type": "string",
-              "minLength": 1
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Registered account id; null names the harness's default API-key route, which is not an account."
             }
           },
           "required": [
             "harness",
             "profile_id"
           ],
-          "additionalProperties": false
+          "additionalProperties": false,
+          "description": "Exact refresh subject. A null profile_id (the default API-key route) and registered API-key accounts require includeApiKeys=true."
         },
         "requestKind": {
           "type": "string",

package/generated/ControlRouteHealth.schema.json

@@ -0,0 +1,202 @@
+{
+  "$ref": "#/definitions/ControlRouteHealth",
+  "definitions": {
+    "ControlRouteHealth": {
+      "type": "object",
+      "properties": {
+        "windowDays": {
+          "type": "number",
+          "const": 7,
+          "description": "Length of the fixed window in days."
+        },
+        "from": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Start of the window: generatedAt minus windowDays. The window holds the terminal product runs created at or after it."
+        },
+        "generatedAt": {
+          "type": "string",
+          "minLength": 1,
+          "description": "When the daemon computed this answer; nothing is stored."
+        },
+        "scannedRuns": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Terminal product runs read inside the window; the sum of every route's runs."
+        },
+        "complete": {
+          "type": "boolean",
+          "description": "True when the scan reached the window start or the end of the retained run records (the engine keeps terminal records for at least thirty days, longer than the window); false when it stopped early."
+        },
+        "incompleteReason": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "scan_bound"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Why the scan stopped early: scan_bound means the fixed newest-first record bound was reached inside the window, so older runs of the window are not counted. Null when complete."
+        },
+        "routes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "harnessId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Harness of the route: the run's settled route harness, else its failure's harness, else its primary harness, else unknown."
+              },
+              "access": {
+                "type": "string",
+                "enum": [
+                  "readonly",
+                  "workspace_write",
+                  "full",
+                  "inherit_native",
+                  "unknown"
+                ],
+                "description": "Effective access profile the engine enforced; unknown when the run recorded none. The retired external_sandbox_full counts as full."
+              },
+              "runs": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Terminal product runs of the route created inside the window; always succeeded + failed + cancelled + other."
+              },
+              "succeeded": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Runs whose lifecycle ended succeeded."
+              },
+              "failed": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Runs whose lifecycle ended failed."
+              },
+              "cancelled": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Runs whose lifecycle ended cancelled or interrupted."
+              },
+              "other": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Runs in any other terminal lifecycle."
+              },
+              "topFailures": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "category": {
+                      "type": "string",
+                      "enum": [
+                        "validation",
+                        "project",
+                        "auth",
+                        "harness_unavailable",
+                        "harness_error",
+                        "config_error",
+                        "budget",
+                        "policy",
+                        "cancelled",
+                        "internal",
+                        "unknown"
+                      ],
+                      "description": "Typed failure category shared by every run in the group; unknown when the run left no typed failure record."
+                    },
+                    "code": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "finite_zero",
+                            "hard_cap",
+                            "estimate_headroom",
+                            "unknown_paid_in_flight",
+                            "budget_overshoot",
+                            "cost_unverifiable",
+                            "delegation_child_drain_timeout",
+                            "subscription_window_exhausted",
+                            "credential_pool_exhausted",
+                            "input_too_large",
+                            "raw_context_mandatory_unavailable",
+                            "raw_context_exceeds_window",
+                            "model_catalog_unavailable",
+                            "vendor_cli_too_old",
+                            "credential_source_unconfirmed",
+                            "delegated_home_unavailable",
+                            "delegated_confinement_unavailable",
+                            "delegated_evidence_incomplete",
+                            "access_profile_incompatible",
+                            "auxiliary_writable_roots_unsupported",
+                            "retired_access_profile"
+                          ],
+                          "description": "Machine-readable failure sub-code within a RunFailure category, including historical delegated-run failures and active access-profile refusals."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Failure sub-code shared by the group; null when the failures carried none."
+                    },
+                    "message": {
+                      "type": "string",
+                      "maxLength": 160,
+                      "description": "First line of the failures' display-safe message, redacted and cut to 160 characters; empty when the run left no message."
+                    },
+                    "count": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "description": "Failed runs of the route in this group."
+                    }
+                  },
+                  "required": [
+                    "category",
+                    "code",
+                    "message",
+                    "count"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One group of a route's failed runs, keyed by category, code and message."
+                },
+                "maxItems": 3,
+                "description": "At most three groups of the route's failed runs, most frequent first."
+              }
+            },
+            "required": [
+              "harnessId",
+              "access",
+              "runs",
+              "succeeded",
+              "failed",
+              "cancelled",
+              "other",
+              "topFailures"
+            ],
+            "additionalProperties": false,
+            "description": "Outcome counts of one route (harness x effective access) inside the window."
+          },
+          "description": "Every route with at least one run in the window, sorted by harnessId, then access."
+        }
+      },
+      "required": [
+        "windowDays",
+        "from",
+        "generatedAt",
+        "scannedRuns",
+        "complete",
+        "incompleteReason",
+        "routes"
+      ],
+      "additionalProperties": false,
+      "description": "Per-route run outcomes over the last seven days, computed on demand from retained run records. Facts only: no thresholds, no alarms."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}