This repository is a Python library and framework for building and deploying multi-agent AI systems. It provides a structured way to define agents with specific roles, instructions, tools, and communication flows, orchestrated by an Agency. The framework extends the OpenAI Agents SDK with production-grade features: FastAPI web serving with streaming SSE endpoints, realtime voice support via WebSocket and Twilio, MCP (Model Context Protocol) server integration with OAuth authentication, persistent conversation state with load/save callbacks, system reminders for prompt engineering, input/output guardrails, and observability hooks for Langfuse/AgentOps. It also includes CLI tools for scaffolding agents and migrating from OpenAI Assistant configurations. Architecturally, the system is a library that can be used programmatically (create Agent and Agency instances, call get_response) or deployed as a FastAPI application via run_fastapi(). The core data flow involves user messages flowing through an agent's execution pipeline, which may invoke tools (built-in, MCP, OpenAPI, LangChain), hand off to other agents via SendMessage/Handoff, and stream responses back. The ThreadManager provides flat message storage with agent/caller metadata, supporting thread isolation and persistence. The tool system uses Pydantic models for schema generation and supports concurrency control. Key entry points include the Agent and Agency classes for programmatic use, run_fastapi() for web deployment, run_realtime() for voice, run_mcp() for MCP server, and CLI commands (create-agent-template, migrate-agent, import-tool). External dependencies include the OpenAI Agents SDK (pinned), FastAPI, Pydantic, and optional integrations like LiteLLM, LangChain, and MCP SDK. The codebase demonstrates strong engineering practices with extensive test coverage (unit, integration, live API), modular design, and reusable patterns such as the BaseTool class, ToolFactory adapter, ThreadManager message store, and OAuth flow for MCP. However, it has tight coupling to the OpenAI Agents SDK internals, requiring careful maintenance as the SDK evolves.