chat 4.15.0 → 4.16.1

package/dist/{jsx-runtime-Wowykq7Z.d.ts → jsx-runtime-Bokk9xw5.d.ts}

@@ -145,6 +145,8 @@ type ButtonStyle = "primary" | "danger" | "default";
 type TextStyle = "plain" | "bold" | "muted";
 /** Button element for interactive actions */
 interface ButtonElement {
+    /** If true, the button is displayed in an inactive state and doesn't respond to user actions */
+    disabled?: boolean;
     /** Unique action ID for callback routing */
     id: string;
     /** Button label text */
@@ -219,8 +221,20 @@ interface FieldsElement {
     children: FieldElement[];
     type: "fields";
 }
+/** Column alignment for table elements */
+type TableAlignment = "left" | "center" | "right";
+/** Table element for structured data display */
+interface TableElement {
+    /** Column alignment */
+    align?: TableAlignment[];
+    /** Column header labels */
+    headers: string[];
+    /** Data rows (each row is an array of cell strings) */
+    rows: string[][];
+    type: "table";
+}
 /** Union of all card child element types */
-type CardChild = TextElement | ImageElement | DividerElement | ActionsElement | SectionElement | FieldsElement | LinkElement;
+type CardChild = TextElement | ImageElement | DividerElement | ActionsElement | SectionElement | FieldsElement | LinkElement | TableElement;
 /** Union of all element types (including nested children) */
 type AnyCardElement = CardChild | CardElement | ButtonElement | LinkButtonElement | LinkElement | FieldElement | SelectElement | RadioSelectElement;
 /** Root card element */
@@ -318,6 +332,8 @@ declare function Section(children: CardChild[]): SectionElement;
 declare function Actions(children: (ButtonElement | LinkButtonElement | SelectElement | RadioSelectElement)[]): ActionsElement;
 /** Options for Button */
 interface ButtonOptions {
+    /** If true, the button is displayed in an inactive state and doesn't respond to user actions */
+    disabled?: boolean;
     /** Unique action ID for callback routing */
     id: string;
     /** Button label text */
@@ -380,6 +396,30 @@ declare function Field(options: {
  * ```
  */
 declare function Fields(children: FieldElement[]): FieldsElement;
+/** Options for Table */
+interface TableOptions {
+    /** Column alignment */
+    align?: TableAlignment[];
+    /** Column header labels */
+    headers: string[];
+    /** Data rows */
+    rows: string[][];
+}
+/**
+ * Create a Table element for structured data display.
+ *
+ * @example
+ * ```ts
+ * Table({
+ *   headers: ["Name", "Age", "Role"],
+ *   rows: [
+ *     ["Alice", "30", "Engineer"],
+ *     ["Bob", "25", "Designer"],
+ *   ],
+ * })
+ * ```
+ */
+declare function Table(options: TableOptions): TableElement;
 /**
  * Create a CardLink element for inline hyperlinks.
  *
@@ -412,6 +452,11 @@ declare function CardLink(options: {
  * ```
  */
 declare function fromReactElement(element: unknown): AnyCardElement | null;
+/**
+ * Generate fallback text from a card child element.
+ * Exported so adapter card converters can call it for unknown types.
+ */
+declare function cardChildToFallbackText(child: CardChild): string | null;
 
 /**
  * Custom JSX runtime for chat cards.
@@ -590,4 +635,4 @@ declare namespace JSX {
     }
 }
 
-export { type ModalOptions as $, Actions as A, Button as B, type CardElement as C, Divider as D, type LinkButtonOptions as E, Field as F, type LinkElement as G, type SectionElement as H, Image as I, type TextElement as J, type TextStyle as K, LinkButton as L, type ModalElement as M, type ButtonProps as N, type CardJSXProps as O, type CardLinkProps as P, type CardProps as Q, RadioSelect as R, Section as S, Text as T, type ContainerProps as U, type DividerProps as V, type FieldProps as W, type ImageProps as X, type LinkButtonProps as Y, type TextProps as Z, type ModalChild as _, type CardJSXElement as a, type RadioSelectElement as a0, type RadioSelectOptions as a1, type SelectElement as a2, type SelectOptionElement as a3, type SelectOptions as a4, type TextInputElement as a5, type TextInputOptions as a6, type ModalProps as a7, type TextInputProps as a8, type SelectProps as a9, type SelectOptionProps as aa, isCardLinkProps as ab, jsx as ac, jsxs as ad, jsxDEV as ae, Fragment as af, JSX as ag, type CardChild as b, Card as c, CardLink as d, Fields as e, fromReactElement as f, isJSX as g, toModalElement as h, isCardElement as i, fromReactModalElement as j, isModalElement as k, Modal as l, Select as m, SelectOption as n, TextInput as o, type ActionsElement as p, type ButtonElement as q, type ButtonOptions as r, type ButtonStyle as s, toCardElement as t, type CardOptions as u, type DividerElement as v, type FieldElement as w, type FieldsElement as x, type ImageElement as y, type LinkButtonElement as z };
+export { type FieldProps as $, Actions as A, Button as B, type CardElement as C, Divider as D, type ImageElement as E, Field as F, type LinkButtonElement as G, type LinkButtonOptions as H, Image as I, type LinkElement as J, type SectionElement as K, LinkButton as L, type ModalElement as M, type TableAlignment as N, type TableElement as O, type TableOptions as P, type TextElement as Q, RadioSelect as R, Section as S, Text as T, type TextStyle as U, type ButtonProps as V, type CardJSXProps as W, type CardLinkProps as X, type CardProps as Y, type ContainerProps as Z, type DividerProps as _, type CardJSXElement as a, type ImageProps as a0, type LinkButtonProps as a1, type TextProps as a2, type ModalChild as a3, type ModalOptions as a4, type RadioSelectElement as a5, type RadioSelectOptions as a6, type SelectElement as a7, type SelectOptionElement as a8, type SelectOptions as a9, type TextInputElement as aa, type TextInputOptions as ab, type ModalProps as ac, type TextInputProps as ad, type SelectProps as ae, type SelectOptionProps as af, isCardLinkProps as ag, jsx as ah, jsxs as ai, jsxDEV as aj, Fragment as ak, JSX as al, type CardChild as b, Card as c, cardChildToFallbackText as d, CardLink as e, Fields as f, fromReactElement as g, isJSX as h, isCardElement as i, Table as j, toModalElement as k, fromReactModalElement as l, isModalElement as m, Modal as n, Select as o, SelectOption as p, TextInput as q, type ActionsElement as r, type ButtonElement as s, toCardElement as t, type ButtonOptions as u, type ButtonStyle as v, type CardOptions as w, type DividerElement as x, type FieldElement as y, type FieldsElement as z };

package/dist/jsx-runtime.d.ts

@@ -1 +1 @@
-export { N as ButtonProps, a as CardJSXElement, O as CardJSXProps, P as CardLinkProps, Q as CardProps, U as ContainerProps, V as DividerProps, W as FieldProps, af as Fragment, X as ImageProps, ag as JSX, Y as LinkButtonProps, a7 as ModalProps, aa as SelectOptionProps, a9 as SelectProps, a8 as TextInputProps, Z as TextProps, ab as isCardLinkProps, g as isJSX, ac as jsx, ae as jsxDEV, ad as jsxs, t as toCardElement, h as toModalElement } from './jsx-runtime-Wowykq7Z.js';
+export { V as ButtonProps, a as CardJSXElement, W as CardJSXProps, X as CardLinkProps, Y as CardProps, Z as ContainerProps, _ as DividerProps, $ as FieldProps, ak as Fragment, a0 as ImageProps, al as JSX, a1 as LinkButtonProps, ac as ModalProps, af as SelectOptionProps, ae as SelectProps, ad as TextInputProps, a2 as TextProps, ag as isCardLinkProps, h as isJSX, ah as jsx, aj as jsxDEV, ai as jsxs, t as toCardElement, k as toModalElement } from './jsx-runtime-Bokk9xw5.js';

package/dist/jsx-runtime.js

@@ -7,7 +7,7 @@ import {
   jsxs,
   toCardElement,
   toModalElement
-} from "./chunk-VGF42GJ2.js";
+} from "./chunk-A2J5CUHD.js";
 export {
   Fragment,
   isCardLinkProps,

package/docs/actions.mdx

@@ -46,7 +46,7 @@ The `event` object passed to action handlers:
 | `actionId` | `string` | The `id` from the Button or Select component |
 | `value` | `string` (optional) | The `value` from the Button or selected option |
 | `user` | `Author` | The user who clicked |
-| `thread` | `Thread` | The thread containing the card |
+| `thread` | `Thread \| null` | The thread containing the card (null for view-based actions like home tab buttons) |
 | `messageId` | `string` | The message containing the card |
 | `threadId` | `string` | Thread ID |
 | `adapter` | `Adapter` | The platform adapter |

package/docs/adapters/discord.mdx

@@ -174,6 +174,7 @@ CRON_SECRET=your-random-secret                   # For Gateway cron
 
 | Feature | Supported |
 |---------|-----------|
+| Slash Commands | Yes |
 | Mentions | Yes |
 | Reactions (add/remove) | Yes |
 | Cards (Embeds) | Yes |

package/docs/adapters/index.mdx

@@ -28,6 +28,7 @@ Adapters handle webhook verification, message parsing, and API calls for each pl
 | Buttons | ✅ | ✅ | ✅ | ✅ | ⚠️ Inline keyboard callbacks | ❌ | ❌ |
 | Link buttons | ✅ | ✅ | ✅ | ✅ | ⚠️ Inline keyboard URLs | ❌ | ❌ |
 | Select menus | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Tables | ✅ Block Kit | ✅ GFM | ⚠️ ASCII | ✅ GFM | ⚠️ ASCII | ✅ GFM | ✅ GFM |
 | Fields | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | Images in cards | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ |
 | Modals | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
@@ -36,6 +37,7 @@ Adapters handle webhook verification, message parsing, and API calls for each pl
 
 | Feature | Slack | Teams | Google Chat | Discord | Telegram | GitHub | Linear |
 |---------|-------|-------|-------------|---------|----------|--------|--------|
+| Slash commands | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
 | Mentions | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | Add reactions | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | Remove reactions | ✅ | ❌ | ✅ | ✅ | ✅ | ⚠️ | ⚠️ |
@@ -71,6 +73,20 @@ Adapters handle webhook verification, message parsing, and API calls for each pl
 | [GitHub](/docs/adapters/github) | `@chat-adapter/github` |
 | [Linear](/docs/adapters/linear) | `@chat-adapter/linear` |
 
+## Community adapters
+
+Beyond the Vercel-maintained adapters listed above, you can build adapters for any messaging platform. Community adapters use the same `Adapter` interface and get full access to Chat SDK features like cards, actions, streaming, and state management.
+
+| Tier | Description |
+|------|-------------|
+| Vercel-maintained | Published under `@chat-adapter/*` by Vercel |
+| Community official | Built and maintained by the platform company itself (e.g., Resend building a Resend adapter) |
+| Community | Built by third-party developers |
+
+Community adapters are expected to meet the same testing bar as first-party adapters — unit tests for all public methods, integration tests for end-to-end message flows.
+
+Ready to build one? Follow the [building](/docs/contributing/building) guide.
+
 ## How adapters work
 
 Each adapter implements a standard interface that the `Chat` class uses to route events and send messages. When a webhook arrives:

package/docs/adapters/slack.mdx

@@ -139,6 +139,7 @@ settings:
     request_url: https://your-domain.com/api/webhooks/slack
     bot_events:
       - app_mention
+      - member_joined_channel
       - message.channels
       - message.groups
       - message.im
@@ -187,6 +188,7 @@ All options are auto-detected from environment variables when not provided. You
 | `clientId` | No | App client ID for multi-workspace OAuth. Auto-detected from `SLACK_CLIENT_ID` |
 | `clientSecret` | No | App client secret for multi-workspace OAuth. Auto-detected from `SLACK_CLIENT_SECRET` |
 | `encryptionKey` | No | AES-256-GCM key for encrypting stored tokens. Auto-detected from `SLACK_ENCRYPTION_KEY` |
+| `installationKeyPrefix` | No | Prefix for the state key used to store workspace installations. Defaults to `slack:installation`. The full key is `{prefix}:{teamId}` |
 | `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
 
 *`signingSecret` is required — either via config or `SLACK_SIGNING_SECRET` env var.
@@ -218,6 +220,7 @@ SLACK_ENCRYPTION_KEY=...             # Optional, for token encryption
 | Message history | Yes |
 | Assistants API | Yes |
 | App Home tab | Yes |
+| Member joined channel | Yes |
 
 ## Slack Assistants API
 

package/docs/adapters/telegram.mdx

@@ -53,6 +53,60 @@ curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
   }'
 ```
 
+## Polling (local development)
+
+When developing locally you typically can't expose a public URL for Telegram to deliver webhooks to. Polling mode uses `getUpdates` to fetch messages directly from Telegram instead — no public endpoint needed.
+
+The `longPolling` option is entirely optional. Sensible defaults are applied when omitted.
+
+```typescript title="lib/bot.ts" lineNumbers
+import { Chat } from "chat";
+import { createTelegramAdapter } from "@chat-adapter/telegram";
+import { createMemoryState } from "@chat-adapter/state-memory";
+
+const telegram = createTelegramAdapter({
+  mode: "polling",
+  // Optional — fine-tune polling behavior:
+  // longPolling: { timeout: 30, dropPendingUpdates: false },
+});
+
+const bot = new Chat({
+  userName: "mybot",
+  adapters: { telegram },
+  state: createMemoryState(),
+});
+
+// Optional manual lifecycle control:
+// await telegram.resetWebhook();
+// await telegram.startPolling();
+// await telegram.stopPolling();
+```
+
+### Auto mode
+
+With `mode: "auto"` (the default), the adapter picks the right strategy for you. When deployed to a serverless environment like Vercel it uses webhooks; everywhere else (e.g. local dev) it falls back to polling automatically.
+
+```typescript title="lib/bot.ts" lineNumbers
+import { Chat } from "chat";
+import { createTelegramAdapter } from "@chat-adapter/telegram";
+import { createMemoryState } from "@chat-adapter/state-memory";
+
+const telegram = createTelegramAdapter({
+  mode: "auto", // default
+});
+
+export const bot = new Chat({
+  userName: "mybot",
+  adapters: { telegram },
+  state: createMemoryState(),
+});
+
+// Call initialize() so polling can start in long-running local processes:
+void bot.initialize();
+
+console.log(telegram.runtimeMode); // "webhook" | "polling"
+```
+
 ## Configuration
 
 All options are auto-detected from environment variables when not provided.
@@ -61,6 +115,8 @@ All options are auto-detected from environment variables when not provided.
 |--------|----------|-------------|
 | `botToken` | No* | Telegram bot token. Auto-detected from `TELEGRAM_BOT_TOKEN` |
 | `secretToken` | No | Optional webhook secret token. Auto-detected from `TELEGRAM_WEBHOOK_SECRET_TOKEN` |
+| `mode` | No | Adapter mode: `auto` (default), `webhook`, or `polling` |
+| `longPolling` | No | Optional long polling config for `getUpdates` (`timeout`, `limit`, `allowedUpdates`, `deleteWebhook`, `dropPendingUpdates`, `retryDelayMs`) |
 | `userName` | No | Bot username used for mention detection. Auto-detected from `TELEGRAM_BOT_USERNAME` or `getMe` |
 | `apiBaseUrl` | No | Telegram API base URL. Auto-detected from `TELEGRAM_API_BASE_URL` |
 | `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
@@ -96,6 +152,10 @@ TELEGRAM_API_BASE_URL=https://api.telegram.org
 
 - Telegram does not expose full historical message APIs to bots. `fetchMessages` / `fetchChannelMessages` return adapter-cached messages from the current process.
 - `listThreads` is not available for Telegram chats.
+- Polling and webhooks are mutually exclusive in Telegram.
+- `mode: "polling"` deletes webhook by default before calling `getUpdates`.
+- `mode: "auto"` checks `getWebhookInfo`: if a webhook URL exists it uses webhook mode; if it is empty it falls back to polling on non-serverless runtimes without deleting webhook.
+- If `getWebhookInfo` fails in `mode: "auto"`, the adapter stays in webhook mode (safe fallback).
 - `Button` and `LinkButton` in card `Actions` render as inline keyboard buttons.
 - Telegram callback data is limited to 64 bytes. Keep button `id`/`value` payloads short.
 - Other rich card elements (images/select menus/radios) render as fallback text only.

package/docs/api/cards.mdx

@@ -7,7 +7,7 @@ type: reference
 Card components render natively on each platform — Block Kit on Slack, Adaptive Cards on Teams, Embeds on Discord, and Google Chat Cards.
 
 ```typescript
-import { Card, Text, CardLink, Button, Actions, Section, Fields, Field, Divider, Image, LinkButton } from "chat";
+import { Card, Text, CardLink, Button, Actions, Section, Fields, Field, Divider, Image, LinkButton, Table } from "chat";
 ```
 
 All components support both function-call and JSX syntax. Function-call syntax is recommended for better type inference.
@@ -216,6 +216,39 @@ Image({ url: "https://example.com/screenshot.png", alt: "Screenshot" })
   }}
 />
 
+## Table
+
+Structured data display with column headers and rows.
+
+```typescript
+Table({
+  headers: ["Name", "Age", "Role"],
+  rows: [
+    ["Alice", "30", "Engineer"],
+    ["Bob", "25", "Designer"],
+  ],
+})
+```
+
+<TypeTable
+  type={{
+    headers: {
+      description: 'Column header labels.',
+      type: 'string[]',
+    },
+    rows: {
+      description: 'Data rows (each row is an array of cell strings).',
+      type: 'string[][]',
+    },
+    align: {
+      description: 'Column alignment.',
+      type: '"left" | "center" | "right"[]',
+    },
+  }}
+/>
+
+On platforms with native table support (Teams, GitHub, Linear), tables render as formatted tables. On other platforms (Slack, Google Chat, Discord, Telegram), tables render as padded ASCII text.
+
 ## Divider
 
 A visual separator between sections.
@@ -237,3 +270,4 @@ The `children` array in `Card` and `Section` accepts these element types:
 | `ActionsElement` | `Actions()` |
 | `SectionElement` | `Section()` |
 | `FieldsElement` | `Fields()` |
+| `TableElement` | `Table()` |

package/docs/api/channel.mdx

@@ -161,10 +161,13 @@ await channel.postEphemeral(userId, "Only you can see this", {
 
 ## startTyping
 
-Show a typing indicator. No-op on platforms that don't support it.
+Show a typing indicator. No-op on platforms that don't support it. On Slack, you can pass an optional `status` string to show a custom loading message (requires `assistant:write` scope).
 
 ```typescript
 await channel.startTyping();
+
+// With custom status (Slack only)
+await channel.startTyping("Searching documents...");
 ```
 
 ## mentionUser

package/docs/api/chat.mdx

@@ -26,6 +26,11 @@ const bot = new Chat(config);
       description: 'Map of adapter name to adapter instance.',
       type: 'Record<string, Adapter>',
     },
+    dedupeTtlMs: {
+      description: 'TTL for message deduplication entries in milliseconds. Increase if webhook cold starts cause platform retries after the default window.',
+      type: 'number',
+      default: '300000',
+    },
     state: {
       description: 'State adapter for subscriptions, locking, and caching.',
       type: 'StateAdapter',

package/docs/api/markdown.mdx

@@ -11,6 +11,7 @@ import {
   root, paragraph, text, strong, emphasis, strikethrough,
   inlineCode, codeBlock, link, blockquote,
   parseMarkdown, stringifyMarkdown, toPlainText, walkAst,
+  tableToAscii, tableElementToAscii,
 } from "chat";
 ```
 
@@ -204,6 +205,9 @@ Functions for checking node types:
 | `isBlockquoteNode(node)` | Blockquote |
 | `isListNode(node)` | List |
 | `isListItemNode(node)` | List item |
+| `isTableNode(node)` | Table |
+| `isTableRowNode(node)` | Table row |
+| `isTableCellNode(node)` | Table cell |
 
 ### getNodeChildren / getNodeValue
 
@@ -214,6 +218,43 @@ const children = getNodeChildren(node); // Content[] | undefined
 const value = getNodeValue(node);       // string | undefined
 ```
 
+## Table utilities
+
+### tableToAscii
+
+Render an mdast `Table` node as a padded ASCII table string. Used by adapters that lack native table support (Slack, Google Chat, Discord, Telegram).
+
+```typescript
+import { parseMarkdown, tableToAscii, isTableNode } from "chat";
+
+const ast = parseMarkdown("| Name | Role |\n|------|------|\n| Alice | Engineer |");
+// Find the table node and convert it
+```
+
+Output:
+
+```
+Name  | Role
+------|--------
+Alice | Engineer
+```
+
+### tableElementToAscii
+
+Render a table from headers and string row arrays as a padded ASCII table. Used for card `TableElement` fallback rendering.
+
+```typescript
+import { tableElementToAscii } from "chat";
+
+const ascii = tableElementToAscii(
+  ["Name", "Age", "Role"],
+  [
+    ["Alice", "30", "Engineer"],
+    ["Bob", "25", "Designer"],
+  ]
+);
+```
+
 ## Platform formatting
 
 The SDK uses mdast as the canonical format and each adapter converts it to the platform's native syntax. You write standard markdown and the SDK handles the translation — but it helps to know how each platform renders common formatting.
@@ -228,6 +269,7 @@ The SDK uses mdast as the canonical format and each adapter converts it to the p
 | Links | `<url\|text>` | `[text](url)` | `[text](url)` |
 | Lists | Supported | Supported | Supported |
 | Blockquotes | `>` | `>` | Simulated with `>` prefix |
+| Tables | ASCII fallback | Native GFM | ASCII fallback |
 | Mentions | `<@USER>` | `<at>name</at>` | `<users/{id}>` |
 
 <Callout type="info">

package/docs/api/postable-message.mdx

@@ -7,7 +7,7 @@ type: reference
 `PostableMessage` is the union of all message formats accepted by `thread.post()` and `sent.edit()`.
 
 ```typescript
-type PostableMessage = AdapterPostableMessage | AsyncIterable<string>;
+type PostableMessage = AdapterPostableMessage | AsyncIterable<string | StreamChunk | StreamEvent>;
 ```
 
 ## String
@@ -135,15 +135,23 @@ await thread.post({
 
 ## AsyncIterable (streaming)
 
-An async iterable of strings, like the AI SDK's `textStream`. The SDK streams the message in real time using platform-native APIs where available.
+An async iterable of strings, `StreamChunk` objects, or stream events. The SDK streams the message in real time using platform-native APIs where available.
+
+You can yield structured `StreamChunk` objects for rich content like task progress cards on platforms that support it (Slack). See [Streaming](/docs/streaming#structured-streaming-chunks-slack-only) for details.
+
+Both AI SDK stream types are supported:
 
 ```typescript
-import { streamText } from "ai";
+// fullStream (recommended) — preserves step boundaries in multi-step agents
+const result = await agent.stream({ prompt: message.text });
+await thread.post(result.fullStream);
 
-const result = streamText({ model, prompt: message.text });
+// textStream — plain string chunks
 await thread.post(result.textStream);
 ```
 
+When using `fullStream`, the SDK auto-detects `text-delta` and `step-finish` events, extracting text and inserting paragraph breaks between agent steps.
+
 ## FileUpload
 
 Used in the `files` field of any structured message format.

package/docs/api/thread.mdx

@@ -54,8 +54,8 @@ await thread.post({ ast: root([paragraph([text("Hello")])]) });
 // Card
 await thread.post(Card({ title: "Hi", children: [Text("Hello")] }));
 
-// Stream
-await thread.post(result.textStream);
+// Stream (fullStream recommended for multi-step agents)
+await thread.post(result.fullStream);
 ```
 
 **Parameters:** `message: string | PostableMessage | CardJSXElement`
@@ -122,10 +122,13 @@ await thread.setState({ aiMode: false }, { replace: true });
 
 ## startTyping
 
-Show a typing indicator in the thread. No-op on platforms that don't support it.
+Show a typing indicator in the thread. No-op on platforms that don't support it. On Slack, you can pass an optional `status` string to show a custom loading message (requires `assistant:write` scope).
 
 ```typescript
 await thread.startTyping();
+
+// With custom status (Slack only)
+await thread.startTyping("Searching documents...");
 ```
 
 ## messages / allMessages

package/docs/cards.mdx

@@ -177,6 +177,30 @@ Radio button group for mutually exclusive choices.
 </Actions>
 ```
 
+### Table
+
+Structured data display with column headers and rows. Renders as a native table on platforms that support it (Teams, GitHub, Linear) and as padded ASCII text elsewhere.
+
+```tsx title="lib/bot.tsx" lineNumbers
+<Table
+  headers={["Name", "Age", "Role"]}
+  rows={[
+    ["Alice", "30", "Engineer"],
+    ["Bob", "25", "Designer"],
+  ]}
+/>
+```
+
+Optional column alignment:
+
+```tsx title="lib/bot.tsx"
+<Table
+  headers={["Name", "Amount"]}
+  rows={[["Alice", "$100"], ["Bob", "$200"]]}
+  align={["left", "right"]}
+/>
+```
+
 ### Image
 
 Embeds an image in the card.