From f8990dae118d39cf7f19f90935439cb01f9483ea Mon Sep 17 00:00:00 2001 From: Ed_ Date: Sun, 21 Jun 2026 12:57:49 -0400 Subject: [PATCH] docs(type_registry): initial auto-generated registry (Phase 2) --- docs/type_registry/index.md | 82 +++++ docs/type_registry/src_beads_client.md | 15 + docs/type_registry/src_command_palette.md | 28 ++ docs/type_registry/src_diff_viewer.md | 28 ++ docs/type_registry/src_history.md | 36 +++ docs/type_registry/src_hot_reloader.md | 15 + docs/type_registry/src_markdown_table.md | 15 + docs/type_registry/src_models.md | 280 ++++++++++++++++++ docs/type_registry/src_openai_compatible.md | 36 +++ docs/type_registry/src_patch_modal.md | 15 + docs/type_registry/src_paths.md | 21 ++ docs/type_registry/src_result_types.md | 47 +++ docs/type_registry/src_startup_profiler.md | 24 ++ docs/type_registry/src_theme_models.md | 101 +++++++ docs/type_registry/src_type_aliases.md | 99 +++++++ docs/type_registry/src_vendor_capabilities.md | 35 +++ docs/type_registry/src_vendor_state.md | 17 ++ docs/type_registry/type_aliases.md | 91 ++++++ 18 files changed, 985 insertions(+) create mode 100644 docs/type_registry/index.md create mode 100644 docs/type_registry/src_beads_client.md create mode 100644 docs/type_registry/src_command_palette.md create mode 100644 docs/type_registry/src_diff_viewer.md create mode 100644 docs/type_registry/src_history.md create mode 100644 docs/type_registry/src_hot_reloader.md create mode 100644 docs/type_registry/src_markdown_table.md create mode 100644 docs/type_registry/src_models.md create mode 100644 docs/type_registry/src_openai_compatible.md create mode 100644 docs/type_registry/src_patch_modal.md create mode 100644 docs/type_registry/src_paths.md create mode 100644 docs/type_registry/src_result_types.md create mode 100644 docs/type_registry/src_startup_profiler.md create mode 100644 docs/type_registry/src_theme_models.md create mode 100644 docs/type_registry/src_type_aliases.md create mode 100644 docs/type_registry/src_vendor_capabilities.md create mode 100644 docs/type_registry/src_vendor_state.md create mode 100644 docs/type_registry/type_aliases.md diff --git a/docs/type_registry/index.md b/docs/type_registry/index.md new file mode 100644 index 00000000..33343ee2 --- /dev/null +++ b/docs/type_registry/index.md @@ -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) diff --git a/docs/type_registry/src_beads_client.md b/docs/type_registry/src_beads_client.md new file mode 100644 index 00000000..47cb55f2 --- /dev/null +++ b/docs/type_registry/src_beads_client.md @@ -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` + diff --git a/docs/type_registry/src_command_palette.md b/docs/type_registry/src_command_palette.md new file mode 100644 index 00000000..1eaa476d --- /dev/null +++ b/docs/type_registry/src_command_palette.md @@ -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` + diff --git a/docs/type_registry/src_diff_viewer.md b/docs/type_registry/src_diff_viewer.md new file mode 100644 index 00000000..1fe64a6d --- /dev/null +++ b/docs/type_registry/src_diff_viewer.md @@ -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` + diff --git a/docs/type_registry/src_history.md b/docs/type_registry/src_history.md new file mode 100644 index 00000000..2c0d54e3 --- /dev/null +++ b/docs/type_registry/src_history.md @@ -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]` + diff --git a/docs/type_registry/src_hot_reloader.md b/docs/type_registry/src_hot_reloader.md new file mode 100644 index 00000000..0bde4b23 --- /dev/null +++ b/docs/type_registry/src_hot_reloader.md @@ -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]` + diff --git a/docs/type_registry/src_markdown_table.md b/docs/type_registry/src_markdown_table.md new file mode 100644 index 00000000..d51264fc --- /dev/null +++ b/docs/type_registry/src_markdown_table.md @@ -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]` + diff --git a/docs/type_registry/src_models.md b/docs/type_registry/src_models.md new file mode 100644 index 00000000..044552c4 --- /dev/null +++ b/docs/type_registry/src_models.md @@ -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` + diff --git a/docs/type_registry/src_openai_compatible.md b/docs/type_registry/src_openai_compatible.md new file mode 100644 index 00000000..d3ad825f --- /dev/null +++ b/docs/type_registry/src_openai_compatible.md @@ -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]]` + diff --git a/docs/type_registry/src_patch_modal.md b/docs/type_registry/src_patch_modal.md new file mode 100644 index 00000000..38ab0bf5 --- /dev/null +++ b/docs/type_registry/src_patch_modal.md @@ -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` + diff --git a/docs/type_registry/src_paths.md b/docs/type_registry/src_paths.md new file mode 100644 index 00000000..43bf6635 --- /dev/null +++ b/docs/type_registry/src_paths.md @@ -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` + diff --git a/docs/type_registry/src_result_types.md b/docs/type_registry/src_result_types.md new file mode 100644 index 00000000..a479220b --- /dev/null +++ b/docs/type_registry/src_result_types.md @@ -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]` + diff --git a/docs/type_registry/src_startup_profiler.md b/docs/type_registry/src_startup_profiler.md new file mode 100644 index 00000000..17c5e68f --- /dev/null +++ b/docs/type_registry/src_startup_profiler.md @@ -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` + diff --git a/docs/type_registry/src_theme_models.md b/docs/type_registry/src_theme_models.md new file mode 100644 index 00000000..e23397aa --- /dev/null +++ b/docs/type_registry/src_theme_models.md @@ -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]` + diff --git a/docs/type_registry/src_type_aliases.md b/docs/type_registry/src_type_aliases.md new file mode 100644 index 00000000..fed90ea1 --- /dev/null +++ b/docs/type_registry/src_type_aliases.md @@ -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. diff --git a/docs/type_registry/src_vendor_capabilities.md b/docs/type_registry/src_vendor_capabilities.md new file mode 100644 index 00000000..af6b05a8 --- /dev/null +++ b/docs/type_registry/src_vendor_capabilities.md @@ -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` + diff --git a/docs/type_registry/src_vendor_state.md b/docs/type_registry/src_vendor_state.md new file mode 100644 index 00000000..0bbba27e --- /dev/null +++ b/docs/type_registry/src_vendor_state.md @@ -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` + diff --git a/docs/type_registry/type_aliases.md b/docs/type_registry/type_aliases.md new file mode 100644 index 00000000..7c795ac4 --- /dev/null +++ b/docs/type_registry/type_aliases.md @@ -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.