diff --git a/docs/type_registry/index.md b/docs/type_registry/index.md
index 19020bf0..2a1cdd50 100644
--- a/docs/type_registry/index.md
+++ b/docs/type_registry/index.md
@@ -85,7 +85,6 @@ Generated by `scripts/generate_type_registry.py`. Re-run the script (or invoke `
 - `ThemeFile` (dataclass) - [`src\theme_models.py`](src\theme_models.md#src\theme_models.py::ThemeFile)
 - `CommsLogEntry` (dataclass) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::CommsLogEntry)
 - `HistoryMessage` (dataclass) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::HistoryMessage)
-- `FileItem` (dataclass) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::FileItem)
 - `ToolDefinition` (dataclass) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::ToolDefinition)
 - `SessionInsights` (dataclass) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::SessionInsights)
 - `DiscussionSettings` (dataclass) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::DiscussionSettings)
@@ -98,6 +97,7 @@ Generated by `scripts/generate_type_registry.py`. Re-run the script (or invoke `
 - `Metadata` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::Metadata)
 - `CommsLog` (TypeAlias) - [`src\type_aliases.py`](src\type_aliases.md#src\type_aliases.py::CommsLog)
 - `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)
 - `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)
diff --git a/docs/type_registry/src_type_aliases.md b/docs/type_registry/src_type_aliases.md
index 6a0a5b71..1bfed696 100644
--- a/docs/type_registry/src_type_aliases.md
+++ b/docs/type_registry/src_type_aliases.md
@@ -14,7 +14,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::CommsLogCallback`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 169
+**Defined at:** line 151
 **Resolves to:** `Callable[[CommsLogEntry], None]`
 
 **Note:** `CommsLogCallback` is a semantic alias. The type registry is auto-generated from the source code.
@@ -38,7 +38,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::CustomSlice`
 
 **Kind:** `dataclass`
-**Defined at:** line 118
+**Defined at:** line 100
 
 **Fields:**
 - `tag: str`
@@ -50,7 +50,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::DiscussionSettings`
 
 **Kind:** `dataclass`
-**Defined at:** line 108
+**Defined at:** line 90
 
 **Fields:**
 - `temperature: float`
@@ -60,23 +60,17 @@ Auto-generated from source. 20 struct(s) defined in this module.
 
 ## `src\type_aliases.py::FileItem`
 
-**Kind:** `dataclass`
-**Defined at:** line 54
-
-**Fields:**
-- `path: str`
-- `content: str`
-- `view_mode: str`
-- `summary: str`
-- `skeleton: str`
-- `annotations: Metadata`
-- `tags: list`
+**Kind:** `TypeAlias`
+**Defined at:** line 53
+**Resolves to:** `'models.FileItem'`
+**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 72
+**Defined at:** line 54
 **Resolves to:** `list[FileItem]`
 **Used by:** `FileItemsDiff`
 
@@ -85,7 +79,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::FileItemsDiff`
 
 **Kind:** `NamedTuple`
-**Defined at:** line 175
+**Defined at:** line 157
 
 **Fields:**
 - `refreshed: FileItems`
@@ -118,7 +112,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::JsonPrimitive`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 171
+**Defined at:** line 153
 **Resolves to:** `str | int | float | bool | None`
 **Used by:** `JsonValue`
 
@@ -127,7 +121,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::JsonValue`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 172
+**Defined at:** line 154
 **Resolves to:** `JsonPrimitive | list['JsonValue'] | dict[str, 'JsonValue']`
 **Used by:** `OpenAICompatibleRequest`, `WebSocketMessage`
 
@@ -136,7 +130,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::MMAUsageStats`
 
 **Kind:** `dataclass`
-**Defined at:** line 129
+**Defined at:** line 111
 
 **Fields:**
 - `model: str`
@@ -149,14 +143,14 @@ Auto-generated from source. 20 struct(s) defined in this module.
 **Kind:** `TypeAlias`
 **Defined at:** line 6
 **Resolves to:** `dict[str, Any]`
-**Used by:** `FileItem`, `PathInfo`, `Persona`, `ProviderPayload`, `RAGChunk`, `Session`, `ToolCall`, `ToolDefinition`, `TrackState`, `WorkerContext`, `WorkspaceProfile`
+**Used by:** `PathInfo`, `Persona`, `ProviderPayload`, `RAGChunk`, `Session`, `ToolDefinition`, `TrackState`, `WorkerContext`, `WorkspaceProfile`
 
 **Note:** `Metadata` is a semantic alias. The type registry is auto-generated from the source code.
 
 ## `src\type_aliases.py::PathInfo`
 
 **Kind:** `dataclass`
-**Defined at:** line 160
+**Defined at:** line 142
 
 **Fields:**
 - `logs_dir: Metadata`
@@ -167,7 +161,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::ProviderPayload`
 
 **Kind:** `dataclass`
-**Defined at:** line 139
+**Defined at:** line 121
 
 **Fields:**
 - `script: str`
@@ -179,7 +173,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::SessionInsights`
 
 **Kind:** `dataclass`
-**Defined at:** line 95
+**Defined at:** line 77
 
 **Fields:**
 - `total_tokens: int`
@@ -193,8 +187,8 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::ToolCall`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 91
-**Resolves to:** `Metadata`
+**Defined at:** line 73
+**Resolves to:** `'openai_schemas.ToolCall'`
 **Used by:** `ChatMessage`, `NormalizedResponse`, `ToolCall`
 
 **Note:** `ToolCall` is a semantic alias. The type registry is auto-generated from the source code.
@@ -202,7 +196,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::ToolDefinition`
 
 **Kind:** `dataclass`
-**Defined at:** line 76
+**Defined at:** line 58
 
 **Fields:**
 - `name: str`
@@ -214,7 +208,7 @@ Auto-generated from source. 20 struct(s) defined in this module.
 ## `src\type_aliases.py::UIPanelConfig`
 
 **Kind:** `dataclass`
-**Defined at:** line 150
+**Defined at:** line 132
 
 **Fields:**
 - `separate_message_panel: bool`
diff --git a/docs/type_registry/type_aliases.md b/docs/type_registry/type_aliases.md
index 6e25749b..8c312110 100644
--- a/docs/type_registry/type_aliases.md
+++ b/docs/type_registry/type_aliases.md
@@ -2,7 +2,7 @@
 
 # Module: `src/type_aliases.py (TypeAliases only)`
 
-Auto-generated from source. 8 struct(s) defined in this module.
+Auto-generated from source. 9 struct(s) defined in this module.
 
 ## `src\type_aliases.py::CommsLog`
 
@@ -16,15 +16,24 @@ Auto-generated from source. 8 struct(s) defined in this module.
 ## `src\type_aliases.py::CommsLogCallback`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 169
+**Defined at:** line 151
 **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::FileItem`
+
+**Kind:** `TypeAlias`
+**Defined at:** line 53
+**Resolves to:** `'models.FileItem'`
+**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 72
+**Defined at:** line 54
 **Resolves to:** `list[FileItem]`
 **Used by:** `FileItemsDiff`
 
@@ -42,7 +51,7 @@ Auto-generated from source. 8 struct(s) defined in this module.
 ## `src\type_aliases.py::JsonPrimitive`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 171
+**Defined at:** line 153
 **Resolves to:** `str | int | float | bool | None`
 **Used by:** `JsonValue`
 
@@ -51,7 +60,7 @@ Auto-generated from source. 8 struct(s) defined in this module.
 ## `src\type_aliases.py::JsonValue`
 
 **Kind:** `TypeAlias`
-**Defined at:** line 172
+**Defined at:** line 154
 **Resolves to:** `JsonPrimitive | list['JsonValue'] | dict[str, 'JsonValue']`
 **Used by:** `OpenAICompatibleRequest`, `WebSocketMessage`
 
@@ -62,15 +71,15 @@ Auto-generated from source. 8 struct(s) defined in this module.
 **Kind:** `TypeAlias`
 **Defined at:** line 6
 **Resolves to:** `dict[str, Any]`
-**Used by:** `FileItem`, `PathInfo`, `Persona`, `ProviderPayload`, `RAGChunk`, `Session`, `ToolCall`, `ToolDefinition`, `TrackState`, `WorkerContext`, `WorkspaceProfile`
+**Used by:** `PathInfo`, `Persona`, `ProviderPayload`, `RAGChunk`, `Session`, `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 91
-**Resolves to:** `Metadata`
+**Defined at:** line 73
+**Resolves to:** `'openai_schemas.ToolCall'`
 **Used by:** `ChatMessage`, `NormalizedResponse`, `ToolCall`
 
 **Note:** `ToolCall` is a semantic alias. The type registry is auto-generated from the source code.