mirror of
https://github.com/CopilotKit/CopilotKit.git
synced 2026-09-14 16:26:20 +08:00
Sam Julien
10b87af572
## Summary - Make Slack and Microsoft Teams the production-ready Channels choices in the top provider picker, with framework-aware routes under `/slack/...` and `/teams/...`. - Put ten task-oriented guides inside every provider/framework journey and remove the standalone Channels overview from navigation. - Restore the global Channels SDK reference at `/reference/channels`, including 34 current core, UI, state, transcript, and direct-adapter entries. - Add the complete CopilotKit Intelligence setup walkthrough, product screenshot, and a stable architecture-diagram slot that Mike's final artwork can replace in place. - Qualify Discord and WhatsApp correctly: their direct adapters already ship, while managed Intelligence support is coming soon. ## Why Developers should choose their chat provider and agent framework first, then stay in that context while they build and operate the integration. The previous structure mixed provider guides, an extra overview layer, and stale provider-specific reference pages, making it hard to find the supported path or understand which behavior was managed versus developer-operated. This update keeps the guide journey provider-specific while returning API material to the normal global Reference surface. It also documents operational boundaries that matter in production instead of adding pages for their own sake. ## How - Reuse provider-aware MDX across Slack, Teams, and all 19 public agent-framework integrations; the built-in agent keeps the shorter route without a framework segment. - Organize the sidebar into Getting started, Build, Production, and API reference with guides for Intelligence, tools, rich and interactive messages, commands and reactions, files, state, persistence, transcripts, and operations. - Pin the verified `@copilotkit/channels@0.4.0` and `@copilotkit/runtime@1.64.1` pair and align the copy with current SDK source plus live Intelligence behavior. - Document managed capabilities and provider-specific realities, including active/standby runtimes, optional hosted endpoint defaults, output-free turn finalization, Slack manifest scopes, Teams attachment shapes and consent, delivery acceptance semantics, and durable state requirements. - Preserve useful direct-adapter discoverability for Slack, Teams, Discord, Telegram, and WhatsApp without restoring obsolete symbol pages. - Add one-hop redirects for retired routes and cover navigation, framework selection, raw-doc URLs, search, reference discovery, and sitemap output. Validation: - Full docs suite: 51 files / 348 tests - Typecheck - Lint with no errors (existing baseline warnings only) - Production build: 222 static pages - Live HTTP checks: Slack Intelligence, Teams + Mastra files, Slack rich messages, and direct-adapter reference all return 200 - Independent read-only correctness passes against the current Channels SDK, Runtime, Intelligence, and every public framework setup Linear: https://linear.app/copilotkit/issue/OSS-615/channels-sdk-documentation-audit