{ "$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" }, "AccountLoginCompletedNotification": { "properties": { "error": { "type": [ "string", "null" ] }, "loginId": { "type": [ "string", "null" ] }, "success": { "type": "boolean" } }, "required": [ "success" ], "type": "object" }, "AccountRateLimitsUpdatedNotification": { "description": "Sparse rolling rate-limit update.\n\nClients should merge available values into the most recent `account/rateLimits/read` response or refetch that snapshot. Nullable account metadata may be unavailable in a rolling update and does not clear a previously observed value.", "properties": { "rateLimits": { "$ref": "#/definitions/RateLimitSnapshot" } }, "required": [ "rateLimits" ], "type": "object" }, "AccountUpdatedNotification": { "properties": { "authMode": { "anyOf": [ { "$ref": "#/definitions/AuthMode" }, { "type": "null" } ] }, "planType": { "anyOf": [ { "$ref": "#/definitions/PlanType" }, { "type": "null" } ] } }, "type": "object" }, "ActivePermissionProfile": { "properties": { "extends": { "default": null, "description": "Parent profile identifier from the selected permissions profile's `extends` setting, when present.", "type": [ "string", "null" ] }, "id": { "description": "Identifier from `default_permissions` or the implicit built-in default, such as `:workspace` or a user-defined `[permissions.]` profile.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "AdditionalFileSystemPermissions": { "properties": { "entries": { "items": { "$ref": "#/definitions/FileSystemSandboxEntry" }, "type": [ "array", "null" ] }, "globScanMaxDepth": { "format": "uint", "minimum": 1.0, "type": [ "integer", "null" ] }, "read": { "description": "This will be removed in favor of `entries`.", "items": { "$ref": "#/definitions/LegacyAppPathString" }, "type": [ "array", "null" ] }, "write": { "description": "This will be removed in favor of `entries`.", "items": { "$ref": "#/definitions/LegacyAppPathString" }, "type": [ "array", "null" ] } }, "type": "object" }, "AdditionalNetworkPermissions": { "properties": { "enabled": { "type": [ "boolean", "null" ] } }, "type": "object" }, "AgentMessageDeltaNotification": { "properties": { "delta": { "type": "string" }, "itemId": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "delta", "itemId", "threadId", "turnId" ], "type": "object" }, "AgentPath": { "type": "string" }, "AppBranding": { "description": "EXPERIMENTAL - app metadata returned by app-list APIs.", "properties": { "category": { "type": [ "string", "null" ] }, "developer": { "type": [ "string", "null" ] }, "isDiscoverableApp": { "type": "boolean" }, "privacyPolicy": { "type": [ "string", "null" ] }, "termsOfService": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] } }, "required": [ "isDiscoverableApp" ], "type": "object" }, "AppInfo": { "description": "EXPERIMENTAL - app metadata returned by app-list APIs.", "properties": { "appMetadata": { "anyOf": [ { "$ref": "#/definitions/AppMetadata" }, { "type": "null" } ] }, "branding": { "anyOf": [ { "$ref": "#/definitions/AppBranding" }, { "type": "null" } ] }, "description": { "type": [ "string", "null" ] }, "distributionChannel": { "type": [ "string", "null" ] }, "id": { "type": "string" }, "installUrl": { "type": [ "string", "null" ] }, "isAccessible": { "default": false, "type": "boolean" }, "isEnabled": { "default": true, "description": "Whether this app is enabled in config.toml. Example: ```toml [apps.bad_app] enabled = false ```", "type": "boolean" }, "labels": { "additionalProperties": { "type": "string" }, "type": [ "object", "null" ] }, "logoUrl": { "type": [ "string", "null" ] }, "logoUrlDark": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "pluginDisplayNames": { "default": [], "items": { "type": "string" }, "type": "array" } }, "required": [ "id", "name" ], "type": "object" }, "AppListUpdatedNotification": { "description": "EXPERIMENTAL - notification emitted when the app list changes.", "properties": { "data": { "items": { "$ref": "#/definitions/AppInfo" }, "type": "array" } }, "required": [ "data" ], "type": "object" }, "AppMetadata": { "properties": { "categories": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "developer": { "type": [ "string", "null" ] }, "firstPartyRequiresInstall": { "type": [ "boolean", "null" ] }, "firstPartyType": { "type": [ "string", "null" ] }, "review": { "anyOf": [ { "$ref": "#/definitions/AppReview" }, { "type": "null" } ] }, "screenshots": { "items": { "$ref": "#/definitions/AppScreenshot" }, "type": [ "array", "null" ] }, "seoDescription": { "type": [ "string", "null" ] }, "showInComposerWhenUnlinked": { "type": [ "boolean", "null" ] }, "subCategories": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "version": { "type": [ "string", "null" ] }, "versionId": { "type": [ "string", "null" ] }, "versionNotes": { "type": [ "string", "null" ] } }, "type": "object" }, "AppReview": { "properties": { "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "AppScreenshot": { "properties": { "fileId": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "userPrompt": { "type": "string" } }, "required": [ "userPrompt" ], "type": "object" }, "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" } ] }, "AuthMode": { "description": "Authentication mode for OpenAI-backed providers.", "oneOf": [ { "description": "OpenAI API key provided by the caller and stored by Codex.", "enum": [ "apikey" ], "type": "string" }, { "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", "enum": [ "chatgpt" ], "type": "string" }, { "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.", "enum": [ "chatgptAuthTokens" ], "type": "string" }, { "description": "Programmatic Codex auth backed by a registered Agent Identity.", "enum": [ "agentIdentity" ], "type": "string" }, { "description": "Programmatic Codex auth backed by a personal access token.", "enum": [ "personalAccessToken" ], "type": "string" }, { "description": "Amazon Bedrock bearer token managed by Codex.", "enum": [ "bedrockApiKey" ], "type": "string" } ] }, "AutoReviewDecisionSource": { "description": "[UNSTABLE] Source that produced a terminal approval auto-review decision.", "enum": [ "agent" ], "type": "string" }, "ByteRange": { "properties": { "end": { "format": "uint", "minimum": 0.0, "type": "integer" }, "start": { "format": "uint", "minimum": 0.0, "type": "integer" } }, "required": [ "end", "start" ], "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { "enum": [ "contextWindowExceeded", "usageLimitExceeded", "serverOverloaded", "cyberPolicy", "internalServerError", "unauthorized", "badRequest", "threadRollbackFailed", "sandboxError", "other" ], "type": "string" }, { "additionalProperties": false, "properties": { "httpConnectionFailed": { "properties": { "httpStatusCode": { "format": "uint16", "minimum": 0.0, "type": [ "integer", "null" ] } }, "type": "object" } }, "required": [ "httpConnectionFailed" ], "title": "HttpConnectionFailedCodexErrorInfo", "type": "object" }, { "additionalProperties": false, "description": "Failed to connect to the response SSE stream.", "properties": { "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { "format": "uint16", "minimum": 0.0, "type": [ "integer", "null" ] } }, "type": "object" } }, "required": [ "responseStreamConnectionFailed" ], "title": "ResponseStreamConnectionFailedCodexErrorInfo", "type": "object" }, { "additionalProperties": false, "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { "responseStreamDisconnected": { "properties": { "httpStatusCode": { "format": "uint16", "minimum": 0.0, "type": [ "integer", "null" ] } }, "type": "object" } }, "required": [ "responseStreamDisconnected" ], "title": "ResponseStreamDisconnectedCodexErrorInfo", "type": "object" }, { "additionalProperties": false, "description": "Reached the retry limit for responses.", "properties": { "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { "format": "uint16", "minimum": 0.0, "type": [ "integer", "null" ] } }, "type": "object" } }, "required": [ "responseTooManyFailedAttempts" ], "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", "type": "object" }, { "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", "properties": { "activeTurnNotSteerable": { "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } }, "required": [ "turnKind" ], "type": "object" } }, "required": [ "activeTurnNotSteerable" ], "title": "ActiveTurnNotSteerableCodexErrorInfo", "type": "object" } ] }, "CollabAgentState": { "properties": { "message": { "type": [ "string", "null" ] }, "status": { "$ref": "#/definitions/CollabAgentStatus" } }, "required": [ "status" ], "type": "object" }, "CollabAgentStatus": { "enum": [ "pendingInit", "running", "interrupted", "completed", "errored", "shutdown", "notFound" ], "type": "string" }, "CollabAgentTool": { "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" ], "type": "string" }, "CollabAgentToolCallStatus": { "enum": [ "inProgress", "completed", "failed" ], "type": "string" }, "CollaborationMode": { "description": "Collaboration mode for a Codex session.", "properties": { "mode": { "$ref": "#/definitions/ModeKind" }, "settings": { "$ref": "#/definitions/Settings" } }, "required": [ "mode", "settings" ], "type": "object" }, "CommandAction": { "oneOf": [ { "properties": { "command": { "type": "string" }, "name": { "type": "string" }, "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { "enum": [ "read" ], "title": "ReadCommandActionType", "type": "string" } }, "required": [ "command", "name", "path", "type" ], "title": "ReadCommandAction", "type": "object" }, { "properties": { "command": { "type": "string" }, "path": { "type": [ "string", "null" ] }, "type": { "enum": [ "listFiles" ], "title": "ListFilesCommandActionType", "type": "string" } }, "required": [ "command", "type" ], "title": "ListFilesCommandAction", "type": "object" }, { "properties": { "command": { "type": "string" }, "path": { "type": [ "string", "null" ] }, "query": { "type": [ "string", "null" ] }, "type": { "enum": [ "search" ], "title": "SearchCommandActionType", "type": "string" } }, "required": [ "command", "type" ], "title": "SearchCommandAction", "type": "object" }, { "properties": { "command": { "type": "string" }, "type": { "enum": [ "unknown" ], "title": "UnknownCommandActionType", "type": "string" } }, "required": [ "command", "type" ], "title": "UnknownCommandAction", "type": "object" } ] }, "CommandExecOutputDeltaNotification": { "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", "properties": { "capReached": { "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", "type": "boolean" }, "deltaBase64": { "description": "Base64-encoded output bytes.", "type": "string" }, "processId": { "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" }, "stream": { "allOf": [ { "$ref": "#/definitions/CommandExecOutputStream" } ], "description": "Output stream for this chunk." } }, "required": [ "capReached", "deltaBase64", "processId", "stream" ], "type": "object" }, "CommandExecOutputStream": { "description": "Stream label for `command/exec/outputDelta` notifications.", "oneOf": [ { "description": "stdout stream. PTY mode multiplexes terminal output here.", "enum": [ "stdout" ], "type": "string" }, { "description": "stderr stream.", "enum": [ "stderr" ], "type": "string" } ] }, "CommandExecutionOutputDeltaNotification": { "properties": { "delta": { "type": "string" }, "itemId": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "delta", "itemId", "threadId", "turnId" ], "type": "object" }, "CommandExecutionSource": { "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" ], "type": "string" }, "CommandExecutionStatus": { "enum": [ "inProgress", "completed", "failed", "declined" ], "type": "string" }, "ConfigWarningNotification": { "properties": { "details": { "description": "Optional extra guidance or error details.", "type": [ "string", "null" ] }, "path": { "description": "Optional path to the config file that triggered the warning.", "type": [ "string", "null" ] }, "range": { "anyOf": [ { "$ref": "#/definitions/TextRange" }, { "type": "null" } ], "description": "Optional range for the error location inside the config file." }, "summary": { "description": "Concise summary of the warning.", "type": "string" } }, "required": [ "summary" ], "type": "object" }, "ContextCompactedNotification": { "description": "Deprecated: Use `ContextCompaction` item type instead.", "properties": { "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "threadId", "turnId" ], "type": "object" }, "CreditsSnapshot": { "properties": { "balance": { "type": [ "string", "null" ] }, "hasCredits": { "type": "boolean" }, "unlimited": { "type": "boolean" } }, "required": [ "hasCredits", "unlimited" ], "type": "object" }, "DeprecationNoticeNotification": { "properties": { "details": { "description": "Optional extra guidance, such as migration steps or rationale.", "type": [ "string", "null" ] }, "summary": { "description": "Concise summary of what is deprecated.", "type": "string" } }, "required": [ "summary" ], "type": "object" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { "properties": { "text": { "type": "string" }, "type": { "enum": [ "inputText" ], "title": "InputTextDynamicToolCallOutputContentItemType", "type": "string" } }, "required": [ "text", "type" ], "title": "InputTextDynamicToolCallOutputContentItem", "type": "object" }, { "properties": { "imageUrl": { "type": "string" }, "type": { "enum": [ "inputImage" ], "title": "InputImageDynamicToolCallOutputContentItemType", "type": "string" } }, "required": [ "imageUrl", "type" ], "title": "InputImageDynamicToolCallOutputContentItem", "type": "object" } ] }, "DynamicToolCallStatus": { "enum": [ "inProgress", "completed", "failed" ], "type": "string" }, "ErrorNotification": { "properties": { "error": { "$ref": "#/definitions/TurnError" }, "threadId": { "type": "string" }, "turnId": { "type": "string" }, "willRetry": { "type": "boolean" } }, "required": [ "error", "threadId", "turnId", "willRetry" ], "type": "object" }, "ExternalAgentConfigImportCompletedNotification": { "properties": { "importId": { "type": "string" }, "itemTypeResults": { "items": { "$ref": "#/definitions/ExternalAgentConfigImportTypeResult" }, "type": "array" } }, "required": [ "importId", "itemTypeResults" ], "type": "object" }, "ExternalAgentConfigImportItemTypeFailure": { "properties": { "cwd": { "type": [ "string", "null" ] }, "errorType": { "type": [ "string", "null" ] }, "failureStage": { "type": "string" }, "itemType": { "$ref": "#/definitions/ExternalAgentConfigMigrationItemType" }, "message": { "type": "string" }, "source": { "type": [ "string", "null" ] } }, "required": [ "failureStage", "itemType", "message" ], "type": "object" }, "ExternalAgentConfigImportItemTypeSuccess": { "properties": { "cwd": { "type": [ "string", "null" ] }, "itemType": { "$ref": "#/definitions/ExternalAgentConfigMigrationItemType" }, "source": { "type": [ "string", "null" ] }, "target": { "type": [ "string", "null" ] } }, "required": [ "itemType" ], "type": "object" }, "ExternalAgentConfigImportProgressNotification": { "properties": { "importId": { "type": "string" }, "itemTypeResults": { "items": { "$ref": "#/definitions/ExternalAgentConfigImportTypeResult" }, "type": "array" } }, "required": [ "importId", "itemTypeResults" ], "type": "object" }, "ExternalAgentConfigImportTypeResult": { "properties": { "failures": { "items": { "$ref": "#/definitions/ExternalAgentConfigImportItemTypeFailure" }, "type": "array" }, "itemType": { "$ref": "#/definitions/ExternalAgentConfigMigrationItemType" }, "successes": { "items": { "$ref": "#/definitions/ExternalAgentConfigImportItemTypeSuccess" }, "type": "array" } }, "required": [ "failures", "itemType", "successes" ], "type": "object" }, "ExternalAgentConfigMigrationItemType": { "enum": [ "AGENTS_MD", "CONFIG", "SKILLS", "PLUGINS", "MCP_SERVER_CONFIG", "SUBAGENTS", "HOOKS", "COMMANDS", "SESSIONS" ], "type": "string" }, "FileChangeOutputDeltaNotification": { "description": "Deprecated legacy notification for `apply_patch` textual output.\n\nThe server no longer emits this notification.", "properties": { "delta": { "type": "string" }, "itemId": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "delta", "itemId", "threadId", "turnId" ], "type": "object" }, "FileChangePatchUpdatedNotification": { "properties": { "changes": { "items": { "$ref": "#/definitions/FileUpdateChange" }, "type": "array" }, "itemId": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "changes", "itemId", "threadId", "turnId" ], "type": "object" }, "FileSystemAccessMode": { "enum": [ "read", "write", "deny" ], "type": "string" }, "FileSystemPath": { "oneOf": [ { "properties": { "path": { "$ref": "#/definitions/LegacyAppPathString" }, "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": [ "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" } ] }, "FileUpdateChange": { "properties": { "diff": { "type": "string" }, "kind": { "$ref": "#/definitions/PatchChangeKind" }, "path": { "type": "string" } }, "required": [ "diff", "kind", "path" ], "type": "object" }, "FsChangedNotification": { "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", "properties": { "changedPaths": { "description": "File or directory paths associated with this event.", "items": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": "array" }, "watchId": { "description": "Watch identifier previously provided to `fs/watch`.", "type": "string" } }, "required": [ "changedPaths", "watchId" ], "type": "object" }, "FuzzyFileSearchMatchType": { "enum": [ "file", "directory" ], "type": "string" }, "FuzzyFileSearchResult": { "description": "Superset of [`codex_file_search::FileMatch`]", "properties": { "file_name": { "type": "string" }, "indices": { "items": { "format": "uint32", "minimum": 0.0, "type": "integer" }, "type": [ "array", "null" ] }, "match_type": { "$ref": "#/definitions/FuzzyFileSearchMatchType" }, "path": { "type": "string" }, "root": { "type": "string" }, "score": { "format": "uint32", "minimum": 0.0, "type": "integer" } }, "required": [ "file_name", "match_type", "path", "root", "score" ], "type": "object" }, "FuzzyFileSearchSessionCompletedNotification": { "properties": { "sessionId": { "type": "string" } }, "required": [ "sessionId" ], "type": "object" }, "FuzzyFileSearchSessionUpdatedNotification": { "properties": { "files": { "items": { "$ref": "#/definitions/FuzzyFileSearchResult" }, "type": "array" }, "query": { "type": "string" }, "sessionId": { "type": "string" } }, "required": [ "files", "query", "sessionId" ], "type": "object" }, "GitInfo": { "properties": { "branch": { "type": [ "string", "null" ] }, "originUrl": { "type": [ "string", "null" ] }, "sha": { "type": [ "string", "null" ] } }, "type": "object" }, "GuardianApprovalReview": { "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", "properties": { "rationale": { "type": [ "string", "null" ] }, "riskLevel": { "anyOf": [ { "$ref": "#/definitions/GuardianRiskLevel" }, { "type": "null" } ] }, "status": { "$ref": "#/definitions/GuardianApprovalReviewStatus" }, "userAuthorization": { "anyOf": [ { "$ref": "#/definitions/GuardianUserAuthorization" }, { "type": "null" } ] } }, "required": [ "status" ], "type": "object" }, "GuardianApprovalReviewAction": { "oneOf": [ { "properties": { "command": { "type": "string" }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "source": { "$ref": "#/definitions/GuardianCommandSource" }, "type": { "enum": [ "command" ], "title": "CommandGuardianApprovalReviewActionType", "type": "string" } }, "required": [ "command", "cwd", "source", "type" ], "title": "CommandGuardianApprovalReviewAction", "type": "object" }, { "properties": { "argv": { "items": { "type": "string" }, "type": "array" }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "program": { "type": "string" }, "source": { "$ref": "#/definitions/GuardianCommandSource" }, "type": { "enum": [ "execve" ], "title": "ExecveGuardianApprovalReviewActionType", "type": "string" } }, "required": [ "argv", "cwd", "program", "source", "type" ], "title": "ExecveGuardianApprovalReviewAction", "type": "object" }, { "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "files": { "items": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": "array" }, "type": { "enum": [ "applyPatch" ], "title": "ApplyPatchGuardianApprovalReviewActionType", "type": "string" } }, "required": [ "cwd", "files", "type" ], "title": "ApplyPatchGuardianApprovalReviewAction", "type": "object" }, { "properties": { "host": { "type": "string" }, "port": { "format": "uint16", "minimum": 0.0, "type": "integer" }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" }, "target": { "type": "string" }, "type": { "enum": [ "networkAccess" ], "title": "NetworkAccessGuardianApprovalReviewActionType", "type": "string" } }, "required": [ "host", "port", "protocol", "target", "type" ], "title": "NetworkAccessGuardianApprovalReviewAction", "type": "object" }, { "properties": { "connectorId": { "type": [ "string", "null" ] }, "connectorName": { "type": [ "string", "null" ] }, "server": { "type": "string" }, "toolName": { "type": "string" }, "toolTitle": { "type": [ "string", "null" ] }, "type": { "enum": [ "mcpToolCall" ], "title": "McpToolCallGuardianApprovalReviewActionType", "type": "string" } }, "required": [ "server", "toolName", "type" ], "title": "McpToolCallGuardianApprovalReviewAction", "type": "object" }, { "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" }, "reason": { "type": [ "string", "null" ] }, "type": { "enum": [ "requestPermissions" ], "title": "RequestPermissionsGuardianApprovalReviewActionType", "type": "string" } }, "required": [ "permissions", "type" ], "title": "RequestPermissionsGuardianApprovalReviewAction", "type": "object" } ] }, "GuardianApprovalReviewStatus": { "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", "enum": [ "inProgress", "approved", "denied", "timedOut", "aborted" ], "type": "string" }, "GuardianCommandSource": { "enum": [ "shell", "unifiedExec" ], "type": "string" }, "GuardianRiskLevel": { "description": "[UNSTABLE] Risk level assigned by approval auto-review.", "enum": [ "low", "medium", "high", "critical" ], "type": "string" }, "GuardianUserAuthorization": { "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", "enum": [ "unknown", "low", "medium", "high" ], "type": "string" }, "GuardianWarningNotification": { "properties": { "message": { "description": "Concise guardian warning message for the user.", "type": "string" }, "threadId": { "description": "Thread target for the guardian warning.", "type": "string" } }, "required": [ "message", "threadId" ], "type": "object" }, "HookCompletedNotification": { "properties": { "run": { "$ref": "#/definitions/HookRunSummary" }, "threadId": { "type": "string" }, "turnId": { "type": [ "string", "null" ] } }, "required": [ "run", "threadId" ], "type": "object" }, "HookEventName": { "enum": [ "preToolUse", "permissionRequest", "postToolUse", "preCompact", "postCompact", "sessionStart", "userPromptSubmit", "subagentStart", "subagentStop", "stop" ], "type": "string" }, "HookExecutionMode": { "enum": [ "sync", "async" ], "type": "string" }, "HookHandlerType": { "enum": [ "command", "prompt", "agent" ], "type": "string" }, "HookOutputEntry": { "properties": { "kind": { "$ref": "#/definitions/HookOutputEntryKind" }, "text": { "type": "string" } }, "required": [ "kind", "text" ], "type": "object" }, "HookOutputEntryKind": { "enum": [ "warning", "stop", "feedback", "context", "error" ], "type": "string" }, "HookPromptFragment": { "properties": { "hookRunId": { "type": "string" }, "text": { "type": "string" } }, "required": [ "hookRunId", "text" ], "type": "object" }, "HookRunStatus": { "enum": [ "running", "completed", "failed", "blocked", "stopped" ], "type": "string" }, "HookRunSummary": { "properties": { "completedAt": { "format": "int64", "type": [ "integer", "null" ] }, "displayOrder": { "format": "int64", "type": "integer" }, "durationMs": { "format": "int64", "type": [ "integer", "null" ] }, "entries": { "items": { "$ref": "#/definitions/HookOutputEntry" }, "type": "array" }, "eventName": { "$ref": "#/definitions/HookEventName" }, "executionMode": { "$ref": "#/definitions/HookExecutionMode" }, "handlerType": { "$ref": "#/definitions/HookHandlerType" }, "id": { "type": "string" }, "scope": { "$ref": "#/definitions/HookScope" }, "source": { "allOf": [ { "$ref": "#/definitions/HookSource" } ], "default": "unknown" }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { "format": "int64", "type": "integer" }, "status": { "$ref": "#/definitions/HookRunStatus" }, "statusMessage": { "type": [ "string", "null" ] } }, "required": [ "displayOrder", "entries", "eventName", "executionMode", "handlerType", "id", "scope", "sourcePath", "startedAt", "status" ], "type": "object" }, "HookScope": { "enum": [ "thread", "turn" ], "type": "string" }, "HookSource": { "enum": [ "system", "user", "project", "mdm", "sessionFlags", "plugin", "cloudRequirements", "cloudManagedConfig", "legacyManagedConfigFile", "legacyManagedConfigMdm", "unknown" ], "type": "string" }, "HookStartedNotification": { "properties": { "run": { "$ref": "#/definitions/HookRunSummary" }, "threadId": { "type": "string" }, "turnId": { "type": [ "string", "null" ] } }, "required": [ "run", "threadId" ], "type": "object" }, "ImageDetail": { "enum": [ "auto", "low", "high", "original" ], "type": "string" }, "ItemCompletedNotification": { "properties": { "completedAtMs": { "description": "Unix timestamp (in milliseconds) when this item lifecycle completed.", "format": "int64", "type": "integer" }, "item": { "$ref": "#/definitions/ThreadItem" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "completedAtMs", "item", "threadId", "turnId" ], "type": "object" }, "ItemGuardianApprovalReviewCompletedNotification": { "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", "properties": { "action": { "$ref": "#/definitions/GuardianApprovalReviewAction" }, "completedAtMs": { "description": "Unix timestamp (in milliseconds) when this review completed.", "format": "int64", "type": "integer" }, "decisionSource": { "$ref": "#/definitions/AutoReviewDecisionSource" }, "review": { "$ref": "#/definitions/GuardianApprovalReview" }, "reviewId": { "description": "Stable identifier for this review.", "type": "string" }, "startedAtMs": { "description": "Unix timestamp (in milliseconds) when this review started.", "format": "int64", "type": "integer" }, "targetItemId": { "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", "type": [ "string", "null" ] }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "action", "completedAtMs", "decisionSource", "review", "reviewId", "startedAtMs", "threadId", "turnId" ], "type": "object" }, "ItemGuardianApprovalReviewStartedNotification": { "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", "properties": { "action": { "$ref": "#/definitions/GuardianApprovalReviewAction" }, "review": { "$ref": "#/definitions/GuardianApprovalReview" }, "reviewId": { "description": "Stable identifier for this review.", "type": "string" }, "startedAtMs": { "description": "Unix timestamp (in milliseconds) when this review started.", "format": "int64", "type": "integer" }, "targetItemId": { "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", "type": [ "string", "null" ] }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "action", "review", "reviewId", "startedAtMs", "threadId", "turnId" ], "type": "object" }, "ItemStartedNotification": { "properties": { "item": { "$ref": "#/definitions/ThreadItem" }, "startedAtMs": { "description": "Unix timestamp (in milliseconds) when this item lifecycle started.", "format": "int64", "type": "integer" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "item", "startedAtMs", "threadId", "turnId" ], "type": "object" }, "LegacyAppPathString": { "type": "string" }, "McpServerOauthLoginCompletedNotification": { "properties": { "error": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "success": { "type": "boolean" } }, "required": [ "name", "success" ], "type": "object" }, "McpServerStartupState": { "enum": [ "starting", "ready", "failed", "cancelled" ], "type": "string" }, "McpServerStatusUpdatedNotification": { "properties": { "error": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "status": { "$ref": "#/definitions/McpServerStartupState" }, "threadId": { "type": [ "string", "null" ] } }, "required": [ "name", "status" ], "type": "object" }, "McpToolCallAppContext": { "properties": { "connectorId": { "type": "string" }, "linkId": { "type": [ "string", "null" ] }, "resourceUri": { "type": [ "string", "null" ] } }, "required": [ "connectorId" ], "type": "object" }, "McpToolCallError": { "properties": { "message": { "type": "string" } }, "required": [ "message" ], "type": "object" }, "McpToolCallProgressNotification": { "properties": { "itemId": { "type": "string" }, "message": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "itemId", "message", "threadId", "turnId" ], "type": "object" }, "McpToolCallResult": { "properties": { "_meta": true, "content": { "items": true, "type": "array" }, "structuredContent": true }, "required": [ "content" ], "type": "object" }, "McpToolCallStatus": { "enum": [ "inProgress", "completed", "failed" ], "type": "string" }, "MemoryCitation": { "properties": { "entries": { "items": { "$ref": "#/definitions/MemoryCitationEntry" }, "type": "array" }, "threadIds": { "items": { "type": "string" }, "type": "array" } }, "required": [ "entries", "threadIds" ], "type": "object" }, "MemoryCitationEntry": { "properties": { "lineEnd": { "format": "uint32", "minimum": 0.0, "type": "integer" }, "lineStart": { "format": "uint32", "minimum": 0.0, "type": "integer" }, "note": { "type": "string" }, "path": { "type": "string" } }, "required": [ "lineEnd", "lineStart", "note", "path" ], "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", "enum": [ "commentary" ], "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", "enum": [ "final_answer" ], "type": "string" } ] }, "ModeKind": { "description": "Initial collaboration mode to use when the TUI starts.", "enum": [ "plan", "default" ], "type": "string" }, "ModelRerouteReason": { "enum": [ "highRiskCyberActivity" ], "type": "string" }, "ModelReroutedNotification": { "properties": { "fromModel": { "type": "string" }, "reason": { "$ref": "#/definitions/ModelRerouteReason" }, "threadId": { "type": "string" }, "toModel": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "fromModel", "reason", "threadId", "toModel", "turnId" ], "type": "object" }, "ModelSafetyBufferingUpdatedNotification": { "properties": { "model": { "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "threadId": { "type": "string" }, "turnId": { "type": "string" }, "useCases": { "items": { "type": "string" }, "type": "array" } }, "required": [ "model", "reasons", "threadId", "turnId", "useCases" ], "type": "object" }, "ModelVerification": { "enum": [ "trustedAccessForCyber" ], "type": "string" }, "ModelVerificationNotification": { "properties": { "threadId": { "type": "string" }, "turnId": { "type": "string" }, "verifications": { "items": { "$ref": "#/definitions/ModelVerification" }, "type": "array" } }, "required": [ "threadId", "turnId", "verifications" ], "type": "object" }, "MultiAgentMode": { "description": "Controls whether the model should only spawn sub-agents after an explicit user request or may delegate proactively when doing so would help.", "enum": [ "explicitRequestOnly", "proactive" ], "type": "string" }, "NetworkAccess": { "enum": [ "restricted", "enabled" ], "type": "string" }, "NetworkApprovalProtocol": { "enum": [ "http", "https", "socks5Tcp", "socks5Udp" ], "type": "string" }, "NonSteerableTurnKind": { "enum": [ "review", "compact" ], "type": "string" }, "PatchApplyStatus": { "enum": [ "inProgress", "completed", "failed", "declined" ], "type": "string" }, "PatchChangeKind": { "oneOf": [ { "properties": { "type": { "enum": [ "add" ], "title": "AddPatchChangeKindType", "type": "string" } }, "required": [ "type" ], "title": "AddPatchChangeKind", "type": "object" }, { "properties": { "type": { "enum": [ "delete" ], "title": "DeletePatchChangeKindType", "type": "string" } }, "required": [ "type" ], "title": "DeletePatchChangeKind", "type": "object" }, { "properties": { "move_path": { "type": [ "string", "null" ] }, "type": { "enum": [ "update" ], "title": "UpdatePatchChangeKindType", "type": "string" } }, "required": [ "type" ], "title": "UpdatePatchChangeKind", "type": "object" } ] }, "Personality": { "enum": [ "none", "friendly", "pragmatic" ], "type": "string" }, "PlanDeltaNotification": { "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", "properties": { "delta": { "type": "string" }, "itemId": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "delta", "itemId", "threadId", "turnId" ], "type": "object" }, "PlanType": { "enum": [ "free", "go", "plus", "pro", "prolite", "team", "self_serve_business_usage_based", "business", "enterprise_cbp_usage_based", "enterprise", "edu", "unknown" ], "type": "string" }, "ProcessExitedNotification": { "description": "Final process exit notification for `process/spawn`.", "properties": { "exitCode": { "description": "Process exit code.", "format": "int32", "type": "integer" }, "processHandle": { "description": "Client-supplied, connection-scoped `processHandle` from `process/spawn`.", "type": "string" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `process/outputDelta`.", "type": "string" }, "stderrCapReached": { "description": "Whether stderr reached `outputBytesCap`.\n\nIn streaming mode, stderr is empty and cap state is also reported on the final stderr `process/outputDelta` notification.", "type": "boolean" }, "stdout": { "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `process/outputDelta`.", "type": "string" }, "stdoutCapReached": { "description": "Whether stdout reached `outputBytesCap`.\n\nIn streaming mode, stdout is empty and cap state is also reported on the final stdout `process/outputDelta` notification.", "type": "boolean" } }, "required": [ "exitCode", "processHandle", "stderr", "stderrCapReached", "stdout", "stdoutCapReached" ], "type": "object" }, "ProcessOutputDeltaNotification": { "description": "Base64-encoded output chunk emitted for a streaming `process/spawn` request.", "properties": { "capReached": { "description": "True on the final streamed chunk for this stream when output was truncated by `outputBytesCap`.", "type": "boolean" }, "deltaBase64": { "description": "Base64-encoded output bytes.", "type": "string" }, "processHandle": { "description": "Client-supplied, connection-scoped `processHandle` from `process/spawn`.", "type": "string" }, "stream": { "allOf": [ { "$ref": "#/definitions/ProcessOutputStream" } ], "description": "Output stream this chunk belongs to." } }, "required": [ "capReached", "deltaBase64", "processHandle", "stream" ], "type": "object" }, "ProcessOutputStream": { "description": "Stream label for `process/outputDelta` notifications.", "oneOf": [ { "description": "stdout stream. PTY mode multiplexes terminal output here.", "enum": [ "stdout" ], "type": "string" }, { "description": "stderr stream.", "enum": [ "stderr" ], "type": "string" } ] }, "RateLimitReachedType": { "enum": [ "rate_limit_reached", "workspace_owner_credits_depleted", "workspace_member_credits_depleted", "workspace_owner_usage_limit_reached", "workspace_member_usage_limit_reached" ], "type": "string" }, "RateLimitSnapshot": { "properties": { "credits": { "anyOf": [ { "$ref": "#/definitions/CreditsSnapshot" }, { "type": "null" } ] }, "individualLimit": { "anyOf": [ { "$ref": "#/definitions/SpendControlLimitSnapshot" }, { "type": "null" } ] }, "limitId": { "type": [ "string", "null" ] }, "limitName": { "type": [ "string", "null" ] }, "planType": { "anyOf": [ { "$ref": "#/definitions/PlanType" }, { "type": "null" } ] }, "primary": { "anyOf": [ { "$ref": "#/definitions/RateLimitWindow" }, { "type": "null" } ] }, "rateLimitReachedType": { "anyOf": [ { "$ref": "#/definitions/RateLimitReachedType" }, { "type": "null" } ] }, "secondary": { "anyOf": [ { "$ref": "#/definitions/RateLimitWindow" }, { "type": "null" } ] } }, "type": "object" }, "RateLimitWindow": { "properties": { "resetsAt": { "format": "int64", "type": [ "integer", "null" ] }, "usedPercent": { "format": "int32", "type": "integer" }, "windowDurationMins": { "format": "int64", "type": [ "integer", "null" ] } }, "required": [ "usedPercent" ], "type": "object" }, "RealtimeConversationVersion": { "enum": [ "v1", "v2" ], "type": "string" }, "ReasoningEffort": { "description": "A non-empty reasoning effort value advertised by the model.", "minLength": 1, "type": "string" }, "ReasoningSummary": { "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", "oneOf": [ { "enum": [ "auto", "concise", "detailed" ], "type": "string" }, { "description": "Option to disable reasoning summaries.", "enum": [ "none" ], "type": "string" } ] }, "ReasoningSummaryPartAddedNotification": { "properties": { "itemId": { "type": "string" }, "summaryIndex": { "format": "int64", "type": "integer" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "itemId", "summaryIndex", "threadId", "turnId" ], "type": "object" }, "ReasoningSummaryTextDeltaNotification": { "properties": { "delta": { "type": "string" }, "itemId": { "type": "string" }, "summaryIndex": { "format": "int64", "type": "integer" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "delta", "itemId", "summaryIndex", "threadId", "turnId" ], "type": "object" }, "ReasoningTextDeltaNotification": { "properties": { "contentIndex": { "format": "int64", "type": "integer" }, "delta": { "type": "string" }, "itemId": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "contentIndex", "delta", "itemId", "threadId", "turnId" ], "type": "object" }, "RemoteControlConnectionStatus": { "enum": [ "disabled", "connecting", "connected", "errored" ], "type": "string" }, "RemoteControlStatusChangedNotification": { "description": "Current remote-control connection status and remote identity exposed to clients.", "properties": { "environmentId": { "type": [ "string", "null" ] }, "installationId": { "type": "string" }, "serverName": { "type": "string" }, "status": { "$ref": "#/definitions/RemoteControlConnectionStatus" } }, "required": [ "installationId", "serverName", "status" ], "type": "object" }, "RequestId": { "anyOf": [ { "type": "string" }, { "format": "int64", "type": "integer" } ] }, "RequestPermissionProfile": { "additionalProperties": false, "properties": { "fileSystem": { "anyOf": [ { "$ref": "#/definitions/AdditionalFileSystemPermissions" }, { "type": "null" } ] }, "network": { "anyOf": [ { "$ref": "#/definitions/AdditionalNetworkPermissions" }, { "type": "null" } ] } }, "type": "object" }, "SandboxPolicy": { "oneOf": [ { "properties": { "type": { "enum": [ "dangerFullAccess" ], "title": "DangerFullAccessSandboxPolicyType", "type": "string" } }, "required": [ "type" ], "title": "DangerFullAccessSandboxPolicy", "type": "object" }, { "properties": { "networkAccess": { "default": false, "type": "boolean" }, "type": { "enum": [ "readOnly" ], "title": "ReadOnlySandboxPolicyType", "type": "string" } }, "required": [ "type" ], "title": "ReadOnlySandboxPolicy", "type": "object" }, { "properties": { "networkAccess": { "allOf": [ { "$ref": "#/definitions/NetworkAccess" } ], "default": "restricted" }, "type": { "enum": [ "externalSandbox" ], "title": "ExternalSandboxSandboxPolicyType", "type": "string" } }, "required": [ "type" ], "title": "ExternalSandboxSandboxPolicy", "type": "object" }, { "properties": { "excludeSlashTmp": { "default": false, "type": "boolean" }, "excludeTmpdirEnvVar": { "default": false, "type": "boolean" }, "networkAccess": { "default": false, "type": "boolean" }, "type": { "enum": [ "workspaceWrite" ], "title": "WorkspaceWriteSandboxPolicyType", "type": "string" }, "writableRoots": { "default": [], "items": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": "array" } }, "required": [ "type" ], "title": "WorkspaceWriteSandboxPolicy", "type": "object" } ] }, "ServerRequestResolvedNotification": { "properties": { "requestId": { "$ref": "#/definitions/RequestId" }, "threadId": { "type": "string" } }, "required": [ "requestId", "threadId" ], "type": "object" }, "SessionSource": { "oneOf": [ { "enum": [ "cli", "vscode", "exec", "appServer", "unknown" ], "type": "string" }, { "additionalProperties": false, "properties": { "custom": { "type": "string" } }, "required": [ "custom" ], "title": "CustomSessionSource", "type": "object" }, { "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, "required": [ "subAgent" ], "title": "SubAgentSessionSource", "type": "object" } ] }, "Settings": { "description": "Settings for a collaboration mode.", "properties": { "developer_instructions": { "type": [ "string", "null" ] }, "model": { "type": "string" }, "reasoning_effort": { "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" }, { "type": "null" } ] } }, "required": [ "model" ], "type": "object" }, "SkillsChangedNotification": { "description": "Notification emitted when watched local skill files change.\n\nTreat this as an invalidation signal and re-run `skills/list` with the client's current parameters when refreshed skill metadata is needed.", "type": "object" }, "SpendControlLimitSnapshot": { "properties": { "limit": { "type": "string" }, "remainingPercent": { "format": "int32", "type": "integer" }, "resetsAt": { "format": "int64", "type": "integer" }, "used": { "type": "string" } }, "required": [ "limit", "remainingPercent", "resetsAt", "used" ], "type": "object" }, "SubAgentActivityKind": { "enum": [ "started", "interacted", "interrupted" ], "type": "string" }, "SubAgentSource": { "oneOf": [ { "enum": [ "review", "compact", "memory_consolidation" ], "type": "string" }, { "additionalProperties": false, "properties": { "thread_spawn": { "properties": { "agent_nickname": { "default": null, "type": [ "string", "null" ] }, "agent_path": { "anyOf": [ { "$ref": "#/definitions/AgentPath" }, { "type": "null" } ], "default": null }, "agent_role": { "default": null, "type": [ "string", "null" ] }, "depth": { "format": "int32", "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } }, "required": [ "depth", "parent_thread_id" ], "type": "object" } }, "required": [ "thread_spawn" ], "title": "ThreadSpawnSubAgentSource", "type": "object" }, { "additionalProperties": false, "properties": { "other": { "type": "string" } }, "required": [ "other" ], "title": "OtherSubAgentSource", "type": "object" } ] }, "TerminalInteractionNotification": { "properties": { "itemId": { "type": "string" }, "processId": { "type": "string" }, "stdin": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "itemId", "processId", "stdin", "threadId", "turnId" ], "type": "object" }, "TextElement": { "properties": { "byteRange": { "allOf": [ { "$ref": "#/definitions/ByteRange" } ], "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", "type": [ "string", "null" ] } }, "required": [ "byteRange" ], "type": "object" }, "TextPosition": { "properties": { "column": { "description": "1-based column number (in Unicode scalar values).", "format": "uint", "minimum": 0.0, "type": "integer" }, "line": { "description": "1-based line number.", "format": "uint", "minimum": 0.0, "type": "integer" } }, "required": [ "column", "line" ], "type": "object" }, "TextRange": { "properties": { "end": { "$ref": "#/definitions/TextPosition" }, "start": { "$ref": "#/definitions/TextPosition" } }, "required": [ "end", "start" ], "type": "object" }, "Thread": { "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", "type": [ "string", "null" ] }, "agentRole": { "description": "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.", "type": [ "string", "null" ] }, "cliVersion": { "description": "Version of the CLI that created the thread.", "type": "string" }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", "format": "int64", "type": "integer" }, "cwd": { "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } ], "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", "type": [ "string", "null" ] }, "gitInfo": { "anyOf": [ { "$ref": "#/definitions/GitInfo" }, { "type": "null" } ], "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" }, "modelProvider": { "description": "Model provider used for this thread (for example, 'openai').", "type": "string" }, "name": { "description": "Optional user-facing thread title.", "type": [ "string", "null" ] }, "parentThreadId": { "description": "The ID of the parent thread. This will only be set if this thread is a subagent.", "type": [ "string", "null" ] }, "path": { "description": "[UNSTABLE] Path to the thread on disk.", "type": [ "string", "null" ] }, "preview": { "description": "Usually the first user message in the thread, if available.", "type": "string" }, "recencyAt": { "description": "Unix timestamp (in seconds) used for thread recency ordering.", "format": "int64", "type": [ "integer", "null" ] }, "sessionId": { "description": "Session id shared by threads that belong to the same session tree.", "type": "string" }, "source": { "allOf": [ { "$ref": "#/definitions/SessionSource" } ], "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { "allOf": [ { "$ref": "#/definitions/ThreadStatus" } ], "description": "Current runtime status for the thread." }, "threadSource": { "anyOf": [ { "$ref": "#/definitions/ThreadSource" }, { "type": "null" } ], "description": "Optional analytics source classification for this thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", "items": { "$ref": "#/definitions/Turn" }, "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", "format": "int64", "type": "integer" } }, "required": [ "cliVersion", "createdAt", "cwd", "ephemeral", "id", "modelProvider", "preview", "sessionId", "source", "status", "turns", "updatedAt" ], "type": "object" }, "ThreadActiveFlag": { "enum": [ "waitingOnApproval", "waitingOnUserInput" ], "type": "string" }, "ThreadArchivedNotification": { "properties": { "threadId": { "type": "string" } }, "required": [ "threadId" ], "type": "object" }, "ThreadClosedNotification": { "properties": { "threadId": { "type": "string" } }, "required": [ "threadId" ], "type": "object" }, "ThreadDeletedNotification": { "properties": { "threadId": { "type": "string" } }, "required": [ "threadId" ], "type": "object" }, "ThreadGoal": { "properties": { "createdAt": { "format": "int64", "type": "integer" }, "objective": { "type": "string" }, "status": { "$ref": "#/definitions/ThreadGoalStatus" }, "threadId": { "type": "string" }, "timeUsedSeconds": { "format": "int64", "type": "integer" }, "tokenBudget": { "format": "int64", "type": [ "integer", "null" ] }, "tokensUsed": { "format": "int64", "type": "integer" }, "updatedAt": { "format": "int64", "type": "integer" } }, "required": [ "createdAt", "objective", "status", "threadId", "timeUsedSeconds", "tokensUsed", "updatedAt" ], "type": "object" }, "ThreadGoalClearedNotification": { "properties": { "threadId": { "type": "string" } }, "required": [ "threadId" ], "type": "object" }, "ThreadGoalStatus": { "enum": [ "active", "paused", "blocked", "usageLimited", "budgetLimited", "complete" ], "type": "string" }, "ThreadGoalUpdatedNotification": { "properties": { "goal": { "$ref": "#/definitions/ThreadGoal" }, "threadId": { "type": "string" }, "turnId": { "type": [ "string", "null" ] } }, "required": [ "goal", "threadId" ], "type": "object" }, "ThreadId": { "type": "string" }, "ThreadItem": { "oneOf": [ { "properties": { "clientId": { "type": [ "string", "null" ] }, "content": { "items": { "$ref": "#/definitions/UserInput" }, "type": "array" }, "id": { "type": "string" }, "type": { "enum": [ "userMessage" ], "title": "UserMessageThreadItemType", "type": "string" } }, "required": [ "content", "id", "type" ], "title": "UserMessageThreadItem", "type": "object" }, { "properties": { "fragments": { "items": { "$ref": "#/definitions/HookPromptFragment" }, "type": "array" }, "id": { "type": "string" }, "type": { "enum": [ "hookPrompt" ], "title": "HookPromptThreadItemType", "type": "string" } }, "required": [ "fragments", "id", "type" ], "title": "HookPromptThreadItem", "type": "object" }, { "properties": { "id": { "type": "string" }, "memoryCitation": { "anyOf": [ { "$ref": "#/definitions/MemoryCitation" }, { "type": "null" } ], "default": null }, "phase": { "anyOf": [ { "$ref": "#/definitions/MessagePhase" }, { "type": "null" } ], "default": null }, "text": { "type": "string" }, "type": { "enum": [ "agentMessage" ], "title": "AgentMessageThreadItemType", "type": "string" } }, "required": [ "id", "text", "type" ], "title": "AgentMessageThreadItem", "type": "object" }, { "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "type": { "enum": [ "plan" ], "title": "PlanThreadItemType", "type": "string" } }, "required": [ "id", "text", "type" ], "title": "PlanThreadItem", "type": "object" }, { "properties": { "content": { "default": [], "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], "items": { "type": "string" }, "type": "array" }, "type": { "enum": [ "reasoning" ], "title": "ReasoningThreadItemType", "type": "string" } }, "required": [ "id", "type" ], "title": "ReasoningThreadItem", "type": "object" }, { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", "type": [ "string", "null" ] }, "command": { "description": "The command to be executed.", "type": "string" }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", "items": { "$ref": "#/definitions/CommandAction" }, "type": "array" }, "cwd": { "allOf": [ { "$ref": "#/definitions/LegacyAppPathString" } ], "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", "format": "int64", "type": [ "integer", "null" ] }, "exitCode": { "description": "The command's exit code.", "format": "int32", "type": [ "integer", "null" ] }, "id": { "type": "string" }, "processId": { "description": "Identifier for the underlying PTY process (when available).", "type": [ "string", "null" ] }, "source": { "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } ], "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { "enum": [ "commandExecution" ], "title": "CommandExecutionThreadItemType", "type": "string" } }, "required": [ "command", "commandActions", "cwd", "id", "status", "type" ], "title": "CommandExecutionThreadItem", "type": "object" }, { "properties": { "changes": { "items": { "$ref": "#/definitions/FileUpdateChange" }, "type": "array" }, "id": { "type": "string" }, "status": { "$ref": "#/definitions/PatchApplyStatus" }, "type": { "enum": [ "fileChange" ], "title": "FileChangeThreadItemType", "type": "string" } }, "required": [ "changes", "id", "status", "type" ], "title": "FileChangeThreadItem", "type": "object" }, { "properties": { "appContext": { "anyOf": [ { "$ref": "#/definitions/McpToolCallAppContext" }, { "type": "null" } ] }, "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", "format": "int64", "type": [ "integer", "null" ] }, "error": { "anyOf": [ { "$ref": "#/definitions/McpToolCallError" }, { "type": "null" } ] }, "id": { "type": "string" }, "mcpAppResourceUri": { "description": "Deprecated: use `appContext.resourceUri` instead.", "type": [ "string", "null" ] }, "pluginId": { "type": [ "string", "null" ] }, "result": { "anyOf": [ { "$ref": "#/definitions/McpToolCallResult" }, { "type": "null" } ] }, "server": { "type": "string" }, "status": { "$ref": "#/definitions/McpToolCallStatus" }, "tool": { "type": "string" }, "type": { "enum": [ "mcpToolCall" ], "title": "McpToolCallThreadItemType", "type": "string" } }, "required": [ "arguments", "id", "server", "status", "tool", "type" ], "title": "McpToolCallThreadItem", "type": "object" }, { "properties": { "arguments": true, "contentItems": { "items": { "$ref": "#/definitions/DynamicToolCallOutputContentItem" }, "type": [ "array", "null" ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", "format": "int64", "type": [ "integer", "null" ] }, "id": { "type": "string" }, "namespace": { "type": [ "string", "null" ] }, "status": { "$ref": "#/definitions/DynamicToolCallStatus" }, "success": { "type": [ "boolean", "null" ] }, "tool": { "type": "string" }, "type": { "enum": [ "dynamicToolCall" ], "title": "DynamicToolCallThreadItemType", "type": "string" } }, "required": [ "arguments", "id", "status", "tool", "type" ], "title": "DynamicToolCallThreadItem", "type": "object" }, { "properties": { "agentsStates": { "additionalProperties": { "$ref": "#/definitions/CollabAgentState" }, "description": "Last known status of the target agents, when available.", "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", "type": "string" }, "model": { "description": "Model requested for the spawned agent, when applicable.", "type": [ "string", "null" ] }, "prompt": { "description": "Prompt text sent as part of the collab tool call, when available.", "type": [ "string", "null" ] }, "reasoningEffort": { "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" }, { "type": "null" } ], "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", "items": { "type": "string" }, "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } ], "description": "Current status of the collab tool call." }, "tool": { "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } ], "description": "Name of the collab tool that was invoked." }, "type": { "enum": [ "collabAgentToolCall" ], "title": "CollabAgentToolCallThreadItemType", "type": "string" } }, "required": [ "agentsStates", "id", "receiverThreadIds", "senderThreadId", "status", "tool", "type" ], "title": "CollabAgentToolCallThreadItem", "type": "object" }, { "properties": { "agentPath": { "type": "string" }, "agentThreadId": { "type": "string" }, "id": { "type": "string" }, "kind": { "$ref": "#/definitions/SubAgentActivityKind" }, "type": { "enum": [ "subAgentActivity" ], "title": "SubAgentActivityThreadItemType", "type": "string" } }, "required": [ "agentPath", "agentThreadId", "id", "kind", "type" ], "title": "SubAgentActivityThreadItem", "type": "object" }, { "properties": { "action": { "anyOf": [ { "$ref": "#/definitions/WebSearchAction" }, { "type": "null" } ] }, "id": { "type": "string" }, "query": { "type": "string" }, "type": { "enum": [ "webSearch" ], "title": "WebSearchThreadItemType", "type": "string" } }, "required": [ "id", "query", "type" ], "title": "WebSearchThreadItem", "type": "object" }, { "properties": { "id": { "type": "string" }, "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { "enum": [ "imageView" ], "title": "ImageViewThreadItemType", "type": "string" } }, "required": [ "id", "path", "type" ], "title": "ImageViewThreadItem", "type": "object" }, { "properties": { "durationMs": { "format": "uint64", "minimum": 0.0, "type": "integer" }, "id": { "type": "string" }, "type": { "enum": [ "sleep" ], "title": "SleepThreadItemType", "type": "string" } }, "required": [ "durationMs", "id", "type" ], "title": "SleepThreadItem", "type": "object" }, { "properties": { "id": { "type": "string" }, "result": { "type": "string" }, "revisedPrompt": { "type": [ "string", "null" ] }, "savedPath": { "anyOf": [ { "$ref": "#/definitions/AbsolutePathBuf" }, { "type": "null" } ] }, "status": { "type": "string" }, "type": { "enum": [ "imageGeneration" ], "title": "ImageGenerationThreadItemType", "type": "string" } }, "required": [ "id", "result", "status", "type" ], "title": "ImageGenerationThreadItem", "type": "object" }, { "properties": { "id": { "type": "string" }, "review": { "type": "string" }, "type": { "enum": [ "enteredReviewMode" ], "title": "EnteredReviewModeThreadItemType", "type": "string" } }, "required": [ "id", "review", "type" ], "title": "EnteredReviewModeThreadItem", "type": "object" }, { "properties": { "id": { "type": "string" }, "review": { "type": "string" }, "type": { "enum": [ "exitedReviewMode" ], "title": "ExitedReviewModeThreadItemType", "type": "string" } }, "required": [ "id", "review", "type" ], "title": "ExitedReviewModeThreadItem", "type": "object" }, { "properties": { "id": { "type": "string" }, "type": { "enum": [ "contextCompaction" ], "title": "ContextCompactionThreadItemType", "type": "string" } }, "required": [ "id", "type" ], "title": "ContextCompactionThreadItem", "type": "object" } ] }, "ThreadNameUpdatedNotification": { "properties": { "threadId": { "type": "string" }, "threadName": { "type": [ "string", "null" ] } }, "required": [ "threadId" ], "type": "object" }, "ThreadRealtimeAudioChunk": { "description": "EXPERIMENTAL - thread realtime audio chunk.", "properties": { "data": { "type": "string" }, "itemId": { "type": [ "string", "null" ] }, "numChannels": { "format": "uint16", "minimum": 0.0, "type": "integer" }, "sampleRate": { "format": "uint32", "minimum": 0.0, "type": "integer" }, "samplesPerChannel": { "format": "uint32", "minimum": 0.0, "type": [ "integer", "null" ] } }, "required": [ "data", "numChannels", "sampleRate" ], "type": "object" }, "ThreadRealtimeClosedNotification": { "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", "properties": { "reason": { "type": [ "string", "null" ] }, "threadId": { "type": "string" } }, "required": [ "threadId" ], "type": "object" }, "ThreadRealtimeErrorNotification": { "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", "properties": { "message": { "type": "string" }, "threadId": { "type": "string" } }, "required": [ "message", "threadId" ], "type": "object" }, "ThreadRealtimeItemAddedNotification": { "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", "properties": { "item": true, "threadId": { "type": "string" } }, "required": [ "item", "threadId" ], "type": "object" }, "ThreadRealtimeOutputAudioDeltaNotification": { "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", "properties": { "audio": { "$ref": "#/definitions/ThreadRealtimeAudioChunk" }, "threadId": { "type": "string" } }, "required": [ "audio", "threadId" ], "type": "object" }, "ThreadRealtimeSdpNotification": { "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", "properties": { "sdp": { "type": "string" }, "threadId": { "type": "string" } }, "required": [ "sdp", "threadId" ], "type": "object" }, "ThreadRealtimeStartedNotification": { "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", "properties": { "realtimeSessionId": { "type": [ "string", "null" ] }, "threadId": { "type": "string" }, "version": { "$ref": "#/definitions/RealtimeConversationVersion" } }, "required": [ "threadId", "version" ], "type": "object" }, "ThreadRealtimeTranscriptDeltaNotification": { "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", "properties": { "delta": { "description": "Live transcript delta from the realtime event.", "type": "string" }, "role": { "type": "string" }, "threadId": { "type": "string" } }, "required": [ "delta", "role", "threadId" ], "type": "object" }, "ThreadRealtimeTranscriptDoneNotification": { "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", "properties": { "role": { "type": "string" }, "text": { "description": "Final complete text for the transcript part.", "type": "string" }, "threadId": { "type": "string" } }, "required": [ "role", "text", "threadId" ], "type": "object" }, "ThreadSettings": { "properties": { "activePermissionProfile": { "anyOf": [ { "$ref": "#/definitions/ActivePermissionProfile" }, { "type": "null" } ] }, "approvalPolicy": { "$ref": "#/definitions/AskForApproval" }, "approvalsReviewer": { "$ref": "#/definitions/ApprovalsReviewer" }, "collaborationMode": { "$ref": "#/definitions/CollaborationMode" }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "effort": { "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" }, { "type": "null" } ] }, "model": { "type": "string" }, "modelProvider": { "type": "string" }, "personality": { "anyOf": [ { "$ref": "#/definitions/Personality" }, { "type": "null" } ] }, "sandboxPolicy": { "$ref": "#/definitions/SandboxPolicy" }, "serviceTier": { "type": [ "string", "null" ] }, "summary": { "anyOf": [ { "$ref": "#/definitions/ReasoningSummary" }, { "type": "null" } ] } }, "required": [ "approvalPolicy", "approvalsReviewer", "collaborationMode", "cwd", "model", "modelProvider", "sandboxPolicy" ], "type": "object" }, "ThreadSettingsUpdatedNotification": { "properties": { "threadId": { "type": "string" }, "threadSettings": { "$ref": "#/definitions/ThreadSettings" } }, "required": [ "threadId", "threadSettings" ], "type": "object" }, "ThreadSource": { "type": "string" }, "ThreadStartedNotification": { "properties": { "thread": { "$ref": "#/definitions/Thread" } }, "required": [ "thread" ], "type": "object" }, "ThreadStatus": { "oneOf": [ { "properties": { "type": { "enum": [ "notLoaded" ], "title": "NotLoadedThreadStatusType", "type": "string" } }, "required": [ "type" ], "title": "NotLoadedThreadStatus", "type": "object" }, { "properties": { "type": { "enum": [ "idle" ], "title": "IdleThreadStatusType", "type": "string" } }, "required": [ "type" ], "title": "IdleThreadStatus", "type": "object" }, { "properties": { "type": { "enum": [ "systemError" ], "title": "SystemErrorThreadStatusType", "type": "string" } }, "required": [ "type" ], "title": "SystemErrorThreadStatus", "type": "object" }, { "properties": { "activeFlags": { "items": { "$ref": "#/definitions/ThreadActiveFlag" }, "type": "array" }, "type": { "enum": [ "active" ], "title": "ActiveThreadStatusType", "type": "string" } }, "required": [ "activeFlags", "type" ], "title": "ActiveThreadStatus", "type": "object" } ] }, "ThreadStatusChangedNotification": { "properties": { "status": { "$ref": "#/definitions/ThreadStatus" }, "threadId": { "type": "string" } }, "required": [ "status", "threadId" ], "type": "object" }, "ThreadTokenUsage": { "properties": { "last": { "$ref": "#/definitions/TokenUsageBreakdown" }, "modelContextWindow": { "format": "int64", "type": [ "integer", "null" ] }, "total": { "$ref": "#/definitions/TokenUsageBreakdown" } }, "required": [ "last", "total" ], "type": "object" }, "ThreadTokenUsageUpdatedNotification": { "properties": { "threadId": { "type": "string" }, "tokenUsage": { "$ref": "#/definitions/ThreadTokenUsage" }, "turnId": { "type": "string" } }, "required": [ "threadId", "tokenUsage", "turnId" ], "type": "object" }, "ThreadUnarchivedNotification": { "properties": { "threadId": { "type": "string" } }, "required": [ "threadId" ], "type": "object" }, "TokenUsageBreakdown": { "properties": { "cachedInputTokens": { "format": "int64", "type": "integer" }, "inputTokens": { "format": "int64", "type": "integer" }, "outputTokens": { "format": "int64", "type": "integer" }, "reasoningOutputTokens": { "format": "int64", "type": "integer" }, "totalTokens": { "format": "int64", "type": "integer" } }, "required": [ "cachedInputTokens", "inputTokens", "outputTokens", "reasoningOutputTokens", "totalTokens" ], "type": "object" }, "Turn": { "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", "format": "int64", "type": [ "integer", "null" ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", "format": "int64", "type": [ "integer", "null" ] }, "error": { "anyOf": [ { "$ref": "#/definitions/TurnError" }, { "type": "null" } ], "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Thread items currently included in this turn payload.", "items": { "$ref": "#/definitions/ThreadItem" }, "type": "array" }, "itemsView": { "allOf": [ { "$ref": "#/definitions/TurnItemsView" } ], "default": "full", "description": "Describes how much of `items` has been loaded for this turn." }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", "format": "int64", "type": [ "integer", "null" ] }, "status": { "$ref": "#/definitions/TurnStatus" } }, "required": [ "id", "items", "status" ], "type": "object" }, "TurnCompletedNotification": { "properties": { "threadId": { "type": "string" }, "turn": { "$ref": "#/definitions/Turn" } }, "required": [ "threadId", "turn" ], "type": "object" }, "TurnDiffUpdatedNotification": { "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", "properties": { "diff": { "type": "string" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "diff", "threadId", "turnId" ], "type": "object" }, "TurnError": { "properties": { "additionalDetails": { "default": null, "type": [ "string", "null" ] }, "codexErrorInfo": { "anyOf": [ { "$ref": "#/definitions/CodexErrorInfo" }, { "type": "null" } ] }, "message": { "type": "string" } }, "required": [ "message" ], "type": "object" }, "TurnItemsView": { "oneOf": [ { "description": "`items` was not loaded for this turn. The field is intentionally empty.", "enum": [ "notLoaded" ], "type": "string" }, { "description": "`items` contains only a display summary for this turn.", "enum": [ "summary" ], "type": "string" }, { "description": "`items` contains every ThreadItem available from persisted app-server history for this turn.", "enum": [ "full" ], "type": "string" } ] }, "TurnModerationMetadataNotification": { "properties": { "metadata": true, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "metadata", "threadId", "turnId" ], "type": "object" }, "TurnPlanStep": { "properties": { "status": { "$ref": "#/definitions/TurnPlanStepStatus" }, "step": { "type": "string" } }, "required": [ "status", "step" ], "type": "object" }, "TurnPlanStepStatus": { "enum": [ "pending", "inProgress", "completed" ], "type": "string" }, "TurnPlanUpdatedNotification": { "properties": { "explanation": { "type": [ "string", "null" ] }, "plan": { "items": { "$ref": "#/definitions/TurnPlanStep" }, "type": "array" }, "threadId": { "type": "string" }, "turnId": { "type": "string" } }, "required": [ "plan", "threadId", "turnId" ], "type": "object" }, "TurnStartedNotification": { "properties": { "threadId": { "type": "string" }, "turn": { "$ref": "#/definitions/Turn" } }, "required": [ "threadId", "turn" ], "type": "object" }, "TurnStatus": { "enum": [ "completed", "interrupted", "failed", "inProgress" ], "type": "string" }, "UserInput": { "oneOf": [ { "properties": { "text": { "type": "string" }, "text_elements": { "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" }, "type": "array" }, "type": { "enum": [ "text" ], "title": "TextUserInputType", "type": "string" } }, "required": [ "text", "type" ], "title": "TextUserInput", "type": "object" }, { "properties": { "detail": { "anyOf": [ { "$ref": "#/definitions/ImageDetail" }, { "type": "null" } ], "default": null }, "type": { "enum": [ "image" ], "title": "ImageUserInputType", "type": "string" }, "url": { "type": "string" } }, "required": [ "type", "url" ], "title": "ImageUserInput", "type": "object" }, { "properties": { "detail": { "anyOf": [ { "$ref": "#/definitions/ImageDetail" }, { "type": "null" } ], "default": null }, "path": { "type": "string" }, "type": { "enum": [ "localImage" ], "title": "LocalImageUserInputType", "type": "string" } }, "required": [ "path", "type" ], "title": "LocalImageUserInput", "type": "object" }, { "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "type": { "enum": [ "skill" ], "title": "SkillUserInputType", "type": "string" } }, "required": [ "name", "path", "type" ], "title": "SkillUserInput", "type": "object" }, { "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "type": { "enum": [ "mention" ], "title": "MentionUserInputType", "type": "string" } }, "required": [ "name", "path", "type" ], "title": "MentionUserInput", "type": "object" } ] }, "WarningNotification": { "properties": { "message": { "description": "Concise warning message for the user.", "type": "string" }, "threadId": { "description": "Optional thread target when the warning applies to a specific thread.", "type": [ "string", "null" ] } }, "required": [ "message" ], "type": "object" }, "WebSearchAction": { "oneOf": [ { "properties": { "queries": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "query": { "type": [ "string", "null" ] }, "type": { "enum": [ "search" ], "title": "SearchWebSearchActionType", "type": "string" } }, "required": [ "type" ], "title": "SearchWebSearchAction", "type": "object" }, { "properties": { "type": { "enum": [ "openPage" ], "title": "OpenPageWebSearchActionType", "type": "string" }, "url": { "type": [ "string", "null" ] } }, "required": [ "type" ], "title": "OpenPageWebSearchAction", "type": "object" }, { "properties": { "pattern": { "type": [ "string", "null" ] }, "type": { "enum": [ "findInPage" ], "title": "FindInPageWebSearchActionType", "type": "string" }, "url": { "type": [ "string", "null" ] } }, "required": [ "type" ], "title": "FindInPageWebSearchAction", "type": "object" }, { "properties": { "type": { "enum": [ "other" ], "title": "OtherWebSearchActionType", "type": "string" } }, "required": [ "type" ], "title": "OtherWebSearchAction", "type": "object" } ] }, "WindowsSandboxSetupCompletedNotification": { "properties": { "error": { "type": [ "string", "null" ] }, "mode": { "$ref": "#/definitions/WindowsSandboxSetupMode" }, "success": { "type": "boolean" } }, "required": [ "mode", "success" ], "type": "object" }, "WindowsSandboxSetupMode": { "enum": [ "elevated", "unelevated" ], "type": "string" }, "WindowsWorldWritableWarningNotification": { "properties": { "extraCount": { "format": "uint", "minimum": 0.0, "type": "integer" }, "failedScan": { "type": "boolean" }, "samplePaths": { "items": { "type": "string" }, "type": "array" } }, "required": [ "extraCount", "failedScan", "samplePaths" ], "type": "object" } }, "description": "Notification sent from the server to the client.", "oneOf": [ { "description": "NEW NOTIFICATIONS", "properties": { "method": { "enum": [ "error" ], "title": "ErrorNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ErrorNotification" } }, "required": [ "method", "params" ], "title": "ErrorNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/started" ], "title": "Thread/startedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadStartedNotification" } }, "required": [ "method", "params" ], "title": "Thread/startedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/status/changed" ], "title": "Thread/status/changedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadStatusChangedNotification" } }, "required": [ "method", "params" ], "title": "Thread/status/changedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/archived" ], "title": "Thread/archivedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadArchivedNotification" } }, "required": [ "method", "params" ], "title": "Thread/archivedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/deleted" ], "title": "Thread/deletedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadDeletedNotification" } }, "required": [ "method", "params" ], "title": "Thread/deletedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/unarchived" ], "title": "Thread/unarchivedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadUnarchivedNotification" } }, "required": [ "method", "params" ], "title": "Thread/unarchivedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/closed" ], "title": "Thread/closedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadClosedNotification" } }, "required": [ "method", "params" ], "title": "Thread/closedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "skills/changed" ], "title": "Skills/changedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/SkillsChangedNotification" } }, "required": [ "method", "params" ], "title": "Skills/changedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/name/updated" ], "title": "Thread/name/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadNameUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Thread/name/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/goal/updated" ], "title": "Thread/goal/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadGoalUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Thread/goal/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/goal/cleared" ], "title": "Thread/goal/clearedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadGoalClearedNotification" } }, "required": [ "method", "params" ], "title": "Thread/goal/clearedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/settings/updated" ], "title": "Thread/settings/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadSettingsUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Thread/settings/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/tokenUsage/updated" ], "title": "Thread/tokenUsage/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Thread/tokenUsage/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "turn/started" ], "title": "Turn/startedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/TurnStartedNotification" } }, "required": [ "method", "params" ], "title": "Turn/startedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "hook/started" ], "title": "Hook/startedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/HookStartedNotification" } }, "required": [ "method", "params" ], "title": "Hook/startedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "turn/completed" ], "title": "Turn/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/TurnCompletedNotification" } }, "required": [ "method", "params" ], "title": "Turn/completedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "hook/completed" ], "title": "Hook/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/HookCompletedNotification" } }, "required": [ "method", "params" ], "title": "Hook/completedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "turn/diff/updated" ], "title": "Turn/diff/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/TurnDiffUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Turn/diff/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "turn/plan/updated" ], "title": "Turn/plan/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/TurnPlanUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Turn/plan/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/started" ], "title": "Item/startedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ItemStartedNotification" } }, "required": [ "method", "params" ], "title": "Item/startedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/autoApprovalReview/started" ], "title": "Item/autoApprovalReview/startedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ItemGuardianApprovalReviewStartedNotification" } }, "required": [ "method", "params" ], "title": "Item/autoApprovalReview/startedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/autoApprovalReview/completed" ], "title": "Item/autoApprovalReview/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ItemGuardianApprovalReviewCompletedNotification" } }, "required": [ "method", "params" ], "title": "Item/autoApprovalReview/completedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/completed" ], "title": "Item/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ItemCompletedNotification" } }, "required": [ "method", "params" ], "title": "Item/completedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/agentMessage/delta" ], "title": "Item/agentMessage/deltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/AgentMessageDeltaNotification" } }, "required": [ "method", "params" ], "title": "Item/agentMessage/deltaNotification", "type": "object" }, { "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", "properties": { "method": { "enum": [ "item/plan/delta" ], "title": "Item/plan/deltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/PlanDeltaNotification" } }, "required": [ "method", "params" ], "title": "Item/plan/deltaNotification", "type": "object" }, { "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", "properties": { "method": { "enum": [ "command/exec/outputDelta" ], "title": "Command/exec/outputDeltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/CommandExecOutputDeltaNotification" } }, "required": [ "method", "params" ], "title": "Command/exec/outputDeltaNotification", "type": "object" }, { "description": "Stream base64-encoded stdout/stderr chunks for a running `process/spawn` session.", "properties": { "method": { "enum": [ "process/outputDelta" ], "title": "Process/outputDeltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ProcessOutputDeltaNotification" } }, "required": [ "method", "params" ], "title": "Process/outputDeltaNotification", "type": "object" }, { "description": "Final exit notification for a `process/spawn` session.", "properties": { "method": { "enum": [ "process/exited" ], "title": "Process/exitedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ProcessExitedNotification" } }, "required": [ "method", "params" ], "title": "Process/exitedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/commandExecution/outputDelta" ], "title": "Item/commandExecution/outputDeltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/CommandExecutionOutputDeltaNotification" } }, "required": [ "method", "params" ], "title": "Item/commandExecution/outputDeltaNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/commandExecution/terminalInteraction" ], "title": "Item/commandExecution/terminalInteractionNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/TerminalInteractionNotification" } }, "required": [ "method", "params" ], "title": "Item/commandExecution/terminalInteractionNotification", "type": "object" }, { "description": "Deprecated legacy apply_patch output stream notification.", "properties": { "method": { "enum": [ "item/fileChange/outputDelta" ], "title": "Item/fileChange/outputDeltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/FileChangeOutputDeltaNotification" } }, "required": [ "method", "params" ], "title": "Item/fileChange/outputDeltaNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/fileChange/patchUpdated" ], "title": "Item/fileChange/patchUpdatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/FileChangePatchUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Item/fileChange/patchUpdatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "serverRequest/resolved" ], "title": "ServerRequest/resolvedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ServerRequestResolvedNotification" } }, "required": [ "method", "params" ], "title": "ServerRequest/resolvedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/mcpToolCall/progress" ], "title": "Item/mcpToolCall/progressNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/McpToolCallProgressNotification" } }, "required": [ "method", "params" ], "title": "Item/mcpToolCall/progressNotification", "type": "object" }, { "properties": { "method": { "enum": [ "mcpServer/oauthLogin/completed" ], "title": "McpServer/oauthLogin/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/McpServerOauthLoginCompletedNotification" } }, "required": [ "method", "params" ], "title": "McpServer/oauthLogin/completedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "mcpServer/startupStatus/updated" ], "title": "McpServer/startupStatus/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/McpServerStatusUpdatedNotification" } }, "required": [ "method", "params" ], "title": "McpServer/startupStatus/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "account/updated" ], "title": "Account/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/AccountUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Account/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "account/rateLimits/updated" ], "title": "Account/rateLimits/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/AccountRateLimitsUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Account/rateLimits/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "app/list/updated" ], "title": "App/list/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/AppListUpdatedNotification" } }, "required": [ "method", "params" ], "title": "App/list/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "remoteControl/status/changed" ], "title": "RemoteControl/status/changedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/RemoteControlStatusChangedNotification" } }, "required": [ "method", "params" ], "title": "RemoteControl/status/changedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "externalAgentConfig/import/progress" ], "title": "ExternalAgentConfig/import/progressNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ExternalAgentConfigImportProgressNotification" } }, "required": [ "method", "params" ], "title": "ExternalAgentConfig/import/progressNotification", "type": "object" }, { "properties": { "method": { "enum": [ "externalAgentConfig/import/completed" ], "title": "ExternalAgentConfig/import/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ExternalAgentConfigImportCompletedNotification" } }, "required": [ "method", "params" ], "title": "ExternalAgentConfig/import/completedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "fs/changed" ], "title": "Fs/changedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/FsChangedNotification" } }, "required": [ "method", "params" ], "title": "Fs/changedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/reasoning/summaryTextDelta" ], "title": "Item/reasoning/summaryTextDeltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ReasoningSummaryTextDeltaNotification" } }, "required": [ "method", "params" ], "title": "Item/reasoning/summaryTextDeltaNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/reasoning/summaryPartAdded" ], "title": "Item/reasoning/summaryPartAddedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ReasoningSummaryPartAddedNotification" } }, "required": [ "method", "params" ], "title": "Item/reasoning/summaryPartAddedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "item/reasoning/textDelta" ], "title": "Item/reasoning/textDeltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ReasoningTextDeltaNotification" } }, "required": [ "method", "params" ], "title": "Item/reasoning/textDeltaNotification", "type": "object" }, { "description": "Deprecated: Use `ContextCompaction` item type instead.", "properties": { "method": { "enum": [ "thread/compacted" ], "title": "Thread/compactedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ContextCompactedNotification" } }, "required": [ "method", "params" ], "title": "Thread/compactedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "model/rerouted" ], "title": "Model/reroutedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ModelReroutedNotification" } }, "required": [ "method", "params" ], "title": "Model/reroutedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "model/verification" ], "title": "Model/verificationNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ModelVerificationNotification" } }, "required": [ "method", "params" ], "title": "Model/verificationNotification", "type": "object" }, { "properties": { "method": { "enum": [ "turn/moderationMetadata" ], "title": "Turn/moderationMetadataNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/TurnModerationMetadataNotification" } }, "required": [ "method", "params" ], "title": "Turn/moderationMetadataNotification", "type": "object" }, { "properties": { "method": { "enum": [ "model/safetyBuffering/updated" ], "title": "Model/safetyBuffering/updatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ModelSafetyBufferingUpdatedNotification" } }, "required": [ "method", "params" ], "title": "Model/safetyBuffering/updatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "warning" ], "title": "WarningNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/WarningNotification" } }, "required": [ "method", "params" ], "title": "WarningNotification", "type": "object" }, { "properties": { "method": { "enum": [ "guardianWarning" ], "title": "GuardianWarningNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/GuardianWarningNotification" } }, "required": [ "method", "params" ], "title": "GuardianWarningNotification", "type": "object" }, { "properties": { "method": { "enum": [ "deprecationNotice" ], "title": "DeprecationNoticeNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/DeprecationNoticeNotification" } }, "required": [ "method", "params" ], "title": "DeprecationNoticeNotification", "type": "object" }, { "properties": { "method": { "enum": [ "configWarning" ], "title": "ConfigWarningNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ConfigWarningNotification" } }, "required": [ "method", "params" ], "title": "ConfigWarningNotification", "type": "object" }, { "properties": { "method": { "enum": [ "fuzzyFileSearch/sessionUpdated" ], "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" } }, "required": [ "method", "params" ], "title": "FuzzyFileSearch/sessionUpdatedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "fuzzyFileSearch/sessionCompleted" ], "title": "FuzzyFileSearch/sessionCompletedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" } }, "required": [ "method", "params" ], "title": "FuzzyFileSearch/sessionCompletedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/started" ], "title": "Thread/realtime/startedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeStartedNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/startedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/itemAdded" ], "title": "Thread/realtime/itemAddedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeItemAddedNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/itemAddedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/transcript/delta" ], "title": "Thread/realtime/transcript/deltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeTranscriptDeltaNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/transcript/deltaNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/transcript/done" ], "title": "Thread/realtime/transcript/doneNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeTranscriptDoneNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/transcript/doneNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/outputAudio/delta" ], "title": "Thread/realtime/outputAudio/deltaNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeOutputAudioDeltaNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/outputAudio/deltaNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/sdp" ], "title": "Thread/realtime/sdpNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeSdpNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/sdpNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/error" ], "title": "Thread/realtime/errorNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeErrorNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/errorNotification", "type": "object" }, { "properties": { "method": { "enum": [ "thread/realtime/closed" ], "title": "Thread/realtime/closedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/ThreadRealtimeClosedNotification" } }, "required": [ "method", "params" ], "title": "Thread/realtime/closedNotification", "type": "object" }, { "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", "properties": { "method": { "enum": [ "windows/worldWritableWarning" ], "title": "Windows/worldWritableWarningNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/WindowsWorldWritableWarningNotification" } }, "required": [ "method", "params" ], "title": "Windows/worldWritableWarningNotification", "type": "object" }, { "properties": { "method": { "enum": [ "windowsSandbox/setupCompleted" ], "title": "WindowsSandbox/setupCompletedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/WindowsSandboxSetupCompletedNotification" } }, "required": [ "method", "params" ], "title": "WindowsSandbox/setupCompletedNotification", "type": "object" }, { "properties": { "method": { "enum": [ "account/login/completed" ], "title": "Account/login/completedNotificationMethod", "type": "string" }, "params": { "$ref": "#/definitions/AccountLoginCompletedNotification" } }, "required": [ "method", "params" ], "title": "Account/login/completedNotification", "type": "object" } ], "title": "ServerNotification" }