textual_adapter

Create multimodal message content with text and images.

Extract @file mentions and return the text with resolved file paths.

Parses @file mentions from the input text and resolves them to absolute file paths. Files that do not exist or cannot be resolved are excluded with a warning printed to the console.

Email addresses (e.g., user@example.com) are automatically excluded by detecting email-like characters before the @ symbol.

Backslash-escaped spaces in paths (e.g., @my\ folder/file.txt) are unescaped before resolution. Tilde paths (e.g., @~/file.txt) are expanded via Path.expanduser(). Only regular files are returned; directories are excluded.

This function does not raise exceptions; invalid paths are handled internally with a console warning.

Convert ToolMessage content into a printable string.

Execute a task with output directed to Textual UI.

This is the Textual-compatible version of execute_task() that uses the TextualUIAdapter for all UI operations.

Collect file operation metrics during a CLI interaction.

Track pasted images in the current conversation.

Widget displaying an app message.

Widget displaying an assistant message with markdown support.

Uses MarkdownStream for smoother streaming instead of re-rendering the full content on each update.

Widget displaying a diff with syntax highlighting.

Widget displaying a tool call with collapsible output.

Tool outputs are shown as a 3-line preview by default. Press Ctrl+E to expand/collapse the full output. Shows an animated "Running..." indicator while the tool is executing.

Adapter for rendering agent output to Textual widgets.

This adapter provides an abstraction layer between the agent execution and the Textual UI, allowing streaming output to be rendered as widgets.