@claudexor/schema 5.0.1 → 5.1.0

package/generated/ThreadRetireRequest.schema.json

@@ -0,0 +1,41 @@
+{
+  "$ref": "#/definitions/ThreadRetireRequest",
+  "definitions": {
+    "ThreadRetireRequest": {
+      "type": "object",
+      "properties": {
+        "operationId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The caller's durable release intent. Exactly one outcome is ever bound to it."
+        },
+        "exportId": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "closureDigest": {
+          "$ref": "#/definitions/ThreadRetireRequest/properties/exportId"
+        },
+        "contentDigest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$",
+          "description": "threadExportDigest over every byte the caller received."
+        },
+        "laneDigest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$",
+          "description": "threadExportDigest over the lane plane of the same transfer."
+        }
+      },
+      "required": [
+        "operationId",
+        "exportId",
+        "closureDigest",
+        "contentDigest",
+        "laneDigest"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ThreadRetirement.schema.json

@@ -0,0 +1,175 @@
+{
+  "$ref": "#/definitions/ThreadRetirement",
+  "definitions": {
+    "ThreadRetirement": {
+      "type": "object",
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "storeId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "threadId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "threadState": {
+          "type": "string",
+          "enum": [
+            "active",
+            "closed",
+            "trashed",
+            "purged"
+          ],
+          "description": "Thread lifecycle state: active, closed, trashed for recovery, or terminally purged."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "not_accepted",
+            "accepted_pending_removal",
+            "removed"
+          ],
+          "description": "accepted_pending_removal: durably purged; the named originals can no longer be promised back while cleanup is open. removed: every directory the purge owner deletes is gone."
+        },
+        "acceptance": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "operationId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The caller's durable release intent."
+                },
+                "exportId": {
+                  "type": "string",
+                  "description": "The manifest identity the caller transferred."
+                },
+                "closureDigest": {
+                  "type": "string",
+                  "description": "The engine-record identity at acceptance."
+                },
+                "contentDigest": {
+                  "type": "string",
+                  "description": "Every exported byte, re-hashed by the engine."
+                },
+                "laneDigest": {
+                  "type": "string",
+                  "description": "The lane bytes acceptance named for removal."
+                },
+                "acceptedAt": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "When the purge decision committed."
+                }
+              },
+              "required": [
+                "operationId",
+                "exportId",
+                "closureDigest",
+                "contentDigest",
+                "laneDigest",
+                "acceptedAt"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "cleanup": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "reason"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Present while removal is open; reason names the last failed attempt."
+        },
+        "operation": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "operationId": {
+                  "$ref": "#/definitions/ThreadRetirement/properties/threadId"
+                },
+                "outcome": {
+                  "type": "string",
+                  "enum": [
+                    "accepted",
+                    "refused",
+                    "abandoned"
+                  ]
+                },
+                "code": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The refusal's code; null when accepted or abandoned."
+                },
+                "message": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "settledAt": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "ISO-8601 timestamp string."
+                }
+              },
+              "required": [
+                "operationId",
+                "outcome",
+                "code",
+                "message",
+                "settledAt"
+              ],
+              "additionalProperties": false,
+              "description": "The one outcome bound to this operation; an absent record settles nothing."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The addressed operation's settled outcome. Null means no outcome is bound yet: an in-flight request may still settle it, so null never releases a caller's intent."
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "storeId",
+        "threadId",
+        "threadState",
+        "status",
+        "acceptance",
+        "cleanup",
+        "operation"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ThreadTurn.schema.json

@@ -169,7 +169,7 @@
                 "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."
+                  "description": "True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay or a managed resource it names was released."
                 },
                 "required_actions": {
                   "type": "array",

package/generated/WorkspaceEnvelope.schema.json

@@ -78,7 +78,7 @@
         "policy_profile": {
           "type": "string",
           "default": "workspace_write",
-          "description": "Access profile the envelope enforces."
+          "description": "Access profile recorded for the envelope."
         },
         "dirty_policy": {
           "type": "string",

package/generated/WorkspacePreparedPayload.schema.json

@@ -0,0 +1,67 @@
+{
+  "$ref": "#/definitions/WorkspacePreparedPayload",
+  "definitions": {
+    "WorkspacePreparedPayload": {
+      "type": "object",
+      "properties": {
+        "attempt_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Attempt that first runs in the prepared copy."
+        },
+        "source_root": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Folder the selected paths were resolved against."
+        },
+        "scope_paths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Selected input paths exactly as requested; empty when none were selected."
+        },
+        "copied": {
+          "type": "object",
+          "properties": {
+            "files": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "directories": {
+              "$ref": "#/definitions/WorkspacePreparedPayload/properties/copied/properties/files"
+            },
+            "symlinks": {
+              "$ref": "#/definitions/WorkspacePreparedPayload/properties/copied/properties/files"
+            }
+          },
+          "required": [
+            "files",
+            "directories",
+            "symlinks"
+          ],
+          "additionalProperties": false,
+          "description": "Entries copied into the isolated copy; symbolic links are copied as links, not followed."
+        },
+        "missing_paths": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/WorkspacePreparedPayload/properties/scope_paths/items"
+          },
+          "description": "Selected paths that did not exist under source_root when the copy was prepared."
+        }
+      },
+      "required": [
+        "attempt_id",
+        "source_root",
+        "scope_paths",
+        "copied",
+        "missing_paths"
+      ],
+      "additionalProperties": false,
+      "description": "Validated payload of a workspace.prepared run event (isolated directory copy)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "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": "5.0.1"
+    "@claudexor/util": "5.1.0"
   },
   "repository": {
     "type": "git",