Pause the animation and update status. Args: status: Status to show while paused

Add a new message to the store. Args: message: The message data to add.

Return the notification for *key*, or `None` when not registered.

r"""Create a deep agent. By default, this agent has access to the following tools: - `write_todos`: manage a todo list - `ls`, `read_fil

Create a `ToolCall` efficiency assertion. Args: name: Expected tool name. step: Optional 1-indexed step to restrict the search to

Mount a message widget to the messages area. This method also stores the message data and handles pruning when the widget count excee

Yield items while mutating the dict mid-iteration.

Clear all tracked media and reset counters.

Send a GET request and decode JSON. Args: path: Absolute bridge endpoint path. Returns: JSON-decoded respons

Create a `FinalTextContains` success assertion. Args: text: The substring to look for in the final agent text. case_insensitive:

Handle a slash command. Args: command: The slash command (including /)

Get the glyph set for the current charset mode. Returns: The appropriate Glyphs instance based on charset mode detection.

Exit the app after shutting down background resources. Args: result: Return value passed to the app runner. return_co

Insert or replace a subagent record, preserving arrival order.

Parse command line arguments. Returns: Parsed arguments namespace.

Load config from file. When called with the default path, results are cached for the lifetime of the process. Use `clear_caches()` to

Row index in the parent list.

Append correctness assertions that hard-fail the test when violated. Args: *assertions: One or more `SuccessAssertion` instances.

Write file content to the mapped real path.

Append efficiency assertions that are logged but never fail. Args: agent_steps: Expected number of agent steps. tool_

Render the model label with width-aware truncation. Returns: Text content, truncated from the left when necessary.

Run agent eval against the given query. Args: agent: The compiled state graph to invoke. query: A string prompt or list of messag

Delegate to internal mock so callers can assert calls.

Return `app` as dynamic for test-only Textual method patching. Textual apps expose real methods at type-check time, but these tests replace t

Register a harness profile for a provider or specific model. !!! beta `deepagents.profiles` exposes beta APIs that may receive minor cha

Load state from the user-local deploy cache. Returns an empty state if the file does not exist. With `reset=True`, deletes the file (

Mark the group complete; no further members will join.

Create a mock LLM model for summarization. Args: summary_response: The text to return as the summary for testing purposes.

Show the thread selector screen.

Stop the animation (widget will be removed by caller).

Yield values while mutating the dict mid-iteration.

Return a patch context manager for `list_threads`. Args: threads: Thread list to return. Defaults to `MOCK_THREADS`.

Create a chat model. Uses `init_chat_model` for standard providers, or imports a custom `BaseChatModel` subclass when the provider has a `cla

Format tool calls for display with tool-specific smart formatting. Shows the most relevant information for each tool type rather than all argumen

Create a mock `Runtime`. Note: `Runtime` does not have a `config` attribute. Config is accessed via `get_config()` from langgraph's contextva

Extract all command types from a shell command, handling && separators. For security-sensitive commands (python, node, npm, uv, etc.), includes t

Wait two frames so the prefix-strip text-change event propagates.

Create a StoreBackend backed by InMemoryStore, optionally pre-populated with files.

Apply one validated subagent lifecycle event. The caller (textual adapter) has already checked `type == "subagent"` and that this is

Create a new file, routing to appropriate backend. Args: file_path: Absolute file path. content: File content as a st

Execute a command using subprocess on the local machine. Args: command: Full shell command string to execute. timeout

Wait for the authorization callback and return `(code, state)`. Returns: The OAuth authorization code and optional state.

Create a mock BaseChatModel with model_name set.

Upload multiple files to the filesystem. Args: files: List of `(path, content)` tuples where content is bytes. Returns:

Helper to call wrap_model_call and capture what was passed to handler. Args: middleware: The middleware instance to test. state:

Factory fixture to mock sys.argv with given arguments.

Reset module-level caches so the next call recomputes from scratch. Intended for tests and for the `/reload` command.

Return the manifest entry for `key`, or `None` when unknown.

Write a JSON config dict to a temp file and return the path.

Check if a shell command is in the allow-list. The allow-list matches against the first token of the command (the executable name). This allo

Resolve an option against the environment then `config.toml`. Args: option: The option to resolve. toml_data: Parsed `config.toml

Create a `FileData` object with timestamps. Args: content: File content as string (plain text or base64-encoded binary). created_

Execute a task with output directed to Textual UI. This is the Textual-compatible version of execute_task() that uses the TextualUIAdapter fo

Stop animation before delegating DOM removal to Textual. Returns: Awaitable that completes once the widget is removed from the DO

Run a bash section snippet and return stdout. Note: bash scripts may return exit code 1 when their last conditional evaluates to false (e.g.,

Write content to a file, creating it or overwriting it if it already exists. Returns `WriteResult` on success or error.

Patch thread config loaders for tests.

Create a realistic conversation message sequence. Args: num_old: Number of "old" messages that will be summarized num_recent: Num

Push the prompt and capture the dismissal result.

Build a ContextHubBackend with a mocked langsmith.Client. `files` pre-populates the `pull_agent` return as `AgentContext.files`. Entry values

Look up an env var with `DEEPAGENTS_CODE_` prefix override. Checks `DEEPAGENTS_CODE_{name}` first, then falls back to `{name}`. If the prefi

Dispatch a parsed `dcode auth` invocation. Returns: Process exit code (`0` on success, non-zero on error).

Build the banner content. When the primary project URL is resolved and a thread ID is set, the thread ID is rendered as a clickable h

Async version of write.

Entry point for console script.

Register a `ProviderProfile` for a provider or specific model. !!! beta `deepagents.profiles` exposes beta APIs that may receive minor c

List skills from built-in, user, and/or project directories. This is a dcode-specific wrapper around the prebuilt middleware's skill loading

Load and validate MCP configuration from a JSON file. Supports multiple server types: - stdio: Process-based servers with `command`, `args`,

Handle one inbound channel message. Args: channel: Channel that delivered the message. message: Inbound message to pr

Show, update, or hide the loading spinner. Also drives the terminal's `OSC 9;4` progress indicator, when supported, so taskbar / dock

Get the resolved backend instance from backend or factory. Args: runtime: The tool runtime context. Returns:

Create a CLI-configured agent with flexible options. This is the main entry point for creating a Deep Agents Code agent, usable both internal

Update suggestions when text changes.

Create a ModelRequest with a runtime that carries CLIContext.

Create settings by detecting the current environment. Args: start_path: Directory to start project detection from (defaults to cw

Create a minimal model response for handler mocks.

Inject the ask_user system prompt. Returns: Model response from the wrapped handler.

Invoke a FilesystemMiddleware tool configured with permissions.

Get the previous history entry matching a substring query. The query is captured on the first call of a navigation session (when `_cu