types.lua

---@class OpencodeDiagnostic
---@field message string
---@field severity number
---@field lnum number
---@field col number
---@field end_lnum? number
---@field end_col? number
---@field source? string
---@field code? string|number
---@field user_data? any

---@class OpencodeSessionSelection
---@field mode? string
---@field model? string
---@field variant? string

---@class OpencodeConfigFile
---@field theme string
---@field autoshare boolean
---@field autoupdate boolean
---@field model string
---@field agent table<string, table>
---@field mcp table<string, table>
---@field mode table<string, table>
---@field command table<string, table>
---@field plugin table[]
---@field username string

---@class OpencodeProject
---@field id string
---@field worktree string
---@field vcs string
---@field time { created: number }

---@class OpencodePath
---@field state string
---@field config string
---@field worktree string
---@field directory string

---@class OpencodeSkill
---@field name string
---@field description string|nil
---@field location string
---@field content string

---@class OpencodeCommand
---@field description string
---@field agent string
---@field model string
---@field template string

---@class OpencodeUICommand
---@field hook_key? string Default hook group, unless the intent supplies one
---@field desc string
---@field execute fun(args: string[], range: OpencodeSelectionRange|nil): any
---@field completions? string[]
---@field nested_subcommand? OpencodeNestedSubcommandValidation
---@field completion_provider_id? string
---@field sub_completions? string[]
---@field nargs? string|integer
---@field range? boolean
---@field complete? boolean

---@class OpencodeNestedSubcommandValidation
---@field allow_empty boolean

---@class OpencodeCommandSubcommandSpec
---@field completions? string[]
---@field nested_subcommand? OpencodeNestedSubcommandValidation
---@field sub_completions? string[]
---@field completion_provider_id? string

---@class OpencodeCommandApi
---@field [string] any

---@alias OpencodeCommandHandler fun(api: OpencodeCommandApi, args: string[], range?: OpencodeSelectionRange): any
---@alias OpencodeCommandHandlerMap table<string, OpencodeCommandHandler>

---@class OpencodeParsedIntentSource
---@field raw_args string
---@field argv string[]

---@class OpencodeParsedIntent
---@field name string
---@field hook_key? string
---@field args string[]
---@field range OpencodeSelectionRange|nil
---@field source OpencodeParsedIntentSource

---@class OpencodeCommandParseError
---@field code 'unknown_subcommand'|'invalid_subcommand'
---@field message string
---@field subcommand string

---@class OpencodeCommandParseResult
---@field ok boolean
---@field intent? OpencodeParsedIntent
---@field error? OpencodeCommandParseError

---@class OpencodeCommandRouteOpts
---@field args? string
---@field range? integer
---@field line1? integer
---@field line2? integer

---@class OpencodeCommandDispatchError
---@field code 'unknown_subcommand'|'missing_handler'|'missing_execute'|'invalid_subcommand'|'invalid_arguments'|'execute_error'
---@field message string
---@field subcommand? string

---@class OpencodeCommandDispatchResult
---@field ok boolean
---@field intent? OpencodeParsedIntent
---@field result? any
---@field error? OpencodeCommandDispatchError

---@class OpencodeCommandActionContext
---@field parsed OpencodeCommandParseResult
---@field intent? OpencodeParsedIntent
---@field args? string[]
---@field range? OpencodeSelectionRange|nil
---@field execute? fun(args: string[], range: OpencodeSelectionRange|nil): any

---@class SessionRevertInfo
---@field messageID string
---@field partID? string
---@field snapshot? string
---@field diff? string

---@class SessionShareInfo
---@field url string

---@class OpencodeLocation
---@field directory string

---@class OpencodeSession
---@field workspace string
---@field title string
---@field time { created: number, updated: number }
---@field id string
---@field parentID string|nil
---@field agent string|nil
---@field model { id: string, providerID: string, variant?: string }|nil
---@field directory? string
---@field cost? number
---@field tokens? { input: number, output: number, reasoning: number, cache: { read: number, write: number } }
---@field location? OpencodeLocation
---@field revert? SessionRevertInfo
---@field share? SessionShareInfo

---@class OpencodeSessionTab
---@field id string Logical panel-tab identifier
---@field active_session OpencodeSession|nil Session assigned to this tab
---@field windows OpencodeWindowState|nil UI windows owned by this tab

---@class SessionProjectInfo
---@field id string
---@field name? string
---@field worktree string

---@class GlobalSession : OpencodeSession
---@field project SessionProjectInfo|nil

---@class OpencodeKeymapEntry
---@field [1] string|function # Action name or callback
---@field [2]? any # Arguments passed to the action or callback
---@field mode? string|string[] # Mode(s) for the keymap
---@field desc? string # Keymap description
---@field nowait? boolean # Execute without waiting for longer mappings
---@field defer_to_completion? boolean # Whether to defer the keymap when completion menu is open

---@class OpencodeKeymapEditor : table<string, OpencodeKeymapEntry>
---@class OpencodeKeymapInputWindow : table<string, OpencodeKeymapEntry>
---@class OpencodeKeymapOutputWindow : table<string, OpencodeKeymapEntry>

---@alias OpencodeSessionDiffMappings table<string, OpencodeKeymapEntry|false>

---@class OpencodeSessionDiffKeymaps
---@field list OpencodeSessionDiffMappings
---@field messages OpencodeSessionDiffMappings
---@field preview OpencodeSessionDiffMappings
---@field comment OpencodeSessionDiffMappings
---@field message_preview OpencodeSessionDiffMappings
---@field help OpencodeSessionDiffMappings

---@class OpencodeKeymap
---@field editor OpencodeKeymapEditor
---@field input_window OpencodeKeymapInputWindow
---@field output_window OpencodeKeymapOutputWindow
---@field session_diff OpencodeSessionDiffKeymaps
---@field tab_strip_window table<string, OpencodeKeymapEntry>
---@field session_picker OpencodeSessionPickerKeymap
---@field session_tab_picker OpencodeSessionTabPickerKeymap
---@field timeline_picker OpencodeTimelinePickerKeymap
---@field history_picker OpencodeHistoryPickerKeymap
---@field quick_chat OpencodeQuickChatKeymap

---@class OpencodeSessionPickerKeymap
---@field delete_session OpencodeKeymapEntry
---@field new_session OpencodeKeymapEntry
---@field open_in_tab OpencodeKeymapEntry
---@field rename_session OpencodeKeymapEntry
---@field fork_session OpencodeKeymapEntry
---@field toggle_scope OpencodeKeymapEntry

---@class OpencodeSessionTabPickerKeymap
---@field new_tab OpencodeKeymapEntry
---@field close_tab OpencodeKeymapEntry

---@class OpencodeTimelinePickerKeymap
---@field undo OpencodeKeymapEntry
---@field fork OpencodeKeymapEntry

---@class OpencodeHistoryPickerKeymap
---@field delete_entry OpencodeKeymapEntry
---@field clear_all OpencodeKeymapEntry

---@class OpencodeQuickChatKeymap
---@field cancel OpencodeKeymapEntry

---@class OpencodeCompletionFileSourcesConfig
---@field enabled boolean
---@field preferred_cli_tool 'server'|'fd'|'fdfind'|'rg'|'git'
---@field ignore_patterns string[]
---@field max_files number
---@field max_display_length number

---@class OpencodeCompletionConfig
---@field file_sources OpencodeCompletionFileSourcesConfig

---@class OpencodeLoadingAnimationConfig
---@field frames string[]

---@class OpencodeServerConfig
---@field url string | nil -- URL/hostname of custom opencode server (e.g., "http://192.168.1.100" or "localhost")
---@field port number | 'auto' | nil -- Explicit V1 port, 'auto' for an available port, or nil for source-specific discovery
---@field timeout number -- Timeout in seconds for health check (default: 5)
---@field health_check_ttl_ms number -- Cached connection health lifetime in milliseconds (default: 5000)
---@field retry_delay number -- Delay in milliseconds between health check retries (default: 2000)
---@field spawn_command? fun(port: number, url: string, env?: table<string, string>): number | nil -- Optional function to start the server, may return server PID
---@field kill_command? fun(port: number, url: string): nil -- Optional function to stop the server when auto_kill is true
---@field auto_kill boolean -- Kill spawned servers when nvim exits (default: true)
---@field path_map (string | fun(host_path: string): string) | nil -- Map host paths to server paths
---@field reverse_path_map (fun(server_path: string): string) | nil -- Map server paths back to host paths
---@field username? string | fun(): string | nil -- Username for Basic auth. Falls back to OPENCODE_SERVER_USERNAME env var, then "opencode"
---@field password? string | fun(): string | nil -- Basic auth password; falls back to password_file, OPENCODE_PASSWORD, then OPENCODE_SERVER_PASSWORD
---@field password_file? string -- File used to persist a generated V1 password; fixed ports default to an owner-only per-port state file

---@class OpencodeUIFloatConfig
---@field width number # Width in columns, or ratio when <= 1 (default: 0.95)
---@field height number # Height in rows, or ratio when <= 1 (default: 0.9)
---@field row number|nil # Top row, centered when nil
---@field col number|nil # Left column, centered when nil
---@field border string|string[]|nil # Float border passed to nvim_open_win
---@field gap integer # Rows between output and input floats
---@field zindex integer # Output float zindex; input uses zindex + 1
---@field opts table<string, any> # Window-local options applied to float windows

---@class OpencodeUIConfig
---@field enable_treesitter_markdown boolean
---@field position 'right'|'left'|'current'|'float' # Position of the UI (default: 'right')
---@field input_position 'bottom'|'top' # Position of the input window (default: 'bottom')
---@field window_width number
---@field persist_state boolean
---@field restore_tabs_on_startup boolean # Keep project-scoped panel tab groups and restore them across Neovim restarts
---@field zoom_width number
---@field float OpencodeUIFloatConfig
---@field picker_width number|false|nil # Width for pickers. 0<w<=1 = fraction of screen; >1 = absolute columns; false = use picker backend defaults.
---@field display_model boolean
---@field display_context_size boolean
---@field display_cost boolean
---@field hide_single_tab boolean
---@field notify_on_background_prompt boolean
---@field window_highlight string
---@field icons { preset: 'text'|'nerdfonts', overrides: table<string,string> }
---@field loading_animation OpencodeLoadingAnimationConfig
---@field output OpencodeUIOutputConfig
---@field input OpencodeUIInputConfig
---@field completion OpencodeCompletionConfig
---@field highlights? OpencodeHighlightConfig
---@field picker OpencodeUIPickerConfig
---@field questions OpencodeUIQuestionConfig

---@class OpencodeUIQuestionConfig
---@field use_vim_ui_select boolean
---@field inline_other_input boolean

---Window-local options applied to the input window.
---Any valid Neovim window-local option (`:h window-variable`) can be set here.
---Common examples:
---  signcolumn = 'no'
---  cursorline = true
---  number = true
---  relativenumber = true
---  foldcolumn = '0'
---  statuscolumn = ''
---  conceallevel = 2
---@class OpencodeUIInputWinOptions : table<string, any>
---@field signcolumn? string # Value for 'signcolumn' (e.g. 'yes', 'no', 'auto')
---@field cursorline? boolean
---@field number? boolean
---@field relativenumber? boolean

---@class OpencodeUIInputConfig
---@field text { wrap: boolean }
---@field min_height number
---@field max_height number
---@field auto_hide boolean
---@field win_options? OpencodeUIInputWinOptions # Window-local options applied to the input window. Any valid Neovim window option is accepted.

---@class OpencodeHighlightConfig
---@field vertical_borders? { tool?: { fg?: string, bg?: string }, user?: { fg?: string, bg?: string }, assistant?: { fg?: string, bg?: string } }

---@class OpencodeUIOutputRenderingConfig
---@field markdown_debounce_ms number
---@field on_data_rendered (fun(buf: integer, win: integer)|boolean)|nil
---@field markdown_on_idle boolean
---@field event_throttle_ms number -- Minimum batching interval for streaming message renders; 0 disables the delay
---@field event_collapsing boolean -- Coalesce streaming notifications within the batching interval

---@class OpencodeUIOutputToolsConfig
---@field show_output boolean
---@field show_reasoning_output boolean
---@field use_folds boolean
---@field fold_exclude (string|{server: string, tool: string})[]|nil
---@field folding_threshold number
---@field streaming_preview_lines integer -- Trailing content lines visible in streaming folds; 0 disables

---@class OpencodeUIOutputConfig
---@field time_format string|nil # Custom os.date format for timestamps, e.g. '%m/%d %H:%M'. Uses fixed default when nil.
---@field actions OpencodeUIOutputActionsConfig
---@field tools OpencodeUIOutputToolsConfig
---@field rendering OpencodeUIOutputRenderingConfig
---@field max_messages integer|nil
---@field always_scroll_to_bottom boolean
---@field filetype string
---@field compact_assistant_headers boolean | 'minimal' | 'hidden' | 'full'

---@class OpencodeUIOutputActionsConfig
---@field open_in_new_tab boolean # Open inline session actions in a new panel tab

---@class OpencodeUIPickerConfig
---@field snacks_layout? snacks.picker.layout.Config
--- TODO: add more picker-specific presets

---@class OpencodeContextConfig
---@field enabled boolean
---@field cursor_data { enabled: boolean, context_lines?: number }
---@field diagnostics { enabled:boolean, info: boolean, warning: boolean, error: boolean, only_closest: boolean}
---@field current_file { enabled: boolean }
---@field selection { enabled: boolean }
---@field review_comments { enabled: boolean }
---@field agents { enabled: boolean }
---@field buffer { enabled: boolean }
---@field git_diff { enabled: boolean }

---@alias OpencodeToggleableContextKey
---| 'current_file'
---| 'selection'
---| 'review_comments'
---| 'diagnostics'
---| 'cursor_data'
---| 'buffer'
---| 'git_diff'

---@class OpencodeDebugConfig
---@field enabled boolean
---@field capture_streamed_events boolean
---@field show_ids boolean
---@field highlight_changed_lines boolean
---@field highlight_changed_lines_timeout_ms integer
---@field quick_chat {keep_session: boolean, set_active_session: boolean}

---@alias OpencodeCommandLifecycleStage 'before'|'after'|'error'|'finally'
---@alias OpencodeCommandDispatchHook fun(ctx: OpencodeCommandDispatchContext): OpencodeCommandDispatchContext|nil
---@alias OpencodeCommandHookScope string|string[]|'*'

---@class OpencodeCommandHookRegisterOptions
---@field command? OpencodeCommandHookScope

---@alias OpencodeBarSegment { [1]: string, [2]?: string, align?: 'left'|'right', spinner?: boolean }
---@alias OpencodeBarSegmentsHook fun(segments: OpencodeBarSegment[]): OpencodeBarSegment[]|nil
---@class OpencodeHooks
---@field on_topbar_render? OpencodeBarSegmentsHook
---@field on_footer_render? OpencodeBarSegmentsHook
---@field on_file_edited? fun(file: string): nil
---@field on_session_loaded? fun(session: OpencodeSession): nil
---@field on_done_thinking? fun(session: OpencodeSession): nil Called when a session becomes idle.
---@field on_permission_requested? fun(session: OpencodeSession): nil
---@field on_question_asked? fun(session: OpencodeSession): nil
---@field on_command_before? OpencodeCommandDispatchHook
---@field on_command_after? OpencodeCommandDispatchHook
---@field on_command_error? OpencodeCommandDispatchHook
---@field on_command_finally? OpencodeCommandDispatchHook

---@class OpencodeCommandDispatchContext
---@field parsed OpencodeCommandParseResult
---@field intent OpencodeParsedIntent|nil
---@field args string[]|nil
---@field range OpencodeSelectionRange|nil
---@field result? any
---@field error OpencodeCommandDispatchError|nil

---@class OpencodeCommandLifecycleHookSpec
---@field before? OpencodeCommandDispatchHook
---@field after? OpencodeCommandDispatchHook
---@field error? OpencodeCommandDispatchHook
---@field finally? OpencodeCommandDispatchHook
---@field on_command_before? OpencodeCommandDispatchHook
---@field on_command_after? OpencodeCommandDispatchHook
---@field on_command_error? OpencodeCommandDispatchHook
---@field on_command_finally? OpencodeCommandDispatchHook

---@class OpencodeProviders
---@field [string] string[]

---@class OpencodeConfigModule
---@field defaults OpencodeConfig
---@field values OpencodeConfig
---@field setup fun(opts?: OpencodeConfig): nil
---@field get_key_for_function fun(scope: 'editor'|'input_window'|'output_window', function_name: string): string|nil

---@class OpencodeQuickChatConfig
---@field default_model? string -- Use current model if nil
---@field default_agent? string -- Use current mode if nil
---@field instructions? string[] -- Custom instructions for quick chat

---@class OpencodeLoggingConfig
---@field enabled boolean
---@field level 'debug' | 'info' | 'warn' | 'error'
---@field outfile string|nil

---@class OpencodeSlashCommandSpec
---@field desc? string
---@field args? boolean
---@field cmd_str? string
---@field command_name? string
---@field preset_args? string[]
---@field fn? fun(args:string[]|nil):nil|Promise<any>|any

---@class OpencodeDirectoryChange
---@field from string Directory the session is bound to (or was loaded from)
---@field to string Directory the editor is moving to
---@field session OpencodeSession The active session

---@class OpencodeConfig
---@field preferred_picker 'telescope' | 'telescope.nvim' | 'fzf' | 'fzf-lua' | 'mini.pick' | 'snacks' | 'snacks.nvim' | 'select' | nil
---@field default_global_keymaps boolean
---@field default_mode 'build' | 'plan' | string -- Default mode
---@field default_system_prompt string | nil
---@field keymap_prefix string
---@field opencode_executable 'opencode' | string -- Command run for calling opencode
---@field lock_session_to_directory boolean|fun(change: OpencodeDirectoryChange): boolean -- true locks everywhere; a function decides per directory change; errors fall back to following cwd
---@field program_status {enabled: boolean, tmux: boolean} -- OSC 7501 reporting; tmux enables DCS passthrough
---@field server OpencodeServerConfig -- Custom/external server configuration
---@field keymap OpencodeKeymap
---@field ui OpencodeUIConfig
---@field context OpencodeContextConfig
---@field logging OpencodeLoggingConfig
---@field debug OpencodeDebugConfig
---@field prompt_guard? fun(mentioned_files: string[]): boolean
---@field child_readonly boolean
---@field hooks OpencodeHooks
---@field quick_chat OpencodeQuickChatConfig
---@field snapshot_path? string -- Override base path for snapshot storage (default: $XDG_DATA_HOME/opencode). Appends /snapshot/<project_id>/<worktree_hash>

---@class OpencodeQuestionOption
---@field value any Value submitted to the owning Observation
---@field label string Display text
---@field description string Explanation of choice

---@class OpencodeQuestionInfo
---@field key string Stable key within the request
---@field prompt string Complete question
---@field title? string Short display label
---@field type 'string'|'multiselect'|'boolean'|'number'|'integer'
---@field options OpencodeQuestionOption[] Available choices
---@field custom? boolean Allow a custom response
---@field required? boolean

---@class OpencodeQuestionRequest
---@field id string Request ID
---@field session_id string Owning session
---@field status 'pending'|'answered'|'rejected'
---@field fields OpencodeQuestionInfo[]
---@field unavailable_reason? string

---@class OutputAction
---@field text string Action text
---@field type 'diff_revert_all'|'diff_revert_selected_file'|'diff_open'|'diff_toggle_file'|'diff_restore_snapshot_file'|'diff_restore_snapshot_all'|'navigate_session_tree'|'toggle_max_messages'|'undo'|'copy_message'|'fork_session'
---@field args? string[] Optional arguments for the command
---@field key string keybinding for the action
---@field display_line number Line number to display the action
---@field range? { from: number, to: number } Optional range for the action

---@class CodeReferenceTextRange
---@field start_offset integer Raw part text offset, 1-based inclusive
---@field end_offset integer Raw part text offset, 1-based inclusive

---@class CodeReference
---@field session_id string
---@field message_id string
---@field part_id string
---@field path string
---@field line? integer
---@field col? integer
---@field source_kind 'assistant_text'|'tool_file_path'|'user_file_part'|'editor_context_selection'
---@field raw_range? CodeReferenceTextRange Required for assistant_text references
---@field order integer Smaller values appear earlier in the session message/part/text order.

---@class SymbolSnapshotCycle
---@field warm_path fun(self: SymbolSnapshotCycle, path: string)

---@class FormatterContext
---@field interactive boolean
---@field resolve_symbol_targets? boolean
---@field get_child_parts? fun(session_id: string): table[]?
---@field get_background_result? fun(id: string): OpencodeV2BackgroundResult?
---@field get_background_tool? fun(id: string): table?
---@field current_refs? CodeReference[]
---@field current_files? string[]
---@field symbol_cycle? SymbolSnapshotCycle

---@class ToolFormatter
---@field format fun(output: Output, part: table, context?: FormatterContext, ...: any) Write this tool part's content to the output
---@field summary? fun(part: table): string, string, string Icon, label, and value for nested tool rows

---@class OutputTargetRange
---@field line integer Output-local line, 1-based
---@field start_col integer Output-local column, 0-based inclusive
---@field end_col integer Output-local column, 0-based exclusive

---@class OutputTarget
---@field kind 'file'|'diff'|'symbol'|'uri'
---@field range OutputTargetRange
---@field path? string
---@field line? integer
---@field col? integer
---@field token? string
---@field uri? string

---@class RenderedTarget: OutputTarget
---@field part_id string
---@field message_id string

---@alias OutputExtmarkType vim.api.keyset.set_extmark & {start_col:0, spinner_chunk?: integer}
---@alias OutputExtmark OutputExtmarkType|fun():OutputExtmarkType

---@class RestorePoint
---@field id string Unique restore point identifier
---@field from_snapshot_id string|nil ID of the snapshot this restore point is based on
---@field files string[] List of file paths included in the restore point
---@field deleted_files string[] List of files that were deleted in this restore point
---@field created_at number Timestamp when the restore point was created

---@class OpencodeSnapshotPatch
---@field hash string Unique identifier for the snapshot
---@field files string[] List of file paths included in the snapshot

---@class OpenOpts
---@field focus? 'input' | 'output'
---@field start_insert? boolean
---@field new_session? boolean
---@field draft? boolean Open without resuming a session; the tab stays empty until the first prompt
---@field open_action? 'reuse_visible'|'restore_hidden'|'create_fresh'

---@class SendMessageOpts
---@field new_session? boolean
---@field context? OpencodeContextConfig
---@field model? string
---@field agent? string
---@field variant? string
---@field system? string
---@field skills? OpencodeV2SkillInput[] Native V2 skill attachments

---@class CompletionContext
---@field trigger_char string The character that triggered completion
---@field input string The current input text
---@field cursor_pos number Current cursor position
---@field line string The full current line text

---@class CompletionItem
---@field label string Display text for the completion item
---@field kind string Type of completion item (e.g., 'file', 'subagent')
---@field kind_icon string Icon representing the kind
---@field kind_hl? string Highlight group for the kind
---@field detail string Additional detail text
---@field documentation string Documentation text
---@field insert_text string Text to insert when selected
---@field source_name string Name of the completion source
---@field priority? number Optional priority for individual item sorting (lower numbers have higher priority)
---@field data table Additional data associated with the item

---@class CompletionSource
---@field name string Name of the completion source
---@field priority? number Priority for ordering sources
---@field complete fun(context: CompletionContext): Promise<CompletionItem[]>|CompletionItem[] Function to generate completion items
---@field on_complete? fun(item: CompletionItem): nil Callback when item is selected
---@field is_incomplete? boolean Whether the completion results are incomplete (for sources that support pagination)
---@field get_trigger_character? fun(): string|nil Optional function returning the trigger character for this source
---@field custom_kind? integer Custom LSP CompletionItemKind registered for this source

---Extended LSP completion item with opencode-specific rendering fields
---@class OpencodeLspItem : lsp.CompletionItem
---@field kind lsp.CompletionItemKind
---@field kind_hl? string Highlight group for the kind icon
---@field kind_icon string Icon string for the kind

---@class OpencodeContext
---@field current_file OpencodeContextFile|nil
---@field cursor_data OpencodeContextCursorData|nil
---@field mentioned_files string[]|nil
---@field mentioned_subagents string[]|nil
---@field selections OpencodeContextSelection[]|nil
---@field review_comments? OpencodeContextReviewComment[]
---@field linter_errors OpencodeDiagnostic[]|nil
---@field automatic_context? table<string, string> Fingerprints for automatic payloads considered by the last submission

---@class OpencodeContextSelection
---@field file OpencodeContextFile
---@field content string|nil
---@field lines string|nil

---@alias OpencodeReviewCommentSide 'before'|'after'
---@alias OpencodeReviewCommentStatus 'exact'|'moved'|'modified'|'removed'|'missing_file'

---@class OpencodeReviewCommentResolution
---@field status OpencodeReviewCommentStatus
---@field start_line? integer
---@field end_line? integer
---@field current_code? string

---@class OpencodeContextReviewComment
---@field id integer
---@field file string
---@field side OpencodeReviewCommentSide
---@field start_line integer
---@field end_line integer
---@field code string
---@field comment string
---@field session_id string
---@field from? string
---@field to? string
---@field context_before string[]
---@field context_after string[]
---@field anchor_side_line integer
---@field resolution? OpencodeReviewCommentResolution

---@class OpencodeContextCursorData
---@field line number
---@field column number
---@field line_content string
---@field lines_before string[]
---@field lines_after string[]

---@class OpencodeContextFile
---@field path string
---@field name string
---@field extension string
---@field sent_at? number

---@class OpencodeModelModalities
---@field input ('text'|'image'|'audio'|'video')[] Supported input modalities
---@field output ('text')[] Supported output modalities

---@class OpencodeModelCost
---@field input number Cost per input token
---@field output number Cost per output token
---@field cache_read number|nil Cost per cache read token
---@field cache_write number|nil Cost per cache write token

---@class OpencodeModelLimits
---@field context number Maximum context length in tokens
---@field output number Maximum output length in tokens

---@class OpencodeModelVariant
---@field reasoningEffort string Reasoning effort level (e.g., "low", "medium", "high")

---@class OpencodeModel
---@field id string Unique identifier for the model
---@field name string Human-readable name of the model
---@field attachment boolean Whether the model supports file attachments
---@field reasoning boolean Whether the model supports reasoning/thinking
---@field temperature boolean Whether the model supports temperature parameter
---@field tool_call boolean Whether the model supports tool calling
---@field knowledge string|nil Knowledge cutoff date (e.g., "2024-04")
---@field release_date string Release date in YYYY-MM-DD format
---@field last_updated string Last updated date in YYYY-MM-DD format
---@field modalities OpencodeModelModalities Supported input/output modalities
---@field open_weights boolean Whether the model has open weights
---@field limit OpencodeModelLimits Token limits for the model
---@field cost OpencodeModelCost Pricing information for the model
---@field variants table<string, OpencodeModelVariant>|nil Model variants with different configurations

---@class OpencodeProvider
---@field id string Unique identifier for the provider
---@field env string[] Required environment variables for authentication
---@field npm string NPM package name for the provider SDK
---@field api string|nil Base API URL for the provider
---@field name string Human-readable name of the provider
---@field doc string|nil Documentation URL for the provider
---@field models table<string, OpencodeModel> Map of model ID to model configuration

---@class OpencodeProvidersResponse
---@field providers OpencodeProvider[] List of available providers
---@field default table<string, string> Map of provider ID to default model ID

---@class OpencodeToolListItem
---@field id string Tool identifier
---@field description string Tool description
---@field parameters any JSON schema parameters for the tool

---@alias OpencodeToolList OpencodeToolListItem[]

---@class OpencodeAgentPermissionBash
---@field [string] string Permission level ('allow', 'deny', etc.)

---@class OpencodeAgentPermission
---@field edit string Permission level for edit operations
---@field webfetch string Permission level for web fetch operations
---@field bash OpencodeAgentPermissionBash Bash command permissions

---@class OpencodeAgentModel
---@field providerID string Provider identifier
---@field modelID string Model identifier

---@class OpencodeAgent
---@field name string Unique identifier for the agent
---@field description string Human-readable description of the agent
---@field tools table<string, boolean> Map of tool names to availability
---@field options table Additional configuration options
---@field permission OpencodeAgentPermission Permissions for various operations
---@field mode 'primary'|'subagent'|'all' Agent execution mode
---@field builtIn boolean Whether this is a built-in agent
---@field model OpencodeAgentModel|nil Optional model configuration
---@field prompt string|nil Optional custom prompt for the agent
---@field temperature number|nil Optional temperature setting

---@class OpencodeSlashCommand
---@field slash_cmd string The command trigger (e.g., "/help")
---@field desc string|nil Description of the command
---@field fn fun(args:string[]|nil):nil|Promise<any>|any Function to execute the command
---@field args boolean Whether the command accepts arguments

---@class OpencodeRevertSummary
---@field messages number Number of messages reverted
---@field tool_calls number Number of tool calls reverted
---@field files table<string, {additions: number, deletions: number}> Summary of file changes reverted

---@class OpencodeSelectionRange
---@field start number Starting line number (inclusive)
---@field stop number Ending line number (inclusive)

---@class OpencodeSessionStatusInfo
---@field type 'idle'|'busy'|'retry' Current status of the session
---@field message? string Human-readable detail (populated for `retry`)
---@field attempt? number Retry attempt counter (populated for `retry`)
---@field next? number Server-side timestamp of the next retry (populated for `retry`)
---@field action? table Optional retry action metadata (populated for `retry`)