@claudexor/schema 3.1.2 → 3.3.7-rc.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

@@ -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",
@@ -778,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/ControlQuotaResponse.schema.json

@@ -168,7 +168,8 @@
                   "transport_unavailable",
                   "platform_unsupported",
                   "refresh_failed",
-                  "no_source"
+                  "no_source",
+                  "auth_revoked"
                 ],
                 "description": "Why a registered subject has no quota snapshot, in the source's own vocabulary."
               },

package/generated/ControlRunAgainDraft.schema.json

@@ -70,6 +70,11 @@
                       ],
                       "description": "Project context depth; auto is the only mode.",
                       "default": "auto"
+                    },
+                    "ephemeral": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Declare the root one-shot: it anchors this run only, is never entered into the durable project registry, and its commands/run events live in the global no-project partition."
                     }
                   },
                   "required": [
@@ -110,10 +115,15 @@
                   ],
                   "default": "envelope",
                   "description": "Run isolation: envelope (isolated worktree in the external per-project runtime namespace, the default) or live (the project tree itself)."
+                },
+                "delegated": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Marks a run driven by an EXTERNAL orchestrator that owns the workspace, not by the operator at a surface. Such a run is confined to a scoped harness HOME even under isolation='live' (an in-place delegated attempt therefore cannot resume a native vendor session stored under the real HOME). Unrelated to the `delegate` belt flag and to `delegatedFromRunId` (belt-child provenance)."
                 }
               },
               "additionalProperties": false,
-              "description": "Execution isolation settings for a run.",
+              "description": "Execution isolation and delegation settings for a run.",
               "default": {
                 "isolation": "envelope"
               }
@@ -457,7 +467,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",

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#"
+}