Skip to content

docs: audit and align docs with Agno v2.7.4#735

Draft
ashpreetbedi wants to merge 47 commits into
mainfrom
codex/docs-audit-20260719-0149
Draft

docs: audit and align docs with Agno v2.7.4#735
ashpreetbedi wants to merge 47 commits into
mainfrom
codex/docs-audit-20260719-0149

Conversation

@ashpreetbedi

Copy link
Copy Markdown
Contributor

Release boundary

  • Agno: v2.7.4 at d1b3a6dc0ed532ac734efb58eb1206bb3bedff09
  • Docs base: 38a2f82a63cf8baafec2ea9ab42b1cba19d7e37f
  • Docs head: e4ff38a9c212dbb308afa047c538f36bb581a4c6
  • Post-tag Agno work is intentionally out of scope per the repository owner.
  • All moving companion main refs were fetched again immediately before publication and remained at their sealed SHAs.

Scope

  • Retargeted example generation, links, references, and OpenAPI to Agno v2.7.4.
  • Corrected source-backed SDK, CLI, AgentOS, session, workflow, team, auth, storage, and interface contracts.
  • Repaired runnable setup and code defects, including async client examples, missing dependencies, stale model/API guidance, unsafe tool exposure, and media encoding.
  • Aligned deployment and product pages with 17 sealed companion repositories, including current skill counts, runtime registrations, environment flows, and security boundaries.
  • Preserved generated cookbook source byte-for-byte and implemented durable generator or one-off transformations where rendered guidance needed correction.
  • Rejected cosmetic and speculative churn.

Diff: 47 commits, 2,227 files changed, 16 added, 2,211 modified, 0 deleted, 13,996 insertions, and 4,971 deletions.

Sealed source map

Repository Revision SHA
agno-agi/agno v2.7.4 d1b3a6dc0ed532ac734efb58eb1206bb3bedff09
agno-agi/agent-ui main 6dad9593fca6756e1813e4f4b3b2620be6377691
agno-agi/agentos-aws main 2d4283cadbb898a37d636769539d50cbb36466ed
agno-agi/agentos-azure main 778cfd34d0fd33d93d8dac98148ab7103b53c781
agno-agi/agentos-docker main d767f0ef38e8d4975c23b180cee35dc509529e53
agno-agi/agentos-fly main 8f40303bc3f6e567303c7407ac4ffa241072b394
agno-agi/agentos-gcp main 0c5c4f7f2a5111d954012d774fc9c0e633f6243e
agno-agi/agentos-helm main f029633fe5480489c74fff648fdbf9c8948aac5b
agno-agi/agentos-modal main 9dcc7c66ce6818ee1253345a277c6371632d5547
agno-agi/agentos-railway main ad58e94d9e15476b7d54588fac4df2aaab373f05
agno-agi/agentos-render main a97f5d34dac3c61b63d80139cb47ae96de37a87a
agno-agi/coda main 8a94cf54f3cc135027f8de75188930e0467b4fa1
agno-agi/context main 417be08fa78bbc12df0704a68c2ac51dca4b123a
agno-agi/dash main 6d86fca8e85b17349238389f5fad92d15e8f633f
agno-agi/demo-os main 4bd50f71b9d29cdd24fd86c2c059c8057b9009c4
agno-agi/investment-committee main 5bb30f7d090c4b074e009578ee3dbd9209ad698d
agno-agi/investment-team main 5bb30f7d090c4b074e009578ee3dbd9209ad698d
agno-agi/scout main 088a8ebb3d0e4764e3f30937345ea3753d5990a8

All source checkouts were clean and detached. The docs origin/main ref remained at the recorded base immediately before publication.

Final verification

  • Generator plan: 1,755 KEEP_VERBATIM, 327 PRESERVE_CURATED, 18 REGEN, 0 DELETE, 0 NEW.
  • Full regeneration: 1,773 pages written, 0 failures, 0 warnings; title dedupe and one-offs are stable with 0 pending changes.
  • Integrity: 1,773 generated pages, 1,835 source fences, 2,100 example files, 2,150 pinned release links, and 5 curated-source bindings checked; 0 problems.
  • Inventory: 3,885 MDX pages; 4,373 nav entries; 3,778 unique reachable pages; 0 missing nav files; 107 reviewed orphans.
  • Navigation assets: 118/118 media referenced; 105/105 snippets used; 0 dangling includes.
  • Redirects and links: 2,513 redirects with 0 shadowing, dead destinations, duplicates, or chains; 4,360 internal links with 0 broken links or anchors.
  • Descriptions and style: 0 missing descriptions; all configured tripwires are 0 except 2 source-owned cookbook hype terms.
  • Install coverage: 1,436 pages scanned, 0 offenders, 0 missing requirements, 221 reviewed allowlist entries, 1 non-failing heuristic review.
  • Reference drift: 147 pages, 135 clean, 12 skipped, 0 missing/phantom/wrong-default fields, 0 pages with drift.
  • Imports: 566 unique statements; 409 runtime OK, 157 dependency-only and source-verified, 0 real failures.
  • OpenAPI: generated YAML is byte-identical; 142 operations, 238 schemas, 0 endpoint/operation/schema changes. JSON SHA-256 3587e5b6b510ed2f448fb630ebb1f66c4cc5611e843b953b8dd268b39920db80; YAML SHA-256 478a2b311fa4cd8cedc6d6d3631c5200e35dca0e6885609775622e3e16540332.
  • Template parity: 9/9 deployment templates have six skills and setup-platform; 9/9 setup snippets match the target repositories.
  • CLI/runtime: agnoctl 0.1.3, 9 create templates, documented create/connect/eval flags present; A2A open route 200, protected route without token 401, all documented public routes 200.
  • Targeted executable checks: A2A client 9/9 Python fences; RemoteWorkflow 8/8; Slack channel-scoped session IDs; Cartesia base64 round-trip; Dash Bash 5 post-increment failure reproduced.
  • Service-account source suites: 34/34 and 39/39 passed. The latter emitted one known Starlette deprecation warning.
  • Final independent convergence: seeds 70139 and 84211, 28 stratified pages each, both zero substantive findings at exact head.
  • Mintlify: mint broken-links passed; mint validate passed.
  • Repository seal: git diff --check passed; tracked tree clean; zero deletions.

mint build was not run, per repository instructions.

Deliberate states

  • The 107 non-navigation pages and 53 links to those reviewed pages remain. No shipped page or route was deleted.
  • The install allowlist and the single Slack default-model heuristic review remain deliberate.
  • Twelve reference pages remain skipped by the drift checker. The optional Hugging Face import warning is unchanged.
  • Two style hits remain because they are source-owned cookbook prose.
  • OpenAPI generation retains the released duplicate get_config operation-ID warning.

Audit record and upstream-only observations

The gitignored local evidence ledger contains 257 adjudicated candidates: 235 accepted and 22 rejected. It is 120,193 bytes with SHA-256 61050f671ecb80ce0b2c10becdbb41e153051c82972427257d52c5bb85ce5fa7.

The gitignored upstream-only ledger contains 133 observations. It is 54,645 bytes with SHA-256 6d8871aed7213d892a9d9153e27a990ca9a2dd0176a506168183b1a4ead83f82. These include incomplete source OpenAPI metadata, stale cookbook setup or safety claims, the A2A AgentCard.capabilities annotation/runtime mismatch, Cartesia and Gmail cookbook defects, and the Dash railway_env.sh Bash portability bug. No source or companion repository was modified or pushed.

@mintlify

mintlify Bot commented Jul 19, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
agno 🟢 Ready View Preview Jul 19, 2026, 2:47 PM

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant