Magentic-UI configuration.

Return value of :func:`classify_bash_command`.

Yielded from ``run_stream()``.

A message in the internal LLM conversation history. Uses ``role`` directly to match the OpenAI API.

Pause/cancel flags and mid-run user-message inbox shared between TeamManager and agents.

One entry in the diff between pre and post probe. ``kind`` values: * ``removed`` — was present, now missing (PRE_AND_POST) * ``added`

Registry of delegatable sub-agents. OmniAgent consults this registry to: 1. Build its tool list (core tools + agent-backed delegation tools).

Result of a sandbox command execution.

Web automation agent with 11 actions, DISPLAY_SIZE=1000 coordinate space. Uses :class:`BrowserEnvironment` so the agent never touches Playwright

A registered tool available to the agent.

Executes commands directly on the host; guest paths are real host paths.

Records execute() calls and pops canned responses from a queue.

Round-based agent orchestrator. Drives a single conversation: builds a system prompt, calls the LLM through :class:`OmniResponses`, parses th

Represents the state of a browser tab.

Result of a scroll or goto operation.

A registered delegatable agent with its tool schema. Attributes: agent: Runtime agent instance satisfying :class:`SubAgentProtocol`.

Mutable state that persists across rounds.

Minimal SubAgentProtocol implementation for testing.

Configuration for FaraQwen3Agent.

Core Fara agent + magentic-ui streaming, pause/resume, critical point. This is the harness that wraps the core agent for use in magentic-ui.

Manages a pool of browser slots inside a Quicksand VM. The VM lifecycle is owned by the injected ``QuicksandSandbox``. This manager only hand

A pre-allocated slot in the port pool.

Represents the saved state of a browser.

Agent is requesting user input. Yield from run_stream(), await the future.

Represents a single execution run within a session

Manages agent lifecycle for OmniAgent / FaraWebSurfer. Simplified for MVP: config from file only (no UI settings), FaraWebSurfer only (no Omn

Result of creating a file.

Result of editing a file.

Web/desktop automation agent with expanded tool sets (FaraNext). Extends FaraQwen3Agent with: - Dynamic tool mode selection (browser vs windo

Emit a filesystem diff for paths touched by destructive or mutating commands.

Snapshot of a single filesystem entry.

Result of inserting into a file.

Quicksand VM sandbox — owns VM lifecycle, execute, mounts, sessions. Args: memory: VM memory (e.g. "4G"). cpus: Number of virtual

Wraps tool execution errors for feeding back to the LLM. All tool errors (parse errors, unknown tool, execution failures) are wrapped in this

Viewport state: current_file, current_line, window, overlap.

Deployment mode controlling which agents are active.

All agent behavior settings exposed to the frontend.

Harness-injected note appended after a bash command's output.

A host-to-guest path mapping.

Emit a hint when a failed command looks like a bash word-split bug. Stays silent when any earlier observer already emitted.

Warn when mv/cp/ln/mkdir/rmdir destinations resolve outside user-visible paths. User-visible paths are the agent workspace and any directories th

Sub-agent stub returning a canned recap + structured handoff info.

Result of a bash command execution, optionally carrying harness annotations.

Result of parsing an LLM response.

Raised by ``acquire_slot`` when every slot is in use.

Agent hit its per-batch ``max_rounds`` cap and is asking the user whether to keep going or stop here. Yielded by ``FaraWebSurfer`` and ``Omni

Result of find_file.

Harness configuration — controls safety checks and approval policies.

Model capability flags for a model endpoint.

Conversation state and LLM I/O for a single OmniAgent session. The history is seeded with the provided system prompt at construction time and

Result of opening a file.

Behavior settings for the OmniAgent (orchestrator).

A ``<tool_call>`` block that failed to parse. ``message`` includes a ``block N:`` prefix so the caller can keep its feedback to the model con

Static files handler with SPA fallback and session-token injection. Reads ``index.html`` once at construction (before the server accepts

Result of search_dir.

Result of search_file.

Manages WebSocket connections and message streaming for team task execution. Args: db_manager: Database manager instance. ap

Behavior settings for the FaraWebSurfer (CUA) agent.

Minimal sub-agent stub that records what it was called with.

Handles application initialization including paths and environment setup

Agent is requesting user approval before executing a tool. Extends InputRequest with tool metadata so the frontend can render an approval car

18-action tool schema for FaraQwen3NextAgent (browser mode). Adds double_click, right_click, triple_click, left_click_drag, hscroll, read_pag

Configuration for FaraQwen3NextAgent.

What ended the sub-agent run.

Coarse outcome of a sub-agent run.

A local Playwright browser implementation that provides flexible browser automation capabilities. Supports both persistent and non-persistent

Configurations for the model clients.

Per-call observer state, threaded through the phases of enrich().

Harness config for the orchestrator agent. ``max_rounds`` caps how many tool-execution rounds the orchestrator may run per batch. When the ca

A successfully-parsed ``<tool_call>`` block.

Paths an observer wants stat-probed.

Delegates every action to ``PlaywrightController`` + ``Page``.

PlaywrightBrowser backed by a Quicksand VM slot. The browser manager (singleton) is injected at construction time. ``_start`` acquires a slot

Quicksand VM sandbox configuration.

Manages database schema validation and migrations using Alembic. Operations are initiated explicitly by DatabaseManager.

A folder the user has granted persistent 'Always Allow' access to.

Harness config for the FaraWebSurfer agent (CUA). ``max_rounds`` caps how many actions the CUA may take before pausing to ask the user whethe

Internal model representing all application paths

Sub-agent that fails the first run with BrowserSlotPoolFullError, then succeeds on the retry. Records the call count so we can assert OmniAgen