docs: align documentation with Agno v3.0.4

[ashpreetbedi]

Summary

• Align generated examples, navigation, references, and setup guidance with Agno v3.0.4.
• Rebuild the OpenAPI reference and add source-backed response, authorization, queue, checkpoint, and transport contracts.
• Strengthen deterministic example generation, migration routing, integrity checks, reference drift checks, and install coverage.
• Repair source-verified documentation issues across AgentOS, models, tools, knowledge, storage, state, and workflows.

Source boundary

• Docs audit base: 61ce5f80eff2e918c18bbb34cc6e6611edc70f78
• Sealed Agno release: v3.0.4
• Sealed Agno SHA: 9dd8f80d8984ceed5ae6bbde16eddf7475eaffa1
• Published branch head: 1e2d681775b063c7e3e120976062ed53b5045cd8

Validation completed at this head

• Full example replay: 1,717 tasks, zero failures, zero warnings.
• Example integrity: 1,717 pages, 1,742 code fences, zero problems.
• Inventory: 4,032 navigable pages with zero broken links or anchors beyond the recorded baseline sets.
• Install coverage: zero offenders.
• Import validation: 579 unique imports, 422 executable and 157 dependency-only source-verified, zero real failures.
• OpenAPI: 146 operations and 220 schemas; tracked files match deterministic generation.
• mint validate, mint broken-links, and git diff --check passed.
• The branch is clean and contains no deleted files relative to the audit base.

Draft status

This PR is intentionally incomplete and must remain draft. The fixed audit window ended during Phase 5 after sample 11. Six accepted findings remain:

• TOOL-0105: WhatsApp webhook request and error contract.
• TOOL-0106: Team checkpoint snapshot response and access contract.
• TOOL-0107: Eval-run pagination response example.
• TOOL-0108: Schedule-list authentication and unsupported-database responses.
• DOC-0124: Chunking overview runnability, prerequisites, and unit guidance.
• DOC-0125: Reasoning event event_index reference coverage.

Coverage still has 1,888 pending and 8 blocked records. Two consecutive clean convergence samples and Phase 6 current-base integration have not been completed. Do not merge until those gates are closed and the final head is revalidated.

Live main advanced to 6a2fc1f09ead6839ba840e2d6af28f61d5f87f6f after this branch's audit base. Its single new commit overlaps four paths and currently conflicts with two generated RBAC pages:

• examples/agent-os/rbac/symmetric/overview.mdx
• examples/agent-os/rbac/symmetric/user-isolation.mdx

Integrate current main, resolve those pages through the generator-owned source, and rerun the affected deterministic gates before moving this PR out of draft.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
agno	🟢 Ready	View Preview	Sep 1, 2026, 10:40 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.