{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://docs.dvoid.io/schemas/settings/console.json",
  "title": "dvoid settings: Console",
  "description": "Theme, glyph face, the button and tab looks, density, outlines, borders, where Files sits, and what a launch opens.",
  "type": "object",
  "properties": {
    "theme": {
      "type": "string",
      "enum": [
        "dvoid",
        "dvoid-light",
        "catppuccin",
        "gruvbox",
        "rose-pine",
        "tokyo-night",
        "nord",
        "sand"
      ],
      "default": "dvoid",
      "description": "The colour theme: a preset, or a file under ~/.config/dvoid/console/themes/."
    },
    "icons": {
      "type": "string",
      "enum": [
        "auto",
        "nerd",
        "unicode"
      ],
      "default": "auto",
      "description": "The glyph face. auto picks nerd when the terminal is known to carry a Nerd Font, else unicode.",
      "x-enumLabels": {
        "auto": "Detect",
        "nerd": "Nerd Font",
        "unicode": "Unicode"
      }
    },
    "buttons": {
      "type": "string",
      "enum": [
        "theme",
        "bracket",
        "filled",
        "boxed"
      ],
      "default": "filled",
      "description": "How buttons draw: [Label], a filled ground, or a bordered box; theme leaves it to the theme file. Settings › Console previews each under its form.",
      "x-enumLabels": {
        "theme": "The theme's choice",
        "bracket": "[Bracket]",
        "filled": "Filled",
        "boxed": "Boxed"
      }
    },
    "tabs": {
      "type": "string",
      "enum": [
        "theme",
        "bracket",
        "underline",
        "pill",
        "pill+underline",
        "pill+bracket"
      ],
      "default": "pill",
      "description": "How a tab row marks the selected tab: [Label], an underline, a pill cut out of the band, or the pill with an underline or [brackets] as well.",
      "x-enumLabels": {
        "theme": "The theme's choice",
        "bracket": "[Bracket]",
        "underline": "Underline",
        "pill": "Pill",
        "pill+underline": "Pill + underline",
        "pill+bracket": "Pill + [bracket]"
      }
    },
    "density": {
      "type": "string",
      "enum": [
        "theme",
        "compact",
        "comfortable"
      ],
      "default": "comfortable",
      "description": "How tightly rows pack: compact (no cell beside a label) or comfortable (one).",
      "x-enumLabels": {
        "theme": "The theme's choice",
        "compact": "Compact",
        "comfortable": "Comfortable"
      }
    },
    "outline": {
      "type": "string",
      "enum": [
        "theme",
        "none",
        "rules",
        "frames"
      ],
      "default": "frames",
      "description": "What tells stacked rows apart: nothing, a rule between them, or frames around action rows with separators between tabs.",
      "x-enumLabels": {
        "theme": "The theme's choice",
        "none": "None",
        "rules": "Rules",
        "frames": "Frames"
      }
    },
    "border": {
      "type": "string",
      "enum": [
        "theme",
        "single",
        "rounded",
        "double",
        "heavy"
      ],
      "default": "rounded",
      "description": "The border style of every frame: panes, the screen, boxed buttons, outline frames.",
      "x-enumLabels": {
        "theme": "The theme's choice",
        "single": "Single ─",
        "rounded": "Rounded ╭",
        "double": "Double ═",
        "heavy": "Heavy ━"
      }
    },
    "files": {
      "type": "string",
      "enum": [
        "drawer",
        "pane"
      ],
      "default": "drawer",
      "description": "Where a workspace keeps Files and the Assistant: drawers that F3, F4 or the rail beside the top-left pane slide out over the panes, or panes in the layout (an Assistant pane in view takes F4 either way).",
      "x-enumLabels": {
        "drawer": "Drawer over the panes",
        "pane": "A pane in the layout"
      }
    },
    "browserApprovals": {
      "type": "string",
      "enum": [
        "ask",
        "trusted"
      ],
      "default": "ask",
      "x-showDescription": true,
      "description": "Standing browser consent for this OS user, across console restarts. Trusted lets local console-control callers read or operate pages without asking, but only where Trusted browser scope names the browser's workspace or profile, reading and driving each listed apart (driving includes JavaScript evaluation). Private screens, driver ownership and takeover approval still apply. Choose Ask or reset to require approval again; commands already sent may finish.",
      "x-enumLabels": {
        "ask": "Ask for browser access",
        "trusted": "Trust local tools within the scope below"
      }
    },
    "approvalWait": {
      "type": "string",
      "enum": [
        "2",
        "10",
        "30",
        "never"
      ],
      "default": "never",
      "description": "How long an agent's approval or question waits in the console before the agent's own prompt asks instead. Until you answer is the default (owner, 2026-11-15: a waiting agent costs nothing); a card still goes when the agent stops waiting (Esc in its pane, or it exits). Never an allow.",
      "x-enumLabels": {
        "2": "2 minutes",
        "10": "10 minutes",
        "30": "30 minutes",
        "never": "Until you answer"
      }
    },
    "browserTrust": {
      "type": "object",
      "title": "Trusted browser scope",
      "properties": {
        "read": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Where trusted tools may read pages (snapshot, get, screenshot) unasked: workspace:<name>, profile:<Chrome profile name> or profile:remembered. Empty: nowhere."
        },
        "drive": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Where trusted tools may operate pages (click, fill, open, eval) unasked; same forms. Empty: nowhere."
        }
      }
    },
    "startup": {
      "type": "string",
      "enum": [
        "ask",
        "console"
      ],
      "default": "ask",
      "description": "At launch with none running: always ask which console to open (New empty console is one choice), or open the last one used.",
      "x-enumLabels": {
        "ask": "Ask which console",
        "console": "Open the last console"
      }
    },
    "approvalArrival": {
      "type": "string",
      "enum": [
        "center",
        "inbox"
      ],
      "default": "center",
      "description": "How a new approval or question first appears. Either way it waits in the Inbox (the rail's Inbox, I on a card, Ctrl+G !) until it is answered, and Esc on a card moves it there, so you can finish what you were typing first.",
      "x-enumLabels": {
        "center": "Its card, in the centre (takes the keyboard)",
        "inbox": "Waits in the Inbox: the rail and the title blink, nothing takes the keyboard"
      }
    },
    "answerDevices": {
      "type": "string",
      "enum": [
        "off",
        "on"
      ],
      "default": "on",
      "description": "Whether the devices you paired (Settings › Paired devices) may read, for a request waiting here, the conversation that led to it (up to your 20th-last message): redacted on this machine, sent a page at a time, sealed so only the device that asked can read it. On, this console sends its device key with each request it mirrors and, while one waits, a device is paired and you are signed in, holds one connection to the relay; a device not paired is never answered. Off, neither: nothing is answered, nothing can pair, and no connection is opened. Deciding still happens only here.",
      "x-enumLabels": {
        "off": "Off: answer none of my other devices",
        "on": "Answer my paired devices: why an agent asks"
      }
    }
  },
  "additionalProperties": true
}
