mirror of https://github.com/vercel/chat.git synced 2026-09-14 18:32:29 +08:00

Files

T

github-actions[bot] 85a37c896f chore(release): version packages (#878 )

This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.


# Releases
## @chat-adapter/gchat@4.40.0

### Minor Changes

- f485255: Harden webhook tenant isolation, require explicit Google Chat
bot identity for reliable mention handling, use native Google Chat
pagination, isolate Slack caches, and bound recording storage.

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/slack@4.40.0

### Minor Changes

- 51322dd: Decode the bot's own mention in incoming Slack messages. The
adapter now resolves `<@U_BOT>` to the bot's display name
(`@<DisplayName>`) the same way it resolves every other user mention,
instead of leaving the raw user-ID markup in place, and sets `isMention`
on the parsed message by detecting the bot's ID in the raw event text.
This keeps `message.text` self-describing for downstream consumers (LLM
prompts, classifiers) while preserving mention detection, which
previously depended on the raw ID markup surviving in the text.
- d4a1f03: Rotate long-running native Slack streams before Slack expires
them. Once a stream segment passes `streamSegmentMaxAgeMs` (default four
minutes) the adapter finalizes it at the next paragraph break and
continues the reply in a new message, closing and reopening code fences,
repeating table headers, replaying open task cards and the plan title,
and keeping the agent session in `processing`. A segment Slack already
expired during an idle gap is recovered the same way instead of failing
the reply.
- 2cc8cc3: Surface custom status text in the Agent messaging experience.
`startTyping` and `setAssistantStatus` with a custom status now call the
legacy `assistant.threads.setStatus` endpoint, whose compatibility
bridge renders the text in the agent-session loading UX — instead of
silently dropping the text and showing the generic "Working…" indicator.
Clearing (empty status) still transitions the session to `active` via
the Agent Sessions lifecycle.

### Patch Changes

- 78021c0: pass workspace context to suggested prompt resolvers in Agent
view
- 8b6d7f3: Reactivate Slack Agent Sessions when `startTyping` receives
an empty status.
- c2b6bff: Use the Slack bot user ID for bot-authored messages when a
bot profile is available.
- f485255: Harden webhook tenant isolation, require explicit Google Chat
bot identity for reliable mention handling, use native Google Chat
pagination, isolate Slack caches, and bound recording storage.
- 8fdaf4a: Stream post-and-edit fallback updates through Slack's
`markdown_text` field instead of `text`, so live-updating messages
render markdown while the stream is in progress (and get the
12,000-character ceiling rather than 4,000)
- 7609d8f: Validate external request targets before sending credentials,
message content, or attachment requests.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/teams@4.40.0

### Minor Changes

- aaeede7: emit Teams bot-join events and expose the bot user ID
- 4a0b5c0: Add `tooltip` to `Button` and `LinkButton`, and a `width`
hint to `Card`. The Teams adapter and the `@chat-adapter/teams/cards`
subpath render them as the Adaptive Card action `tooltip` and the
`msteams` full-width card property; other adapters ignore them. Emitted
Adaptive Cards now declare schema version 1.5, which is the version that
introduced action tooltips. Buttons with a `callbackUrl` keep their
`tooltip` and other fields when the URL is swapped for a callback token.

### Patch Changes

- a8de95b: Fall back to Teams activity group metadata when the explicit
conversation type is missing.
- f485255: Harden webhook tenant isolation, require explicit Google Chat
bot identity for reliable mention handling, use native Google Chat
pagination, isolate Slack caches, and bound recording storage.
- 7062c39: preserve outgoing @names as plain text instead of generating
mention markup without matching entities
- 7609d8f: Validate external request targets before sending credentials,
message content, or attachment requests.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/telegram@4.40.0

### Minor Changes

- 043386b: Add Telegram Business mode support. Opt in via `businessMode:
true`.
  
The adapter handles `business_connection`, `business_message`, and
`edited_business_message` updates, encodes business threads as
`telegram:biz:{connectionId}:{chatId}`, and passes
`business_connection_id` on outbound sends, edits, typing, file uploads,
and inline-keyboard callbacks. Business threads are their own channel,
slash commands route through `onSlashCommand`, deletes use
`deleteBusinessMessages`, and connection state is cached in the state
adapter so a revoked connection is honoured by every instance. Reactions
on business threads throw a `NotImplementedError`, since the Bot API has
no business variant of `setMessageReaction`.

### Patch Changes

- 43dba3d: Skip unused plain-text conversion for rich and Markdown
native draft updates. Plain-text fallback and final delivery keep their
existing behavior.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/whatsapp@4.40.0

### Minor Changes

- 31bce0a: export `WhatsAppApiError` for non-2xx Graph API responses. It
carries Meta's numeric `errorCode`, `providerMessage`, `type`,
`details`, `subcode`, `traceId`, the HTTP `status`, and the `raw`
envelope, and maps `code` onto the shared `AdapterError` taxonomy
(`RATE_LIMITED`, `AUTH_FAILED`, `PERMISSION_DENIED`, `NOT_FOUND`).
Transport failures and unparseable response bodies now throw
`NetworkError` instead of leaking raw fetch errors, and error messages
carry Meta's message or a bounded excerpt instead of the full response
body.

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## chat@4.40.0

### Minor Changes

- 4a0b5c0: Add `tooltip` to `Button` and `LinkButton`, and a `width`
hint to `Card`. The Teams adapter and the `@chat-adapter/teams/cards`
subpath render them as the Adaptive Card action `tooltip` and the
`msteams` full-width card property; other adapters ignore them. Emitted
Adaptive Cards now declare schema version 1.5, which is the version that
introduced action tooltips. Buttons with a `callbackUrl` keep their
`tooltip` and other fields when the URL is swapped for a callback token.

### Patch Changes

- f485255: Harden webhook tenant isolation, require explicit Google Chat
bot identity for reliable mention handling, use native Google Chat
pagination, isolate Slack caches, and bound recording storage.
- b7c9316: Tighten AI tool and queued-message scoping, isolate
direct-message conversations, preserve ephemeral follow-ups, consume
callback tokens once, and mark external link metadata as untrusted.
## @chat-adapter/discord@4.40.0

### Patch Changes

- b7c9316: Tighten AI tool and queued-message scoping, isolate
direct-message conversations, preserve ephemeral follow-ups, consume
callback tokens once, and mark external link metadata as untrusted.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/github@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/instagram@4.40.0

### Patch Changes

- 7609d8f: Validate external request targets before sending credentials,
message content, or attachment requests.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/linear@4.40.0

### Patch Changes

- 3d2cb22: Keep Linear agent-session events on one stable thread and
handle sessions created by automation or without a root comment.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/messenger@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/notion@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/shared@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
## @chat-adapter/twilio@4.40.0

### Patch Changes

- b7c9316: Tighten AI tool and queued-message scoping, isolate
direct-message conversations, preserve ephemeral follow-ups, consume
callback tokens once, and mark external link metadata as untrusted.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/web@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/x@4.40.0

### Patch Changes

- 7609d8f: Validate external request targets before sending credentials,
message content, or attachment requests.
- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
  - @chat-adapter/shared@4.40.0
## @chat-adapter/state-ioredis@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
## @chat-adapter/state-memory@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
## @chat-adapter/state-pg@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
## @chat-adapter/state-redis@4.40.0

### Patch Changes

- Updated dependencies [f485255]
- Updated dependencies [b7c9316]
- Updated dependencies [4a0b5c0]
  - chat@4.40.0
## @chat-adapter/tests@4.40.0

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

2026-09-05 06:06:47 +00:00

src

fix(slack): preserve first line of incoming code blocks (#843 )

2026-08-28 15:09:03 +10:00

CHANGELOG.md

chore(release): version packages (#878 )

2026-09-05 06:06:47 +00:00

package.json

chore(release): version packages (#878 )

2026-09-05 06:06:47 +00:00

README.md

docs: refresh agent docs, README badges, and Chat SDK skill (#646 )

2026-06-27 14:06:13 +10:00

tsconfig.json

Upgrade Biome configuration to use Ultracite preset (#81 )

2026-02-20 22:01:10 -08:00

tsup.config.ts

fix: disable source maps in published packages (#337 )

2026-04-07 09:02:36 +10:00

vitest.config.ts

Upgrade vitest

2026-02-27 09:58:28 -08:00

README.md

@chat-adapter/shared

npm package: @chat-adapter/shared

Shared utilities for Chat SDK adapters. Provides common helpers used across adapter implementations.

Documentation: chat-sdk.dev/docs/contributing/building · Guides: vercel.com/kb/chat-sdk

Installation

pnpm add @chat-adapter/shared

Utilities

Adapter helpers

extractCard(message) - extract a CardElement from an AdapterPostableMessage
extractFiles(message) - extract FileUpload[] from an AdapterPostableMessage
extractPostableAttachments(message) - extract Attachment[] from an AdapterPostableMessage

Buffer conversion

toBuffer(input) - convert various inputs (Buffer, Blob, string, URL) to Buffer
toBufferSync(input) - synchronous version of toBuffer
bufferToDataUri(buffer, mimeType) - convert a Buffer to a data URI string

Card conversion

cardToFallbackText(card) - render a CardElement as plain text for platforms that don't support cards
createEmojiConverter(platform) - create a function that converts emoji placeholders to platform format
mapButtonStyle(style) - map generic button styles to platform-specific variants
renderGfmTable(headers, rows) - render a GitHub Flavored Markdown table
escapeTableCell(text) - escape pipe characters in table cells

Token encryption

AES-256-GCM helpers for encrypting OAuth tokens at rest before writing them to a state adapter. Used by @chat-adapter/slack and @chat-adapter/linear; available to any adapter that persists credentials.

encryptToken(plaintext, key) - encrypt a string and return an EncryptedTokenData envelope (random 12-byte IV per call)
decryptToken(data, key) - decrypt an envelope back to the original string
decodeKey(encoded) - decode a hex-64 or base64-44 encoded 32-byte key; throws on wrong length
isEncryptedTokenData(value) - type guard for distinguishing envelopes from legacy plaintext records
EncryptedTokenData - the envelope type ({ data, iv, tag }, all base64)

Error classes

Standardized errors for adapter implementations:

AdapterError - base error class
AdapterRateLimitError - platform rate limit (includes retryAfter)
AuthenticationError - expired or invalid tokens
NetworkError - connection failures
PermissionError - missing scopes or permissions
ResourceNotFoundError - missing channel/thread/message
ValidationError - invalid config or input

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

The skill references bundled documentation in node_modules/chat/docs, plus adapter guides and starter templates in the published package.

You can also install the Vercel Plugin for a broader agent toolkit — it includes the Chat SDK skill alongside specialist agents, agent slash commands, and more:

npx plugins add vercel/vercel-plugin

The plugin is optional; the skill alone is enough to build with Chat SDK.

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

License

MIT