@claudexor/schema 3.1.1 → 3.2.0

package/generated/ControlDirectoryEntry.schema.json

@@ -0,0 +1,36 @@
+{
+  "$ref": "#/definitions/ControlDirectoryEntry",
+  "definitions": {
+    "ControlDirectoryEntry": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "directory",
+            "file"
+          ]
+        },
+        "readable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "name",
+        "path",
+        "kind",
+        "readable"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlDirectoryListing.schema.json

@@ -0,0 +1,77 @@
+{
+  "$ref": "#/definitions/ControlDirectoryListing",
+  "definitions": {
+    "ControlDirectoryListing": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "home": {
+          "type": "string",
+          "minLength": 1
+        },
+        "parent": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "directory",
+                  "file"
+                ]
+              },
+              "readable": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "name",
+              "path",
+              "kind",
+              "readable"
+            ],
+            "additionalProperties": false
+          },
+          "maxItems": 1000
+        },
+        "truncated": {
+          "type": "boolean",
+          "description": "True when more actionable entries existed than the bounded response contains."
+        }
+      },
+      "required": [
+        "path",
+        "home",
+        "parent",
+        "entries",
+        "truncated"
+      ],
+      "additionalProperties": false,
+      "description": "A home-contained server directory listing for the remote project picker."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlHarnessListResponse.schema.json

@@ -254,12 +254,12 @@
                           "mcp_injection": {
                             "type": "boolean",
                             "default": false,
-                            "description": "The adapter can inject engine-owned MCP servers into the harness sandbox (browser tool, delegation belt); false = extra_mcp_servers and the delegate toggle are refused."
+                            "description": "The adapter can inject engine-owned MCP servers into the harness sandbox (browser tool, delegation belt); false = browser MCP is refused and Delegate degrades to ordinary Agent with a durable typed receipt."
                           },
                           "mcp_injection_requires_full_access": {
                             "type": "boolean",
                             "default": false,
-                            "description": "An injected MCP server can only reach the daemon (belt) at full access; below it the harness sandbox cancels the call. true => --delegate below full access is refused for this harness."
+                            "description": "An injected MCP server can only reach the daemon (belt) at full access; below it the harness sandbox cancels the call. true => Delegate below full access degrades to ordinary Agent with a durable typed receipt."
                           }
                         },
                         "additionalProperties": false,
@@ -357,7 +357,7 @@
                               "unsupported"
                             ],
                             "default": "unsupported",
-                            "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (whole-answer JSON), or unsupported (work_state stays unverified)."
+                            "description": "How the harness carries the D-16 WorkReport envelope: constrained (native schema transport), validated (instructed terminal metadata), or unsupported (work_state stays unverified)."
                           },
                           "structured_output_channel": {
                             "type": "string",
@@ -721,6 +721,52 @@
                 ],
                 "default": null,
                 "description": "Strict truth-source check of configuredModel; null when no model is configured."
+              },
+              "delegation": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "available": {
+                        "type": "boolean",
+                        "description": "Whether this harness can receive the packaged delegation belt."
+                      },
+                      "reason": {
+                        "type": "string",
+                        "enum": [
+                          "ready",
+                          "runtime_unavailable",
+                          "manifest_unsupported"
+                        ],
+                        "description": "Stable reason for the current delegation capability verdict."
+                      },
+                      "remediation": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "default": null,
+                        "description": "Concrete update/repair guidance when unavailable; null when ready."
+                      },
+                      "requiresFullAccess": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Whether this harness can reach the belt only under a full-access profile."
+                      }
+                    },
+                    "required": [
+                      "available",
+                      "reason"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Engine-owned Delegate capability projection for one harness and installed runtime."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Engine-owned Delegate capability for this harness and installed runtime; null on legacy status rows.",
+                "default": null
               }
             },
             "required": [
@@ -732,6 +778,46 @@
           },
           "default": [],
           "description": "Status rows for all known harnesses."
+        },
+        "git": {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "enum": [
+                "available",
+                "missing",
+                "developer_tools_stub",
+                "failed"
+              ]
+            },
+            "version": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "detail": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "remediation": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "status",
+            "version",
+            "detail",
+            "remediation"
+          ],
+          "additionalProperties": false,
+          "description": "Execution-location Git readiness; omitted by daemons predating capability projection."
         }
       },
       "additionalProperties": false,

package/generated/ControlRunAgainDraft.schema.json

@@ -393,7 +393,11 @@
             },
             "parentRunId": {
               "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
-              "description": "Run this turn follows up on."
+              "description": "Server-owned parent/follow-up lineage; rejected on direct POST /runs."
+            },
+            "delegatedFromRunId": {
+              "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
+              "description": "Internal belt-child provenance only; equals parentRunId and is rejected on direct POST /runs."
             },
             "retryOf": {
               "$ref": "#/definitions/ControlRunAgainDraft/properties/sourceRunId",
@@ -453,7 +457,7 @@
                 "description": "One reviewer of an explicit reviewer panel — a harness plus optional model and effort. The CLI spells one entry `harness=model:effort` (e.g. `claude=claude-opus-4-8:max`)."
               },
               "minItems": 1,
-              "description": "Explicit reviewer panel — who reviews the change, one entry per reviewer as `harness=model:effort` (CLI `--reviewers \"claude=claude-opus-4-8:max,cursor=gemini-3.1-pro\"`). Duplicate harness entries are kept so one provider can review through several models; overrides the legacy reviewerModels/reviewerEfforts maps."
+              "description": "Explicit Agent reviewer panel — who reviews the change, one entry per reviewer as `harness=model:effort` (CLI `--reviewer-panel \"claude=claude-opus-4-8:max,cursor=gemini-3.1-pro\"`). Duplicate harness entries are kept so one provider can review through several models; overrides the legacy reviewerModels/reviewerEfforts maps."
             },
             "authPreference": {
               "type": "string",
@@ -478,7 +482,7 @@
             },
             "delegate": {
               "type": "boolean",
-              "description": "Agent-only: inject the Claudexor delegation belt so the harness can spawn bounded isolated sub-runs; refused on non-agent modes or harnesses without mcp_injection."
+              "description": "Agent-only: inject the Claudexor delegation belt so the harness can spawn bounded isolated sub-runs; non-agent modes refuse, while known belt or harness unavailability degrades before start to ordinary Agent with a durable warning."
             },
             "maxSeconds": {
               "type": "integer",

package/generated/ControlRunApplicabilityResponse.schema.json

@@ -0,0 +1,217 @@
+{
+  "$ref": "#/definitions/ControlRunApplicabilityResponse",
+  "definitions": {
+    "ControlRunApplicabilityResponse": {
+      "type": "object",
+      "properties": {
+        "repoRoot": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Exact absolute project root for which this projection was computed."
+        },
+        "git": {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "enum": [
+                "available",
+                "missing",
+                "developer_tools_stub",
+                "failed"
+              ]
+            },
+            "version": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "detail": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "remediation": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "status",
+            "version",
+            "detail",
+            "remediation"
+          ],
+          "additionalProperties": false,
+          "description": "Live Git readiness used for every applicability cell."
+        },
+        "matrix": {
+          "type": "object",
+          "properties": {
+            "in_place": {
+              "type": "object",
+              "properties": {
+                "read_only": {
+                  "type": "object",
+                  "properties": {
+                    "applicable": {
+                      "type": "boolean",
+                      "description": "Whether the current Git capability admits this shape; other run preconditions are out of scope."
+                    },
+                    "requiresGit": {
+                      "type": "boolean",
+                      "description": "Whether this run/workspace shape crosses a Git-backed engine boundary."
+                    },
+                    "code": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "git_missing",
+                            "git_developer_tools_stub",
+                            "git_failed"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Stable refusal code when not applicable; null when applicable."
+                    },
+                    "reason": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "description": "Human causal explanation when not applicable; null when applicable."
+                    },
+                    "remediation": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "description": "Exact recovery action when not applicable; null when applicable."
+                    }
+                  },
+                  "required": [
+                    "applicable",
+                    "requiresGit",
+                    "code",
+                    "reason",
+                    "remediation"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Ask or Plan."
+                },
+                "agent_convergence": {
+                  "type": "object",
+                  "properties": {
+                    "applicable": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/applicable"
+                    },
+                    "requiresGit": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/requiresGit"
+                    },
+                    "code": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/code"
+                    },
+                    "reason": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/reason"
+                    },
+                    "remediation": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/remediation"
+                    }
+                  },
+                  "required": [
+                    "applicable",
+                    "requiresGit",
+                    "code",
+                    "reason",
+                    "remediation"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Agent with an actual attempts cap or until-clean flag on the wire."
+                },
+                "agent_other": {
+                  "type": "object",
+                  "properties": {
+                    "applicable": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/applicable"
+                    },
+                    "requiresGit": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/requiresGit"
+                    },
+                    "code": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/code"
+                    },
+                    "reason": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/reason"
+                    },
+                    "remediation": {
+                      "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only/properties/remediation"
+                    }
+                  },
+                  "required": [
+                    "applicable",
+                    "requiresGit",
+                    "code",
+                    "reason",
+                    "remediation"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Plain Agent, Best-of, Create, or any other Agent wire shape."
+                }
+              },
+              "required": [
+                "read_only",
+                "agent_convergence",
+                "agent_other"
+              ],
+              "additionalProperties": false,
+              "description": "An in-place thread workspace."
+            },
+            "isolated": {
+              "type": "object",
+              "properties": {
+                "read_only": {
+                  "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/read_only"
+                },
+                "agent_convergence": {
+                  "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/agent_convergence"
+                },
+                "agent_other": {
+                  "$ref": "#/definitions/ControlRunApplicabilityResponse/properties/matrix/properties/in_place/properties/agent_other"
+                }
+              },
+              "required": [
+                "read_only",
+                "agent_convergence",
+                "agent_other"
+              ],
+              "additionalProperties": false,
+              "description": "A persistent isolated thread worktree."
+            }
+          },
+          "required": [
+            "in_place",
+            "isolated"
+          ],
+          "additionalProperties": false,
+          "description": "Root-scoped Git applicability for every composer run/workspace shape."
+        }
+      },
+      "required": [
+        "repoRoot",
+        "git",
+        "matrix"
+      ],
+      "additionalProperties": false,
+      "description": "Root-scoped Git applicability projected by the engine; this is not total run readiness."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlRunControlResponse.schema.json

@@ -24,6 +24,14 @@
           "minLength": 1,
           "description": "Run the control was applied to."
         },
+        "cascadeRunIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlRunControlResponse/properties/runId"
+          },
+          "default": [],
+          "description": "Active Claudexor Delegate descendants included in this cancellation."
+        },
         "message": {
           "type": "string",
           "description": "Human-readable detail."