Main Textual application for deepagents-code.

Middleware for providing filesystem and optional execution tools to an agent. This middleware adds filesystem tools to the agent: `ls`, `read_fil

Backend that reads and writes files directly from the filesystem. Files are accessed using their actual filesystem paths. Relative paths are

Backend that stores files in LangGraph's BaseStore (persistent). Uses LangGraph's Store for persistent, cross-conversation storage. Files are

Widget displaying an app message.

r"""Generic fake chat model that can be used to test the chat model interface. * Chat model should be usable in both sync and async tests * I

Runtime configuration for deep agent behavior. !!! beta `deepagents.profiles` exposes beta APIs that may receive minor changes in

Routes file operations to different backends by path prefix. Matches paths against route prefixes (longest first) and delegates to the corres

A single access rule for filesystem operations.

Backend that stores files in agent state (ephemeral). Uses LangGraph's state management and checkpointing. Files persist within a conversatio

Two-tier assertion container for agent trajectories. Use `.success()` to add correctness assertions (hard-fail) and `.expect()` to add effici

Data structure for storing file contents with metadata.

Widget displaying a tool call with collapsible output. Tool outputs are shown as a 3-line preview by default. Press Ctrl+O to expand/collapse

Minimal app that hosts a ChatInput for testing.

Result of code execution. Simplified schema optimized for LLM consumption.

In-memory message data for virtualization. This dataclass holds all information needed to recreate a message widget. It is designed to be lig

Metadata for a configured MCP server and its tools.

Middleware exposing a JS REPL to the agent. Each LangGraph thread gets its own QuickJS slot (worker + runtime + context), so globals from one

Minimal host app for pushing the auth screens.

Test app for ThreadSelectorScreen.

Fixed version of GenericFakeChatModel that properly handles bind_tools.

Widget displaying an error message.

Minimal concrete implementation of BaseSandbox for testing.

Credential readiness information for a provider. Args: state: Provider auth state. provider: Provider name. env_var: Env

File-backed `TokenStorage` under `~/.deepagents/.state/mcp-tokens/`.

Widget displaying a user message.

Inbound message delivered by a channel adapter. Args: conversation_id: Stable channel-specific conversation identifier. text: Pla

A mock backend that records read/write calls and can simulate failures.

Adapter for rendering agent output to Textual widgets. This adapter provides an abstraction layer between the agent execution and the Textual

Modal viewer for active MCP servers and their tools. Displays servers grouped by name with transport type and tool count. Navigate with arrow

One user-tunable configuration option and where it can be set.

Minimal app wrapper for testing MCPViewerScreen.

Minimal app that mounts a StatusBar for testing.

Declarative configuration for constructing a chat model. !!! beta `deepagents.profiles` exposes beta APIs that may receive minor changes

Stats accumulated over a single agent turn (or full session).

Test app for ModelSelectorScreen.

Middleware for loading agent memory from `AGENTS.md` files. Loads memory content from configured sources and injects into the system prompt.

Middleware for loading and exposing agent skills to the system prompt. Loads skills from backend sources and injects them into the system prompt

Approval menu using standard Textual patterns. Key design decisions (following mistral-vibe reference): - Container base class with compose()

Inject local context (git state, project structure, etc.) into the system prompt. Runs a bash detection script via `backend.execute()` on first i

Metadata for a single MCP tool.

Result from backend read operations. Attributes: error: Error message on failure, None on success. file_data: FileData dict on su

Middleware that drives self-evaluated iteration against a rubric. The middleware activates only when a caller passes a `rubric` on invocation

Modal dialog for browsing and resuming threads. Displays recent threads with keyboard navigation, fuzzy search, configurable columns, and del

Result of a single file download operation. The response is designed to allow partial success in batch operations. The errors are standardiz

Result from backend `grep` operations. Attributes: error: Error message on failure, `None` on success. matches: List of grep matc

Full-screen modal for model selection. Displays available models grouped by provider with keyboard navigation and search filtering. Current m

Raised when the on-disk project is malformed.

Result from backend `edit` operations. Attributes: error: Error message on failure, `None` on success. path: Absolute path of edi

Filesystem backend with unrestricted local shell command execution. This backend extends `FilesystemBackend` to add shell command execution c

Result of a single file upload operation. The response is designed to allow partial success in batch operations. The errors are standardized

ACP agent server that bridges Deep Agents with the Agent Client Protocol.

Client-facing builder for the per-run graph context payload. Callers populate this and pass it via `context=` to `astream`/`ainvoke`. `Config

State for the filesystem middleware.

Session state for the Textual app.

Generic fake chat model that can be used to test the chat model interface. * Chat model should be usable in both sync and async tests * Invoke

Manages message data and widget window for virtualization. This class stores all messages as data and manages a sliding window of widgets tha

One button/action row in the notification modal.

A single slash-command definition.

Long-running process host for one Talon assistant. Args: config: Runtime configuration for this assistant. agent: Agent runtime i

Result from backend `glob` operations. Attributes: error: Error message on failure, `None` on success. matches: List of matching

Result from backend `ls` operations. Attributes: error: Error message on failure, `None` on success. entries: List of file info d

Minimal app that mounts a SubagentPanel for testing.

Deep Agents-backed runtime for Talon. Args: model: Chat model identifier for `create_deep_agent`. tools: Runtime tools exposed to

Shared test double for channel adapters. Tracks sent messages and media, and supports injecting inbound messages via ``receive``.

Client that talks to a LangGraph server over HTTP+SSE. Wraps `langgraph.pregel.remote.RemoteGraph` which handles SSE parsing, stream-mode neg

Modal dialog for theme selection with live preview. Displays available themes in an `OptionList`. Navigating the option list applies a live p

Represents a pasted image with its base64 encoding.

App that records ChatInput.Submitted events for assertion.

Middleware for providing subagents to an agent via a `task` tool. This middleware adds a `task` tool to the agent that can be used to invoke

Channel adapter for Telegram via the Bot API with long polling. Only private chats and channel posts are processed. Messages from group and s

Edits applied to the auto-added `general-purpose` subagent. !!! beta `deepagents.profiles` exposes beta APIs that may receive minor chan

Minimal async stream agent used for adapter execution tests.

A pre-compiled agent spec. !!! note The `runnable`'s state schema must include a 'messages' key. This is required for the subag

Minimal configuration for one MemoryAgentBench sub-dataset. Attributes: split: HuggingFace dataset split name (e.g. `Conflict_Resolution`

A single labeled diagnostic fact. `ok` is `False` only for genuine problems (e.g. a missing dependency), not for informational states such as

Revert agent edits to the managed onboarding-name memory block. Guards the managed onboarding-name block in a fixed set of memory files. A `w

Result from backend `write` operations. Attributes: error: Error message on failure, `None` on success. path: Absolute path of wr

Test app for AgentSelectorScreen.

Inbound exposure policy shared by channel adapters.

An action deferred until the current busy state resolves.

Represents a queued user message awaiting processing.

`StringIO` with a context-manager that doesn't truncate on close.

Agent test double that returns a different stream per call.

Declarative harness-profile config for YAML/JSON-backed profiles. !!! beta `deepagents.profiles` exposes beta APIs that may receive mino

Test app for `LaunchNameScreen`.

Fake transport that records calls and returns canned responses.

Outbound media delivered through a channel adapter. Args: path: Local file path visible to the channel adapter. media_type: Chann

Result from backend delete operations. Attributes: error: Error message on failure, None on success. path: Absolute path of the d

Result of formatting tool output for display.

Modal that renders the OAuth login flow and collects user input. Implements the `OAuthInteraction` Protocol structurally so a `mcp_auth.login

Result of creating a chat model, bundling the model with its metadata. This separates model creation from settings mutation so callers can decide

Represents a pasted video with its base64 encoding.

Data returned by `_fetch_thread_history_data`.