| { |
| "$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" |
| ] |
| }, |
| "onboardingEntrypoint": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/DesktopOnboardingEntrypoint" |
| }, |
| { |
| "type": "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.<id>]` 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" |
| }, |
| "AgentMessageDelivery": { |
| "enum": [ |
| "async" |
| ], |
| "type": "string" |
| }, |
| "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" |
| ] |
| }, |
| "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" |
| } |
| ] |
| }, |
| "AsyncUserInputQuestion": { |
| "additionalProperties": false, |
| "properties": { |
| "options": { |
| "items": { |
| "type": "string" |
| }, |
| "type": [ |
| "array", |
| "null" |
| ] |
| }, |
| "title": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "title" |
| ], |
| "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": "Backend auth supplied as request headers.", |
| "enum": [ |
| "headers" |
| ], |
| "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" |
| }, |
| { |
| "description": "Amazon Bedrock AWS access keys managed by Codex.", |
| "enum": [ |
| "bedrockAccessKeys" |
| ], |
| "type": "string" |
| } |
| ] |
| }, |
| "AuthRecoveryNotification": { |
| "properties": { |
| "message": { |
| "type": "string" |
| }, |
| "provider": { |
| "type": "string" |
| }, |
| "threadId": { |
| "type": "string" |
| }, |
| "turnId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "message", |
| "provider", |
| "threadId", |
| "turnId" |
| ], |
| "type": "object" |
| }, |
| "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", |
| "rateLimitExceeded", |
| "serverOverloaded", |
| "cyberPolicy", |
| "misalignmentPolicyViolation", |
| "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", |
| "sendMessage", |
| "followupTask", |
| "interruptAgent", |
| "listAgents" |
| ], |
| "type": "string" |
| }, |
| "CollabAgentToolCallStatus": { |
| "enum": [ |
| "inProgress", |
| "completed", |
| "failed", |
| "interrupted" |
| ], |
| "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/LegacyAppPathString" |
| }, |
| "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" |
| }, |
| "DesktopOnboardingEntrypoint": { |
| "enum": [ |
| "life_sciences" |
| ], |
| "type": "string" |
| }, |
| "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" |
| }, |
| { |
| "properties": { |
| "audioUrl": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "inputAudio" |
| ], |
| "title": "InputAudioDynamicToolCallOutputContentItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "audioUrl", |
| "type" |
| ], |
| "title": "InputAudioDynamicToolCallOutputContentItem", |
| "type": "object" |
| } |
| ] |
| }, |
| "DynamicToolCallStatus": { |
| "enum": [ |
| "inProgress", |
| "completed", |
| "failed" |
| ], |
| "type": "string" |
| }, |
| "EnvironmentConnectionNotification": { |
| "properties": { |
| "environmentId": { |
| "type": "string" |
| }, |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "environmentId", |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "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" |
| ] |
| }, |
| "subErrorType": { |
| "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" |
| ] |
| }, |
| "title": { |
| "default": null, |
| "description": "Original title for an imported session; null for other item types.", |
| "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", |
| "MEMORY", |
| "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": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| { |
| "type": "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": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| { |
| "type": "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" |
| }, |
| "FunctionCallOutputBody": { |
| "anyOf": [ |
| { |
| "type": "string" |
| }, |
| { |
| "items": { |
| "$ref": "#/definitions/FunctionCallOutputContentItem" |
| }, |
| "type": "array" |
| } |
| ] |
| }, |
| "FunctionCallOutputContentItem": { |
| "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", |
| "oneOf": [ |
| { |
| "properties": { |
| "text": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "input_text" |
| ], |
| "title": "InputTextFunctionCallOutputContentItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "text", |
| "type" |
| ], |
| "title": "InputTextFunctionCallOutputContentItem", |
| "type": "object" |
| }, |
| { |
| "anyOf": [ |
| { |
| "properties": { |
| "image_url": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "image_url" |
| ], |
| "title": "ImageUrlFunctionCallOutputContentItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "file_id": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "file_id" |
| ], |
| "title": "FileIdFunctionCallOutputContentItem", |
| "type": "object" |
| } |
| ], |
| "properties": { |
| "detail": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ImageDetail" |
| }, |
| { |
| "type": "null" |
| } |
| ] |
| }, |
| "type": { |
| "enum": [ |
| "input_image" |
| ], |
| "title": "InputImageFunctionCallOutputContentItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "type" |
| ], |
| "title": "InputImageFunctionCallOutputContentItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "audio_url": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "input_audio" |
| ], |
| "title": "InputAudioFunctionCallOutputContentItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "audio_url", |
| "type" |
| ], |
| "title": "InputAudioFunctionCallOutputContentItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "encrypted_content": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "encrypted_content" |
| ], |
| "title": "EncryptedContentFunctionCallOutputContentItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "encrypted_content", |
| "type" |
| ], |
| "title": "EncryptedContentFunctionCallOutputContentItem", |
| "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/LegacyAppPathString" |
| }, |
| "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" |
| }, |
| { |
| "description": "A child approval for input to an existing command execution item.", |
| "properties": { |
| "approvalId": { |
| "type": "string" |
| }, |
| "cwd": { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| "processId": { |
| "type": "string" |
| }, |
| "stdin": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "writeStdin" |
| ], |
| "title": "WriteStdinGuardianApprovalReviewActionType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "approvalId", |
| "cwd", |
| "processId", |
| "stdin", |
| "type" |
| ], |
| "title": "WriteStdinGuardianApprovalReviewAction", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "cwd": { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| "files": { |
| "items": { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| "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", |
| "sessionEnd", |
| "userPromptSubmit", |
| "subagentStart", |
| "subagentStop", |
| "stop", |
| "interrupt" |
| ], |
| "type": "string" |
| }, |
| "HookExecutionMode": { |
| "enum": [ |
| "sync", |
| "async" |
| ], |
| "type": "string" |
| }, |
| "HookHandlerType": { |
| "enum": [ |
| "command", |
| "mcpTool", |
| "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" |
| }, |
| "ImageGenerationFailure": { |
| "oneOf": [ |
| { |
| "properties": { |
| "limitId": { |
| "type": "string" |
| }, |
| "resetsAt": { |
| "format": "int64", |
| "type": [ |
| "integer", |
| "null" |
| ] |
| }, |
| "type": { |
| "enum": [ |
| "usageLimitExceeded" |
| ], |
| "title": "UsageLimitExceededImageGenerationFailureType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "limitId", |
| "type" |
| ], |
| "title": "UsageLimitExceededImageGenerationFailure", |
| "type": "object" |
| } |
| ] |
| }, |
| "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) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - 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) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - 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" |
| }, |
| "McpAppDisplayMode": { |
| "enum": [ |
| "inline", |
| "fullscreen" |
| ], |
| "type": "string" |
| }, |
| "McpAppUi": { |
| "description": "UI resource and display preference for model invocations, captured from the tool descriptor.", |
| "properties": { |
| "preferredModelDisplayMode": { |
| "$ref": "#/definitions/McpAppDisplayMode" |
| }, |
| "resourceUri": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "preferredModelDisplayMode", |
| "resourceUri" |
| ], |
| "type": "object" |
| }, |
| "McpServerEventNotification": { |
| "properties": { |
| "method": { |
| "type": "string" |
| }, |
| "params": true |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "type": "object" |
| }, |
| "McpServerEventStreamNotification": { |
| "properties": { |
| "notification": { |
| "$ref": "#/definitions/McpServerEventNotification" |
| }, |
| "subscriptionId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "notification", |
| "subscriptionId" |
| ], |
| "type": "object" |
| }, |
| "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" |
| ] |
| } |
| }, |
| "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" |
| } |
| ] |
| }, |
| "MisalignmentErrorDetails": { |
| "properties": { |
| "detailedExplanation": { |
| "description": "A substantive localized explanation is required before offering continuation.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "errorType": { |
| "description": "Open-ended classification; clients must accept categories added by Responses.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "steer": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/MisalignmentSteer" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "description": "Instruction to submit as the next turn's user input if continuation is confirmed." |
| } |
| }, |
| "type": "object" |
| }, |
| "MisalignmentSteer": { |
| "properties": { |
| "message": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "message" |
| ], |
| "type": "object" |
| }, |
| "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 the effective multi-agent delegation instructions for a turn. `custom` means the configured mode hint defines the policy instead of a built-in policy.", |
| "oneOf": [ |
| { |
| "enum": [ |
| "explicitRequestOnly", |
| "proactive" |
| ], |
| "type": "string" |
| }, |
| { |
| "additionalProperties": false, |
| "properties": { |
| "custom": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "custom" |
| ], |
| "title": "CustomMultiAgentMode", |
| "type": "object" |
| } |
| ] |
| }, |
| "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": { |
| "description": "Deprecated: `friendly` and `pragmatic` no longer select a style.", |
| "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_prolite", |
| "self_serve_business_usage_based", |
| "business", |
| "ent26", |
| "enterprise_cbp_automation", |
| "enterprise_cbp_usage_based", |
| "enterprise", |
| "edu", |
| "edu_plus", |
| "edu_pro", |
| "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" |
| } |
| ] |
| }, |
| "ProjectChangeType": { |
| "enum": [ |
| "created", |
| "updated", |
| "deleted" |
| ], |
| "type": "string" |
| }, |
| "ProjectChangedNotification": { |
| "properties": { |
| "changeType": { |
| "$ref": "#/definitions/ProjectChangeType" |
| }, |
| "projectId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "changeType", |
| "projectId" |
| ], |
| "type": "object" |
| }, |
| "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" |
| ] |
| }, |
| "normalModelSlug": { |
| "description": "Normal model whose display name and reasoning options describe this quota alias.", |
| "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" |
| } |
| ] |
| }, |
| "spendControlReached": { |
| "description": "Backend-reported spend-control state. `None` is unavailable, not a sparse-update recovery.", |
| "type": [ |
| "boolean", |
| "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", |
| "v3" |
| ], |
| "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" |
| }, |
| "StrictReviewRequiredNotification": { |
| "properties": { |
| "startedAtMs": { |
| "description": "Unix timestamp (in milliseconds) when this review started.", |
| "format": "int64", |
| "type": "integer" |
| }, |
| "threadId": { |
| "type": "string" |
| }, |
| "turnId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "startedAtMs", |
| "threadId", |
| "turnId" |
| ], |
| "type": "object" |
| }, |
| "SubAgentActivityKind": { |
| "enum": [ |
| "started", |
| "interacted", |
| "interrupted", |
| "completed" |
| ], |
| "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." |
| }, |
| "historyMode": { |
| "allOf": [ |
| { |
| "$ref": "#/definitions/ThreadHistoryMode" |
| } |
| ], |
| "default": "legacy", |
| "description": "Persisted thread history contract selected when this thread was created." |
| }, |
| "id": { |
| "description": "Identifier for this thread. Codex-generated thread IDs are UUIDv7.", |
| "type": "string" |
| }, |
| "model": { |
| "description": "Current configured model when loaded, otherwise the latest persisted model. Null when unavailable. This is not per-turn execution telemetry.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "modelProvider": { |
| "description": "Model provider used for this thread (for example, 'openai').", |
| "type": "string" |
| }, |
| "name": { |
| "description": "Optional user-facing thread title.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "originator": { |
| "description": "Originator recorded when the thread was created, independent of its current client or executor. Null when the recorded originator is unavailable.", |
| "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" |
| }, |
| "projectId": { |
| "description": "Canonical project assignment owned by app-server, if any.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "reasoningEffort": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ReasoningEffort" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "description": "Current configured reasoning effort when loaded, otherwise the latest persisted effort. Null when unset or unavailable. This is not per-turn execution telemetry." |
| }, |
| "recencyAt": { |
| "description": "Unix timestamp (in seconds) used for thread recency ordering.", |
| "format": "int64", |
| "type": [ |
| "integer", |
| "null" |
| ] |
| }, |
| "section": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ThreadSection" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null, |
| "description": "The independently persisted section selected for this thread, if any." |
| }, |
| "sectionEnteredAt": { |
| "default": null, |
| "description": "Unix timestamp in seconds when the thread entered its current section.", |
| "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/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", |
| "projectId", |
| "sessionId", |
| "source", |
| "status", |
| "turns", |
| "updatedAt" |
| ], |
| "type": "object" |
| }, |
| "ThreadActiveFlag": { |
| "enum": [ |
| "waitingOnApproval", |
| "waitingOnUserInput" |
| ], |
| "type": "string" |
| }, |
| "ThreadArchivedNotification": { |
| "properties": { |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadAttachmentOperation": { |
| "description": "The persisted attachment change represented by a notification.", |
| "enum": [ |
| "created", |
| "deleted" |
| ], |
| "type": "string" |
| }, |
| "ThreadAttachmentUpdatedNotification": { |
| "description": "Notification published after a thread attachment is created or deleted.", |
| "properties": { |
| "attachmentId": { |
| "type": "string" |
| }, |
| "attachmentType": { |
| "type": "string" |
| }, |
| "identityKey": { |
| "type": "string" |
| }, |
| "operation": { |
| "$ref": "#/definitions/ThreadAttachmentOperation" |
| }, |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "attachmentId", |
| "attachmentType", |
| "identityKey", |
| "operation", |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadClosedNotification": { |
| "properties": { |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadDeletedNotification": { |
| "properties": { |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadEnvironment": { |
| "description": "An environment selected by a loaded thread, independent of connection status.", |
| "properties": { |
| "cwd": { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| "environmentId": { |
| "type": "string" |
| }, |
| "runtimeWorkspaceRoots": { |
| "items": { |
| "$ref": "#/definitions/LegacyAppPathString" |
| }, |
| "type": "array" |
| } |
| }, |
| "required": [ |
| "cwd", |
| "environmentId", |
| "runtimeWorkspaceRoots" |
| ], |
| "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" |
| }, |
| "ThreadHistoryMode": { |
| "enum": [ |
| "legacy", |
| "paginated" |
| ], |
| "type": "string" |
| }, |
| "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": { |
| "delivery": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/AgentMessageDelivery" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null |
| }, |
| "id": { |
| "type": "string" |
| }, |
| "memoryCitation": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/MemoryCitation" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null |
| }, |
| "phase": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/MessagePhase" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null |
| }, |
| "questions": { |
| "default": null, |
| "items": { |
| "$ref": "#/definitions/AsyncUserInputQuestion" |
| }, |
| "type": [ |
| "array", |
| "null" |
| ] |
| }, |
| "text": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "agentMessage" |
| ], |
| "title": "AgentMessageThreadItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "id", |
| "text", |
| "type" |
| ], |
| "title": "AgentMessageThreadItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "id": { |
| "type": "string" |
| }, |
| "name": { |
| "type": "string" |
| }, |
| "namespace": { |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "output": { |
| "$ref": "#/definitions/FunctionCallOutputBody" |
| }, |
| "type": { |
| "enum": [ |
| "functionCallOutput" |
| ], |
| "title": "FunctionCallOutputThreadItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "id", |
| "name", |
| "output", |
| "type" |
| ], |
| "title": "FunctionCallOutputThreadItem", |
| "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" |
| }, |
| "pluginId": { |
| "default": null, |
| "description": "Trusted first-party plugin id when this command resolves to one plugin script.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "processId": { |
| "description": "Identifier for the underlying PTY process (when available).", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "scriptPath": { |
| "default": null, |
| "description": "Safe plugin-relative path when this command resolves to one plugin script.", |
| "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": "Legacy compatibility field; prefer `mcpAppUi.resourceUri` when available.", |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "mcpAppUi": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/McpAppUi" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "description": "Presentation captured from the invoked descriptor; absent in older history." |
| }, |
| "pluginId": { |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "readOnlyHint": { |
| "type": [ |
| "boolean", |
| "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" |
| }, |
| "results": { |
| "default": null, |
| "description": "Structured search results returned out-of-band by standalone web search.\n\nThese stay as opaque JSON at the extension/app-server boundary so new result fields and result types can pass through without a Codex release.", |
| "items": true, |
| "type": [ |
| "array", |
| "null" |
| ] |
| }, |
| "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" |
| }, |
| { |
| "description": "Display item emitted by the interruptible `clock.sleep` tool.", |
| "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": { |
| "failure": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ImageGenerationFailure" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null |
| }, |
| "id": { |
| "type": "string" |
| }, |
| "result": { |
| "type": "string" |
| }, |
| "revisedPrompt": { |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "savedPath": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/AbsolutePathBuf" |
| }, |
| { |
| "type": "null" |
| } |
| ] |
| }, |
| "status": { |
| "type": "string" |
| }, |
| "transparentBackground": { |
| "default": null, |
| "type": [ |
| "boolean", |
| "null" |
| ] |
| }, |
| "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" |
| }, |
| "ThreadProjectUpdatedNotification": { |
| "properties": { |
| "projectId": { |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "projectId", |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadQueueChangedNotification": { |
| "properties": { |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "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" |
| }, |
| "ThreadRealtimeBemItemPresentation": { |
| "description": "EXPERIMENTAL - how an existing agent item appears in a realtime conversation.", |
| "oneOf": [ |
| { |
| "properties": { |
| "type": { |
| "enum": [ |
| "wholeItem" |
| ], |
| "title": "WholeItemThreadRealtimeBemItemPresentationType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "type" |
| ], |
| "title": "WholeItemThreadRealtimeBemItemPresentation", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "type": { |
| "enum": [ |
| "inlineMarkdown" |
| ], |
| "title": "InlineMarkdownThreadRealtimeBemItemPresentationType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "type" |
| ], |
| "title": "InlineMarkdownThreadRealtimeBemItemPresentation", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "index": { |
| "format": "uint32", |
| "minimum": 0.0, |
| "type": "integer" |
| }, |
| "type": { |
| "enum": [ |
| "inlineVisualization" |
| ], |
| "title": "InlineVisualizationThreadRealtimeBemItemPresentationType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "index", |
| "type" |
| ], |
| "title": "InlineVisualizationThreadRealtimeBemItemPresentation", |
| "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" |
| }, |
| "ThreadRealtimeItem": { |
| "description": "EXPERIMENTAL - a thread-scoped realtime item in the canonical timeline.", |
| "oneOf": [ |
| { |
| "properties": { |
| "type": { |
| "enum": [ |
| "realtimeSessionStarted" |
| ], |
| "title": "RealtimeSessionStartedThreadRealtimeItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "type" |
| ], |
| "title": "RealtimeSessionStartedThreadRealtimeItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "role": { |
| "$ref": "#/definitions/ThreadRealtimeTranscriptRole" |
| }, |
| "text": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "transcriptSegment" |
| ], |
| "title": "TranscriptSegmentThreadRealtimeItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "role", |
| "text", |
| "type" |
| ], |
| "title": "TranscriptSegmentThreadRealtimeItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "item_id": { |
| "type": "string" |
| }, |
| "presentation": { |
| "$ref": "#/definitions/ThreadRealtimeBemItemPresentation" |
| }, |
| "turn_id": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "bemItemPromoted" |
| ], |
| "title": "BemItemPromotedThreadRealtimeItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "item_id", |
| "presentation", |
| "turn_id", |
| "type" |
| ], |
| "title": "BemItemPromotedThreadRealtimeItem", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "outcome": { |
| "$ref": "#/definitions/ThreadRealtimeSessionOutcome" |
| }, |
| "type": { |
| "enum": [ |
| "realtimeSessionClosed" |
| ], |
| "title": "RealtimeSessionClosedThreadRealtimeItemType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "outcome", |
| "type" |
| ], |
| "title": "RealtimeSessionClosedThreadRealtimeItem", |
| "type": "object" |
| } |
| ], |
| "properties": { |
| "id": { |
| "type": "string" |
| }, |
| "realtimeSessionId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "id", |
| "realtimeSessionId" |
| ], |
| "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" |
| }, |
| "ThreadRealtimeItemCompletedNotification": { |
| "description": "EXPERIMENTAL - a realtime timeline item published after canonical commit.", |
| "properties": { |
| "item": { |
| "$ref": "#/definitions/ThreadRealtimeItem" |
| }, |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "item", |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadRealtimeItemStartedNotification": { |
| "description": "EXPERIMENTAL - a realtime timeline item started before its content streams.", |
| "properties": { |
| "item": { |
| "$ref": "#/definitions/ThreadRealtimeItem" |
| }, |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "item", |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadRealtimeItemTranscriptDeltaNotification": { |
| "description": "EXPERIMENTAL - text appended to an active realtime transcript item.", |
| "properties": { |
| "delta": { |
| "type": "string" |
| }, |
| "itemId": { |
| "type": "string" |
| }, |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "delta", |
| "itemId", |
| "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" |
| }, |
| "ThreadRealtimeSessionOutcome": { |
| "enum": [ |
| "ended", |
| "failed" |
| ], |
| "type": "string" |
| }, |
| "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" |
| }, |
| "ThreadRealtimeTranscriptRole": { |
| "enum": [ |
| "user", |
| "assistant" |
| ], |
| "type": "string" |
| }, |
| "ThreadRevertedNotification": { |
| "properties": { |
| "threadId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "threadId" |
| ], |
| "type": "object" |
| }, |
| "ThreadSection": { |
| "description": "An independently persisted, user-visible thread section.", |
| "properties": { |
| "appearance": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ThreadSectionAppearance" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null, |
| "description": "Optional appearance synchronized across clients." |
| }, |
| "id": { |
| "description": "Opaque UUIDv7 identity that remains stable when the section is renamed.", |
| "type": "string" |
| }, |
| "name": { |
| "description": "The current user-visible section name.", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "id", |
| "name" |
| ], |
| "type": "object" |
| }, |
| "ThreadSectionAppearance": { |
| "description": "Extensible visual presentation for a custom thread section.", |
| "properties": { |
| "color": { |
| "type": [ |
| "string", |
| "null" |
| ] |
| }, |
| "icon": { |
| "type": [ |
| "string", |
| "null" |
| ] |
| } |
| }, |
| "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" |
| }, |
| "disabledPluginIds": { |
| "default": [], |
| "description": "Saved list of disabled plugin IDs. Does not yet filter plugin capabilities.", |
| "items": { |
| "type": "string" |
| }, |
| "type": "array" |
| }, |
| "effort": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ReasoningEffort" |
| }, |
| { |
| "type": "null" |
| } |
| ] |
| }, |
| "model": { |
| "type": "string" |
| }, |
| "modelProvider": { |
| "type": "string" |
| }, |
| "personality": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/Personality" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "description": "@deprecated Reports the saved setting; `friendly` and `pragmatic` no longer select a style." |
| }, |
| "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": { |
| "cacheWriteInputTokens": { |
| "default": 0, |
| "format": "int64", |
| "type": "integer" |
| }, |
| "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" |
| }, |
| "misalignment": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/MisalignmentErrorDetails" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null, |
| "description": "Optional public explanation and continuation instruction for a misalignment block." |
| } |
| }, |
| "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" |
| }, |
| { |
| "anyOf": [ |
| { |
| "properties": { |
| "url": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "url" |
| ], |
| "title": "UrlUserInput", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "fileId": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "fileId" |
| ], |
| "title": "FileIdUserInput", |
| "type": "object" |
| } |
| ], |
| "properties": { |
| "detail": { |
| "anyOf": [ |
| { |
| "$ref": "#/definitions/ImageDetail" |
| }, |
| { |
| "type": "null" |
| } |
| ], |
| "default": null |
| }, |
| "type": { |
| "enum": [ |
| "image" |
| ], |
| "title": "ImageUserInputType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "type" |
| ], |
| "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": { |
| "type": { |
| "enum": [ |
| "audio" |
| ], |
| "title": "AudioUserInputType", |
| "type": "string" |
| }, |
| "url": { |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "type", |
| "url" |
| ], |
| "title": "AudioUserInput", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "path": { |
| "type": "string" |
| }, |
| "type": { |
| "enum": [ |
| "localAudio" |
| ], |
| "title": "LocalAudioUserInputType", |
| "type": "string" |
| } |
| }, |
| "required": [ |
| "path", |
| "type" |
| ], |
| "title": "LocalAudioUserInput", |
| "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": [ |
| "thread/reverted" |
| ], |
| "title": "Thread/revertedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadRevertedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/revertedNotification", |
| "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/attachment/updated" |
| ], |
| "title": "Thread/attachment/updatedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadAttachmentUpdatedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/attachment/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/queue/changed" |
| ], |
| "title": "Thread/queue/changedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadQueueChangedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/queue/changedNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "project/changed" |
| ], |
| "title": "Project/changedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ProjectChangedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Project/changedNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "thread/project/updated" |
| ], |
| "title": "Thread/project/updatedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadProjectUpdatedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/project/updatedNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "thread/environment/connected" |
| ], |
| "title": "Thread/environment/connectedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/EnvironmentConnectionNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/environment/connectedNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "thread/environment/disconnected" |
| ], |
| "title": "Thread/environment/disconnectedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/EnvironmentConnectionNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/environment/disconnectedNotification", |
| "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": [ |
| "autoApprovalReview/strictReviewRequired" |
| ], |
| "title": "AutoApprovalReview/strictReviewRequiredNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/StrictReviewRequiredNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "AutoApprovalReview/strictReviewRequiredNotification", |
| "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": [ |
| "mcpServer/event/stream/notification" |
| ], |
| "title": "McpServer/event/stream/notificationNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/McpServerEventStreamNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "McpServer/event/stream/notificationNotification", |
| "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": [ |
| "modelProvider/authRecoveryStarted" |
| ], |
| "title": "ModelProvider/authRecoveryStartedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/AuthRecoveryNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "ModelProvider/authRecoveryStartedNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "modelProvider/authRecoveryCompleted" |
| ], |
| "title": "ModelProvider/authRecoveryCompletedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/AuthRecoveryNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "ModelProvider/authRecoveryCompletedNotification", |
| "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/item/started" |
| ], |
| "title": "Thread/realtime/item/startedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadRealtimeItemStartedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/realtime/item/startedNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "thread/realtime/item/transcript/delta" |
| ], |
| "title": "Thread/realtime/item/transcript/deltaNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadRealtimeItemTranscriptDeltaNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/realtime/item/transcript/deltaNotification", |
| "type": "object" |
| }, |
| { |
| "properties": { |
| "method": { |
| "enum": [ |
| "thread/realtime/item/completed" |
| ], |
| "title": "Thread/realtime/item/completedNotificationMethod", |
| "type": "string" |
| }, |
| "params": { |
| "$ref": "#/definitions/ThreadRealtimeItemCompletedNotification" |
| } |
| }, |
| "required": [ |
| "method", |
| "params" |
| ], |
| "title": "Thread/realtime/item/completedNotification", |
| "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" |
| } |
| ], |
| "properties": { |
| "emittedAtMs": { |
| "description": "Unix timestamp (in milliseconds) when app-server emitted this notification.", |
| "format": "int64", |
| "type": "integer" |
| } |
| }, |
| "title": "ServerNotification" |
| } |
