Chat SDK : un SDK TypeScript unifié pour de nombreuses plateformes de chat

Un noyau de bot, de nombreuses plateformes de chat

Chat SDK est un paquet TypeScript publié sous le nom `chat`. Le README le décrit comme un SDK unifié pour créer des bots de chat sur Slack, Microsoft Teams, Google Chat, Discord, Telegram, GitHub, Linear, WhatsApp, et plus encore. L'idée centrale est d'écrire la logique du bot une seule fois et de la déployer sur n'importe quelle plateforme prise en charge. Le comportement spécifique à chaque plateforme se trouve dans des adaptateurs, des paquets npm séparés sous le scope `@chat-adapter`. Le README ne liste pas toutes les plateformes prises en charge et n'explique pas comment la couverture des adaptateurs est maintenue.

Installation et génération de squelette

Installez le SDK avec `npm i chat`. Les adaptateurs s'installent séparément ; le README montre `npm install @chat-adapter/slack @chat-adapter/teams @chat-adapter/gchat`. Un paquet CLI, `create-chat-sdk`, génère une application de bot Next.js lorsqu'on exécute `npx create-chat-sdk@latest my-bot`. Selon le README, le CLI génère la configuration `Chat`, une route webhook, un fichier `.env.example`, les dépendances, et une route d'adaptateur Web optionnelle. Les options et l'utilisation non interactive ne sont pas couvertes par le README ; elles figurent dans la documentation CLI sur chat-sdk.dev.

Motif d'utilisation de base

L'exemple d'utilisation du README commence par une instance `Chat`. Il importe `Chat` depuis `chat`, un adaptateur Slack depuis `@chat-adapter/slack`, et un adaptateur d'état Redis depuis `@chat-adapter/state-redis`. Le constructeur prend `userName`, un objet `adapters`, et un objet `state`. L'exemple enregistre `onNewMention` pour s'abonner à un fil et poster un message de bienvenue, et `onSubscribedMessage` pour renvoyer le texte du message. Le README renvoie au guide Getting Started pour un parcours complet ; il ne décrit pas comment l'état est persisté ni comment les adaptateurs sont configurés au-delà de l'extrait.

Liste des fonctionnalités et leur couverture

Le README énumère onze fonctionnalités : des gestionnaires d'événements pour les mentions, messages, réactions, clics de boutons, commandes slash et modales ; le streaming IA avec streaming natif Slack, aperçus de brouillon de discussion privée Telegram et repli post-puis-modification ; des cartes interactives basées sur JSX pour Block Kit, Adaptive Cards et Google Chat Cards ; des actions pour les clics de boutons et les sélections dans des listes déroulantes ; des modales avec saisies de texte, listes déroulantes et validation ; des commandes slash ; des emojis typés et multiplateformes avec prise en charge des emojis personnalisés ; des téléversements de fichiers ; l'initiation programmatique de messages directs ; des messages éphémères visibles uniquement par l'utilisateur avec repli vers DM ; et la gestion configurable des messages se chevauchant sur un même fil via burst, queue, debounce, drop ou process. Chaque fonctionnalité pointe vers une page de documentation, mais le README lui-même ne fournit pas de détails d'implémentation.

Outils pour agents de codage IA

Chat SDK inclut une compétence optionnelle pour les agents de codage IA. Le README suggère de l'installer avec `npx skills add vercel/chat` lorsqu'on utilise des agents comme OpenAI Codex, Claude Code ou Cursor. La compétence référence la documentation incluse dans `node_modules/chat/docs`, ainsi que des guides d'adaptateurs et des modèles de départ dans le paquet publié. Le README mentionne également un plugin Vercel installable avec `npx plugins add vercel/vercel-plugin`, qui inclut la compétence Chat SDK et d'autres outils. Deux points de terminaison de documentation lisibles par machine sont listés : `chat-sdk.dev/llms.txt` et `chat-sdk.dev/llms-full.txt`. Le README ne décrit pas ce que contient la compétence au-delà de la référence à la documentation incluse.

Documentation, support et licence

La documentation complète est sur chat-sdk.dev/docs, et des guides sont dans la base de connaissances Vercel. Pour les contributions, le support et les signalements de sécurité, le README renvoie à `CONTRIBUTING.md`, `SUPPORT.md` et `SECURITY.md` dans le dépôt. La licence est MIT, copyright 2026 Vercel, Inc. Elle autorise l'utilisation, la copie, la modification, la fusion, la publication, la distribution, la sous-licence et la vente de copies, à condition que l'avis de copyright soit inclus. Le logiciel est fourni tel quel, sans garantie. Le README ne précise pas les délais de réponse du support, les garanties de sécurité, ni si tous les adaptateurs sont vendor-official.

Conclusion éditoriale

Le README du Chat SDK présente un petit noyau et un vaste écosystème d'adaptateurs. Il définit l'installation, le générateur CLI, un exemple d'utilisation, une liste de fonctionnalités et des outils pour agents IA, puis renvoie le reste vers chat-sdk.dev. La licence MIT couvre le paquet mais ne dit rien sur le support ou la garantie.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes