docs: revalidate v2.7.2 and harden generated examples

[ashpreetbedi]

Summary

• Revalidate the full docs site against Agno v2.7.2 at 81f50c2389e9710a3aab9fdd298a7215c264b986.
• Harden the examples generator for provider extras, environment variables, database drivers, local services, model setup, repository-layout examples, and dependency deduplication.
• Resync 568 Examples-tab pages while preserving every cookbook fence byte-for-byte.
• Add Telegram's GET /telegram/status and POST /telegram/webhook endpoints to the OpenAPI reference.
• Correct source-backed setup, parameter, protocol, and behavior drift across 44 guide and reference files.

Release baseline

This is a same-tag convergence pass. The previous and current Agno tags are both v2.7.2, so there is no release-source delta to summarize. The changes come from a full fresh-eyes audit and stronger deterministic checks.

• Agno tag: v2.7.2
• Agno commit: 81f50c2389e9710a3aab9fdd298a7215c264b986
• Docs delta: 624 files, 4,167 insertions, 1,933 deletions
• Tracked deletions: 0

Accuracy sweep

• Final navigation: 3,737 unique reachable pages.
• The original 3,735-page inventory was generated programmatically as 623 six-page chunks. Provenance showed 3,725 pages byte-identical to the prior verified convergence tree; the 10 changed pages, 59 manual/tooling files, and two new Telegram stubs received fresh source review.
• Dirty/manual chunks received independent adversarial verification against the tagged Agno source, cookbook, and primary provider documentation.
• Five non-overlapping randomized rounds covered 150 additional pages across the whole navigation. The final two rounds were clean apart from defects logged for upstream.
• The local tmp/UPSTREAM-FLAGS.txt ledger gained 85 flags during this run. Major groups include cookbook/runtime mismatches, storage ID and migration bugs, workflow event and HITL issues, embedder dimension/task errors, and Telegram/OpenAPI gaps.

Deterministic results

Check	Result
Examples plan	2,075 pages: 1,702 KEEP_VERBATIM, 14 REGEN, 359 PRESERVE_CURATED; 0 deletes, conflicts, or unplaced pages
Cookbook fidelity	1,716/1,716 generated first Python fences exact
Examples integrity	TOTAL PROBLEMS: 0
Reference drift	146 pages; 12 known unparseable; 0 wrong defaults
OpenAPI	142 operations, 191 schemas; YAML equals minified JSON; only the two intended Slack enrichments differ from raw generation
Imports	554 unique imports: 406 runtime OK, 148 dependency-only verified in source, 0 real failures
Install coverage	1,421 pages scanned, 0 offenders, 2 intentional review pages
Inventory	111 deliberate orphans, 0 missing nav files, 0 unused media/snippets, 0 redirect defects, 0 broken links or anchors
Template prompts	9/9 byte-identical to template origin/main READMEs
Syntax and style	691 changed Python fences compile; 4 changed Python scripts pass Ruff; 0 em dashes outside fences
Mint	mint broken-links clean

Known holds

• Two existing visual TODOs remain: agent-os/control-plane.mdx and agent-os/tracing/filter-options.mdx.
• The 111 orphans and 60 links to orphans match the deliberate KEEP inventory.
• Install coverage retains two heuristic review pages: Slack features and Culture overview.
• OpenAPI generation still emits Agno's duplicate get_config operation-ID warning. It is recorded upstream.
• No deletions need sign-off.

Ready for Ash's review. This PR is draft and should not be merged automatically.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
agno	🟢 Ready	View Preview	Jul 11, 2026, 6:30 PM

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