@claudexor/schema 4.8.1 → 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/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."

package/generated/ControlRunDetail.schema.json

@@ -1939,7 +1939,7 @@
                     "null"
                   ],
                   "default": null,
-                  "description": "GC-independent revert anchor."
+                  "description": "Run-owned revert anchor."
                 },
                 "revertable": {
                   "type": "boolean",
@@ -3206,6 +3206,37 @@
                 "default": false,
                 "description": "True only for adapter-declared text fragments. Consecutive deltas of the same textKind and attempt may be concatenated verbatim; complete messages and other events remain separate."
               },
+              "speechKey": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Adapter-issued key of the observed text block this row belongs to (the harness event's speech.key); compare by equality only. Null when no block lifecycle was exactly observed; such rows stay separate."
+              },
+              "speechOp": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "fragment",
+                      "complete",
+                      "abandoned"
+                    ],
+                    "description": "fragment: a verbatim streamed piece of the keyed text block; complete: the harness's complete text of that block (at most once per key); abandoned: the harness stated the block will never be completed (partial fragments stay as emitted)."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The harness event's speech.op on keyed rows; null otherwise.",
+                "default": null
+              },
+              "textFinal": {
+                "type": "boolean",
+                "default": false,
+                "description": "True only on the harness's typed final-answer text row (the harness event's final flag). It carries a speech key only when the adapter proved the link; otherwise it is a separate terminal result."
+              },
               "severity": {
                 "type": "string",
                 "enum": [

package/generated/ControlRunListResponse.schema.json

@@ -1761,7 +1761,7 @@
                       "null"
                     ],
                     "default": null,
-                    "description": "GC-independent revert anchor."
+                    "description": "Run-owned revert anchor."
                   },
                   "revertable": {
                     "type": "boolean",

package/generated/ControlRunSummary.schema.json

@@ -1756,7 +1756,7 @@
                 "null"
               ],
               "default": null,
-              "description": "GC-independent revert anchor."
+              "description": "Run-owned revert anchor."
             },
             "revertable": {
               "type": "boolean",

package/generated/ControlThreadDetail.schema.json

@@ -502,7 +502,7 @@
                               "null"
                             ],
                             "default": null,
-                            "description": "GC-independent revert anchor."
+                            "description": "Run-owned revert anchor."
                           },
                           "revertable": {
                             "type": "boolean",

package/generated/HarnessEvent.schema.json

@@ -492,6 +492,31 @@
           "type": "boolean",
           "description": "True on the harness's typed final-answer message (vendor terminal result); mid-run narration never sets it."
         },
+        "speech": {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Opaque adapter-issued key of one observed text block; equality only."
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "fragment",
+                "complete",
+                "abandoned"
+              ],
+              "description": "fragment: a verbatim streamed piece of the keyed text block; complete: the harness's complete text of that block (at most once per key); abandoned: the harness stated the block will never be completed (partial fragments stay as emitted)."
+            }
+          },
+          "required": [
+            "key",
+            "op"
+          ],
+          "additionalProperties": false,
+          "description": "Adapter-issued speech identity of a text event (fragment/complete on messages, abandoned on a status event); absent when no block lifecycle was exactly observed. A typed final never carries it unless the adapter proves the link."
+        },
         "tool": {
           "type": "object",
           "properties": {

package/generated/RunWaitManyInput.schema.json

@@ -15,10 +15,17 @@
                 "maxLength": 256
               },
               "seen": {
-                "type": "string",
-                "minLength": 43,
-                "maxLength": 43,
-                "pattern": "^[A-Za-z0-9_-]{43}$"
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 43,
+                    "maxLength": 43,
+                    "pattern": "^[A-Za-z0-9_-]{43}$"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
               }
             },
             "required": [

package/generated/ThreadHistoryPage.schema.json

@@ -518,7 +518,7 @@
                                 "null"
                               ],
                               "default": null,
-                              "description": "GC-independent revert anchor."
+                              "description": "Run-owned revert anchor."
                             },
                             "revertable": {
                               "type": "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "4.8.1",
+  "version": "4.8.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.8.1"
+    "@claudexor/util": "4.8.2"
   },
   "repository": {
     "type": "git",