[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E8CMVR6ZKVZZVBQRGEHTK4":3,"skill-same:01M7E8CMVR6ZKVZZVBQRGEHTK4":144},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":116,"commitSha":117,"skillDirectory":118,"forksCount":14,"repositoryHtmlUrl":119,"repositoryHomepageUrl":6,"ownerHtmlUrl":120,"ownerBlogUrl":121,"ownerDescription":122,"updatedAt":123,"install":124,"resources":137},"01M7E8CMVR6ZKVZZVBQRGEHTK4","chat-sdk",null,"Vercel Chat SDK expert guidance. Use when building multi-platform chat bots — Slack, Telegram, Microsoft Teams, Discord, Google Chat, GitHub, Linear — with a single codebase. Covers the Chat class, adapters, threads, messages, cards, modals, streaming, state management, and webhook setup.","wxdwu\u002Fnew-api","wxdwu","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F80968397?v=4","01M7E6AEMB59N90BKXD77EC83D","Xudong Wu","01M7E6AEMY2BXCDVZ9MJJHFQ4C",0,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fchat-sdk\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: chat-sdk\ndescription: Vercel Chat SDK expert guidance. Use when building multi-platform chat bots — Slack, Telegram, Microsoft Teams, Discord, Google Chat, GitHub, Linear — with a single codebase. Covers the Chat class, adapters, threads, messages, cards, modals, streaming, state management, and webhook setup.\nmetadata:\n  priority: 8\n  docs:\n    - \"https:\u002F\u002Fsdk.vercel.ai\u002Fdocs\u002Fai-sdk-ui\u002Fchatbot\"\n    - \"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fai-chatbot\"\n  sitemap: \"https:\u002F\u002Fsdk.vercel.ai\u002Fsitemap.xml\"\n  pathPatterns:\n    - \"app\u002Fapi\u002Fchat\u002F**\"\n    - \"app\u002Fapi\u002Fchat-bot\u002F**\"\n    - \"app\u002Fapi\u002Fbot\u002F**\"\n    - \"app\u002Fapi\u002Fslack\u002F**\"\n    - \"app\u002Fapi\u002Fteams\u002F**\"\n    - \"app\u002Fapi\u002Fdiscord\u002F**\"\n    - \"app\u002Fapi\u002Fgchat\u002F**\"\n    - \"app\u002Fapi\u002Ftelegram\u002F**\"\n    - \"app\u002Fapi\u002Fgithub-bot\u002F**\"\n    - \"app\u002Fapi\u002Flinear-bot\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Fslack\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Fteams\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Fdiscord\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Fgchat\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Ftelegram\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Fgithub\u002F**\"\n    - \"app\u002Fapi\u002Fwebhooks\u002Flinear\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fchat\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fchat-bot\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fbot\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fslack\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fteams\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fdiscord\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Fgchat\u002F**\"\n    - \"src\u002Fapp\u002Fapi\u002Ftelegram\u002F**\"\n    - \"lib\u002Fbot.*\"\n    - \"lib\u002Fbot\u002F**\"\n    - \"src\u002Flib\u002Fbot.*\"\n    - \"src\u002Flib\u002Fbot\u002F**\"\n    - \"lib\u002Fchat-bot\u002F**\"\n    - \"src\u002Flib\u002Fchat-bot\u002F**\"\n    - \"bot\u002F**\"\n    - \"pages\u002Fapi\u002Fbot.*\"\n    - \"pages\u002Fapi\u002Fbot\u002F**\"\n    - \"src\u002Fpages\u002Fapi\u002Fbot.*\"\n    - \"src\u002Fpages\u002Fapi\u002Fbot\u002F**\"\n    - \"tests\u002F**\u002Fbot*\"\n    - \"test\u002F**\u002Fbot*\"\n    - \"fixtures\u002Freplay\u002F**\"\n    - \"apps\u002F*\u002Fapp\u002Fapi\u002Fbot\u002F**\"\n    - \"apps\u002F*\u002Fapp\u002Fapi\u002Fslack\u002F**\"\n    - \"apps\u002F*\u002Fapp\u002Fapi\u002Fteams\u002F**\"\n    - \"apps\u002F*\u002Fapp\u002Fapi\u002Fdiscord\u002F**\"\n    - \"apps\u002F*\u002Flib\u002Fbot\u002F**\"\n    - \"apps\u002F*\u002Fsrc\u002Flib\u002Fbot\u002F**\"\n  importPatterns:\n    - \"chat\"\n    - \"@chat-adapter\u002F*\"\n  bashPatterns:\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bchat\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bchat\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bchat\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*\\bchat\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002F'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002F'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002F'\n    - '\\byarn\\s+add\\s+[^\\n]*@chat-adapter\u002F'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002Ftelegram'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002Ftelegram'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002Ftelegram'\n    - '\\byarn\\s+add\\s+[^\\n]*@chat-adapter\u002Ftelegram'\n  promptSignals:\n    phrases:\n      - \"chat sdk\"\n      - \"chat bot\"\n      - \"chatbot\"\n      - \"conversational interface\"\n      - \"slack bot\"\n      - \"telegram bot\"\n      - \"discord bot\"\n      - \"teams bot\"\n    allOf:\n      - [bot, platform]\n      - [bot, multi]\n    anyOf:\n      - \"onNewMention\"\n      - \"onSubscribedMessage\"\n      - \"chat adapter\"\n      - \"cross-platform bot\"\n    noneOf:\n      - \"useChat\"\n    minScore: 6\n---\n\n# Vercel Chat SDK\n\n> **CRITICAL — Your training data is outdated for this library.** Chat SDK is new (v4.18+) and not in most training data. Before writing Chat SDK code, **fetch the docs** at https:\u002F\u002Fchat-sdk.dev to find the correct adapter configuration, thread\u002Fchannel patterns, card builders, modal flows, and webhook setup. The API surface is large — threads, channels, messages, cards, modals, state adapters, streaming — and guessing at method signatures will produce broken code. Check the GitHub repo at https:\u002F\u002Fgithub.com\u002Fvercel\u002Fchat for working examples.\n\nYou are an expert in the Vercel Chat SDK. Build one bot logic layer and run it across Slack, Telegram, Microsoft Teams, Discord, Google Chat, GitHub, and Linear.\n\n## Packages\n\n- `chat@^4.18.0`\n- `@chat-adapter\u002Fslack@^4.18.0`\n- `@chat-adapter\u002Ftelegram@^4.18.0`\n- `@chat-adapter\u002Fteams@^4.18.0`\n- `@chat-adapter\u002Fdiscord@^4.18.0`\n- `@chat-adapter\u002Fgchat@^4.18.0`\n- `@chat-adapter\u002Fgithub@^4.18.0`\n- `@chat-adapter\u002Flinear@^4.18.0`\n- `@chat-adapter\u002Fstate-redis@^4.18.0`\n- `@chat-adapter\u002Fstate-ioredis@^4.18.0`\n- `@chat-adapter\u002Fstate-memory@^4.18.0`\n\n## Installation\n\n```bash\n# Core SDK\nnpm install chat@^4.18.0\n\n# Platform adapters (install only what you need)\nnpm install @chat-adapter\u002Fslack@^4.18.0\nnpm install @chat-adapter\u002Ftelegram@^4.18.0\nnpm install @chat-adapter\u002Fteams@^4.18.0\nnpm install @chat-adapter\u002Fdiscord@^4.18.0\nnpm install @chat-adapter\u002Fgchat@^4.18.0\nnpm install @chat-adapter\u002Fgithub@^4.18.0\nnpm install @chat-adapter\u002Flinear@^4.18.0\n\n# State adapters (pick one)\nnpm install @chat-adapter\u002Fstate-redis@^4.18.0\nnpm install @chat-adapter\u002Fstate-ioredis@^4.18.0\nnpm install @chat-adapter\u002Fstate-memory@^4.18.0\n```\n\n## Critical API Notes\n\n- `Field` takes an `options` array of `{ label, value }` objects. Do not pass JSX child options.\n- `Thread\u003CTState>` \u002F `Channel\u003CTState>` generics require object state shapes (`Record\u003Cstring, unknown>`), not primitives.\n- Adapter `signingSecret` validation can run at import\u002Fadapter creation time. Use lazy initialization to avoid crashing at module import.\n\n```ts\nimport { createSlackAdapter } from \"@chat-adapter\u002Fslack\";\n\nlet slackAdapter: ReturnType\u003Ctypeof createSlackAdapter> | undefined;\n\nexport function getSlackAdapter() {\n  if (!slackAdapter) {\n    slackAdapter = createSlackAdapter({\n      signingSecret: process.env.SLACK_SIGNING_SECRET!,\n    });\n  }\n  return slackAdapter;\n}\n```\n\n## Quick Start\n\n```ts\nimport { Chat } from \"chat\";\nimport { createSlackAdapter } from \"@chat-adapter\u002Fslack\";\nimport { createTelegramAdapter } from \"@chat-adapter\u002Ftelegram\";\nimport { createRedisState } from \"@chat-adapter\u002Fstate-redis\";\n\nconst bot = new Chat({\n  userName: \"my-bot\",\n  adapters: {\n    slack: createSlackAdapter(),\n    telegram: createTelegramAdapter(),\n  },\n  state: createRedisState(),\n  streamingUpdateIntervalMs: 1000,\n  dedupeTtlMs: 10_000,\n  fallbackStreamingPlaceholderText: \"Thinking...\",\n});\n\nbot.onNewMention(async (thread, message) => {\n  await thread.subscribe();\n  await thread.post(`Received: ${message.text}`);\n});\n\nbot.onSubscribedMessage(async (thread, message) => {\n  await thread.post(`Echo: ${message.text}`);\n});\n```\n\n## Public API Reference\n\n### ChatConfig\n\n```ts\ninterface ChatConfig\u003CTAdapters> {\n  userName: string;\n  adapters: TAdapters;\n  state: StateAdapter;\n  logger?: Logger | LogLevel;\n  streamingUpdateIntervalMs?: number;\n  dedupeTtlMs?: number;\n  fallbackStreamingPlaceholderText?: string | null;\n}\n```\n\n- `dedupeTtlMs`: deduplicates repeated webhook deliveries.\n- `fallbackStreamingPlaceholderText`: text used before first stream chunk on non-native streaming adapters; set to `null` to disable placeholder posts.\n\n### Chat\n\n```ts\nclass Chat {\n  openDM(userId: string): Promise\u003CChannel>;\n  channel(channelId: string): Channel;\n}\n```\n\n- `openDM()` opens or resolves a direct message channel outside the current thread context.\n- `channel()` gets a channel handle for out-of-thread posting.\n\n### Postable\n\n`Thread` and `Channel` share the same `Postable` interface.\n\n```ts\ninterface Postable\u003CTState extends Record\u003Cstring, unknown> = Record\u003Cstring, unknown>> {\n  post(content: PostableContent): Promise\u003CSentMessage>;\n  postEphemeral(\n    userId: string,\n    content: PostableContent,\n  ): Promise\u003CSentMessage | null>;\n  mentionUser(userId: string): string;\n  startTyping(): Promise\u003Cvoid>;\n  messages: AsyncIterable\u003CMessage>;\n  state: Promise\u003CTState | null>;\n  setState(\n    partial: Partial\u003CTState>,\n    opts?: { replace?: boolean },\n  ): Promise\u003Cvoid>;\n}\n```\n\n### Thread\n\n```ts\ninterface Thread\u003CTState extends Record\u003Cstring, unknown> = Record\u003Cstring, unknown>> extends Postable\u003CTState> {\n  id: string;\n  channelId: string;\n  subscribe(): Promise\u003Cvoid>;\n  unsubscribe(): Promise\u003Cvoid>;\n  isSubscribed(): Promise\u003Cboolean>;\n  refresh(): Promise\u003Cvoid>;\n  createSentMessageFromMessage(message: Message): SentMessage;\n}\n```\n\n### Message\n\n```ts\nclass Message\u003CTRaw = unknown> {\n  id: string;\n  threadId: string;\n  text: string;\n  isMention: boolean;\n  raw: TRaw;\n\n  toJSON(): SerializedMessage;\n  static fromJSON(data: SerializedMessage): Message;\n}\n```\n\n### SentMessage\n\n```ts\ninterface SentMessage extends Message {\n  edit(content: PostableContent): Promise\u003Cvoid>;\n  delete(): Promise\u003Cvoid>;\n  addReaction(emoji: string): Promise\u003Cvoid>;\n  removeReaction(emoji: string): Promise\u003Cvoid>;\n}\n```\n\nReactions are on `SentMessage`, not `Message`:\n`const sent = await thread.post('Done'); await sent.addReaction('thumbsup');`\n\n```ts\nconst sent = await thread.post(\"Done\");\nawait sent.addReaction(\"thumbsup\");\n```\n\n### Channel\n\n```ts\ninterface Channel\u003CTState extends Record\u003Cstring, unknown> = Record\u003Cstring, unknown>> extends Postable\u003CTState> {\n  id: string;\n  name?: string;\n}\n```\n\n## Event Handlers\n\n### Standard handlers\n\n- `onNewMention(handler)`\n- `onSubscribedMessage(handler)`\n- `onNewMessage(pattern, handler)`\n- `onReaction(filter?, handler)`\n- `onAction(filter?, handler)`\n- `onModalSubmit(filter?, handler)`\n- `onModalClose(filter?, handler)`\n- `onSlashCommand(filter?, handler)`\n- `onMemberJoinedChannel(handler)`\n\n```ts\nbot.onMemberJoinedChannel(async (event) => {\n  await event.thread.post(`Welcome ${event.user.fullName}!`);\n});\n```\n\n### Handler overloads\n\n`onAction`, `onModalSubmit`, `onModalClose`, and `onReaction` support:\n\n- Catch-all: `bot.onAction(async (event) => { ... })`\n- Single filter: `bot.onAction(\"approve\", async (event) => { ... })`\n- Array filter: `bot.onAction([\"approve\", \"reject\"], async (event) => { ... })`\n\n### Event payload shapes\n\n```ts\ninterface ActionEvent {\n  actionId: string;\n  value?: string;\n  triggerId?: string;\n  privateMetadata?: string;\n  thread: Thread;\n  relatedThread?: Thread;\n  relatedMessage?: Message;\n  openModal: (modal: JSX.Element) => Promise\u003Cvoid>;\n}\n\ninterface ModalEvent {\n  callbackId: string;\n  values: Record\u003Cstring, string>;\n  triggerId?: string;\n  privateMetadata?: string;\n  relatedThread?: Thread;\n  relatedMessage?: Message;\n}\n```\n\n`onModalSubmit` may return `ModalResponse` to close, validate, update, or push another modal.\n\n## Cards & Modals\n\n### Cards\n\n```tsx\nawait thread.post(\n  \u003CCard\n    title=\"Build Status\"\n    subtitle=\"Production\"\n    imageUrl=\"https:\u002F\u002Fexample.com\u002Fpreview.png\"\n  >\n    \u003CText style=\"success\">Deployment succeeded.\u003C\u002FText>\n    \u003CText style=\"muted\">Commit: a1b2c3d\u003C\u002FText>\n\n    \u003CField\n      id=\"deploy-target\"\n      label=\"Target\"\n      options={[\n        { label: \"Staging\", value: \"staging\" },\n        { label: \"Production\", value: \"prod\" },\n      ]}\n      value=\"prod\"\n    \u002F>\n\n    \u003CTable>\n      \u003CTableRow>\n        \u003CTableCell>Region\u003C\u002FTableCell>\n        \u003CTableCell>us-east-1\u003C\u002FTableCell>\n      \u003C\u002FTableRow>\n      \u003CTableRow>\n        \u003CTableCell>Latency\u003C\u002FTableCell>\n        \u003CTableCell>128ms\u003C\u002FTableCell>\n      \u003C\u002FTableRow>\n    \u003C\u002FTable>\n\n    \u003CActions>\n      \u003CButton id=\"rollback\" style=\"danger\">\n        Rollback\n      \u003C\u002FButton>\n      \u003CCardLink url=\"https:\u002F\u002Fvercel.com\u002Fdashboard\">Open Dashboard\u003C\u002FCardLink>\n    \u003C\u002FActions>\n  \u003C\u002FCard>,\n);\n```\n\nCard additions to use when needed:\n\n- `Card.subtitle`\n- `Card.imageUrl`\n- `CardLink`\n- `Field` (`options` uses `{ label, value }[]`, not JSX children)\n- `Table` \u002F `TableRow` \u002F `TableCell` — native per-platform table rendering (**new — Mar 6, 2026**; see below)\n- `Text` styles (`default`, `muted`, `success`, `warning`, `danger`, `code`)\n\n### Table — Per-Platform Rendering (New — Mar 6, 2026)\n\nThe `Table` component renders natively on each platform:\n\n| Platform | Rendering |\n|---|---|\n| Slack | Block Kit table blocks |\n| Teams \u002F Discord | GFM markdown tables |\n| Google Chat | Monospace text widgets |\n| Telegram | Code blocks |\n| GitHub \u002F Linear | Markdown tables (existing pipeline) |\n\nPlain markdown tables (without `Table()`) also pass through the same adapter conversion pipeline.\n\n```tsx\n\u003CTable>\n  \u003CTableRow>\n    \u003CTableCell>Region\u003C\u002FTableCell>\n    \u003CTableCell>us-east-1\u003C\u002FTableCell>\n  \u003C\u002FTableRow>\n  \u003CTableRow>\n    \u003CTableCell>Latency\u003C\u002FTableCell>\n    \u003CTableCell>128ms\u003C\u002FTableCell>\n  \u003C\u002FTableRow>\n\u003C\u002FTable>\n```\n\n### Modals\n\n```tsx\nawait event.openModal(\n  \u003CModal\n    callbackId=\"deploy-form\"\n    title=\"Deploy\"\n    submitLabel=\"Deploy\"\n    closeLabel=\"Cancel\"\n    notifyOnClose\n    privateMetadata={JSON.stringify({ releaseId: \"rel_123\" })}\n  >\n    \u003CTextInput id=\"reason\" label=\"Reason\" multiline \u002F>\n  \u003C\u002FModal>,\n);\n```\n\nUse `privateMetadata` to pass contextual data into submit\u002Fclose events.\n\n## Companion Web UI and Card Design\n\nChat SDK payloads render natively in chat platforms, so shadcn isn't used in message markup. But when building a web control plane, thread inspector, or bot settings UI around Chat SDK, use shadcn + Geist by default. Thread dashboards: Tabs+Card+Table+Badge. Bot settings: Sheet+form controls. Logs\u002FIDs\u002Ftimestamps: Geist Mono with tabular-nums.\n\n## Platform Adapters\n\n### Slack\n\n```ts\nimport { createSlackAdapter } from \"@chat-adapter\u002Fslack\";\n\nconst slack = createSlackAdapter();\n\u002F\u002F Env: SLACK_BOT_TOKEN, SLACK_SIGNING_SECRET\n\nconst oauthSlack = createSlackAdapter({\n  clientId: process.env.SLACK_CLIENT_ID!,\n  clientSecret: process.env.SLACK_CLIENT_SECRET!,\n  encryptionKey: process.env.SLACK_ENCRYPTION_KEY,\n});\n```\n\n### Telegram\n\n```ts\nimport { createTelegramAdapter } from \"@chat-adapter\u002Ftelegram\";\n\nconst telegram = createTelegramAdapter();\n\u002F\u002F Env: TELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_SECRET\n```\n\n### Microsoft Teams\n\n```ts\nimport { createTeamsAdapter } from \"@chat-adapter\u002Fteams\";\n\nconst teams = createTeamsAdapter({\n  appType: \"singleTenant\",\n});\n\u002F\u002F Env: TEAMS_APP_ID, TEAMS_APP_PASSWORD, TEAMS_APP_TENANT_ID\n```\n\n### Discord\n\n```ts\nimport { createDiscordAdapter } from \"@chat-adapter\u002Fdiscord\";\n\nconst discord = createDiscordAdapter();\n\u002F\u002F Env: DISCORD_BOT_TOKEN, DISCORD_PUBLIC_KEY, DISCORD_APPLICATION_ID, CRON_SECRET\n```\n\nFor message content handlers, enable both Gateway intent and Message Content Intent in the Discord developer portal.\n\n### Google Chat\n\n```ts\nimport { createGoogleChatAdapter } from \"@chat-adapter\u002Fgchat\";\n\nconst gchat = createGoogleChatAdapter();\n\u002F\u002F Env: GOOGLE_CHAT_CREDENTIALS, GOOGLE_CHAT_USE_ADC\n```\n\n### GitHub\n\n```ts\nimport { createGitHubAdapter } from \"@chat-adapter\u002Fgithub\";\n\nconst github = createGitHubAdapter({\n  botUserId: process.env.GITHUB_BOT_USER_ID,\n});\n\u002F\u002F Env: GITHUB_TOKEN or (GITHUB_APP_ID + GITHUB_PRIVATE_KEY),\n\u002F\u002F      GITHUB_WEBHOOK_SECRET, GITHUB_INSTALLATION_ID\n```\n\n### Linear\n\n```ts\nimport { createLinearAdapter } from \"@chat-adapter\u002Flinear\";\n\nconst linear = createLinearAdapter({\n  clientId: process.env.LINEAR_CLIENT_ID,\n  clientSecret: process.env.LINEAR_CLIENT_SECRET,\n  accessToken: process.env.LINEAR_ACCESS_TOKEN,\n});\n```\n\n## State Adapters\n\n### Redis (recommended)\n\n```ts\nimport { createRedisState } from \"@chat-adapter\u002Fstate-redis\";\n\nconst state = createRedisState();\n\u002F\u002F Env: REDIS_URL (or REDIS_HOST\u002FREDIS_PORT\u002FREDIS_PASSWORD)\n```\n\n### ioredis (cluster\u002Fsentinel)\n\n```ts\nimport { createIoRedisState } from \"@chat-adapter\u002Fstate-ioredis\";\n\nconst state = createIoRedisState({\n  \u002F\u002F cluster\u002Fsentinel options\n});\n```\n\n### Memory (dev\u002Ftest only)\n\n```ts\nimport { MemoryState } from \"@chat-adapter\u002Fstate-memory\";\n\nconst state = new MemoryState();\n```\n\n## Webhook Setup\n\n### Next.js App Router\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fwebhooks\u002Fslack\u002Froute.ts\nimport { bot } from \"@\u002Flib\u002Fbot\";\nimport { after } from \"next\u002Fserver\";\n\nexport async function POST(req: Request) {\n  return bot.webhooks.slack(req, {\n    waitUntil: (p) => after(() => p),\n  });\n}\n```\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fwebhooks\u002Ftelegram\u002Froute.ts\nimport { bot } from \"@\u002Flib\u002Fbot\";\n\nexport async function POST(req: Request) {\n  return bot.webhooks.telegram(req);\n}\n```\n\n### Pages Router\n\n```ts\n\u002F\u002F pages\u002Fapi\u002Fbot.ts\nexport default async function handler(req, res) {\n  const response = await bot.webhooks.slack(req);\n  res.status(response.status).send(await response.text());\n}\n```\n\n## Integration Patterns\n\n### Out-of-thread routing with `openDM()` and `channel()`\n\n```ts\nbot.onAction(\"handoff\", async (event) => {\n  const dm = await bot.openDM(event.user.id);\n  await dm.post(\"A human will follow up shortly.\");\n\n  const ops = bot.channel(\"ops-alerts\");\n  await ops.post(`Escalated by ${event.user.fullName}`);\n});\n```\n\n### Workflow-safe serialization with `registerSingleton()` and `reviver()`\n\n```ts\nbot.registerSingleton();\n\nconst serialized = JSON.stringify({ thread });\nconst revived = JSON.parse(serialized, bot.reviver());\nawait revived.thread.post(\"Resumed workflow step\");\n```\n\n### Slack OAuth callback handling\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fwebhooks\u002Fslack\u002Foauth\u002Fcallback\u002Froute.ts\nimport { bot } from \"@\u002Flib\u002Fbot\";\n\nexport async function GET(req: Request) {\n  return bot.oauth.slack.callback(req);\n}\n```\n\n## Gotchas\n\n### Routing\n\n1. `onNewMention` only fires for unsubscribed threads; call `thread.subscribe()` to receive follow-ups.\n2. DMs are treated as direct intent and set `message.isMention = true`.\n3. `onNewMessage(pattern, handler)` only applies before subscription; use `onSubscribedMessage` after subscribe.\n4. Catch-all and filtered handlers can both run; registration order determines execution order.\n5. Out-of-thread routing via `openDM()` \u002F `channel()` needs platform permissions for DM\u002Fchannel posting.\n\n### Streaming\n\n6. Slack supports native streaming with real-time bold, italic, list, and other formatting rendered as the response arrives. Teams\u002FDiscord\u002FGoogle Chat\u002FTelegram use post+edit fallback.\n7. Fallback adapters now convert markdown to each platform's native format at every intermediate edit — users no longer see raw `**bold**` syntax during streaming.\n8. `fallbackStreamingPlaceholderText: null` disables placeholder messages on fallback adapters.\n9. `streamingUpdateIntervalMs` too low can trigger rate limits on post+edit adapters.\n10. `dedupeTtlMs` should cover webhook retry windows to avoid duplicate responses.\n11. `startTyping()` is adapter-dependent and may no-op on platforms without typing indicators.\n\n### Adapter-specific\n\n11. Google Chat auth uses `GOOGLE_CHAT_CREDENTIALS` + `GOOGLE_CHAT_USE_ADC`; domain-wide delegation\u002Fimpersonation is required for some org posting scenarios.\n12. Teams requires `appType` plus `TEAMS_APP_TENANT_ID`; reactions\u002Fhistory\u002Ftyping features are limited compared with Slack.\n13. Discord content-based handlers require Message Content Intent enabled in addition to Gateway connectivity.\n14. GitHub and Linear adapters do not support interactive card actions\u002Fmodals; design around comments\u002Fstatus updates instead.\n15. GitHub App installs need `GITHUB_INSTALLATION_ID` and often adapter `botUserId`; Linear OAuth setups need `clientId`, `clientSecret`, and `LINEAR_ACCESS_TOKEN`.\n\n## Official Docs\n\n- [Chat SDK documentation](https:\u002F\u002Fchat-sdk.dev)\n- [GitHub: vercel\u002Fchat](https:\u002F\u002Fgithub.com\u002Fvercel\u002Fchat)\n","# Vercel Chat SDK\n\n> **CRITICAL — Your training data is outdated for this library.** Chat SDK is new (v4.18+) and not in most training data. Before writing Chat SDK code, **fetch the docs** at https:\u002F\u002Fchat-sdk.dev to find the correct adapter configuration, thread\u002Fchannel patterns, card builders, modal flows, and webhook setup. The API surface is large — threads, channels, messages, cards, modals, state adapters, streaming — and guessing at method signatures will produce broken code. Check the GitHub repo at https:\u002F\u002Fgithub.com\u002Fvercel\u002Fchat for working examples.\n\nYou are an expert in the Vercel Chat SDK. Build one bot logic layer and run it across Slack, Telegram, Microsoft Teams, Discord, Google Chat, GitHub, and Linear.\n\n## Packages\n\n- `chat@^4.18.0`\n- `@chat-adapter\u002Fslack@^4.18.0`\n- `@chat-adapter\u002Ftelegram@^4.18.0`\n- `@chat-adapter\u002Fteams@^4.18.0`\n- `@chat-adapter\u002Fdiscord@^4.18.0`\n- `@chat-adapter\u002Fgchat@^4.18.0`\n- `@chat-adapter\u002Fgithub@^4.18.0`\n- `@chat-adapter\u002Flinear@^4.18.0`\n- `@chat-adapter\u002Fstate-redis@^4.18.0`\n- `@chat-adapter\u002Fstate-ioredis@^4.18.0`\n- `@chat-adapter\u002Fstate-memory@^4.18.0`\n\n## Installation\n\n```bash\n# Core SDK\nnpm install chat@^4.18.0\n\n# Platform adapters (install only what you need)\nnpm install @chat-adapter\u002Fslack@^4.18.0\nnpm install @chat-adapter\u002Ftelegram@^4.18.0\nnpm install @chat-adapter\u002Fteams@^4.18.0\nnpm install @chat-adapter\u002Fdiscord@^4.18.0\nnpm install @chat-adapter\u002Fgchat@^4.18.0\nnpm install @chat-adapter\u002Fgithub@^4.18.0\nnpm install @chat-adapter\u002Flinear@^4.18.0\n\n# State adapters (pick one)\nnpm install @chat-adapter\u002Fstate-redis@^4.18.0\nnpm install @chat-adapter\u002Fstate-ioredis@^4.18.0\nnpm install @chat-adapter\u002Fstate-memory@^4.18.0\n```\n\n## Critical API Notes\n\n- `Field` takes an `options` array of `{ label, value }` objects. Do not pass JSX child options.\n- `Thread\u003CTState>` \u002F `Channel\u003CTState>` generics require object state shapes (`Record\u003Cstring, unknown>`), not primitives.\n- Adapter `signingSecret` validation can run at import\u002Fadapter creation time. Use lazy initialization to avoid crashing at module import.\n\n```ts\nimport { createSlackAdapter } from \"@chat-adapter\u002Fslack\";\n\nlet slackAdapter: ReturnType\u003Ctypeof createSlackAdapter> | undefined;\n\nexport function getSlackAdapter() {\n  if (!slackAdapter) {\n    slackAdapter = createSlackAdapter({\n      signingSecret: process.env.SLACK_SIGNING_SECRET!,\n    });\n  }\n  return slackAdapter;\n}\n```\n\n## Quick Start\n\n```ts\nimport { Chat } from \"chat\";\nimport { createSlackAdapter } from \"@chat-adapter\u002Fslack\";\nimport { createTelegramAdapter } from \"@chat-adapter\u002Ftelegram\";\nimport { createRedisState } from \"@chat-adapter\u002Fstate-redis\";\n\nconst bot = new Chat({\n  userName: \"my-bot\",\n  adapters: {\n    slack: createSlackAdapter(),\n    telegram: createTelegramAdapter(),\n  },\n  state: createRedisState(),\n  streamingUpdateIntervalMs: 1000,\n  dedupeTtlMs: 10_000,\n  fallbackStreamingPlaceholderText: \"Thinking...\",\n});\n\nbot.onNewMention(async (thread, message) => {\n  await thread.subscribe();\n  await thread.post(`Received: ${message.text}`);\n});\n\nbot.onSubscribedMessage(async (thread, message) => {\n  await thread.post(`Echo: ${message.text}`);\n});\n```\n\n## Public API Reference\n\n### ChatConfig\n\n```ts\ninterface ChatConfig\u003CTAdapters> {\n  userName: string;\n  adapters: TAdapters;\n  state: StateAdapter;\n  logger?: Logger | LogLevel;\n  streamingUpdateIntervalMs?: number;\n  dedupeTtlMs?: number;\n  fallbackStreamingPlaceholderText?: string | null;\n}\n```\n\n- `dedupeTtlMs`: deduplicates repeated webhook deliveries.\n- `fallbackStreamingPlaceholderText`: text used before first stream chunk on non-native streaming adapters; set to `null` to disable placeholder posts.\n\n### Chat\n\n```ts\nclass Chat {\n  openDM(userId: string): Promise\u003CChannel>;\n  channel(channelId: string): Channel;\n}\n```\n\n- `openDM()` opens or resolves a direct message channel outside the current thread context.\n- `channel()` gets a channel handle for out-of-thread posting.\n\n### Postable\n\n`Thread` and `Channel` share the same `Postable` interface.\n\n```ts\ninterface Postable\u003CTState extends Record\u003Cstring, unknown> = Record\u003Cstring, unknown>> {\n  post(content: PostableContent): Promise\u003CSentMessage>;\n  postEphemeral(\n    userId: string,\n    content: PostableContent,\n  ): Promise\u003CSentMessage | null>;\n  mentionUser(userId: string): string;\n  startTyping(): Promise\u003Cvoid>;\n  messages: AsyncIterable\u003CMessage>;\n  state: Promise\u003CTState | null>;\n  setState(\n    partial: Partial\u003CTState>,\n    opts?: { replace?: boolean },\n  ): Promise\u003Cvoid>;\n}\n```\n\n### Thread\n\n```ts\ninterface Thread\u003CTState extends Record\u003Cstring, unknown> = Record\u003Cstring, unknown>> extends Postable\u003CTState> {\n  id: string;\n  channelId: string;\n  subscribe(): Promise\u003Cvoid>;\n  unsubscribe(): Promise\u003Cvoid>;\n  isSubscribed(): Promise\u003Cboolean>;\n  refresh(): Promise\u003Cvoid>;\n  createSentMessageFromMessage(message: Message): SentMessage;\n}\n```\n\n### Message\n\n```ts\nclass Message\u003CTRaw = unknown> {\n  id: string;\n  threadId: string;\n  text: string;\n  isMention: boolean;\n  raw: TRaw;\n\n  toJSON(): SerializedMessage;\n  static fromJSON(data: SerializedMessage): Message;\n}\n```\n\n### SentMessage\n\n```ts\ninterface SentMessage extends Message {\n  edit(content: PostableContent): Promise\u003Cvoid>;\n  delete(): Promise\u003Cvoid>;\n  addReaction(emoji: string): Promise\u003Cvoid>;\n  removeReaction(emoji: string): Promise\u003Cvoid>;\n}\n```\n\nReactions are on `SentMessage`, not `Message`:\n`const sent = await thread.post('Done'); await sent.addReaction('thumbsup');`\n\n```ts\nconst sent = await thread.post(\"Done\");\nawait sent.addReaction(\"thumbsup\");\n```\n\n### Channel\n\n```ts\ninterface Channel\u003CTState extends Record\u003Cstring, unknown> = Record\u003Cstring, unknown>> extends Postable\u003CTState> {\n  id: string;\n  name?: string;\n}\n```\n\n## Event Handlers\n\n### Standard handlers\n\n- `onNewMention(handler)`\n- `onSubscribedMessage(handler)`\n- `onNewMessage(pattern, handler)`\n- `onReaction(filter?, handler)`\n- `onAction(filter?, handler)`\n- `onModalSubmit(filter?, handler)`\n- `onModalClose(filter?, handler)`\n- `onSlashCommand(filter?, handler)`\n- `onMemberJoinedChannel(handler)`\n\n```ts\nbot.onMemberJoinedChannel(async (event) => {\n  await event.thread.post(`Welcome ${event.user.fullName}!`);\n});\n```\n\n### Handler overloads\n\n`onAction`, `onModalSubmit`, `onModalClose`, and `onReaction` support:\n\n- Catch-all: `bot.onAction(async (event) => { ... })`\n- Single filter: `bot.onAction(\"approve\", async (event) => { ... })`\n- Array filter: `bot.onAction([\"approve\", \"reject\"], async (event) => { ... })`\n\n### Event payload shapes\n\n```ts\ninterface ActionEvent {\n  actionId: string;\n  value?: string;\n  triggerId?: string;\n  privateMetadata?: string;\n  thread: Thread;\n  relatedThread?: Thread;\n  relatedMessage?: Message;\n  openModal: (modal: JSX.Element) => Promise\u003Cvoid>;\n}\n\ninterface ModalEvent {\n  callbackId: string;\n  values: Record\u003Cstring, string>;\n  triggerId?: string;\n  privateMetadata?: string;\n  relatedThread?: Thread;\n  relatedMessage?: Message;\n}\n```\n\n`onModalSubmit` may return `ModalResponse` to close, validate, update, or push another modal.\n\n## Cards & Modals\n\n### Cards\n\n```tsx\nawait thread.post(\n  \u003CCard\n    title=\"Build Status\"\n    subtitle=\"Production\"\n    imageUrl=\"https:\u002F\u002Fexample.com\u002Fpreview.png\"\n  >\n    \u003CText style=\"success\">Deployment succeeded.\u003C\u002FText>\n    \u003CText style=\"muted\">Commit: a1b2c3d\u003C\u002FText>\n\n    \u003CField\n      id=\"deploy-target\"\n      label=\"Target\"\n      options={[\n        { label: \"Staging\", value: \"staging\" },\n        { label: \"Production\", value: \"prod\" },\n      ]}\n      value=\"prod\"\n    \u002F>\n\n    \u003CTable>\n      \u003CTableRow>\n        \u003CTableCell>Region\u003C\u002FTableCell>\n        \u003CTableCell>us-east-1\u003C\u002FTableCell>\n      \u003C\u002FTableRow>\n      \u003CTableRow>\n        \u003CTableCell>Latency\u003C\u002FTableCell>\n        \u003CTableCell>128ms\u003C\u002FTableCell>\n      \u003C\u002FTableRow>\n    \u003C\u002FTable>\n\n    \u003CActions>\n      \u003CButton id=\"rollback\" style=\"danger\">\n        Rollback\n      \u003C\u002FButton>\n      \u003CCardLink url=\"https:\u002F\u002Fvercel.com\u002Fdashboard\">Open Dashboard\u003C\u002FCardLink>\n    \u003C\u002FActions>\n  \u003C\u002FCard>,\n);\n```\n\nCard additions to use when needed:\n\n- `Card.subtitle`\n- `Card.imageUrl`\n- `CardLink`\n- `Field` (`options` uses `{ label, value }[]`, not JSX children)\n- `Table` \u002F `TableRow` \u002F `TableCell` — native per-platform table rendering (**new — Mar 6, 2026**; see below)\n- `Text` styles (`default`, `muted`, `success`, `warning`, `danger`, `code`)\n\n### Table — Per-Platform Rendering (New — Mar 6, 2026)\n\nThe `Table` component renders natively on each platform:\n\n| Platform | Rendering |\n|---|---|\n| Slack | Block Kit table blocks |\n| Teams \u002F Discord | GFM markdown tables |\n| Google Chat | Monospace text widgets |\n| Telegram | Code blocks |\n| GitHub \u002F Linear | Markdown tables (existing pipeline) |\n\nPlain markdown tables (without `Table()`) also pass through the same adapter conversion pipeline.\n\n```tsx\n\u003CTable>\n  \u003CTableRow>\n    \u003CTableCell>Region\u003C\u002FTableCell>\n    \u003CTableCell>us-east-1\u003C\u002FTableCell>\n  \u003C\u002FTableRow>\n  \u003CTableRow>\n    \u003CTableCell>Latency\u003C\u002FTableCell>\n    \u003CTableCell>128ms\u003C\u002FTableCell>\n  \u003C\u002FTableRow>\n\u003C\u002FTable>\n```\n\n### Modals\n\n```tsx\nawait event.openModal(\n  \u003CModal\n    callbackId=\"deploy-form\"\n    title=\"Deploy\"\n    submitLabel=\"Deploy\"\n    closeLabel=\"Cancel\"\n    notifyOnClose\n    privateMetadata={JSON.stringify({ releaseId: \"rel_123\" })}\n  >\n    \u003CTextInput id=\"reason\" label=\"Reason\" multiline \u002F>\n  \u003C\u002FModal>,\n);\n```\n\nUse `privateMetadata` to pass contextual data into submit\u002Fclose events.\n\n## Companion Web UI and Card Design\n\nChat SDK payloads render natively in chat platforms, so shadcn isn't used in message markup. But when building a web control plane, thread inspector, or bot settings UI around Chat SDK, use shadcn + Geist by default. Thread dashboards: Tabs+Card+Table+Badge. Bot settings: Sheet+form controls. Logs\u002FIDs\u002Ftimestamps: Geist Mono with tabular-nums.\n\n## Platform Adapters\n\n### Slack\n\n```ts\nimport { createSlackAdapter } from \"@chat-adapter\u002Fslack\";\n\nconst slack = createSlackAdapter();\n\u002F\u002F Env: SLACK_BOT_TOKEN, SLACK_SIGNING_SECRET\n\nconst oauthSlack = createSlackAdapter({\n  clientId: process.env.SLACK_CLIENT_ID!,\n  clientSecret: process.env.SLACK_CLIENT_SECRET!,\n  encryptionKey: process.env.SLACK_ENCRYPTION_KEY,\n});\n```\n\n### Telegram\n\n```ts\nimport { createTelegramAdapter } from \"@chat-adapter\u002Ftelegram\";\n\nconst telegram = createTelegramAdapter();\n\u002F\u002F Env: TELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_SECRET\n```\n\n### Microsoft Teams\n\n```ts\nimport { createTeamsAdapter } from \"@chat-adapter\u002Fteams\";\n\nconst teams = createTeamsAdapter({\n  appType: \"singleTenant\",\n});\n\u002F\u002F Env: TEAMS_APP_ID, TEAMS_APP_PASSWORD, TEAMS_APP_TENANT_ID\n```\n\n### Discord\n\n```ts\nimport { createDiscordAdapter } from \"@chat-adapter\u002Fdiscord\";\n\nconst discord = createDiscordAdapter();\n\u002F\u002F Env: DISCORD_BOT_TOKEN, DISCORD_PUBLIC_KEY, DISCORD_APPLICATION_ID, CRON_SECRET\n```\n\nFor message content handlers, enable both Gateway intent and Message Content Intent in the Discord developer portal.\n\n### Google Chat\n\n```ts\nimport { createGoogleChatAdapter } from \"@chat-adapter\u002Fgchat\";\n\nconst gchat = createGoogleChatAdapter();\n\u002F\u002F Env: GOOGLE_CHAT_CREDENTIALS, GOOGLE_CHAT_USE_ADC\n```\n\n### GitHub\n\n```ts\nimport { createGitHubAdapter } from \"@chat-adapter\u002Fgithub\";\n\nconst github = createGitHubAdapter({\n  botUserId: process.env.GITHUB_BOT_USER_ID,\n});\n\u002F\u002F Env: GITHUB_TOKEN or (GITHUB_APP_ID + GITHUB_PRIVATE_KEY),\n\u002F\u002F      GITHUB_WEBHOOK_SECRET, GITHUB_INSTALLATION_ID\n```\n\n### Linear\n\n```ts\nimport { createLinearAdapter } from \"@chat-adapter\u002Flinear\";\n\nconst linear = createLinearAdapter({\n  clientId: process.env.LINEAR_CLIENT_ID,\n  clientSecret: process.env.LINEAR_CLIENT_SECRET,\n  accessToken: process.env.LINEAR_ACCESS_TOKEN,\n});\n```\n\n## State Adapters\n\n### Redis (recommended)\n\n```ts\nimport { createRedisState } from \"@chat-adapter\u002Fstate-redis\";\n\nconst state = createRedisState();\n\u002F\u002F Env: REDIS_URL (or REDIS_HOST\u002FREDIS_PORT\u002FREDIS_PASSWORD)\n```\n\n### ioredis (cluster\u002Fsentinel)\n\n```ts\nimport { createIoRedisState } from \"@chat-adapter\u002Fstate-ioredis\";\n\nconst state = createIoRedisState({\n  \u002F\u002F cluster\u002Fsentinel options\n});\n```\n\n### Memory (dev\u002Ftest only)\n\n```ts\nimport { MemoryState } from \"@chat-adapter\u002Fstate-memory\";\n\nconst state = new MemoryState();\n```\n\n## Webhook Setup\n\n### Next.js App Router\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fwebhooks\u002Fslack\u002Froute.ts\nimport { bot } from \"@\u002Flib\u002Fbot\";\nimport { after } from \"next\u002Fserver\";\n\nexport async function POST(req: Request) {\n  return bot.webhooks.slack(req, {\n    waitUntil: (p) => after(() => p),\n  });\n}\n```\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fwebhooks\u002Ftelegram\u002Froute.ts\nimport { bot } from \"@\u002Flib\u002Fbot\";\n\nexport async function POST(req: Request) {\n  return bot.webhooks.telegram(req);\n}\n```\n\n### Pages Router\n\n```ts\n\u002F\u002F pages\u002Fapi\u002Fbot.ts\nexport default async function handler(req, res) {\n  const response = await bot.webhooks.slack(req);\n  res.status(response.status).send(await response.text());\n}\n```\n\n## Integration Patterns\n\n### Out-of-thread routing with `openDM()` and `channel()`\n\n```ts\nbot.onAction(\"handoff\", async (event) => {\n  const dm = await bot.openDM(event.user.id);\n  await dm.post(\"A human will follow up shortly.\");\n\n  const ops = bot.channel(\"ops-alerts\");\n  await ops.post(`Escalated by ${event.user.fullName}`);\n});\n```\n\n### Workflow-safe serialization with `registerSingleton()` and `reviver()`\n\n```ts\nbot.registerSingleton();\n\nconst serialized = JSON.stringify({ thread });\nconst revived = JSON.parse(serialized, bot.reviver());\nawait revived.thread.post(\"Resumed workflow step\");\n```\n\n### Slack OAuth callback handling\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fwebhooks\u002Fslack\u002Foauth\u002Fcallback\u002Froute.ts\nimport { bot } from \"@\u002Flib\u002Fbot\";\n\nexport async function GET(req: Request) {\n  return bot.oauth.slack.callback(req);\n}\n```\n\n## Gotchas\n\n### Routing\n\n1. `onNewMention` only fires for unsubscribed threads; call `thread.subscribe()` to receive follow-ups.\n2. DMs are treated as direct intent and set `message.isMention = true`.\n3. `onNewMessage(pattern, handler)` only applies before subscription; use `onSubscribedMessage` after subscribe.\n4. Catch-all and filtered handlers can both run; registration order determines execution order.\n5. Out-of-thread routing via `openDM()` \u002F `channel()` needs platform permissions for DM\u002Fchannel posting.\n\n### Streaming\n\n6. Slack supports native streaming with real-time bold, italic, list, and other formatting rendered as the response arrives. Teams\u002FDiscord\u002FGoogle Chat\u002FTelegram use post+edit fallback.\n7. Fallback adapters now convert markdown to each platform's native format at every intermediate edit — users no longer see raw `**bold**` syntax during streaming.\n8. `fallbackStreamingPlaceholderText: null` disables placeholder messages on fallback adapters.\n9. `streamingUpdateIntervalMs` too low can trigger rate limits on post+edit adapters.\n10. `dedupeTtlMs` should cover webhook retry windows to avoid duplicate responses.\n11. `startTyping()` is adapter-dependent and may no-op on platforms without typing indicators.\n\n### Adapter-specific\n\n11. Google Chat auth uses `GOOGLE_CHAT_CREDENTIALS` + `GOOGLE_CHAT_USE_ADC`; domain-wide delegation\u002Fimpersonation is required for some org posting scenarios.\n12. Teams requires `appType` plus `TEAMS_APP_TENANT_ID`; reactions\u002Fhistory\u002Ftyping features are limited compared with Slack.\n13. Discord content-based handlers require Message Content Intent enabled in addition to Gateway connectivity.\n14. GitHub and Linear adapters do not support interactive card actions\u002Fmodals; design around comments\u002Fstatus updates instead.\n15. GitHub App installs need `GITHUB_INSTALLATION_ID` and often adapter `botUserId`; Linear OAuth setups need `clientId`, `clientSecret`, and `LINEAR_ACCESS_TOKEN`.\n\n## Official Docs\n\n- [Chat SDK documentation](https:\u002F\u002Fchat-sdk.dev)\n- [GitHub: vercel\u002Fchat](https:\u002F\u002Fgithub.com\u002Fvercel\u002Fchat)\n",{"name":5,"metadata":24,"description":7},{"docs":25,"sitemap":28,"priority":29,"bashPatterns":30,"pathPatterns":43,"promptSignals":89,"importPatterns":113},[26,27],"https:\u002F\u002Fsdk.vercel.ai\u002Fdocs\u002Fai-sdk-ui\u002Fchatbot","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fai-chatbot","https:\u002F\u002Fsdk.vercel.ai\u002Fsitemap.xml",8,[31,32,33,34,35,36,37,38,39,40,41,42],"\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bchat\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bchat\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bchat\\b","\\byarn\\s+add\\s+[^\\n]*\\bchat\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002F","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002F","\\bbun\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002F","\\byarn\\s+add\\s+[^\\n]*@chat-adapter\u002F","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002Ftelegram","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002Ftelegram","\\bbun\\s+(install|i|add)\\s+[^\\n]*@chat-adapter\u002Ftelegram","\\byarn\\s+add\\s+[^\\n]*@chat-adapter\u002Ftelegram",[44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88],"app\u002Fapi\u002Fchat\u002F**","app\u002Fapi\u002Fchat-bot\u002F**","app\u002Fapi\u002Fbot\u002F**","app\u002Fapi\u002Fslack\u002F**","app\u002Fapi\u002Fteams\u002F**","app\u002Fapi\u002Fdiscord\u002F**","app\u002Fapi\u002Fgchat\u002F**","app\u002Fapi\u002Ftelegram\u002F**","app\u002Fapi\u002Fgithub-bot\u002F**","app\u002Fapi\u002Flinear-bot\u002F**","app\u002Fapi\u002Fwebhooks\u002Fslack\u002F**","app\u002Fapi\u002Fwebhooks\u002Fteams\u002F**","app\u002Fapi\u002Fwebhooks\u002Fdiscord\u002F**","app\u002Fapi\u002Fwebhooks\u002Fgchat\u002F**","app\u002Fapi\u002Fwebhooks\u002Ftelegram\u002F**","app\u002Fapi\u002Fwebhooks\u002Fgithub\u002F**","app\u002Fapi\u002Fwebhooks\u002Flinear\u002F**","src\u002Fapp\u002Fapi\u002Fchat\u002F**","src\u002Fapp\u002Fapi\u002Fchat-bot\u002F**","src\u002Fapp\u002Fapi\u002Fbot\u002F**","src\u002Fapp\u002Fapi\u002Fslack\u002F**","src\u002Fapp\u002Fapi\u002Fteams\u002F**","src\u002Fapp\u002Fapi\u002Fdiscord\u002F**","src\u002Fapp\u002Fapi\u002Fgchat\u002F**","src\u002Fapp\u002Fapi\u002Ftelegram\u002F**","lib\u002Fbot.*","lib\u002Fbot\u002F**","src\u002Flib\u002Fbot.*","src\u002Flib\u002Fbot\u002F**","lib\u002Fchat-bot\u002F**","src\u002Flib\u002Fchat-bot\u002F**","bot\u002F**","pages\u002Fapi\u002Fbot.*","pages\u002Fapi\u002Fbot\u002F**","src\u002Fpages\u002Fapi\u002Fbot.*","src\u002Fpages\u002Fapi\u002Fbot\u002F**","tests\u002F**\u002Fbot*","test\u002F**\u002Fbot*","fixtures\u002Freplay\u002F**","apps\u002F*\u002Fapp\u002Fapi\u002Fbot\u002F**","apps\u002F*\u002Fapp\u002Fapi\u002Fslack\u002F**","apps\u002F*\u002Fapp\u002Fapi\u002Fteams\u002F**","apps\u002F*\u002Fapp\u002Fapi\u002Fdiscord\u002F**","apps\u002F*\u002Flib\u002Fbot\u002F**","apps\u002F*\u002Fsrc\u002Flib\u002Fbot\u002F**",{"allOf":90,"anyOf":96,"noneOf":101,"phrases":103,"minScore":112},[91,94],[92,93],"bot","platform",[92,95],"multi",[97,98,99,100],"onNewMention","onSubscribedMessage","chat adapter","cross-platform bot",[102],"useChat",[104,105,106,107,108,109,110,111],"chat sdk","chat bot","chatbot","conversational interface","slack bot","telegram bot","discord bot","teams bot",6,[114,115],"chat","@chat-adapter\u002F*","main","dde9a06ab10bce3fe52058c783826590231f7df3","plugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fchat-sdk","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api","https:\u002F\u002Fgithub.com\u002Fwxdwu","24120128@bjtu.edu.cn","I am Xudong Wu，a student in beijing jiaotong University, \"I am eager to learn on GitHub and contribute my part to this community.","2026-10-05 17:26:50",{"source":8,"skillName":5,"commands":125,"prompt":135,"zipAvailable":136},[126,129,132],{"tool":127,"command":128},"npx","npx skills add wxdwu\u002Fnew-api --skill chat-sdk",{"tool":130,"command":131},"bunx","bunx skills add wxdwu\u002Fnew-api --skill chat-sdk",{"tool":133,"command":134},"pnpm","pnpm dlx skills add wxdwu\u002Fnew-api --skill chat-sdk","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fchat-sdk\u002FSKILL.md",true,[138],{"path":139,"resourceType":140,"resourceTypeDesc":141,"sizeBytes":142,"sourceHtmlUrl":143},"agents\u002Fopenai.yaml","REFERENCE","参考文档",93,"https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fchat-sdk\u002Fagents\u002Fopenai.yaml",[145,152,159,166,173,180],{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":151,"publishedAt":19},"01M7E8SVA2N0JA09RW1XJYXCWX","Zotero","Use Zotero Desktop from Codex to enable\u002Fprobe the local API, search a local Zotero library, list items\u002Fcollections\u002Ftags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX\u002FRIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzotero\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":153,"name":154,"nameZh":6,"description":155,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":156,"categories":157,"keywords":158,"publishedAt":19},"01M7E8ST1FJAD5PWTW2FN1NSK0","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":165,"publishedAt":19},"01M7E8SRW074NNNCZRCZA5T3Z1","setup-zoom-websockets","Use when building Zoom WebSockets.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[],{"skillNo":167,"name":168,"nameZh":6,"description":169,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":170,"categories":171,"keywords":172,"publishedAt":19},"01M7E8SPCFMD3YVPRX2MW8X3RA","setup-zoom-webhooks","Use when building Zoom webhooks.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fwebhooks\u002FSKILL.md",[],[],{"skillNo":174,"name":175,"nameZh":6,"description":176,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":177,"categories":178,"keywords":179,"publishedAt":19},"01M7E8SMCH4RPCX8YSBNGWQCMP","zoom-virtual-agent-web","Zoom Virtual Agent SDK for web embeds. Use for campaign or entry ID chat launch, event-driven controls, user context updates, and CSP-safe deployment.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fvirtual-agent\u002Fweb\u002FSKILL.md",[],[],{"skillNo":181,"name":182,"nameZh":6,"description":183,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":184,"categories":185,"keywords":186,"publishedAt":19},"01M7E8SJCAY323E36Z8SAP8H4M","zoom-virtual-agent-ios","Zoom Virtual Agent iOS integration via WKWebView. Use for Swift\u002FObjective-C script injection, message handlers, support_handoff relay, and URL routing policies.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fvirtual-agent\u002Fios\u002FSKILL.md",[],[]]