@claudexor/schema 4.7.0 → 4.8.2

package/generated/ControlGcLastResponse.schema.json

@@ -0,0 +1,184 @@
+{
+  "$ref": "#/definitions/ControlGcLastResponse",
+  "definitions": {
+    "ControlGcLastResponse": {
+      "type": "object",
+      "properties": {
+        "last": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "outcome": {
+                  "type": "string",
+                  "enum": [
+                    "completed",
+                    "held",
+                    "truncated",
+                    "failed"
+                  ]
+                },
+                "started_at": {
+                  "type": "string"
+                },
+                "finished_at": {
+                  "type": "string"
+                },
+                "freed_bytes": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "kept": {
+                  "type": "object",
+                  "properties": {
+                    "active": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    },
+                    "recent": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    },
+                    "young": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    },
+                    "referenced": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    },
+                    "actionable": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    },
+                    "unknown_state": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Survivor counts per keep reason."
+                },
+                "held": {
+                  "type": "object",
+                  "properties": {
+                    "roots": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0
+                    },
+                    "native_homes": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "default": 0,
+                      "description": "Vetoed native homes only; unsupported adapters and unknown native entries are informational."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Held project roots and vetoed native homes, separate from run counts."
+                },
+                "holds": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "class": {
+                        "type": "string",
+                        "enum": [
+                          "missing_partition",
+                          "unbound_active_registration",
+                          "recovery_pending",
+                          "namespace_unreadable",
+                          "anchor_references_unreadable",
+                          "references_changed",
+                          "native_home_veto",
+                          "cleanup_suppressed"
+                        ]
+                      },
+                      "count": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0
+                      },
+                      "example": {
+                        "type": "string",
+                        "maxLength": 160
+                      },
+                      "since": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "class",
+                      "count",
+                      "example",
+                      "since"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "maxItems": 8
+                },
+                "errors": {
+                  "type": "object",
+                  "properties": {
+                    "count": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "first": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "maxLength": 512
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  },
+                  "required": [
+                    "count",
+                    "first"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "outcome",
+                "started_at",
+                "finished_at",
+                "freed_bytes",
+                "kept",
+                "held",
+                "holds",
+                "errors"
+              ],
+              "additionalProperties": false,
+              "description": "One durable non-preview pass summary (at most 16 KiB), including outer cleanup failures."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Null when no readable non-preview pass has been recorded; reading never starts GC."
+        },
+        "diagnostic": {
+          "type": "string",
+          "maxLength": 512,
+          "description": "Why the stored summary could not be read; absent when no record exists or it is valid."
+        }
+      },
+      "required": [
+        "last"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlGcReceipt.schema.json

@@ -116,6 +116,64 @@
           "additionalProperties": false,
           "description": "Why every surviving candidate survived."
         },
+        "held": {
+          "type": "object",
+          "properties": {
+            "roots": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            },
+            "native_homes": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "description": "Vetoed native homes only; unsupported adapters and unknown native entries are informational."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Held project roots and vetoed native homes, separate from run counts.",
+          "default": {}
+        },
+        "holds": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "class": {
+                "type": "string",
+                "enum": [
+                  "missing_partition",
+                  "unbound_active_registration",
+                  "recovery_pending",
+                  "namespace_unreadable",
+                  "anchor_references_unreadable",
+                  "references_changed",
+                  "native_home_veto",
+                  "cleanup_suppressed"
+                ]
+              },
+              "count": {
+                "type": "integer",
+                "exclusiveMinimum": 0
+              },
+              "example": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "class",
+              "count",
+              "example"
+            ],
+            "additionalProperties": false
+          },
+          "default": []
+        },
+        "truncated": {
+          "type": "boolean",
+          "default": false
+        },
         "deleted_reviews": {
           "type": "array",
           "items": {
@@ -215,7 +273,8 @@
               },
               "kept_unknown": {
                 "type": "integer",
-                "minimum": 0
+                "minimum": 0,
+                "description": "Unknown native entries preserved without a hold; informational only."
               },
               "truncated": {
                 "type": "boolean"

package/generated/ControlGcRequest.schema.json

@@ -9,6 +9,10 @@
           "default": false,
           "description": "Report what WOULD be deleted without touching disk."
         },
+        "retention_report": {
+          "type": "boolean",
+          "description": "Include typed holds, root/home counts and truncation; lockstep clients only."
+        },
         "model_payload_report": {
           "type": "boolean",
           "description": "Include exact model-purpose resource cleanup outcomes. Cleanup itself always runs; opt-in keeps older strict receipt readers compatible."

package/generated/ControlQueuedRunInfo.schema.json

@@ -4,6 +4,16 @@
     "ControlQueuedRunInfo": {
       "type": "object",
       "properties": {
+        "taskGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Caller-generated UUID saved before launching the first member. Each job still needs its own idempotency key; the group grants no execution authority."
+        },
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Identity of the durable engine store that accepted this group member, stable across restarts."
+        },
         "jobId": {
           "type": "string",
           "description": "Daemon job id."

package/generated/ControlQuotaFreshnessResponse.schema.json

@@ -171,6 +171,7 @@
                   "claude_oauth_usage",
                   "agy_command_usage",
                   "cursor_rate_limit",
+                  "grok_rate_limit",
                   "claude_rate_limit_event",
                   "codex_app_server_event",
                   "codex_image_response"

package/generated/ControlQuotaQueryResponse.schema.json

@@ -163,6 +163,7 @@
                       "claude_oauth_usage",
                       "agy_command_usage",
                       "cursor_rate_limit",
+                      "grok_rate_limit",
                       "claude_rate_limit_event",
                       "codex_app_server_event",
                       "codex_image_response"

package/generated/ControlQuotaResponse.schema.json

@@ -161,6 +161,7 @@
                   "claude_oauth_usage",
                   "agy_command_usage",
                   "cursor_rate_limit",
+                  "grok_rate_limit",
                   "claude_rate_limit_event",
                   "codex_app_server_event",
                   "codex_image_response"

package/generated/ControlRunAgainDraft.schema.json

@@ -50,6 +50,11 @@
               "description": "Canonical run mode: ask and plan are read-only, agent writes. Strategy controls are separate schema-owned fields, never modes.",
               "default": "agent"
             },
+            "taskGroupId": {
+              "type": "string",
+              "format": "uuid",
+              "description": "Caller-generated UUID saved before launching the first member. Each job still needs its own idempotency key; the group grants no execution authority."
+            },
             "scope": {
               "anyOf": [
                 {

package/generated/ControlRunControlResponse.schema.json

@@ -35,6 +35,175 @@
         "message": {
           "type": "string",
           "description": "Human-readable detail."
+        },
+        "deferredMessage": {
+          "type": "object",
+          "properties": {
+            "draftId": {
+              "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+            },
+            "revision": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "state": {
+              "type": "string",
+              "enum": [
+                "waiting",
+                "held",
+                "dispatched",
+                "cleared"
+              ]
+            },
+            "predecessorJobId": {
+              "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+            },
+            "predecessorRunId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            },
+            "predecessorResult": {
+              "type": "string",
+              "description": "Existing addressed run-detail/result path; no duplicate result store."
+            },
+            "hold": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "predecessor_failed",
+                        "predecessor_cancelled",
+                        "predecessor_interrupted",
+                        "predecessor_needs_input",
+                        "predecessor_incomplete",
+                        "predecessor_facts_unavailable",
+                        "predecessor_work_unverified",
+                        "predecessor_checks_failed",
+                        "predecessor_review_blocked",
+                        "predecessor_output_unavailable",
+                        "settlement_unknown",
+                        "stop_requested",
+                        "shutdown",
+                        "restart_requires_controller",
+                        "partition_retired",
+                        "admission_refused"
+                      ]
+                    },
+                    "problem": {
+                      "type": "object",
+                      "properties": {
+                        "message": {
+                          "type": "string",
+                          "description": "Human-readable refusal message."
+                        },
+                        "code": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "default": null,
+                          "description": "Machine-readable refusal code carried from the throwing gate; null when the failure had no typed code."
+                        },
+                        "retryable": {
+                          "type": "boolean",
+                          "default": true,
+                          "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay."
+                        },
+                        "required_actions": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 512
+                          },
+                          "maxItems": 16,
+                          "default": [],
+                          "description": "Bounded user actions that may make an exact retry succeed."
+                        },
+                        "context": {
+                          "type": "object",
+                          "additionalProperties": {},
+                          "default": {},
+                          "description": "Bounded typed recovery context; never arbitrary provider or environment output."
+                        }
+                      },
+                      "required": [
+                        "message"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Typed, sanitized problem for a thread turn that could not start."
+                    }
+                  },
+                  "required": [
+                    "code"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Stable hold. Editing, observation and readiness restoration never rearm it; inspect the predecessor result and clear before an ordinary continuation."
+            },
+            "dispatchedRevision": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/deferredMessage/properties/revision"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "successorJobId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            },
+            "successorRunId": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Non-empty identifier string."
+            }
+          },
+          "required": [
+            "draftId",
+            "revision",
+            "state",
+            "predecessorJobId",
+            "predecessorRunId",
+            "predecessorResult",
+            "hold",
+            "dispatchedRevision",
+            "successorJobId",
+            "successorRunId"
+          ],
+          "additionalProperties": false,
+          "description": "The run's latest next-message draft after this cancel: a waiting draft is held by the same call; an already accepted successor is named, not cancelled."
         }
       },
       "required": [

package/generated/ControlRunDecisionResponse.schema.json

@@ -24,6 +24,20 @@
           "minLength": 1,
           "description": "New run id when the decision re-enqueues a turn (rerun_with_feedback)."
         },
+        "newJobId": {
+          "$ref": "#/definitions/ControlRunDecisionResponse/properties/newRunId",
+          "description": "Accepted job handle of the re-enqueued work, present even before its run binds."
+        },
+        "taskGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Caller-generated UUID saved before launching the first member. Each job still needs its own idempotency key; the group grants no execution authority."
+        },
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Identity of the durable engine store that accepted this group member, stable across restarts."
+        },
         "message": {
           "type": "string",
           "description": "Human-readable detail."