docs: restructure agents Deploy section around surface × access mode

[Him188]

Summary

Retargets the Deploy restructure to main (previously landed on the stale agent-docs branch as #117 by mistake — main had already absorbed agent-docs via #116). Two commits:

1. call.analyzed webhook semantics sync — pending doc sync that was stranded on agent-docs: the event fires on every terminal analysis status, dedup key includes finished_at.

2. Deploy section restructure. The old overview presented a four-step "channel ladder" (widget → public → authenticated → phone) conflating two orthogonal axes; clicking 3. Authenticated sessions landed on a page titled Authentication that re-explained both access modes, duplicating the Public agents page.

• Overview rewritten as two independent decisions: where users meet your agent (widget / your own UI via SDKs / phone / custom client) and who may start sessions (public agents vs authenticated sessions, comparison table moved here). States explicitly that every browser surface supports both access modes.
• authentication.mdx → authenticated-sessions.mdx (redirect added in docs.json): now the pure backend session-creation reference — token flow, request fields, response, token lifetime, force-end, errors — plus a client-agnostic table showing where the token goes per surface (Web SDK, React SDK, widget sessionTokenProvider, wire protocol).
• Sidebar reordered to setup order: overview → versions-publishing → public-agents → authenticated-sessions → widget → web-sdk → react-sdk → protocol.
• Mislink fixes: three pages cited the old Authentication page for "API key setup" (never covered there) — now point at api-reference/introduction or the console API-keys page; versions-publishing's "Automate via API" card pointed at the Deploy overview, now at the publish endpoint reference.
• Wording: "mint/minted/minting" → "create" across agent docs.
• CodeGroup cleanup: groups that tabbed different responsibilities (backend vs browser, draft-update vs publish, request vs response, distinct API operations) split into sequential blocks; tabs kept only for alternative implementations of the same action.

Verification

• Both commits cherry-pick cleanly onto main (agents tree on main was identical to the restructure's base; docs.json had no divergence)
• mint broken-links: no broken links under agents/
• Prettier: all touched files pass

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

Summary by CodeRabbit

• Documentation
  • Reorganized authentication guidance around authenticated sessions, backend-issued tokens, access modes, and deployment options.
  • Updated documentation links, navigation, and added a redirect from the former authentication page.
  • Clarified webhook behavior for completed, skipped, and failed post-call analysis, including status handling and idempotency guidance.
  • Simplified API examples by removing unnecessary code-group wrappers.
  • Updated API key and publishing links to point directly to the relevant resources.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
hanabiaiinc	🔴 Failed	–	Aug 6, 2026, 6:38 AM

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

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d93f3b3b-7a0b-41fd-b738-9cb783b527e3

📥 Commits

Reviewing files that changed from the base of the PR and between 9aa2454 and 8ae68de.

📒 Files selected for processing (22)

• agents/build/configuration.mdx
• agents/build/dynamic-variables.mdx
• agents/build/knowledge-base.mdx
• agents/build/time-timezone.mdx
• agents/build/tools.mdx
• agents/concepts.mdx
• agents/deploy/authenticated-sessions.mdx
• agents/deploy/overview.mdx
• agents/deploy/protocol.mdx
• agents/deploy/public-agents.mdx
• agents/deploy/react-sdk.mdx
• agents/deploy/versions-publishing.mdx
• agents/deploy/web-sdk.mdx
• agents/deploy/widget.mdx
• agents/monitor/conversation-history.mdx
• agents/monitor/post-call-analysis.mdx
• agents/monitor/webhooks.mdx
• agents/overview.mdx
• agents/quickstart.mdx
• agents/telephony/phone-numbers.mdx
• api-reference/agent-errors.mdx
• docs.json

---

📝 Walkthrough

Walkthrough

The PR updates authenticated-session guidance, separates deployment surfaces from access modes, revises analysis webhook behavior, updates documentation links, and removes several CodeGroup wrappers.

Changes

Documentation updates

Layer / File(s)	Summary
Authenticated sessions and navigation agents/deploy/authenticated-sessions.mdx, docs.json, agents/deploy/*.mdx, agents/build/*.mdx, api-reference/agent-errors.mdx	The documentation now describes backend-minted session tokens, authenticated sessions, token lifetime, request fields, and session ending. Navigation and related cards use the new page and a server icon.
Deployment surfaces and access modes agents/deploy/overview.mdx	The overview separates deployment surfaces from access modes and adds comparison and selection tables.
Settled analysis webhook behavior agents/monitor/webhooks.mdx, agents/monitor/post-call-analysis.mdx	The docs cover completed, skipped, and failed analysis events. Examples handle analysis.status and deduplicate rerun analyses using analysis.finished_at.
API links and code examples agents/build/*, agents/quickstart.mdx, agents/telephony/phone-numbers.mdx, agents/deploy/versions-publishing.mdx, agents/overview.mdx, agents/concepts.mdx	API destinations and terminology are updated. Several API examples no longer use CodeGroup wrappers.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

• fishaudio/docs#116: This PR revises documentation pages introduced by PR #116, including terminology, links, examples, and webhook behavior.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/deploy-restructure-main

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}