Skip to content

docs: document chat platforms as an AG-UI client surface - #2324

Merged
mme merged 1 commit into
mainfrom
markus/pni-271-chat-platform-clients
Aug 5, 2026
Merged

docs: document chat platforms as an AG-UI client surface#2324
mme merged 1 commit into
mainfrom
markus/pni-271-chat-platform-clients

Conversation

@mme

@mme mme commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Closes PNI-271

Read the Clients listings today and you would conclude AG-UI targets web applications: they cover CopilotKit, a terminal client, and React Native. Nothing indicated that an AG-UI agent can serve a conversation in Slack or Microsoft Teams, even though it can. This is docs-only — no protocol, specification, or event-set changes.

Changes

  • docs/introduction.mdx — new row in the Clients table, same format as the existing entries. Two paragraphs under the table: a client need not be a web app, because the protocol describes an event stream rather than a rendering target; a chat-platform client is something anyone can build against AG-UI; the Channels SDK is one implementation; OpenTag is the worked example.
  • docs/quickstart/clients.mdx (Get Started) — two sentences making the same point where someone building a client will read it.
  • docs/integrations.mdx — one line in the Clients list, existing pipe format.
  • README.md — row added to the Clients table.

Register

No superlatives, no "any channel", no product voice, and no hosted-service call to action — the links go to the MIT-licensed repositories, not to a signup or trial page. Where a hosted component is involved the text names it as such: in OpenTag the agent and its runtime are self-hosted, while platform credentials and message delivery are handled by CopilotKit Intelligence, which is called out as a hosted service and not part of the protocol.

Notes for the reviewer

  • The ticket said the README has no client category. It already does (README.md:165), so the row went into the existing table rather than a new section.
  • Facts were checked against the two repositories rather than the ticket text. channels-sdk's repo description also mentions Discord and Telegram; the docs text stays with Slack and Microsoft Teams, which is what the SDK's documented path and OpenTag support today.
  • prettier --check flags all four files, but it flags them identically on main. Pre-existing drift, left alone so the change is not buried in a reformat.
  • Both linked repositories return 200 unauthenticated and are MIT.

Outstanding acceptance criterion: review for register by someone who does not work on Channels.

🤖 Generated with Claude Code

The Clients listings covered web, terminal, and React Native, which left
the impression that AG-UI targets web applications. Add chat platforms
(Slack, Microsoft Teams) alongside the existing entries, and state that a
client need not be a web app because the protocol describes an event
stream rather than a rendering target.

The added text separates the layers: a chat-platform client is something
anyone can build against AG-UI, the Channels SDK is one implementation,
OpenTag is a readable application built on it, and CopilotKit
Intelligence is named as a hosted service outside the protocol.

No protocol, specification, or event-set changes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mme
mme requested a review from a team as a code owner August 5, 2026 14:29
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Python Preview Packages

Version 0.0.0.dev1785940198 published to TestPyPI.

Warning: These packages are built from contributor code that may not yet have been vetted for correctness or security. Install at your own risk and do not use in production.

Install with uv

Add the TestPyPI index to your pyproject.toml:

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
explicit = true

Then install the packages you need:

# Core SDK
uv add 'ag-ui-protocol==0.0.0.dev1785940198' --index testpypi

# Integrations (each already depends on the matching ag-ui-protocol preview)
uv add 'ag-ui-langgraph==0.0.0.dev1785940198' --index testpypi
uv add 'ag-ui-crewai==0.0.0.dev1785940198' --index testpypi
# NOTE: ag-ui-agent-spec depends on pyagentspec (git-only, not on PyPI).
# You will need to install pyagentspec separately from its git repo.
uv add 'ag-ui-agent-spec==0.0.0.dev1785940198' --index testpypi
uv add 'ag_ui_adk==0.0.0.dev1785940198' --index testpypi
uv add 'ag_ui_strands==0.0.0.dev1785940198' --index testpypi

Install with pip

pip install \
  --index-url https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple/ \
  ag-ui-protocol==0.0.0.dev1785940198

Use --extra-index-url https://pypi.org/simple/ so pip can resolve
transitive dependencies (pydantic, fastapi, etc.) from real PyPI.


Commit: 401e385

@pkg-pr-new

pkg-pr-new Bot commented Aug 5, 2026

Copy link
Copy Markdown

Open in StackBlitz

@ag-ui/a2a-middleware

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/a2a-middleware@2324

@ag-ui/a2ui-middleware

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/a2ui-middleware@2324

@ag-ui/event-throttle-middleware

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/event-throttle-middleware@2324

@ag-ui/mcp-apps-middleware

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/mcp-apps-middleware@2324

@ag-ui/mcp-middleware

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/mcp-middleware@2324

@ag-ui/a2a

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/a2a@2324

@ag-ui/adk

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/adk@2324

@ag-ui/ag2

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/ag2@2324

@ag-ui/agno

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/agno@2324

@ag-ui/aws-strands

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/aws-strands@2324

@ag-ui/claude-agent-sdk

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/claude-agent-sdk@2324

@ag-ui/claude-managed-agents

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/claude-managed-agents@2324

@ag-ui/crewai

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/crewai@2324

@ag-ui/langchain

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/langchain@2324

@ag-ui/langgraph

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/langgraph@2324

@ag-ui/llamaindex

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/llamaindex@2324

@ag-ui/mastra

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/mastra@2324

@ag-ui/pydantic-ai

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/pydantic-ai@2324

@ag-ui/vercel-ai-sdk

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/vercel-ai-sdk@2324

@ag-ui/watsonx

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/watsonx@2324

@ag-ui/a2ui-toolkit

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/a2ui-toolkit@2324

create-ag-ui-app

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/create-ag-ui-app@2324

@ag-ui/client

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/client@2324

@ag-ui/core

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/core@2324

@ag-ui/encoder

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/encoder@2324

@ag-ui/proto

pnpm add https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/proto@2324

commit: 9f040ea

@mme
mme enabled auto-merge August 5, 2026 14:38
@mme
mme merged commit de790dd into main Aug 5, 2026
12 checks passed
@mme
mme deleted the markus/pni-271-chat-platform-clients branch August 5, 2026 15:01
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.

2 participants