{
  "$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"
    },
    "Account": {
      "oneOf": [
        {
          "properties": {
            "type": {
              "enum": [
                "apiKey"
              ],
              "title": "ApiKeyAccountType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "ApiKeyAccount",
          "type": "object"
        },
        {
          "properties": {
            "email": {
              "type": "string"
            },
            "planType": {
              "$ref": "#/definitions/PlanType"
            },
            "type": {
              "enum": [
                "chatgpt"
              ],
              "title": "ChatgptAccountType",
              "type": "string"
            }
          },
          "required": [
            "email",
            "planType",
            "type"
          ],
          "title": "ChatgptAccount",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "amazonBedrock"
              ],
              "title": "AmazonBedrockAccountType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "AmazonBedrockAccount",
          "type": "object"
        }
      ]
    },
    "AccountLoginCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "error": {
          "type": [
            "string",
            "null"
          ]
        },
        "loginId": {
          "type": [
            "string",
            "null"
          ]
        },
        "success": {
          "type": "boolean"
        }
      },
      "required": [
        "success"
      ],
      "title": "AccountLoginCompletedNotification",
      "type": "object"
    },
    "AccountRateLimitsUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "rateLimits": {
          "$ref": "#/definitions/RateLimitSnapshot"
        }
      },
      "required": [
        "rateLimits"
      ],
      "title": "AccountRateLimitsUpdatedNotification",
      "type": "object"
    },
    "AccountUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "authMode": {
          "anyOf": [
            {
              "$ref": "#/definitions/AuthMode"
            },
            {
              "type": "null"
            }
          ]
        },
        "planType": {
          "anyOf": [
            {
              "$ref": "#/definitions/PlanType"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "title": "AccountUpdatedNotification",
      "type": "object"
    },
    "ActivePermissionProfile": {
      "properties": {
        "extends": {
          "default": null,
          "description": "Parent profile identifier once permissions profiles support inheritance. This is currently always `null`.",
          "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"
        },
        "modifications": {
          "default": [],
          "description": "Bounded user-requested modifications applied on top of the named profile, if any.",
          "items": {
            "$ref": "#/definitions/ActivePermissionProfileModification"
          },
          "type": "array"
        }
      },
      "required": [
        "id"
      ],
      "type": "object"
    },
    "ActivePermissionProfileModification": {
      "oneOf": [
        {
          "description": "Additional concrete directory that should be writable.",
          "properties": {
            "path": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "additionalWritableRoot"
              ],
              "title": "AdditionalWritableRootActivePermissionProfileModificationType",
              "type": "string"
            }
          },
          "required": [
            "path",
            "type"
          ],
          "title": "AdditionalWritableRootActivePermissionProfileModification",
          "type": "object"
        }
      ]
    },
    "AddCreditsNudgeCreditType": {
      "enum": [
        "credits",
        "usage_limit"
      ],
      "type": "string"
    },
    "AddCreditsNudgeEmailStatus": {
      "enum": [
        "sent",
        "cooldown_active"
      ],
      "type": "string"
    },
    "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/AbsolutePathBuf"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "write": {
          "description": "This will be removed in favor of `entries`.",
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "AdditionalNetworkPermissions": {
      "properties": {
        "enabled": {
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "AgentMessageDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "delta": {
          "type": "string"
        },
        "itemId": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "delta",
        "itemId",
        "threadId",
        "turnId"
      ],
      "title": "AgentMessageDeltaNotification",
      "type": "object"
    },
    "AgentPath": {
      "type": "string"
    },
    "AnalyticsConfig": {
      "additionalProperties": true,
      "properties": {
        "enabled": {
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "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"
    },
    "AppConfig": {
      "properties": {
        "default_tools_approval_mode": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppToolApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "default_tools_enabled": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "destructive_enabled": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "enabled": {
          "default": true,
          "type": "boolean"
        },
        "open_world_enabled": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "tools": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppToolsConfig"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    },
    "AppInfo": {
      "description": "EXPERIMENTAL - app metadata returned by app-list APIs.",
      "properties": {
        "appMetadata": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppMetadata"
            },
            {
              "type": "null"
            }
          ]
        },
        "branding": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppBranding"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "distributionChannel": {
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "type": "string"
        },
        "installUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "isAccessible": {
          "default": false,
          "type": "boolean"
        },
        "isEnabled": {
          "default": true,
          "description": "Whether this app is enabled in config.toml. Example: ```toml [apps.bad_app] enabled = false ```",
          "type": "boolean"
        },
        "labels": {
          "additionalProperties": {
            "type": "string"
          },
          "type": [
            "object",
            "null"
          ]
        },
        "logoUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "logoUrlDark": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "pluginDisplayNames": {
          "default": [],
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "id",
        "name"
      ],
      "type": "object"
    },
    "AppListUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - notification emitted when the app list changes.",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/AppInfo"
          },
          "type": "array"
        }
      },
      "required": [
        "data"
      ],
      "title": "AppListUpdatedNotification",
      "type": "object"
    },
    "AppMetadata": {
      "properties": {
        "categories": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "developer": {
          "type": [
            "string",
            "null"
          ]
        },
        "firstPartyRequiresInstall": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "firstPartyType": {
          "type": [
            "string",
            "null"
          ]
        },
        "review": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppReview"
            },
            {
              "type": "null"
            }
          ]
        },
        "screenshots": {
          "items": {
            "$ref": "#/definitions/AppScreenshot"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "seoDescription": {
          "type": [
            "string",
            "null"
          ]
        },
        "showInComposerWhenUnlinked": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "subCategories": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "version": {
          "type": [
            "string",
            "null"
          ]
        },
        "versionId": {
          "type": [
            "string",
            "null"
          ]
        },
        "versionNotes": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "AppReview": {
      "properties": {
        "status": {
          "type": "string"
        }
      },
      "required": [
        "status"
      ],
      "type": "object"
    },
    "AppScreenshot": {
      "properties": {
        "fileId": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": [
            "string",
            "null"
          ]
        },
        "userPrompt": {
          "type": "string"
        }
      },
      "required": [
        "userPrompt"
      ],
      "type": "object"
    },
    "AppSummary": {
      "description": "EXPERIMENTAL - app metadata summary for plugin responses.",
      "properties": {
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "type": "string"
        },
        "installUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "needsAuth": {
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "name",
        "needsAuth"
      ],
      "type": "object"
    },
    "AppToolApproval": {
      "enum": [
        "auto",
        "prompt",
        "approve"
      ],
      "type": "string"
    },
    "AppToolConfig": {
      "properties": {
        "approval_mode": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppToolApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "enabled": {
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "AppToolsConfig": {
      "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"
    },
    "AppsConfig": {
      "properties": {
        "_default": {
          "anyOf": [
            {
              "$ref": "#/definitions/AppsDefaultConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "AppsDefaultConfig": {
      "properties": {
        "destructive_enabled": {
          "default": true,
          "type": "boolean"
        },
        "enabled": {
          "default": true,
          "type": "boolean"
        },
        "open_world_enabled": {
          "default": true,
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "AppsListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - list available apps/connectors.",
      "properties": {
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous call.",
          "type": [
            "string",
            "null"
          ]
        },
        "forceRefetch": {
          "description": "When true, bypass app caches and fetch the latest data from sources.",
          "type": "boolean"
        },
        "limit": {
          "description": "Optional page size; defaults to a reasonable server-side value.",
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        },
        "threadId": {
          "description": "Optional thread id used to evaluate app feature gating from that thread's config.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "title": "AppsListParams",
      "type": "object"
    },
    "AppsListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - app list response.",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/AppInfo"
          },
          "type": "array"
        },
        "nextCursor": {
          "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "data"
      ],
      "title": "AppsListResponse",
      "type": "object"
    },
    "AskForApproval": {
      "oneOf": [
        {
          "enum": [
            "untrusted",
            "on-failure",
            "on-request",
            "never"
          ],
          "type": "string"
        },
        {
          "additionalProperties": false,
          "properties": {
            "granular": {
              "properties": {
                "mcp_elicitations": {
                  "type": "boolean"
                },
                "request_permissions": {
                  "default": false,
                  "type": "boolean"
                },
                "rules": {
                  "type": "boolean"
                },
                "sandbox_approval": {
                  "type": "boolean"
                },
                "skill_approval": {
                  "default": false,
                  "type": "boolean"
                }
              },
              "required": [
                "mcp_elicitations",
                "rules",
                "sandbox_approval"
              ],
              "type": "object"
            }
          },
          "required": [
            "granular"
          ],
          "title": "GranularAskForApproval",
          "type": "object"
        }
      ]
    },
    "AuthMode": {
      "description": "Authentication mode for OpenAI-backed providers.",
      "oneOf": [
        {
          "description": "OpenAI API key provided by the caller and stored by Codex.",
          "enum": [
            "apikey"
          ],
          "type": "string"
        },
        {
          "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
          "enum": [
            "chatgpt"
          ],
          "type": "string"
        },
        {
          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.",
          "enum": [
            "chatgptAuthTokens"
          ],
          "type": "string"
        },
        {
          "description": "Programmatic Codex auth backed by a registered Agent Identity.",
          "enum": [
            "agentIdentity"
          ],
          "type": "string"
        }
      ]
    },
    "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"
    },
    "CancelLoginAccountParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "loginId": {
          "type": "string"
        }
      },
      "required": [
        "loginId"
      ],
      "title": "CancelLoginAccountParams",
      "type": "object"
    },
    "CancelLoginAccountResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "status": {
          "$ref": "#/definitions/CancelLoginAccountStatus"
        }
      },
      "required": [
        "status"
      ],
      "title": "CancelLoginAccountResponse",
      "type": "object"
    },
    "CancelLoginAccountStatus": {
      "enum": [
        "canceled",
        "notFound"
      ],
      "type": "string"
    },
    "ClientInfo": {
      "properties": {
        "name": {
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "version"
      ],
      "type": "object"
    },
    "ClientRequest": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Request from the client to the server.",
      "oneOf": [
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "initialize"
              ],
              "title": "InitializeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/InitializeParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "InitializeRequest",
          "type": "object"
        },
        {
          "description": "NEW APIs",
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/start"
              ],
              "title": "Thread/startRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadStartParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/startRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/resume"
              ],
              "title": "Thread/resumeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadResumeParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/resumeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/fork"
              ],
              "title": "Thread/forkRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadForkParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/forkRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/archive"
              ],
              "title": "Thread/archiveRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadArchiveParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/archiveRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/unsubscribe"
              ],
              "title": "Thread/unsubscribeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadUnsubscribeParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/unsubscribeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/name/set"
              ],
              "title": "Thread/name/setRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadSetNameParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/name/setRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/metadata/update"
              ],
              "title": "Thread/metadata/updateRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadMetadataUpdateParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/metadata/updateRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/unarchive"
              ],
              "title": "Thread/unarchiveRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadUnarchiveParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/unarchiveRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/compact/start"
              ],
              "title": "Thread/compact/startRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadCompactStartParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/compact/startRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/shellCommand"
              ],
              "title": "Thread/shellCommandRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadShellCommandParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/shellCommandRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/approveGuardianDeniedAction"
              ],
              "title": "Thread/approveGuardianDeniedActionRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadApproveGuardianDeniedActionParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/approveGuardianDeniedActionRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/rollback"
              ],
              "title": "Thread/rollbackRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRollbackParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/rollbackRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/list"
              ],
              "title": "Thread/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/loaded/list"
              ],
              "title": "Thread/loaded/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadLoadedListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/loaded/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/read"
              ],
              "title": "Thread/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadReadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/readRequest",
          "type": "object"
        },
        {
          "description": "Append raw Responses API items to the thread history without starting a user turn.",
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "thread/inject_items"
              ],
              "title": "Thread/injectItemsRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadInjectItemsParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Thread/injectItemsRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "skills/list"
              ],
              "title": "Skills/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/SkillsListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Skills/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "hooks/list"
              ],
              "title": "Hooks/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/HooksListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Hooks/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "marketplace/add"
              ],
              "title": "Marketplace/addRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/MarketplaceAddParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Marketplace/addRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "marketplace/remove"
              ],
              "title": "Marketplace/removeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/MarketplaceRemoveParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Marketplace/removeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "marketplace/upgrade"
              ],
              "title": "Marketplace/upgradeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/MarketplaceUpgradeParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Marketplace/upgradeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/list"
              ],
              "title": "Plugin/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/read"
              ],
              "title": "Plugin/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginReadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/skill/read"
              ],
              "title": "Plugin/skill/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginSkillReadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/skill/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/share/save"
              ],
              "title": "Plugin/share/saveRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginShareSaveParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/share/saveRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/share/list"
              ],
              "title": "Plugin/share/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginShareListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/share/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/share/delete"
              ],
              "title": "Plugin/share/deleteRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginShareDeleteParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/share/deleteRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "app/list"
              ],
              "title": "App/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/AppsListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "App/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "device/key/create"
              ],
              "title": "Device/key/createRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/DeviceKeyCreateParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Device/key/createRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "device/key/public"
              ],
              "title": "Device/key/publicRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/DeviceKeyPublicParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Device/key/publicRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "device/key/sign"
              ],
              "title": "Device/key/signRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/DeviceKeySignParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Device/key/signRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/readFile"
              ],
              "title": "Fs/readFileRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsReadFileParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/readFileRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/writeFile"
              ],
              "title": "Fs/writeFileRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsWriteFileParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/writeFileRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/createDirectory"
              ],
              "title": "Fs/createDirectoryRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsCreateDirectoryParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/createDirectoryRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/getMetadata"
              ],
              "title": "Fs/getMetadataRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsGetMetadataParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/getMetadataRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/readDirectory"
              ],
              "title": "Fs/readDirectoryRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsReadDirectoryParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/readDirectoryRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/remove"
              ],
              "title": "Fs/removeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsRemoveParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/removeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/copy"
              ],
              "title": "Fs/copyRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsCopyParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/copyRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/watch"
              ],
              "title": "Fs/watchRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsWatchParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/watchRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fs/unwatch"
              ],
              "title": "Fs/unwatchRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FsUnwatchParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Fs/unwatchRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "skills/config/write"
              ],
              "title": "Skills/config/writeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/SkillsConfigWriteParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Skills/config/writeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/install"
              ],
              "title": "Plugin/installRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginInstallParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/installRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "plugin/uninstall"
              ],
              "title": "Plugin/uninstallRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PluginUninstallParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Plugin/uninstallRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "turn/start"
              ],
              "title": "Turn/startRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnStartParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Turn/startRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "turn/steer"
              ],
              "title": "Turn/steerRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnSteerParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Turn/steerRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "turn/interrupt"
              ],
              "title": "Turn/interruptRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnInterruptParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Turn/interruptRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "review/start"
              ],
              "title": "Review/startRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ReviewStartParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Review/startRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "model/list"
              ],
              "title": "Model/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ModelListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Model/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "modelProvider/capabilities/read"
              ],
              "title": "ModelProvider/capabilities/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ModelProviderCapabilitiesReadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "ModelProvider/capabilities/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "experimentalFeature/list"
              ],
              "title": "ExperimentalFeature/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ExperimentalFeatureListParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "ExperimentalFeature/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "experimentalFeature/enablement/set"
              ],
              "title": "ExperimentalFeature/enablement/setRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ExperimentalFeatureEnablementSetParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "ExperimentalFeature/enablement/setRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "mcpServer/oauth/login"
              ],
              "title": "McpServer/oauth/loginRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/McpServerOauthLoginParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "McpServer/oauth/loginRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "config/mcpServer/reload"
              ],
              "title": "Config/mcpServer/reloadRequestMethod",
              "type": "string"
            },
            "params": {
              "type": "null"
            }
          },
          "required": [
            "id",
            "method"
          ],
          "title": "Config/mcpServer/reloadRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "mcpServerStatus/list"
              ],
              "title": "McpServerStatus/listRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ListMcpServerStatusParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "McpServerStatus/listRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "mcpServer/resource/read"
              ],
              "title": "McpServer/resource/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/McpResourceReadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "McpServer/resource/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "mcpServer/tool/call"
              ],
              "title": "McpServer/tool/callRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/McpServerToolCallParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "McpServer/tool/callRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "windowsSandbox/setupStart"
              ],
              "title": "WindowsSandbox/setupStartRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/WindowsSandboxSetupStartParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "WindowsSandbox/setupStartRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "account/login/start"
              ],
              "title": "Account/login/startRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/LoginAccountParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Account/login/startRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "account/login/cancel"
              ],
              "title": "Account/login/cancelRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CancelLoginAccountParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Account/login/cancelRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "account/logout"
              ],
              "title": "Account/logoutRequestMethod",
              "type": "string"
            },
            "params": {
              "type": "null"
            }
          },
          "required": [
            "id",
            "method"
          ],
          "title": "Account/logoutRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "account/rateLimits/read"
              ],
              "title": "Account/rateLimits/readRequestMethod",
              "type": "string"
            },
            "params": {
              "type": "null"
            }
          },
          "required": [
            "id",
            "method"
          ],
          "title": "Account/rateLimits/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "account/sendAddCreditsNudgeEmail"
              ],
              "title": "Account/sendAddCreditsNudgeEmailRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/SendAddCreditsNudgeEmailParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Account/sendAddCreditsNudgeEmailRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "feedback/upload"
              ],
              "title": "Feedback/uploadRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FeedbackUploadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Feedback/uploadRequest",
          "type": "object"
        },
        {
          "description": "Execute a standalone command (argv vector) under the server's sandbox.",
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "command/exec"
              ],
              "title": "Command/execRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CommandExecParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Command/execRequest",
          "type": "object"
        },
        {
          "description": "Write stdin bytes to a running `command/exec` session or close stdin.",
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "command/exec/write"
              ],
              "title": "Command/exec/writeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CommandExecWriteParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Command/exec/writeRequest",
          "type": "object"
        },
        {
          "description": "Terminate a running `command/exec` session by client-supplied `processId`.",
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "command/exec/terminate"
              ],
              "title": "Command/exec/terminateRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CommandExecTerminateParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Command/exec/terminateRequest",
          "type": "object"
        },
        {
          "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.",
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "command/exec/resize"
              ],
              "title": "Command/exec/resizeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CommandExecResizeParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Command/exec/resizeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "config/read"
              ],
              "title": "Config/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ConfigReadParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Config/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "externalAgentConfig/detect"
              ],
              "title": "ExternalAgentConfig/detectRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ExternalAgentConfigDetectParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "ExternalAgentConfig/detectRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "externalAgentConfig/import"
              ],
              "title": "ExternalAgentConfig/importRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ExternalAgentConfigImportParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "ExternalAgentConfig/importRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "config/value/write"
              ],
              "title": "Config/value/writeRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ConfigValueWriteParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Config/value/writeRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "config/batchWrite"
              ],
              "title": "Config/batchWriteRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ConfigBatchWriteParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Config/batchWriteRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "configRequirements/read"
              ],
              "title": "ConfigRequirements/readRequestMethod",
              "type": "string"
            },
            "params": {
              "type": "null"
            }
          },
          "required": [
            "id",
            "method"
          ],
          "title": "ConfigRequirements/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "account/read"
              ],
              "title": "Account/readRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/GetAccountParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "Account/readRequest",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "$ref": "#/definitions/RequestId"
            },
            "method": {
              "enum": [
                "fuzzyFileSearch"
              ],
              "title": "FuzzyFileSearchRequestMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FuzzyFileSearchParams"
            }
          },
          "required": [
            "id",
            "method",
            "params"
          ],
          "title": "FuzzyFileSearchRequest",
          "type": "object"
        }
      ],
      "title": "ClientRequest"
    },
    "CodexErrorInfo": {
      "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
      "oneOf": [
        {
          "enum": [
            "contextWindowExceeded",
            "usageLimitExceeded",
            "serverOverloaded",
            "cyberPolicy",
            "internalServerError",
            "unauthorized",
            "badRequest",
            "threadRollbackFailed",
            "sandboxError",
            "other"
          ],
          "type": "string"
        },
        {
          "additionalProperties": false,
          "properties": {
            "httpConnectionFailed": {
              "properties": {
                "httpStatusCode": {
                  "format": "uint16",
                  "minimum": 0.0,
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "type": "object"
            }
          },
          "required": [
            "httpConnectionFailed"
          ],
          "title": "HttpConnectionFailedCodexErrorInfo",
          "type": "object"
        },
        {
          "additionalProperties": false,
          "description": "Failed to connect to the response SSE stream.",
          "properties": {
            "responseStreamConnectionFailed": {
              "properties": {
                "httpStatusCode": {
                  "format": "uint16",
                  "minimum": 0.0,
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "type": "object"
            }
          },
          "required": [
            "responseStreamConnectionFailed"
          ],
          "title": "ResponseStreamConnectionFailedCodexErrorInfo",
          "type": "object"
        },
        {
          "additionalProperties": false,
          "description": "The response SSE stream disconnected in the middle of a turn before completion.",
          "properties": {
            "responseStreamDisconnected": {
              "properties": {
                "httpStatusCode": {
                  "format": "uint16",
                  "minimum": 0.0,
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "type": "object"
            }
          },
          "required": [
            "responseStreamDisconnected"
          ],
          "title": "ResponseStreamDisconnectedCodexErrorInfo",
          "type": "object"
        },
        {
          "additionalProperties": false,
          "description": "Reached the retry limit for responses.",
          "properties": {
            "responseTooManyFailedAttempts": {
              "properties": {
                "httpStatusCode": {
                  "format": "uint16",
                  "minimum": 0.0,
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "type": "object"
            }
          },
          "required": [
            "responseTooManyFailedAttempts"
          ],
          "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
          "type": "object"
        },
        {
          "additionalProperties": false,
          "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.",
          "properties": {
            "activeTurnNotSteerable": {
              "properties": {
                "turnKind": {
                  "$ref": "#/definitions/NonSteerableTurnKind"
                }
              },
              "required": [
                "turnKind"
              ],
              "type": "object"
            }
          },
          "required": [
            "activeTurnNotSteerable"
          ],
          "title": "ActiveTurnNotSteerableCodexErrorInfo",
          "type": "object"
        }
      ]
    },
    "CollabAgentState": {
      "properties": {
        "message": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "$ref": "#/definitions/CollabAgentStatus"
        }
      },
      "required": [
        "status"
      ],
      "type": "object"
    },
    "CollabAgentStatus": {
      "enum": [
        "pendingInit",
        "running",
        "interrupted",
        "completed",
        "errored",
        "shutdown",
        "notFound"
      ],
      "type": "string"
    },
    "CollabAgentTool": {
      "enum": [
        "spawnAgent",
        "sendInput",
        "resumeAgent",
        "wait",
        "closeAgent"
      ],
      "type": "string"
    },
    "CollabAgentToolCallStatus": {
      "enum": [
        "inProgress",
        "completed",
        "failed"
      ],
      "type": "string"
    },
    "CollaborationMode": {
      "description": "Collaboration mode for a Codex session.",
      "properties": {
        "mode": {
          "$ref": "#/definitions/ModeKind"
        },
        "settings": {
          "$ref": "#/definitions/Settings"
        }
      },
      "required": [
        "mode",
        "settings"
      ],
      "type": "object"
    },
    "CollaborationModeMask": {
      "description": "EXPERIMENTAL - collaboration mode preset metadata for clients.",
      "properties": {
        "mode": {
          "anyOf": [
            {
              "$ref": "#/definitions/ModeKind"
            },
            {
              "type": "null"
            }
          ]
        },
        "model": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "reasoning_effort": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/definitions/ReasoningEffort"
                },
                {
                  "type": "null"
                }
              ]
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "CommandAction": {
      "oneOf": [
        {
          "properties": {
            "command": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "path": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "read"
              ],
              "title": "ReadCommandActionType",
              "type": "string"
            }
          },
          "required": [
            "command",
            "name",
            "path",
            "type"
          ],
          "title": "ReadCommandAction",
          "type": "object"
        },
        {
          "properties": {
            "command": {
              "type": "string"
            },
            "path": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "listFiles"
              ],
              "title": "ListFilesCommandActionType",
              "type": "string"
            }
          },
          "required": [
            "command",
            "type"
          ],
          "title": "ListFilesCommandAction",
          "type": "object"
        },
        {
          "properties": {
            "command": {
              "type": "string"
            },
            "path": {
              "type": [
                "string",
                "null"
              ]
            },
            "query": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "search"
              ],
              "title": "SearchCommandActionType",
              "type": "string"
            }
          },
          "required": [
            "command",
            "type"
          ],
          "title": "SearchCommandAction",
          "type": "object"
        },
        {
          "properties": {
            "command": {
              "type": "string"
            },
            "type": {
              "enum": [
                "unknown"
              ],
              "title": "UnknownCommandActionType",
              "type": "string"
            }
          },
          "required": [
            "command",
            "type"
          ],
          "title": "UnknownCommandAction",
          "type": "object"
        }
      ]
    },
    "CommandExecOutputDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "CommandExecOutputDeltaNotification",
      "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"
        }
      ]
    },
    "CommandExecParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.",
      "properties": {
        "command": {
          "description": "Command argv vector. Empty arrays are rejected.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "cwd": {
          "description": "Optional working directory. Defaults to the server cwd.",
          "type": [
            "string",
            "null"
          ]
        },
        "disableOutputCap": {
          "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.",
          "type": "boolean"
        },
        "disableTimeout": {
          "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.",
          "type": "boolean"
        },
        "env": {
          "additionalProperties": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.",
          "type": [
            "object",
            "null"
          ]
        },
        "outputBytesCap": {
          "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.",
          "format": "uint",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        },
        "processId": {
          "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.",
          "type": [
            "string",
            "null"
          ]
        },
        "sandboxPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxPolicy"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted. Cannot be combined with `permissionProfile`."
        },
        "size": {
          "anyOf": [
            {
              "$ref": "#/definitions/CommandExecTerminalSize"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional initial PTY size in character cells. Only valid when `tty` is true."
        },
        "streamStdin": {
          "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.",
          "type": "boolean"
        },
        "streamStdoutStderr": {
          "description": "Stream stdout/stderr via `command/exec/outputDelta` notifications.\n\nStreamed bytes are not duplicated into the final response and require a client-supplied `processId`.",
          "type": "boolean"
        },
        "timeoutMs": {
          "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "tty": {
          "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.",
          "type": "boolean"
        }
      },
      "required": [
        "command"
      ],
      "title": "CommandExecParams",
      "type": "object"
    },
    "CommandExecResizeParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Resize a running PTY-backed `command/exec` session.",
      "properties": {
        "processId": {
          "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.",
          "type": "string"
        },
        "size": {
          "allOf": [
            {
              "$ref": "#/definitions/CommandExecTerminalSize"
            }
          ],
          "description": "New PTY size in character cells."
        }
      },
      "required": [
        "processId",
        "size"
      ],
      "title": "CommandExecResizeParams",
      "type": "object"
    },
    "CommandExecResizeResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Empty success response for `command/exec/resize`.",
      "title": "CommandExecResizeResponse",
      "type": "object"
    },
    "CommandExecResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Final buffered result for `command/exec`.",
      "properties": {
        "exitCode": {
          "description": "Process exit code.",
          "format": "int32",
          "type": "integer"
        },
        "stderr": {
          "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.",
          "type": "string"
        },
        "stdout": {
          "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `command/exec/outputDelta`.",
          "type": "string"
        }
      },
      "required": [
        "exitCode",
        "stderr",
        "stdout"
      ],
      "title": "CommandExecResponse",
      "type": "object"
    },
    "CommandExecTerminalSize": {
      "description": "PTY size in character cells for `command/exec` PTY sessions.",
      "properties": {
        "cols": {
          "description": "Terminal width in character cells.",
          "format": "uint16",
          "minimum": 0.0,
          "type": "integer"
        },
        "rows": {
          "description": "Terminal height in character cells.",
          "format": "uint16",
          "minimum": 0.0,
          "type": "integer"
        }
      },
      "required": [
        "cols",
        "rows"
      ],
      "type": "object"
    },
    "CommandExecTerminateParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Terminate a running `command/exec` session.",
      "properties": {
        "processId": {
          "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.",
          "type": "string"
        }
      },
      "required": [
        "processId"
      ],
      "title": "CommandExecTerminateParams",
      "type": "object"
    },
    "CommandExecTerminateResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Empty success response for `command/exec/terminate`.",
      "title": "CommandExecTerminateResponse",
      "type": "object"
    },
    "CommandExecWriteParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.",
      "properties": {
        "closeStdin": {
          "description": "Close stdin after writing `deltaBase64`, if present.",
          "type": "boolean"
        },
        "deltaBase64": {
          "description": "Optional base64-encoded stdin bytes to write.",
          "type": [
            "string",
            "null"
          ]
        },
        "processId": {
          "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.",
          "type": "string"
        }
      },
      "required": [
        "processId"
      ],
      "title": "CommandExecWriteParams",
      "type": "object"
    },
    "CommandExecWriteResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Empty success response for `command/exec/write`.",
      "title": "CommandExecWriteResponse",
      "type": "object"
    },
    "CommandExecutionOutputDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "delta": {
          "type": "string"
        },
        "itemId": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "delta",
        "itemId",
        "threadId",
        "turnId"
      ],
      "title": "CommandExecutionOutputDeltaNotification",
      "type": "object"
    },
    "CommandExecutionSource": {
      "enum": [
        "agent",
        "userShell",
        "unifiedExecStartup",
        "unifiedExecInteraction"
      ],
      "type": "string"
    },
    "CommandExecutionStatus": {
      "enum": [
        "inProgress",
        "completed",
        "failed",
        "declined"
      ],
      "type": "string"
    },
    "CommandMigration": {
      "properties": {
        "name": {
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "Config": {
      "additionalProperties": true,
      "properties": {
        "analytics": {
          "anyOf": [
            {
              "$ref": "#/definitions/AnalyticsConfig"
            },
            {
              "type": "null"
            }
          ]
        },
        "approval_policy": {
          "anyOf": [
            {
              "$ref": "#/definitions/AskForApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "approvals_reviewer": {
          "anyOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            },
            {
              "type": "null"
            }
          ],
          "description": "[UNSTABLE] Optional default for where approval requests are routed for review."
        },
        "compact_prompt": {
          "type": [
            "string",
            "null"
          ]
        },
        "developer_instructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "forced_chatgpt_workspace_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "forced_login_method": {
          "anyOf": [
            {
              "$ref": "#/definitions/ForcedLoginMethod"
            },
            {
              "type": "null"
            }
          ]
        },
        "instructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "model": {
          "type": [
            "string",
            "null"
          ]
        },
        "model_auto_compact_token_limit": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "model_context_window": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "model_provider": {
          "type": [
            "string",
            "null"
          ]
        },
        "model_reasoning_effort": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningEffort"
            },
            {
              "type": "null"
            }
          ]
        },
        "model_reasoning_summary": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningSummary"
            },
            {
              "type": "null"
            }
          ]
        },
        "model_verbosity": {
          "anyOf": [
            {
              "$ref": "#/definitions/Verbosity"
            },
            {
              "type": "null"
            }
          ]
        },
        "profile": {
          "type": [
            "string",
            "null"
          ]
        },
        "profiles": {
          "additionalProperties": {
            "$ref": "#/definitions/ProfileV2"
          },
          "default": {},
          "type": "object"
        },
        "review_model": {
          "type": [
            "string",
            "null"
          ]
        },
        "sandbox_mode": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxMode"
            },
            {
              "type": "null"
            }
          ]
        },
        "sandbox_workspace_write": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxWorkspaceWrite"
            },
            {
              "type": "null"
            }
          ]
        },
        "service_tier": {
          "anyOf": [
            {
              "$ref": "#/definitions/ServiceTier"
            },
            {
              "type": "null"
            }
          ]
        },
        "tools": {
          "anyOf": [
            {
              "$ref": "#/definitions/ToolsV2"
            },
            {
              "type": "null"
            }
          ]
        },
        "web_search": {
          "anyOf": [
            {
              "$ref": "#/definitions/WebSearchMode"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    },
    "ConfigBatchWriteParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "edits": {
          "items": {
            "$ref": "#/definitions/ConfigEdit"
          },
          "type": "array"
        },
        "expectedVersion": {
          "type": [
            "string",
            "null"
          ]
        },
        "filePath": {
          "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
          "type": [
            "string",
            "null"
          ]
        },
        "reloadUserConfig": {
          "description": "When true, hot-reload the updated user config into all loaded threads after writing.",
          "type": "boolean"
        }
      },
      "required": [
        "edits"
      ],
      "title": "ConfigBatchWriteParams",
      "type": "object"
    },
    "ConfigEdit": {
      "properties": {
        "keyPath": {
          "type": "string"
        },
        "mergeStrategy": {
          "$ref": "#/definitions/MergeStrategy"
        },
        "value": true
      },
      "required": [
        "keyPath",
        "mergeStrategy",
        "value"
      ],
      "type": "object"
    },
    "ConfigLayer": {
      "properties": {
        "config": true,
        "disabledReason": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "$ref": "#/definitions/ConfigLayerSource"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "config",
        "name",
        "version"
      ],
      "type": "object"
    },
    "ConfigLayerMetadata": {
      "properties": {
        "name": {
          "$ref": "#/definitions/ConfigLayerSource"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "version"
      ],
      "type": "object"
    },
    "ConfigLayerSource": {
      "oneOf": [
        {
          "description": "Managed preferences layer delivered by MDM (macOS only).",
          "properties": {
            "domain": {
              "type": "string"
            },
            "key": {
              "type": "string"
            },
            "type": {
              "enum": [
                "mdm"
              ],
              "title": "MdmConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "domain",
            "key",
            "type"
          ],
          "title": "MdmConfigLayerSource",
          "type": "object"
        },
        {
          "description": "Managed config layer from a file (usually `managed_config.toml`).",
          "properties": {
            "file": {
              "allOf": [
                {
                  "$ref": "#/definitions/AbsolutePathBuf"
                }
              ],
              "description": "This is the path to the system config.toml file, though it is not guaranteed to exist."
            },
            "type": {
              "enum": [
                "system"
              ],
              "title": "SystemConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "file",
            "type"
          ],
          "title": "SystemConfigLayerSource",
          "type": "object"
        },
        {
          "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory",
          "properties": {
            "file": {
              "allOf": [
                {
                  "$ref": "#/definitions/AbsolutePathBuf"
                }
              ],
              "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist."
            },
            "type": {
              "enum": [
                "user"
              ],
              "title": "UserConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "file",
            "type"
          ],
          "title": "UserConfigLayerSource",
          "type": "object"
        },
        {
          "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.",
          "properties": {
            "dotCodexFolder": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "project"
              ],
              "title": "ProjectConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "dotCodexFolder",
            "type"
          ],
          "title": "ProjectConfigLayerSource",
          "type": "object"
        },
        {
          "description": "Session-layer overrides supplied via `-c`/`--config`.",
          "properties": {
            "type": {
              "enum": [
                "sessionFlags"
              ],
              "title": "SessionFlagsConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "SessionFlagsConfigLayerSource",
          "type": "object"
        },
        {
          "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.",
          "properties": {
            "file": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "legacyManagedConfigTomlFromFile"
              ],
              "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "file",
            "type"
          ],
          "title": "LegacyManagedConfigTomlFromFileConfigLayerSource",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "legacyManagedConfigTomlFromMdm"
              ],
              "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource",
          "type": "object"
        }
      ]
    },
    "ConfigReadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cwd": {
          "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).",
          "type": [
            "string",
            "null"
          ]
        },
        "includeLayers": {
          "default": false,
          "type": "boolean"
        }
      },
      "title": "ConfigReadParams",
      "type": "object"
    },
    "ConfigReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "config": {
          "$ref": "#/definitions/Config"
        },
        "layers": {
          "items": {
            "$ref": "#/definitions/ConfigLayer"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "origins": {
          "additionalProperties": {
            "$ref": "#/definitions/ConfigLayerMetadata"
          },
          "type": "object"
        }
      },
      "required": [
        "config",
        "origins"
      ],
      "title": "ConfigReadResponse",
      "type": "object"
    },
    "ConfigRequirements": {
      "properties": {
        "allowedApprovalPolicies": {
          "items": {
            "$ref": "#/definitions/AskForApproval"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "allowedSandboxModes": {
          "items": {
            "$ref": "#/definitions/SandboxMode"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "allowedWebSearchModes": {
          "items": {
            "$ref": "#/definitions/WebSearchMode"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "enforceResidency": {
          "anyOf": [
            {
              "$ref": "#/definitions/ResidencyRequirement"
            },
            {
              "type": "null"
            }
          ]
        },
        "featureRequirements": {
          "additionalProperties": {
            "type": "boolean"
          },
          "type": [
            "object",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "ConfigRequirementsReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "requirements": {
          "anyOf": [
            {
              "$ref": "#/definitions/ConfigRequirements"
            },
            {
              "type": "null"
            }
          ],
          "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)."
        }
      },
      "title": "ConfigRequirementsReadResponse",
      "type": "object"
    },
    "ConfigValueWriteParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "expectedVersion": {
          "type": [
            "string",
            "null"
          ]
        },
        "filePath": {
          "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
          "type": [
            "string",
            "null"
          ]
        },
        "keyPath": {
          "type": "string"
        },
        "mergeStrategy": {
          "$ref": "#/definitions/MergeStrategy"
        },
        "value": true
      },
      "required": [
        "keyPath",
        "mergeStrategy",
        "value"
      ],
      "title": "ConfigValueWriteParams",
      "type": "object"
    },
    "ConfigWarningNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "ConfigWarningNotification",
      "type": "object"
    },
    "ConfigWriteResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "filePath": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Canonical path to the config file that was written."
        },
        "overriddenMetadata": {
          "anyOf": [
            {
              "$ref": "#/definitions/OverriddenMetadata"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "$ref": "#/definitions/WriteStatus"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "filePath",
        "status",
        "version"
      ],
      "title": "ConfigWriteResponse",
      "type": "object"
    },
    "ConfiguredHookHandler": {
      "oneOf": [
        {
          "properties": {
            "async": {
              "type": "boolean"
            },
            "command": {
              "type": "string"
            },
            "statusMessage": {
              "type": [
                "string",
                "null"
              ]
            },
            "timeoutSec": {
              "format": "uint64",
              "minimum": 0.0,
              "type": [
                "integer",
                "null"
              ]
            },
            "type": {
              "enum": [
                "command"
              ],
              "title": "CommandConfiguredHookHandlerType",
              "type": "string"
            }
          },
          "required": [
            "async",
            "command",
            "type"
          ],
          "title": "CommandConfiguredHookHandler",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "prompt"
              ],
              "title": "PromptConfiguredHookHandlerType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "PromptConfiguredHookHandler",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "agent"
              ],
              "title": "AgentConfiguredHookHandlerType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "AgentConfiguredHookHandler",
          "type": "object"
        }
      ]
    },
    "ConfiguredHookMatcherGroup": {
      "properties": {
        "hooks": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookHandler"
          },
          "type": "array"
        },
        "matcher": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "hooks"
      ],
      "type": "object"
    },
    "ContentItem": {
      "oneOf": [
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "input_text"
              ],
              "title": "InputTextContentItemType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "InputTextContentItem",
          "type": "object"
        },
        {
          "properties": {
            "detail": {
              "anyOf": [
                {
                  "$ref": "#/definitions/ImageDetail"
                },
                {
                  "type": "null"
                }
              ]
            },
            "image_url": {
              "type": "string"
            },
            "type": {
              "enum": [
                "input_image"
              ],
              "title": "InputImageContentItemType",
              "type": "string"
            }
          },
          "required": [
            "image_url",
            "type"
          ],
          "title": "InputImageContentItem",
          "type": "object"
        },
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "output_text"
              ],
              "title": "OutputTextContentItemType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "OutputTextContentItem",
          "type": "object"
        }
      ]
    },
    "ContextCompactedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Deprecated: Use `ContextCompaction` item type instead.",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "threadId",
        "turnId"
      ],
      "title": "ContextCompactedNotification",
      "type": "object"
    },
    "CreditsSnapshot": {
      "properties": {
        "balance": {
          "type": [
            "string",
            "null"
          ]
        },
        "hasCredits": {
          "type": "boolean"
        },
        "unlimited": {
          "type": "boolean"
        }
      },
      "required": [
        "hasCredits",
        "unlimited"
      ],
      "type": "object"
    },
    "DeprecationNoticeNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "DeprecationNoticeNotification",
      "type": "object"
    },
    "DeviceKeyAlgorithm": {
      "description": "Device-key algorithm reported at enrollment and signing boundaries.",
      "enum": [
        "ecdsa_p256_sha256"
      ],
      "type": "string"
    },
    "DeviceKeyCreateParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Create a controller-local device key with a random key id.",
      "properties": {
        "accountUserId": {
          "type": "string"
        },
        "clientId": {
          "type": "string"
        },
        "protectionPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/DeviceKeyProtectionPolicy"
            },
            {
              "type": "null"
            }
          ],
          "description": "Defaults to `hardware_only` when omitted."
        }
      },
      "required": [
        "accountUserId",
        "clientId"
      ],
      "title": "DeviceKeyCreateParams",
      "type": "object"
    },
    "DeviceKeyCreateResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Device-key metadata and public key returned by create/public APIs.",
      "properties": {
        "algorithm": {
          "$ref": "#/definitions/DeviceKeyAlgorithm"
        },
        "keyId": {
          "type": "string"
        },
        "protectionClass": {
          "$ref": "#/definitions/DeviceKeyProtectionClass"
        },
        "publicKeySpkiDerBase64": {
          "description": "SubjectPublicKeyInfo DER encoded as base64.",
          "type": "string"
        }
      },
      "required": [
        "algorithm",
        "keyId",
        "protectionClass",
        "publicKeySpkiDerBase64"
      ],
      "title": "DeviceKeyCreateResponse",
      "type": "object"
    },
    "DeviceKeyProtectionClass": {
      "description": "Platform protection class for a controller-local device key.",
      "enum": [
        "hardware_secure_enclave",
        "hardware_tpm",
        "os_protected_nonextractable"
      ],
      "type": "string"
    },
    "DeviceKeyProtectionPolicy": {
      "description": "Protection policy for creating or loading a controller-local device key.",
      "enum": [
        "hardware_only",
        "allow_os_protected_nonextractable"
      ],
      "type": "string"
    },
    "DeviceKeyPublicParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Fetch a controller-local device key public key by id.",
      "properties": {
        "keyId": {
          "type": "string"
        }
      },
      "required": [
        "keyId"
      ],
      "title": "DeviceKeyPublicParams",
      "type": "object"
    },
    "DeviceKeyPublicResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Device-key public metadata returned by `device/key/public`.",
      "properties": {
        "algorithm": {
          "$ref": "#/definitions/DeviceKeyAlgorithm"
        },
        "keyId": {
          "type": "string"
        },
        "protectionClass": {
          "$ref": "#/definitions/DeviceKeyProtectionClass"
        },
        "publicKeySpkiDerBase64": {
          "description": "SubjectPublicKeyInfo DER encoded as base64.",
          "type": "string"
        }
      },
      "required": [
        "algorithm",
        "keyId",
        "protectionClass",
        "publicKeySpkiDerBase64"
      ],
      "title": "DeviceKeyPublicResponse",
      "type": "object"
    },
    "DeviceKeySignParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Sign an accepted structured payload with a controller-local device key.",
      "properties": {
        "keyId": {
          "type": "string"
        },
        "payload": {
          "$ref": "#/definitions/DeviceKeySignPayload"
        }
      },
      "required": [
        "keyId",
        "payload"
      ],
      "title": "DeviceKeySignParams",
      "type": "object"
    },
    "DeviceKeySignPayload": {
      "description": "Structured payloads accepted by `device/key/sign`.",
      "oneOf": [
        {
          "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.",
          "properties": {
            "accountUserId": {
              "type": "string"
            },
            "audience": {
              "$ref": "#/definitions/RemoteControlClientConnectionAudience"
            },
            "clientId": {
              "type": "string"
            },
            "nonce": {
              "type": "string"
            },
            "scopes": {
              "description": "Must contain exactly `remote_control_controller_websocket`.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "sessionId": {
              "description": "Backend-issued websocket session id that this proof authorizes.",
              "type": "string"
            },
            "targetOrigin": {
              "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.",
              "type": "string"
            },
            "targetPath": {
              "description": "Websocket route path that this proof authorizes.",
              "type": "string"
            },
            "tokenExpiresAt": {
              "description": "Remote-control token expiration as Unix seconds.",
              "format": "int64",
              "type": "integer"
            },
            "tokenSha256Base64url": {
              "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.",
              "type": "string"
            },
            "type": {
              "enum": [
                "remoteControlClientConnection"
              ],
              "title": "RemoteControlClientConnectionDeviceKeySignPayloadType",
              "type": "string"
            }
          },
          "required": [
            "accountUserId",
            "audience",
            "clientId",
            "nonce",
            "scopes",
            "sessionId",
            "targetOrigin",
            "targetPath",
            "tokenExpiresAt",
            "tokenSha256Base64url",
            "type"
          ],
          "title": "RemoteControlClientConnectionDeviceKeySignPayload",
          "type": "object"
        },
        {
          "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.",
          "properties": {
            "accountUserId": {
              "type": "string"
            },
            "audience": {
              "$ref": "#/definitions/RemoteControlClientEnrollmentAudience"
            },
            "challengeExpiresAt": {
              "description": "Enrollment challenge expiration as Unix seconds.",
              "format": "int64",
              "type": "integer"
            },
            "challengeId": {
              "description": "Backend-issued enrollment challenge id that this proof authorizes.",
              "type": "string"
            },
            "clientId": {
              "type": "string"
            },
            "deviceIdentitySha256Base64url": {
              "description": "SHA-256 of the requested device identity operation, encoded as unpadded base64url.",
              "type": "string"
            },
            "nonce": {
              "type": "string"
            },
            "targetOrigin": {
              "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.",
              "type": "string"
            },
            "targetPath": {
              "description": "HTTP route path that this proof authorizes.",
              "type": "string"
            },
            "type": {
              "enum": [
                "remoteControlClientEnrollment"
              ],
              "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType",
              "type": "string"
            }
          },
          "required": [
            "accountUserId",
            "audience",
            "challengeExpiresAt",
            "challengeId",
            "clientId",
            "deviceIdentitySha256Base64url",
            "nonce",
            "targetOrigin",
            "targetPath",
            "type"
          ],
          "title": "RemoteControlClientEnrollmentDeviceKeySignPayload",
          "type": "object"
        }
      ]
    },
    "DeviceKeySignResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "ASN.1 DER signature returned by `device/key/sign`.",
      "properties": {
        "algorithm": {
          "$ref": "#/definitions/DeviceKeyAlgorithm"
        },
        "signatureDerBase64": {
          "description": "ECDSA signature DER encoded as base64.",
          "type": "string"
        },
        "signedPayloadBase64": {
          "description": "Exact bytes signed by the device key, encoded as base64. Verifiers must verify this byte string directly and must not reserialize `payload`.",
          "type": "string"
        }
      },
      "required": [
        "algorithm",
        "signatureDerBase64",
        "signedPayloadBase64"
      ],
      "title": "DeviceKeySignResponse",
      "type": "object"
    },
    "DynamicToolCallOutputContentItem": {
      "oneOf": [
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "inputText"
              ],
              "title": "InputTextDynamicToolCallOutputContentItemType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "InputTextDynamicToolCallOutputContentItem",
          "type": "object"
        },
        {
          "properties": {
            "imageUrl": {
              "type": "string"
            },
            "type": {
              "enum": [
                "inputImage"
              ],
              "title": "InputImageDynamicToolCallOutputContentItemType",
              "type": "string"
            }
          },
          "required": [
            "imageUrl",
            "type"
          ],
          "title": "InputImageDynamicToolCallOutputContentItem",
          "type": "object"
        }
      ]
    },
    "DynamicToolCallStatus": {
      "enum": [
        "inProgress",
        "completed",
        "failed"
      ],
      "type": "string"
    },
    "DynamicToolSpec": {
      "properties": {
        "deferLoading": {
          "type": "boolean"
        },
        "description": {
          "type": "string"
        },
        "inputSchema": true,
        "name": {
          "type": "string"
        },
        "namespace": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "description",
        "inputSchema",
        "name"
      ],
      "type": "object"
    },
    "ErrorNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "error": {
          "$ref": "#/definitions/TurnError"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        },
        "willRetry": {
          "type": "boolean"
        }
      },
      "required": [
        "error",
        "threadId",
        "turnId",
        "willRetry"
      ],
      "title": "ErrorNotification",
      "type": "object"
    },
    "ExperimentalFeature": {
      "properties": {
        "announcement": {
          "description": "Announcement copy shown to users when the feature is introduced. Null when this feature is not in beta.",
          "type": [
            "string",
            "null"
          ]
        },
        "defaultEnabled": {
          "description": "Whether this feature is enabled by default.",
          "type": "boolean"
        },
        "description": {
          "description": "Short summary describing what the feature does. Null when this feature is not in beta.",
          "type": [
            "string",
            "null"
          ]
        },
        "displayName": {
          "description": "User-facing display name shown in the experimental features UI. Null when this feature is not in beta.",
          "type": [
            "string",
            "null"
          ]
        },
        "enabled": {
          "description": "Whether this feature is currently enabled in the loaded config.",
          "type": "boolean"
        },
        "name": {
          "description": "Stable key used in config.toml and CLI flag toggles.",
          "type": "string"
        },
        "stage": {
          "allOf": [
            {
              "$ref": "#/definitions/ExperimentalFeatureStage"
            }
          ],
          "description": "Lifecycle stage of this feature flag."
        }
      },
      "required": [
        "defaultEnabled",
        "enabled",
        "name",
        "stage"
      ],
      "type": "object"
    },
    "ExperimentalFeatureEnablementSetParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "enablement": {
          "additionalProperties": {
            "type": "boolean"
          },
          "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.",
          "type": "object"
        }
      },
      "required": [
        "enablement"
      ],
      "title": "ExperimentalFeatureEnablementSetParams",
      "type": "object"
    },
    "ExperimentalFeatureEnablementSetResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "enablement": {
          "additionalProperties": {
            "type": "boolean"
          },
          "description": "Feature enablement entries updated by this request.",
          "type": "object"
        }
      },
      "required": [
        "enablement"
      ],
      "title": "ExperimentalFeatureEnablementSetResponse",
      "type": "object"
    },
    "ExperimentalFeatureListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous call.",
          "type": [
            "string",
            "null"
          ]
        },
        "limit": {
          "description": "Optional page size; defaults to a reasonable server-side value.",
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "title": "ExperimentalFeatureListParams",
      "type": "object"
    },
    "ExperimentalFeatureListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/ExperimentalFeature"
          },
          "type": "array"
        },
        "nextCursor": {
          "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "data"
      ],
      "title": "ExperimentalFeatureListResponse",
      "type": "object"
    },
    "ExperimentalFeatureStage": {
      "oneOf": [
        {
          "description": "Feature is available for user testing and feedback.",
          "enum": [
            "beta"
          ],
          "type": "string"
        },
        {
          "description": "Feature is still being built and not ready for broad use.",
          "enum": [
            "underDevelopment"
          ],
          "type": "string"
        },
        {
          "description": "Feature is production-ready.",
          "enum": [
            "stable"
          ],
          "type": "string"
        },
        {
          "description": "Feature is deprecated and should be avoided.",
          "enum": [
            "deprecated"
          ],
          "type": "string"
        },
        {
          "description": "Feature flag is retained only for backwards compatibility.",
          "enum": [
            "removed"
          ],
          "type": "string"
        }
      ]
    },
    "ExternalAgentConfigDetectParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cwds": {
          "description": "Zero or more working directories to include for repo-scoped detection.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "includeHome": {
          "description": "If true, include detection under the user's home (~/.claude, ~/.codex, etc.).",
          "type": "boolean"
        }
      },
      "title": "ExternalAgentConfigDetectParams",
      "type": "object"
    },
    "ExternalAgentConfigDetectResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "items": {
          "items": {
            "$ref": "#/definitions/ExternalAgentConfigMigrationItem"
          },
          "type": "array"
        }
      },
      "required": [
        "items"
      ],
      "title": "ExternalAgentConfigDetectResponse",
      "type": "object"
    },
    "ExternalAgentConfigImportCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ExternalAgentConfigImportCompletedNotification",
      "type": "object"
    },
    "ExternalAgentConfigImportParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "migrationItems": {
          "items": {
            "$ref": "#/definitions/ExternalAgentConfigMigrationItem"
          },
          "type": "array"
        }
      },
      "required": [
        "migrationItems"
      ],
      "title": "ExternalAgentConfigImportParams",
      "type": "object"
    },
    "ExternalAgentConfigImportResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ExternalAgentConfigImportResponse",
      "type": "object"
    },
    "ExternalAgentConfigMigrationItem": {
      "properties": {
        "cwd": {
          "description": "Null or empty means home-scoped migration; non-empty means repo-scoped migration.",
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "type": "string"
        },
        "details": {
          "anyOf": [
            {
              "$ref": "#/definitions/MigrationDetails"
            },
            {
              "type": "null"
            }
          ]
        },
        "itemType": {
          "$ref": "#/definitions/ExternalAgentConfigMigrationItemType"
        }
      },
      "required": [
        "description",
        "itemType"
      ],
      "type": "object"
    },
    "ExternalAgentConfigMigrationItemType": {
      "enum": [
        "AGENTS_MD",
        "CONFIG",
        "SKILLS",
        "PLUGINS",
        "MCP_SERVER_CONFIG",
        "SUBAGENTS",
        "HOOKS",
        "COMMANDS",
        "SESSIONS"
      ],
      "type": "string"
    },
    "FeedbackUploadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "classification": {
          "type": "string"
        },
        "extraLogFiles": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "includeLogs": {
          "type": "boolean"
        },
        "reason": {
          "type": [
            "string",
            "null"
          ]
        },
        "tags": {
          "additionalProperties": {
            "type": "string"
          },
          "type": [
            "object",
            "null"
          ]
        },
        "threadId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "classification",
        "includeLogs"
      ],
      "title": "FeedbackUploadParams",
      "type": "object"
    },
    "FeedbackUploadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "FeedbackUploadResponse",
      "type": "object"
    },
    "FileChangeOutputDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "FileChangeOutputDeltaNotification",
      "type": "object"
    },
    "FileChangePatchUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "changes": {
          "items": {
            "$ref": "#/definitions/FileUpdateChange"
          },
          "type": "array"
        },
        "itemId": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "changes",
        "itemId",
        "threadId",
        "turnId"
      ],
      "title": "FileChangePatchUpdatedNotification",
      "type": "object"
    },
    "FileSystemAccessMode": {
      "enum": [
        "read",
        "write",
        "none"
      ],
      "type": "string"
    },
    "FileSystemPath": {
      "oneOf": [
        {
          "properties": {
            "path": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "path"
              ],
              "title": "PathFileSystemPathType",
              "type": "string"
            }
          },
          "required": [
            "path",
            "type"
          ],
          "title": "PathFileSystemPath",
          "type": "object"
        },
        {
          "properties": {
            "pattern": {
              "type": "string"
            },
            "type": {
              "enum": [
                "glob_pattern"
              ],
              "title": "GlobPatternFileSystemPathType",
              "type": "string"
            }
          },
          "required": [
            "pattern",
            "type"
          ],
          "title": "GlobPatternFileSystemPath",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "special"
              ],
              "title": "SpecialFileSystemPathType",
              "type": "string"
            },
            "value": {
              "$ref": "#/definitions/FileSystemSpecialPath"
            }
          },
          "required": [
            "type",
            "value"
          ],
          "title": "SpecialFileSystemPath",
          "type": "object"
        }
      ]
    },
    "FileSystemSandboxEntry": {
      "properties": {
        "access": {
          "$ref": "#/definitions/FileSystemAccessMode"
        },
        "path": {
          "$ref": "#/definitions/FileSystemPath"
        }
      },
      "required": [
        "access",
        "path"
      ],
      "type": "object"
    },
    "FileSystemSpecialPath": {
      "oneOf": [
        {
          "properties": {
            "kind": {
              "enum": [
                "root"
              ],
              "type": "string"
            }
          },
          "required": [
            "kind"
          ],
          "title": "RootFileSystemSpecialPath",
          "type": "object"
        },
        {
          "properties": {
            "kind": {
              "enum": [
                "minimal"
              ],
              "type": "string"
            }
          },
          "required": [
            "kind"
          ],
          "title": "MinimalFileSystemSpecialPath",
          "type": "object"
        },
        {
          "properties": {
            "kind": {
              "enum": [
                "project_roots"
              ],
              "type": "string"
            },
            "subpath": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "kind"
          ],
          "title": "KindFileSystemSpecialPath",
          "type": "object"
        },
        {
          "properties": {
            "kind": {
              "enum": [
                "tmpdir"
              ],
              "type": "string"
            }
          },
          "required": [
            "kind"
          ],
          "title": "TmpdirFileSystemSpecialPath",
          "type": "object"
        },
        {
          "properties": {
            "kind": {
              "enum": [
                "slash_tmp"
              ],
              "type": "string"
            }
          },
          "required": [
            "kind"
          ],
          "title": "SlashTmpFileSystemSpecialPath",
          "type": "object"
        },
        {
          "properties": {
            "kind": {
              "enum": [
                "unknown"
              ],
              "type": "string"
            },
            "path": {
              "type": "string"
            },
            "subpath": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "kind",
            "path"
          ],
          "type": "object"
        }
      ]
    },
    "FileUpdateChange": {
      "properties": {
        "diff": {
          "type": "string"
        },
        "kind": {
          "$ref": "#/definitions/PatchChangeKind"
        },
        "path": {
          "type": "string"
        }
      },
      "required": [
        "diff",
        "kind",
        "path"
      ],
      "type": "object"
    },
    "ForcedLoginMethod": {
      "enum": [
        "chatgpt",
        "api"
      ],
      "type": "string"
    },
    "FsChangedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "FsChangedNotification",
      "type": "object"
    },
    "FsCopyParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Copy a file or directory tree on the host filesystem.",
      "properties": {
        "destinationPath": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute destination path."
        },
        "recursive": {
          "description": "Required for directory copies; ignored for file copies.",
          "type": "boolean"
        },
        "sourcePath": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute source path."
        }
      },
      "required": [
        "destinationPath",
        "sourcePath"
      ],
      "title": "FsCopyParams",
      "type": "object"
    },
    "FsCopyResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Successful response for `fs/copy`.",
      "title": "FsCopyResponse",
      "type": "object"
    },
    "FsCreateDirectoryParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Create a directory on the host filesystem.",
      "properties": {
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute directory path to create."
        },
        "recursive": {
          "description": "Whether parent directories should also be created. Defaults to `true`.",
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "required": [
        "path"
      ],
      "title": "FsCreateDirectoryParams",
      "type": "object"
    },
    "FsCreateDirectoryResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Successful response for `fs/createDirectory`.",
      "title": "FsCreateDirectoryResponse",
      "type": "object"
    },
    "FsGetMetadataParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Request metadata for an absolute path.",
      "properties": {
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute path to inspect."
        }
      },
      "required": [
        "path"
      ],
      "title": "FsGetMetadataParams",
      "type": "object"
    },
    "FsGetMetadataResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Metadata returned by `fs/getMetadata`.",
      "properties": {
        "createdAtMs": {
          "description": "File creation time in Unix milliseconds when available, otherwise `0`.",
          "format": "int64",
          "type": "integer"
        },
        "isDirectory": {
          "description": "Whether the path resolves to a directory.",
          "type": "boolean"
        },
        "isFile": {
          "description": "Whether the path resolves to a regular file.",
          "type": "boolean"
        },
        "isSymlink": {
          "description": "Whether the path itself is a symbolic link.",
          "type": "boolean"
        },
        "modifiedAtMs": {
          "description": "File modification time in Unix milliseconds when available, otherwise `0`.",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "createdAtMs",
        "isDirectory",
        "isFile",
        "isSymlink",
        "modifiedAtMs"
      ],
      "title": "FsGetMetadataResponse",
      "type": "object"
    },
    "FsReadDirectoryEntry": {
      "description": "A directory entry returned by `fs/readDirectory`.",
      "properties": {
        "fileName": {
          "description": "Direct child entry name only, not an absolute or relative path.",
          "type": "string"
        },
        "isDirectory": {
          "description": "Whether this entry resolves to a directory.",
          "type": "boolean"
        },
        "isFile": {
          "description": "Whether this entry resolves to a regular file.",
          "type": "boolean"
        }
      },
      "required": [
        "fileName",
        "isDirectory",
        "isFile"
      ],
      "type": "object"
    },
    "FsReadDirectoryParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "List direct child names for a directory.",
      "properties": {
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute directory path to read."
        }
      },
      "required": [
        "path"
      ],
      "title": "FsReadDirectoryParams",
      "type": "object"
    },
    "FsReadDirectoryResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Directory entries returned by `fs/readDirectory`.",
      "properties": {
        "entries": {
          "description": "Direct child entries in the requested directory.",
          "items": {
            "$ref": "#/definitions/FsReadDirectoryEntry"
          },
          "type": "array"
        }
      },
      "required": [
        "entries"
      ],
      "title": "FsReadDirectoryResponse",
      "type": "object"
    },
    "FsReadFileParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Read a file from the host filesystem.",
      "properties": {
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute path to read."
        }
      },
      "required": [
        "path"
      ],
      "title": "FsReadFileParams",
      "type": "object"
    },
    "FsReadFileResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Base64-encoded file contents returned by `fs/readFile`.",
      "properties": {
        "dataBase64": {
          "description": "File contents encoded as base64.",
          "type": "string"
        }
      },
      "required": [
        "dataBase64"
      ],
      "title": "FsReadFileResponse",
      "type": "object"
    },
    "FsRemoveParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Remove a file or directory tree from the host filesystem.",
      "properties": {
        "force": {
          "description": "Whether missing paths should be ignored. Defaults to `true`.",
          "type": [
            "boolean",
            "null"
          ]
        },
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute path to remove."
        },
        "recursive": {
          "description": "Whether directory removal should recurse. Defaults to `true`.",
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "required": [
        "path"
      ],
      "title": "FsRemoveParams",
      "type": "object"
    },
    "FsRemoveResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Successful response for `fs/remove`.",
      "title": "FsRemoveResponse",
      "type": "object"
    },
    "FsUnwatchParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Stop filesystem watch notifications for a prior `fs/watch`.",
      "properties": {
        "watchId": {
          "description": "Watch identifier previously provided to `fs/watch`.",
          "type": "string"
        }
      },
      "required": [
        "watchId"
      ],
      "title": "FsUnwatchParams",
      "type": "object"
    },
    "FsUnwatchResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Successful response for `fs/unwatch`.",
      "title": "FsUnwatchResponse",
      "type": "object"
    },
    "FsWatchParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Start filesystem watch notifications for an absolute path.",
      "properties": {
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute file or directory path to watch."
        },
        "watchId": {
          "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.",
          "type": "string"
        }
      },
      "required": [
        "path",
        "watchId"
      ],
      "title": "FsWatchParams",
      "type": "object"
    },
    "FsWatchResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Successful response for `fs/watch`.",
      "properties": {
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Canonicalized path associated with the watch."
        }
      },
      "required": [
        "path"
      ],
      "title": "FsWatchResponse",
      "type": "object"
    },
    "FsWriteFileParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Write a file on the host filesystem.",
      "properties": {
        "dataBase64": {
          "description": "File contents encoded as base64.",
          "type": "string"
        },
        "path": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Absolute path to write."
        }
      },
      "required": [
        "dataBase64",
        "path"
      ],
      "title": "FsWriteFileParams",
      "type": "object"
    },
    "FsWriteFileResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Successful response for `fs/writeFile`.",
      "title": "FsWriteFileResponse",
      "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"
        },
        {
          "properties": {
            "detail": {
              "anyOf": [
                {
                  "$ref": "#/definitions/ImageDetail"
                },
                {
                  "type": "null"
                }
              ]
            },
            "image_url": {
              "type": "string"
            },
            "type": {
              "enum": [
                "input_image"
              ],
              "title": "InputImageFunctionCallOutputContentItemType",
              "type": "string"
            }
          },
          "required": [
            "image_url",
            "type"
          ],
          "title": "InputImageFunctionCallOutputContentItem",
          "type": "object"
        }
      ]
    },
    "FuzzyFileSearchMatchType": {
      "enum": [
        "file",
        "directory"
      ],
      "type": "string"
    },
    "FuzzyFileSearchParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cancellationToken": {
          "type": [
            "string",
            "null"
          ]
        },
        "query": {
          "type": "string"
        },
        "roots": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "query",
        "roots"
      ],
      "title": "FuzzyFileSearchParams",
      "type": "object"
    },
    "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": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "sessionId": {
          "type": "string"
        }
      },
      "required": [
        "sessionId"
      ],
      "title": "FuzzyFileSearchSessionCompletedNotification",
      "type": "object"
    },
    "FuzzyFileSearchSessionUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "files": {
          "items": {
            "$ref": "#/definitions/FuzzyFileSearchResult"
          },
          "type": "array"
        },
        "query": {
          "type": "string"
        },
        "sessionId": {
          "type": "string"
        }
      },
      "required": [
        "files",
        "query",
        "sessionId"
      ],
      "title": "FuzzyFileSearchSessionUpdatedNotification",
      "type": "object"
    },
    "GetAccountParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "refreshToken": {
          "default": false,
          "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.",
          "type": "boolean"
        }
      },
      "title": "GetAccountParams",
      "type": "object"
    },
    "GetAccountRateLimitsResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "rateLimits": {
          "allOf": [
            {
              "$ref": "#/definitions/RateLimitSnapshot"
            }
          ],
          "description": "Backward-compatible single-bucket view; mirrors the historical payload."
        },
        "rateLimitsByLimitId": {
          "additionalProperties": {
            "$ref": "#/definitions/RateLimitSnapshot"
          },
          "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).",
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "rateLimits"
      ],
      "title": "GetAccountRateLimitsResponse",
      "type": "object"
    },
    "GetAccountResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "account": {
          "anyOf": [
            {
              "$ref": "#/definitions/Account"
            },
            {
              "type": "null"
            }
          ]
        },
        "requiresOpenaiAuth": {
          "type": "boolean"
        }
      },
      "required": [
        "requiresOpenaiAuth"
      ],
      "title": "GetAccountResponse",
      "type": "object"
    },
    "GitInfo": {
      "properties": {
        "branch": {
          "type": [
            "string",
            "null"
          ]
        },
        "originUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "sha": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "GuardianApprovalReview": {
      "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.",
      "properties": {
        "rationale": {
          "type": [
            "string",
            "null"
          ]
        },
        "riskLevel": {
          "anyOf": [
            {
              "$ref": "#/definitions/GuardianRiskLevel"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "$ref": "#/definitions/GuardianApprovalReviewStatus"
        },
        "userAuthorization": {
          "anyOf": [
            {
              "$ref": "#/definitions/GuardianUserAuthorization"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "status"
      ],
      "type": "object"
    },
    "GuardianApprovalReviewAction": {
      "oneOf": [
        {
          "properties": {
            "command": {
              "type": "string"
            },
            "cwd": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "source": {
              "$ref": "#/definitions/GuardianCommandSource"
            },
            "type": {
              "enum": [
                "command"
              ],
              "title": "CommandGuardianApprovalReviewActionType",
              "type": "string"
            }
          },
          "required": [
            "command",
            "cwd",
            "source",
            "type"
          ],
          "title": "CommandGuardianApprovalReviewAction",
          "type": "object"
        },
        {
          "properties": {
            "argv": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "cwd": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "program": {
              "type": "string"
            },
            "source": {
              "$ref": "#/definitions/GuardianCommandSource"
            },
            "type": {
              "enum": [
                "execve"
              ],
              "title": "ExecveGuardianApprovalReviewActionType",
              "type": "string"
            }
          },
          "required": [
            "argv",
            "cwd",
            "program",
            "source",
            "type"
          ],
          "title": "ExecveGuardianApprovalReviewAction",
          "type": "object"
        },
        {
          "properties": {
            "cwd": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "files": {
              "items": {
                "$ref": "#/definitions/AbsolutePathBuf"
              },
              "type": "array"
            },
            "type": {
              "enum": [
                "applyPatch"
              ],
              "title": "ApplyPatchGuardianApprovalReviewActionType",
              "type": "string"
            }
          },
          "required": [
            "cwd",
            "files",
            "type"
          ],
          "title": "ApplyPatchGuardianApprovalReviewAction",
          "type": "object"
        },
        {
          "properties": {
            "host": {
              "type": "string"
            },
            "port": {
              "format": "uint16",
              "minimum": 0.0,
              "type": "integer"
            },
            "protocol": {
              "$ref": "#/definitions/NetworkApprovalProtocol"
            },
            "target": {
              "type": "string"
            },
            "type": {
              "enum": [
                "networkAccess"
              ],
              "title": "NetworkAccessGuardianApprovalReviewActionType",
              "type": "string"
            }
          },
          "required": [
            "host",
            "port",
            "protocol",
            "target",
            "type"
          ],
          "title": "NetworkAccessGuardianApprovalReviewAction",
          "type": "object"
        },
        {
          "properties": {
            "connectorId": {
              "type": [
                "string",
                "null"
              ]
            },
            "connectorName": {
              "type": [
                "string",
                "null"
              ]
            },
            "server": {
              "type": "string"
            },
            "toolName": {
              "type": "string"
            },
            "toolTitle": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "mcpToolCall"
              ],
              "title": "McpToolCallGuardianApprovalReviewActionType",
              "type": "string"
            }
          },
          "required": [
            "server",
            "toolName",
            "type"
          ],
          "title": "McpToolCallGuardianApprovalReviewAction",
          "type": "object"
        },
        {
          "properties": {
            "permissions": {
              "$ref": "#/definitions/RequestPermissionProfile"
            },
            "reason": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "requestPermissions"
              ],
              "title": "RequestPermissionsGuardianApprovalReviewActionType",
              "type": "string"
            }
          },
          "required": [
            "permissions",
            "type"
          ],
          "title": "RequestPermissionsGuardianApprovalReviewAction",
          "type": "object"
        }
      ]
    },
    "GuardianApprovalReviewStatus": {
      "description": "[UNSTABLE] Lifecycle state for an approval auto-review.",
      "enum": [
        "inProgress",
        "approved",
        "denied",
        "timedOut",
        "aborted"
      ],
      "type": "string"
    },
    "GuardianCommandSource": {
      "enum": [
        "shell",
        "unifiedExec"
      ],
      "type": "string"
    },
    "GuardianRiskLevel": {
      "description": "[UNSTABLE] Risk level assigned by approval auto-review.",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ],
      "type": "string"
    },
    "GuardianUserAuthorization": {
      "description": "[UNSTABLE] Authorization level assigned by approval auto-review.",
      "enum": [
        "unknown",
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "GuardianWarningNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "GuardianWarningNotification",
      "type": "object"
    },
    "HookCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "run": {
          "$ref": "#/definitions/HookRunSummary"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "run",
        "threadId"
      ],
      "title": "HookCompletedNotification",
      "type": "object"
    },
    "HookErrorInfo": {
      "properties": {
        "message": {
          "type": "string"
        },
        "path": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "path"
      ],
      "type": "object"
    },
    "HookEventName": {
      "enum": [
        "preToolUse",
        "permissionRequest",
        "postToolUse",
        "sessionStart",
        "userPromptSubmit",
        "stop"
      ],
      "type": "string"
    },
    "HookExecutionMode": {
      "enum": [
        "sync",
        "async"
      ],
      "type": "string"
    },
    "HookHandlerType": {
      "enum": [
        "command",
        "prompt",
        "agent"
      ],
      "type": "string"
    },
    "HookMetadata": {
      "properties": {
        "command": {
          "type": [
            "string",
            "null"
          ]
        },
        "displayOrder": {
          "format": "int64",
          "type": "integer"
        },
        "enabled": {
          "type": "boolean"
        },
        "eventName": {
          "$ref": "#/definitions/HookEventName"
        },
        "handlerType": {
          "$ref": "#/definitions/HookHandlerType"
        },
        "isManaged": {
          "type": "boolean"
        },
        "key": {
          "type": "string"
        },
        "matcher": {
          "type": [
            "string",
            "null"
          ]
        },
        "pluginId": {
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "$ref": "#/definitions/HookSource"
        },
        "sourcePath": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "statusMessage": {
          "type": [
            "string",
            "null"
          ]
        },
        "timeoutSec": {
          "format": "uint64",
          "minimum": 0.0,
          "type": "integer"
        }
      },
      "required": [
        "displayOrder",
        "enabled",
        "eventName",
        "handlerType",
        "isManaged",
        "key",
        "source",
        "sourcePath",
        "timeoutSec"
      ],
      "type": "object"
    },
    "HookMigration": {
      "properties": {
        "name": {
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "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",
        "legacyManagedConfigFile",
        "legacyManagedConfigMdm",
        "unknown"
      ],
      "type": "string"
    },
    "HookStartedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "run": {
          "$ref": "#/definitions/HookRunSummary"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "run",
        "threadId"
      ],
      "title": "HookStartedNotification",
      "type": "object"
    },
    "HooksListEntry": {
      "properties": {
        "cwd": {
          "type": "string"
        },
        "errors": {
          "items": {
            "$ref": "#/definitions/HookErrorInfo"
          },
          "type": "array"
        },
        "hooks": {
          "items": {
            "$ref": "#/definitions/HookMetadata"
          },
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "cwd",
        "errors",
        "hooks",
        "warnings"
      ],
      "type": "object"
    },
    "HooksListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cwds": {
          "description": "When empty, defaults to the current session working directory.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "title": "HooksListParams",
      "type": "object"
    },
    "HooksListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/HooksListEntry"
          },
          "type": "array"
        }
      },
      "required": [
        "data"
      ],
      "title": "HooksListResponse",
      "type": "object"
    },
    "ImageDetail": {
      "enum": [
        "auto",
        "low",
        "high",
        "original"
      ],
      "type": "string"
    },
    "InitializeCapabilities": {
      "description": "Client-declared capabilities negotiated during initialize.",
      "properties": {
        "experimentalApi": {
          "default": false,
          "description": "Opt into receiving experimental API methods and fields.",
          "type": "boolean"
        },
        "optOutNotificationMethods": {
          "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "InitializeParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "capabilities": {
          "anyOf": [
            {
              "$ref": "#/definitions/InitializeCapabilities"
            },
            {
              "type": "null"
            }
          ]
        },
        "clientInfo": {
          "$ref": "#/definitions/ClientInfo"
        }
      },
      "required": [
        "clientInfo"
      ],
      "title": "InitializeParams",
      "type": "object"
    },
    "InputModality": {
      "description": "Canonical user-input modality tags advertised by a model.",
      "oneOf": [
        {
          "description": "Plain text turns and tool payloads.",
          "enum": [
            "text"
          ],
          "type": "string"
        },
        {
          "description": "Image attachments included in user turns.",
          "enum": [
            "image"
          ],
          "type": "string"
        }
      ]
    },
    "ItemCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "item": {
          "$ref": "#/definitions/ThreadItem"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "item",
        "threadId",
        "turnId"
      ],
      "title": "ItemCompletedNotification",
      "type": "object"
    },
    "ItemGuardianApprovalReviewCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.",
      "properties": {
        "action": {
          "$ref": "#/definitions/GuardianApprovalReviewAction"
        },
        "decisionSource": {
          "$ref": "#/definitions/AutoReviewDecisionSource"
        },
        "review": {
          "$ref": "#/definitions/GuardianApprovalReview"
        },
        "reviewId": {
          "description": "Stable identifier for this review.",
          "type": "string"
        },
        "targetItemId": {
          "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
          "type": [
            "string",
            "null"
          ]
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "action",
        "decisionSource",
        "review",
        "reviewId",
        "threadId",
        "turnId"
      ],
      "title": "ItemGuardianApprovalReviewCompletedNotification",
      "type": "object"
    },
    "ItemGuardianApprovalReviewStartedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
        },
        "targetItemId": {
          "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
          "type": [
            "string",
            "null"
          ]
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "action",
        "review",
        "reviewId",
        "threadId",
        "turnId"
      ],
      "title": "ItemGuardianApprovalReviewStartedNotification",
      "type": "object"
    },
    "ItemStartedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "item": {
          "$ref": "#/definitions/ThreadItem"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "item",
        "threadId",
        "turnId"
      ],
      "title": "ItemStartedNotification",
      "type": "object"
    },
    "ListMcpServerStatusParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous call.",
          "type": [
            "string",
            "null"
          ]
        },
        "detail": {
          "anyOf": [
            {
              "$ref": "#/definitions/McpServerStatusDetail"
            },
            {
              "type": "null"
            }
          ],
          "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted."
        },
        "limit": {
          "description": "Optional page size; defaults to a server-defined value.",
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "title": "ListMcpServerStatusParams",
      "type": "object"
    },
    "ListMcpServerStatusResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/McpServerStatus"
          },
          "type": "array"
        },
        "nextCursor": {
          "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "data"
      ],
      "title": "ListMcpServerStatusResponse",
      "type": "object"
    },
    "LocalShellAction": {
      "oneOf": [
        {
          "properties": {
            "command": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "env": {
              "additionalProperties": {
                "type": "string"
              },
              "type": [
                "object",
                "null"
              ]
            },
            "timeout_ms": {
              "format": "uint64",
              "minimum": 0.0,
              "type": [
                "integer",
                "null"
              ]
            },
            "type": {
              "enum": [
                "exec"
              ],
              "title": "ExecLocalShellActionType",
              "type": "string"
            },
            "user": {
              "type": [
                "string",
                "null"
              ]
            },
            "working_directory": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "command",
            "type"
          ],
          "title": "ExecLocalShellAction",
          "type": "object"
        }
      ]
    },
    "LocalShellStatus": {
      "enum": [
        "completed",
        "in_progress",
        "incomplete"
      ],
      "type": "string"
    },
    "LoginAccountParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "oneOf": [
        {
          "properties": {
            "apiKey": {
              "type": "string"
            },
            "type": {
              "enum": [
                "apiKey"
              ],
              "title": "ApiKeyv2::LoginAccountParamsType",
              "type": "string"
            }
          },
          "required": [
            "apiKey",
            "type"
          ],
          "title": "ApiKeyv2::LoginAccountParams",
          "type": "object"
        },
        {
          "properties": {
            "codexStreamlinedLogin": {
              "type": "boolean"
            },
            "type": {
              "enum": [
                "chatgpt"
              ],
              "title": "Chatgptv2::LoginAccountParamsType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "Chatgptv2::LoginAccountParams",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "chatgptDeviceCode"
              ],
              "title": "ChatgptDeviceCodev2::LoginAccountParamsType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "ChatgptDeviceCodev2::LoginAccountParams",
          "type": "object"
        },
        {
          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.",
          "properties": {
            "accessToken": {
              "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.",
              "type": "string"
            },
            "chatgptAccountId": {
              "description": "Workspace/account identifier supplied by the client.",
              "type": "string"
            },
            "chatgptPlanType": {
              "description": "Optional plan type supplied by the client.\n\nWhen `null`, Codex attempts to derive the plan type from access-token claims. If unavailable, the plan defaults to `unknown`.",
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "chatgptAuthTokens"
              ],
              "title": "ChatgptAuthTokensv2::LoginAccountParamsType",
              "type": "string"
            }
          },
          "required": [
            "accessToken",
            "chatgptAccountId",
            "type"
          ],
          "title": "ChatgptAuthTokensv2::LoginAccountParams",
          "type": "object"
        }
      ],
      "title": "LoginAccountParams"
    },
    "LoginAccountResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "oneOf": [
        {
          "properties": {
            "type": {
              "enum": [
                "apiKey"
              ],
              "title": "ApiKeyv2::LoginAccountResponseType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "ApiKeyv2::LoginAccountResponse",
          "type": "object"
        },
        {
          "properties": {
            "authUrl": {
              "description": "URL the client should open in a browser to initiate the OAuth flow.",
              "type": "string"
            },
            "loginId": {
              "type": "string"
            },
            "type": {
              "enum": [
                "chatgpt"
              ],
              "title": "Chatgptv2::LoginAccountResponseType",
              "type": "string"
            }
          },
          "required": [
            "authUrl",
            "loginId",
            "type"
          ],
          "title": "Chatgptv2::LoginAccountResponse",
          "type": "object"
        },
        {
          "properties": {
            "loginId": {
              "type": "string"
            },
            "type": {
              "enum": [
                "chatgptDeviceCode"
              ],
              "title": "ChatgptDeviceCodev2::LoginAccountResponseType",
              "type": "string"
            },
            "userCode": {
              "description": "One-time code the user must enter after signing in.",
              "type": "string"
            },
            "verificationUrl": {
              "description": "URL the client should open in a browser to complete device code authorization.",
              "type": "string"
            }
          },
          "required": [
            "loginId",
            "type",
            "userCode",
            "verificationUrl"
          ],
          "title": "ChatgptDeviceCodev2::LoginAccountResponse",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "chatgptAuthTokens"
              ],
              "title": "ChatgptAuthTokensv2::LoginAccountResponseType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "ChatgptAuthTokensv2::LoginAccountResponse",
          "type": "object"
        }
      ],
      "title": "LoginAccountResponse"
    },
    "LogoutAccountResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "LogoutAccountResponse",
      "type": "object"
    },
    "ManagedHooksRequirements": {
      "properties": {
        "PermissionRequest": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "PostToolUse": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "PreToolUse": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "SessionStart": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "Stop": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "UserPromptSubmit": {
          "items": {
            "$ref": "#/definitions/ConfiguredHookMatcherGroup"
          },
          "type": "array"
        },
        "managedDir": {
          "type": [
            "string",
            "null"
          ]
        },
        "windowsManagedDir": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "PermissionRequest",
        "PostToolUse",
        "PreToolUse",
        "SessionStart",
        "Stop",
        "UserPromptSubmit"
      ],
      "type": "object"
    },
    "MarketplaceAddParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "refName": {
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "type": "string"
        },
        "sparsePaths": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "source"
      ],
      "title": "MarketplaceAddParams",
      "type": "object"
    },
    "MarketplaceAddResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "alreadyAdded": {
          "type": "boolean"
        },
        "installedRoot": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "marketplaceName": {
          "type": "string"
        }
      },
      "required": [
        "alreadyAdded",
        "installedRoot",
        "marketplaceName"
      ],
      "title": "MarketplaceAddResponse",
      "type": "object"
    },
    "MarketplaceInterface": {
      "properties": {
        "displayName": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "MarketplaceLoadErrorInfo": {
      "properties": {
        "marketplacePath": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "message": {
          "type": "string"
        }
      },
      "required": [
        "marketplacePath",
        "message"
      ],
      "type": "object"
    },
    "MarketplaceRemoveParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "marketplaceName": {
          "type": "string"
        }
      },
      "required": [
        "marketplaceName"
      ],
      "title": "MarketplaceRemoveParams",
      "type": "object"
    },
    "MarketplaceRemoveResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "installedRoot": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "marketplaceName": {
          "type": "string"
        }
      },
      "required": [
        "marketplaceName"
      ],
      "title": "MarketplaceRemoveResponse",
      "type": "object"
    },
    "MarketplaceUpgradeErrorInfo": {
      "properties": {
        "marketplaceName": {
          "type": "string"
        },
        "message": {
          "type": "string"
        }
      },
      "required": [
        "marketplaceName",
        "message"
      ],
      "type": "object"
    },
    "MarketplaceUpgradeParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "marketplaceName": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "title": "MarketplaceUpgradeParams",
      "type": "object"
    },
    "MarketplaceUpgradeResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "errors": {
          "items": {
            "$ref": "#/definitions/MarketplaceUpgradeErrorInfo"
          },
          "type": "array"
        },
        "selectedMarketplaces": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "upgradedRoots": {
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": "array"
        }
      },
      "required": [
        "errors",
        "selectedMarketplaces",
        "upgradedRoots"
      ],
      "title": "MarketplaceUpgradeResponse",
      "type": "object"
    },
    "McpAuthStatus": {
      "enum": [
        "unsupported",
        "notLoggedIn",
        "bearerToken",
        "oAuth"
      ],
      "type": "string"
    },
    "McpResourceReadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "server": {
          "type": "string"
        },
        "threadId": {
          "type": [
            "string",
            "null"
          ]
        },
        "uri": {
          "type": "string"
        }
      },
      "required": [
        "server",
        "uri"
      ],
      "title": "McpResourceReadParams",
      "type": "object"
    },
    "McpResourceReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "contents": {
          "items": {
            "$ref": "#/definitions/ResourceContent"
          },
          "type": "array"
        }
      },
      "required": [
        "contents"
      ],
      "title": "McpResourceReadResponse",
      "type": "object"
    },
    "McpServerMigration": {
      "properties": {
        "name": {
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "McpServerOauthLoginCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "error": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "success": {
          "type": "boolean"
        }
      },
      "required": [
        "name",
        "success"
      ],
      "title": "McpServerOauthLoginCompletedNotification",
      "type": "object"
    },
    "McpServerOauthLoginParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "name": {
          "type": "string"
        },
        "scopes": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "timeoutSecs": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "name"
      ],
      "title": "McpServerOauthLoginParams",
      "type": "object"
    },
    "McpServerOauthLoginResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "authorizationUrl": {
          "type": "string"
        }
      },
      "required": [
        "authorizationUrl"
      ],
      "title": "McpServerOauthLoginResponse",
      "type": "object"
    },
    "McpServerRefreshResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "McpServerRefreshResponse",
      "type": "object"
    },
    "McpServerStartupState": {
      "enum": [
        "starting",
        "ready",
        "failed",
        "cancelled"
      ],
      "type": "string"
    },
    "McpServerStatus": {
      "properties": {
        "authStatus": {
          "$ref": "#/definitions/McpAuthStatus"
        },
        "name": {
          "type": "string"
        },
        "resourceTemplates": {
          "items": {
            "$ref": "#/definitions/ResourceTemplate"
          },
          "type": "array"
        },
        "resources": {
          "items": {
            "$ref": "#/definitions/Resource"
          },
          "type": "array"
        },
        "tools": {
          "additionalProperties": {
            "$ref": "#/definitions/Tool"
          },
          "type": "object"
        }
      },
      "required": [
        "authStatus",
        "name",
        "resourceTemplates",
        "resources",
        "tools"
      ],
      "type": "object"
    },
    "McpServerStatusDetail": {
      "enum": [
        "full",
        "toolsAndAuthOnly"
      ],
      "type": "string"
    },
    "McpServerStatusUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "error": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "status": {
          "$ref": "#/definitions/McpServerStartupState"
        }
      },
      "required": [
        "name",
        "status"
      ],
      "title": "McpServerStatusUpdatedNotification",
      "type": "object"
    },
    "McpServerToolCallParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "_meta": true,
        "arguments": true,
        "server": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "tool": {
          "type": "string"
        }
      },
      "required": [
        "server",
        "threadId",
        "tool"
      ],
      "title": "McpServerToolCallParams",
      "type": "object"
    },
    "McpServerToolCallResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "_meta": true,
        "content": {
          "items": true,
          "type": "array"
        },
        "isError": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "structuredContent": true
      },
      "required": [
        "content"
      ],
      "title": "McpServerToolCallResponse",
      "type": "object"
    },
    "McpToolCallError": {
      "properties": {
        "message": {
          "type": "string"
        }
      },
      "required": [
        "message"
      ],
      "type": "object"
    },
    "McpToolCallProgressNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "itemId": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "itemId",
        "message",
        "threadId",
        "turnId"
      ],
      "title": "McpToolCallProgressNotification",
      "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"
    },
    "MergeStrategy": {
      "enum": [
        "replace",
        "upsert"
      ],
      "type": "string"
    },
    "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"
        }
      ]
    },
    "MigrationDetails": {
      "properties": {
        "commands": {
          "default": [],
          "items": {
            "$ref": "#/definitions/CommandMigration"
          },
          "type": "array"
        },
        "hooks": {
          "default": [],
          "items": {
            "$ref": "#/definitions/HookMigration"
          },
          "type": "array"
        },
        "mcpServers": {
          "default": [],
          "items": {
            "$ref": "#/definitions/McpServerMigration"
          },
          "type": "array"
        },
        "plugins": {
          "default": [],
          "items": {
            "$ref": "#/definitions/PluginsMigration"
          },
          "type": "array"
        },
        "sessions": {
          "default": [],
          "items": {
            "$ref": "#/definitions/SessionMigration"
          },
          "type": "array"
        },
        "subagents": {
          "default": [],
          "items": {
            "$ref": "#/definitions/SubagentMigration"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "ModeKind": {
      "description": "Initial collaboration mode to use when the TUI starts.",
      "enum": [
        "plan",
        "default"
      ],
      "type": "string"
    },
    "Model": {
      "properties": {
        "additionalSpeedTiers": {
          "default": [],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "availabilityNux": {
          "anyOf": [
            {
              "$ref": "#/definitions/ModelAvailabilityNux"
            },
            {
              "type": "null"
            }
          ]
        },
        "defaultReasoningEffort": {
          "$ref": "#/definitions/ReasoningEffort"
        },
        "description": {
          "type": "string"
        },
        "displayName": {
          "type": "string"
        },
        "hidden": {
          "type": "boolean"
        },
        "id": {
          "type": "string"
        },
        "inputModalities": {
          "default": [
            "text",
            "image"
          ],
          "items": {
            "$ref": "#/definitions/InputModality"
          },
          "type": "array"
        },
        "isDefault": {
          "type": "boolean"
        },
        "model": {
          "type": "string"
        },
        "supportedReasoningEfforts": {
          "items": {
            "$ref": "#/definitions/ReasoningEffortOption"
          },
          "type": "array"
        },
        "supportsPersonality": {
          "default": false,
          "type": "boolean"
        },
        "upgrade": {
          "type": [
            "string",
            "null"
          ]
        },
        "upgradeInfo": {
          "anyOf": [
            {
              "$ref": "#/definitions/ModelUpgradeInfo"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "defaultReasoningEffort",
        "description",
        "displayName",
        "hidden",
        "id",
        "isDefault",
        "model",
        "supportedReasoningEfforts"
      ],
      "type": "object"
    },
    "ModelAvailabilityNux": {
      "properties": {
        "message": {
          "type": "string"
        }
      },
      "required": [
        "message"
      ],
      "type": "object"
    },
    "ModelListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous call.",
          "type": [
            "string",
            "null"
          ]
        },
        "includeHidden": {
          "description": "When true, include models that are hidden from the default picker list.",
          "type": [
            "boolean",
            "null"
          ]
        },
        "limit": {
          "description": "Optional page size; defaults to a reasonable server-side value.",
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "title": "ModelListParams",
      "type": "object"
    },
    "ModelListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/Model"
          },
          "type": "array"
        },
        "nextCursor": {
          "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "data"
      ],
      "title": "ModelListResponse",
      "type": "object"
    },
    "ModelProviderCapabilitiesReadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ModelProviderCapabilitiesReadParams",
      "type": "object"
    },
    "ModelProviderCapabilitiesReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "imageGeneration": {
          "type": "boolean"
        },
        "namespaceTools": {
          "type": "boolean"
        },
        "webSearch": {
          "type": "boolean"
        }
      },
      "required": [
        "imageGeneration",
        "namespaceTools",
        "webSearch"
      ],
      "title": "ModelProviderCapabilitiesReadResponse",
      "type": "object"
    },
    "ModelRerouteReason": {
      "enum": [
        "highRiskCyberActivity"
      ],
      "type": "string"
    },
    "ModelReroutedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "fromModel": {
          "type": "string"
        },
        "reason": {
          "$ref": "#/definitions/ModelRerouteReason"
        },
        "threadId": {
          "type": "string"
        },
        "toModel": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "fromModel",
        "reason",
        "threadId",
        "toModel",
        "turnId"
      ],
      "title": "ModelReroutedNotification",
      "type": "object"
    },
    "ModelUpgradeInfo": {
      "properties": {
        "migrationMarkdown": {
          "type": [
            "string",
            "null"
          ]
        },
        "model": {
          "type": "string"
        },
        "modelLink": {
          "type": [
            "string",
            "null"
          ]
        },
        "upgradeCopy": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "model"
      ],
      "type": "object"
    },
    "ModelVerification": {
      "enum": [
        "trustedAccessForCyber"
      ],
      "type": "string"
    },
    "ModelVerificationNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        },
        "verifications": {
          "items": {
            "$ref": "#/definitions/ModelVerification"
          },
          "type": "array"
        }
      },
      "required": [
        "threadId",
        "turnId",
        "verifications"
      ],
      "title": "ModelVerificationNotification",
      "type": "object"
    },
    "NetworkAccess": {
      "enum": [
        "restricted",
        "enabled"
      ],
      "type": "string"
    },
    "NetworkApprovalProtocol": {
      "enum": [
        "http",
        "https",
        "socks5Tcp",
        "socks5Udp"
      ],
      "type": "string"
    },
    "NetworkDomainPermission": {
      "enum": [
        "allow",
        "deny"
      ],
      "type": "string"
    },
    "NetworkRequirements": {
      "properties": {
        "allowLocalBinding": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "allowUnixSockets": {
          "description": "Legacy compatibility view derived from `unix_sockets`.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "allowUpstreamProxy": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "allowedDomains": {
          "description": "Legacy compatibility view derived from `domains`.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "dangerouslyAllowAllUnixSockets": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "dangerouslyAllowNonLoopbackProxy": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "deniedDomains": {
          "description": "Legacy compatibility view derived from `domains`.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "domains": {
          "additionalProperties": {
            "$ref": "#/definitions/NetworkDomainPermission"
          },
          "description": "Canonical network permission map for `experimental_network`.",
          "type": [
            "object",
            "null"
          ]
        },
        "enabled": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "httpPort": {
          "format": "uint16",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        },
        "managedAllowedDomainsOnly": {
          "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.",
          "type": [
            "boolean",
            "null"
          ]
        },
        "socksPort": {
          "format": "uint16",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        },
        "unixSockets": {
          "additionalProperties": {
            "$ref": "#/definitions/NetworkUnixSocketPermission"
          },
          "description": "Canonical unix socket permission map for `experimental_network`.",
          "type": [
            "object",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "NetworkUnixSocketPermission": {
      "enum": [
        "allow",
        "none"
      ],
      "type": "string"
    },
    "NonSteerableTurnKind": {
      "enum": [
        "review",
        "compact"
      ],
      "type": "string"
    },
    "OverriddenMetadata": {
      "properties": {
        "effectiveValue": true,
        "message": {
          "type": "string"
        },
        "overridingLayer": {
          "$ref": "#/definitions/ConfigLayerMetadata"
        }
      },
      "required": [
        "effectiveValue",
        "message",
        "overridingLayer"
      ],
      "type": "object"
    },
    "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"
        }
      ]
    },
    "PermissionProfile": {
      "oneOf": [
        {
          "description": "Codex owns sandbox construction for this profile.",
          "properties": {
            "fileSystem": {
              "$ref": "#/definitions/PermissionProfileFileSystemPermissions"
            },
            "network": {
              "$ref": "#/definitions/PermissionProfileNetworkPermissions"
            },
            "type": {
              "enum": [
                "managed"
              ],
              "title": "ManagedPermissionProfileType",
              "type": "string"
            }
          },
          "required": [
            "fileSystem",
            "network",
            "type"
          ],
          "title": "ManagedPermissionProfile",
          "type": "object"
        },
        {
          "description": "Do not apply an outer sandbox.",
          "properties": {
            "type": {
              "enum": [
                "disabled"
              ],
              "title": "DisabledPermissionProfileType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "DisabledPermissionProfile",
          "type": "object"
        },
        {
          "description": "Filesystem isolation is enforced by an external caller.",
          "properties": {
            "network": {
              "$ref": "#/definitions/PermissionProfileNetworkPermissions"
            },
            "type": {
              "enum": [
                "external"
              ],
              "title": "ExternalPermissionProfileType",
              "type": "string"
            }
          },
          "required": [
            "network",
            "type"
          ],
          "title": "ExternalPermissionProfile",
          "type": "object"
        }
      ]
    },
    "PermissionProfileFileSystemPermissions": {
      "oneOf": [
        {
          "properties": {
            "entries": {
              "items": {
                "$ref": "#/definitions/FileSystemSandboxEntry"
              },
              "type": "array"
            },
            "globScanMaxDepth": {
              "format": "uint",
              "minimum": 1.0,
              "type": [
                "integer",
                "null"
              ]
            },
            "type": {
              "enum": [
                "restricted"
              ],
              "title": "RestrictedPermissionProfileFileSystemPermissionsType",
              "type": "string"
            }
          },
          "required": [
            "entries",
            "type"
          ],
          "title": "RestrictedPermissionProfileFileSystemPermissions",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "unrestricted"
              ],
              "title": "UnrestrictedPermissionProfileFileSystemPermissionsType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "UnrestrictedPermissionProfileFileSystemPermissions",
          "type": "object"
        }
      ]
    },
    "PermissionProfileModificationParams": {
      "oneOf": [
        {
          "description": "Additional concrete directory that should be writable.",
          "properties": {
            "path": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "additionalWritableRoot"
              ],
              "title": "AdditionalWritableRootPermissionProfileModificationParamsType",
              "type": "string"
            }
          },
          "required": [
            "path",
            "type"
          ],
          "title": "AdditionalWritableRootPermissionProfileModificationParams",
          "type": "object"
        }
      ]
    },
    "PermissionProfileNetworkPermissions": {
      "properties": {
        "enabled": {
          "type": "boolean"
        }
      },
      "required": [
        "enabled"
      ],
      "type": "object"
    },
    "PermissionProfileSelectionParams": {
      "oneOf": [
        {
          "description": "Select a named built-in or user-defined profile and optionally apply bounded modifications that Codex knows how to validate.",
          "properties": {
            "id": {
              "type": "string"
            },
            "modifications": {
              "items": {
                "$ref": "#/definitions/PermissionProfileModificationParams"
              },
              "type": [
                "array",
                "null"
              ]
            },
            "type": {
              "enum": [
                "profile"
              ],
              "title": "ProfilePermissionProfileSelectionParamsType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "type"
          ],
          "title": "ProfilePermissionProfileSelectionParams",
          "type": "object"
        }
      ]
    },
    "Personality": {
      "enum": [
        "none",
        "friendly",
        "pragmatic"
      ],
      "type": "string"
    },
    "PlanDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "PlanDeltaNotification",
      "type": "object"
    },
    "PlanType": {
      "enum": [
        "free",
        "go",
        "plus",
        "pro",
        "prolite",
        "team",
        "self_serve_business_usage_based",
        "business",
        "enterprise_cbp_usage_based",
        "enterprise",
        "edu",
        "unknown"
      ],
      "type": "string"
    },
    "PluginAuthPolicy": {
      "enum": [
        "ON_INSTALL",
        "ON_USE"
      ],
      "type": "string"
    },
    "PluginAvailability": {
      "oneOf": [
        {
          "enum": [
            "DISABLED_BY_ADMIN"
          ],
          "type": "string"
        },
        {
          "description": "Plugin-service currently sends `\"ENABLED\"` for available remote plugins. Codex app-server exposes `\"AVAILABLE\"` in its API; the alias keeps decoding compatible with that upstream response.",
          "enum": [
            "AVAILABLE"
          ],
          "type": "string"
        }
      ]
    },
    "PluginDetail": {
      "properties": {
        "apps": {
          "items": {
            "$ref": "#/definitions/AppSummary"
          },
          "type": "array"
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "marketplaceName": {
          "type": "string"
        },
        "marketplacePath": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "mcpServers": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "skills": {
          "items": {
            "$ref": "#/definitions/SkillSummary"
          },
          "type": "array"
        },
        "summary": {
          "$ref": "#/definitions/PluginSummary"
        }
      },
      "required": [
        "apps",
        "marketplaceName",
        "mcpServers",
        "skills",
        "summary"
      ],
      "type": "object"
    },
    "PluginInstallParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "marketplacePath": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "pluginName": {
          "type": "string"
        },
        "remoteMarketplaceName": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "pluginName"
      ],
      "title": "PluginInstallParams",
      "type": "object"
    },
    "PluginInstallPolicy": {
      "enum": [
        "NOT_AVAILABLE",
        "AVAILABLE",
        "INSTALLED_BY_DEFAULT"
      ],
      "type": "string"
    },
    "PluginInstallResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "appsNeedingAuth": {
          "items": {
            "$ref": "#/definitions/AppSummary"
          },
          "type": "array"
        },
        "authPolicy": {
          "$ref": "#/definitions/PluginAuthPolicy"
        }
      },
      "required": [
        "appsNeedingAuth",
        "authPolicy"
      ],
      "title": "PluginInstallResponse",
      "type": "object"
    },
    "PluginInterface": {
      "properties": {
        "brandColor": {
          "type": [
            "string",
            "null"
          ]
        },
        "capabilities": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "category": {
          "type": [
            "string",
            "null"
          ]
        },
        "composerIcon": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ],
          "description": "Local composer icon path, resolved from the installed plugin package."
        },
        "composerIconUrl": {
          "description": "Remote composer icon URL from the plugin catalog.",
          "type": [
            "string",
            "null"
          ]
        },
        "defaultPrompt": {
          "description": "Starter prompts for the plugin. Capped at 3 entries with a maximum of 128 characters per entry.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "developerName": {
          "type": [
            "string",
            "null"
          ]
        },
        "displayName": {
          "type": [
            "string",
            "null"
          ]
        },
        "logo": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ],
          "description": "Local logo path, resolved from the installed plugin package."
        },
        "logoUrl": {
          "description": "Remote logo URL from the plugin catalog.",
          "type": [
            "string",
            "null"
          ]
        },
        "longDescription": {
          "type": [
            "string",
            "null"
          ]
        },
        "privacyPolicyUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "screenshotUrls": {
          "description": "Remote screenshot URLs from the plugin catalog.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "screenshots": {
          "description": "Local screenshot paths, resolved from the installed plugin package.",
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": "array"
        },
        "shortDescription": {
          "type": [
            "string",
            "null"
          ]
        },
        "termsOfServiceUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "websiteUrl": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "capabilities",
        "screenshotUrls",
        "screenshots"
      ],
      "type": "object"
    },
    "PluginListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cwds": {
          "description": "Optional working directories used to discover repo marketplaces. When omitted, only home-scoped marketplaces and the official curated marketplace are considered.",
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "title": "PluginListParams",
      "type": "object"
    },
    "PluginListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "featuredPluginIds": {
          "default": [],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "marketplaceLoadErrors": {
          "default": [],
          "items": {
            "$ref": "#/definitions/MarketplaceLoadErrorInfo"
          },
          "type": "array"
        },
        "marketplaces": {
          "items": {
            "$ref": "#/definitions/PluginMarketplaceEntry"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaces"
      ],
      "title": "PluginListResponse",
      "type": "object"
    },
    "PluginMarketplaceEntry": {
      "properties": {
        "interface": {
          "anyOf": [
            {
              "$ref": "#/definitions/MarketplaceInterface"
            },
            {
              "type": "null"
            }
          ]
        },
        "name": {
          "type": "string"
        },
        "path": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ],
          "description": "Local marketplace file path when the marketplace is backed by a local file. Remote-only catalog marketplaces do not have a local path."
        },
        "plugins": {
          "items": {
            "$ref": "#/definitions/PluginSummary"
          },
          "type": "array"
        }
      },
      "required": [
        "name",
        "plugins"
      ],
      "type": "object"
    },
    "PluginReadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "marketplacePath": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "pluginName": {
          "type": "string"
        },
        "remoteMarketplaceName": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "pluginName"
      ],
      "title": "PluginReadParams",
      "type": "object"
    },
    "PluginReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "plugin": {
          "$ref": "#/definitions/PluginDetail"
        }
      },
      "required": [
        "plugin"
      ],
      "title": "PluginReadResponse",
      "type": "object"
    },
    "PluginShareDeleteParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "remotePluginId": {
          "type": "string"
        }
      },
      "required": [
        "remotePluginId"
      ],
      "title": "PluginShareDeleteParams",
      "type": "object"
    },
    "PluginShareDeleteResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "PluginShareDeleteResponse",
      "type": "object"
    },
    "PluginShareListItem": {
      "properties": {
        "localPluginPath": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "plugin": {
          "$ref": "#/definitions/PluginSummary"
        },
        "shareUrl": {
          "type": "string"
        }
      },
      "required": [
        "plugin",
        "shareUrl"
      ],
      "type": "object"
    },
    "PluginShareListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "PluginShareListParams",
      "type": "object"
    },
    "PluginShareListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/PluginShareListItem"
          },
          "type": "array"
        }
      },
      "required": [
        "data"
      ],
      "title": "PluginShareListResponse",
      "type": "object"
    },
    "PluginShareSaveParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "pluginPath": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "remotePluginId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "pluginPath"
      ],
      "title": "PluginShareSaveParams",
      "type": "object"
    },
    "PluginShareSaveResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "remotePluginId": {
          "type": "string"
        },
        "shareUrl": {
          "type": "string"
        }
      },
      "required": [
        "remotePluginId",
        "shareUrl"
      ],
      "title": "PluginShareSaveResponse",
      "type": "object"
    },
    "PluginSkillReadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "remoteMarketplaceName": {
          "type": "string"
        },
        "remotePluginId": {
          "type": "string"
        },
        "skillName": {
          "type": "string"
        }
      },
      "required": [
        "remoteMarketplaceName",
        "remotePluginId",
        "skillName"
      ],
      "title": "PluginSkillReadParams",
      "type": "object"
    },
    "PluginSkillReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "contents": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "title": "PluginSkillReadResponse",
      "type": "object"
    },
    "PluginSource": {
      "oneOf": [
        {
          "properties": {
            "path": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "local"
              ],
              "title": "LocalPluginSourceType",
              "type": "string"
            }
          },
          "required": [
            "path",
            "type"
          ],
          "title": "LocalPluginSource",
          "type": "object"
        },
        {
          "properties": {
            "path": {
              "type": [
                "string",
                "null"
              ]
            },
            "refName": {
              "type": [
                "string",
                "null"
              ]
            },
            "sha": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "git"
              ],
              "title": "GitPluginSourceType",
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "type",
            "url"
          ],
          "title": "GitPluginSource",
          "type": "object"
        },
        {
          "description": "The plugin is available in the remote catalog. Download metadata is kept server-side and is not exposed through the app-server API.",
          "properties": {
            "type": {
              "enum": [
                "remote"
              ],
              "title": "RemotePluginSourceType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "RemotePluginSource",
          "type": "object"
        }
      ]
    },
    "PluginSummary": {
      "properties": {
        "authPolicy": {
          "$ref": "#/definitions/PluginAuthPolicy"
        },
        "availability": {
          "allOf": [
            {
              "$ref": "#/definitions/PluginAvailability"
            }
          ],
          "default": "AVAILABLE",
          "description": "Availability state for installing and using the plugin."
        },
        "enabled": {
          "type": "boolean"
        },
        "id": {
          "type": "string"
        },
        "installPolicy": {
          "$ref": "#/definitions/PluginInstallPolicy"
        },
        "installed": {
          "type": "boolean"
        },
        "interface": {
          "anyOf": [
            {
              "$ref": "#/definitions/PluginInterface"
            },
            {
              "type": "null"
            }
          ]
        },
        "name": {
          "type": "string"
        },
        "source": {
          "$ref": "#/definitions/PluginSource"
        }
      },
      "required": [
        "authPolicy",
        "enabled",
        "id",
        "installPolicy",
        "installed",
        "name",
        "source"
      ],
      "type": "object"
    },
    "PluginUninstallParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "pluginId": {
          "type": "string"
        }
      },
      "required": [
        "pluginId"
      ],
      "title": "PluginUninstallParams",
      "type": "object"
    },
    "PluginUninstallResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "PluginUninstallResponse",
      "type": "object"
    },
    "PluginsMigration": {
      "properties": {
        "marketplaceName": {
          "type": "string"
        },
        "pluginNames": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceName",
        "pluginNames"
      ],
      "type": "object"
    },
    "ProfileV2": {
      "additionalProperties": true,
      "properties": {
        "approval_policy": {
          "anyOf": [
            {
              "$ref": "#/definitions/AskForApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "approvals_reviewer": {
          "anyOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            },
            {
              "type": "null"
            }
          ],
          "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used."
        },
        "chatgpt_base_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "model": {
          "type": [
            "string",
            "null"
          ]
        },
        "model_provider": {
          "type": [
            "string",
            "null"
          ]
        },
        "model_reasoning_effort": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningEffort"
            },
            {
              "type": "null"
            }
          ]
        },
        "model_reasoning_summary": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningSummary"
            },
            {
              "type": "null"
            }
          ]
        },
        "model_verbosity": {
          "anyOf": [
            {
              "$ref": "#/definitions/Verbosity"
            },
            {
              "type": "null"
            }
          ]
        },
        "service_tier": {
          "anyOf": [
            {
              "$ref": "#/definitions/ServiceTier"
            },
            {
              "type": "null"
            }
          ]
        },
        "tools": {
          "anyOf": [
            {
              "$ref": "#/definitions/ToolsV2"
            },
            {
              "type": "null"
            }
          ]
        },
        "web_search": {
          "anyOf": [
            {
              "$ref": "#/definitions/WebSearchMode"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "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"
            }
          ]
        },
        "limitId": {
          "type": [
            "string",
            "null"
          ]
        },
        "limitName": {
          "type": [
            "string",
            "null"
          ]
        },
        "planType": {
          "anyOf": [
            {
              "$ref": "#/definitions/PlanType"
            },
            {
              "type": "null"
            }
          ]
        },
        "primary": {
          "anyOf": [
            {
              "$ref": "#/definitions/RateLimitWindow"
            },
            {
              "type": "null"
            }
          ]
        },
        "rateLimitReachedType": {
          "anyOf": [
            {
              "$ref": "#/definitions/RateLimitReachedType"
            },
            {
              "type": "null"
            }
          ]
        },
        "secondary": {
          "anyOf": [
            {
              "$ref": "#/definitions/RateLimitWindow"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    },
    "RateLimitWindow": {
      "properties": {
        "resetsAt": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "usedPercent": {
          "format": "int32",
          "type": "integer"
        },
        "windowDurationMins": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "usedPercent"
      ],
      "type": "object"
    },
    "RawResponseItemCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "item": {
          "$ref": "#/definitions/ResponseItem"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "item",
        "threadId",
        "turnId"
      ],
      "title": "RawResponseItemCompletedNotification",
      "type": "object"
    },
    "RealtimeConversationVersion": {
      "enum": [
        "v1",
        "v2"
      ],
      "type": "string"
    },
    "RealtimeOutputModality": {
      "enum": [
        "text",
        "audio"
      ],
      "type": "string"
    },
    "RealtimeVoice": {
      "enum": [
        "alloy",
        "arbor",
        "ash",
        "ballad",
        "breeze",
        "cedar",
        "coral",
        "cove",
        "echo",
        "ember",
        "juniper",
        "maple",
        "marin",
        "sage",
        "shimmer",
        "sol",
        "spruce",
        "vale",
        "verse"
      ],
      "type": "string"
    },
    "RealtimeVoicesList": {
      "properties": {
        "defaultV1": {
          "$ref": "#/definitions/RealtimeVoice"
        },
        "defaultV2": {
          "$ref": "#/definitions/RealtimeVoice"
        },
        "v1": {
          "items": {
            "$ref": "#/definitions/RealtimeVoice"
          },
          "type": "array"
        },
        "v2": {
          "items": {
            "$ref": "#/definitions/RealtimeVoice"
          },
          "type": "array"
        }
      },
      "required": [
        "defaultV1",
        "defaultV2",
        "v1",
        "v2"
      ],
      "type": "object"
    },
    "ReasoningEffort": {
      "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
      "enum": [
        "none",
        "minimal",
        "low",
        "medium",
        "high",
        "xhigh"
      ],
      "type": "string"
    },
    "ReasoningEffortOption": {
      "properties": {
        "description": {
          "type": "string"
        },
        "reasoningEffort": {
          "$ref": "#/definitions/ReasoningEffort"
        }
      },
      "required": [
        "description",
        "reasoningEffort"
      ],
      "type": "object"
    },
    "ReasoningItemContent": {
      "oneOf": [
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "reasoning_text"
              ],
              "title": "ReasoningTextReasoningItemContentType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "ReasoningTextReasoningItemContent",
          "type": "object"
        },
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "text"
              ],
              "title": "TextReasoningItemContentType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "TextReasoningItemContent",
          "type": "object"
        }
      ]
    },
    "ReasoningItemReasoningSummary": {
      "oneOf": [
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "summary_text"
              ],
              "title": "SummaryTextReasoningItemReasoningSummaryType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "SummaryTextReasoningItemReasoningSummary",
          "type": "object"
        }
      ]
    },
    "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": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "itemId": {
          "type": "string"
        },
        "summaryIndex": {
          "format": "int64",
          "type": "integer"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "itemId",
        "summaryIndex",
        "threadId",
        "turnId"
      ],
      "title": "ReasoningSummaryPartAddedNotification",
      "type": "object"
    },
    "ReasoningSummaryTextDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "delta": {
          "type": "string"
        },
        "itemId": {
          "type": "string"
        },
        "summaryIndex": {
          "format": "int64",
          "type": "integer"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "delta",
        "itemId",
        "summaryIndex",
        "threadId",
        "turnId"
      ],
      "title": "ReasoningSummaryTextDeltaNotification",
      "type": "object"
    },
    "ReasoningTextDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "contentIndex": {
          "format": "int64",
          "type": "integer"
        },
        "delta": {
          "type": "string"
        },
        "itemId": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "contentIndex",
        "delta",
        "itemId",
        "threadId",
        "turnId"
      ],
      "title": "ReasoningTextDeltaNotification",
      "type": "object"
    },
    "RemoteControlClientConnectionAudience": {
      "description": "Audience for a remote-control client connection device-key proof.",
      "enum": [
        "remote_control_client_websocket"
      ],
      "type": "string"
    },
    "RemoteControlClientEnrollmentAudience": {
      "description": "Audience for a remote-control client enrollment device-key proof.",
      "enum": [
        "remote_control_client_enrollment"
      ],
      "type": "string"
    },
    "RemoteControlConnectionStatus": {
      "enum": [
        "disabled",
        "connecting",
        "connected",
        "errored"
      ],
      "type": "string"
    },
    "RemoteControlStatusChangedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "Current remote-control connection status and environment id exposed to clients.",
      "properties": {
        "environmentId": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "$ref": "#/definitions/RemoteControlConnectionStatus"
        }
      },
      "required": [
        "status"
      ],
      "title": "RemoteControlStatusChangedNotification",
      "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"
    },
    "ResidencyRequirement": {
      "enum": [
        "us"
      ],
      "type": "string"
    },
    "Resource": {
      "description": "A known resource that the server is capable of reading.",
      "properties": {
        "_meta": true,
        "annotations": true,
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "icons": {
          "items": true,
          "type": [
            "array",
            "null"
          ]
        },
        "mimeType": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "size": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "uri": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "uri"
      ],
      "type": "object"
    },
    "ResourceContent": {
      "anyOf": [
        {
          "properties": {
            "_meta": true,
            "mimeType": {
              "type": [
                "string",
                "null"
              ]
            },
            "text": {
              "type": "string"
            },
            "uri": {
              "description": "The URI of this resource.",
              "type": "string"
            }
          },
          "required": [
            "text",
            "uri"
          ],
          "type": "object"
        },
        {
          "properties": {
            "_meta": true,
            "blob": {
              "type": "string"
            },
            "mimeType": {
              "type": [
                "string",
                "null"
              ]
            },
            "uri": {
              "description": "The URI of this resource.",
              "type": "string"
            }
          },
          "required": [
            "blob",
            "uri"
          ],
          "type": "object"
        }
      ],
      "description": "Contents returned when reading a resource from an MCP server."
    },
    "ResourceTemplate": {
      "description": "A template description for resources available on the server.",
      "properties": {
        "annotations": true,
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "mimeType": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "uriTemplate": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "uriTemplate"
      ],
      "type": "object"
    },
    "ResponseItem": {
      "oneOf": [
        {
          "properties": {
            "content": {
              "items": {
                "$ref": "#/definitions/ContentItem"
              },
              "type": "array"
            },
            "id": {
              "type": [
                "string",
                "null"
              ],
              "writeOnly": true
            },
            "phase": {
              "anyOf": [
                {
                  "$ref": "#/definitions/MessagePhase"
                },
                {
                  "type": "null"
                }
              ]
            },
            "role": {
              "type": "string"
            },
            "type": {
              "enum": [
                "message"
              ],
              "title": "MessageResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "content",
            "role",
            "type"
          ],
          "title": "MessageResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "content": {
              "default": null,
              "items": {
                "$ref": "#/definitions/ReasoningItemContent"
              },
              "type": [
                "array",
                "null"
              ]
            },
            "encrypted_content": {
              "type": [
                "string",
                "null"
              ]
            },
            "summary": {
              "items": {
                "$ref": "#/definitions/ReasoningItemReasoningSummary"
              },
              "type": "array"
            },
            "type": {
              "enum": [
                "reasoning"
              ],
              "title": "ReasoningResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "summary",
            "type"
          ],
          "title": "ReasoningResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "action": {
              "$ref": "#/definitions/LocalShellAction"
            },
            "call_id": {
              "description": "Set when using the Responses API.",
              "type": [
                "string",
                "null"
              ]
            },
            "id": {
              "description": "Legacy id field retained for compatibility with older payloads.",
              "type": [
                "string",
                "null"
              ],
              "writeOnly": true
            },
            "status": {
              "$ref": "#/definitions/LocalShellStatus"
            },
            "type": {
              "enum": [
                "local_shell_call"
              ],
              "title": "LocalShellCallResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "action",
            "status",
            "type"
          ],
          "title": "LocalShellCallResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "arguments": {
              "type": "string"
            },
            "call_id": {
              "type": "string"
            },
            "id": {
              "type": [
                "string",
                "null"
              ],
              "writeOnly": true
            },
            "name": {
              "type": "string"
            },
            "namespace": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "function_call"
              ],
              "title": "FunctionCallResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "arguments",
            "call_id",
            "name",
            "type"
          ],
          "title": "FunctionCallResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "arguments": true,
            "call_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "execution": {
              "type": "string"
            },
            "id": {
              "type": [
                "string",
                "null"
              ],
              "writeOnly": true
            },
            "status": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "tool_search_call"
              ],
              "title": "ToolSearchCallResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "arguments",
            "execution",
            "type"
          ],
          "title": "ToolSearchCallResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "call_id": {
              "type": "string"
            },
            "output": {
              "$ref": "#/definitions/FunctionCallOutputBody"
            },
            "type": {
              "enum": [
                "function_call_output"
              ],
              "title": "FunctionCallOutputResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "call_id",
            "output",
            "type"
          ],
          "title": "FunctionCallOutputResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "call_id": {
              "type": "string"
            },
            "id": {
              "type": [
                "string",
                "null"
              ],
              "writeOnly": true
            },
            "input": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "status": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "custom_tool_call"
              ],
              "title": "CustomToolCallResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "call_id",
            "input",
            "name",
            "type"
          ],
          "title": "CustomToolCallResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "call_id": {
              "type": "string"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "output": {
              "$ref": "#/definitions/FunctionCallOutputBody"
            },
            "type": {
              "enum": [
                "custom_tool_call_output"
              ],
              "title": "CustomToolCallOutputResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "call_id",
            "output",
            "type"
          ],
          "title": "CustomToolCallOutputResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "call_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "execution": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "tools": {
              "items": true,
              "type": "array"
            },
            "type": {
              "enum": [
                "tool_search_output"
              ],
              "title": "ToolSearchOutputResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "execution",
            "status",
            "tools",
            "type"
          ],
          "title": "ToolSearchOutputResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "action": {
              "anyOf": [
                {
                  "$ref": "#/definitions/ResponsesApiWebSearchAction"
                },
                {
                  "type": "null"
                }
              ]
            },
            "id": {
              "type": [
                "string",
                "null"
              ],
              "writeOnly": true
            },
            "status": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "web_search_call"
              ],
              "title": "WebSearchCallResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "WebSearchCallResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "result": {
              "type": "string"
            },
            "revised_prompt": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": "string"
            },
            "type": {
              "enum": [
                "image_generation_call"
              ],
              "title": "ImageGenerationCallResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "result",
            "status",
            "type"
          ],
          "title": "ImageGenerationCallResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "encrypted_content": {
              "type": "string"
            },
            "type": {
              "enum": [
                "compaction"
              ],
              "title": "CompactionResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "encrypted_content",
            "type"
          ],
          "title": "CompactionResponseItem",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "other"
              ],
              "title": "OtherResponseItemType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "OtherResponseItem",
          "type": "object"
        }
      ]
    },
    "ResponsesApiWebSearchAction": {
      "oneOf": [
        {
          "properties": {
            "queries": {
              "items": {
                "type": "string"
              },
              "type": [
                "array",
                "null"
              ]
            },
            "query": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "search"
              ],
              "title": "SearchResponsesApiWebSearchActionType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "SearchResponsesApiWebSearchAction",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "open_page"
              ],
              "title": "OpenPageResponsesApiWebSearchActionType",
              "type": "string"
            },
            "url": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "type"
          ],
          "title": "OpenPageResponsesApiWebSearchAction",
          "type": "object"
        },
        {
          "properties": {
            "pattern": {
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "find_in_page"
              ],
              "title": "FindInPageResponsesApiWebSearchActionType",
              "type": "string"
            },
            "url": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "type"
          ],
          "title": "FindInPageResponsesApiWebSearchAction",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "other"
              ],
              "title": "OtherResponsesApiWebSearchActionType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "OtherResponsesApiWebSearchAction",
          "type": "object"
        }
      ]
    },
    "ReviewDelivery": {
      "enum": [
        "inline",
        "detached"
      ],
      "type": "string"
    },
    "ReviewStartParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "delivery": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReviewDelivery"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)."
        },
        "target": {
          "$ref": "#/definitions/ReviewTarget"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "target",
        "threadId"
      ],
      "title": "ReviewStartParams",
      "type": "object"
    },
    "ReviewStartResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "reviewThreadId": {
          "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.",
          "type": "string"
        },
        "turn": {
          "$ref": "#/definitions/Turn"
        }
      },
      "required": [
        "reviewThreadId",
        "turn"
      ],
      "title": "ReviewStartResponse",
      "type": "object"
    },
    "ReviewTarget": {
      "oneOf": [
        {
          "description": "Review the working tree: staged, unstaged, and untracked files.",
          "properties": {
            "type": {
              "enum": [
                "uncommittedChanges"
              ],
              "title": "UncommittedChangesReviewTargetType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "UncommittedChangesReviewTarget",
          "type": "object"
        },
        {
          "description": "Review changes between the current branch and the given base branch.",
          "properties": {
            "branch": {
              "type": "string"
            },
            "type": {
              "enum": [
                "baseBranch"
              ],
              "title": "BaseBranchReviewTargetType",
              "type": "string"
            }
          },
          "required": [
            "branch",
            "type"
          ],
          "title": "BaseBranchReviewTarget",
          "type": "object"
        },
        {
          "description": "Review the changes introduced by a specific commit.",
          "properties": {
            "sha": {
              "type": "string"
            },
            "title": {
              "description": "Optional human-readable label (e.g., commit subject) for UIs.",
              "type": [
                "string",
                "null"
              ]
            },
            "type": {
              "enum": [
                "commit"
              ],
              "title": "CommitReviewTargetType",
              "type": "string"
            }
          },
          "required": [
            "sha",
            "type"
          ],
          "title": "CommitReviewTarget",
          "type": "object"
        },
        {
          "description": "Arbitrary instructions, equivalent to the old free-form prompt.",
          "properties": {
            "instructions": {
              "type": "string"
            },
            "type": {
              "enum": [
                "custom"
              ],
              "title": "CustomReviewTargetType",
              "type": "string"
            }
          },
          "required": [
            "instructions",
            "type"
          ],
          "title": "CustomReviewTarget",
          "type": "object"
        }
      ]
    },
    "SandboxMode": {
      "enum": [
        "read-only",
        "workspace-write",
        "danger-full-access"
      ],
      "type": "string"
    },
    "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"
        }
      ]
    },
    "SandboxWorkspaceWrite": {
      "properties": {
        "exclude_slash_tmp": {
          "default": false,
          "type": "boolean"
        },
        "exclude_tmpdir_env_var": {
          "default": false,
          "type": "boolean"
        },
        "network_access": {
          "default": false,
          "type": "boolean"
        },
        "writable_roots": {
          "default": [],
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "SendAddCreditsNudgeEmailParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "creditType": {
          "$ref": "#/definitions/AddCreditsNudgeCreditType"
        }
      },
      "required": [
        "creditType"
      ],
      "title": "SendAddCreditsNudgeEmailParams",
      "type": "object"
    },
    "SendAddCreditsNudgeEmailResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "status": {
          "$ref": "#/definitions/AddCreditsNudgeEmailStatus"
        }
      },
      "required": [
        "status"
      ],
      "title": "SendAddCreditsNudgeEmailResponse",
      "type": "object"
    },
    "ServerNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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/unarchived"
              ],
              "title": "Thread/unarchivedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadUnarchivedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/unarchivedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/closed"
              ],
              "title": "Thread/closedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadClosedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/closedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "skills/changed"
              ],
              "title": "Skills/changedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/SkillsChangedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Skills/changedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/name/updated"
              ],
              "title": "Thread/name/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadNameUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/name/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/goal/updated"
              ],
              "title": "Thread/goal/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadGoalUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/goal/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/goal/cleared"
              ],
              "title": "Thread/goal/clearedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadGoalClearedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/goal/clearedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/tokenUsage/updated"
              ],
              "title": "Thread/tokenUsage/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/tokenUsage/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "turn/started"
              ],
              "title": "Turn/startedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnStartedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Turn/startedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "hook/started"
              ],
              "title": "Hook/startedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/HookStartedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Hook/startedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "turn/completed"
              ],
              "title": "Turn/completedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Turn/completedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "hook/completed"
              ],
              "title": "Hook/completedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/HookCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Hook/completedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "turn/diff/updated"
              ],
              "title": "Turn/diff/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnDiffUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Turn/diff/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "turn/plan/updated"
              ],
              "title": "Turn/plan/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TurnPlanUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Turn/plan/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/started"
              ],
              "title": "Item/startedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ItemStartedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/startedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/autoApprovalReview/started"
              ],
              "title": "Item/autoApprovalReview/startedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ItemGuardianApprovalReviewStartedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/autoApprovalReview/startedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/autoApprovalReview/completed"
              ],
              "title": "Item/autoApprovalReview/completedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ItemGuardianApprovalReviewCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/autoApprovalReview/completedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/completed"
              ],
              "title": "Item/completedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ItemCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/completedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/agentMessage/delta"
              ],
              "title": "Item/agentMessage/deltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/AgentMessageDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/agentMessage/deltaNotification",
          "type": "object"
        },
        {
          "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.",
          "properties": {
            "method": {
              "enum": [
                "item/plan/delta"
              ],
              "title": "Item/plan/deltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/PlanDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/plan/deltaNotification",
          "type": "object"
        },
        {
          "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.",
          "properties": {
            "method": {
              "enum": [
                "command/exec/outputDelta"
              ],
              "title": "Command/exec/outputDeltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CommandExecOutputDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Command/exec/outputDeltaNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/commandExecution/outputDelta"
              ],
              "title": "Item/commandExecution/outputDeltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/CommandExecutionOutputDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/commandExecution/outputDeltaNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/commandExecution/terminalInteraction"
              ],
              "title": "Item/commandExecution/terminalInteractionNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/TerminalInteractionNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/commandExecution/terminalInteractionNotification",
          "type": "object"
        },
        {
          "description": "Deprecated legacy apply_patch output stream notification.",
          "properties": {
            "method": {
              "enum": [
                "item/fileChange/outputDelta"
              ],
              "title": "Item/fileChange/outputDeltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FileChangeOutputDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/fileChange/outputDeltaNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/fileChange/patchUpdated"
              ],
              "title": "Item/fileChange/patchUpdatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FileChangePatchUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/fileChange/patchUpdatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "serverRequest/resolved"
              ],
              "title": "ServerRequest/resolvedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ServerRequestResolvedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "ServerRequest/resolvedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "item/mcpToolCall/progress"
              ],
              "title": "Item/mcpToolCall/progressNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/McpToolCallProgressNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Item/mcpToolCall/progressNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "mcpServer/oauthLogin/completed"
              ],
              "title": "McpServer/oauthLogin/completedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/McpServerOauthLoginCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "McpServer/oauthLogin/completedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "mcpServer/startupStatus/updated"
              ],
              "title": "McpServer/startupStatus/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/McpServerStatusUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "McpServer/startupStatus/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "account/updated"
              ],
              "title": "Account/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/AccountUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Account/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "account/rateLimits/updated"
              ],
              "title": "Account/rateLimits/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/AccountRateLimitsUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Account/rateLimits/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "app/list/updated"
              ],
              "title": "App/list/updatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/AppListUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "App/list/updatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "remoteControl/status/changed"
              ],
              "title": "RemoteControl/status/changedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/RemoteControlStatusChangedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "RemoteControl/status/changedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "externalAgentConfig/import/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": [
                "warning"
              ],
              "title": "WarningNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/WarningNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "WarningNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "guardianWarning"
              ],
              "title": "GuardianWarningNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/GuardianWarningNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "GuardianWarningNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "deprecationNotice"
              ],
              "title": "DeprecationNoticeNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/DeprecationNoticeNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "DeprecationNoticeNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "configWarning"
              ],
              "title": "ConfigWarningNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ConfigWarningNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "ConfigWarningNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "fuzzyFileSearch/sessionUpdated"
              ],
              "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "FuzzyFileSearch/sessionUpdatedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "fuzzyFileSearch/sessionCompleted"
              ],
              "title": "FuzzyFileSearch/sessionCompletedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "FuzzyFileSearch/sessionCompletedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/started"
              ],
              "title": "Thread/realtime/startedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeStartedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/startedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/itemAdded"
              ],
              "title": "Thread/realtime/itemAddedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeItemAddedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/itemAddedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/transcript/delta"
              ],
              "title": "Thread/realtime/transcript/deltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeTranscriptDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/transcript/deltaNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/transcript/done"
              ],
              "title": "Thread/realtime/transcript/doneNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeTranscriptDoneNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/transcript/doneNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/outputAudio/delta"
              ],
              "title": "Thread/realtime/outputAudio/deltaNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeOutputAudioDeltaNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/outputAudio/deltaNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/sdp"
              ],
              "title": "Thread/realtime/sdpNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeSdpNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/sdpNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/error"
              ],
              "title": "Thread/realtime/errorNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeErrorNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/errorNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "thread/realtime/closed"
              ],
              "title": "Thread/realtime/closedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/ThreadRealtimeClosedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Thread/realtime/closedNotification",
          "type": "object"
        },
        {
          "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.",
          "properties": {
            "method": {
              "enum": [
                "windows/worldWritableWarning"
              ],
              "title": "Windows/worldWritableWarningNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/WindowsWorldWritableWarningNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Windows/worldWritableWarningNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "windowsSandbox/setupCompleted"
              ],
              "title": "WindowsSandbox/setupCompletedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/WindowsSandboxSetupCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "WindowsSandbox/setupCompletedNotification",
          "type": "object"
        },
        {
          "properties": {
            "method": {
              "enum": [
                "account/login/completed"
              ],
              "title": "Account/login/completedNotificationMethod",
              "type": "string"
            },
            "params": {
              "$ref": "#/definitions/AccountLoginCompletedNotification"
            }
          },
          "required": [
            "method",
            "params"
          ],
          "title": "Account/login/completedNotification",
          "type": "object"
        }
      ],
      "title": "ServerNotification"
    },
    "ServerRequestResolvedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "requestId": {
          "$ref": "#/definitions/RequestId"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "requestId",
        "threadId"
      ],
      "title": "ServerRequestResolvedNotification",
      "type": "object"
    },
    "ServiceTier": {
      "enum": [
        "fast",
        "flex"
      ],
      "type": "string"
    },
    "SessionMigration": {
      "properties": {
        "cwd": {
          "type": "string"
        },
        "path": {
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "cwd",
        "path"
      ],
      "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"
    },
    "SkillDependencies": {
      "properties": {
        "tools": {
          "items": {
            "$ref": "#/definitions/SkillToolDependency"
          },
          "type": "array"
        }
      },
      "required": [
        "tools"
      ],
      "type": "object"
    },
    "SkillErrorInfo": {
      "properties": {
        "message": {
          "type": "string"
        },
        "path": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "path"
      ],
      "type": "object"
    },
    "SkillInterface": {
      "properties": {
        "brandColor": {
          "type": [
            "string",
            "null"
          ]
        },
        "defaultPrompt": {
          "type": [
            "string",
            "null"
          ]
        },
        "displayName": {
          "type": [
            "string",
            "null"
          ]
        },
        "iconLarge": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "iconSmall": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "shortDescription": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "SkillMetadata": {
      "properties": {
        "dependencies": {
          "anyOf": [
            {
              "$ref": "#/definitions/SkillDependencies"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "type": "string"
        },
        "enabled": {
          "type": "boolean"
        },
        "interface": {
          "anyOf": [
            {
              "$ref": "#/definitions/SkillInterface"
            },
            {
              "type": "null"
            }
          ]
        },
        "name": {
          "type": "string"
        },
        "path": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "scope": {
          "$ref": "#/definitions/SkillScope"
        },
        "shortDescription": {
          "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "description",
        "enabled",
        "name",
        "path",
        "scope"
      ],
      "type": "object"
    },
    "SkillScope": {
      "enum": [
        "user",
        "repo",
        "system",
        "admin"
      ],
      "type": "string"
    },
    "SkillSummary": {
      "properties": {
        "description": {
          "type": "string"
        },
        "enabled": {
          "type": "boolean"
        },
        "interface": {
          "anyOf": [
            {
              "$ref": "#/definitions/SkillInterface"
            },
            {
              "type": "null"
            }
          ]
        },
        "name": {
          "type": "string"
        },
        "path": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "shortDescription": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "description",
        "enabled",
        "name"
      ],
      "type": "object"
    },
    "SkillToolDependency": {
      "properties": {
        "command": {
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "transport": {
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "type": "string"
        },
        "url": {
          "type": [
            "string",
            "null"
          ]
        },
        "value": {
          "type": "string"
        }
      },
      "required": [
        "type",
        "value"
      ],
      "type": "object"
    },
    "SkillsChangedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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.",
      "title": "SkillsChangedNotification",
      "type": "object"
    },
    "SkillsConfigWriteParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "enabled": {
          "type": "boolean"
        },
        "name": {
          "description": "Name-based selector.",
          "type": [
            "string",
            "null"
          ]
        },
        "path": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ],
          "description": "Path-based selector."
        }
      },
      "required": [
        "enabled"
      ],
      "title": "SkillsConfigWriteParams",
      "type": "object"
    },
    "SkillsConfigWriteResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "effectiveEnabled": {
          "type": "boolean"
        }
      },
      "required": [
        "effectiveEnabled"
      ],
      "title": "SkillsConfigWriteResponse",
      "type": "object"
    },
    "SkillsListEntry": {
      "properties": {
        "cwd": {
          "type": "string"
        },
        "errors": {
          "items": {
            "$ref": "#/definitions/SkillErrorInfo"
          },
          "type": "array"
        },
        "skills": {
          "items": {
            "$ref": "#/definitions/SkillMetadata"
          },
          "type": "array"
        }
      },
      "required": [
        "cwd",
        "errors",
        "skills"
      ],
      "type": "object"
    },
    "SkillsListExtraRootsForCwd": {
      "properties": {
        "cwd": {
          "type": "string"
        },
        "extraUserRoots": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "cwd",
        "extraUserRoots"
      ],
      "type": "object"
    },
    "SkillsListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cwds": {
          "description": "When empty, defaults to the current session working directory.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "forceReload": {
          "description": "When true, bypass the skills cache and re-scan skills from disk.",
          "type": "boolean"
        },
        "perCwdExtraUserRoots": {
          "default": null,
          "description": "Optional per-cwd extra roots to scan as user-scoped skills.",
          "items": {
            "$ref": "#/definitions/SkillsListExtraRootsForCwd"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "title": "SkillsListParams",
      "type": "object"
    },
    "SkillsListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "items": {
            "$ref": "#/definitions/SkillsListEntry"
          },
          "type": "array"
        }
      },
      "required": [
        "data"
      ],
      "title": "SkillsListResponse",
      "type": "object"
    },
    "SortDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "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"
        }
      ]
    },
    "SubagentMigration": {
      "properties": {
        "name": {
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "TerminalInteractionNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "itemId": {
          "type": "string"
        },
        "processId": {
          "type": "string"
        },
        "stdin": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "itemId",
        "processId",
        "stdin",
        "threadId",
        "turnId"
      ],
      "title": "TerminalInteractionNotification",
      "type": "object"
    },
    "TextElement": {
      "properties": {
        "byteRange": {
          "allOf": [
            {
              "$ref": "#/definitions/ByteRange"
            }
          ],
          "description": "Byte range in the parent `text` buffer that this element occupies."
        },
        "placeholder": {
          "description": "Optional human-readable placeholder for the element, displayed in the UI.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "byteRange"
      ],
      "type": "object"
    },
    "TextPosition": {
      "properties": {
        "column": {
          "description": "1-based column number (in Unicode scalar values).",
          "format": "uint",
          "minimum": 0.0,
          "type": "integer"
        },
        "line": {
          "description": "1-based line number.",
          "format": "uint",
          "minimum": 0.0,
          "type": "integer"
        }
      },
      "required": [
        "column",
        "line"
      ],
      "type": "object"
    },
    "TextRange": {
      "properties": {
        "end": {
          "$ref": "#/definitions/TextPosition"
        },
        "start": {
          "$ref": "#/definitions/TextPosition"
        }
      },
      "required": [
        "end",
        "start"
      ],
      "type": "object"
    },
    "Thread": {
      "properties": {
        "agentNickname": {
          "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.",
          "type": [
            "string",
            "null"
          ]
        },
        "agentRole": {
          "description": "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.",
          "type": [
            "string",
            "null"
          ]
        },
        "cliVersion": {
          "description": "Version of the CLI that created the thread.",
          "type": "string"
        },
        "createdAt": {
          "description": "Unix timestamp (in seconds) when the thread was created.",
          "format": "int64",
          "type": "integer"
        },
        "cwd": {
          "allOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            }
          ],
          "description": "Working directory captured for the thread."
        },
        "ephemeral": {
          "description": "Whether the thread is ephemeral and should not be materialized on disk.",
          "type": "boolean"
        },
        "forkedFromId": {
          "description": "Source thread id when this thread was created by forking another thread.",
          "type": [
            "string",
            "null"
          ]
        },
        "gitInfo": {
          "anyOf": [
            {
              "$ref": "#/definitions/GitInfo"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional Git metadata captured when the thread was created."
        },
        "id": {
          "type": "string"
        },
        "modelProvider": {
          "description": "Model provider used for this thread (for example, 'openai').",
          "type": "string"
        },
        "name": {
          "description": "Optional user-facing thread title.",
          "type": [
            "string",
            "null"
          ]
        },
        "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"
        },
        "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."
        },
        "turns": {
          "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
          "items": {
            "$ref": "#/definitions/Turn"
          },
          "type": "array"
        },
        "updatedAt": {
          "description": "Unix timestamp (in seconds) when the thread was last updated.",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "cliVersion",
        "createdAt",
        "cwd",
        "ephemeral",
        "id",
        "modelProvider",
        "preview",
        "source",
        "status",
        "turns",
        "updatedAt"
      ],
      "type": "object"
    },
    "ThreadActiveFlag": {
      "enum": [
        "waitingOnApproval",
        "waitingOnUserInput"
      ],
      "type": "string"
    },
    "ThreadApproveGuardianDeniedActionParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "event": {
          "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`."
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "event",
        "threadId"
      ],
      "title": "ThreadApproveGuardianDeniedActionParams",
      "type": "object"
    },
    "ThreadApproveGuardianDeniedActionResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ThreadApproveGuardianDeniedActionResponse",
      "type": "object"
    },
    "ThreadArchiveParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadArchiveParams",
      "type": "object"
    },
    "ThreadArchiveResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ThreadArchiveResponse",
      "type": "object"
    },
    "ThreadArchivedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadArchivedNotification",
      "type": "object"
    },
    "ThreadClosedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadClosedNotification",
      "type": "object"
    },
    "ThreadCompactStartParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadCompactStartParams",
      "type": "object"
    },
    "ThreadCompactStartResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ThreadCompactStartResponse",
      "type": "object"
    },
    "ThreadForkParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
      "properties": {
        "approvalPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/AskForApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "approvalsReviewer": {
          "anyOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override where approval requests are routed for review on this thread and subsequent turns."
        },
        "baseInstructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "config": {
          "additionalProperties": true,
          "type": [
            "object",
            "null"
          ]
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "developerInstructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "ephemeral": {
          "type": "boolean"
        },
        "model": {
          "description": "Configuration overrides for the forked thread, if any.",
          "type": [
            "string",
            "null"
          ]
        },
        "modelProvider": {
          "type": [
            "string",
            "null"
          ]
        },
        "sandbox": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxMode"
            },
            {
              "type": "null"
            }
          ]
        },
        "serviceTier": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/definitions/ServiceTier"
                },
                {
                  "type": "null"
                }
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadForkParams",
      "type": "object"
    },
    "ThreadForkResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "approvalPolicy": {
          "$ref": "#/definitions/AskForApproval"
        },
        "approvalsReviewer": {
          "allOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            }
          ],
          "description": "Reviewer currently used for approval requests on this thread."
        },
        "cwd": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "instructionSources": {
          "default": [],
          "description": "Instruction source files currently loaded for this thread.",
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": "array"
        },
        "model": {
          "type": "string"
        },
        "modelProvider": {
          "type": "string"
        },
        "reasoningEffort": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningEffort"
            },
            {
              "type": "null"
            }
          ]
        },
        "sandbox": {
          "allOf": [
            {
              "$ref": "#/definitions/SandboxPolicy"
            }
          ],
          "description": "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `permissionProfile` when they need exact runtime permissions."
        },
        "serviceTier": {
          "anyOf": [
            {
              "$ref": "#/definitions/ServiceTier"
            },
            {
              "type": "null"
            }
          ]
        },
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "approvalPolicy",
        "approvalsReviewer",
        "cwd",
        "model",
        "modelProvider",
        "sandbox",
        "thread"
      ],
      "title": "ThreadForkResponse",
      "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": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadGoalClearedNotification",
      "type": "object"
    },
    "ThreadGoalStatus": {
      "enum": [
        "active",
        "paused",
        "budgetLimited",
        "complete"
      ],
      "type": "string"
    },
    "ThreadGoalUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "goal": {
          "$ref": "#/definitions/ThreadGoal"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "goal",
        "threadId"
      ],
      "title": "ThreadGoalUpdatedNotification",
      "type": "object"
    },
    "ThreadId": {
      "type": "string"
    },
    "ThreadInjectItemsParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "items": {
          "description": "Raw Responses API items to append to the thread's model-visible history.",
          "items": true,
          "type": "array"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "items",
        "threadId"
      ],
      "title": "ThreadInjectItemsParams",
      "type": "object"
    },
    "ThreadInjectItemsResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ThreadInjectItemsResponse",
      "type": "object"
    },
    "ThreadItem": {
      "oneOf": [
        {
          "properties": {
            "content": {
              "items": {
                "$ref": "#/definitions/UserInput"
              },
              "type": "array"
            },
            "id": {
              "type": "string"
            },
            "type": {
              "enum": [
                "userMessage"
              ],
              "title": "UserMessageThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "content",
            "id",
            "type"
          ],
          "title": "UserMessageThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "fragments": {
              "items": {
                "$ref": "#/definitions/HookPromptFragment"
              },
              "type": "array"
            },
            "id": {
              "type": "string"
            },
            "type": {
              "enum": [
                "hookPrompt"
              ],
              "title": "HookPromptThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "fragments",
            "id",
            "type"
          ],
          "title": "HookPromptThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "memoryCitation": {
              "anyOf": [
                {
                  "$ref": "#/definitions/MemoryCitation"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            },
            "phase": {
              "anyOf": [
                {
                  "$ref": "#/definitions/MessagePhase"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            },
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "agentMessage"
              ],
              "title": "AgentMessageThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "text",
            "type"
          ],
          "title": "AgentMessageThreadItem",
          "type": "object"
        },
        {
          "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.",
          "properties": {
            "id": {
              "type": "string"
            },
            "text": {
              "type": "string"
            },
            "type": {
              "enum": [
                "plan"
              ],
              "title": "PlanThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "text",
            "type"
          ],
          "title": "PlanThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "content": {
              "default": [],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "id": {
              "type": "string"
            },
            "summary": {
              "default": [],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": {
              "enum": [
                "reasoning"
              ],
              "title": "ReasoningThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "type"
          ],
          "title": "ReasoningThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "aggregatedOutput": {
              "description": "The command's output, aggregated from stdout and stderr.",
              "type": [
                "string",
                "null"
              ]
            },
            "command": {
              "description": "The command to be executed.",
              "type": "string"
            },
            "commandActions": {
              "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
              "items": {
                "$ref": "#/definitions/CommandAction"
              },
              "type": "array"
            },
            "cwd": {
              "allOf": [
                {
                  "$ref": "#/definitions/AbsolutePathBuf"
                }
              ],
              "description": "The command's working directory."
            },
            "durationMs": {
              "description": "The duration of the command execution in milliseconds.",
              "format": "int64",
              "type": [
                "integer",
                "null"
              ]
            },
            "exitCode": {
              "description": "The command's exit code.",
              "format": "int32",
              "type": [
                "integer",
                "null"
              ]
            },
            "id": {
              "type": "string"
            },
            "processId": {
              "description": "Identifier for the underlying PTY process (when available).",
              "type": [
                "string",
                "null"
              ]
            },
            "source": {
              "allOf": [
                {
                  "$ref": "#/definitions/CommandExecutionSource"
                }
              ],
              "default": "agent"
            },
            "status": {
              "$ref": "#/definitions/CommandExecutionStatus"
            },
            "type": {
              "enum": [
                "commandExecution"
              ],
              "title": "CommandExecutionThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "command",
            "commandActions",
            "cwd",
            "id",
            "status",
            "type"
          ],
          "title": "CommandExecutionThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "changes": {
              "items": {
                "$ref": "#/definitions/FileUpdateChange"
              },
              "type": "array"
            },
            "id": {
              "type": "string"
            },
            "status": {
              "$ref": "#/definitions/PatchApplyStatus"
            },
            "type": {
              "enum": [
                "fileChange"
              ],
              "title": "FileChangeThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "changes",
            "id",
            "status",
            "type"
          ],
          "title": "FileChangeThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "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": {
              "type": [
                "string",
                "null"
              ]
            },
            "result": {
              "anyOf": [
                {
                  "$ref": "#/definitions/McpToolCallResult"
                },
                {
                  "type": "null"
                }
              ]
            },
            "server": {
              "type": "string"
            },
            "status": {
              "$ref": "#/definitions/McpToolCallStatus"
            },
            "tool": {
              "type": "string"
            },
            "type": {
              "enum": [
                "mcpToolCall"
              ],
              "title": "McpToolCallThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "arguments",
            "id",
            "server",
            "status",
            "tool",
            "type"
          ],
          "title": "McpToolCallThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "arguments": true,
            "contentItems": {
              "items": {
                "$ref": "#/definitions/DynamicToolCallOutputContentItem"
              },
              "type": [
                "array",
                "null"
              ]
            },
            "durationMs": {
              "description": "The duration of the dynamic tool call in milliseconds.",
              "format": "int64",
              "type": [
                "integer",
                "null"
              ]
            },
            "id": {
              "type": "string"
            },
            "namespace": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "$ref": "#/definitions/DynamicToolCallStatus"
            },
            "success": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "tool": {
              "type": "string"
            },
            "type": {
              "enum": [
                "dynamicToolCall"
              ],
              "title": "DynamicToolCallThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "arguments",
            "id",
            "status",
            "tool",
            "type"
          ],
          "title": "DynamicToolCallThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "agentsStates": {
              "additionalProperties": {
                "$ref": "#/definitions/CollabAgentState"
              },
              "description": "Last known status of the target agents, when available.",
              "type": "object"
            },
            "id": {
              "description": "Unique identifier for this collab tool call.",
              "type": "string"
            },
            "model": {
              "description": "Model requested for the spawned agent, when applicable.",
              "type": [
                "string",
                "null"
              ]
            },
            "prompt": {
              "description": "Prompt text sent as part of the collab tool call, when available.",
              "type": [
                "string",
                "null"
              ]
            },
            "reasoningEffort": {
              "anyOf": [
                {
                  "$ref": "#/definitions/ReasoningEffort"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Reasoning effort requested for the spawned agent, when applicable."
            },
            "receiverThreadIds": {
              "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "senderThreadId": {
              "description": "Thread ID of the agent issuing the collab request.",
              "type": "string"
            },
            "status": {
              "allOf": [
                {
                  "$ref": "#/definitions/CollabAgentToolCallStatus"
                }
              ],
              "description": "Current status of the collab tool call."
            },
            "tool": {
              "allOf": [
                {
                  "$ref": "#/definitions/CollabAgentTool"
                }
              ],
              "description": "Name of the collab tool that was invoked."
            },
            "type": {
              "enum": [
                "collabAgentToolCall"
              ],
              "title": "CollabAgentToolCallThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "agentsStates",
            "id",
            "receiverThreadIds",
            "senderThreadId",
            "status",
            "tool",
            "type"
          ],
          "title": "CollabAgentToolCallThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "action": {
              "anyOf": [
                {
                  "$ref": "#/definitions/WebSearchAction"
                },
                {
                  "type": "null"
                }
              ]
            },
            "id": {
              "type": "string"
            },
            "query": {
              "type": "string"
            },
            "type": {
              "enum": [
                "webSearch"
              ],
              "title": "WebSearchThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "query",
            "type"
          ],
          "title": "WebSearchThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "path": {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            "type": {
              "enum": [
                "imageView"
              ],
              "title": "ImageViewThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "path",
            "type"
          ],
          "title": "ImageViewThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "result": {
              "type": "string"
            },
            "revisedPrompt": {
              "type": [
                "string",
                "null"
              ]
            },
            "savedPath": {
              "anyOf": [
                {
                  "$ref": "#/definitions/AbsolutePathBuf"
                },
                {
                  "type": "null"
                }
              ]
            },
            "status": {
              "type": "string"
            },
            "type": {
              "enum": [
                "imageGeneration"
              ],
              "title": "ImageGenerationThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "result",
            "status",
            "type"
          ],
          "title": "ImageGenerationThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "review": {
              "type": "string"
            },
            "type": {
              "enum": [
                "enteredReviewMode"
              ],
              "title": "EnteredReviewModeThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "review",
            "type"
          ],
          "title": "EnteredReviewModeThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "review": {
              "type": "string"
            },
            "type": {
              "enum": [
                "exitedReviewMode"
              ],
              "title": "ExitedReviewModeThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "review",
            "type"
          ],
          "title": "ExitedReviewModeThreadItem",
          "type": "object"
        },
        {
          "properties": {
            "id": {
              "type": "string"
            },
            "type": {
              "enum": [
                "contextCompaction"
              ],
              "title": "ContextCompactionThreadItemType",
              "type": "string"
            }
          },
          "required": [
            "id",
            "type"
          ],
          "title": "ContextCompactionThreadItem",
          "type": "object"
        }
      ]
    },
    "ThreadListCwdFilter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ]
    },
    "ThreadListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "archived": {
          "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.",
          "type": [
            "boolean",
            "null"
          ]
        },
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous call.",
          "type": [
            "string",
            "null"
          ]
        },
        "cwd": {
          "anyOf": [
            {
              "$ref": "#/definitions/ThreadListCwdFilter"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned."
        },
        "limit": {
          "description": "Optional page size; defaults to a reasonable server-side value.",
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        },
        "modelProviders": {
          "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "searchTerm": {
          "description": "Optional substring filter for the extracted thread title.",
          "type": [
            "string",
            "null"
          ]
        },
        "sortDirection": {
          "anyOf": [
            {
              "$ref": "#/definitions/SortDirection"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional sort direction; defaults to descending (newest first)."
        },
        "sortKey": {
          "anyOf": [
            {
              "$ref": "#/definitions/ThreadSortKey"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional sort key; defaults to created_at."
        },
        "sourceKinds": {
          "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.",
          "items": {
            "$ref": "#/definitions/ThreadSourceKind"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "useStateDbOnly": {
          "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.",
          "type": "boolean"
        }
      },
      "title": "ThreadListParams",
      "type": "object"
    },
    "ThreadListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "backwardsCursor": {
          "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.",
          "type": [
            "string",
            "null"
          ]
        },
        "data": {
          "items": {
            "$ref": "#/definitions/Thread"
          },
          "type": "array"
        },
        "nextCursor": {
          "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "data"
      ],
      "title": "ThreadListResponse",
      "type": "object"
    },
    "ThreadLoadedListParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous call.",
          "type": [
            "string",
            "null"
          ]
        },
        "limit": {
          "description": "Optional page size; defaults to no limit.",
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "title": "ThreadLoadedListParams",
      "type": "object"
    },
    "ThreadLoadedListResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "data": {
          "description": "Thread ids for sessions currently loaded in memory.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "nextCursor": {
          "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "data"
      ],
      "title": "ThreadLoadedListResponse",
      "type": "object"
    },
    "ThreadMemoryMode": {
      "enum": [
        "enabled",
        "disabled"
      ],
      "type": "string"
    },
    "ThreadMetadataGitInfoUpdateParams": {
      "properties": {
        "branch": {
          "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.",
          "type": [
            "string",
            "null"
          ]
        },
        "originUrl": {
          "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.",
          "type": [
            "string",
            "null"
          ]
        },
        "sha": {
          "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "ThreadMetadataUpdateParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "gitInfo": {
          "anyOf": [
            {
              "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams"
            },
            {
              "type": "null"
            }
          ],
          "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value."
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadMetadataUpdateParams",
      "type": "object"
    },
    "ThreadMetadataUpdateResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "thread"
      ],
      "title": "ThreadMetadataUpdateResponse",
      "type": "object"
    },
    "ThreadNameUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "threadName": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadNameUpdatedNotification",
      "type": "object"
    },
    "ThreadReadParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "includeTurns": {
          "default": false,
          "description": "When true, include turns and their items from rollout history.",
          "type": "boolean"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadReadParams",
      "type": "object"
    },
    "ThreadReadResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "thread"
      ],
      "title": "ThreadReadResponse",
      "type": "object"
    },
    "ThreadRealtimeAudioChunk": {
      "description": "EXPERIMENTAL - thread realtime audio chunk.",
      "properties": {
        "data": {
          "type": "string"
        },
        "itemId": {
          "type": [
            "string",
            "null"
          ]
        },
        "numChannels": {
          "format": "uint16",
          "minimum": 0.0,
          "type": "integer"
        },
        "sampleRate": {
          "format": "uint32",
          "minimum": 0.0,
          "type": "integer"
        },
        "samplesPerChannel": {
          "format": "uint32",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "data",
        "numChannels",
        "sampleRate"
      ],
      "type": "object"
    },
    "ThreadRealtimeClosedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - emitted when thread realtime transport closes.",
      "properties": {
        "reason": {
          "type": [
            "string",
            "null"
          ]
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadRealtimeClosedNotification",
      "type": "object"
    },
    "ThreadRealtimeErrorNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.",
      "properties": {
        "message": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "threadId"
      ],
      "title": "ThreadRealtimeErrorNotification",
      "type": "object"
    },
    "ThreadRealtimeItemAddedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.",
      "properties": {
        "item": true,
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "item",
        "threadId"
      ],
      "title": "ThreadRealtimeItemAddedNotification",
      "type": "object"
    },
    "ThreadRealtimeOutputAudioDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.",
      "properties": {
        "audio": {
          "$ref": "#/definitions/ThreadRealtimeAudioChunk"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "audio",
        "threadId"
      ],
      "title": "ThreadRealtimeOutputAudioDeltaNotification",
      "type": "object"
    },
    "ThreadRealtimeSdpNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.",
      "properties": {
        "sdp": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "sdp",
        "threadId"
      ],
      "title": "ThreadRealtimeSdpNotification",
      "type": "object"
    },
    "ThreadRealtimeStartTransport": {
      "description": "EXPERIMENTAL - transport used by thread realtime.",
      "oneOf": [
        {
          "properties": {
            "type": {
              "enum": [
                "websocket"
              ],
              "title": "WebsocketThreadRealtimeStartTransportType",
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "title": "WebsocketThreadRealtimeStartTransport",
          "type": "object"
        },
        {
          "properties": {
            "sdp": {
              "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.",
              "type": "string"
            },
            "type": {
              "enum": [
                "webrtc"
              ],
              "title": "WebrtcThreadRealtimeStartTransportType",
              "type": "string"
            }
          },
          "required": [
            "sdp",
            "type"
          ],
          "title": "WebrtcThreadRealtimeStartTransport",
          "type": "object"
        }
      ]
    },
    "ThreadRealtimeStartedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.",
      "properties": {
        "realtimeSessionId": {
          "type": [
            "string",
            "null"
          ]
        },
        "threadId": {
          "type": "string"
        },
        "version": {
          "$ref": "#/definitions/RealtimeConversationVersion"
        }
      },
      "required": [
        "threadId",
        "version"
      ],
      "title": "ThreadRealtimeStartedNotification",
      "type": "object"
    },
    "ThreadRealtimeTranscriptDeltaNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "ThreadRealtimeTranscriptDeltaNotification",
      "type": "object"
    },
    "ThreadRealtimeTranscriptDoneNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "ThreadRealtimeTranscriptDoneNotification",
      "type": "object"
    },
    "ThreadResumeParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
      "properties": {
        "approvalPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/AskForApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "approvalsReviewer": {
          "anyOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override where approval requests are routed for review on this thread and subsequent turns."
        },
        "baseInstructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "config": {
          "additionalProperties": true,
          "type": [
            "object",
            "null"
          ]
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "developerInstructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "model": {
          "description": "Configuration overrides for the resumed thread, if any.",
          "type": [
            "string",
            "null"
          ]
        },
        "modelProvider": {
          "type": [
            "string",
            "null"
          ]
        },
        "personality": {
          "anyOf": [
            {
              "$ref": "#/definitions/Personality"
            },
            {
              "type": "null"
            }
          ]
        },
        "sandbox": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxMode"
            },
            {
              "type": "null"
            }
          ]
        },
        "serviceTier": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/definitions/ServiceTier"
                },
                {
                  "type": "null"
                }
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadResumeParams",
      "type": "object"
    },
    "ThreadResumeResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "approvalPolicy": {
          "$ref": "#/definitions/AskForApproval"
        },
        "approvalsReviewer": {
          "allOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            }
          ],
          "description": "Reviewer currently used for approval requests on this thread."
        },
        "cwd": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "instructionSources": {
          "default": [],
          "description": "Instruction source files currently loaded for this thread.",
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": "array"
        },
        "model": {
          "type": "string"
        },
        "modelProvider": {
          "type": "string"
        },
        "reasoningEffort": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningEffort"
            },
            {
              "type": "null"
            }
          ]
        },
        "sandbox": {
          "allOf": [
            {
              "$ref": "#/definitions/SandboxPolicy"
            }
          ],
          "description": "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `permissionProfile` when they need exact runtime permissions."
        },
        "serviceTier": {
          "anyOf": [
            {
              "$ref": "#/definitions/ServiceTier"
            },
            {
              "type": "null"
            }
          ]
        },
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "approvalPolicy",
        "approvalsReviewer",
        "cwd",
        "model",
        "modelProvider",
        "sandbox",
        "thread"
      ],
      "title": "ThreadResumeResponse",
      "type": "object"
    },
    "ThreadRollbackParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "numTurns": {
          "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.",
          "format": "uint32",
          "minimum": 0.0,
          "type": "integer"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "numTurns",
        "threadId"
      ],
      "title": "ThreadRollbackParams",
      "type": "object"
    },
    "ThreadRollbackResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "thread": {
          "allOf": [
            {
              "$ref": "#/definitions/Thread"
            }
          ],
          "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`."
        }
      },
      "required": [
        "thread"
      ],
      "title": "ThreadRollbackResponse",
      "type": "object"
    },
    "ThreadSetNameParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "name": {
          "type": "string"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "threadId"
      ],
      "title": "ThreadSetNameParams",
      "type": "object"
    },
    "ThreadSetNameResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ThreadSetNameResponse",
      "type": "object"
    },
    "ThreadShellCommandParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "command": {
          "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.",
          "type": "string"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "command",
        "threadId"
      ],
      "title": "ThreadShellCommandParams",
      "type": "object"
    },
    "ThreadShellCommandResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "ThreadShellCommandResponse",
      "type": "object"
    },
    "ThreadSortKey": {
      "enum": [
        "created_at",
        "updated_at"
      ],
      "type": "string"
    },
    "ThreadSourceKind": {
      "enum": [
        "cli",
        "vscode",
        "exec",
        "appServer",
        "subAgent",
        "subAgentReview",
        "subAgentCompact",
        "subAgentThreadSpawn",
        "subAgentOther",
        "unknown"
      ],
      "type": "string"
    },
    "ThreadStartParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "approvalPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/AskForApproval"
            },
            {
              "type": "null"
            }
          ]
        },
        "approvalsReviewer": {
          "anyOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override where approval requests are routed for review on this thread and subsequent turns."
        },
        "baseInstructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "config": {
          "additionalProperties": true,
          "type": [
            "object",
            "null"
          ]
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "developerInstructions": {
          "type": [
            "string",
            "null"
          ]
        },
        "ephemeral": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "model": {
          "type": [
            "string",
            "null"
          ]
        },
        "modelProvider": {
          "type": [
            "string",
            "null"
          ]
        },
        "personality": {
          "anyOf": [
            {
              "$ref": "#/definitions/Personality"
            },
            {
              "type": "null"
            }
          ]
        },
        "sandbox": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxMode"
            },
            {
              "type": "null"
            }
          ]
        },
        "serviceName": {
          "type": [
            "string",
            "null"
          ]
        },
        "serviceTier": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/definitions/ServiceTier"
                },
                {
                  "type": "null"
                }
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "sessionStartSource": {
          "anyOf": [
            {
              "$ref": "#/definitions/ThreadStartSource"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "title": "ThreadStartParams",
      "type": "object"
    },
    "ThreadStartResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "approvalPolicy": {
          "$ref": "#/definitions/AskForApproval"
        },
        "approvalsReviewer": {
          "allOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            }
          ],
          "description": "Reviewer currently used for approval requests on this thread."
        },
        "cwd": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "instructionSources": {
          "default": [],
          "description": "Instruction source files currently loaded for this thread.",
          "items": {
            "$ref": "#/definitions/AbsolutePathBuf"
          },
          "type": "array"
        },
        "model": {
          "type": "string"
        },
        "modelProvider": {
          "type": "string"
        },
        "reasoningEffort": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningEffort"
            },
            {
              "type": "null"
            }
          ]
        },
        "sandbox": {
          "allOf": [
            {
              "$ref": "#/definitions/SandboxPolicy"
            }
          ],
          "description": "Legacy sandbox policy retained for compatibility. Experimental clients should prefer `permissionProfile` when they need exact runtime permissions."
        },
        "serviceTier": {
          "anyOf": [
            {
              "$ref": "#/definitions/ServiceTier"
            },
            {
              "type": "null"
            }
          ]
        },
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "approvalPolicy",
        "approvalsReviewer",
        "cwd",
        "model",
        "modelProvider",
        "sandbox",
        "thread"
      ],
      "title": "ThreadStartResponse",
      "type": "object"
    },
    "ThreadStartSource": {
      "enum": [
        "startup",
        "clear"
      ],
      "type": "string"
    },
    "ThreadStartedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "thread"
      ],
      "title": "ThreadStartedNotification",
      "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": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "status": {
          "$ref": "#/definitions/ThreadStatus"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "threadId"
      ],
      "title": "ThreadStatusChangedNotification",
      "type": "object"
    },
    "ThreadTokenUsage": {
      "properties": {
        "last": {
          "$ref": "#/definitions/TokenUsageBreakdown"
        },
        "modelContextWindow": {
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "total": {
          "$ref": "#/definitions/TokenUsageBreakdown"
        }
      },
      "required": [
        "last",
        "total"
      ],
      "type": "object"
    },
    "ThreadTokenUsageUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "tokenUsage": {
          "$ref": "#/definitions/ThreadTokenUsage"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "threadId",
        "tokenUsage",
        "turnId"
      ],
      "title": "ThreadTokenUsageUpdatedNotification",
      "type": "object"
    },
    "ThreadUnarchiveParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadUnarchiveParams",
      "type": "object"
    },
    "ThreadUnarchiveResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "thread": {
          "$ref": "#/definitions/Thread"
        }
      },
      "required": [
        "thread"
      ],
      "title": "ThreadUnarchiveResponse",
      "type": "object"
    },
    "ThreadUnarchivedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadUnarchivedNotification",
      "type": "object"
    },
    "ThreadUnsubscribeParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "threadId"
      ],
      "title": "ThreadUnsubscribeParams",
      "type": "object"
    },
    "ThreadUnsubscribeResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "status": {
          "$ref": "#/definitions/ThreadUnsubscribeStatus"
        }
      },
      "required": [
        "status"
      ],
      "title": "ThreadUnsubscribeResponse",
      "type": "object"
    },
    "ThreadUnsubscribeStatus": {
      "enum": [
        "notLoaded",
        "notSubscribed",
        "unsubscribed"
      ],
      "type": "string"
    },
    "TokenUsageBreakdown": {
      "properties": {
        "cachedInputTokens": {
          "format": "int64",
          "type": "integer"
        },
        "inputTokens": {
          "format": "int64",
          "type": "integer"
        },
        "outputTokens": {
          "format": "int64",
          "type": "integer"
        },
        "reasoningOutputTokens": {
          "format": "int64",
          "type": "integer"
        },
        "totalTokens": {
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "cachedInputTokens",
        "inputTokens",
        "outputTokens",
        "reasoningOutputTokens",
        "totalTokens"
      ],
      "type": "object"
    },
    "Tool": {
      "description": "Definition for a tool the client can call.",
      "properties": {
        "_meta": true,
        "annotations": true,
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "icons": {
          "items": true,
          "type": [
            "array",
            "null"
          ]
        },
        "inputSchema": true,
        "name": {
          "type": "string"
        },
        "outputSchema": true,
        "title": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "inputSchema",
        "name"
      ],
      "type": "object"
    },
    "ToolsV2": {
      "properties": {
        "view_image": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "web_search": {
          "anyOf": [
            {
              "$ref": "#/definitions/WebSearchToolConfig"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    },
    "Turn": {
      "properties": {
        "completedAt": {
          "description": "Unix timestamp (in seconds) when the turn completed.",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "durationMs": {
          "description": "Duration between turn start and completion in milliseconds, if known.",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "error": {
          "anyOf": [
            {
              "$ref": "#/definitions/TurnError"
            },
            {
              "type": "null"
            }
          ],
          "description": "Only populated when the Turn's status is failed."
        },
        "id": {
          "type": "string"
        },
        "items": {
          "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.",
          "items": {
            "$ref": "#/definitions/ThreadItem"
          },
          "type": "array"
        },
        "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": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "turn": {
          "$ref": "#/definitions/Turn"
        }
      },
      "required": [
        "threadId",
        "turn"
      ],
      "title": "TurnCompletedNotification",
      "type": "object"
    },
    "TurnDiffUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "TurnDiffUpdatedNotification",
      "type": "object"
    },
    "TurnEnvironmentParams": {
      "properties": {
        "cwd": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "environmentId": {
          "type": "string"
        }
      },
      "required": [
        "cwd",
        "environmentId"
      ],
      "type": "object"
    },
    "TurnError": {
      "properties": {
        "additionalDetails": {
          "default": null,
          "type": [
            "string",
            "null"
          ]
        },
        "codexErrorInfo": {
          "anyOf": [
            {
              "$ref": "#/definitions/CodexErrorInfo"
            },
            {
              "type": "null"
            }
          ]
        },
        "message": {
          "type": "string"
        }
      },
      "required": [
        "message"
      ],
      "type": "object"
    },
    "TurnInterruptParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "threadId",
        "turnId"
      ],
      "title": "TurnInterruptParams",
      "type": "object"
    },
    "TurnInterruptResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "TurnInterruptResponse",
      "type": "object"
    },
    "TurnPlanStep": {
      "properties": {
        "status": {
          "$ref": "#/definitions/TurnPlanStepStatus"
        },
        "step": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "step"
      ],
      "type": "object"
    },
    "TurnPlanStepStatus": {
      "enum": [
        "pending",
        "inProgress",
        "completed"
      ],
      "type": "string"
    },
    "TurnPlanUpdatedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "explanation": {
          "type": [
            "string",
            "null"
          ]
        },
        "plan": {
          "items": {
            "$ref": "#/definitions/TurnPlanStep"
          },
          "type": "array"
        },
        "threadId": {
          "type": "string"
        },
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "plan",
        "threadId",
        "turnId"
      ],
      "title": "TurnPlanUpdatedNotification",
      "type": "object"
    },
    "TurnStartParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "approvalPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/AskForApproval"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override the approval policy for this turn and subsequent turns."
        },
        "approvalsReviewer": {
          "anyOf": [
            {
              "$ref": "#/definitions/ApprovalsReviewer"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override where approval requests are routed for review on this turn and subsequent turns."
        },
        "cwd": {
          "description": "Override the working directory for this turn and subsequent turns.",
          "type": [
            "string",
            "null"
          ]
        },
        "effort": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningEffort"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override the reasoning effort for this turn and subsequent turns."
        },
        "input": {
          "items": {
            "$ref": "#/definitions/UserInput"
          },
          "type": "array"
        },
        "model": {
          "description": "Override the model for this turn and subsequent turns.",
          "type": [
            "string",
            "null"
          ]
        },
        "outputSchema": {
          "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
        },
        "personality": {
          "anyOf": [
            {
              "$ref": "#/definitions/Personality"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override the personality for this turn and subsequent turns."
        },
        "sandboxPolicy": {
          "anyOf": [
            {
              "$ref": "#/definitions/SandboxPolicy"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override the sandbox policy for this turn and subsequent turns."
        },
        "serviceTier": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/definitions/ServiceTier"
                },
                {
                  "type": "null"
                }
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Override the service tier for this turn and subsequent turns."
        },
        "summary": {
          "anyOf": [
            {
              "$ref": "#/definitions/ReasoningSummary"
            },
            {
              "type": "null"
            }
          ],
          "description": "Override the reasoning summary for this turn and subsequent turns."
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "input",
        "threadId"
      ],
      "title": "TurnStartParams",
      "type": "object"
    },
    "TurnStartResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "turn": {
          "$ref": "#/definitions/Turn"
        }
      },
      "required": [
        "turn"
      ],
      "title": "TurnStartResponse",
      "type": "object"
    },
    "TurnStartedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "threadId": {
          "type": "string"
        },
        "turn": {
          "$ref": "#/definitions/Turn"
        }
      },
      "required": [
        "threadId",
        "turn"
      ],
      "title": "TurnStartedNotification",
      "type": "object"
    },
    "TurnStatus": {
      "enum": [
        "completed",
        "interrupted",
        "failed",
        "inProgress"
      ],
      "type": "string"
    },
    "TurnSteerParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "expectedTurnId": {
          "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.",
          "type": "string"
        },
        "input": {
          "items": {
            "$ref": "#/definitions/UserInput"
          },
          "type": "array"
        },
        "threadId": {
          "type": "string"
        }
      },
      "required": [
        "expectedTurnId",
        "input",
        "threadId"
      ],
      "title": "TurnSteerParams",
      "type": "object"
    },
    "TurnSteerResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "turnId": {
          "type": "string"
        }
      },
      "required": [
        "turnId"
      ],
      "title": "TurnSteerResponse",
      "type": "object"
    },
    "UserInput": {
      "oneOf": [
        {
          "properties": {
            "text": {
              "type": "string"
            },
            "text_elements": {
              "default": [],
              "description": "UI-defined spans within `text` used to render or persist special elements.",
              "items": {
                "$ref": "#/definitions/TextElement"
              },
              "type": "array"
            },
            "type": {
              "enum": [
                "text"
              ],
              "title": "TextUserInputType",
              "type": "string"
            }
          },
          "required": [
            "text",
            "type"
          ],
          "title": "TextUserInput",
          "type": "object"
        },
        {
          "properties": {
            "type": {
              "enum": [
                "image"
              ],
              "title": "ImageUserInputType",
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "type",
            "url"
          ],
          "title": "ImageUserInput",
          "type": "object"
        },
        {
          "properties": {
            "path": {
              "type": "string"
            },
            "type": {
              "enum": [
                "localImage"
              ],
              "title": "LocalImageUserInputType",
              "type": "string"
            }
          },
          "required": [
            "path",
            "type"
          ],
          "title": "LocalImageUserInput",
          "type": "object"
        },
        {
          "properties": {
            "name": {
              "type": "string"
            },
            "path": {
              "type": "string"
            },
            "type": {
              "enum": [
                "skill"
              ],
              "title": "SkillUserInputType",
              "type": "string"
            }
          },
          "required": [
            "name",
            "path",
            "type"
          ],
          "title": "SkillUserInput",
          "type": "object"
        },
        {
          "properties": {
            "name": {
              "type": "string"
            },
            "path": {
              "type": "string"
            },
            "type": {
              "enum": [
                "mention"
              ],
              "title": "MentionUserInputType",
              "type": "string"
            }
          },
          "required": [
            "name",
            "path",
            "type"
          ],
          "title": "MentionUserInput",
          "type": "object"
        }
      ]
    },
    "Verbosity": {
      "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "WarningNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "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"
      ],
      "title": "WarningNotification",
      "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"
        }
      ]
    },
    "WebSearchContextSize": {
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "WebSearchLocation": {
      "additionalProperties": false,
      "properties": {
        "city": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": [
            "string",
            "null"
          ]
        },
        "region": {
          "type": [
            "string",
            "null"
          ]
        },
        "timezone": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "WebSearchMode": {
      "enum": [
        "disabled",
        "cached",
        "live"
      ],
      "type": "string"
    },
    "WebSearchToolConfig": {
      "additionalProperties": false,
      "properties": {
        "allowed_domains": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "context_size": {
          "anyOf": [
            {
              "$ref": "#/definitions/WebSearchContextSize"
            },
            {
              "type": "null"
            }
          ]
        },
        "location": {
          "anyOf": [
            {
              "$ref": "#/definitions/WebSearchLocation"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    },
    "WindowsSandboxSetupCompletedNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "error": {
          "type": [
            "string",
            "null"
          ]
        },
        "mode": {
          "$ref": "#/definitions/WindowsSandboxSetupMode"
        },
        "success": {
          "type": "boolean"
        }
      },
      "required": [
        "mode",
        "success"
      ],
      "title": "WindowsSandboxSetupCompletedNotification",
      "type": "object"
    },
    "WindowsSandboxSetupMode": {
      "enum": [
        "elevated",
        "unelevated"
      ],
      "type": "string"
    },
    "WindowsSandboxSetupStartParams": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "cwd": {
          "anyOf": [
            {
              "$ref": "#/definitions/AbsolutePathBuf"
            },
            {
              "type": "null"
            }
          ]
        },
        "mode": {
          "$ref": "#/definitions/WindowsSandboxSetupMode"
        }
      },
      "required": [
        "mode"
      ],
      "title": "WindowsSandboxSetupStartParams",
      "type": "object"
    },
    "WindowsSandboxSetupStartResponse": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "started": {
          "type": "boolean"
        }
      },
      "required": [
        "started"
      ],
      "title": "WindowsSandboxSetupStartResponse",
      "type": "object"
    },
    "WindowsWorldWritableWarningNotification": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "extraCount": {
          "format": "uint",
          "minimum": 0.0,
          "type": "integer"
        },
        "failedScan": {
          "type": "boolean"
        },
        "samplePaths": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "extraCount",
        "failedScan",
        "samplePaths"
      ],
      "title": "WindowsWorldWritableWarningNotification",
      "type": "object"
    },
    "WriteStatus": {
      "enum": [
        "ok",
        "okOverridden"
      ],
      "type": "string"
    }
  },
  "title": "CodexAppServerProtocolV2",
  "type": "object"
}