@claudexor/schema 1.0.0

package/generated/ControlHarnessSettingsPatch.schema.json

@@ -0,0 +1,130 @@
+{
+  "$ref": "#/definitions/ControlHarnessSettingsPatch",
+  "definitions": {
+    "ControlHarnessSettingsPatch": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable/disable the harness for routing."
+        },
+        "defaultModel": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "\\S",
+              "description": "User-supplied string that must contain visible content, not just whitespace."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New per-harness default model; null clears it."
+        },
+        "effort": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "low",
+                "medium",
+                "high",
+                "xhigh",
+                "max"
+              ],
+              "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New default reasoning effort; null clears it."
+        },
+        "maxTurns": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New max agent turns; null clears the limit."
+        },
+        "maxRounds": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New max convergence rounds; null clears it."
+        },
+        "maxUsd": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New per-harness USD cap; null clears it."
+        },
+        "toolsAllow": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlHarnessSettingsPatch/properties/defaultModel/anyOf/0"
+          },
+          "description": "New tool allowlist."
+        },
+        "toolsDeny": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlHarnessSettingsPatch/properties/defaultModel/anyOf/0"
+          },
+          "description": "New tool denylist."
+        },
+        "fallbackModel": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlHarnessSettingsPatch/properties/defaultModel/anyOf/0"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New fallback model; null clears it."
+        },
+        "web": {
+          "type": "string",
+          "enum": [
+            "off",
+            "auto",
+            "cached",
+            "live"
+          ],
+          "description": "New default web policy."
+        },
+        "authPreference": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "New auth route preference."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Partial per-harness settings patch; absent fields keep their stored value, and a typoed key 400s (strict)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlInteractionAnswerRequest.schema.json

@@ -0,0 +1,48 @@
+{
+  "$ref": "#/definitions/ControlInteractionAnswerRequest",
+  "definitions": {
+    "ControlInteractionAnswerRequest": {
+      "type": "object",
+      "properties": {
+        "answers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "questionId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Id of the question being answered."
+              },
+              "selectedLabels": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [],
+                "description": "Labels of the selected options."
+              },
+              "freeText": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Free-text answer; null when only options were selected."
+              }
+            },
+            "required": [
+              "questionId"
+            ],
+            "additionalProperties": false
+          },
+          "default": [],
+          "description": "Answers, one per question."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body answering a pending interactive question."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlInteractionAnswerResponse.schema.json

@@ -0,0 +1,35 @@
+{
+  "$ref": "#/definitions/ControlInteractionAnswerResponse",
+  "definitions": {
+    "ControlInteractionAnswerResponse": {
+      "type": "object",
+      "properties": {
+        "accepted": {
+          "type": "boolean",
+          "description": "Whether the answer was accepted."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "delivered",
+            "not_found",
+            "already_resolved",
+            "rejected"
+          ],
+          "description": "Delivery outcome: delivered into the live session, interaction not found, already resolved, or rejected."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable detail."
+        }
+      },
+      "required": [
+        "accepted",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "Response to an interaction answer."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlPendingInteraction.schema.json

@@ -0,0 +1,129 @@
+{
+  "$ref": "#/definitions/ControlPendingInteraction",
+  "definitions": {
+    "ControlPendingInteraction": {
+      "type": "object",
+      "properties": {
+        "interactionId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Interaction id used to answer."
+        },
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Run the interaction belongs to."
+        },
+        "attemptId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Attempt the interaction was raised in, when known."
+        },
+        "harnessId": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Harness that raised the interaction."
+        },
+        "sourceTool": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "Native tool that raised the request."
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Question id."
+              },
+              "question": {
+                "type": "string",
+                "description": "The question text."
+              },
+              "header": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Short chip/header text some harnesses attach to a question."
+              },
+              "options": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "label": {
+                      "type": "string",
+                      "description": "Option label shown to the user."
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "default": null,
+                      "description": "Optional longer explanation of the option."
+                    }
+                  },
+                  "required": [
+                    "label"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One multiple-choice option of an interactive question."
+                },
+                "default": [],
+                "description": "Selectable options; empty for free-text-only questions."
+              },
+              "multi_select": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether multiple options may be selected."
+              }
+            },
+            "required": [
+              "id",
+              "question"
+            ],
+            "additionalProperties": false,
+            "description": "One question of an interactive user-input request."
+          },
+          "default": [],
+          "description": "Questions awaiting answers."
+        },
+        "requestedAt": {
+          "type": "string",
+          "description": "When the interaction was requested."
+        },
+        "timeoutAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "default": null,
+          "description": "When the interaction times out into a benign decline; null = no timeout."
+        }
+      },
+      "required": [
+        "interactionId",
+        "runId",
+        "requestedAt"
+      ],
+      "additionalProperties": false,
+      "description": "A live interactive question awaiting the user's answer (snapshot projection)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlQueuedRunInfo.schema.json

@@ -0,0 +1,44 @@
+{
+  "$ref": "#/definitions/ControlQueuedRunInfo",
+  "definitions": {
+    "ControlQueuedRunInfo": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "description": "Daemon job id."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "queued",
+            "running",
+            "blocked",
+            "succeeded",
+            "no_op",
+            "ungated",
+            "review_not_run",
+            "failed",
+            "cancelled",
+            "interrupted",
+            "exhausted",
+            "not_converged",
+            "stuck_no_progress"
+          ],
+          "description": "Control-plane run state: queued/running while live; blocked awaiting a human; then a terminal outcome (succeeded, no_op, ungated, review_not_run, failed, cancelled, interrupted, exhausted, not_converged, stuck_no_progress)."
+        },
+        "error": {
+          "type": "string",
+          "description": "Error message, when the job failed."
+        }
+      },
+      "required": [
+        "jobId",
+        "state"
+      ],
+      "additionalProperties": false,
+      "description": "Compact state of a queued/running daemon job."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlRunControlRequest.schema.json

@@ -0,0 +1,61 @@
+{
+  "$ref": "#/definitions/ControlRunControlRequest",
+  "definitions": {
+    "ControlRunControlRequest": {
+      "type": "object",
+      "properties": {
+        "control": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "cancel"
+              ],
+              "description": "Control verb: cancel the run."
+            },
+            "target": {
+              "type": "object",
+              "properties": {
+                "attemptId": {
+                  "type": "string",
+                  "description": "Attempt to target; omitted = the whole run."
+                },
+                "harnessId": {
+                  "type": "string",
+                  "description": "Harness to target."
+                },
+                "sessionId": {
+                  "type": "string",
+                  "description": "Session to target."
+                },
+                "requestId": {
+                  "type": "string",
+                  "description": "Specific request to target."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Optional narrowing of what a run control verb targets.",
+              "default": {}
+            },
+            "reason": {
+              "type": "string",
+              "description": "Human-readable reason for the control."
+            }
+          },
+          "required": [
+            "kind"
+          ],
+          "additionalProperties": false,
+          "description": "A control verb (cancel) aimed at a run or a narrower target inside it."
+        }
+      },
+      "required": [
+        "control"
+      ],
+      "additionalProperties": false,
+      "description": "Request body for POST /runs/:id/control."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlRunControlResponse.schema.json

@@ -0,0 +1,40 @@
+{
+  "$ref": "#/definitions/ControlRunControlResponse",
+  "definitions": {
+    "ControlRunControlResponse": {
+      "type": "object",
+      "properties": {
+        "accepted": {
+          "type": "boolean",
+          "description": "Whether the control was accepted."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "applied",
+            "queued",
+            "rejected",
+            "unsupported"
+          ],
+          "default": "queued",
+          "description": "Outcome: applied immediately, queued, rejected, or unsupported for this run."
+        },
+        "runId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Run the control was applied to."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable detail."
+        }
+      },
+      "required": [
+        "accepted"
+      ],
+      "additionalProperties": false,
+      "description": "Response to a run control request."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlRunDecisionRequest.schema.json

@@ -0,0 +1,98 @@
+{
+  "$ref": "#/definitions/ControlRunDecisionRequest",
+  "definitions": {
+    "ControlRunDecisionRequest": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "accept_clean_patch",
+            "rerun_with_feedback",
+            "accept_risk",
+            "override_needs_human",
+            "revert_run"
+          ],
+          "description": "Operator decision on a blocked run: accept_clean_patch (apply it), rerun_with_feedback, accept_risk, override_needs_human, or revert_run (restore the pre-turn snapshot)."
+        },
+        "findingIds": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Non-empty identifier string."
+          },
+          "default": [],
+          "description": "Findings the decision targets (override/accept_risk)."
+        },
+        "feedback": {
+          "type": "string",
+          "description": "Reviewer feedback to seed a rerun turn."
+        },
+        "acceptedRisks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Risk reasons being explicitly accepted (recorded, never silent)."
+        },
+        "applyMode": {
+          "type": "string",
+          "enum": [
+            "artifact_only",
+            "apply",
+            "branch",
+            "commit",
+            "pr"
+          ],
+          "description": "Delivery mode for accept_clean_patch."
+        },
+        "target": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "original_project"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false,
+              "description": "Apply to the project the run originally came from."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "project"
+                },
+                "root": {
+                  "type": "string",
+                  "description": "Absolute path of the target project root."
+                }
+              },
+              "required": [
+                "kind",
+                "root"
+              ],
+              "additionalProperties": false,
+              "description": "Apply to an explicitly named project root."
+            }
+          ],
+          "description": "Delivery target for accept_clean_patch."
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "Typed, auditable operator decision on a NEEDS_HUMAN-blocked run."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlRunDecisionResponse.schema.json

@@ -0,0 +1,40 @@
+{
+  "$ref": "#/definitions/ControlRunDecisionResponse",
+  "definitions": {
+    "ControlRunDecisionResponse": {
+      "type": "object",
+      "properties": {
+        "accepted": {
+          "type": "boolean",
+          "description": "Whether the decision was accepted."
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "applied",
+            "requeued",
+            "rejected",
+            "unsupported"
+          ],
+          "description": "Outcome: applied, requeued (a new turn was enqueued), rejected, or unsupported."
+        },
+        "newRunId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "New run id when the decision re-enqueues a turn (rerun_with_feedback)."
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable detail."
+        }
+      },
+      "required": [
+        "accepted",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "Response to an operator run decision."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}