docs(type_registry): initial auto-generated registry (Phase 2)

2026-06-21 12:57:49 -04:00
parent f7c16954d4
commit f8990dae11
18 changed files with 985 additions and 0 deletions
@@ -0,0 +1,82 @@
+# Type Registry
+
+Auto-generated reference for every `@dataclass`, `NamedTuple`, `TypeAlias`, and `TypedDict` in `src/`.
+Generated by `scripts/generate_type_registry.py`. Re-run the script (or invoke `python scripts/generate_type_registry.py --check` in CI) to keep this in sync with the source.
+
+## Table of Contents
+
+- [`src\beads_client.py`](src\beads_client.md)
+- [`src\command_palette.py`](src\command_palette.md)
+- [`src\diff_viewer.py`](src\diff_viewer.md)
+- [`src\history.py`](src\history.md)
+- [`src\hot_reloader.py`](src\hot_reloader.md)
+- [`src\markdown_table.py`](src\markdown_table.md)
+- [`src\models.py`](src\models.md)
+- [`src\openai_compatible.py`](src\openai_compatible.md)
+- [`src\patch_modal.py`](src\patch_modal.md)
+- [`src\paths.py`](src\paths.md)
+- [`src\result_types.py`](src\result_types.md)
+- [`src\startup_profiler.py`](src\startup_profiler.md)
+- [`src\theme_models.py`](src\theme_models.md)
+- [`src\type_aliases.py`](src\type_aliases.md)
+- [`src\vendor_capabilities.py`](src\vendor_capabilities.md)
+- [`src\vendor_state.py`](src\vendor_state.md)
+
+## Cross-Module Index (by type name)
+
+- `Bead` (dataclass) - [`src\beads_client.py`](src\beads_client.md#src\beads_client.py::Bead)
+- `Command` (dataclass) - [`src\command_palette.py`](src\command_palette.md#src\command_palette.py::Command)
+- `ScoredCommand` (dataclass) - [`src\command_palette.py`](src\command_palette.md#src\command_palette.py::ScoredCommand)
+- `DiffHunk` (dataclass) - [`src\diff_viewer.py`](src\diff_viewer.md#src\diff_viewer.py::DiffHunk)
+- `DiffFile` (dataclass) - [`src\diff_viewer.py`](src\diff_viewer.md#src\diff_viewer.py::DiffFile)
+- `UISnapshot` (dataclass) - [`src\history.py`](src\history.md#src\history.py::UISnapshot)
+- `HistoryEntry` (dataclass) - [`src\history.py`](src\history.md#src\history.py::HistoryEntry)
+- `HotModule` (dataclass) - [`src\hot_reloader.py`](src\hot_reloader.md#src\hot_reloader.py::HotModule)
+- `TableBlock` (dataclass) - [`src\markdown_table.py`](src\markdown_table.md#src\markdown_table.py::TableBlock)
+- `ThinkingSegment` (dataclass) - [`src\models.py`](src\models.md#src\models.py::ThinkingSegment)
+- `Ticket` (dataclass) - [`src\models.py`](src\models.md#src\models.py::Ticket)
+- `Track` (dataclass) - [`src\models.py`](src\models.md#src\models.py::Track)
+- `WorkerContext` (dataclass) - [`src\models.py`](src\models.md#src\models.py::WorkerContext)
+- `Metadata` (dataclass) - [`src\models.py`](src\models.md#src\models.py::Metadata)
+- `TrackState` (dataclass) - [`src\models.py`](src\models.md#src\models.py::TrackState)
+- `FileItem` (dataclass) - [`src\models.py`](src\models.md#src\models.py::FileItem)
+- `Preset` (dataclass) - [`src\models.py`](src\models.md#src\models.py::Preset)
+- `Tool` (dataclass) - [`src\models.py`](src\models.md#src\models.py::Tool)
+- `ToolPreset` (dataclass) - [`src\models.py`](src\models.md#src\models.py::ToolPreset)
+- `BiasProfile` (dataclass) - [`src\models.py`](src\models.md#src\models.py::BiasProfile)
+- `TextEditorConfig` (dataclass) - [`src\models.py`](src\models.md#src\models.py::TextEditorConfig)
+- `ExternalEditorConfig` (dataclass) - [`src\models.py`](src\models.md#src\models.py::ExternalEditorConfig)
+- `Persona` (dataclass) - [`src\models.py`](src\models.md#src\models.py::Persona)
+- `WorkspaceProfile` (dataclass) - [`src\models.py`](src\models.md#src\models.py::WorkspaceProfile)
+- `ContextFileEntry` (dataclass) - [`src\models.py`](src\models.md#src\models.py::ContextFileEntry)
+- `NamedViewPreset` (dataclass) - [`src\models.py`](src\models.md#src\models.py::NamedViewPreset)
+- `ContextPreset` (dataclass) - [`src\models.py`](src\models.md#src\models.py::ContextPreset)
+- `MCPServerConfig` (dataclass) - [`src\models.py`](src\models.md#src\models.py::MCPServerConfig)
+- `MCPConfiguration` (dataclass) - [`src\models.py`](src\models.md#src\models.py::MCPConfiguration)
+- `VectorStoreConfig` (dataclass) - [`src\models.py`](src\models.md#src\models.py::VectorStoreConfig)
+- `RAGConfig` (dataclass) - [`src\models.py`](src\models.md#src\models.py::RAGConfig)
+- `NormalizedResponse` (dataclass) - [`src\openai_compatible.py`](src\openai_compatible.md#src\openai_compatible.py::NormalizedResponse)
+- `OpenAICompatibleRequest` (dataclass) - [`src\openai_compatible.py`](src\openai_compatible.md#src\openai_compatible.py::OpenAICompatibleRequest)
+- `PendingPatch` (dataclass) - [`src\patch_modal.py`](src\patch_modal.md#src\patch_modal.py::PendingPatch)
+- `PathsConfig` (dataclass) - [`src\paths.py`](src\paths.md#src\paths.py::PathsConfig)
+- `ErrorInfo` (dataclass) - [`src\result_types.py`](src\result_types.md#src\result_types.py::ErrorInfo)
+- `Result` (dataclass) - [`src\result_types.py`](src\result_types.md#src\result_types.py::Result)
+- `NilPath` (dataclass) - [`src\result_types.py`](src\result_types.md#src\result_types.py::NilPath)
+- `NilRAGState` (dataclass) - [`src\result_types.py`](src\result_types.md#src\result_types.py::NilRAGState)
+- `_Phase` (dataclass) - [`src\startup_profiler.py`](src\startup_profiler.md#src\startup_profiler.py::_Phase)
+- `StartupProfiler` (dataclass) - [`src\startup_profiler.py`](src\startup_profiler.md#src\startup_profiler.py::StartupProfiler)
+- `ThemePalette` (dataclass) - [`src\theme_models.py`](src\theme_models.md#src\theme_models.py::ThemePalette)
+- `ThemeFile` (dataclass) - [`src\theme_models.py`](src\theme_models.md#src\theme_models.py::ThemeFile)
+- `FileItemsDiff` (NamedTuple) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::FileItemsDiff)
+- `Metadata` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::Metadata)
+- `CommsLogEntry` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::CommsLogEntry)
+- `CommsLog` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::CommsLog)
+- `HistoryMessage` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::HistoryMessage)
+- `History` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::History)
+- `FileItem` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::FileItem)
+- `FileItems` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::FileItems)
+- `ToolDefinition` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::ToolDefinition)
+- `ToolCall` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::ToolCall)
+- `CommsLogCallback` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::CommsLogCallback)
+- `VendorCapabilities` (dataclass) - [`src\vendor_capabilities.py`](src\vendor_capabilities.md#src\vendor_capabilities.py::VendorCapabilities)
+- `VendorMetric` (dataclass) - [`src\vendor_state.py`](src\vendor_state.md#src\vendor_state.py::VendorMetric)
@@ -0,0 +1,15 @@
+# Module: `src\beads_client.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\beads_client.py::Bead`
+
+**Kind:** `dataclass`
+**Defined at:** line 9
+
+**Fields:**
+- `id: str`
+- `title: str`
+- `description: str`
+- `status: str`
+
@@ -0,0 +1,28 @@
+# Module: `src\command_palette.py`
+
+Auto-generated from source. 2 struct(s) defined in this module.
+
+## `src\command_palette.py::Command`
+
+**Kind:** `dataclass`
+**Defined at:** line 13
+
+**Fields:**
+- `id: str`
+- `title: str`
+- `category: str`
+- `shortcut: Optional[str]`
+- `description: str`
+- `enabled_when: Optional[str]`
+- `action: Optional[Callable]`
+
+
+## `src\command_palette.py::ScoredCommand`
+
+**Kind:** `dataclass`
+**Defined at:** line 23
+
+**Fields:**
+- `command: Command`
+- `score: float`
+
@@ -0,0 +1,28 @@
+# Module: `src\diff_viewer.py`
+
+Auto-generated from source. 2 struct(s) defined in this module.
+
+## `src\diff_viewer.py::DiffFile`
+
+**Kind:** `dataclass`
+**Defined at:** line 22
+
+**Fields:**
+- `old_path: str`
+- `new_path: str`
+- `hunks: List[DiffHunk]`
+
+
+## `src\diff_viewer.py::DiffHunk`
+
+**Kind:** `dataclass`
+**Defined at:** line 13
+
+**Fields:**
+- `header: str`
+- `lines: List[str]`
+- `old_start: int`
+- `old_count: int`
+- `new_start: int`
+- `new_count: int`
+
@@ -0,0 +1,36 @@
+# Module: `src\history.py`
+
+Auto-generated from source. 2 struct(s) defined in this module.
+
+## `src\history.py::HistoryEntry`
+
+**Kind:** `dataclass`
+**Defined at:** line 66
+
+**Fields:**
+- `state: typing.Any`
+- `description: str`
+- `timestamp: float`
+
+
+## `src\history.py::UISnapshot`
+
+**Kind:** `dataclass`
+**Defined at:** line 8
+**Summary:** Capture of restorable UI state.
+
+**Fields:**
+- `ai_input: str`
+- `project_system_prompt: str`
+- `global_system_prompt: str`
+- `base_system_prompt: str`
+- `use_default_base_prompt: bool`
+- `temperature: float`
+- `top_p: float`
+- `max_tokens: int`
+- `auto_add_history: bool`
+- `disc_entries: list[dict]`
+- `files: list[dict]`
+- `context_files: list[dict]`
+- `screenshots: list[str]`
+
@@ -0,0 +1,15 @@
+# Module: `src\hot_reloader.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\hot_reloader.py::HotModule`
+
+**Kind:** `dataclass`
+**Defined at:** line 15
+
+**Fields:**
+- `name: str`
+- `file_path: str`
+- `state_keys: list[str]`
+- `delegation_targets: list[str]`
+
@@ -0,0 +1,15 @@
+# Module: `src\markdown_table.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\markdown_table.py::TableBlock`
+
+**Kind:** `dataclass`
+**Defined at:** line 28
+**Summary:** Frozen GFM table block.
+
+**Fields:**
+- `headers: list[str]`
+- `rows: list[list[str]]`
+- `span: tuple[int, int]`
+
@@ -0,0 +1,280 @@
+# Module: `src\models.py`
+
+Auto-generated from source. 22 struct(s) defined in this module.
+
+## `src\models.py::BiasProfile`
+
+**Kind:** `dataclass`
+**Defined at:** line 667
+
+**Fields:**
+- `name: str`
+- `tool_weights: Dict[str, int]`
+- `category_multipliers: Dict[str, float]`
+
+
+## `src\models.py::ContextFileEntry`
+
+**Kind:** `dataclass`
+**Defined at:** line 878
+
+**Fields:**
+- `path: str`
+- `view_mode: str`
+- `custom_slices: list`
+- `ast_mask: dict`
+- `ast_signatures: bool`
+- `ast_definitions: bool`
+
+
+## `src\models.py::ContextPreset`
+
+**Kind:** `dataclass`
+**Defined at:** line 932
+
+**Fields:**
+- `name: str`
+- `files: list[ContextFileEntry]`
+- `screenshots: list[str]`
+- `description: str`
+
+
+## `src\models.py::ExternalEditorConfig`
+
+**Kind:** `dataclass`
+**Defined at:** line 723
+
+**Fields:**
+- `editors: Dict[str, TextEditorConfig]`
+- `default_editor: Optional[str]`
+
+
+## `src\models.py::FileItem`
+
+**Kind:** `dataclass`
+**Defined at:** line 533
+
+**Fields:**
+- `path: str`
+- `auto_aggregate: bool`
+- `force_full: bool`
+- `view_mode: str`
+- `selected: bool`
+- `ast_signatures: bool`
+- `ast_definitions: bool`
+- `ast_mask: dict[str, str]`
+- `custom_slices: list[dict]`
+- `injected_at: Optional[float]`
+
+
+## `src\models.py::MCPConfiguration`
+
+**Kind:** `dataclass`
+**Defined at:** line 997
+
+**Fields:**
+- `mcpServers: Dict[str, MCPServerConfig]`
+
+
+## `src\models.py::MCPServerConfig`
+
+**Kind:** `dataclass`
+**Defined at:** line 964
+
+**Fields:**
+- `name: str`
+- `command: Optional[str]`
+- `args: List[str]`
+- `url: Optional[str]`
+- `auto_start: bool`
+
+
+## `src\models.py::Metadata`
+
+**Kind:** `dataclass`
+**Defined at:** line 434
+
+**Fields:**
+- `id: str`
+- `name: str`
+- `status: Optional[str]`
+- `created_at: Optional[datetime.datetime]`
+- `updated_at: Optional[datetime.datetime]`
+
+
+## `src\models.py::NamedViewPreset`
+
+**Kind:** `dataclass`
+**Defined at:** line 907
+
+**Fields:**
+- `name: str`
+- `view_mode: str`
+- `ast_mask: dict`
+- `custom_slices: list`
+
+
+## `src\models.py::Persona`
+
+**Kind:** `dataclass`
+**Defined at:** line 760
+
+**Fields:**
+- `name: str`
+- `preferred_models: list[Metadata]`
+- `system_prompt: str`
+- `tool_preset: Optional[str]`
+- `bias_profile: Optional[str]`
+- `context_preset: Optional[str]`
+- `aggregation_strategy: Optional[str]`
+
+
+## `src\models.py::Preset`
+
+**Kind:** `dataclass`
+**Defined at:** line 592
+
+**Fields:**
+- `name: str`
+- `system_prompt: str`
+
+
+## `src\models.py::RAGConfig`
+
+**Kind:** `dataclass`
+**Defined at:** line 1052
+
+**Fields:**
+- `enabled: bool`
+- `vector_store: VectorStoreConfig`
+- `embedding_provider: str`
+- `chunk_size: int`
+- `chunk_overlap: int`
+
+
+## `src\models.py::TextEditorConfig`
+
+**Kind:** `dataclass`
+**Defined at:** line 696
+
+**Fields:**
+- `name: str`
+- `path: str`
+- `diff_args: List[str]`
+
+
+## `src\models.py::ThinkingSegment`
+
+**Kind:** `dataclass`
+**Defined at:** line 284
+
+**Fields:**
+- `content: str`
+- `marker: str`
+
+
+## `src\models.py::Ticket`
+
+**Kind:** `dataclass`
+**Defined at:** line 302
+
+**Fields:**
+- `id: str`
+- `description: str`
+- `target_symbols: List[str]`
+- `context_requirements: List[str]`
+- `depends_on: List[str]`
+- `status: str`
+- `assigned_to: str`
+- `priority: str`
+- `target_file: Optional[str]`
+- `blocked_reason: Optional[str]`
+- `step_mode: bool`
+- `retry_count: int`
+- `manual_block: bool`
+- `model_override: Optional[str]`
+- `persona_id: Optional[str]`
+
+
+## `src\models.py::Tool`
+
+**Kind:** `dataclass`
+**Defined at:** line 612
+
+**Fields:**
+- `name: str`
+- `approval: str`
+- `weight: int`
+- `parameter_bias: Dict[str, str]`
+
+
+## `src\models.py::ToolPreset`
+
+**Kind:** `dataclass`
+**Defined at:** line 642
+
+**Fields:**
+- `name: str`
+- `categories: Dict[str, List[Union[Tool, Any]]]`
+
+
+## `src\models.py::Track`
+
+**Kind:** `dataclass`
+**Defined at:** line 401
+
+**Fields:**
+- `id: str`
+- `description: str`
+- `tickets: List[Ticket]`
+
+
+## `src\models.py::TrackState`
+
+**Kind:** `dataclass`
+**Defined at:** line 481
+
+**Fields:**
+- `metadata: Metadata`
+- `discussion: List[str]`
+- `tasks: List[Ticket]`
+
+
+## `src\models.py::VectorStoreConfig`
+
+**Kind:** `dataclass`
+**Defined at:** line 1016
+
+**Fields:**
+- `provider: str`
+- `url: Optional[str]`
+- `api_key: Optional[str]`
+- `collection_name: str`
+- `mcp_server: Optional[str]`
+- `mcp_tool: Optional[str]`
+
+
+## `src\models.py::WorkerContext`
+
+**Kind:** `dataclass`
+**Defined at:** line 426
+
+**Fields:**
+- `ticket_id: str`
+- `model_name: str`
+- `messages: list[Metadata]`
+- `tool_preset: Optional[str]`
+- `persona_id: Optional[str]`
+
+
+## `src\models.py::WorkspaceProfile`
+
+**Kind:** `dataclass`
+**Defined at:** line 849
+
+**Fields:**
+- `name: str`
+- `ini_content: str`
+- `show_windows: Dict[str, bool]`
+- `panel_states: Metadata`
+
@@ -0,0 +1,36 @@
+# Module: `src\openai_compatible.py`
+
+Auto-generated from source. 2 struct(s) defined in this module.
+
+## `src\openai_compatible.py::NormalizedResponse`
+
+**Kind:** `dataclass`
+**Defined at:** line 10
+
+**Fields:**
+- `text: str`
+- `tool_calls: list[dict[str, Any]]`
+- `usage_input_tokens: int`
+- `usage_output_tokens: int`
+- `usage_cache_read_tokens: int`
+- `usage_cache_creation_tokens: int`
+- `raw_response: Any`
+
+
+## `src\openai_compatible.py::OpenAICompatibleRequest`
+
+**Kind:** `dataclass`
+**Defined at:** line 20
+
+**Fields:**
+- `messages: list[dict[str, Any]]`
+- `model: str`
+- `temperature: float`
+- `top_p: float`
+- `max_tokens: int`
+- `tools: Optional[list[dict[str, Any]]]`
+- `tool_choice: str`
+- `stream: bool`
+- `stream_callback: Optional[Callable[[str], None]]`
+- `extra_body: Optional[dict[str, Any]]`
+
@@ -0,0 +1,15 @@
+# Module: `src\patch_modal.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\patch_modal.py::PendingPatch`
+
+**Kind:** `dataclass`
+**Defined at:** line 6
+
+**Fields:**
+- `patch_text: str`
+- `file_paths: List[str]`
+- `generated_by: str`
+- `timestamp: float`
+
@@ -0,0 +1,21 @@
+# Module: `src\paths.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\paths.py::PathsConfig`
+
+**Kind:** `dataclass`
+**Defined at:** line 53
+**Summary:** Immutable snapshot of resolved paths. Created ONCE per process.
+
+**Fields:**
+- `config_path: Path`
+- `presets: Path`
+- `tool_presets: Path`
+- `personas: Path`
+- `themes: Path`
+- `workspace_profiles: Path`
+- `credentials: Path`
+- `logs_dir: Path`
+- `scripts_dir: Path`
+
@@ -0,0 +1,47 @@
+# Module: `src\result_types.py`
+
+Auto-generated from source. 4 struct(s) defined in this module.
+
+## `src\result_types.py::ErrorInfo`
+
+**Kind:** `dataclass`
+**Defined at:** line 22
+
+**Fields:**
+- `kind: ErrorKind`
+- `message: str`
+- `source: str`
+- `original: BaseException | None`
+
+
+## `src\result_types.py::NilPath`
+
+**Kind:** `dataclass`
+**Defined at:** line 46
+
+**Fields:**
+- `exists: bool`
+- `read_text: str`
+- `errors: ClassVar[list[ErrorInfo]]`
+
+
+## `src\result_types.py::NilRAGState`
+
+**Kind:** `dataclass`
+**Defined at:** line 54
+
+**Fields:**
+- `enabled: bool`
+- `is_empty_result: bool`
+- `errors: ClassVar[list[ErrorInfo]]`
+
+
+## `src\result_types.py::Result`
+
+**Kind:** `dataclass`
+**Defined at:** line 32
+
+**Fields:**
+- `data: T`
+- `errors: list[ErrorInfo]`
+
@@ -0,0 +1,24 @@
+# Module: `src\startup_profiler.py`
+
+Auto-generated from source. 2 struct(s) defined in this module.
+
+## `src\startup_profiler.py::StartupProfiler`
+
+**Kind:** `dataclass`
+**Defined at:** line 38
+
+**Fields:**
+- `_phases: list[_Phase]`
+- `_enabled: bool`
+
+
+## `src\startup_profiler.py::_Phase`
+
+**Kind:** `dataclass`
+**Defined at:** line 11
+
+**Fields:**
+- `name: str`
+- `start_ts: float`
+- `end_ts: float`
+
@@ -0,0 +1,101 @@
+# Module: `src\theme_models.py`
+
+Auto-generated from source. 2 struct(s) defined in this module.
+
+## `src\theme_models.py::ThemeFile`
+
+**Kind:** `dataclass`
+**Defined at:** line 112
+
+**Fields:**
+- `name: str`
+- `palette: ThemePalette`
+- `syntax_palette: str`
+- `source_path: Path`
+- `scope: str`
+- `description: str`
+
+
+## `src\theme_models.py::ThemePalette`
+
+**Kind:** `dataclass`
+**Defined at:** line 17
+
+**Fields:**
+- `window_bg: tuple[int, int, int]`
+- `child_bg: tuple[int, int, int]`
+- `popup_bg: tuple[int, int, int]`
+- `border: tuple[int, int, int]`
+- `border_shadow: tuple[int, int, int]`
+- `frame_bg: tuple[int, int, int]`
+- `frame_bg_hovered: tuple[int, int, int]`
+- `frame_bg_active: tuple[int, int, int]`
+- `title_bg: tuple[int, int, int]`
+- `title_bg_active: tuple[int, int, int]`
+- `title_bg_collapsed: tuple[int, int, int]`
+- `menu_bar_bg: tuple[int, int, int]`
+- `scrollbar_bg: tuple[int, int, int]`
+- `scrollbar_grab: tuple[int, int, int]`
+- `scrollbar_grab_hovered: tuple[int, int, int]`
+- `scrollbar_grab_active: tuple[int, int, int]`
+- `check_mark: tuple[int, int, int]`
+- `slider_grab: tuple[int, int, int]`
+- `slider_grab_active: tuple[int, int, int]`
+- `button: tuple[int, int, int]`
+- `button_hovered: tuple[int, int, int]`
+- `button_active: tuple[int, int, int]`
+- `header: tuple[int, int, int]`
+- `header_hovered: tuple[int, int, int]`
+- `header_active: tuple[int, int, int]`
+- `separator: tuple[int, int, int]`
+- `separator_hovered: tuple[int, int, int]`
+- `separator_active: tuple[int, int, int]`
+- `resize_grip: tuple[int, int, int]`
+- `resize_grip_hovered: tuple[int, int, int]`
+- `resize_grip_active: tuple[int, int, int]`
+- `tab: tuple[int, int, int]`
+- `tab_hovered: tuple[int, int, int]`
+- `tab_selected: tuple[int, int, int]`
+- `tab_dimmed: tuple[int, int, int]`
+- `tab_dimmed_selected: tuple[int, int, int]`
+- `docking_preview: tuple[int, int, int]`
+- `docking_empty_bg: tuple[int, int, int]`
+- `text: tuple[int, int, int]`
+- `text_disabled: tuple[int, int, int]`
+- `text_selected_bg: tuple[int, int, int]`
+- `table_header_bg: tuple[int, int, int]`
+- `table_border_strong: tuple[int, int, int]`
+- `table_border_light: tuple[int, int, int]`
+- `table_row_bg: tuple[int, int, int]`
+- `table_row_bg_alt: tuple[int, int, int]`
+- `nav_cursor: tuple[int, int, int]`
+- `nav_windowing_dim_bg: tuple[int, int, int]`
+- `nav_windowing_highlight: tuple[int, int, int]`
+- `modal_window_dim_bg: tuple[int, int, int]`
+- `plot_lines: tuple[int, int, int]`
+- `plot_lines_hovered: tuple[int, int, int]`
+- `plot_histogram: tuple[int, int, int]`
+- `plot_histogram_hovered: tuple[int, int, int]`
+- `drag_drop_target: tuple[int, int, int]`
+- `drag_drop_target_bg: tuple[int, int, int]`
+- `input_text_cursor: tuple[int, int, int]`
+- `tab_dimmed_selected_overline: tuple[int, int, int]`
+- `tab_selected_overline: tuple[int, int, int]`
+- `text_link: tuple[int, int, int]`
+- `tree_lines: tuple[int, int, int]`
+- `unsaved_marker: tuple[int, int, int]`
+- `status_success: tuple[int, int, int]`
+- `status_warning: tuple[int, int, int]`
+- `status_error: tuple[int, int, int]`
+- `status_info: tuple[int, int, int]`
+- `bubble_user: tuple[int, int, int]`
+- `bubble_ai: tuple[int, int, int]`
+- `bubble_vendor: tuple[int, int, int]`
+- `bubble_system: tuple[int, int, int]`
+- `slice_manual: tuple[int, int, int]`
+- `slice_auto: tuple[int, int, int]`
+- `slice_selection: tuple[int, int, int]`
+- `diff_added: tuple[int, int, int]`
+- `diff_removed: tuple[int, int, int]`
+- `diff_header: tuple[int, int, int]`
+
@@ -0,0 +1,99 @@
+# Module: `src\type_aliases.py`
+
+Auto-generated from source. 11 struct(s) defined in this module.
+
+## `src\type_aliases.py::CommsLog`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 8
+**Resolves to:** `list[CommsLogEntry]`
+**Used by:** `CommsLogCallback`
+
+**Note:** `CommsLog` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::CommsLogCallback`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 19
+**Resolves to:** `Callable[[CommsLogEntry], None]`
+
+**Note:** `CommsLogCallback` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::CommsLogEntry`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 7
+**Resolves to:** `Metadata`
+**Used by:** `CommsLog`, `CommsLogCallback`
+
+**Note:** `CommsLogEntry` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::FileItem`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 13
+**Resolves to:** `Metadata`
+**Used by:** `FileItems`, `FileItemsDiff`
+
+**Note:** `FileItem` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::FileItems`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 14
+**Resolves to:** `list[FileItem]`
+**Used by:** `FileItemsDiff`
+
+**Note:** `FileItems` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::FileItemsDiff`
+
+**Kind:** `NamedTuple`
+**Defined at:** line 22
+
+**Fields:**
+- `refreshed: FileItems`
+- `changed: FileItems`
+
+
+## `src\type_aliases.py::History`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 11
+**Resolves to:** `list[HistoryMessage]`
+
+**Note:** `History` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::HistoryMessage`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 10
+**Resolves to:** `Metadata`
+**Used by:** `History`
+
+**Note:** `HistoryMessage` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::Metadata`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 5
+**Resolves to:** `dict[str, Any]`
+**Used by:** `CommsLogEntry`, `FileItem`, `HistoryMessage`, `Persona`, `ToolCall`, `ToolDefinition`, `TrackState`, `WorkerContext`, `WorkspaceProfile`
+
+**Note:** `Metadata` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::ToolCall`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 17
+**Resolves to:** `Metadata`
+
+**Note:** `ToolCall` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::ToolDefinition`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 16
+**Resolves to:** `Metadata`
+
+**Note:** `ToolDefinition` is a semantic alias. The type registry is auto-generated from the source code.
@@ -0,0 +1,35 @@
+# Module: `src\vendor_capabilities.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\vendor_capabilities.py::VendorCapabilities`
+
+**Kind:** `dataclass`
+**Defined at:** line 5
+
+**Fields:**
+- `vendor: str`
+- `model: str`
+- `vision: bool`
+- `tool_calling: bool`
+- `caching: bool`
+- `streaming: bool`
+- `model_discovery: bool`
+- `context_window: int`
+- `cost_tracking: bool`
+- `cost_input_per_mtok: float`
+- `cost_output_per_mtok: float`
+- `notes: str`
+- `local: bool`
+- `reasoning: bool`
+- `structured_output: bool`
+- `code_execution: bool`
+- `web_search: bool`
+- `x_search: bool`
+- `file_search: bool`
+- `mcp_support: bool`
+- `audio: bool`
+- `video: bool`
+- `grounding: bool`
+- `computer_use: bool`
+
@@ -0,0 +1,17 @@
+# Module: `src\vendor_state.py`
+
+Auto-generated from source. 1 struct(s) defined in this module.
+
+## `src\vendor_state.py::VendorMetric`
+
+**Kind:** `dataclass`
+**Defined at:** line 5
+**Summary:** Atomic vendor-state metric.
+
+**Fields:**
+- `key: str`
+- `label: str`
+- `value: str`
+- `state: str`
+- `tooltip: str`
+
@@ -0,0 +1,91 @@
+# Type Aliases (from src/type_aliases.py (TypeAliases only))
+
+# Module: `src/type_aliases.py (TypeAliases only)`
+
+Auto-generated from source. 10 struct(s) defined in this module.
+
+## `src\type_aliases.py::CommsLog`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 8
+**Resolves to:** `list[CommsLogEntry]`
+**Used by:** `CommsLogCallback`
+
+**Note:** `CommsLog` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::CommsLogCallback`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 19
+**Resolves to:** `Callable[[CommsLogEntry], None]`
+
+**Note:** `CommsLogCallback` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::CommsLogEntry`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 7
+**Resolves to:** `Metadata`
+**Used by:** `CommsLog`, `CommsLogCallback`
+
+**Note:** `CommsLogEntry` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::FileItem`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 13
+**Resolves to:** `Metadata`
+**Used by:** `FileItems`, `FileItemsDiff`
+
+**Note:** `FileItem` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::FileItems`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 14
+**Resolves to:** `list[FileItem]`
+**Used by:** `FileItemsDiff`
+
+**Note:** `FileItems` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::History`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 11
+**Resolves to:** `list[HistoryMessage]`
+
+**Note:** `History` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::HistoryMessage`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 10
+**Resolves to:** `Metadata`
+**Used by:** `History`
+
+**Note:** `HistoryMessage` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::Metadata`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 5
+**Resolves to:** `dict[str, Any]`
+**Used by:** `CommsLogEntry`, `FileItem`, `HistoryMessage`, `Persona`, `ToolCall`, `ToolDefinition`, `TrackState`, `WorkerContext`, `WorkspaceProfile`
+
+**Note:** `Metadata` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::ToolCall`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 17
+**Resolves to:** `Metadata`
+
+**Note:** `ToolCall` is a semantic alias. The type registry is auto-generated from the source code.
+
+## `src\type_aliases.py::ToolDefinition`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 16
+**Resolves to:** `Metadata`
+
+**Note:** `ToolDefinition` is a semantic alias. The type registry is auto-generated from the source code.