{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://docs.dvoid.io/schemas/settings/agents.json",
  "title": "dvoid settings: Agents",
  "description": "One approval and sandbox for every harness, mapped to its flags at launch.",
  "type": "object",
  "properties": {
    "approval": {
      "type": "string",
      "enum": [
        "ask",
        "edits",
        "smart",
        "never"
      ],
      "default": "smart",
      "description": "What an agent may do without asking, the same in every harness. A harness that cannot say it runs the nearest mode and says so. With guard on Follows approval, Never ask also quiets dvoid-guard to the critical only (credentials, deleting outside the workstream, force pushes, infrastructure); every other choice keeps every guard.",
      "x-enumLabels": {
        "ask": "Ask before every action",
        "edits": "Edit files freely, ask for commands",
        "smart": "Ask only when a reviewer flags risk",
        "never": "Never ask"
      }
    },
    "sandbox": {
      "type": "string",
      "enum": [
        "off",
        "workspace",
        "strict"
      ],
      "default": "off",
      "description": "Where an agent's commands run. Claude Code and Codex sandbox them; pi and Hermes have no sandbox and say so.",
      "x-enumLabels": {
        "off": "No sandbox",
        "workspace": "Write inside the workspace",
        "strict": "No escape from the sandbox"
      }
    },
    "guard": {
      "type": "string",
      "enum": [
        "auto",
        "minimal",
        "soft",
        "normal",
        "hard"
      ],
      "default": "auto",
      "description": "How much dvoid-guard stops (DVOID_GUARD_MODE). Follows approval (auto) is critical only on Never ask and every guard otherwise; minimal stops only the critical (credentials, deleting outside the workstream, force pushes, infrastructure); soft sends process nudges to you instead of the agent; hard closes the DVOID_ALLOW_* escape hatches. The floor always asks.",
      "x-enumLabels": {
        "auto": "Follows approval",
        "minimal": "Critical only",
        "soft": "Nudges reach you, not the agent",
        "normal": "Every guard as shipped",
        "hard": "No escape hatches"
      }
    }
  },
  "additionalProperties": true
}
