@claudexor/schema 4.3.1 → 4.4.0

package/generated/ControlDaemonStatus.schema.json

@@ -500,6 +500,28 @@
                         }
                       ],
                       "description": "Longest COMMIT call; null before the first."
+                    },
+                    "p50_ms": {
+                      "anyOf": [
+                        {
+                          "$ref": "#/definitions/ControlDaemonStatus/properties/store/properties/flusher/anyOf/0/properties/interval_ms"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Lifetime COMMIT p50, microsecond histogram with two significant digits; absent on older engines."
+                    },
+                    "p99_ms": {
+                      "anyOf": [
+                        {
+                          "$ref": "#/definitions/ControlDaemonStatus/properties/store/properties/flusher/anyOf/0/properties/interval_ms"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Lifetime COMMIT p99, microsecond histogram with two significant digits; absent on older engines."
                     }
                   },
                   "required": [
@@ -605,6 +627,153 @@
           ],
           "additionalProperties": false
         },
+        "timing": {
+          "type": "object",
+          "properties": {
+            "windowMs": {
+              "anyOf": [
+                {
+                  "type": "number",
+                  "minimum": 0
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "windowEndedAt": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlDaemonStatus/properties/memory/properties/atAdmission/anyOf/0/properties/at"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "ISO-8601 timestamp string."
+            },
+            "routes": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "method": {
+                    "type": "string"
+                  },
+                  "route": {
+                    "type": "string"
+                  },
+                  "lifetime": {
+                    "type": "object",
+                    "properties": {
+                      "count": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "p50Ms": {
+                        "anyOf": [
+                          {
+                            "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "p99Ms": {
+                        "anyOf": [
+                          {
+                            "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "maxMs": {
+                        "anyOf": [
+                          {
+                            "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      }
+                    },
+                    "required": [
+                      "count",
+                      "p50Ms",
+                      "p99Ms",
+                      "maxMs"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "window": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/routes/items/properties/lifetime"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "method",
+                  "route",
+                  "lifetime",
+                  "window"
+                ],
+                "additionalProperties": false
+              },
+              "maxItems": 256,
+              "description": "Completed responses or disconnects by method and catalog template (never raw URLs). SSE latency includes the stream lifetime. At most 256 keys including OTHER <unmatched>. Fixed histograms use microseconds and two significant digits; max is exact to a microsecond. Window is the last completed loop-facts window, null before the first; empty windows have count zero and null latencies."
+            },
+            "worstSync": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "operation": {
+                    "type": "string",
+                    "enum": [
+                      "store.begin_immediate",
+                      "store.commit",
+                      "store.external_write",
+                      "control.run_detail",
+                      "control.run_summary",
+                      "scope.persist"
+                    ]
+                  },
+                  "durationMs": {
+                    "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
+                  },
+                  "at": {
+                    "$ref": "#/definitions/ControlDaemonStatus/properties/memory/properties/atAdmission/anyOf/0/properties/at"
+                  }
+                },
+                "required": [
+                  "operation",
+                  "durationMs",
+                  "at"
+                ],
+                "additionalProperties": false
+              },
+              "maxItems": 32,
+              "description": "The 32 longest instrumented synchronous sections since process start, descending by duration, retaining later samples on ties. Labels contain no SQL, paths, IDs or payloads. Scope persistence measures synchronous serialization only; its file writes are asynchronous. Sections can overlap; these facts do not attribute a stall to disk or another cause."
+            }
+          },
+          "required": [
+            "windowMs",
+            "windowEndedAt",
+            "routes",
+            "worstSync"
+          ],
+          "additionalProperties": false,
+          "description": "Bounded process timing facts; absent on older engines."
+        },
         "loop": {
           "anyOf": [
             {
@@ -633,14 +802,13 @@
                           "minimum": 0
                         },
                         "p50Ms": {
-                          "type": "number",
-                          "minimum": 0
+                          "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
                         },
                         "p99Ms": {
-                          "$ref": "#/definitions/ControlDaemonStatus/properties/loop/anyOf/0/properties/delay/anyOf/0/properties/p50Ms"
+                          "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
                         },
                         "maxMs": {
-                          "$ref": "#/definitions/ControlDaemonStatus/properties/loop/anyOf/0/properties/delay/anyOf/0/properties/p50Ms"
+                          "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
                         }
                       },
                       "required": [
@@ -679,10 +847,10 @@
                       "minimum": 0
                     },
                     "totalMs": {
-                      "$ref": "#/definitions/ControlDaemonStatus/properties/loop/anyOf/0/properties/delay/anyOf/0/properties/p50Ms"
+                      "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
                     },
                     "maxMs": {
-                      "$ref": "#/definitions/ControlDaemonStatus/properties/loop/anyOf/0/properties/delay/anyOf/0/properties/p50Ms"
+                      "$ref": "#/definitions/ControlDaemonStatus/properties/timing/properties/windowMs/anyOf/0"
                     }
                   },
                   "required": [

package/generated/ControlGcReceipt.schema.json

@@ -61,7 +61,7 @@
               },
               "project_root": {
                 "type": "string",
-                "description": "Canonical project root owning the run tree."
+                "description": "Canonical project root, or the owned runtime namespace when no project record remains."
               },
               "freed_bytes": {
                 "type": "integer",
@@ -159,6 +159,86 @@
           },
           "description": "Names of top-level entries in the Claudexor-owned data root that the engine does not own and will never touch (advisory only — nothing here is ever deleted). The full sorted list. Present ONLY when the request opted in via data_root_report; ABSENT (not empty) when the request did not opt in, the scan failed, or the serving daemon predates the feature; a scan failure is disclosed in errors instead."
         },
+        "native_homes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "harness_id": {
+                "type": "string"
+              },
+              "profile_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "home": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "checked",
+                  "not_pruned"
+                ]
+              },
+              "reason": {
+                "type": "string"
+              },
+              "deleted_files": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "errors": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "freed_bytes": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "kept_referenced": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "kept_recent": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "kept_unknown": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "truncated": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "harness_id",
+              "profile_id",
+              "home",
+              "status",
+              "reason",
+              "deleted_files",
+              "errors",
+              "freed_bytes",
+              "kept_referenced",
+              "kept_recent",
+              "kept_unknown",
+              "truncated"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Per-home adapter retirement decisions; present only when native_home_report was requested. Unknown vendor data and unreadable references are kept with a reason."
+        },
         "model_payloads": {
           "type": "object",
           "properties": {

package/generated/ControlGcRequest.schema.json

@@ -17,6 +17,10 @@
           "type": "boolean",
           "description": "Opt in to the advisory data-root scan: when true, the receipt carries data_root_unrecognized. Capability negotiation for engine-version skew — a client omits this unless the serving daemon is the SAME engine version, so an older daemon never sees the unknown request key and an older client never receives the unknown receipt key."
         },
+        "native_home_report": {
+          "type": "boolean",
+          "description": "Include adapter-owned native-home retirement outcomes. Cleanup always runs; lockstep opt-in keeps older strict clients compatible."
+        },
         "trash_purge_report": {
           "type": "boolean",
           "description": "Opt in to the thread-purge disclosure: when true, the receipt carries purged_threads and purge_leftovers. The purges themselves always run; the same lockstep capability negotiation as data_root_report keeps older strict receipt readers compatible."

package/generated/ControlHandshakeResponse.schema.json

@@ -16,6 +16,11 @@
           "type": "string",
           "const": "/v2/operations"
         },
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Immutable UUID of the durable engine store, stable across restarts; a run 404 is meaningful only with the same storeId. Returned only to a request sending `X-Claudexor-Store-Identity: 1` (older strict clients keep the legacy shape); absent when the store is unavailable or the daemon predates this field."
+        },
         "engine": {
           "type": "object",
           "properties": {

package/generated/ControlRunEventPart.schema.json

@@ -0,0 +1,140 @@
+{
+  "$ref": "#/definitions/ControlRunEventPart",
+  "definitions": {
+    "ControlRunEventPart": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Canonical run id."
+        },
+        "seq": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Durable seq of the event (its event-stream id)."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "run.created",
+            "task.contract.created",
+            "context.pack.created",
+            "project.git.initialized",
+            "project.claude_bridge.created",
+            "budget.lease.created",
+            "budget.observation",
+            "budget.cash",
+            "policy.web.upgraded",
+            "harness.started",
+            "harness.event",
+            "harness.completed",
+            "route.fallback.started",
+            "route.fallback.completed",
+            "route.fallback.exhausted",
+            "route.transient.detected",
+            "route.transient.retry_scheduled",
+            "route.profile.headroom_exceeded",
+            "route.profile.rotated",
+            "route.profile.rotation_exhausted",
+            "route.profile.credential_unusable",
+            "route.account.pool_selected",
+            "route.account.lane_switch",
+            "route.account.pool_exhausted",
+            "route.transient.exhausted",
+            "route.fallback.auth_switched",
+            "route.primary.diverged",
+            "route.pool.degraded",
+            "session.continuity",
+            "interaction.requested",
+            "interaction.answered",
+            "interaction.timeout",
+            "interaction.answer_discarded",
+            "interaction.withdrawn",
+            "message.accepted",
+            "message.delivered",
+            "message.refused",
+            "plan.progress",
+            "plan.questions",
+            "plan.brief.materialized",
+            "council.started",
+            "council.draft",
+            "council.member.failed",
+            "council.merged",
+            "budget.quota_pressure",
+            "delegation.belt.unavailable",
+            "delegation.belt.degraded",
+            "output.ready",
+            "gate.started",
+            "gate.completed",
+            "review.preflight",
+            "review.started",
+            "review.skipped",
+            "reviewer.started",
+            "reviewer.first_event",
+            "reviewer.auth_switched",
+            "reviewer.completed",
+            "reviewer.timed_out",
+            "reviewer.failed",
+            "finding.revalidated",
+            "synthesis.started",
+            "arbitration.completed",
+            "work_product.emitted",
+            "work_product.adopted",
+            "control.requested",
+            "control.applied",
+            "control.rejected",
+            "run.blocked",
+            "run.completed",
+            "run.failed",
+            "run.continuation",
+            "run.continuation.denied",
+            "run.continuity",
+            "workspace.retained"
+          ],
+          "description": "Type of an append-only run event, covering run lifecycle, contract/context creation, budget, routing fallbacks, harness activity, interactions, gates, review, arbitration, work products, and control verbs."
+        },
+        "totalBytes": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "UTF-8 byte length of the event's complete stream serialization: the redacted JSON line the run event stream delivers."
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$",
+          "description": "SHA-256 of all totalBytes; verify the reassembled text before parsing it."
+        },
+        "offset": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "UTF-8 byte offset where this part starts."
+        },
+        "nextOffset": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Where the next part starts; equal to totalBytes when this part ends the event."
+        },
+        "text": {
+          "type": "string",
+          "description": "Bytes [offset, nextOffset) decoded as UTF-8; a boundary never splits a character."
+        }
+      },
+      "required": [
+        "runId",
+        "seq",
+        "type",
+        "totalBytes",
+        "sha256",
+        "offset",
+        "nextOffset",
+        "text"
+      ],
+      "additionalProperties": false,
+      "description": "One bounded part of a single validated run event, read from the run's own event log by run id and seq. Concatenate parts in offset order until nextOffset equals totalBytes; only then is the event consumed."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/GlobalConfig.schema.json

@@ -313,7 +313,7 @@
               "type": "integer",
               "minimum": 0,
               "default": 20,
-              "description": "The newest N runs per project always survive, regardless of age."
+              "description": "The newest N runs survive for active registrations (even with missing roots), archived registrations whose roots exist, and the built-in no-project scope. Orphaned namespaces have no keep-last protection."
             }
           },
           "additionalProperties": false,

package/generated/McpRunEventReadInput.schema.json

@@ -0,0 +1,41 @@
+{
+  "$ref": "#/definitions/McpRunEventReadInput",
+  "definitions": {
+    "McpRunEventReadInput": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "seq": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "The event to read, e.g. claudexor_run_wait's oversizedEvent.seq."
+        },
+        "offset": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "default": 0,
+          "description": "0, or the previous part's nextOffset."
+        },
+        "maxBytes": {
+          "type": "integer",
+          "minimum": 4,
+          "maximum": 65536,
+          "default": 32768,
+          "description": "Upper bound of this part's UTF-8 bytes; a part may end earlier at a character boundary."
+        }
+      },
+      "required": [
+        "runId",
+        "seq"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}