@claudexor/schema 1.0.0

package/generated/ControlThread.schema.json

@@ -0,0 +1,129 @@
+{
+  "$ref": "#/definitions/ControlThread",
+  "definitions": {
+    "ControlThread": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Thread id."
+        },
+        "title": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Thread title; null until set."
+        },
+        "repoRoot": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Project root the thread is anchored to; null for a no-project thread."
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "ask",
+            "plan",
+            "audit",
+            "agent",
+            "orchestrate"
+          ],
+          "description": "Default mode for new turns."
+        },
+        "workspaceMode": {
+          "type": "string",
+          "enum": [
+            "in_place",
+            "isolated"
+          ],
+          "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.",
+          "default": "in_place"
+        },
+        "authPreference": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "Preferred auth route: subscription (native/OAuth session), api_key (a stored API key), or auto (engine picks subscription-first with policy fallback). A preference, not a secret.",
+          "default": "auto"
+        },
+        "primaryHarness": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Sticky primary harness for the thread; null = engine routing."
+        },
+        "eligibleHarnesses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Sticky eligible harness pool; empty = the engine auto-pools."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "active",
+            "closed"
+          ],
+          "description": "Thread lifecycle state: active or explicitly closed (archived). Blocked is a live projection, not a thread state.",
+          "default": "active"
+        },
+        "runIds": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Non-empty identifier string."
+          },
+          "default": [],
+          "description": "Ordered run lineage of the thread."
+        },
+        "headRunId": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlThread/properties/runIds/items"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Most recent run of the thread; null before the first turn runs.",
+          "default": null
+        },
+        "needsHuman": {
+          "type": "boolean",
+          "default": false,
+          "description": "True when the head turn is blocked on a human decision (needs-me inbox)."
+        },
+        "createdAt": {
+          "type": "string",
+          "description": "When the thread was created."
+        },
+        "updatedAt": {
+          "type": "string",
+          "description": "When the thread was last updated."
+        }
+      },
+      "required": [
+        "id",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Control-plane projection of a thread (camelCase view of the Thread artifact)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThreadApplyRequest.schema.json

@@ -0,0 +1,32 @@
+{
+  "$ref": "#/definitions/ControlThreadApplyRequest",
+  "definitions": {
+    "ControlThreadApplyRequest": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "apply",
+            "branch",
+            "commit",
+            "pr"
+          ],
+          "default": "apply",
+          "description": "Delivery mode: apply to the tree, or as a branch, commit, or PR."
+        },
+        "branch": {
+          "type": "string",
+          "description": "Branch name for branch/pr modes."
+        },
+        "message": {
+          "type": "string",
+          "description": "Commit message for commit/pr modes."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body applying an isolated thread's accumulated worktree diff to the project."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThreadApplyResponse.schema.json

@@ -0,0 +1,47 @@
+{
+  "$ref": "#/definitions/ControlThreadApplyResponse",
+  "definitions": {
+    "ControlThreadApplyResponse": {
+      "type": "object",
+      "properties": {
+        "applied": {
+          "type": "boolean",
+          "description": "Whether anything was delivered."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "applied",
+            "branched",
+            "committed",
+            "pr_opened",
+            "empty",
+            "conflict",
+            "rejected"
+          ],
+          "description": "Delivery outcome: applied, branched, committed, pr_opened, empty (no diff), conflict, or rejected."
+        },
+        "headMoved": {
+          "type": "boolean",
+          "default": false,
+          "description": "True when the project HEAD moved past the thread base since the thread started."
+        },
+        "detail": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Human-readable detail."
+        }
+      },
+      "required": [
+        "applied",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "Response to a thread apply."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlThreadCreateRequest.schema.json

@@ -0,0 +1,107 @@
+{
+  "$ref": "#/definitions/ControlThreadCreateRequest",
+  "definitions": {
+    "ControlThreadCreateRequest": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Initial thread title."
+        },
+        "scope": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "project"
+                },
+                "root": {
+                  "type": "string",
+                  "description": "Absolute path of the project root."
+                },
+                "context": {
+                  "type": "string",
+                  "enum": [
+                    "auto"
+                  ],
+                  "description": "Project context depth; auto is the only mode.",
+                  "default": "auto"
+                }
+              },
+              "required": [
+                "kind",
+                "root"
+              ],
+              "additionalProperties": false,
+              "description": "Run anchored to a project."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "none"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false,
+              "description": "Run with no project (pure ask)."
+            }
+          ],
+          "description": "What the run operates on: a project (with root) or nothing.",
+          "default": {
+            "kind": "none"
+          }
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "ask",
+            "plan",
+            "audit",
+            "agent",
+            "orchestrate"
+          ],
+          "description": "Default mode for new turns."
+        },
+        "workspace": {
+          "type": "string",
+          "enum": [
+            "in_place",
+            "isolated"
+          ],
+          "description": "Workspace mode for the thread (in_place or isolated)."
+        },
+        "authPreference": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "Per-thread auth preference override."
+        },
+        "primaryHarness": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "description": "Sticky primary harness for the thread."
+        },
+        "eligibleHarnesses": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlThreadCreateRequest/properties/primaryHarness"
+          },
+          "description": "Sticky eligible harness pool; turns inherit it when unset."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body for POST /threads."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}