tutti/packages/agent/daemon/runtime/codexproto/schema/json/v2/ConfigRequirementsReadResponse.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "ApprovalsReviewer": {
      "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.",
      "enum": ["user", "auto_review", "guardian_subagent"],
      "type": "string"
    },
    "AskForApproval": {
      "oneOf": [
        {
          "enum": ["untrusted", "on-request", "never"],
          "type": "string"
        },
        {
          "additionalProperties": false,
          "properties": {
            "granular": {
              "properties": {
                "mcp_elicitations": {
                  "type": "boolean"
                },
                "request_permissions": {
                  "default": false,
                  "type": "boolean"
                },
                "rules": {
                  "type": "boolean"
                },
                "sandbox_approval": {
                  "type": "boolean"
                },
                "skill_approval": {
                  "default": false,
                  "type": "boolean"
                }
              },
              "required": ["mcp_elicitations", "rules", "sandbox_approval"],
              "type": "object"
            }
          },
          "required": ["granular"],
          "title": "GranularAskForApproval",
          "type": "object"
        }
      ]
    },
    "ComputerUseRequirements": {
      "properties": {
        "allowLockedComputerUse": {
          "type": ["boolean", "null"]
        }
      },
      "type": "object"
    },
    "ConfigRequirements": {
      "properties": {
        "allowAppshots": {
          "type": ["boolean", "null"]
        },
        "allowManagedHooksOnly": {
          "type": ["boolean", "null"]
        },
        "allowRemoteControl": {
          "type": ["boolean", "null"]
        },
        "allowedApprovalPolicies": {
          "items": {
            "$ref": "#/definitions/AskForApproval"
          },
          "type": ["array", "null"]
        },
        "allowedPermissionProfiles": {
          "additionalProperties": {
            "type": "boolean"
          },
          "type": ["object", "null"]
        },
        "allowedSandboxModes": {
          "items": {
            "$ref": "#/definitions/SandboxMode"
          },
          "type": ["array", "null"]
        },
        "allowedWebSearchModes": {
          "items": {
            "$ref": "#/definitions/WebSearchMode"
          },
          "type": ["array", "null"]
        },
        "allowedWindowsSandboxImplementations": {
          "items": {
            "$ref": "#/definitions/WindowsSandboxSetupMode"
          },
          "type": ["array", "null"]
        },
        "computerUse": {
          "anyOf": [
            {
              "$ref": "#/definitions/ComputerUseRequirements"
            },
            {
              "type": "null"
            }
          ]
        },
        "defaultPermissions": {
          "type": ["string", "null"]
        },
        "enforceResidency": {
          "anyOf": [
            {
              "$ref": "#/definitions/ResidencyRequirement"
            },
            {
              "type": "null"
            }
          ]
        },
        "featureRequirements": {
          "additionalProperties": {
            "type": "boolean"
          },
          "type": ["object", "null"]
        }
      },
      "type": "object"
    },
    "ConfiguredHookHandler": {
      "oneOf": [
        {
          "properties": {
            "async": {
              "type": "boolean"
            },
            "command": {
              "type": "string"
            },
            "commandWindows": {
              "type": ["string", "null"]
            },
            "statusMessage": {
              "type": ["string", "null"]
            },
            "timeoutSec": {
              "format": "uint64",
              "minimum": 0.0,
              "type": ["integer", "null"]
            },
            "type": {
              "enum": ["command"],
              "title": "CommandConfiguredHookHandlerType",
              "type": "string"
            }
          },
          "required": ["async", "command", "type"],
          "title": "CommandConfiguredHookHandler",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": ["prompt"],
              "title": "PromptConfiguredHookHandlerType",
              "type": "string"
            }
          },
          "required": ["type"],
          "title": "PromptConfiguredHookHandler",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": ["agent"],
              "title": "AgentConfiguredHookHandlerType",
              "type": "string"
            }
          },
          "required": ["type"],
          "title": "AgentConfiguredHookHandler",
          "type": "object"
        }
      ]
    },
    "ConfiguredHookMatcherGroup": {
      "properties": {
        "hooks": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookHandler"
          },
          "type": "array"
        },
        "matcher": {
          "type": ["string", "null"]
        }
      },
      "required": ["hooks"],
      "type": "object"
    },
    "ManagedHooksRequirements": {
      "properties": {
        "PermissionRequest": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "PostCompact": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "PostToolUse": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "PreCompact": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "PreToolUse": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "SessionStart": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "Stop": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "SubagentStart": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "SubagentStop": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "UserPromptSubmit": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "managedDir": {
          "type": ["string", "null"]
        },
        "windowsManagedDir": {
          "type": ["string", "null"]
        }
      },
      "required": [
        "PermissionRequest",
        "PostCompact",
        "PostToolUse",
        "PreCompact",
        "PreToolUse",
        "SessionStart",
        "Stop",
        "SubagentStart",
        "SubagentStop",
        "UserPromptSubmit"
      ],
      "type": "object"
    },
    "NetworkDomainPermission": {
      "enum": ["allow", "deny"],
      "type": "string"
    },
    "NetworkRequirements": {
      "properties": {
        "allowLocalBinding": {
          "type": ["boolean", "null"]
        },
        "allowUnixSockets": {
          "description": "Legacy compatibility view derived from `unix_sockets`.",
          "items": {
            "type": "string"
          },
          "type": ["array", "null"]
        },
        "allowUpstreamProxy": {
          "type": ["boolean", "null"]
        },
        "allowedDomains": {
          "description": "Legacy compatibility view derived from `domains`.",
          "items": {
            "type": "string"
          },
          "type": ["array", "null"]
        },
        "dangerouslyAllowAllUnixSockets": {
          "type": ["boolean", "null"]
        },
        "dangerouslyAllowNonLoopbackProxy": {
          "type": ["boolean", "null"]
        },
        "deniedDomains": {
          "description": "Legacy compatibility view derived from `domains`.",
          "items": {
            "type": "string"
          },
          "type": ["array", "null"]
        },
        "domains": {
          "additionalProperties": {
            "$ref": "#/definitions/NetworkDomainPermission"
          },
          "description": "Canonical network permission map for `experimental_network`.",
          "type": ["object", "null"]
        },
        "enabled": {
          "type": ["boolean", "null"]
        },
        "httpPort": {
          "format": "uint16",
          "minimum": 0.0,
          "type": ["integer", "null"]
        },
        "managedAllowedDomainsOnly": {
          "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.",
          "type": ["boolean", "null"]
        },
        "socksPort": {
          "format": "uint16",
          "minimum": 0.0,
          "type": ["integer", "null"]
        },
        "unixSockets": {
          "additionalProperties": {
            "$ref": "#/definitions/NetworkUnixSocketPermission"
          },
          "description": "Canonical unix socket permission map for `experimental_network`.",
          "type": ["object", "null"]
        }
      },
      "type": "object"
    },
    "NetworkUnixSocketPermission": {
      "enum": ["allow", "deny"],
      "type": "string"
    },
    "ResidencyRequirement": {
      "enum": ["us"],
      "type": "string"
    },
    "SandboxMode": {
      "enum": ["read-only", "workspace-write", "danger-full-access"],
      "type": "string"
    },
    "WebSearchMode": {
      "enum": ["disabled", "cached", "indexed", "live"],
      "type": "string"
    },
    "WindowsSandboxSetupMode": {
      "enum": ["elevated", "unelevated"],
      "type": "string"
    }
  },
  "properties": {
    "requirements": {
      "anyOf": [
        {
          "$ref": "#/definitions/ConfigRequirements"
        },
        {
          "type": "null"
        }
      ],
      "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)."
    }
  },
  "title": "ConfigRequirementsReadResponse",
  "type": "object"
}