@claudexor/schema 3.22.0 → 3.23.1

package/generated/ControlThread.schema.json

@@ -53,11 +53,20 @@
           "type": "string",
           "enum": [
             "in_place",
-            "isolated"
+            "isolated",
+            "delegated"
           ],
-          "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project.",
+          "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project; delegated runs every turn in one caller-owned workspace bound at creation, which Claudexor never applies to the project or deletes.",
           "default": "in_place"
         },
+        "workspaceRoot": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Caller-owned workspace a delegated thread executes in; null for in_place and isolated threads."
+        },
         "authPreference": {
           "type": "string",
           "enum": [

package/generated/ControlThreadCreateRequest.schema.json

@@ -81,9 +81,14 @@
           "type": "string",
           "enum": [
             "in_place",
-            "isolated"
+            "isolated",
+            "delegated"
           ],
-          "description": "Workspace mode for the thread (in_place or isolated)."
+          "description": "Workspace mode for the thread (in_place, isolated, or delegated)."
+        },
+        "workspaceRoot": {
+          "type": "string",
+          "description": "Absolute existing caller-owned directory every turn of a workspace='delegated' thread executes in. Required exactly for that workspace, project scope only, and immutable after creation; scope.root stays the stable project identity."
         },
         "authPreference": {
           "type": "string",

package/generated/ControlThreadDetail.schema.json

@@ -56,11 +56,20 @@
               "type": "string",
               "enum": [
                 "in_place",
-                "isolated"
+                "isolated",
+                "delegated"
               ],
-              "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project.",
+              "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project; delegated runs every turn in one caller-owned workspace bound at creation, which Claudexor never applies to the project or deletes.",
               "default": "in_place"
             },
+            "workspaceRoot": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Caller-owned workspace a delegated thread executes in; null for in_place and isolated threads."
+            },
             "authPreference": {
               "type": "string",
               "enum": [

package/generated/ControlThreadListResponse.schema.json

@@ -58,11 +58,20 @@
                 "type": "string",
                 "enum": [
                   "in_place",
-                  "isolated"
+                  "isolated",
+                  "delegated"
                 ],
-                "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project.",
+                "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project; delegated runs every turn in one caller-owned workspace bound at creation, which Claudexor never applies to the project or deletes.",
                 "default": "in_place"
               },
+              "workspaceRoot": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Caller-owned workspace a delegated thread executes in; null for in_place and isolated threads."
+              },
               "authPreference": {
                 "type": "string",
                 "enum": [

package/generated/RunListQuery.schema.json

@@ -0,0 +1,66 @@
+{
+  "$ref": "#/definitions/RunListQuery",
+  "definitions": {
+    "RunListQuery": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        },
+        "state": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "queued",
+                "running",
+                "succeeded",
+                "failed",
+                "cancelled",
+                "interrupted"
+              ],
+              "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Control-plane run state = the run LIFECYCLE (D8): queued/running while live, then exactly one of succeeded / failed / cancelled / interrupted. Outcome quality (checks/review/delivery) is orthogonal — see outcomeFacts."
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "createdAt": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "createdAt",
+                "id"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "limit",
+        "state",
+        "cursor"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/Thread.schema.json

@@ -151,9 +151,10 @@
               "type": "string",
               "enum": [
                 "in_place",
-                "isolated"
+                "isolated",
+                "delegated"
               ],
-              "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project.",
+              "description": "Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project; delegated runs every turn in one caller-owned workspace bound at creation, which Claudexor never applies to the project or deletes.",
               "default": "in_place"
             },
             "worktree_path": {
@@ -183,10 +184,18 @@
               ],
               "description": "Last run in the lineage prefix already delivered from this isolated thread.",
               "default": null
+            },
+            "workspace_root": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Caller-owned absolute workspace every turn of a delegated thread executes in; bound at creation, immutable, and retained after purge as the historical binding. Null for in_place and isolated threads."
             }
           },
           "additionalProperties": false,
-          "description": "How the thread's turns touch files (in-place live tree vs isolated worktree).",
+          "description": "How the thread's turns touch files (in-place live tree, isolated worktree, or caller-owned delegated workspace).",
           "default": {}
         },
         "run_ids": {

package/package.json

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