Foundations¶
The foundations layer holds the core abstractions every other module in AI-Parrot is built on: the hook/event bus, the data models shared between clients, bots and tools, and the architectural decisions that keep the framework vendor-agnostic and fully async.
What lives here¶
- Core hooks & event bus — the cross-cutting infrastructure agents
use to publish lifecycle events, attach observers and compose
middleware. Source:
parrot.core.hooks. - Pydantic data models —
AIMessage,SourceDocument,MessageResponse,ToolCalland friends. These are the lingua franca between clients, bots and integrations. Source:parrot.models. - Helpers & utils — small reusable building blocks (string normalisation, async runners, retry decorators).
Read next¶
For the long-form architectural reasoning behind these pieces, see the nine-part architecture series in this section's sidebar:
- Architecture — MCP Server
- Architecture — A2A
- Architecture — Toolkits
- Architecture — Interaction Surface
- Architecture — Hardening
- Architecture — Cross-cutting Concerns
- Architecture — AgentCrew
- Architecture — AgentsFlow DAG
- Architecture — Ontologic RAG
API reference¶
The auto-generated API for these modules is in API Reference → Clients and the per-module pages that follow it.