Agency Swarm Agent: Extends the base `agents.Agent` with capabilities for multi-agent collaboration within an `Agency`. This class manag

Orchestrates a collection of `Agent` instances based on a communication flow. This class is the main entry point for interacting with a mult

Configuration for overriding the OpenAI client per-request.

Manage an OpenClaw gateway process for a FastAPI app.

Manages flat message storage with persistence. This class replaces the previous thread-based system with a flat message storage approach wher

A persistent IPython-style interpreter tool with access to the internet and file system. Executes Python code in an isolated, persistent she

Manages permanent file operations for agents, including uploads and vector store management.

Execute shell commands locally with persistent working directory. Allows the agent to run any shell commands like bash, file operations,

Agency-specific context for an agent to enable multi-agency support.

Converts between AG-UI and other formats (e.g., OpenAI Agents SDK), and provides helpers for translating events and messages for AG-UI integr

Shared context object passed around during agent runs via agents.Runner. Holds globally relevant components like the ThreadManager and a map of a

Wrap an async generator while preserving the eventual ``RunResultStreaming``. The wrapper mirrors the generator interface (`__aiter__`, `asend`,

Shared policy for request-level client overrides across FastAPI handlers.

Agency Swarm agent wrapper for an OpenClaw worker.

Process-level registry for MCP servers with persistent connections. Servers are keyed by their readable `name` attribute. New agencies/agents

Async-safe registry for active runs so cancel endpoints see local state.

Returns metadata for local files and ensures they persist by moving them into the MNT directory. Use this tool when you want to show a local

Converts OpenAI Agents SDK events int console message outputs.

Provides sequential input responses for testing.

Usage statistics for a run or session.

Holds mutable per-agency runtime state for a logical agent instance.

Manages temporary file attachments for agent requests.

Manages tool concurrency for a single agent instance. Provides tracking of tool execution state to enforce one-call-at-a-time constraint

Loads a file attachment and returns it in the appropriate format for the agent to view. Supports images (jpg, png, gif, etc.) and PDF files.

Generic proxy routing coroutine methods to the manager's background loop. Avoids coupling to the concrete server implementation by dynamically pr

Represents a flow of agents created with the > or < operators for communication flows. This class allows building flows like: agent1 > agent

Generates HTML visualizations for Agency Swarm agencies. Uses templates for HTML generation.

Represents the state of a concurrency lock.

Container for metadata collected during streaming. Stores metadata by various keys for matching items between streaming and final persistence

Outcome from executing code in a kernel session.

A handoff configuration class for defining agent handoffs.

JSON formatter for file logging with structured data.

Input for running an agent.

Normalize LiteLLM/Chat Completions placeholder IDs. The Agents SDK uses `FAKE_RESPONSES_ID="__fake_id__"` for Responses-style objects produced

Handler that only logs to file when enabled via context variable.

Custom console formatter that includes request ID and enhanced location info.

Encapsulates vector store synchronization and file removal helpers.

Custom tool for testing.

Runtime and proxy settings for OpenClaw integration.

Use this tool to facilitate direct, synchronous communication between specialized agents within your agency. When you send a message using t

Track request override lifecycle for one handler invocation.

Tracks an active streaming run for cancellation support.

Manage a single Jupyter kernel process for one logical client.

Raised when stored chat history cannot be used with the current model protocol.

Middleware that tracks requests and enables conditional file logging.

Context for managing event streaming across nested agent calls.