{ "$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"] }, "iconAssets": { "additionalProperties": { "type": "string" }, "type": ["object", "null"] }, "iconDarkAssets": { "additionalProperties": { "type": "string" }, "type": ["object", "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-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", "sessionBudgetExceeded", "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" }, "threadId": { "type": ["string", "null"] } }, "required": ["name", "success"], "type": "object" }, "McpServerStartupFailureReason": { "enum": ["reauthenticationRequired"], "type": "string" }, "McpServerStartupState": { "enum": ["starting", "ready", "failed", "cancelled"], "type": "string" }, "McpServerStatusUpdatedNotification": { "properties": { "error": { "type": ["string", "null"] }, "failureReason": { "anyOf": [ { "$ref": "#/definitions/McpServerStartupFailureReason" }, { "type": "null" } ] }, "name": { "type": "string" }, "status": { "$ref": "#/definitions/McpServerStartupState" }, "threadId": { "type": ["string", "null"] } }, "required": ["name", "status"], "type": "object" }, "McpToolCallAppContext": { "properties": { "actionName": { "type": ["string", "null"] }, "appName": { "type": ["string", "null"] }, "connectorId": { "type": "string" }, "linkId": { "type": ["string", "null"] }, "resourceUri": { "type": ["string", "null"] }, "templateId": { "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": { "fasterModel": { "type": ["string", "null"] }, "model": { "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "showBufferingUi": { "type": "boolean" }, "threadId": { "type": "string" }, "turnId": { "type": "string" }, "useCases": { "items": { "type": "string" }, "type": "array" } }, "required": [ "model", "reasons", "showBufferingUi", "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 receives multi-agent delegation instructions and, when it does, whether it should only spawn sub-agents after an explicit user request or may delegate proactively when doing so would help. `none` leaves the multi-agent tools available without injecting delegation instructions.", "enum": ["none", "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": { "description": "Identifier for this thread. Codex-generated thread IDs are UUIDv7.", "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" }, "ThreadExtra": { "description": "Extra app-server data for a thread.", "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/LegacyAppPathString" }, "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": { "description": "Identifier for this turn. Codex-generated turn IDs are UUIDv7.", "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" }