@claudexor/schema 3.10.4 → 3.11.0

package/generated/UsageCostSummary.schema.json

@@ -0,0 +1,44 @@
+{
+  "$ref": "#/definitions/UsageCostSummary",
+  "definitions": {
+    "UsageCostSummary": {
+      "type": "object",
+      "properties": {
+        "cashUsd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "valuationUsd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "unknownUsd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "cashKnowledge": {
+          "type": "string",
+          "enum": [
+            "exact",
+            "estimated",
+            "unknown"
+          ],
+          "description": "Quality of incremental-cash cost evidence for an operation."
+        },
+        "valuationKnowledge": {
+          "$ref": "#/definitions/UsageCostSummary/properties/cashKnowledge"
+        }
+      },
+      "required": [
+        "cashUsd",
+        "valuationUsd",
+        "unknownUsd",
+        "cashKnowledge",
+        "valuationKnowledge"
+      ],
+      "additionalProperties": false,
+      "description": "Observed usage components. An amount of unknown meaning is not charged cash; separately proven included service can still establish exact zero incremental cash."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/WorkProduct.schema.json

@@ -14,9 +14,10 @@
           "enum": [
             "patch",
             "new_repo",
-            "report"
+            "report",
+            "files"
           ],
-          "description": "Kind of work product a run produces: a patch against the base tree, a newly created repository, or a report document."
+          "description": "Kind of work product: Git patch, new repository, report, or complete directory file manifest with retained bytes."
         },
         "source_task_id": {
           "type": "string",
@@ -49,7 +50,7 @@
         "source_task_id"
       ],
       "additionalProperties": false,
-      "description": "The deliverable a run produced (patch, new repo, or report), referenced by apply/delivery verbs."
+      "description": "The deliverable a run produced, referenced by apply/delivery verbs; files uses files.manifest and meta.manifest_sha256."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/WorkspaceEnvelope.schema.json

@@ -24,8 +24,11 @@
           "description": "Absolute path of the source repository root."
         },
         "base_ref": {
-          "type": "string",
-          "description": "Git ref the checkout was created from."
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Git base ref; null for directory execution."
         },
         "base_sha": {
           "type": [
@@ -37,11 +40,28 @@
         },
         "worktree_path": {
           "type": "string",
-          "description": "Absolute path of the isolated Git checkout."
+          "description": "Absolute actual execution directory, whether Git-backed or plain."
         },
         "branch_name": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Clone-local branch; null for directory execution."
+        },
+        "workspace_kind": {
           "type": "string",
-          "description": "Clone-local branch created for the checkout."
+          "enum": [
+            "git",
+            "directory"
+          ]
+        },
+        "scope_paths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
         },
         "home_dir": {
           "type": "string",
@@ -87,7 +107,7 @@
         "created_at"
       ],
       "additionalProperties": false,
-      "description": "An isolated execution envelope: a private Git checkout plus scoped env/HOME/harness-config isolation."
+      "description": "Execution directory and scoped HOME/configs. Git checkouts retain their Git identity; directory execution uses a selected copy or the live source without Git initialization."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/WorkspaceFilesManifest.schema.json

@@ -0,0 +1,160 @@
+{
+  "$ref": "#/definitions/WorkspaceFilesManifest",
+  "definitions": {
+    "WorkspaceFilesManifest": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "number",
+          "const": 1
+        },
+        "sourceRoot": {
+          "type": "string",
+          "minLength": 1
+        },
+        "executionRoot": {
+          "type": "string",
+          "minLength": 1
+        },
+        "isolation": {
+          "type": "string",
+          "enum": [
+            "live",
+            "envelope"
+          ]
+        },
+        "scopePaths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "complete": {
+          "type": "boolean",
+          "description": "Complete bytes for the declared footprint, not a whole-source-tree claim."
+        },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "$ref": "#/definitions/WorkspaceFilesManifest/properties/scopePaths/items"
+              },
+              "before": {
+                "anyOf": [
+                  {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "const": "file"
+                          },
+                          "sha256": {
+                            "type": "string",
+                            "pattern": "^sha256:[a-f0-9]{64}$"
+                          },
+                          "sizeBytes": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "mode": {
+                            "type": "integer",
+                            "minimum": 0
+                          },
+                          "artifactPath": {
+                            "$ref": "#/definitions/WorkspaceFilesManifest/properties/entries/items/properties/path"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "sha256",
+                          "sizeBytes",
+                          "mode"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "const": "directory"
+                          },
+                          "mode": {
+                            "type": "integer",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "mode"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "const": "symlink"
+                          },
+                          "target": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind",
+                          "target"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "string",
+                    "const": "unknown"
+                  }
+                ],
+                "description": "Null proves absence; unknown means this path has no captured application preimage."
+              },
+              "after": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/WorkspaceFilesManifest/properties/entries/items/properties/before/anyOf/0"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "path",
+              "before",
+              "after"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "version",
+        "sourceRoot",
+        "executionRoot",
+        "isolation",
+        "scopePaths",
+        "complete",
+        "entries"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/WorkspaceKind.schema.json

@@ -0,0 +1,13 @@
+{
+  "$ref": "#/definitions/WorkspaceKind",
+  "definitions": {
+    "WorkspaceKind": {
+      "type": "string",
+      "enum": [
+        "git",
+        "directory"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/schema",
-  "version": "3.10.4",
+  "version": "3.11.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.4.3",
     "zod-to-json-schema": "^3.24.1",
-    "@claudexor/util": "3.10.4"
+    "@claudexor/util": "3.11.0"
   },
   "repository": {
     "type": "git",