catalog

@chat-adapter/catalog

npm package: @chat-adapter/catalog

Static catalog of Chat SDK adapters: every official, vendor-official, and community adapter listed on chat-sdk.dev/adapters, with its npm package, maintainer, and supported capabilities. Official and vendor-official entries also include the factory export, peer dependencies, and environment variables needed to set them up.

The package has no dependencies and imports no adapter code, so you can use it in websites, build scripts, setup screens, and CLIs. chat-sdk.dev and create-chat-sdk both read from it.

Documentation: chat-sdk.dev/docs/adapter-catalog · Guides: vercel.com/kb/chat-sdk

Installation

pnpm add @chat-adapter/catalog

Usage

List adapters and check their capabilities:

import { getFeatureSupport, listAdapters } from "@chat-adapter/catalog";

for (const adapter of listAdapters({ type: "platform" })) {
  const streaming = getFeatureSupport(adapter, "streaming");
  console.log(adapter.name, adapter.group, adapter.packageName, streaming);
}

listAdapters() returns official and vendor-official adapters in the order chat-sdk.dev lists them, followed by community adapters. Pass group (one group or an array) or type to filter.

Read setup requirements for an official or vendor-official adapter:

import { getAdapter, getSecretEnvVars, listEnvVars } from "@chat-adapter/catalog";

const slack = getAdapter("slack");
console.log(slack.packageName, slack.factoryExport, slack.peerDeps);

const allVars = listEnvVars("slack").map((envVar) => envVar.key);
const secrets = getSecretEnvVars("slack").map((envVar) => envVar.key);

API

Export	Description
listAdapters(options?)	Every entry, including community adapters, filtered by group and type
getCatalogEntry(slug)	Any entry by slug, or undefined
getAdapter(slug)	An official or vendor-official entry by slug, or undefined
isAdapterSlug(slug)	Narrows a string to AdapterSlug (official and vendor-official)
listPlatformAdapters() / listStateAdapters()	Official and vendor-official entries sorted by slug
getFeatureSupport(adapterOrSlug, key)	{ status, label? } for one capability; undeclared capabilities return { status: "no" }
getFeatureCategories(type)	Capability keys and labels grouped for display
listEnvVars(slug) / getSecretEnvVars(slug)	Flattened, de-duplicated env vars; empty for community adapters
ADAPTERS / COMMUNITY_ADAPTERS	Entries keyed by slug
ADAPTER_NAMES	Official and vendor-official slugs, sorted
PLATFORM_FEATURE_CATEGORIES / STATE_FEATURE_CATEGORIES	Every capability key with its display label

The chat/adapters subpath of the chat package is a deprecated re-export of the official and vendor-official API in this package.

Adding an adapter

Each adapter is one file in src/adapters/<group>/<slug>.ts, registered in src/adapters/index.ts, with a docs page in apps/docs/content/adapters/<group>/. See Publishing your adapter for community listings and List a vendor-official adapter for vendor-official listings.

AI Coding Agents

If you use an AI coding agent such as OpenAI Codex, Claude Code, or Cursor, install the Chat SDK skill so it knows the SDK APIs, adapter patterns, and project conventions before writing code.

npx skills add vercel/chat

For agent-readable documentation, see chat-sdk.dev/llms.txt (page index) or chat-sdk.dev/llms-full.txt (full text).

License

MIT