@claudexor/schema 1.0.0

package/generated/ControlSecretListResponse.schema.json

@@ -0,0 +1,57 @@
+{
+  "$ref": "#/definitions/ControlSecretListResponse",
+  "definitions": {
+    "ControlSecretListResponse": {
+      "type": "object",
+      "properties": {
+        "backend": {
+          "type": "string",
+          "enum": [
+            "keychain",
+            "file"
+          ],
+          "description": "Active secret store backend."
+        },
+        "secrets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Secret name/label."
+              },
+              "backend": {
+                "type": "string",
+                "enum": [
+                  "keychain",
+                  "file"
+                ],
+                "description": "Where the secret is stored: the OS keychain or a file store."
+              },
+              "present": {
+                "type": "boolean",
+                "default": true,
+                "description": "Whether a value is actually stored."
+              }
+            },
+            "required": [
+              "name",
+              "backend"
+            ],
+            "additionalProperties": false,
+            "description": "Secret list row: name, storage backend, and presence — never the value."
+          },
+          "default": [],
+          "description": "Stored secrets (metadata only, never values)."
+        }
+      },
+      "required": [
+        "backend"
+      ],
+      "additionalProperties": false,
+      "description": "Response for listing stored secrets (metadata only)."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSettingsSnapshot.schema.json

@@ -0,0 +1,281 @@
+{
+  "$ref": "#/definitions/ControlSettingsSnapshot",
+  "definitions": {
+    "ControlSettingsSnapshot": {
+      "type": "object",
+      "properties": {
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Config file paths that contributed to the snapshot."
+        },
+        "defaultPortfolio": {
+          "type": "string",
+          "enum": [
+            "daily-rich",
+            "balanced",
+            "cheapest",
+            "strongest",
+            "burn",
+            "subscription-first",
+            "api-overflow",
+            "conserve-claude",
+            "conserve-codex"
+          ],
+          "description": "Budget portfolio used when a run does not specify one.",
+          "default": "subscription-first"
+        },
+        "interactionTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 900000,
+          "description": "How long a run waits for an interactive answer before a benign decline, in milliseconds."
+        },
+        "routing": {
+          "type": "object",
+          "properties": {
+            "defaultPolicy": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "primary"
+              ],
+              "default": "auto",
+              "description": "Default routing policy."
+            },
+            "primaryHarness": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Global default primary harness; null = engine decides."
+            },
+            "eligibleHarnesses": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "description": "Harness pool eligible for routing/races; empty = all available."
+            },
+            "envInheritance": {
+              "type": "string",
+              "enum": [
+                "mirror_native",
+                "clean"
+              ],
+              "default": "mirror_native",
+              "description": "How the child harness env is built: mirror_native inherits the shell env; clean spawns from a minimal allowlist."
+            },
+            "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"
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Global routing settings."
+        },
+        "budget": {
+          "type": "object",
+          "properties": {
+            "maxUsdPerRun": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "default": null,
+              "description": "Global USD cap per run; null = no cap."
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Global budget limits."
+        },
+        "runtime": {
+          "type": "object",
+          "properties": {
+            "reviewerTimeoutMs": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "default": 600000,
+              "description": "Wall-clock timeout for a reviewer run, in milliseconds."
+            },
+            "harnessInactivityTimeoutMs": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "default": 1200000,
+              "description": "Inactivity watchdog for harness streams, in milliseconds."
+            },
+            "transientRetry": {
+              "type": "object",
+              "properties": {
+                "maxRetries": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 2,
+                  "description": "Maximum retries for a transient failure."
+                },
+                "initialDelayMs": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 1000,
+                  "description": "Initial retry delay in milliseconds."
+                },
+                "maxDelayMs": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 10000,
+                  "description": "Maximum retry delay in milliseconds."
+                }
+              },
+              "additionalProperties": false,
+              "default": {},
+              "description": "Bounded retry policy for transient failures."
+            }
+          },
+          "additionalProperties": false,
+          "default": {},
+          "description": "Global runtime timeouts and retry policy."
+        },
+        "harnesses": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "default": true,
+                "description": "Whether the harness participates in routing."
+              },
+              "defaultModel": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Per-harness default model; null = the harness's own default."
+              },
+              "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": "Default reasoning effort; null = harness default.",
+                "default": null
+              },
+              "maxTurns": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "exclusiveMinimum": 0
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Default max agent turns; null = no limit."
+              },
+              "maxRounds": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "exclusiveMinimum": 0
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Default max convergence rounds; null = engine default."
+              },
+              "maxUsd": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Per-harness USD cap; null = no cap."
+              },
+              "toolsAllow": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [],
+                "description": "Tool names allowed for this harness."
+              },
+              "toolsDeny": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [],
+                "description": "Tool names denied for this harness."
+              },
+              "fallbackModel": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Model to fall back to on typed fallback signals; null = none."
+              },
+              "web": {
+                "type": "string",
+                "enum": [
+                  "off",
+                  "auto",
+                  "cached",
+                  "live"
+                ],
+                "description": "Default web policy for this harness.",
+                "default": "auto"
+              },
+              "authPreference": {
+                "$ref": "#/definitions/ControlSettingsSnapshot/properties/routing/properties/authPreference",
+                "default": "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."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Per-harness settings."
+          },
+          "default": {},
+          "description": "Per-harness settings keyed by harness id."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Effective settings snapshot served by GET /settings."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSettingsUpdateRequest.schema.json

@@ -0,0 +1,212 @@
+{
+  "$ref": "#/definitions/ControlSettingsUpdateRequest",
+  "definitions": {
+    "ControlSettingsUpdateRequest": {
+      "type": "object",
+      "properties": {
+        "defaultPortfolio": {
+          "type": "string",
+          "enum": [
+            "daily-rich",
+            "balanced",
+            "cheapest",
+            "strongest",
+            "burn",
+            "subscription-first",
+            "api-overflow",
+            "conserve-claude",
+            "conserve-codex"
+          ],
+          "description": "Budget portfolio weighting the harness router's quality/cost/latency and subscription-vs-API preferences (e.g. cheapest minimizes spend, burn maximizes quality, conserve-* deprioritizes one vendor)."
+        },
+        "interactionTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "New interactive-answer timeout, in milliseconds."
+        },
+        "routingPolicy": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "primary"
+          ],
+          "description": "New default routing policy."
+        },
+        "primaryHarness": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "\\S",
+              "description": "User-supplied string that must contain visible content, not just whitespace."
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "New global primary harness; null clears back to engine routing."
+        },
+        "eligibleHarnesses": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ControlSettingsUpdateRequest/properties/primaryHarness/anyOf/0"
+          },
+          "description": "New global eligible harness pool."
+        },
+        "envInheritance": {
+          "type": "string",
+          "enum": [
+            "mirror_native",
+            "clean"
+          ],
+          "description": "New child harness env composition mode."
+        },
+        "maxUsdPerRun": {
+          "type": "number",
+          "minimum": 0,
+          "description": "New global USD cap per run (mutually exclusive with clearMaxUsdPerRun)."
+        },
+        "clearMaxUsdPerRun": {
+          "type": "boolean",
+          "description": "Clear the global USD cap per run (mutually exclusive with maxUsdPerRun)."
+        },
+        "authPreference": {
+          "type": "string",
+          "enum": [
+            "subscription",
+            "api_key",
+            "auto"
+          ],
+          "description": "New global auth route preference."
+        },
+        "harnesses": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable/disable the harness for routing."
+              },
+              "defaultModel": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/ControlSettingsUpdateRequest/properties/primaryHarness/anyOf/0"
+                  },
+                  {
+                    "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/ControlSettingsUpdateRequest/properties/primaryHarness/anyOf/0"
+                },
+                "description": "New tool allowlist."
+              },
+              "toolsDeny": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/definitions/ControlSettingsUpdateRequest/properties/primaryHarness/anyOf/0"
+                },
+                "description": "New tool denylist."
+              },
+              "fallbackModel": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/ControlSettingsUpdateRequest/properties/primaryHarness/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": {
+                "$ref": "#/definitions/ControlSettingsUpdateRequest/properties/authPreference",
+                "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)."
+          },
+          "propertyNames": {
+            "minLength": 1,
+            "pattern": "\\S"
+          },
+          "description": "Per-harness settings patches keyed by harness id."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Request body for PATCH /settings; absent fields keep their stored values."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}