{ "$schema": "http://json-schema.org/draft-07/schema#", "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "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-failure", "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" } ] }, "DynamicToolSpec": { "properties": { "deferLoading": { "type": "boolean" }, "description": { "type": "string" }, "inputSchema": true, "name": { "type": "string" }, "namespace": { "type": [ "string", "null" ] } }, "required": [ "description", "inputSchema", "name" ], "type": "object" }, "FileSystemAccessMode": { "enum": [ "read", "write", "none" ], "type": "string" }, "FileSystemPath": { "oneOf": [ { "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { "enum": [ "path" ], "title": "PathFileSystemPathType", "type": "string" } }, "required": [ "path", "type" ], "title": "PathFileSystemPath", "type": "object" }, { "properties": { "pattern": { "type": "string" }, "type": { "enum": [ "glob_pattern" ], "title": "GlobPatternFileSystemPathType", "type": "string" } }, "required": [ "pattern", "type" ], "title": "GlobPatternFileSystemPath", "type": "object" }, { "properties": { "type": { "enum": [ "special" ], "title": "SpecialFileSystemPathType", "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, "required": [ "type", "value" ], "title": "SpecialFileSystemPath", "type": "object" } ] }, "FileSystemSandboxEntry": { "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" }, "path": { "$ref": "#/definitions/FileSystemPath" } }, "required": [ "access", "path" ], "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { "properties": { "kind": { "enum": [ "root" ], "type": "string" } }, "required": [ "kind" ], "title": "RootFileSystemSpecialPath", "type": "object" }, { "properties": { "kind": { "enum": [ "minimal" ], "type": "string" } }, "required": [ "kind" ], "title": "MinimalFileSystemSpecialPath", "type": "object" }, { "properties": { "kind": { "enum": [ "current_working_directory" ], "type": "string" } }, "required": [ "kind" ], "title": "CurrentWorkingDirectoryFileSystemSpecialPath", "type": "object" }, { "properties": { "kind": { "enum": [ "project_roots" ], "type": "string" }, "subpath": { "type": [ "string", "null" ] } }, "required": [ "kind" ], "title": "KindFileSystemSpecialPath", "type": "object" }, { "properties": { "kind": { "enum": [ "tmpdir" ], "type": "string" } }, "required": [ "kind" ], "title": "TmpdirFileSystemSpecialPath", "type": "object" }, { "properties": { "kind": { "enum": [ "slash_tmp" ], "type": "string" } }, "required": [ "kind" ], "title": "SlashTmpFileSystemSpecialPath", "type": "object" }, { "properties": { "kind": { "enum": [ "unknown" ], "type": "string" }, "path": { "type": "string" }, "subpath": { "type": [ "string", "null" ] } }, "required": [ "kind", "path" ], "type": "object" } ] }, "PermissionProfile": { "properties": { "fileSystem": { "anyOf": [ { "$ref": "#/definitions/PermissionProfileFileSystemPermissions" }, { "type": "null" } ] }, "network": { "anyOf": [ { "$ref": "#/definitions/PermissionProfileNetworkPermissions" }, { "type": "null" } ] } }, "type": "object" }, "PermissionProfileFileSystemPermissions": { "properties": { "entries": { "items": { "$ref": "#/definitions/FileSystemSandboxEntry" }, "type": "array" }, "globScanMaxDepth": { "format": "uint", "minimum": 1.0, "type": [ "integer", "null" ] } }, "required": [ "entries" ], "type": "object" }, "PermissionProfileNetworkPermissions": { "properties": { "enabled": { "type": [ "boolean", "null" ] } }, "type": "object" }, "Personality": { "enum": [ "none", "friendly", "pragmatic" ], "type": "string" }, "SandboxMode": { "enum": [ "read-only", "workspace-write", "danger-full-access" ], "type": "string" }, "ServiceTier": { "enum": [ "fast", "flex" ], "type": "string" }, "ThreadStartSource": { "enum": [ "startup", "clear" ], "type": "string" } }, "properties": { "approvalPolicy": { "anyOf": [ { "$ref": "#/definitions/AskForApproval" }, { "type": "null" } ] }, "approvalsReviewer": { "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" }, { "type": "null" } ], "description": "Override where approval requests are routed for review on this thread and subsequent turns." }, "baseInstructions": { "type": [ "string", "null" ] }, "config": { "additionalProperties": true, "type": [ "object", "null" ] }, "cwd": { "type": [ "string", "null" ] }, "developerInstructions": { "type": [ "string", "null" ] }, "ephemeral": { "type": [ "boolean", "null" ] }, "model": { "type": [ "string", "null" ] }, "modelProvider": { "type": [ "string", "null" ] }, "permissionProfile": { "anyOf": [ { "$ref": "#/definitions/PermissionProfile" }, { "type": "null" } ], "description": "Full permissions override for this thread. Cannot be combined with `sandbox`." }, "personality": { "anyOf": [ { "$ref": "#/definitions/Personality" }, { "type": "null" } ] }, "sandbox": { "anyOf": [ { "$ref": "#/definitions/SandboxMode" }, { "type": "null" } ] }, "serviceName": { "type": [ "string", "null" ] }, "serviceTier": { "anyOf": [ { "anyOf": [ { "$ref": "#/definitions/ServiceTier" }, { "type": "null" } ] }, { "type": "null" } ] }, "sessionStartSource": { "anyOf": [ { "$ref": "#/definitions/ThreadStartSource" }, { "type": "null" } ] } }, "title": "ThreadStartParams", "type": "object" }