api.yaml

components:
  schemas:
    AddPackageRequest:
      description: 'This can be a remove package or a local package.


        Supported formats:


        httpx

        httpx==0.27.0

        httpx>=0.27.0

        git+https://github.com/encode/httpx

        https://files.pythonhosted.org/packages/5c/2d/3da5bdf4408b8b2800061c339f240c1802f2e82d55e50bd39c5a881f47f0/httpx-0.27.0.tar.gz

        /example/foo-0.1.0-py3-none-any.whl'
      properties:
        group:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        package:
          type: string
        upgrade:
          anyOf:
          - type: boolean
          - type: 'null'
          default: false
      required:
      - package
      title: AddPackageRequest
      type: object
    AiCompletionContext:
      properties:
        plainText:
          default: ''
          type: string
        schema:
          default: []
          items:
            $ref: '#/components/schemas/SchemaTable'
          type: array
        variables:
          default: []
          items:
            anyOf:
            - type: string
            - $ref: '#/components/schemas/VariableContext'
          type: array
      required: []
      title: AiCompletionContext
      type: object
    AiCompletionRequest:
      description: 'UIMessages are expected to be AI SDK messages.

        See pydantic_ai.ui.vercel_ai.request_types.UIMessage or Vercel AI SDK documentation.'
      properties:
        code:
          type: string
        context:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/AiCompletionContext'
          default: null
        includeOtherCode:
          type: string
        language:
          default: python
          enum:
          - markdown
          - python
          - sql
        prompt:
          type: string
        selectedText:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        uiMessages:
          default: []
          items:
            type: object
          type: array
      required:
      - prompt
      - includeOtherCode
      - code
      title: AiCompletionRequest
      type: object
    AiConfig:
      description: "Configuration options for AI.\n\n    **Keys.**\n\n    - `rules`:\
        \ custom rules to include in all AI completion prompts\n    - `max_tokens`:\
        \ the maximum number of tokens to use in AI completions\n    - `mode`: the\
        \ mode to use for AI completions. Can be one of: `\"ask\"` or `\"manual\"\
        `\n    - `inline_tooltip`: if `True`, enable inline AI tooltip suggestions\n\
        \    - `models`: the models to use for AI completions\n    - `open_ai`: the\
        \ OpenAI config\n    - `anthropic`: the Anthropic config\n    - `google`:\
        \ the Google AI config\n    - `bedrock`: the Bedrock config\n    - `azure`:\
        \ the Azure config\n    - `ollama`: the Ollama config\n    - `github`: the\
        \ GitHub config\n    - `openrouter`: the OpenRouter config\n    - `wandb`:\
        \ the Weights & Biases config\n    - `custom_providers`: a dict of custom\
        \ OpenAI-compatible providers\n    - `open_ai_compatible`: the OpenAI-compatible\
        \ config (deprecated, use custom_providers)"
      properties:
        anthropic:
          $ref: '#/components/schemas/AnthropicConfig'
        azure:
          $ref: '#/components/schemas/OpenAiConfig'
        bedrock:
          $ref: '#/components/schemas/BedrockConfig'
        custom_providers:
          additionalProperties:
            $ref: '#/components/schemas/OpenAiConfig'
          type: object
        github:
          $ref: '#/components/schemas/GitHubConfig'
        google:
          $ref: '#/components/schemas/GoogleAiConfig'
        inline_tooltip:
          type: boolean
        max_tokens:
          type: integer
        mode:
          enum:
          - agent
          - ask
          - manual
        models:
          $ref: '#/components/schemas/AiModelConfig'
        ollama:
          $ref: '#/components/schemas/OpenAiConfig'
        open_ai:
          $ref: '#/components/schemas/OpenAiConfig'
        open_ai_compatible:
          $ref: '#/components/schemas/OpenAiConfig'
        openrouter:
          $ref: '#/components/schemas/OpenAiConfig'
        rules:
          type: string
        wandb:
          $ref: '#/components/schemas/OpenAiConfig'
      required: []
      title: AiConfig
      type: object
    AiInlineCompletionRequest:
      properties:
        language:
          default: python
          enum:
          - markdown
          - python
          - sql
        prefix:
          type: string
        suffix:
          type: string
      required:
      - prefix
      - suffix
      title: AiInlineCompletionRequest
      type: object
    AiModelConfig:
      description: "Configuration options for an AI model.\n\n    **Keys.**\n\n  \
        \  - `chat_model`: the model to use for chat completions\n    - `edit_model`:\
        \ the model to use for edit completions\n    - `autocomplete_model`: the model\
        \ to use for code completion/autocomplete\n    - `displayed_models`: a list\
        \ of models to display in the UI\n    - `custom_models`: a list of custom\
        \ models to use that are not from the default list"
      properties:
        autocomplete_model:
          type: string
        chat_model:
          type: string
        custom_models:
          items:
            type: string
          type: array
        displayed_models:
          items:
            type: string
          type: array
        edit_model:
          type: string
      required:
      - custom_models
      - displayed_models
      title: AiModelConfig
      type: object
    AlertNotification:
      description: "User-facing alert message.\n\n    Attributes:\n        title:\
        \ Alert title.\n        description: Alert body (may contain HTML).\n    \
        \    variant: Visual variant (e.g., \"danger\")."
      properties:
        description:
          type: string
        op:
          enum:
          - alert
        title:
          type: string
        variant:
          anyOf:
          - enum:
            - danger
          - type: 'null'
          default: null
      required:
      - op
      - title
      - description
      title: AlertNotification
      type: object
    AnthropicConfig:
      description: "Configuration options for Anthropic.\n\n    **Keys.**\n\n    -\
        \ `api_key`: the Anthropic API key"
      properties:
        api_key:
          type: string
      required: []
      title: AnthropicConfig
      type: object
    BannerNotification:
      description: "Persistent banner message at top of notebook.\n\n    Attributes:\n\
        \        title: Banner title.\n        description: Banner body (may contain\
        \ HTML).\n        variant: Visual variant (e.g., \"danger\").\n        action:\
        \ Optional user action (e.g., \"restart\")."
      properties:
        action:
          anyOf:
          - enum:
            - restart
          - type: 'null'
          default: null
        description:
          type: string
        op:
          enum:
          - banner
        title:
          type: string
        variant:
          anyOf:
          - enum:
            - danger
          - type: 'null'
          default: null
      required:
      - op
      - title
      - description
      title: BannerNotification
      type: object
    BaseResponse:
      properties:
        success:
          type: boolean
      required:
      - success
      title: BaseResponse
      type: object
    BasedpyrightServerConfig:
      description: 'Configuration options for basedpyright Language Server.


        basedpyright handles completion, hover, go-to-definition, and diagnostics,

        but we only use it for diagnostics.'
      properties:
        enabled:
          type: boolean
      required: []
      title: BasedpyrightServerConfig
      type: object
    BedrockConfig:
      description: "Configuration options for Bedrock.\n\n    **Keys.**\n\n    - `profile_name`:\
        \ the AWS profile to use\n    - `region_name`: the AWS region to use\n   \
        \ - `aws_access_key_id`: the AWS access key ID\n    - `aws_secret_access_key`:\
        \ the AWS secret access key"
      properties:
        aws_access_key_id:
          type: string
        aws_secret_access_key:
          type: string
        profile_name:
          type: string
        region_name:
          type: string
      required: []
      title: BedrockConfig
      type: object
    CacheClearedNotification:
      description: "Execution cache cleared result.\n\n    Attributes:\n        bytes_freed:\
        \ Bytes freed by clearing cache."
      properties:
        bytes_freed:
          type: integer
        op:
          enum:
          - cache-cleared
      required:
      - op
      - bytes_freed
      title: CacheClearedNotification
      type: object
    CacheInfoNotification:
      description: "Execution cache statistics.\n\n    Attributes:\n        hits:\
        \ Cache hits.\n        misses: Cache misses.\n        time: Time spent on\
        \ cache operations (seconds).\n        disk_to_free: Disk space that could\
        \ be freed (bytes).\n        disk_total: Total disk space used (bytes)."
      properties:
        disk_to_free:
          type: integer
        disk_total:
          type: integer
        hits:
          type: integer
        misses:
          type: integer
        op:
          enum:
          - cache-info
        time:
          type: number
      required:
      - op
      - hits
      - misses
      - time
      - disk_to_free
      - disk_total
      title: CacheInfoNotification
      type: object
    CellChannel:
      description: The channel of a cell's output.
      enum:
      - marimo-error
      - media
      - output
      - pdb
      - stderr
      - stdin
      - stdout
      title: CellChannel
    CellConfig:
      description: 'Internal representation of a cell''s configuration.

        This is not part of the public API.'
      properties:
        column:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        disabled:
          default: false
          type: boolean
        hide_code:
          default: false
          type: boolean
      required: []
      title: CellConfig
      type: object
    CellNotification:
      description: "Updates a cell's state in the frontend.\n\n    Only fields that\
        \ are set (not None) will update the cell state.\n    Omitting a field leaves\
        \ that aspect unchanged.\n\n    Attributes:\n        cell_id: Unique identifier\
        \ of the cell being updated.\n        output: Cell's output. Use CellOutput.empty()\
        \ to clear.\n        console: Console messages. Single/list appends, [] clears,\
        \ None unchanged.\n        status: Execution status (idle/running/stale/queued/disabled-transitively).\n\
        \        stale_inputs: Whether cell has stale inputs from changed dependencies.\n\
        \        run_id: Execution run ID for tracing. Auto-set from context.\n  \
        \      serialization: Serialization status (TopLevelHints).\n        timestamp:\
        \ Creation timestamp, auto-set."
      properties:
        cell_id:
          type: string
        console:
          anyOf:
          - items:
              $ref: '#/components/schemas/CellOutput'
            type: array
          - type: 'null'
          - $ref: '#/components/schemas/CellOutput'
          default: null
        op:
          enum:
          - cell-op
        output:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/CellOutput'
          default: null
        run_id:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        serialization:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        stale_inputs:
          anyOf:
          - type: boolean
          - type: 'null'
          default: null
        status:
          anyOf:
          - enum:
            - disabled-transitively
            - idle
            - queued
            - running
          - type: 'null'
          default: null
        timestamp:
          type: number
      required:
      - op
      - cell_id
      title: CellNotification
      type: object
    CellOutput:
      properties:
        channel:
          $ref: '#/components/schemas/CellChannel'
        data:
          anyOf:
          - type: string
          - items:
              anyOf:
              - $ref: '#/components/schemas/SetupRootError'
              - $ref: '#/components/schemas/CycleError'
              - $ref: '#/components/schemas/MultipleDefinitionError'
              - $ref: '#/components/schemas/ImportStarError'
              - $ref: '#/components/schemas/MarimoAncestorStoppedError'
              - $ref: '#/components/schemas/MarimoAncestorPreventedError'
              - $ref: '#/components/schemas/MarimoExceptionRaisedError'
              - $ref: '#/components/schemas/MarimoStrictExecutionError'
              - $ref: '#/components/schemas/MarimoInterruptionError'
              - $ref: '#/components/schemas/MarimoSyntaxError'
              - $ref: '#/components/schemas/MarimoInternalError'
              - $ref: '#/components/schemas/MarimoSQLError'
              - $ref: '#/components/schemas/UnknownError'
              discriminator:
                mapping:
                  ancestor-prevented: '#/components/schemas/MarimoAncestorPreventedError'
                  ancestor-stopped: '#/components/schemas/MarimoAncestorStoppedError'
                  cycle: '#/components/schemas/CycleError'
                  exception: '#/components/schemas/MarimoExceptionRaisedError'
                  import-star: '#/components/schemas/ImportStarError'
                  internal: '#/components/schemas/MarimoInternalError'
                  interruption: '#/components/schemas/MarimoInterruptionError'
                  multiple-defs: '#/components/schemas/MultipleDefinitionError'
                  setup-refs: '#/components/schemas/SetupRootError'
                  sql-error: '#/components/schemas/MarimoSQLError'
                  strict-exception: '#/components/schemas/MarimoStrictExecutionError'
                  syntax: '#/components/schemas/MarimoSyntaxError'
                  unknown: '#/components/schemas/UnknownError'
                propertyName: type
            type: array
          - type: object
        mimetype:
          enum:
          - application/json
          - application/vnd.jupyter.widget-view+json
          - application/vnd.marimo+error
          - application/vnd.marimo+mimebundle
          - application/vnd.marimo+traceback
          - application/vnd.vega.v5+json
          - application/vnd.vega.v6+json
          - application/vnd.vegalite.v5+json
          - application/vnd.vegalite.v6+json
          - image/avif
          - image/bmp
          - image/gif
          - image/jpeg
          - image/png
          - image/svg+xml
          - image/tiff
          - text/csv
          - text/html
          - text/latex
          - text/markdown
          - text/plain
          - video/mp4
          - video/mpeg
        timestamp:
          type: number
      required:
      - channel
      - mimetype
      - data
      title: CellOutput
      type: object
    ChatAttachment:
      properties:
        content_type:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        name:
          default: attachment
          type: string
        url:
          type: string
      required:
      - url
      title: ChatAttachment
      type: object
    ChatMessage:
      description: A message in a chat.
      properties:
        attachments:
          anyOf:
          - items:
              $ref: '#/components/schemas/ChatAttachment'
            type: array
          - type: 'null'
          default: null
        content: {}
        id:
          default: ''
          type: string
        metadata:
          anyOf:
          - {}
          - type: 'null'
          default: null
        parts:
          default: []
          items:
            type: object
          type: array
        role:
          enum:
          - assistant
          - system
          - user
      required:
      - role
      - content
      title: ChatMessage
      type: object
    ChatRequest:
      description: 'UIMessages are expected to be AI SDK messages.

        See pydantic_ai.ui.vercel_ai.request_types.UIMessage or Vercel AI SDK documentation.'
      properties:
        context:
          $ref: '#/components/schemas/AiCompletionContext'
        includeOtherCode:
          type: string
        model:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        tools:
          anyOf:
          - items:
              $ref: '#/components/schemas/ToolDefinition'
            type: array
          - type: 'null'
          default: null
        uiMessages:
          items:
            type: object
          type: array
        variables:
          anyOf:
          - items:
              anyOf:
              - type: string
              - $ref: '#/components/schemas/VariableContext'
            type: array
          - type: 'null'
          default: null
      required:
      - context
      - includeOtherCode
      - uiMessages
      title: ChatRequest
      type: object
    ClearCacheCommand:
      description: "Clear all cached data.\n\n    Clears all cache contexts, freeing\
        \ memory and disk space.\n    Affects all cells using the @cache decorator."
      properties:
        type:
          enum:
          - clear-cache
      required:
      - type
      title: ClearCacheCommand
      type: object
    ClearCacheRequest:
      properties: {}
      required: []
      title: ClearCacheRequest
      type: object
    CodeCompletionCommand:
      description: "Request code completion suggestions.\n\n    Sent when the user\
        \ requests autocomplete. Provides code context up to\n    the cursor position\
        \ for the language server.\n\n    Attributes:\n        id: Unique identifier\
        \ for this request.\n        document: Source code up to the cursor position.\n\
        \        cell_id: Cell where completion is requested."
      properties:
        cellId:
          type: string
        document:
          type: string
        id:
          type: string
        type:
          enum:
          - code-completion
      required:
      - type
      - id
      - document
      - cellId
      title: CodeCompletionCommand
      type: object
    CodeCompletionRequest:
      properties:
        cellId:
          type: string
        document:
          type: string
        id:
          type: string
      required:
      - id
      - document
      - cellId
      title: CodeCompletionRequest
      type: object
    ColumnStats:
      description: Represents stats for a column in a data table.
      properties:
        'false':
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        max:
          anyOf:
          - {}
          - type: 'null'
          default: null
        mean:
          anyOf:
          - {}
          - type: 'null'
          default: null
        median:
          anyOf:
          - {}
          - type: 'null'
          default: null
        min:
          anyOf:
          - {}
          - type: 'null'
          default: null
        nulls:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        p25:
          anyOf:
          - {}
          - type: 'null'
          default: null
        p5:
          anyOf:
          - {}
          - type: 'null'
          default: null
        p75:
          anyOf:
          - {}
          - type: 'null'
          default: null
        p95:
          anyOf:
          - {}
          - type: 'null'
          default: null
        std:
          anyOf:
          - {}
          - type: 'null'
          default: null
        total:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        'true':
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        unique:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
      required: []
      title: ColumnStats
      type: object
    CompletedRunNotification:
      description: Run of submitted cells and descendants completed.
      properties:
        op:
          enum:
          - completed-run
      required:
      - op
      title: CompletedRunNotification
      type: object
    CompletionConfig:
      description: "Configuration for code completion.\n\n    A dict with key/value\
        \ pairs configuring code completion in the marimo\n    editor.\n\n    **Keys.**\n\
        \n    - `activate_on_typing`: if `False`, completion won't activate\n    until\
        \ the completion hotkey is entered\n    - `signature_hint_on_typing`: if `False`,\
        \ signature hint won't be shown when typing\n    - `copilot`: one of `\"github\"\
        `, `\"codeium\"`, or `\"custom\"`\n    - `codeium_api_key`: the Codeium API\
        \ key"
      properties:
        activate_on_typing:
          type: boolean
        api_key:
          anyOf:
          - type: string
          - type: 'null'
        base_url:
          anyOf:
          - type: string
          - type: 'null'
        codeium_api_key:
          anyOf:
          - type: string
          - type: 'null'
        copilot:
          anyOf:
          - type: boolean
          - enum:
            - codeium
            - custom
            - github
        model:
          anyOf:
          - type: string
          - type: 'null'
        signature_hint_on_typing:
          type: boolean
      required:
      - activate_on_typing
      - copilot
      - signature_hint_on_typing
      title: CompletionConfig
      type: object
    CompletionOption:
      properties:
        completion_info:
          anyOf:
          - type: string
          - type: 'null'
        name:
          type: string
        type:
          type: string
      required:
      - name
      - type
      - completion_info
      title: CompletionOption
      type: object
    CompletionResultNotification:
      description: "Code completion result from language server.\n\n    Attributes:\n\
        \        completion_id: Request ID this responds to.\n        prefix_length:\
        \ Length of prefix to replace.\n        options: Completion options to display."
      properties:
        completion_id:
          type: string
        op:
          enum:
          - completion-result
        options:
          items:
            $ref: '#/components/schemas/CompletionOption'
          type: array
        prefix_length:
          type: integer
      required:
      - op
      - completion_id
      - prefix_length
      - options
      title: CompletionResultNotification
      type: object
    CopyNotebookRequest:
      properties:
        destination:
          type: string
        source:
          type: string
      required:
      - source
      - destination
      title: CopyNotebookRequest
      type: object
    CreateNotebookCommand:
      description: "Instantiate and initialize a notebook.\n\n    Sent when a notebook\
        \ is first loaded. Contains all cells and initial UI element values.\n\n \
        \   Attributes:\n        execution_requests: ExecuteCellCommand for each notebook\
        \ cell.\n        cell_ids: Initial cell IDs in the notebook.\n        set_ui_element_value_request:\
        \ Initial UI element values.\n        auto_run: Whether to automatically execute\
        \ cells on instantiation.\n        request: HTTP request context if available."
      properties:
        autoRun:
          type: boolean
        cellIds:
          items:
            type: string
          type: array
        executionRequests:
          items:
            $ref: '#/components/schemas/ExecuteCellCommand'
          type: array
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        setUiElementValueRequest:
          $ref: '#/components/schemas/UpdateUIElementCommand'
        type:
          enum:
          - create-notebook
      required:
      - type
      - executionRequests
      - cellIds
      - setUiElementValueRequest
      - autoRun
      title: CreateNotebookCommand
      type: object
    CreateSecretRequest:
      properties:
        key:
          type: string
        name:
          type: string
        provider:
          enum:
          - dotenv
          - env
        value:
          type: string
      required:
      - key
      - value
      - provider
      - name
      title: CreateSecretRequest
      type: object
    CycleError:
      properties:
        edges_with_vars:
          items:
            items: false
            maxItems: 3
            minItems: 3
            prefixItems:
            - type: string
            - items:
                type: string
              type: array
            - type: string
            type: array
          type: array
        type:
          enum:
          - cycle
      required:
      - type
      - edges_with_vars
      title: CycleError
      type: object
    DataColumnPreviewNotification:
      description: "Data column preview with stats and visualization.\n\n    Inherits\
        \ all ColumnPreview attributes.\n\n    Attributes:\n        table_name: Table\
        \ containing the column.\n        column_name: Column being previewed."
      properties:
        chart_code:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        chart_spec:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        column_name:
          type: string
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        missing_packages:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          default: null
        op:
          enum:
          - data-column-preview
        stats:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/ColumnStats'
          default: null
        table_name:
          type: string
      required:
      - op
      - table_name
      - column_name
      title: DataColumnPreviewNotification
      type: object
    DataSourceConnection:
      description: "Represents a data source connection.\n\nAttributes:\n    source\
        \ (str): The source of the data source connection. E.g 'postgres'.\n    dialect\
        \ (str): The dialect of the data source connection. E.g 'postgresql'.\n  \
        \  name (str): The name of the data source connection. E.g 'engine'.\n   \
        \ display_name (str): The display name of the data source connection. E.g\
        \ 'PostgresQL (engine)'.\n    databases (List[Database]): The databases in\
        \ the data source connection.\n    default_database (Optional[str]): The default\
        \ database in the data source connection.\n    default_schema (Optional[str]):\
        \ The default schema in the data source connection."
      properties:
        databases:
          items:
            $ref: '#/components/schemas/Database'
          type: array
        default_database:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        default_schema:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        dialect:
          type: string
        display_name:
          type: string
        name:
          type: string
        source:
          type: string
      required:
      - source
      - dialect
      - name
      - display_name
      - databases
      title: DataSourceConnection
      type: object
    DataSourceConnectionsNotification:
      description: "Available data source connections for SQL cells.\n\n    Attributes:\n\
        \        connections: Available data source connections."
      properties:
        connections:
          items:
            $ref: '#/components/schemas/DataSourceConnection'
          type: array
        op:
          enum:
          - data-source-connections
      required:
      - op
      - connections
      title: DataSourceConnectionsNotification
      type: object
    DataTable:
      description: "Represents a data table.\n\nAttributes:\n    source_type (DataTableSource):\
        \ Type of data source ('local', 'duckdb', 'connection').\n    source (str):\
        \ Can be dialect, or source db name.\n    name (str): Name of the data table.\n\
        \    num_rows (Optional[int]): Total number of rows in the table, if known.\n\
        \    num_columns (Optional[int]): Total number of columns in the table, if\
        \ known.\n    variable_name (Optional[VariableName]): Variable name referencing\
        \ this table in code.\n    columns (List[DataTableColumn]): List of column\
        \ definitions and metadata.\n    engine (Optional[VariableName]): Database\
        \ engine or connection handler, if any.\n    type (DataTableType): Table type,\
        \ either 'table' or 'view'. Defaults to 'table'.\n    primary_keys (Optional[List[str]]):\
        \ Column names used as primary keys, if any.\n    indexes (Optional[List[str]]):\
        \ Column names used as indexes, if any."
      properties:
        columns:
          items:
            $ref: '#/components/schemas/DataTableColumn'
          type: array
        engine:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        indexes:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          default: null
        name:
          type: string
        num_columns:
          anyOf:
          - type: integer
          - type: 'null'
        num_rows:
          anyOf:
          - type: integer
          - type: 'null'
        primary_keys:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          default: null
        source:
          type: string
        source_type:
          enum:
          - catalog
          - connection
          - duckdb
          - local
        type:
          default: table
          enum:
          - table
          - view
        variable_name:
          anyOf:
          - type: string
          - type: 'null'
      required:
      - source_type
      - source
      - name
      - num_rows
      - num_columns
      - variable_name
      - columns
      title: DataTable
      type: object
    DataTableColumn:
      description: "Represents a column in a data table.\n\nAttributes:\n    name\
        \ (str): The name of the column.\n    type (DataType): The data type of the\
        \ column.\n    external_type (ExternalDataType): The raw data type of the\
        \ column.\n    sample_values (List[Any]): The sample values of the column."
      properties:
        external_type:
          type: string
        name:
          type: string
        sample_values:
          type: array
        type:
          enum:
          - boolean
          - date
          - datetime
          - integer
          - number
          - string
          - time
          - unknown
      required:
      - name
      - type
      - external_type
      - sample_values
      title: DataTableColumn
      type: object
    Database:
      description: "Represents a collection of schemas.\n\nAttributes:\n    name (str):\
        \ The name of the database\n    dialect (str): The dialect of the database\n\
        \    schemas (List[Schema]): List of schemas in the database\n    engine (Optional[VariableName]):\
        \ Database engine or connection handler, if any."
      properties:
        dialect:
          type: string
        engine:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        name:
          type: string
        schemas:
          items:
            $ref: '#/components/schemas/Schema'
          type: array
      required:
      - name
      - dialect
      - schemas
      title: Database
      type: object
    DatasetsNotification:
      description: "Available datasets for data explorer.\n\n    Attributes:\n   \
        \     tables: Available data tables/datasets.\n        clear_channel: If set,\
        \ clears tables from this channel first."
      properties:
        clear_channel:
          anyOf:
          - enum:
            - catalog
            - connection
            - duckdb
            - local
          - type: 'null'
          default: null
        op:
          enum:
          - datasets
        tables:
          items:
            $ref: '#/components/schemas/DataTable'
          type: array
      required:
      - op
      - tables
      title: DatasetsNotification
      type: object
    DatasourcesConfig:
      description: "Configuration for datasources panel.\n\n    **Keys.**\n\n    -\
        \ `auto_discover_schemas`: if `True`, include schemas in the datasource\n\
        \    - `auto_discover_tables`: if `True`, include tables in the datasource\n\
        \    - `auto_discover_columns`: if `True`, include columns & table metadata\
        \ in the datasource"
      properties:
        auto_discover_columns:
          anyOf:
          - type: boolean
          - enum:
            - auto
        auto_discover_schemas:
          anyOf:
          - type: boolean
          - enum:
            - auto
        auto_discover_tables:
          anyOf:
          - type: boolean
          - enum:
            - auto
      required: []
      title: DatasourcesConfig
      type: object
    DebugCellCommand:
      description: "Enter debugger mode for a cell.\n\n    Starts the Python debugger\
        \ (pdb) for the specified cell.\n\n    Attributes:\n        cell_id: Cell\
        \ to debug.\n        request: HTTP request context if available."
      properties:
        cellId:
          type: string
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        type:
          enum:
          - debug-cell
      required:
      - type
      - cellId
      title: DebugCellCommand
      type: object
    DebugCellRequest:
      properties:
        cellId:
          type: string
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
      required:
      - cellId
      title: DebugCellRequest
      type: object
    DeleteCellCommand:
      description: "Delete a cell from the notebook.\n\n    Removes cell from the\
        \ dependency graph and cleans up its variables.\n    Dependent cells may become\
        \ stale.\n\n    Attributes:\n        cell_id: Cell to delete."
      properties:
        cellId:
          type: string
        type:
          enum:
          - delete-cell
      required:
      - type
      - cellId
      title: DeleteCellCommand
      type: object
    DeleteCellRequest:
      properties:
        cellId:
          type: string
      required:
      - cellId
      title: DeleteCellRequest
      type: object
    DeleteSecretRequest:
      properties:
        key:
          type: string
      required:
      - key
      title: DeleteSecretRequest
      type: object
    DependencyTag:
      properties:
        kind:
          type: string
        value:
          type: string
      required:
      - kind
      - value
      title: DependencyTag
      type: object
    DependencyTreeNode:
      properties:
        dependencies:
          items:
            $ref: '#/components/schemas/DependencyTreeNode'
          type: array
        name:
          type: string
        tags:
          items:
            $ref: '#/components/schemas/DependencyTag'
          type: array
        version:
          anyOf:
          - type: string
          - type: 'null'
      required:
      - name
      - version
      - tags
      - dependencies
      title: DependencyTreeNode
      type: object
    DependencyTreeResponse:
      properties:
        tree:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/DependencyTreeNode'
      required:
      - tree
      title: DependencyTreeResponse
      type: object
    DiagnosticsConfig:
      description: "Configuration options for diagnostics.\n\n    **Keys.**\n\n  \
        \  - `enabled`: if `True`, diagnostics will be shown in the editor\n    -\
        \ `sql_linter`: if `True`, SQL cells will have linting enabled"
      properties:
        enabled:
          type: boolean
        sql_linter:
          type: boolean
      required: []
      title: DiagnosticsConfig
      type: object
    DisplayConfig:
      description: "Configuration for display.\n\n    **Keys.**\n\n    - `theme`:\
        \ `\"light\"`, `\"dark\"`, or `\"system\"`\n    - `code_editor_font_size`:\
        \ font size for the code editor\n    - `cell_output`: `\"above\"` or `\"below\"\
        `\n    - `dataframes`: `\"rich\"` or `\"plain\"`\n    - `custom_css`: list\
        \ of paths to custom CSS files\n    - `default_table_page_size`: default number\
        \ of rows to display in tables\n    - `default_table_max_columns`: default\
        \ maximum number of columns to display in tables\n    - `reference_highlighting`:\
        \ if `True`, highlight reactive variable references\n    - `locale`: locale\
        \ for date formatting and internationalization (e.g., \"en-US\", \"en-GB\"\
        , \"de-DE\")"
      properties:
        cell_output:
          enum:
          - above
          - below
        code_editor_font_size:
          type: integer
        custom_css:
          items:
            type: string
          type: array
        dataframes:
          enum:
          - plain
          - rich
        default_table_max_columns:
          type: integer
        default_table_page_size:
          type: integer
        default_width:
          enum:
          - columns
          - compact
          - full
          - medium
          - normal
        locale:
          anyOf:
          - type: string
          - type: 'null'
        reference_highlighting:
          type: boolean
        theme:
          enum:
          - dark
          - light
          - system
      required:
      - cell_output
      - code_editor_font_size
      - dataframes
      - default_table_max_columns
      - default_table_page_size
      - default_width
      - theme
      title: DisplayConfig
      type: object
    ExecuteCellCommand:
      description: "Execute a single cell.\n\n    Executes a cell with the provided\
        \ code. Dependent cells may be\n    re-executed based on the reactive execution\
        \ mode.\n\n    Attributes:\n        cell_id: Cell to execute.\n        code:\
        \ Python code to execute.\n        request: HTTP request context if available.\n\
        \        timestamp: Unix timestamp when command was created."
      properties:
        cellId:
          type: string
        code:
          type: string
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        timestamp:
          type: number
        type:
          enum:
          - execute-cell
      required:
      - type
      - cellId
      - code
      title: ExecuteCellCommand
      type: object
    ExecuteCellsCommand:
      description: "Execute multiple cells in a batch.\n\n    Executes multiple cells\
        \ with their corresponding code. The kernel manages\n    dependency tracking\
        \ and reactive execution.\n\n    Attributes:\n        cell_ids: Cells to execute.\n\
        \        codes: Python code for each cell. Must match length of cell_ids.\n\
        \        request: HTTP request context if available.\n        timestamp: Unix\
        \ timestamp when command was created."
      properties:
        cellIds:
          items:
            type: string
          type: array
        codes:
          items:
            type: string
          type: array
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        timestamp:
          type: number
        type:
          enum:
          - execute-cells
      required:
      - type
      - cellIds
      - codes
      title: ExecuteCellsCommand
      type: object
    ExecuteCellsRequest:
      properties:
        cellIds:
          items:
            type: string
          type: array
        codes:
          items:
            type: string
          type: array
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
      required:
      - cellIds
      - codes
      title: ExecuteCellsRequest
      type: object
    ExecuteScratchpadCommand:
      description: "Execute code in the scratchpad.\n\n    The scratchpad is a temporary\
        \ execution environment that doesn't affect\n    the notebook's cells or dependencies.\
        \ Runs in an isolated cell with a copy\n    of the global namespace, useful\
        \ for experimentation.\n\n    Attributes:\n        code: Python code to execute.\n\
        \        request: HTTP request context if available."
      properties:
        code:
          type: string
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        type:
          enum:
          - execute-scratchpad
      required:
      - type
      - code
      title: ExecuteScratchpadCommand
      type: object
    ExecuteScratchpadRequest:
      properties:
        code:
          type: string
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
      required:
      - code
      title: ExecuteScratchpadRequest
      type: object
    ExecuteStaleCellsCommand:
      description: "Execute all stale cells.\n\n    Cells become stale when their\
        \ dependencies change but haven't been\n    re-executed yet. Brings the notebook\
        \ to a consistent state.\n\n    Attributes:\n        request: HTTP request\
        \ context if available."
      properties:
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        type:
          enum:
          - execute-stale-cells
      required:
      - type
      title: ExecuteStaleCellsCommand
      type: object
    ExportAsHTMLRequest:
      properties:
        assetUrl:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        download:
          type: boolean
        files:
          items:
            type: string
          type: array
        includeCode:
          type: boolean
      required:
      - download
      - files
      - includeCode
      title: ExportAsHTMLRequest
      type: object
    ExportAsIPYNBRequest:
      properties:
        download:
          type: boolean
      required:
      - download
      title: ExportAsIPYNBRequest
      type: object
    ExportAsMarkdownRequest:
      properties:
        download:
          type: boolean
      required:
      - download
      title: ExportAsMarkdownRequest
      type: object
    ExportAsPDFRequest:
      properties:
        webpdf:
          type: boolean
      required:
      - webpdf
      title: ExportAsPDFRequest
      type: object
    ExportAsScriptRequest:
      properties:
        download:
          type: boolean
      required:
      - download
      title: ExportAsScriptRequest
      type: object
    FileCreateRequest:
      properties:
        contents:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        name:
          type: string
        path:
          type: string
        type:
          enum:
          - directory
          - file
      required:
      - path
      - type
      - name
      title: FileCreateRequest
      type: object
    FileCreateResponse:
      properties:
        info:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/FileInfo'
          default: null
        message:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        success:
          type: boolean
      required:
      - success
      title: FileCreateResponse
      type: object
    FileDeleteRequest:
      properties:
        path:
          type: string
      required:
      - path
      title: FileDeleteRequest
      type: object
    FileDeleteResponse:
      properties:
        message:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        success:
          type: boolean
      required:
      - success
      title: FileDeleteResponse
      type: object
    FileDetailsRequest:
      properties:
        path:
          type: string
      required:
      - path
      title: FileDetailsRequest
      type: object
    FileDetailsResponse:
      properties:
        contents:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        file:
          $ref: '#/components/schemas/FileInfo'
        mimeType:
          anyOf:
          - type: string
          - type: 'null'
          default: null
      required:
      - file
      title: FileDetailsResponse
      type: object
    FileInfo:
      properties:
        children:
          default: []
          items:
            $ref: '#/components/schemas/FileInfo'
          type: array
        id:
          type: string
        isDirectory:
          type: boolean
        isMarimoFile:
          type: boolean
        lastModified:
          anyOf:
          - type: number
          - type: 'null'
          default: null
        name:
          type: string
        opengraph:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/OpenGraphMetadata'
          default: null
        path:
          type: string
      required:
      - id
      - path
      - name
      - isDirectory
      - isMarimoFile
      title: FileInfo
      type: object
    FileListRequest:
      properties:
        path:
          anyOf:
          - type: string
          - type: 'null'
          default: null
      required: []
      title: FileListRequest
      type: object
    FileListResponse:
      properties:
        files:
          items:
            $ref: '#/components/schemas/FileInfo'
          type: array
        root:
          type: string
      required:
      - files
      - root
      title: FileListResponse
      type: object
    FileMoveRequest:
      properties:
        newPath:
          type: string
        path:
          type: string
      required:
      - path
      - newPath
      title: FileMoveRequest
      type: object
    FileMoveResponse:
      properties:
        info:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/FileInfo'
          default: null
        message:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        success:
          type: boolean
      required:
      - success
      title: FileMoveResponse
      type: object
    FileOpenRequest:
      properties:
        lineNumber:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        path:
          type: string
      required:
      - path
      title: FileOpenRequest
      type: object
    FileSearchRequest:
      properties:
        depth:
          default: 3
          type: integer
        includeDirectories:
          default: true
          type: boolean
        includeFiles:
          default: true
          type: boolean
        limit:
          default: 100
          type: integer
        path:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        query:
          type: string
      required:
      - query
      title: FileSearchRequest
      type: object
    FileSearchResponse:
      properties:
        files:
          items:
            $ref: '#/components/schemas/FileInfo'
          type: array
        query:
          type: string
        totalFound:
          type: integer
      required:
      - files
      - query
      - totalFound
      title: FileSearchResponse
      type: object
    FileUpdateRequest:
      properties:
        contents:
          type: string
        path:
          type: string
      required:
      - path
      - contents
      title: FileUpdateRequest
      type: object
    FileUpdateResponse:
      properties:
        info:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/FileInfo'
          default: null
        message:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        success:
          type: boolean
      required:
      - success
      title: FileUpdateResponse
      type: object
    FocusCellNotification:
      description: "Focuses a cell (kiosk mode).\n\n    Attributes:\n        cell_id:\
        \ Cell to focus."
      properties:
        cell_id:
          type: string
        op:
          enum:
          - focus-cell
      required:
      - op
      - cell_id
      title: FocusCellNotification
      type: object
    FormatCellsRequest:
      properties:
        codes:
          additionalProperties:
            type: string
          type: object
        lineLength:
          type: integer
      required:
      - codes
      - lineLength
      title: FormatCellsRequest
      type: object
    FormatResponse:
      properties:
        codes:
          additionalProperties:
            type: string
          type: object
      required:
      - codes
      title: FormatResponse
      type: object
    FormattingConfig:
      description: "Configuration for code formatting.\n\n    **Keys.**\n\n    - `line_length`:\
        \ max line length"
      properties:
        line_length:
          type: integer
      required:
      - line_length
      title: FormattingConfig
      type: object
    FunctionCallResultNotification:
      description: "Result of a frontend-initiated function call.\n\n    Attributes:\n\
        \        function_call_id: ID matching the original request.\n        return_value:\
        \ Function return value as JSON.\n        status: Human-readable success/failure\
        \ status."
      properties:
        function_call_id:
          type: string
        op:
          enum:
          - function-call-result
        return_value: {}
        status:
          $ref: '#/components/schemas/HumanReadableStatus'
      required:
      - op
      - function_call_id
      - return_value
      - status
      title: FunctionCallResultNotification
      type: object
    GetCacheInfoCommand:
      description: "Retrieve cache statistics.\n\n    Collects cache usage info across\
        \ all contexts (hit/miss rates, time saved, disk usage)."
      properties:
        type:
          enum:
          - get-cache-info
      required:
      - type
      title: GetCacheInfoCommand
      type: object
    GetCacheInfoRequest:
      properties: {}
      required: []
      title: GetCacheInfoRequest
      type: object
    GitHubConfig:
      description: "Configuration options for GitHub.\n\n    **Keys.**\n\n    - `api_key`:\
        \ the GitHub API token\n    - `base_url`: the base URL for the API\n    -\
        \ `copilot_settings`: configuration settings for GitHub Copilot LSP.\n   \
        \     Supports settings like `http` (proxy configuration), `telemetry`,\n\
        \        and `github-enterprise` (enterprise URI)."
      properties:
        api_key:
          type: string
        base_url:
          type: string
        copilot_settings:
          type: object
      required: []
      title: GitHubConfig
      type: object
    GoogleAiConfig:
      description: "Configuration options for Google AI.\n\n    **Keys.**\n\n    -\
        \ `api_key`: the Google AI API key"
      properties:
        api_key:
          type: string
      required: []
      title: GoogleAiConfig
      type: object
    HTTPRequest:
      description: "Serializable HTTP request representation.\n\n    Mimics Starlette/FastAPI\
        \ Request but is pickle-able and contains only a safe\n    subset of data.\
        \ Excludes session and auth to prevent exposing sensitive data.\n\n    Attributes:\n\
        \        url: Serialized URL with path, port, scheme, netloc, query, hostname.\n\
        \        base_url: Serialized base URL.\n        headers: Request headers\
        \ (marimo-specific headers excluded).\n        query_params: Query parameters\
        \ mapped to lists of values.\n        path_params: Path parameters from the\
        \ URL route.\n        cookies: Request cookies.\n        meta: User-defined\
        \ storage for custom data.\n        user: User info from authentication middleware\
        \ (e.g., is_authenticated, username)."
      properties:
        base_url:
          type: object
        cookies:
          additionalProperties:
            type: string
          type: object
        headers:
          additionalProperties:
            type: string
          type: object
        meta:
          type: object
        path_params:
          type: object
        query_params:
          additionalProperties:
            items:
              type: string
            type: array
          type: object
        url:
          type: object
        user: {}
      required:
      - url
      - base_url
      - headers
      - query_params
      - path_params
      - cookies
      - meta
      - user
      title: HTTPRequest
      type: object
    HumanReadableStatus:
      description: "Human-readable status for operation results.\n\n    Attributes:\n\
        \        code: Status code (\"ok\" or \"error\").\n        title: Optional\
        \ short title.\n        message: Optional detailed description."
      properties:
        code:
          enum:
          - error
          - ok
        message:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        title:
          anyOf:
          - type: string
          - type: 'null'
          default: null
      required:
      - code
      title: HumanReadableStatus
      type: object
    ImportStarError:
      properties:
        lineno:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        msg:
          type: string
        type:
          enum:
          - import-star
      required:
      - type
      - msg
      title: ImportStarError
      type: object
    InstallPackagesCommand:
      description: "Install Python packages.\n\n    Installs missing packages using\
        \ the specified package manager. Triggered\n    automatically on import errors\
        \ or manually by the user.\n\n    Attributes:\n        manager: Package manager\
        \ to use ('pip', 'conda', 'uv', etc.).\n        versions: Package names mapped\
        \ to version specifiers. Empty version\n                  means install latest."
      properties:
        manager:
          type: string
        type:
          enum:
          - install-packages
        versions:
          additionalProperties:
            type: string
          type: object
      required:
      - type
      - manager
      - versions
      title: InstallPackagesCommand
      type: object
    InstallPackagesRequest:
      properties:
        manager:
          type: string
        versions:
          additionalProperties:
            type: string
          type: object
      required:
      - manager
      - versions
      title: InstallPackagesRequest
      type: object
    InstallingPackageAlertNotification:
      description: "Package installation progress with streaming logs.\n\n    Attributes:\n\
        \        packages: Package name to status (queued/installing/installed/failed).\n\
        \        logs: Optional streaming logs per package.\n        log_status: Log\
        \ stream status (append/start/done)."
      properties:
        log_status:
          anyOf:
          - enum:
            - append
            - done
            - start
          - type: 'null'
          default: null
        logs:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          default: null
        op:
          enum:
          - installing-package-alert
        packages:
          additionalProperties:
            enum:
            - failed
            - installed
            - installing
            - queued
          type: object
      required:
      - op
      - packages
      title: InstallingPackageAlertNotification
      type: object
    InstantiateNotebookRequest:
      properties:
        autoRun:
          default: true
          type: boolean
        codes:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          default: null
        objectIds:
          items:
            type: string
          type: array
        values:
          type: array
      required:
      - objectIds
      - values
      title: InstantiateNotebookRequest
      type: object
    InterruptedNotification:
      description: Kernel was interrupted by user (SIGINT/Ctrl+C).
      properties:
        op:
          enum:
          - interrupted
      required:
      - op
      title: InterruptedNotification
      type: object
    InvokeAiToolRequest:
      properties:
        arguments:
          type: object
        toolName:
          type: string
      required:
      - toolName
      - arguments
      title: InvokeAiToolRequest
      type: object
    InvokeAiToolResponse:
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        result: {}
        success:
          type: boolean
        toolName:
          type: string
      required:
      - success
      - toolName
      - result
      title: InvokeAiToolResponse
      type: object
    InvokeFunctionCommand:
      description: "Invoke a function from a UI element.\n\n    Called when a UI element\
        \ needs to invoke a Python function.\n\n    Attributes:\n        function_call_id:\
        \ Unique identifier for this call.\n        namespace: Namespace where the\
        \ function is registered.\n        function_name: Function to invoke.\n  \
        \      args: Keyword arguments for the function."
      properties:
        args:
          type: object
        functionCallId:
          type: string
        functionName:
          type: string
        namespace:
          type: string
        type:
          enum:
          - invoke-function
      required:
      - type
      - functionCallId
      - namespace
      - functionName
      - args
      title: InvokeFunctionCommand
      type: object
    InvokeFunctionRequest:
      properties:
        args:
          type: object
        functionCallId:
          type: string
        functionName:
          type: string
        namespace:
          type: string
      required:
      - functionCallId
      - namespace
      - functionName
      - args
      title: InvokeFunctionRequest
      type: object
    KernelCapabilitiesNotification:
      description: "Kernel capabilities detected at startup.\n\n    All fields auto-detected\
        \ in __post_init__.\n\n    Attributes:\n        terminal: Terminal access\
        \ (unavailable on Windows/Pyodide).\n        pylsp: Python Language Server\
        \ Protocol installed.\n        ty: ty type checker installed.\n        basedpyright:\
        \ basedpyright type checker installed."
      properties:
        basedpyright:
          default: false
          type: boolean
        pylsp:
          default: false
          type: boolean
        pyrefly:
          default: false
          type: boolean
        terminal:
          default: false
          type: boolean
        ty:
          default: false
          type: boolean
      required: []
      title: KernelCapabilitiesNotification
      type: object
    KernelReadyNotification:
      description: "Kernel ready for execution. First notification sent at startup.\n\
        \n    Attributes:\n        cell_ids: Cell IDs in order.\n        codes: Source\
        \ code for each cell.\n        names: Cell names/titles.\n        layout:\
        \ Notebook layout config.\n        configs: Per-cell configuration.\n    \
        \    resumed: Whether resumed from previous session.\n        ui_values: Previous\
        \ UI element values if resumed.\n        last_executed_code: Last executed\
        \ code per cell if resumed.\n        last_execution_time: Last execution time\
        \ per cell if resumed.\n        app_config: Application configuration.\n \
        \       kiosk: Whether running in kiosk mode.\n        capabilities: Available\
        \ kernel capabilities.\n        auto_instantiated: Whether cells already executed\
        \ (run mode)."
      properties:
        app_config:
          $ref: '#/components/schemas/_AppConfig'
        auto_instantiated:
          default: false
          type: boolean
        capabilities:
          $ref: '#/components/schemas/KernelCapabilitiesNotification'
        cell_ids:
          items:
            type: string
          type: array
        codes:
          items:
            type: string
          type: array
        configs:
          items:
            $ref: '#/components/schemas/CellConfig'
          type: array
        kiosk:
          type: boolean
        last_executed_code:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
        last_execution_time:
          anyOf:
          - additionalProperties:
              type: number
            type: object
          - type: 'null'
        layout:
          anyOf:
          - $ref: '#/components/schemas/LayoutConfig'
          - type: 'null'
        names:
          items:
            type: string
          type: array
        op:
          enum:
          - kernel-ready
        resumed:
          type: boolean
        ui_values:
          anyOf:
          - type: object
          - type: 'null'
      required:
      - op
      - cell_ids
      - codes
      - names
      - layout
      - configs
      - resumed
      - ui_values
      - last_executed_code
      - last_execution_time
      - app_config
      - kiosk
      - capabilities
      title: KernelReadyNotification
      type: object
    KernelStartupErrorNotification:
      description: "Kernel failed to start.\n\n    Attributes:\n        error: Error\
        \ message describing failure."
      properties:
        error:
          type: string
        op:
          enum:
          - kernel-startup-error
      required:
      - op
      - error
      title: KernelStartupErrorNotification
      type: object
    KeymapConfig:
      description: "Configuration for keymaps.\n\n    **Keys.**\n\n    - `preset`:\
        \ one of `\"default\"` or `\"vim\"`\n    - `overrides`: a dict of keymap actions\
        \ to their keymap override\n    - `vimrc`: path to a vimrc file to load keymaps\
        \ from\n    - `destructive_delete`: if `True`, allows deleting cells with\
        \ content."
      properties:
        destructive_delete:
          type: boolean
        overrides:
          additionalProperties:
            type: string
          type: object
        preset:
          enum:
          - default
          - vim
        vimrc:
          anyOf:
          - type: string
          - type: 'null'
      required:
      - preset
      title: KeymapConfig
      type: object
    KnownUnions:
      properties:
        command:
          anyOf:
          - $ref: '#/components/schemas/CreateNotebookCommand'
          - $ref: '#/components/schemas/RenameNotebookCommand'
          - $ref: '#/components/schemas/CodeCompletionCommand'
          - $ref: '#/components/schemas/ExecuteCellsCommand'
          - $ref: '#/components/schemas/ExecuteScratchpadCommand'
          - $ref: '#/components/schemas/ExecuteStaleCellsCommand'
          - $ref: '#/components/schemas/DebugCellCommand'
          - $ref: '#/components/schemas/DeleteCellCommand'
          - $ref: '#/components/schemas/SyncGraphCommand'
          - $ref: '#/components/schemas/UpdateCellConfigCommand'
          - $ref: '#/components/schemas/InstallPackagesCommand'
          - $ref: '#/components/schemas/UpdateUIElementCommand'
          - $ref: '#/components/schemas/ModelCommand'
          - $ref: '#/components/schemas/InvokeFunctionCommand'
          - $ref: '#/components/schemas/UpdateUserConfigCommand'
          - $ref: '#/components/schemas/PreviewDatasetColumnCommand'
          - $ref: '#/components/schemas/PreviewSQLTableCommand'
          - $ref: '#/components/schemas/ListSQLTablesCommand'
          - $ref: '#/components/schemas/ValidateSQLCommand'
          - $ref: '#/components/schemas/ListDataSourceConnectionCommand'
          - $ref: '#/components/schemas/ListSecretKeysCommand'
          - $ref: '#/components/schemas/RefreshSecretsCommand'
          - $ref: '#/components/schemas/ClearCacheCommand'
          - $ref: '#/components/schemas/GetCacheInfoCommand'
          - $ref: '#/components/schemas/StopKernelCommand'
          discriminator:
            mapping:
              clear-cache: '#/components/schemas/ClearCacheCommand'
              code-completion: '#/components/schemas/CodeCompletionCommand'
              create-notebook: '#/components/schemas/CreateNotebookCommand'
              debug-cell: '#/components/schemas/DebugCellCommand'
              delete-cell: '#/components/schemas/DeleteCellCommand'
              execute-cells: '#/components/schemas/ExecuteCellsCommand'
              execute-scratchpad: '#/components/schemas/ExecuteScratchpadCommand'
              execute-stale-cells: '#/components/schemas/ExecuteStaleCellsCommand'
              get-cache-info: '#/components/schemas/GetCacheInfoCommand'
              install-packages: '#/components/schemas/InstallPackagesCommand'
              invoke-function: '#/components/schemas/InvokeFunctionCommand'
              list-data-source-connection: '#/components/schemas/ListDataSourceConnectionCommand'
              list-secret-keys: '#/components/schemas/ListSecretKeysCommand'
              list-sql-tables: '#/components/schemas/ListSQLTablesCommand'
              model: '#/components/schemas/ModelCommand'
              preview-dataset-column: '#/components/schemas/PreviewDatasetColumnCommand'
              preview-sql-table: '#/components/schemas/PreviewSQLTableCommand'
              refresh-secrets: '#/components/schemas/RefreshSecretsCommand'
              rename-notebook: '#/components/schemas/RenameNotebookCommand'
              stop-kernel: '#/components/schemas/StopKernelCommand'
              sync-graph: '#/components/schemas/SyncGraphCommand'
              update-cell-config: '#/components/schemas/UpdateCellConfigCommand'
              update-ui-element: '#/components/schemas/UpdateUIElementCommand'
              update-user-config: '#/components/schemas/UpdateUserConfigCommand'
              validate-sql: '#/components/schemas/ValidateSQLCommand'
            propertyName: type
        data_type:
          enum:
          - boolean
          - date
          - datetime
          - integer
          - number
          - string
          - time
          - unknown
        error:
          anyOf:
          - $ref: '#/components/schemas/SetupRootError'
          - $ref: '#/components/schemas/CycleError'
          - $ref: '#/components/schemas/MultipleDefinitionError'
          - $ref: '#/components/schemas/ImportStarError'
          - $ref: '#/components/schemas/MarimoAncestorStoppedError'
          - $ref: '#/components/schemas/MarimoAncestorPreventedError'
          - $ref: '#/components/schemas/MarimoExceptionRaisedError'
          - $ref: '#/components/schemas/MarimoStrictExecutionError'
          - $ref: '#/components/schemas/MarimoInterruptionError'
          - $ref: '#/components/schemas/MarimoSyntaxError'
          - $ref: '#/components/schemas/MarimoInternalError'
          - $ref: '#/components/schemas/MarimoSQLError'
          - $ref: '#/components/schemas/UnknownError'
          discriminator:
            mapping:
              ancestor-prevented: '#/components/schemas/MarimoAncestorPreventedError'
              ancestor-stopped: '#/components/schemas/MarimoAncestorStoppedError'
              cycle: '#/components/schemas/CycleError'
              exception: '#/components/schemas/MarimoExceptionRaisedError'
              import-star: '#/components/schemas/ImportStarError'
              internal: '#/components/schemas/MarimoInternalError'
              interruption: '#/components/schemas/MarimoInterruptionError'
              multiple-defs: '#/components/schemas/MultipleDefinitionError'
              setup-refs: '#/components/schemas/SetupRootError'
              sql-error: '#/components/schemas/MarimoSQLError'
              strict-exception: '#/components/schemas/MarimoStrictExecutionError'
              syntax: '#/components/schemas/MarimoSyntaxError'
              unknown: '#/components/schemas/UnknownError'
            propertyName: type
        notification:
          anyOf:
          - $ref: '#/components/schemas/CellNotification'
          - $ref: '#/components/schemas/FunctionCallResultNotification'
          - $ref: '#/components/schemas/UIElementMessageNotification'
          - $ref: '#/components/schemas/ModelLifecycleNotification'
          - $ref: '#/components/schemas/RemoveUIElementsNotification'
          - $ref: '#/components/schemas/ReloadNotification'
          - $ref: '#/components/schemas/ReconnectedNotification'
          - $ref: '#/components/schemas/InterruptedNotification'
          - $ref: '#/components/schemas/CompletedRunNotification'
          - $ref: '#/components/schemas/KernelReadyNotification'
          - $ref: '#/components/schemas/CompletionResultNotification'
          - $ref: '#/components/schemas/AlertNotification'
          - $ref: '#/components/schemas/BannerNotification'
          - $ref: '#/components/schemas/MissingPackageAlertNotification'
          - $ref: '#/components/schemas/InstallingPackageAlertNotification'
          - $ref: '#/components/schemas/StartupLogsNotification'
          - $ref: '#/components/schemas/KernelStartupErrorNotification'
          - $ref: '#/components/schemas/VariablesNotification'
          - $ref: '#/components/schemas/VariableValuesNotification'
          - $ref: '#/components/schemas/QueryParamsSetNotification'
          - $ref: '#/components/schemas/QueryParamsAppendNotification'
          - $ref: '#/components/schemas/QueryParamsDeleteNotification'
          - $ref: '#/components/schemas/QueryParamsClearNotification'
          - $ref: '#/components/schemas/DatasetsNotification'
          - $ref: '#/components/schemas/DataColumnPreviewNotification'
          - $ref: '#/components/schemas/SQLTablePreviewNotification'
          - $ref: '#/components/schemas/SQLTableListPreviewNotification'
          - $ref: '#/components/schemas/DataSourceConnectionsNotification'
          - $ref: '#/components/schemas/ValidateSQLResultNotification'
          - $ref: '#/components/schemas/SecretKeysResultNotification'
          - $ref: '#/components/schemas/CacheClearedNotification'
          - $ref: '#/components/schemas/CacheInfoNotification'
          - $ref: '#/components/schemas/FocusCellNotification'
          - $ref: '#/components/schemas/UpdateCellCodesNotification'
          - $ref: '#/components/schemas/UpdateCellIdsNotification'
          discriminator:
            mapping:
              alert: '#/components/schemas/AlertNotification'
              banner: '#/components/schemas/BannerNotification'
              cache-cleared: '#/components/schemas/CacheClearedNotification'
              cache-info: '#/components/schemas/CacheInfoNotification'
              cell-op: '#/components/schemas/CellNotification'
              completed-run: '#/components/schemas/CompletedRunNotification'
              completion-result: '#/components/schemas/CompletionResultNotification'
              data-column-preview: '#/components/schemas/DataColumnPreviewNotification'
              data-source-connections: '#/components/schemas/DataSourceConnectionsNotification'
              datasets: '#/components/schemas/DatasetsNotification'
              focus-cell: '#/components/schemas/FocusCellNotification'
              function-call-result: '#/components/schemas/FunctionCallResultNotification'
              installing-package-alert: '#/components/schemas/InstallingPackageAlertNotification'
              interrupted: '#/components/schemas/InterruptedNotification'
              kernel-ready: '#/components/schemas/KernelReadyNotification'
              kernel-startup-error: '#/components/schemas/KernelStartupErrorNotification'
              missing-package-alert: '#/components/schemas/MissingPackageAlertNotification'
              model-lifecycle: '#/components/schemas/ModelLifecycleNotification'
              query-params-append: '#/components/schemas/QueryParamsAppendNotification'
              query-params-clear: '#/components/schemas/QueryParamsClearNotification'
              query-params-delete: '#/components/schemas/QueryParamsDeleteNotification'
              query-params-set: '#/components/schemas/QueryParamsSetNotification'
              reconnected: '#/components/schemas/ReconnectedNotification'
              reload: '#/components/schemas/ReloadNotification'
              remove-ui-elements: '#/components/schemas/RemoveUIElementsNotification'
              secret-keys-result: '#/components/schemas/SecretKeysResultNotification'
              send-ui-element-message: '#/components/schemas/UIElementMessageNotification'
              sql-table-list-preview: '#/components/schemas/SQLTableListPreviewNotification'
              sql-table-preview: '#/components/schemas/SQLTablePreviewNotification'
              startup-logs: '#/components/schemas/StartupLogsNotification'
              update-cell-codes: '#/components/schemas/UpdateCellCodesNotification'
              update-cell-ids: '#/components/schemas/UpdateCellIdsNotification'
              validate-sql-result: '#/components/schemas/ValidateSQLResultNotification'
              variable-values: '#/components/schemas/VariableValuesNotification'
              variables: '#/components/schemas/VariablesNotification'
            propertyName: op
      required:
      - notification
      - command
      - error
      - data_type
      title: KnownUnions
      type: object
    LanguageServersConfig:
      description: "Configuration options for language servers.\n\n    **Keys.**\n\
        \n    - `pylsp`: the pylsp config\n    - `pyrefly`: the pyrefly config\n    - `ty`: the ty config\n    - `basedpyright`: the basedpyright config"
      properties:
        basedpyright:
          $ref: '#/components/schemas/BasedpyrightServerConfig'
        pylsp:
          $ref: '#/components/schemas/PythonLanguageServerConfig'
        pyrefly:
          $ref: '#/components/schemas/PyreflyLanguageServerConfig'
        ty:
          $ref: '#/components/schemas/TyLanguageServerConfig'
      required: []
      title: LanguageServersConfig
      type: object
    LayoutConfig:
      properties:
        data:
          type: object
        type:
          type: string
      required:
      - type
      - data
      title: LayoutConfig
      type: object
    ListDataSourceConnectionCommand:
      description: "List data source schemas.\n\n    Retrieves available schemas for\
        \ a data source engine.\n\n    Attributes:\n        engine: Data source engine\
        \ identifier."
      properties:
        engine:
          type: string
        type:
          enum:
          - list-data-source-connection
      required:
      - type
      - engine
      title: ListDataSourceConnectionCommand
      type: object
    ListDataSourceConnectionRequest:
      properties:
        engine:
          type: string
      required:
      - engine
      title: ListDataSourceConnectionRequest
      type: object
    ListPackagesResponse:
      properties:
        packages:
          items:
            $ref: '#/components/schemas/PackageDescription'
          type: array
      required:
      - packages
      title: ListPackagesResponse
      type: object
    ListSQLTablesCommand:
      description: "List tables in an SQL schema.\n\n    Retrieves names of all tables\
        \ and views in a schema. Used by the SQL\n    editor for table selection.\n\
        \n    Attributes:\n        request_id: Unique identifier for this request.\n\
        \        engine: SQL engine ('postgresql', 'mysql', 'duckdb', etc.).\n   \
        \     database: Database to query.\n        schema: Schema to list tables\
        \ from."
      properties:
        database:
          type: string
        engine:
          type: string
        requestId:
          type: string
        schema:
          type: string
        type:
          enum:
          - list-sql-tables
      required:
      - type
      - requestId
      - engine
      - database
      - schema
      title: ListSQLTablesCommand
      type: object
    ListSQLTablesRequest:
      properties:
        database:
          type: string
        engine:
          type: string
        requestId:
          type: string
        schema:
          type: string
      required:
      - requestId
      - engine
      - database
      - schema
      title: ListSQLTablesRequest
      type: object
    ListSecretKeysCommand:
      description: "List available secret keys.\n\n    Retrieves secret names without\
        \ exposing values.\n\n    Attributes:\n        request_id: Unique identifier\
        \ for this request."
      properties:
        requestId:
          type: string
        type:
          enum:
          - list-secret-keys
      required:
      - type
      - requestId
      title: ListSecretKeysCommand
      type: object
    ListSecretKeysRequest:
      properties:
        requestId:
          type: string
      required:
      - requestId
      title: ListSecretKeysRequest
      type: object
    ListSecretKeysResponse:
      properties:
        keys:
          items:
            $ref: '#/components/schemas/SecretKeysWithProvider'
          type: array
      required:
      - keys
      title: ListSecretKeysResponse
      type: object
    LspHealthResponse:
      description: Aggregated health response for all LSP servers.
      properties:
        servers:
          items:
            $ref: '#/components/schemas/LspServerHealth'
          type: array
        status:
          enum:
          - degraded
          - healthy
          - unhealthy
      required:
      - status
      - servers
      title: LspHealthResponse
      type: object
    LspRestartRequest:
      description: Request to restart LSP servers.
      properties:
        serverIds:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          default: null
      required: []
      title: LspRestartRequest
      type: object
    LspRestartResponse:
      description: Response from restart operation.
      properties:
        errors:
          additionalProperties:
            type: string
          default: {}
          type: object
        restarted:
          items:
            type: string
          type: array
        success:
          type: boolean
      required:
      - success
      - restarted
      title: LspRestartResponse
      type: object
    LspServerHealth:
      description: "Health status for a single LSP server.\n\n    Status meanings:\n\
        \    - starting: process launched, initializing\n    - running: healthy and\
        \ responsive to pings\n    - stopped: not running (never started or cleanly\
        \ stopped)\n    - crashed: exited with non-zero code\n    - unresponsive:\
        \ process alive but not responding to pings"
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        lastPingMs:
          anyOf:
          - type: number
          - type: 'null'
          default: null
        port:
          type: integer
        serverId:
          type: string
        startedAt:
          anyOf:
          - type: number
          - type: 'null'
          default: null
        status:
          enum:
          - crashed
          - running
          - starting
          - stopped
          - unresponsive
      required:
      - serverId
      - status
      - port
      title: LspServerHealth
      type: object
    MCPConfig:
      description: 'Configuration for MCP servers


        Note: the field name `mcpServers` is camelCased to match MCP server

        config conventions used by popular AI applications (e.g. Cursor, Claude Desktop,
        etc.)'
      properties:
        mcpServers:
          additionalProperties:
            type: object
          type: object
        presets:
          items:
            enum:
            - context7
            - marimo
          type: array
      required:
      - mcpServers
      title: MCPConfig
      type: object
    MCPRefreshResponse:
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        servers:
          additionalProperties:
            type: boolean
          default: {}
          type: object
        success:
          type: boolean
      required:
      - success
      title: MCPRefreshResponse
      type: object
    MCPStatusResponse:
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        servers:
          additionalProperties:
            enum:
            - connected
            - disconnected
            - failed
            - pending
          default: {}
          type: object
        status:
          enum:
          - error
          - ok
          - partial
      required:
      - status
      title: MCPStatusResponse
      type: object
    MarimoAncestorPreventedError:
      properties:
        blamed_cell:
          anyOf:
          - type: string
          - type: 'null'
        msg:
          type: string
        raising_cell:
          type: string
        type:
          enum:
          - ancestor-prevented
      required:
      - type
      - msg
      - raising_cell
      - blamed_cell
      title: MarimoAncestorPreventedError
      type: object
    MarimoAncestorStoppedError:
      properties:
        msg:
          type: string
        raising_cell:
          type: string
        type:
          enum:
          - ancestor-stopped
      required:
      - type
      - msg
      - raising_cell
      title: MarimoAncestorStoppedError
      type: object
    MarimoConfig:
      description: Configuration for the marimo editor
      properties:
        ai:
          $ref: '#/components/schemas/AiConfig'
        completion:
          $ref: '#/components/schemas/CompletionConfig'
        datasources:
          $ref: '#/components/schemas/DatasourcesConfig'
        diagnostics:
          $ref: '#/components/schemas/DiagnosticsConfig'
        display:
          $ref: '#/components/schemas/DisplayConfig'
        experimental:
          type: object
        formatting:
          $ref: '#/components/schemas/FormattingConfig'
        keymap:
          $ref: '#/components/schemas/KeymapConfig'
        language_servers:
          $ref: '#/components/schemas/LanguageServersConfig'
        mcp:
          $ref: '#/components/schemas/MCPConfig'
        package_management:
          $ref: '#/components/schemas/PackageManagementConfig'
        runtime:
          $ref: '#/components/schemas/RuntimeConfig'
        save:
          $ref: '#/components/schemas/SaveConfig'
        server:
          $ref: '#/components/schemas/ServerConfig'
        sharing:
          $ref: '#/components/schemas/SharingConfig'
        snippets:
          $ref: '#/components/schemas/SnippetsConfig'
        venv:
          $ref: '#/components/schemas/VenvConfig'
      required:
      - completion
      - display
      - formatting
      - keymap
      - package_management
      - runtime
      - save
      - server
      title: MarimoConfig
      type: object
    MarimoExceptionRaisedError:
      properties:
        exception_type:
          type: string
        msg:
          type: string
        raising_cell:
          anyOf:
          - type: string
          - type: 'null'
        type:
          enum:
          - exception
      required:
      - type
      - msg
      - exception_type
      - raising_cell
      title: MarimoExceptionRaisedError
      type: object
    MarimoFile:
      properties:
        initializationId:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        lastModified:
          anyOf:
          - type: number
          - type: 'null'
          default: null
        name:
          type: string
        path:
          type: string
        sessionId:
          anyOf:
          - type: string
          - type: 'null'
          default: null
      required:
      - name
      - path
      title: MarimoFile
      type: object
    MarimoInternalError:
      description: 'An internal error that should be hidden from the user.

        The error is logged to the console and then a new error is broadcasted

        such that the data is hidden.


        They can be linked back to the original error by the error_id.'
      properties:
        error_id:
          type: string
        msg:
          default: ''
          type: string
        type:
          enum:
          - internal
      required:
      - type
      - error_id
      title: MarimoInternalError
      type: object
    MarimoInterruptionError:
      properties:
        type:
          enum:
          - interruption
      required:
      - type
      title: MarimoInterruptionError
      type: object
    MarimoSQLError:
      description: SQL-specific error with enhanced metadata for debugging.
      properties:
        hint:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        msg:
          type: string
        node_col_offset:
          default: 0
          type: integer
        node_lineno:
          default: 0
          type: integer
        sql_col:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        sql_line:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        sql_statement:
          type: string
        type:
          enum:
          - sql-error
      required:
      - type
      - msg
      - sql_statement
      title: MarimoSQLError
      type: object
    MarimoStrictExecutionError:
      properties:
        blamed_cell:
          anyOf:
          - type: string
          - type: 'null'
        msg:
          type: string
        ref:
          type: string
        type:
          enum:
          - strict-exception
      required:
      - type
      - msg
      - ref
      - blamed_cell
      title: MarimoStrictExecutionError
      type: object
    MarimoSyntaxError:
      properties:
        lineno:
          anyOf:
          - type: integer
          - type: 'null'
          default: null
        msg:
          type: string
        type:
          enum:
          - syntax
      required:
      - type
      - msg
      title: MarimoSyntaxError
      type: object
    MissingPackageAlertNotification:
      description: "Alert for missing packages with install option.\n\n    Attributes:\n\
        \        packages: Missing package names.\n        isolated: Whether in isolated\
        \ environment."
      properties:
        isolated:
          type: boolean
        op:
          enum:
          - missing-package-alert
        packages:
          items:
            type: string
          type: array
      required:
      - op
      - packages
      - isolated
      title: MissingPackageAlertNotification
      type: object
    ModelClose:
      description: Widget destruction.
      properties:
        method:
          enum:
          - close
      required:
      - method
      title: ModelClose
      type: object
    ModelCommand:
      description: "Widget model message command.\n\n    Handles widget model communication\
        \ between frontend and backend.\n\n    Attributes:\n        model_id: Widget\
        \ model identifier.\n        message: Model message (update or custom).\n\
        \        buffers: Base64-encoded binary buffers.\n        token: Unique identifier\
        \ for deduplication across dual queues."
      properties:
        buffers:
          items:
            contentEncoding: base64
            type: string
          type: array
        message:
          anyOf:
          - $ref: '#/components/schemas/ModelUpdateMessage'
          - $ref: '#/components/schemas/ModelCustomMessage'
          discriminator:
            mapping:
              custom: '#/components/schemas/ModelCustomMessage'
              update: '#/components/schemas/ModelUpdateMessage'
            propertyName: method
        modelId:
          type: string
        token:
          type: string
        type:
          enum:
          - model
      required:
      - type
      - modelId
      - message
      - buffers
      title: ModelCommand
      type: object
    ModelCustom:
      description: Custom application message.
      properties:
        buffers:
          items:
            contentEncoding: base64
            type: string
          type: array
        content: {}
        method:
          enum:
          - custom
      required:
      - method
      - content
      - buffers
      title: ModelCustom
      type: object
    ModelCustomMessage:
      description: "Custom widget message.\n\n    Attributes:\n        content: Arbitrary\
        \ content for the custom message."
      properties:
        content: {}
        method:
          enum:
          - custom
      required:
      - method
      - content
      title: ModelCustomMessage
      type: object
    ModelLifecycleNotification:
      description: "Widget model lifecycle message.\n\n    Mirrors the Jupyter widget\
        \ comm protocol with open/update/custom/close.\n\n    Attributes:\n      \
        \  model_id: Widget model identifier.\n        message: The lifecycle message\
        \ (open/update/custom/close)."
      properties:
        message:
          anyOf:
          - $ref: '#/components/schemas/ModelOpen'
          - $ref: '#/components/schemas/ModelUpdate'
          - $ref: '#/components/schemas/ModelCustom'
          - $ref: '#/components/schemas/ModelClose'
          discriminator:
            mapping:
              close: '#/components/schemas/ModelClose'
              custom: '#/components/schemas/ModelCustom'
              open: '#/components/schemas/ModelOpen'
              update: '#/components/schemas/ModelUpdate'
            propertyName: method
        model_id:
          type: string
        op:
          enum:
          - model-lifecycle
      required:
      - op
      - model_id
      - message
      title: ModelLifecycleNotification
      type: object
    ModelOpen:
      description: Initial widget state on creation.
      properties:
        buffer_paths:
          items:
            items:
              anyOf:
              - type: string
              - type: integer
            type: array
          type: array
        buffers:
          items:
            contentEncoding: base64
            type: string
          type: array
        method:
          enum:
          - open
        state:
          type: object
      required:
      - method
      - state
      - buffer_paths
      - buffers
      title: ModelOpen
      type: object
    ModelRequest:
      properties:
        buffers:
          items:
            contentEncoding: base64
            type: string
          type: array
        message:
          anyOf:
          - $ref: '#/components/schemas/ModelUpdateMessage'
          - $ref: '#/components/schemas/ModelCustomMessage'
          discriminator:
            mapping:
              custom: '#/components/schemas/ModelCustomMessage'
              update: '#/components/schemas/ModelUpdateMessage'
            propertyName: method
        modelId:
          type: string
        token:
          type: string
      required:
      - modelId
      - message
      - buffers
      title: ModelRequest
      type: object
    ModelUpdate:
      description: State sync - changed traits only.
      properties:
        buffer_paths:
          items:
            items:
              anyOf:
              - type: string
              - type: integer
            type: array
          type: array
        buffers:
          items:
            contentEncoding: base64
            type: string
          type: array
        method:
          enum:
          - update
        state:
          type: object
      required:
      - method
      - state
      - buffer_paths
      - buffers
      title: ModelUpdate
      type: object
    ModelUpdateMessage:
      description: "Widget model state update message.\n\n    Attributes:\n      \
        \  state: Model state updates.\n        buffer_paths: Paths within state dict\
        \ pointing to binary buffers."
      properties:
        bufferPaths:
          items:
            items:
              anyOf:
              - type: string
              - type: integer
            type: array
          type: array
        method:
          enum:
          - update
        state:
          type: object
      required:
      - method
      - state
      - bufferPaths
      title: ModelUpdateMessage
      type: object
    MultipleDefinitionError:
      properties:
        cells:
          items:
            type: string
          type: array
        name:
          type: string
        type:
          enum:
          - multiple-defs
      required:
      - type
      - name
      - cells
      title: MultipleDefinitionError
      type: object
    OpenAiConfig:
      description: "Configuration options for OpenAI or OpenAI-compatible services.\n\
        \n    **Keys.**\n\n    - `api_key`: the OpenAI API key\n    - `base_url`:\
        \ the base URL for the API\n    - `project`: the project ID for the OpenAI\
        \ API\n    - `ssl_verify` : Boolean argument for httpx passed to open ai client.\
        \ httpx defaults to true, but some use cases to let users override to False\
        \ in some testing scenarios\n    - `ca_bundle_path`: custom ca bundle to be\
        \ used for verifying SSL certificates. Used to create custom SSL context for\
        \ httpx client\n    - `client_pem` : custom path of a client .pem cert used\
        \ for verifying identity of client server\n    - `extra_headers`: extra headers\
        \ to be passed to the OpenAI client"
      properties:
        api_key:
          type: string
        base_url:
          type: string
        ca_bundle_path:
          type: string
        client_pem:
          type: string
        extra_headers:
          additionalProperties:
            type: string
          type: object
        model:
          type: string
        project:
          type: string
        ssl_verify:
          type: boolean
      required: []
      title: OpenAiConfig
      type: object
    OpenGraphMetadata:
      description: "OpenGraph-style metadata for a notebook.\n\n    The `image` field\
        \ may be either:\n    - a relative path (typically under `__marimo__/`), or\n\
        \    - an absolute HTTPS URL."
      properties:
        description:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        image:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        title:
          anyOf:
          - type: string
          - type: 'null'
          default: null
      required: []
      title: OpenGraphMetadata
      type: object
    OpenTutorialRequest:
      properties:
        tutorialId:
          anyOf:
          - enum:
            - dataflow
            - fileformat
            - for-jupyter-users
            - intro
            - layout
            - markdown
            - plots
            - sql
            - ui
          - enum:
            - markdown-format
      required:
      - tutorialId
      title: OpenTutorialRequest
      type: object
    PackageDescription:
      properties:
        name:
          type: string
        version:
          type: string
      required:
      - name
      - version
      title: PackageDescription
      type: object
    PackageManagementConfig:
      description: "Configuration options for package management.\n\n    **Keys.**\n\
        \n    - `manager`: the package manager to use"
      properties:
        manager:
          enum:
          - pip
          - pixi
          - poetry
          - rye
          - uv
      required:
      - manager
      title: PackageManagementConfig
      type: object
    PackageOperationResponse:
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        success:
          type: boolean
      required:
      - success
      title: PackageOperationResponse
      type: object
    PreviewDatasetColumnCommand:
      description: "Preview a dataset column.\n\n    Retrieves and displays data from\
        \ a single column (dataframe or SQL table).\n    Used by the data explorer\
        \ UI.\n\n    Attributes:\n        source_type: Data source type ('dataframe',\
        \ 'sql', etc.).\n        source: Source identifier (connection string or variable\
        \ name).\n        table_name: Table or dataframe variable name.\n        column_name:\
        \ Column to preview.\n        fully_qualified_table_name: Full database.schema.table\
        \ name for SQL."
      properties:
        columnName:
          type: string
        fullyQualifiedTableName:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        source:
          type: string
        sourceType:
          enum:
          - catalog
          - connection
          - duckdb
          - local
        tableName:
          type: string
        type:
          enum:
          - preview-dataset-column
      required:
      - type
      - sourceType
      - source
      - tableName
      - columnName
      title: PreviewDatasetColumnCommand
      type: object
    PreviewDatasetColumnRequest:
      properties:
        columnName:
          type: string
        fullyQualifiedTableName:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        source:
          type: string
        sourceType:
          enum:
          - catalog
          - connection
          - duckdb
          - local
        tableName:
          type: string
      required:
      - sourceType
      - source
      - tableName
      - columnName
      title: PreviewDatasetColumnRequest
      type: object
    PreviewSQLTableCommand:
      description: "Preview SQL table details.\n\n    Retrieves metadata and sample\
        \ data for a table. Used by the SQL editor\n    and data explorer.\n\n   \
        \ Attributes:\n        request_id: Unique identifier for this request.\n \
        \       engine: SQL engine ('postgresql', 'mysql', 'duckdb', etc.).\n    \
        \    database: Database containing the table.\n        schema: Schema containing\
        \ the table.\n        table_name: Table to preview."
      properties:
        database:
          type: string
        engine:
          type: string
        requestId:
          type: string
        schema:
          type: string
        tableName:
          type: string
        type:
          enum:
          - preview-sql-table
      required:
      - type
      - requestId
      - engine
      - database
      - schema
      - tableName
      title: PreviewSQLTableCommand
      type: object
    PreviewSQLTableRequest:
      properties:
        database:
          type: string
        engine:
          type: string
        requestId:
          type: string
        schema:
          type: string
        tableName:
          type: string
      required:
      - requestId
      - engine
      - database
      - schema
      - tableName
      title: PreviewSQLTableRequest
      type: object
    PyreflyLanguageServerConfig:
      description: 'Configuration options for Pyrefly Language Server.


        Pyrefly handles completion, hover, go-to-definition, and diagnostics.'
      properties:
        enabled:
          type: boolean
      required: []
      title: PyreflyLanguageServerConfig
      type: object
    PythonLanguageServerConfig:
      description: 'Configuration options for Python Language Server.


        pylsp handles completion, hover, go-to-definition, and diagnostics.'
      properties:
        enable_flake8:
          type: boolean
        enable_mypy:
          type: boolean
        enable_pydocstyle:
          type: boolean
        enable_pyflakes:
          type: boolean
        enable_pylint:
          type: boolean
        enable_ruff:
          type: boolean
        enabled:
          type: boolean
      required: []
      title: PythonLanguageServerConfig
      type: object
    QueryParamsAppendNotification:
      description: "Appends value to URL query parameter.\n\n    Attributes:\n   \
        \     key: Query parameter key.\n        value: Value to append."
      properties:
        key:
          type: string
        op:
          enum:
          - query-params-append
        value:
          type: string
      required:
      - op
      - key
      - value
      title: QueryParamsAppendNotification
      type: object
    QueryParamsClearNotification:
      description: Clears all URL query parameters.
      properties:
        op:
          enum:
          - query-params-clear
      required:
      - op
      title: QueryParamsClearNotification
      type: object
    QueryParamsDeleteNotification:
      description: "Deletes URL query parameter values.\n\n    Attributes:\n     \
        \   key: Query parameter key.\n        value: Specific value to delete. If\
        \ None, deletes all values for key."
      properties:
        key:
          type: string
        op:
          enum:
          - query-params-delete
        value:
          anyOf:
          - type: string
          - type: 'null'
      required:
      - op
      - key
      - value
      title: QueryParamsDeleteNotification
      type: object
    QueryParamsSetNotification:
      description: "Sets URL query parameter, replacing existing values.\n\n    Attributes:\n\
        \        key: Query parameter key.\n        value: Value(s) to set."
      properties:
        key:
          type: string
        op:
          enum:
          - query-params-set
        value:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
      required:
      - op
      - key
      - value
      title: QueryParamsSetNotification
      type: object
    ReadCodeResponse:
      properties:
        contents:
          type: string
      required:
      - contents
      title: ReadCodeResponse
      type: object
    RecentFilesResponse:
      properties:
        files:
          items:
            $ref: '#/components/schemas/MarimoFile'
          type: array
      required:
      - files
      title: RecentFilesResponse
      type: object
    ReconnectedNotification:
      description: WebSocket reconnection confirmed.
      properties:
        op:
          enum:
          - reconnected
      required:
      - op
      title: ReconnectedNotification
      type: object
    RefreshSecretsCommand:
      description: "Refresh secrets from the secrets store.\n\n    Reloads secrets\
        \ from the provider without restarting the kernel."
      properties:
        type:
          enum:
          - refresh-secrets
      required:
      - type
      title: RefreshSecretsCommand
      type: object
    ReloadNotification:
      description: Instructs frontend to reload the page.
      properties:
        op:
          enum:
          - reload
      required:
      - op
      title: ReloadNotification
      type: object
    RemovePackageRequest:
      properties:
        group:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        package:
          type: string
      required:
      - package
      title: RemovePackageRequest
      type: object
    RemoveUIElementsNotification:
      description: "Removes UI elements associated with a cell.\n\n    Sent when cell\
        \ is re-executed or deleted.\n\n    Attributes:\n        cell_id: Cell whose\
        \ UI elements should be removed."
      properties:
        cell_id:
          type: string
        op:
          enum:
          - remove-ui-elements
      required:
      - op
      - cell_id
      title: RemoveUIElementsNotification
      type: object
    RenameNotebookCommand:
      description: "Rename or move the notebook file.\n\n    Updates the notebook's\
        \ filename in the kernel metadata.\n\n    Attributes:\n        filename: New\
        \ filename or path for the notebook."
      properties:
        filename:
          type: string
        type:
          enum:
          - rename-notebook
      required:
      - type
      - filename
      title: RenameNotebookCommand
      type: object
    RenameNotebookRequest:
      properties:
        filename:
          type: string
      required:
      - filename
      title: RenameNotebookRequest
      type: object
    RunningNotebooksResponse:
      properties:
        files:
          items:
            $ref: '#/components/schemas/MarimoFile'
          type: array
      required:
      - files
      title: RunningNotebooksResponse
      type: object
    RuntimeConfig:
      description: "Configuration for runtime.\n\n    **Keys.**\n\n    - `auto_instantiate`:\
        \ if `False`, cells won't automatically\n        run on startup. This only\
        \ applies when editing a notebook,\n        and not when running as an application.\n\
        \        The default is `True`.\n    - `auto_reload`: if `lazy`, cells importing\
        \ modified modules will marked\n      as stale; if `autorun`, affected cells\
        \ will be automatically run. similar\n      to IPython's %autoreload extension\
        \ but with more code intelligence.\n    - `reactive_tests`: if `True`, marimo\
        \ will automatically run pytest on cells containing only test functions and\
        \ test classes.\n      execution.\n    - `on_cell_change`: if `lazy`, cells\
        \ will be marked stale when their\n      ancestors run but won't autorun;\
        \ if `autorun`, cells will automatically\n      run when their ancestors run.\n\
        \    - `execution_type`: if `relaxed`, marimo will not clone cell declarations;\n\
        \      if `strict` marimo will clone cell declarations by default, avoiding\n\
        \      hidden potential state build up.\n    - `watcher_on_save`: how to handle\
        \ file changes when saving. `\"lazy\"` marks\n        affected cells as stale,\
        \ `\"autorun\"` automatically runs affected cells.\n    - `output_max_bytes`:\
        \ the maximum size in bytes of cell outputs; larger\n        values may affect\
        \ frontend performance\n    - `serve_cached_sessions_in_apps`: if `True`,\
        \ initialize applications with session cache.\n        The default is `False`.\n\
        \    - `std_stream_max_bytes`: the maximum size in bytes of console outputs;\n\
        \      larger values may affect frontend performance\n    - `pythonpath`:\
        \ a list of directories to add to the Python search path.\n        Directories\
        \ will be added to the head of sys.path. Similar to the\n        `PYTHONPATH`\
        \ environment variable, the directories will be included in\n        where\
        \ Python will look for imported modules.\n    - `dotenv`: a list of paths\
        \ to `.env` files to load.\n        If the file does not exist, it will be\
        \ silently ignored.\n        The default is `[\".env\"]` if a pyproject.toml\
        \ is found, otherwise `[]`.\n    - `default_sql_output`: the default output\
        \ format for SQL queries. Can be one of:\n        `\"auto\"`, `\"native\"\
        `, `\"polars\"`, `\"lazy-polars\"`, or `\"pandas\"`.\n        The default\
        \ is `\"auto\"`.\n    - `default_auto_download`: an Optional list of export\
        \ types to automatically snapshot your notebook as:\n       `html`, `markdown`,\
        \ `ipynb`.\n       The default is None.\n    - `default_csv_encoding`: the\
        \ default encoding for CSV exports.\n        The default is `\"utf-8\"`."
      properties:
        auto_instantiate:
          type: boolean
        auto_reload:
          enum:
          - autorun
          - lazy
          - 'off'
        default_auto_download:
          items:
            enum:
            - html
            - ipynb
            - markdown
          type: array
        default_csv_encoding:
          type: string
        default_sql_output:
          enum:
          - auto
          - lazy-polars
          - native
          - pandas
          - polars
        dotenv:
          items:
            type: string
          type: array
        on_cell_change:
          enum:
          - autorun
          - lazy
        output_max_bytes:
          type: integer
        pythonpath:
          items:
            type: string
          type: array
        reactive_tests:
          type: boolean
        serve_cached_sessions_in_apps:
          type: boolean
        std_stream_max_bytes:
          type: integer
        watcher_on_save:
          enum:
          - autorun
          - lazy
      required:
      - auto_instantiate
      - auto_reload
      - default_sql_output
      - on_cell_change
      - output_max_bytes
      - reactive_tests
      - std_stream_max_bytes
      - watcher_on_save
      title: RuntimeConfig
      type: object
    SQLMetadata:
      description: "SQL database and schema metadata.\n\n    Attributes:\n       \
        \ connection: Connection identifier.\n        database: Database name.\n \
        \       schema: Schema name."
      properties:
        connection:
          type: string
        database:
          type: string
        schema:
          type: string
        type:
          enum:
          - sql-metadata
      required:
      - type
      - connection
      - database
      - schema
      title: SQLMetadata
      type: object
    SQLTableListPreviewNotification:
      description: "List of SQL tables in a schema.\n\n    Attributes:\n        request_id:\
        \ Request ID this responds to.\n        metadata: Database and schema metadata.\n\
        \        tables: Tables in schema.\n        error: Error message if failed."
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        metadata:
          $ref: '#/components/schemas/SQLMetadata'
        op:
          enum:
          - sql-table-list-preview
        request_id:
          type: string
        tables:
          default: []
          items:
            $ref: '#/components/schemas/DataTable'
          type: array
      required:
      - op
      - request_id
      - metadata
      title: SQLTableListPreviewNotification
      type: object
    SQLTablePreviewNotification:
      description: "SQL table preview.\n\n    Attributes:\n        request_id: Request\
        \ ID this responds to.\n        metadata: Database and schema metadata.\n\
        \        table: Table data (None if error).\n        error: Error message\
        \ if failed."
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        metadata:
          $ref: '#/components/schemas/SQLMetadata'
        op:
          enum:
          - sql-table-preview
        request_id:
          type: string
        table:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/DataTable'
      required:
      - op
      - request_id
      - metadata
      - table
      title: SQLTablePreviewNotification
      type: object
    SaveAppConfigurationRequest:
      properties:
        config:
          type: object
      required:
      - config
      title: SaveAppConfigurationRequest
      type: object
    SaveConfig:
      description: "Configuration for saving.\n\n    **Keys.**\n\n    - `autosave`:\
        \ one of `\"off\"` or `\"after_delay\"`\n    - `delay`: number of milliseconds\
        \ to wait before autosaving\n    - `format_on_save`: if `True`, format the\
        \ code on save"
      properties:
        autosave:
          enum:
          - after_delay
          - 'off'
        autosave_delay:
          type: integer
        format_on_save:
          type: boolean
      required:
      - autosave
      - autosave_delay
      - format_on_save
      title: SaveConfig
      type: object
    SaveNotebookRequest:
      properties:
        cellIds:
          items:
            type: string
          type: array
        codes:
          items:
            type: string
          type: array
        configs:
          items:
            $ref: '#/components/schemas/CellConfig'
          type: array
        filename:
          type: string
        layout:
          anyOf:
          - type: object
          - type: 'null'
          default: null
        names:
          items:
            type: string
          type: array
        persist:
          default: true
          type: boolean
      required:
      - cellIds
      - codes
      - names
      - configs
      - filename
      title: SaveNotebookRequest
      type: object
    SaveUserConfigurationRequest:
      properties:
        config:
          type: object
      required:
      - config
      title: SaveUserConfigurationRequest
      type: object
    Schema:
      properties:
        name:
          type: string
        tables:
          items:
            $ref: '#/components/schemas/DataTable'
          type: array
      required:
      - name
      - tables
      title: Schema
      type: object
    SchemaColumn:
      properties:
        name:
          type: string
        sampleValues:
          type: array
        type:
          type: string
      required:
      - name
      - type
      - sampleValues
      title: SchemaColumn
      type: object
    SchemaTable:
      properties:
        columns:
          items:
            $ref: '#/components/schemas/SchemaColumn'
          type: array
        name:
          type: string
      required:
      - name
      - columns
      title: SchemaTable
      type: object
    SecretKeysResultNotification:
      description: "Available secret keys from secret providers.\n\n    Attributes:\n\
        \        request_id: Request ID this responds to.\n        secrets: Secret\
        \ keys with provider info."
      properties:
        op:
          enum:
          - secret-keys-result
        request_id:
          type: string
        secrets:
          items:
            $ref: '#/components/schemas/SecretKeysWithProvider'
          type: array
      required:
      - op
      - request_id
      - secrets
      title: SecretKeysResultNotification
      type: object
    SecretKeysWithProvider:
      properties:
        keys:
          items:
            type: string
          type: array
        name:
          type: string
        provider:
          enum:
          - dotenv
          - env
      required:
      - provider
      - name
      - keys
      title: SecretKeysWithProvider
      type: object
    ServerConfig:
      description: "Configuration for the server.\n\n    **Keys.**\n\n    - `browser`:\
        \ the web browser to use. `\"default\"` or a browser registered\n        with\
        \ Python's webbrowser module (eg, `\"firefox\"` or `\"chrome\"`)\n    - `follow_symlink`:\
        \ if true, the server will follow symlinks it finds\n        inside its static\
        \ assets directory.\n    - `disable_file_downloads`: if true, the file download\
        \ button will be\n        hidden in the file explorer."
      properties:
        browser:
          anyOf:
          - enum:
            - default
          - type: string
        disable_file_downloads:
          type: boolean
        follow_symlink:
          type: boolean
      required:
      - browser
      - follow_symlink
      title: ServerConfig
      type: object
    SetupRootError:
      properties:
        edges_with_vars:
          items:
            items: false
            maxItems: 3
            minItems: 3
            prefixItems:
            - type: string
            - items:
                type: string
              type: array
            - type: string
            type: array
          type: array
        type:
          enum:
          - setup-refs
      required:
      - type
      - edges_with_vars
      title: SetupRootError
      type: object
    SharingConfig:
      description: "Configuration for sharing features.\n\n    **Keys.**\n\n    -\
        \ `html`: if `False`, HTML sharing options will be hidden from the UI\n  \
        \  - `wasm`: if `False`, WebAssembly sharing options will be hidden from the\
        \ UI"
      properties:
        html:
          type: boolean
        wasm:
          type: boolean
      required: []
      title: SharingConfig
      type: object
    ShutdownSessionRequest:
      properties:
        sessionId:
          type: string
      required:
      - sessionId
      title: ShutdownSessionRequest
      type: object
    Snippet:
      properties:
        sections:
          items:
            $ref: '#/components/schemas/SnippetSection'
          type: array
        title:
          type: string
      required:
      - title
      - sections
      title: Snippet
      type: object
    SnippetSection:
      properties:
        code:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        html:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        id:
          type: string
      required:
      - id
      title: SnippetSection
      type: object
    Snippets:
      properties:
        snippets:
          items:
            $ref: '#/components/schemas/Snippet'
          type: array
      required:
      - snippets
      title: Snippets
      type: object
    SnippetsConfig:
      description: "Configuration for snippets.\n\n    **Keys.**\n\n    - `custom_path`:\
        \ the path to the custom snippets directory"
      properties:
        custom_paths:
          items:
            type: string
          type: array
        include_default_snippets:
          type: boolean
      required: []
      title: SnippetsConfig
      type: object
    SqlCatalogCheckResult:
      description: Result of running validation against the database.
      properties:
        error_message:
          anyOf:
          - type: string
          - type: 'null'
        success:
          type: boolean
      required:
      - success
      - error_message
      title: SqlCatalogCheckResult
      type: object
    SqlParseError:
      description: "Represents a single SQL parse error.\n\nAttributes:\n    message\
        \ (str): Description of the error.\n    line (int): Line number where the\
        \ error occurred (1-based).\n    column (int): Column number where the error\
        \ occurred (1-based).\n    severity (Literal[\"error\", \"warning\"]): Severity\
        \ of the error."
      properties:
        column:
          type: integer
        line:
          type: integer
        message:
          type: string
        severity:
          enum:
          - error
          - warning
      required:
      - message
      - line
      - column
      - severity
      title: SqlParseError
      type: object
    SqlParseResult:
      description: "Result of parsing an SQL query.\n\nAttributes:\n    success (bool):\
        \ True if parsing succeeded without errors.\n    errors (list[SqlParseError]):\
        \ List of parse errors (empty if success is True)."
      properties:
        errors:
          items:
            $ref: '#/components/schemas/SqlParseError'
          type: array
        success:
          type: boolean
      required:
      - success
      - errors
      title: SqlParseResult
      type: object
    StartupLogsNotification:
      description: "Streaming kernel startup logs.\n\n    Attributes:\n        content:\
        \ Log content to display.\n        status: Stream status (start/append/done)."
      properties:
        content:
          type: string
        op:
          enum:
          - startup-logs
        status:
          enum:
          - append
          - done
          - start
      required:
      - op
      - content
      - status
      title: StartupLogsNotification
      type: object
    StdinRequest:
      properties:
        text:
          type: string
      required:
      - text
      title: StdinRequest
      type: object
    StopKernelCommand:
      description: "Stop kernel execution.\n\n    Signals the kernel to stop processing\
        \ and shut down gracefully.\n    Used when closing a notebook or terminating\
        \ a session."
      properties:
        type:
          enum:
          - stop-kernel
      required:
      - type
      title: StopKernelCommand
      type: object
    StoreConfig:
      description: Configuration for cache stores.
      properties:
        args:
          type: object
        type:
          enum:
          - file
          - redis
          - rest
          - tiered
      required: []
      title: StoreConfig
      type: object
    SuccessResponse:
      properties:
        success:
          default: true
          type: boolean
      required: []
      title: SuccessResponse
      type: object
    SyncGraphCommand:
      description: "Synchronize the kernel graph with file manager state.\n\n    Used\
        \ when the notebook file changes externally (e.g., file reload or version\
        \ control).\n    Updates changed cells, deletes removed cells, and optionally\
        \ executes modified cells.\n\n    Attributes:\n        cells: All cells known\
        \ to file manager, mapping cell_id to code.\n        run_ids: Cells to execute\
        \ or update.\n        delete_ids: Cells to delete from the graph.\n      \
        \  timestamp: Unix timestamp when command was created."
      properties:
        cells:
          additionalProperties:
            type: string
          type: object
        deleteIds:
          items:
            type: string
          type: array
        runIds:
          items:
            type: string
          type: array
        timestamp:
          type: number
        type:
          enum:
          - sync-graph
      required:
      - type
      - cells
      - runIds
      - deleteIds
      title: SyncGraphCommand
      type: object
    ToolDefinition:
      description: Tool definition compatible with ai-sdk-ui format.
      properties:
        description:
          type: string
        mode:
          items:
            enum:
            - agent
            - ask
            - manual
          type: array
        name:
          type: string
        parameters:
          type: object
        source:
          enum:
          - backend
          - frontend
          - mcp
      required:
      - name
      - description
      - parameters
      - source
      - mode
      title: ToolDefinition
      type: object
    TyLanguageServerConfig:
      description: 'Configuration options for Ty Language Server.


        ty handles completion, hover, go-to-definition, and diagnostics,

        but we only use it for diagnostics.'
      properties:
        enabled:
          type: boolean
      required: []
      title: TyLanguageServerConfig
      type: object
    UIElementMessageNotification:
      description: "Sends a message to a UI element/widget.\n\n    Attributes:\n \
        \       ui_element: UI element identifier.\n        message: Message payload\
        \ as dictionary.\n        buffers: Optional binary buffers for large data."
      properties:
        buffers:
          anyOf:
          - items:
              contentEncoding: base64
              type: string
            type: array
          - type: 'null'
          default: null
        message:
          type: object
        op:
          enum:
          - send-ui-element-message
        ui_element:
          type: string
      required:
      - op
      - ui_element
      - message
      title: UIElementMessageNotification
      type: object
    UnknownError:
      properties:
        error_type:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        msg:
          type: string
        type:
          enum:
          - unknown
      required:
      - type
      - msg
      title: UnknownError
      type: object
    UpdateCellCodesNotification:
      description: "Updates cell code contents (kiosk mode).\n\n    Attributes:\n\
        \        cell_ids: Cells to update.\n        codes: New code for each cell.\n\
        \        code_is_stale: If True, code was not executed on backend (output\
        \ may not match)."
      properties:
        cell_ids:
          items:
            type: string
          type: array
        code_is_stale:
          type: boolean
        codes:
          items:
            type: string
          type: array
        op:
          enum:
          - update-cell-codes
      required:
      - op
      - cell_ids
      - codes
      - code_is_stale
      title: UpdateCellCodesNotification
      type: object
    UpdateCellConfigCommand:
      description: "Update cell configuration.\n\n    Updates cell-level settings\
        \ like disabled state, hide code, etc.\n\n    Attributes:\n        configs:\
        \ Cell IDs mapped to their config updates. Each config dict\n            \
        \     can contain partial updates."
      properties:
        configs:
          additionalProperties:
            type: object
          type: object
        type:
          enum:
          - update-cell-config
      required:
      - type
      - configs
      title: UpdateCellConfigCommand
      type: object
    UpdateCellConfigRequest:
      properties:
        configs:
          additionalProperties:
            type: object
          type: object
      required:
      - configs
      title: UpdateCellConfigRequest
      type: object
    UpdateCellIdsNotification:
      description: "Updates cell ordering in notebook.\n\n    Attributes:\n      \
        \  cell_ids: Complete ordered list of cell IDs."
      properties:
        cell_ids:
          items:
            type: string
          type: array
        op:
          enum:
          - update-cell-ids
      required:
      - op
      - cell_ids
      title: UpdateCellIdsNotification
      type: object
    UpdateCellIdsRequest:
      properties:
        cellIds:
          items:
            type: string
          type: array
      required:
      - cellIds
      title: UpdateCellIdsRequest
      type: object
    UpdateCellOutputsRequest:
      properties:
        cellIdsToOutput:
          additionalProperties:
            items: false
            maxItems: 2
            minItems: 2
            prefixItems:
            - enum:
              - application/json
              - application/vnd.jupyter.widget-view+json
              - application/vnd.marimo+error
              - application/vnd.marimo+mimebundle
              - application/vnd.marimo+traceback
              - application/vnd.vega.v5+json
              - application/vnd.vega.v6+json
              - application/vnd.vegalite.v5+json
              - application/vnd.vegalite.v6+json
              - image/avif
              - image/bmp
              - image/gif
              - image/jpeg
              - image/png
              - image/svg+xml
              - image/tiff
              - text/csv
              - text/html
              - text/latex
              - text/markdown
              - text/plain
              - video/mp4
              - video/mpeg
            - {}
            type: array
          type: object
      required:
      - cellIdsToOutput
      title: UpdateCellOutputsRequest
      type: object
    UpdateUIElementCommand:
      description: "Update UI element values.\n\n    Triggered when users interact\
        \ with UI elements (sliders, inputs, dropdowns, etc.).\n    Updates element\
        \ values and re-executes dependent cells.\n\n    Attributes:\n        object_ids:\
        \ UI elements to update.\n        values: New values for the elements. Must\
        \ match length of object_ids.\n        request: HTTP request context if available.\n\
        \        token: Unique request identifier for deduplication."
      properties:
        objectIds:
          items:
            type: string
          type: array
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        token:
          type: string
        type:
          enum:
          - update-ui-element
        values:
          type: array
      required:
      - type
      - objectIds
      - values
      title: UpdateUIElementCommand
      type: object
    UpdateUIElementRequest:
      properties:
        objectIds:
          items:
            type: string
          type: array
        request:
          anyOf:
          - $ref: '#/components/schemas/HTTPRequest'
          - type: 'null'
          default: null
        token:
          type: string
        values:
          type: array
      required:
      - objectIds
      - values
      title: UpdateUIElementRequest
      type: object
    UpdateUIElementValuesRequest:
      properties:
        objectIds:
          items:
            type: string
          type: array
        values:
          type: array
      required:
      - objectIds
      - values
      title: UpdateUIElementValuesRequest
      type: object
    UpdateUserConfigCommand:
      description: "Update user configuration.\n\n    Updates global marimo configuration\
        \ (runtime settings, display options, editor preferences).\n\n    Attributes:\n\
        \        config: Complete user configuration."
      properties:
        config:
          $ref: '#/components/schemas/MarimoConfig'
        type:
          enum:
          - update-user-config
      required:
      - type
      - config
      title: UpdateUserConfigCommand
      type: object
    UpdateUserConfigRequest:
      properties:
        config:
          $ref: '#/components/schemas/MarimoConfig'
      required:
      - config
      title: UpdateUserConfigRequest
      type: object
    ValidateSQLCommand:
      description: "Validate an SQL query.\n\n    Checks if an SQL query is valid\
        \ by parsing against a dialect (no DB connection)\n    or validating against\
        \ an actual database.\n\n    Attributes:\n        request_id: Unique identifier\
        \ for this request.\n        query: SQL query to validate.\n        only_parse:\
        \ If True, only parse using dialect. If False, validate against DB.\n    \
        \    engine: SQL engine (required if only_parse is False).\n        dialect:\
        \ SQL dialect for parsing (required if only_parse is True)."
      properties:
        dialect:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        engine:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        onlyParse:
          type: boolean
        query:
          type: string
        requestId:
          type: string
        type:
          enum:
          - validate-sql
      required:
      - type
      - requestId
      - query
      - onlyParse
      title: ValidateSQLCommand
      type: object
    ValidateSQLRequest:
      properties:
        dialect:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        engine:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        onlyParse:
          type: boolean
        query:
          type: string
        requestId:
          type: string
      required:
      - requestId
      - query
      - onlyParse
      title: ValidateSQLRequest
      type: object
    ValidateSQLResultNotification:
      description: "SQL query validation result.\n\n    Attributes:\n        request_id:\
        \ Request ID this responds to.\n        parse_result: SQL parsing result.\n\
        \        validate_result: Catalog validation result.\n        error: Error\
        \ message if failed."
      properties:
        error:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        op:
          enum:
          - validate-sql-result
        parse_result:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/SqlParseResult'
          default: null
        request_id:
          type: string
        validate_result:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/SqlCatalogCheckResult'
          default: null
      required:
      - op
      - request_id
      title: ValidateSQLResultNotification
      type: object
    VariableContext:
      properties:
        name:
          type: string
        previewValue: {}
        valueType:
          type: string
      required:
      - name
      - valueType
      - previewValue
      title: VariableContext
      type: object
    VariableDeclarationNotification:
      description: "Variable declaration and usage for dataflow graph.\n\n    Attributes:\n\
        \        name: Variable name.\n        declared_by: Cell IDs that define this\
        \ variable.\n        used_by: Cell IDs that use this variable."
      properties:
        declared_by:
          items:
            type: string
          type: array
        name:
          type: string
        used_by:
          items:
            type: string
          type: array
      required:
      - name
      - declared_by
      - used_by
      title: VariableDeclarationNotification
      type: object
    VariableValue:
      description: "Variable value and type for variables panel.\n\n    Attributes:\n\
        \        name: Variable name.\n        value: String representation of value.\n\
        \        datatype: Data type as string."
      properties:
        datatype:
          anyOf:
          - type: string
          - type: 'null'
        name:
          type: string
        value:
          anyOf:
          - type: string
          - type: 'null'
      required:
      - name
      - value
      - datatype
      title: VariableValue
      type: object
    VariableValuesNotification:
      description: "Current variable values.\n\n    Attributes:\n        variables:\
        \ Variables with current values and types."
      properties:
        op:
          enum:
          - variable-values
        variables:
          items:
            $ref: '#/components/schemas/VariableValue'
          type: array
      required:
      - op
      - variables
      title: VariableValuesNotification
      type: object
    VariablesNotification:
      description: "Variable dataflow graph.\n\n    Attributes:\n        variables:\
        \ Variable declarations and usage."
      properties:
        op:
          enum:
          - variables
        variables:
          items:
            $ref: '#/components/schemas/VariableDeclarationNotification'
          type: array
      required:
      - op
      - variables
      title: VariablesNotification
      type: object
    VenvConfig:
      description: "Configuration for external Python environment in home sandbox\
        \ mode.\n\n    Allows specifying an existing virtualenv to use instead of\
        \ creating\n    ephemeral sandboxes per notebook. Only applies in home sandbox\
        \ mode.\n\n    **Keys.**\n\n    - `path`: path to a virtualenv directory (absolute\
        \ or relative to\n      pyproject.toml)\n    - `writable`: if true, marimo\
        \ will manage script metadata (inline\n      dependencies). Defaults to false."
      properties:
        path:
          type: string
        writable:
          type: boolean
      required: []
      title: VenvConfig
      type: object
    WorkspaceFilesRequest:
      properties:
        includeMarkdown:
          default: false
          type: boolean
      required: []
      title: WorkspaceFilesRequest
      type: object
    WorkspaceFilesResponse:
      properties:
        fileCount:
          default: 0
          type: integer
        files:
          items:
            $ref: '#/components/schemas/FileInfo'
          type: array
        hasMore:
          default: false
          type: boolean
        root:
          type: string
      required:
      - root
      - files
      title: WorkspaceFilesResponse
      type: object
    _AppConfig:
      description: "Program-specific configuration.\n\n    Configuration for frontends\
        \ or runtimes that is specific to\n    a single marimo program."
      properties:
        app_title:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        auto_download:
          items:
            enum:
            - html
            - ipynb
            - markdown
          type: array
        css_file:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        html_head_file:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        layout_file:
          anyOf:
          - type: string
          - type: 'null'
          default: null
        sql_output:
          default: auto
          enum:
          - auto
          - lazy-polars
          - native
          - pandas
          - polars
        width:
          default: compact
          enum:
          - columns
          - compact
          - full
          - medium
          - normal
      required: []
      title: _AppConfig
      type: object
info:
  title: marimo API
  version: 0.19.9
openapi: 3.1.0
paths:
  /@file/{filename_and_length}:
    get:
      parameters:
      - description: The filename and byte length of the virtual file
        in: path
        name: filename_and_length
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/octet-stream:
              schema:
                type: string
          description: Get a virtual file
        404:
          description: Invalid byte length in virtual file request
  /api/ai/chat:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatRequest'
        description: The request body for AI chat
        required: true
  /api/ai/completion:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiCompletionRequest'
        description: The request body for AI completion
        required: true
      responses:
        200:
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
          description: Get AI completion for a prompt
  /api/ai/inline_completion:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiInlineCompletionRequest'
        description: The request body for AI inline completion
        required: true
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Get AI inline completion for code
  /api/ai/invoke_tool:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvokeAiToolRequest'
        description: The request body for tool invocation
        required: true
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvokeAiToolResponse'
          description: Tool invocation result
  /api/ai/mcp/refresh:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MCPRefreshResponse'
          description: Refresh MCP server configuration
  /api/ai/mcp/status:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MCPStatusResponse'
          description: Get MCP server status
  /api/cache/clear:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClearCacheRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Clear all caches
  /api/cache/info:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetCacheInfoRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Get cache statistics
  /api/datasources/preview_column:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PreviewDatasetColumnRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Preview a column in a dataset
  /api/datasources/preview_datasource_connection:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListDataSourceConnectionRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Broadcasts a datasource connection
  /api/datasources/preview_sql_table:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PreviewSQLTableRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Preview a SQL table
  /api/datasources/preview_sql_table_list:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSQLTablesRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Preview a list of tables in an SQL schema
  /api/documentation/snippets:
    get:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Snippets'
          description: Load the snippets for the documentation page
  /api/export/auto_export/html:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsHTMLRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Export the notebook as HTML
        400:
          description: File must be saved before downloading
  /api/export/auto_export/ipynb:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsIPYNBRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Export the notebook as IPYNB
        400:
          description: File must be saved before downloading
  /api/export/auto_export/markdown:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsMarkdownRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Export the notebook as a markdown
        400:
          description: File must be saved before downloading
  /api/export/html:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsHTMLRequest'
      responses:
        200:
          content:
            text/html:
              schema:
                type: string
          description: Export the notebook as HTML
        400:
          description: File must be saved before downloading
  /api/export/markdown:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsMarkdownRequest'
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Export the notebook as a markdown
        400:
          description: File must be saved before downloading
  /api/export/pdf:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsPDFRequest'
      responses:
        200:
          content:
            application/pdf:
              schema:
                format: binary
                type: string
          description: Export the notebook as a PDF
        400:
          description: File must be saved before downloading
        500:
          description: Export failed or dependencies missing
  /api/export/script:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportAsScriptRequest'
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Export the notebook as a script
        400:
          description: File must be saved before downloading
  /api/export/update_cell_outputs:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCellOutputsRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Update the cell outputs
        400:
          description: File must be saved before downloading
  /api/files/create:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileCreateRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileCreateResponse'
          description: Create a new file or directory
  /api/files/delete:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileDeleteRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileDeleteResponse'
          description: Delete a file or directory
  /api/files/file_details:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileDetailsRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileDetailsResponse'
          description: Get details of a specific file or directory
  /api/files/list_files:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileListRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileListResponse'
          description: List files and directories in a given path
  /api/files/move:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileMoveRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMoveResponse'
          description: Move a file or directory
  /api/files/open:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileOpenRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseResponse'
          description: Open a file in the system editor
  /api/files/search:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileSearchRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSearchResponse'
          description: Search for files and directories matching a query
  /api/files/update:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileUpdateRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileUpdateResponse'
          description: Update a file or directory
  /api/home/recent_files:
    post:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecentFilesResponse'
          description: Get the recent files
  /api/home/running_notebooks:
    post:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunningNotebooksResponse'
          description: Get the running files
  /api/home/shutdown_session:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShutdownSessionRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunningNotebooksResponse'
          description: Shutdown the current session
  /api/home/tutorial/open:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenTutorialRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarimoFile'
          description: Open a new tutorial
  /api/home/workspace_files:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceFilesRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceFilesResponse'
          description: Get the files in the workspace
  /api/kernel/code_autocomplete:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CodeCompletionRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Complete a code fragment
  /api/kernel/copy:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CopyNotebookRequest'
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Copy notebook
  /api/kernel/delete:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteCellRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Delete a cell
  /api/kernel/format:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FormatCellsRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FormatResponse'
          description: Format code
  /api/kernel/function_call:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvokeFunctionRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Invoke an RPC
  /api/kernel/install_missing_packages:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstallPackagesRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Install missing packages
  /api/kernel/instantiate:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstantiateNotebookRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Instantiate a component. Only allowed in edit mode; in run
            mode, instantiation happens server-side automatically.
  /api/kernel/interrupt:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Interrupt the kernel's execution
  /api/kernel/pdb/pm:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DebugCellRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Run a post mortem on the most recent failed cell.
  /api/kernel/read_code:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadCodeResponse'
          description: Read the code from the server
        400:
          description: File must be saved before downloading
        403:
          description: Code is not available in run mode
  /api/kernel/rename:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RenameNotebookRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Rename the current app
  /api/kernel/restart_session:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Restart the current session without affecting other sessions.
  /api/kernel/run:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExecuteCellsRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Run a cell. Updates cell code in the kernel if needed; registers
            new cells for unseen cell IDs. Only allowed in edit mode.
  /api/kernel/save:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveNotebookRequest'
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Save the current app
  /api/kernel/save_app_config:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveAppConfigurationRequest'
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Save the app configuration
  /api/kernel/save_user_config:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveUserConfigurationRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Update the user config on disk and in the kernel. Only allowed
            in edit mode.
  /api/kernel/scratchpad/run:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExecuteScratchpadRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Run the scratchpad
  /api/kernel/set_cell_config:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCellConfigRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Set the configuration of a cell
  /api/kernel/set_model_value:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModelRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Set model value
  /api/kernel/set_ui_element_value:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateUIElementValuesRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Set UI element values
  /api/kernel/shutdown:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: false
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Shutdown the kernel
  /api/kernel/stdin:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StdinRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Send input to the stdin stream
  /api/kernel/sync/cell_ids:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCellIdsRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Sync cell ids
  /api/kernel/takeover:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      responses:
        200:
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                type: object
          description: Successfully closed existing sessions
  /api/lsp/health:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LspHealthResponse'
          description: Get health status of all LSP servers
  /api/lsp/restart:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LspRestartRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LspRestartResponse'
          description: Restart LSP servers
  /api/packages/add:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddPackageRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PackageOperationResponse'
          description: Install package
  /api/packages/list:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPackagesResponse'
          description: List installed packages
  /api/packages/remove:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemovePackageRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PackageOperationResponse'
          description: Uninstall package
  /api/packages/tree:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DependencyTreeResponse'
          description: List dependency tree
  /api/secrets/create:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSecretRequest'
        required: true
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseResponse'
          description: Create a secret
  /api/secrets/delete:
    post:
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseResponse'
          description: Delete a secret
  /api/secrets/keys:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSecretKeysRequest'
        required: true
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSecretKeysResponse'
          description: List all secret keys
  /api/sql/validate:
    post:
      parameters:
      - in: header
        name: Marimo-Session-Id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValidateSQLRequest'
      responses:
        200:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
          description: Validate an SQL query
  /api/status:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                properties:
                  filenames:
                    items:
                      type: string
                    type: array
                  lsp_running:
                    type: boolean
                  mode:
                    type: string
                  node_version:
                    type: string
                  requirements:
                    items:
                      type: string
                    type: array
                  sessions:
                    type: integer
                  status:
                    type: string
                  version:
                    type: string
                type: object
          description: Get the status of the application
  /api/status/connections:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                properties:
                  active:
                    type: integer
                type: object
          description: Get the number of active websocket connections
  /api/usage:
    get:
      responses:
        200:
          content:
            application/json:
              schema:
                properties:
                  cpu:
                    properties:
                      percent:
                        type: number
                    required:
                    - percent
                    type: object
                  gpu:
                    items:
                      properties:
                        index:
                          type: integer
                        memory:
                          properties:
                            free:
                              type: integer
                            percent:
                              type: number
                            total:
                              type: integer
                            used:
                              type: integer
                          required:
                          - total
                          - used
                          - free
                          - percent
                          type: object
                        name:
                          type: string
                      required:
                      - index
                      - memory
                      - name
                      type: object
                    type: array
                  kernel:
                    properties:
                      memory:
                        type: integer
                    type: object
                  memory:
                    properties:
                      available:
                        type: integer
                      free:
                        type: integer
                      has_cgroup_mem_limit:
                        type: boolean
                      percent:
                        type: number
                      total:
                        type: integer
                      used:
                        type: integer
                    required:
                    - total
                    - available
                    - percent
                    - used
                    - free
                    - has_cgroup_mem_limit
                    type: object
                  server:
                    properties:
                      memory:
                        type: integer
                    required:
                    - memory
                    type: object
                required:
                - memory
                - cpu
                type: object
          description: Get the current memory and CPU usage of the application
  /api/version:
    get:
      responses:
        200:
          content:
            text/plain:
              schema:
                type: string
          description: Get the version of the application
  /auth/login:
    post:
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              properties:
                password:
                  description: Access token or password
                  type: string
              type: object
      responses:
        200:
          content:
            text/html:
              schema:
                type: string
          description: Login page
        302:
          description: Redirect to the next URL
          headers:
            Location:
              schema:
                type: string
      summary: Submit login form
      tags:
      - auth