chat-adapter-twitter 0.1.0

package/README.md

@@ -0,0 +1,94 @@
+# chat-adapter-twitter
+
+[![npm version](https://img.shields.io/npm/v/chat-adapter-twitter)](https://www.npmjs.com/package/chat-adapter-twitter)
+[![npm downloads](https://img.shields.io/npm/dm/chat-adapter-twitter)](https://www.npmjs.com/package/chat-adapter-twitter)
+
+Twitter / X Webhooks adapter for [Chat SDK](https://chat-sdk.dev/docs).
+
+This adapter uses the **X Account Activity API** (Enterprise/Pro tier required) to receive Direct Messages in real-time and the **X API v2** to send responses.
+
+## Installation
+
+```bash
+npm install chat chat-adapter-twitter
+```
+
+## Usage
+
+```typescript
+import { Chat } from "chat";
+import { createTwitterAdapter } from "chat-adapter-twitter";
+import { createMemoryState } from "@chat-adapter/state-memory";
+
+const bot = new Chat({
+  userName: "my_twitter_bot",
+  adapters: {
+    twitter: createTwitterAdapter({
+      consumerKey: process.env.TWITTER_CONSUMER_KEY!,
+      consumerSecret: process.env.TWITTER_CONSUMER_SECRET!,
+      accessToken: process.env.TWITTER_ACCESS_TOKEN!,
+      accessTokenSecret: process.env.TWITTER_ACCESS_TOKEN_SECRET!,
+      bearerToken: process.env.TWITTER_BEARER_TOKEN!,
+    }),
+  },
+  state: createMemoryState(), // Required for deduping
+});
+
+// Twitter DMs are treated as standard messages (not mentions)
+bot.onNewMessage(async (thread, message) => {
+  await thread.post(`Echo: ${message.text}`);
+});
+```
+
+## Environment variables
+
+If you don't pass options into `createTwitterAdapter()`, it will automatically read from these environment variables:
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `TWITTER_CONSUMER_KEY` | Yes | App API Key |
+| `TWITTER_CONSUMER_SECRET` | Yes | App API Secret |
+| `TWITTER_ACCESS_TOKEN` | Yes | Bot account access token |
+| `TWITTER_ACCESS_TOKEN_SECRET` | Yes | Bot account access token secret |
+| `TWITTER_BEARER_TOKEN` | Yes | App Bearer token (for v2 read endpoints) |
+| `TWITTER_BOT_USERNAME` | No | Override the bot display name |
+| `TWITTER_WEBHOOK_ENV` | No | Account Activity environment name (default: "production") |
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `consumerKey` | `string` | `process.env.TWITTER_CONSUMER_KEY` | App API Key |
+| `consumerSecret` | `string` | `process.env.TWITTER_CONSUMER_SECRET` | App API Secret for CRC hashing |
+| `accessToken` | `string` | `process.env.TWITTER_ACCESS_TOKEN` | Bot account access token |
+| `accessTokenSecret` | `string` | `process.env.TWITTER_ACCESS_TOKEN_SECRET` | Bot account access token secret |
+| `bearerToken` | `string` | `process.env.TWITTER_BEARER_TOKEN` | App Bearer token |
+| `userName` | `string` | `process.env.TWITTER_BOT_USERNAME` | Bot display name |
+| `apiBaseUrl` | `string` | `"https://api.twitter.com"` | Override domain for testing |
+
+## Platform setup
+
+1. Create a project in the [X Developer Portal](https://developer.x.com).
+2. Generate your **Consumer Key**, **Consumer Secret**, and **Bearer Token**.
+3. Set up **OAuth 1.0a User Authentication** in your app settings with Read/Write/Direct Messages permissions.
+4. Generate the **Access Token** and **Access Token Secret** for your bot account.
+5. Apply for the **Account Activity API** (requires Pro or Enterprise access).
+6. Start your server so the webhook endpoint is active.
+7. Register your webhook URL and subscribe your bot account using the Account Activity API.
+
+## Features
+
+- **Direct Messages**: Receive and reply to 1-1 DMs
+- **CRC Hashing**: Automatically responds to Twitter's Challenge-Response Checks
+- **Media Attachments**: Extracts image and video URLs from incoming DMs
+- **Plain Text Rendering**: Automatically converts markdown AST to plain text (with ASCII tables) since Twitter DMs don't support rich formatting
+
+### Limitations
+- **No Message Editing**: The Twitter API does not support editing DMs. `editMessage` throws `NotImplementedError`.
+- **Typing Indicators**: The X API doesn't support bot typing indicators.
+- **Rate Limits**: The DM API is subject to X's strict rate limits.
+- **Premium Tier Requirement**: Requires Account Activity API access, which is not available on free or basic tiers.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,327 @@
+import { Logger, BaseFormatConverter, Root, AdapterPostableMessage, Adapter, ChatInstance, WebhookOptions, RawMessage, EmojiValue, FetchOptions, FetchResult, ThreadInfo, Message, FormattedContent } from 'chat';
+
+/**
+ * Twitter / X adapter types.
+ */
+
+/**
+ * Twitter adapter configuration.
+ */
+interface TwitterAdapterConfig {
+    /**
+     * Twitter API v2 Bearer Token for read-only endpoints.
+     * Defaults to TWITTER_BEARER_TOKEN env var.
+     */
+    bearerToken?: string;
+    /**
+     * Twitter API consumer key (API Key).
+     * Used for OAuth 1.0a signing and CRC validation.
+     * Defaults to TWITTER_CONSUMER_KEY env var.
+     */
+    consumerKey?: string;
+    /**
+     * Twitter API consumer secret (API Secret).
+     * Used for CRC HMAC-SHA256 computation.
+     * Defaults to TWITTER_CONSUMER_SECRET env var.
+     */
+    consumerSecret?: string;
+    /**
+     * OAuth 1.0a access token for the bot account.
+     * Defaults to TWITTER_ACCESS_TOKEN env var.
+     */
+    accessToken?: string;
+    /**
+     * OAuth 1.0a access token secret for the bot account.
+     * Defaults to TWITTER_ACCESS_TOKEN_SECRET env var.
+     */
+    accessTokenSecret?: string;
+    /** Logger instance for error reporting. Defaults to ConsoleLogger. */
+    logger?: Logger;
+    /** Override bot username (optional). Defaults to TWITTER_BOT_USERNAME env var. */
+    userName?: string;
+    /**
+     * Optional custom API base URL (defaults to https://api.twitter.com).
+     * Useful for testing with a mock server.
+     */
+    apiBaseUrl?: string;
+    /**
+     * Optional webhook environment name for Account Activity API.
+     * Defaults to TWITTER_WEBHOOK_ENV env var or "production".
+     */
+    webhookEnvironment?: string;
+}
+/**
+ * Twitter thread ID components.
+ * A "thread" in Twitter maps to a DM conversation.
+ */
+interface TwitterThreadId {
+    /** DM conversation ID */
+    conversationId: string;
+}
+/**
+ * Twitter user object from the Account Activity API webhook payload.
+ */
+interface TwitterUser {
+    id: string;
+    created_timestamp: string;
+    name: string;
+    screen_name: string;
+    location?: string;
+    description?: string;
+    url?: string;
+    protected: boolean;
+    verified: boolean;
+    followers_count: number;
+    friends_count: number;
+    statuses_count: number;
+    profile_image_url_https?: string;
+}
+/**
+ * Twitter DM event message data.
+ */
+interface TwitterMessageData {
+    text: string;
+    entities?: {
+        hashtags: TwitterEntity[];
+        symbols: TwitterEntity[];
+        user_mentions: TwitterMentionEntity[];
+        urls: TwitterUrlEntity[];
+    };
+    attachment?: {
+        type: string;
+        media: TwitterMedia;
+    };
+}
+interface TwitterEntity {
+    text?: string;
+    indices: [number, number];
+}
+interface TwitterMentionEntity extends TwitterEntity {
+    id: number;
+    id_str: string;
+    name: string;
+    screen_name: string;
+}
+interface TwitterUrlEntity extends TwitterEntity {
+    url: string;
+    expanded_url: string;
+    display_url: string;
+}
+interface TwitterMedia {
+    id: number;
+    id_str: string;
+    media_url: string;
+    media_url_https: string;
+    type: string;
+    sizes?: Record<string, {
+        w: number;
+        h: number;
+        resize: string;
+    }>;
+}
+/**
+ * A single DM event within the Account Activity webhook payload.
+ */
+interface TwitterDirectMessageEvent {
+    type: "message_create";
+    id: string;
+    created_timestamp: string;
+    message_create: {
+        target: {
+            recipient_id: string;
+        };
+        sender_id: string;
+        source_app_id?: string;
+        message_data: TwitterMessageData;
+    };
+}
+/**
+ * Twitter API v2 DM event from GET /2/direct_messages/events.
+ */
+interface TwitterDMEventV2 {
+    id: string;
+    event_type: "MessageCreate" | "ParticipantsJoin" | "ParticipantsLeave";
+    text: string;
+    dm_conversation_id?: string;
+    created_at?: string;
+    sender_id?: string;
+    participant_ids?: string[];
+    attachments?: {
+        media_keys?: string[];
+    };
+    referenced_tweets?: Array<{
+        id: string;
+        type: string;
+    }>;
+}
+/**
+ * Response envelope for Twitter API v2 DM send.
+ */
+interface TwitterDMSendResponse {
+    dm_conversation_id: string;
+    dm_event_id: string;
+}
+/**
+ * Twitter API v2 user object.
+ */
+interface TwitterUserV2 {
+    id: string;
+    name: string;
+    username: string;
+    profile_image_url?: string;
+    verified?: boolean;
+}
+/**
+ * Full webhook payload from Account Activity API.
+ * Can contain DM events, tweet events, follow events, etc.
+ * We focus on DM events for the adapter.
+ */
+interface TwitterAccountActivityPayload {
+    for_user_id: string;
+    direct_message_events?: TwitterDirectMessageEvent[];
+    users?: Record<string, TwitterUser>;
+    apps?: Record<string, {
+        id: string;
+        name: string;
+        url: string;
+    }>;
+    tweet_create_events?: unknown[];
+    favorite_events?: unknown[];
+    follow_events?: unknown[];
+    block_events?: unknown[];
+    mute_events?: unknown[];
+}
+/**
+ * Raw message type for the Twitter adapter.
+ * This is the DM event as received from the webhook.
+ */
+type TwitterRawMessage = TwitterDirectMessageEvent;
+
+/**
+ * Twitter / X format conversion.
+ *
+ * Twitter DMs use plain text with entity annotations (similar to Telegram).
+ * For outbound messages, we send plain text since the DM API doesn't
+ * support rich formatting (bold/italic/etc.) natively.
+ */
+
+declare class TwitterFormatConverter extends BaseFormatConverter {
+    /**
+     * Convert platform text to mdast AST.
+     * Twitter DMs are plain text — we parse as if they were markdown
+     * so that any user-typed markdown is preserved in the AST.
+     */
+    toAst(text: string): Root;
+    /**
+     * Convert mdast AST to platform text format.
+     * Twitter DMs don't support rich formatting, so we try to
+     * produce readable plain text. Tables get converted to ASCII art.
+     */
+    fromAst(ast: Root): string;
+    renderPostable(message: AdapterPostableMessage): string;
+}
+
+declare class TwitterAdapter implements Adapter<TwitterThreadId, TwitterRawMessage> {
+    readonly name = "twitter";
+    readonly persistMessageHistory = true;
+    private readonly consumerKey;
+    private readonly consumerSecret;
+    private readonly accessToken;
+    private readonly accessTokenSecret;
+    private readonly bearerToken;
+    private readonly apiBaseUrl;
+    private readonly webhookEnvironment;
+    private readonly logger;
+    private readonly formatConverter;
+    private readonly messageCache;
+    private chat;
+    private _botUserId?;
+    private _userName;
+    private readonly hasExplicitUserName;
+    get botUserId(): string | undefined;
+    get userName(): string;
+    constructor(config?: TwitterAdapterConfig);
+    initialize(chat: ChatInstance): Promise<void>;
+    /**
+     * Handle incoming webhook requests from the X Account Activity API.
+     *
+     * GET requests are CRC challenges — we respond with the HMAC-SHA256 hash.
+     * POST requests are webhook events (DMs, tweets, etc.).
+     */
+    handleWebhook(request: Request, options?: WebhookOptions): Promise<Response>;
+    /**
+     * Handle CRC challenge from the X Account Activity API.
+     * Responds with HMAC-SHA256 hash of the crc_token using consumer secret.
+     */
+    private handleCrcChallenge;
+    /**
+     * Process DM events from the Account Activity webhook payload.
+     */
+    private processDMEvents;
+    /**
+     * Derive a deterministic conversation ID from two user IDs.
+     * Twitter's 1:1 DM conversation IDs are formed by sorting the two user
+     * IDs and joining them. For simplicity, we use the smaller ID first.
+     */
+    private deriveConversationId;
+    /**
+     * Parse a Twitter DM event into a normalized Message.
+     */
+    private parseDMEvent;
+    /**
+     * Extract attachments from a DM event.
+     */
+    private extractAttachments;
+    /**
+     * Check if the bot is mentioned in the text.
+     */
+    private checkMention;
+    postMessage(threadId: string, message: AdapterPostableMessage): Promise<RawMessage<TwitterRawMessage>>;
+    editMessage(_threadId: string, _messageId: string, _message: AdapterPostableMessage): Promise<RawMessage<TwitterRawMessage>>;
+    deleteMessage(_threadId: string, messageId: string): Promise<void>;
+    addReaction(_threadId: string, _messageId: string, _emoji: EmojiValue | string): Promise<void>;
+    removeReaction(_threadId: string, _messageId: string, _emoji: EmojiValue | string): Promise<void>;
+    startTyping(_threadId: string): Promise<void>;
+    fetchMessages(threadId: string, options?: FetchOptions): Promise<FetchResult<TwitterRawMessage>>;
+    fetchThread(threadId: string): Promise<ThreadInfo>;
+    channelIdFromThreadId(threadId: string): string;
+    openDM(userId: string): Promise<string>;
+    isDM(_threadId: string): boolean;
+    encodeThreadId(platformData: TwitterThreadId): string;
+    decodeThreadId(threadId: string): TwitterThreadId;
+    parseMessage(raw: TwitterRawMessage): Message<TwitterRawMessage>;
+    renderFormatted(content: FormattedContent): string;
+    private resolveThreadId;
+    /**
+     * Get the recipient user ID from a conversation ID.
+     * Conversation IDs are in the format `{smallerId}-{largerId}`.
+     * The recipient is the ID that is NOT the bot's.
+     */
+    private getRecipientFromConversation;
+    /**
+     * Send a DM via the Twitter API v2.
+     */
+    private sendDM;
+    /**
+     * Make an authenticated API call using OAuth 1.0a.
+     */
+    private twitterFetchOAuth;
+    /**
+     * Make an authenticated API call using Bearer Token (API v2 read endpoints).
+     */
+    private twitterFetchV2;
+    /**
+     * Map HTTP status codes to appropriate error classes.
+     */
+    private throwTwitterApiError;
+    private truncateMessage;
+    private escapeRegex;
+    private cacheMessage;
+    private findCachedMessage;
+    private deleteCachedMessage;
+    private compareMessages;
+    private paginateMessages;
+}
+declare function createTwitterAdapter(config?: TwitterAdapterConfig): TwitterAdapter;
+
+export { type TwitterAccountActivityPayload, TwitterAdapter, type TwitterAdapterConfig, type TwitterDMEventV2, type TwitterDMSendResponse, type TwitterDirectMessageEvent, TwitterFormatConverter, type TwitterRawMessage, type TwitterThreadId, type TwitterUser, type TwitterUserV2, createTwitterAdapter };

package/dist/index.js

@@ -0,0 +1,789 @@
+// src/index.ts
+import {
+  AdapterRateLimitError,
+  AuthenticationError,
+  cardToFallbackText,
+  extractCard,
+  NetworkError,
+  PermissionError,
+  ResourceNotFoundError,
+  ValidationError
+} from "@chat-adapter/shared";
+import { ConsoleLogger, Message, NotImplementedError } from "chat";
+
+// src/markdown.ts
+import {
+  BaseFormatConverter,
+  isTableNode,
+  parseMarkdown,
+  stringifyMarkdown,
+  tableToAscii,
+  walkAst
+} from "chat";
+var TwitterFormatConverter = class extends BaseFormatConverter {
+  /**
+   * Convert platform text to mdast AST.
+   * Twitter DMs are plain text — we parse as if they were markdown
+   * so that any user-typed markdown is preserved in the AST.
+   */
+  toAst(text) {
+    return parseMarkdown(text);
+  }
+  /**
+   * Convert mdast AST to platform text format.
+   * Twitter DMs don't support rich formatting, so we try to
+   * produce readable plain text. Tables get converted to ASCII art.
+   */
+  fromAst(ast) {
+    const transformed = walkAst(structuredClone(ast), (node) => {
+      if (isTableNode(node)) {
+        return {
+          type: "code",
+          value: tableToAscii(node),
+          lang: void 0
+        };
+      }
+      return node;
+    });
+    return stringifyMarkdown(transformed).trim();
+  }
+  renderPostable(message) {
+    if (typeof message === "string") {
+      return message;
+    }
+    if ("raw" in message) {
+      return message.raw;
+    }
+    if ("markdown" in message) {
+      return this.fromMarkdown(message.markdown);
+    }
+    if ("ast" in message) {
+      return this.fromAst(message.ast);
+    }
+    return super.renderPostable(message);
+  }
+};
+
+// src/index.ts
+var TWITTER_API_BASE = "https://api.twitter.com";
+var TWITTER_DM_MESSAGE_LIMIT = 1e4;
+var CRC_TOKEN_PARAM = "crc_token";
+async function computeHmacSha256(key, message) {
+  const encoder = new TextEncoder();
+  const keyData = encoder.encode(key);
+  const messageData = encoder.encode(message);
+  const cryptoKey = await crypto.subtle.importKey(
+    "raw",
+    keyData,
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const signature = await crypto.subtle.sign("HMAC", cryptoKey, messageData);
+  return btoa(String.fromCharCode(...new Uint8Array(signature)));
+}
+async function generateOAuth1Header(params) {
+  const {
+    method,
+    url,
+    consumerKey,
+    consumerSecret,
+    accessToken,
+    accessTokenSecret,
+    additionalParams
+  } = params;
+  const timestamp = Math.floor(Date.now() / 1e3).toString();
+  const nonce = crypto.randomUUID().replace(/-/g, "");
+  const oauthParams = {
+    oauth_consumer_key: consumerKey,
+    oauth_nonce: nonce,
+    oauth_signature_method: "HMAC-SHA1",
+    oauth_timestamp: timestamp,
+    oauth_token: accessToken,
+    oauth_version: "1.0",
+    ...additionalParams
+  };
+  const parsedUrl = new URL(url);
+  for (const [key, value] of parsedUrl.searchParams.entries()) {
+    oauthParams[key] = value;
+  }
+  const sortedParams = Object.entries(oauthParams).sort(([a], [b]) => a.localeCompare(b)).map(
+    ([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`
+  ).join("&");
+  const baseUrl = `${parsedUrl.origin}${parsedUrl.pathname}`;
+  const signatureBase = `${method.toUpperCase()}&${encodeURIComponent(baseUrl)}&${encodeURIComponent(sortedParams)}`;
+  const signingKey = `${encodeURIComponent(consumerSecret)}&${encodeURIComponent(accessTokenSecret)}`;
+  const encoder = new TextEncoder();
+  const keyData = encoder.encode(signingKey);
+  const messageData = encoder.encode(signatureBase);
+  const cryptoKey = await crypto.subtle.importKey(
+    "raw",
+    keyData,
+    { name: "HMAC", hash: "SHA-1" },
+    false,
+    ["sign"]
+  );
+  const signature = await crypto.subtle.sign("HMAC", cryptoKey, messageData);
+  const signatureBase64 = btoa(
+    String.fromCharCode(...new Uint8Array(signature))
+  );
+  const authParams = {
+    oauth_consumer_key: consumerKey,
+    oauth_nonce: nonce,
+    oauth_signature: signatureBase64,
+    oauth_signature_method: "HMAC-SHA1",
+    oauth_timestamp: timestamp,
+    oauth_token: accessToken,
+    oauth_version: "1.0"
+  };
+  const authHeader = Object.entries(authParams).sort(([a], [b]) => a.localeCompare(b)).map(
+    ([key, value]) => `${encodeURIComponent(key)}="${encodeURIComponent(value)}"`
+  ).join(", ");
+  return `OAuth ${authHeader}`;
+}
+var TwitterAdapter = class {
+  name = "twitter";
+  persistMessageHistory = true;
+  consumerKey;
+  consumerSecret;
+  accessToken;
+  accessTokenSecret;
+  bearerToken;
+  apiBaseUrl;
+  webhookEnvironment;
+  logger;
+  formatConverter = new TwitterFormatConverter();
+  messageCache = /* @__PURE__ */ new Map();
+  chat = null;
+  _botUserId;
+  _userName;
+  hasExplicitUserName;
+  get botUserId() {
+    return this._botUserId;
+  }
+  get userName() {
+    return this._userName;
+  }
+  constructor(config = {}) {
+    const consumerKey = config.consumerKey ?? process.env.TWITTER_CONSUMER_KEY;
+    const consumerSecret = config.consumerSecret ?? process.env.TWITTER_CONSUMER_SECRET;
+    const accessToken = config.accessToken ?? process.env.TWITTER_ACCESS_TOKEN;
+    const accessTokenSecret = config.accessTokenSecret ?? process.env.TWITTER_ACCESS_TOKEN_SECRET;
+    const bearerToken = config.bearerToken ?? process.env.TWITTER_BEARER_TOKEN;
+    if (!consumerKey) {
+      throw new ValidationError(
+        "twitter",
+        "Consumer key is required. Set TWITTER_CONSUMER_KEY or provide it in config."
+      );
+    }
+    if (!consumerSecret) {
+      throw new ValidationError(
+        "twitter",
+        "Consumer secret is required. Set TWITTER_CONSUMER_SECRET or provide it in config."
+      );
+    }
+    if (!accessToken) {
+      throw new ValidationError(
+        "twitter",
+        "Access token is required. Set TWITTER_ACCESS_TOKEN or provide it in config."
+      );
+    }
+    if (!accessTokenSecret) {
+      throw new ValidationError(
+        "twitter",
+        "Access token secret is required. Set TWITTER_ACCESS_TOKEN_SECRET or provide it in config."
+      );
+    }
+    if (!bearerToken) {
+      throw new ValidationError(
+        "twitter",
+        "Bearer token is required. Set TWITTER_BEARER_TOKEN or provide it in config."
+      );
+    }
+    this.consumerKey = consumerKey;
+    this.consumerSecret = consumerSecret;
+    this.accessToken = accessToken;
+    this.accessTokenSecret = accessTokenSecret;
+    this.bearerToken = bearerToken;
+    this.apiBaseUrl = (config.apiBaseUrl ?? process.env.TWITTER_API_BASE_URL ?? TWITTER_API_BASE).replace(/\/+$/, "");
+    this.webhookEnvironment = config.webhookEnvironment ?? process.env.TWITTER_WEBHOOK_ENV ?? "production";
+    this.logger = config.logger ?? new ConsoleLogger("info").child("twitter");
+    const userName = config.userName ?? process.env.TWITTER_BOT_USERNAME;
+    this._userName = userName ?? "bot";
+    this.hasExplicitUserName = Boolean(userName);
+  }
+  async initialize(chat) {
+    this.chat = chat;
+    if (!this.hasExplicitUserName) {
+      const chatUserName = chat.getUserName?.();
+      if (typeof chatUserName === "string" && chatUserName.trim()) {
+        this._userName = chatUserName;
+      }
+    }
+    try {
+      const me = await this.twitterFetchV2(
+        "/2/users/me",
+        "GET"
+      );
+      if (me) {
+        this._botUserId = me.id;
+        if (!this.hasExplicitUserName && me.username) {
+          this._userName = me.username;
+        }
+      }
+      this.logger.info("Twitter adapter initialized", {
+        botUserId: this._botUserId,
+        userName: this._userName
+      });
+    } catch (error) {
+      this.logger.warn("Failed to fetch Twitter bot identity", {
+        error: String(error)
+      });
+    }
+  }
+  /**
+   * Handle incoming webhook requests from the X Account Activity API.
+   *
+   * GET requests are CRC challenges — we respond with the HMAC-SHA256 hash.
+   * POST requests are webhook events (DMs, tweets, etc.).
+   */
+  async handleWebhook(request, options) {
+    if (request.method === "GET") {
+      return this.handleCrcChallenge(request);
+    }
+    const body = await request.text();
+    let payload;
+    try {
+      payload = JSON.parse(body);
+    } catch {
+      return new Response("Invalid JSON", { status: 400 });
+    }
+    if (!this.chat) {
+      this.logger.warn(
+        "Chat instance not initialized, ignoring Twitter webhook"
+      );
+      return new Response("OK", { status: 200 });
+    }
+    try {
+      this.processDMEvents(payload, options);
+    } catch (error) {
+      this.logger.warn("Failed to process Twitter webhook payload", {
+        error: String(error),
+        forUserId: payload.for_user_id
+      });
+    }
+    return new Response("OK", { status: 200 });
+  }
+  /**
+   * Handle CRC challenge from the X Account Activity API.
+   * Responds with HMAC-SHA256 hash of the crc_token using consumer secret.
+   */
+  async handleCrcChallenge(request) {
+    const url = new URL(request.url);
+    const crcToken = url.searchParams.get(CRC_TOKEN_PARAM);
+    if (!crcToken) {
+      return new Response("Missing crc_token parameter", { status: 400 });
+    }
+    const responseToken = await computeHmacSha256(
+      this.consumerSecret,
+      crcToken
+    );
+    return new Response(
+      JSON.stringify({
+        response_token: `sha256=${responseToken}`
+      }),
+      {
+        status: 200,
+        headers: { "Content-Type": "application/json" }
+      }
+    );
+  }
+  /**
+   * Process DM events from the Account Activity webhook payload.
+   */
+  processDMEvents(payload, options) {
+    if (!this.chat || !payload.direct_message_events) {
+      return;
+    }
+    for (const dmEvent of payload.direct_message_events) {
+      if (dmEvent.type !== "message_create") {
+        continue;
+      }
+      const senderId = dmEvent.message_create.sender_id;
+      if (senderId === this._botUserId) {
+        continue;
+      }
+      if (senderId === payload.for_user_id && senderId === this._botUserId) {
+        continue;
+      }
+      if (this._botUserId && payload.for_user_id !== this._botUserId) {
+        continue;
+      }
+      const recipientId = dmEvent.message_create.target.recipient_id;
+      const conversationId = this.deriveConversationId(senderId, recipientId);
+      const threadId = this.encodeThreadId({ conversationId });
+      const parsedMessage = this.parseDMEvent(
+        dmEvent,
+        threadId,
+        payload.users
+      );
+      this.cacheMessage(parsedMessage);
+      this.chat.processMessage(this, threadId, parsedMessage, options);
+    }
+  }
+  /**
+   * Derive a deterministic conversation ID from two user IDs.
+   * Twitter's 1:1 DM conversation IDs are formed by sorting the two user
+   * IDs and joining them. For simplicity, we use the smaller ID first.
+   */
+  deriveConversationId(userId1, userId2) {
+    const ids = [userId1, userId2].sort();
+    return `${ids[0]}-${ids[1]}`;
+  }
+  /**
+   * Parse a Twitter DM event into a normalized Message.
+   */
+  parseDMEvent(dmEvent, threadId, users) {
+    const senderId = dmEvent.message_create.sender_id;
+    const text = dmEvent.message_create.message_data.text;
+    const user = users?.[senderId];
+    const author = {
+      userId: senderId,
+      userName: user?.screen_name ?? senderId,
+      fullName: user?.name ?? user?.screen_name ?? senderId,
+      isBot: senderId === this._botUserId,
+      isMe: senderId === this._botUserId
+    };
+    const attachments = this.extractAttachments(dmEvent);
+    const isMention = this.checkMention(text);
+    return new Message({
+      id: dmEvent.id,
+      threadId,
+      text,
+      formatted: this.formatConverter.toAst(text),
+      raw: dmEvent,
+      author,
+      metadata: {
+        dateSent: new Date(Number.parseInt(dmEvent.created_timestamp, 10)),
+        edited: false
+      },
+      attachments,
+      isMention
+    });
+  }
+  /**
+   * Extract attachments from a DM event.
+   */
+  extractAttachments(dmEvent) {
+    const attachments = [];
+    const attachment = dmEvent.message_create.message_data.attachment;
+    if (attachment?.media) {
+      const media = attachment.media;
+      const type = media.type === "video" ? "video" : "image";
+      const largestSize = media.sizes ? Object.values(media.sizes).reduce(
+        (acc, size) => size.w * size.h > (acc?.w ?? 0) * (acc?.h ?? 0) ? size : acc,
+        void 0
+      ) : void 0;
+      attachments.push({
+        type,
+        url: media.media_url_https,
+        width: largestSize?.w,
+        height: largestSize?.h
+      });
+    }
+    return attachments;
+  }
+  /**
+   * Check if the bot is mentioned in the text.
+   */
+  checkMention(text) {
+    if (!text || !this._userName) {
+      return false;
+    }
+    const mentionPattern = new RegExp(
+      `@${this.escapeRegex(this._userName)}\\b`,
+      "i"
+    );
+    return mentionPattern.test(text);
+  }
+  async postMessage(threadId, message) {
+    const { conversationId } = this.resolveThreadId(threadId);
+    const card = extractCard(message);
+    const text = this.truncateMessage(
+      card ? cardToFallbackText(card) : this.formatConverter.renderPostable(message)
+    );
+    if (!text.trim()) {
+      throw new ValidationError("twitter", "Message text cannot be empty");
+    }
+    const recipientId = this.getRecipientFromConversation(conversationId);
+    const response = await this.sendDM(recipientId, text);
+    const syntheticEvent = {
+      type: "message_create",
+      id: response.dm_event_id,
+      created_timestamp: String(Date.now()),
+      message_create: {
+        target: { recipient_id: recipientId },
+        sender_id: this._botUserId ?? "",
+        message_data: { text }
+      }
+    };
+    const resultThreadId = this.encodeThreadId({
+      conversationId: response.dm_conversation_id
+    });
+    const parsedMessage = new Message({
+      id: response.dm_event_id,
+      threadId: resultThreadId,
+      text,
+      formatted: this.formatConverter.toAst(text),
+      raw: syntheticEvent,
+      author: {
+        userId: this._botUserId ?? "",
+        userName: this._userName,
+        fullName: this._userName,
+        isBot: true,
+        isMe: true
+      },
+      metadata: {
+        dateSent: /* @__PURE__ */ new Date(),
+        edited: false
+      },
+      attachments: []
+    });
+    this.cacheMessage(parsedMessage);
+    return {
+      id: parsedMessage.id,
+      threadId: parsedMessage.threadId,
+      raw: syntheticEvent
+    };
+  }
+  async editMessage(_threadId, _messageId, _message) {
+    throw new NotImplementedError(
+      "Twitter DMs cannot be edited after sending",
+      "editMessage"
+    );
+  }
+  async deleteMessage(_threadId, messageId) {
+    await this.twitterFetchOAuth(
+      `/2/dm_conversations/events/${messageId}`,
+      "DELETE"
+    );
+    this.deleteCachedMessage(messageId);
+  }
+  async addReaction(_threadId, _messageId, _emoji) {
+    this.logger.warn(
+      "Twitter DM reactions via API are not fully supported"
+    );
+  }
+  async removeReaction(_threadId, _messageId, _emoji) {
+    this.logger.warn(
+      "Twitter DM reaction removal via API is not fully supported"
+    );
+  }
+  async startTyping(_threadId) {
+  }
+  async fetchMessages(threadId, options = {}) {
+    const messages = [
+      ...this.messageCache.get(threadId) ?? []
+    ].sort((a, b) => this.compareMessages(a, b));
+    return this.paginateMessages(messages, options);
+  }
+  async fetchThread(threadId) {
+    const { conversationId } = this.resolveThreadId(threadId);
+    return {
+      id: threadId,
+      channelId: conversationId,
+      isDM: true,
+      metadata: {
+        conversationId
+      }
+    };
+  }
+  channelIdFromThreadId(threadId) {
+    const { conversationId } = this.resolveThreadId(threadId);
+    return `twitter:${conversationId}`;
+  }
+  async openDM(userId) {
+    if (!this._botUserId) {
+      throw new ValidationError(
+        "twitter",
+        "Bot user ID is not available. Ensure the adapter is initialized."
+      );
+    }
+    const conversationId = this.deriveConversationId(
+      this._botUserId,
+      userId
+    );
+    return this.encodeThreadId({ conversationId });
+  }
+  isDM(_threadId) {
+    return true;
+  }
+  encodeThreadId(platformData) {
+    return `twitter:${platformData.conversationId}`;
+  }
+  decodeThreadId(threadId) {
+    const parts = threadId.split(":");
+    if (parts[0] !== "twitter" || parts.length !== 2) {
+      throw new ValidationError(
+        "twitter",
+        `Invalid Twitter thread ID: ${threadId}`
+      );
+    }
+    const conversationId = parts[1];
+    if (!conversationId) {
+      throw new ValidationError(
+        "twitter",
+        `Invalid Twitter thread ID: ${threadId}`
+      );
+    }
+    return { conversationId };
+  }
+  parseMessage(raw) {
+    const senderId = raw.message_create.sender_id;
+    const recipientId = raw.message_create.target.recipient_id;
+    const conversationId = this.deriveConversationId(senderId, recipientId);
+    const threadId = this.encodeThreadId({ conversationId });
+    const message = this.parseDMEvent(raw, threadId);
+    this.cacheMessage(message);
+    return message;
+  }
+  renderFormatted(content) {
+    return this.formatConverter.fromAst(content);
+  }
+  // ─── Private Helpers ──────────────────────────────────────────────────
+  resolveThreadId(value) {
+    if (value.startsWith("twitter:")) {
+      return this.decodeThreadId(value);
+    }
+    return { conversationId: value };
+  }
+  /**
+   * Get the recipient user ID from a conversation ID.
+   * Conversation IDs are in the format `{smallerId}-{largerId}`.
+   * The recipient is the ID that is NOT the bot's.
+   */
+  getRecipientFromConversation(conversationId) {
+    const parts = conversationId.split("-");
+    if (parts.length !== 2) {
+      throw new ValidationError(
+        "twitter",
+        `Cannot determine recipient from conversation ID: ${conversationId}`
+      );
+    }
+    const [id1, id2] = parts;
+    if (id1 === this._botUserId) {
+      return id2;
+    }
+    if (id2 === this._botUserId) {
+      return id1;
+    }
+    return id2;
+  }
+  /**
+   * Send a DM via the Twitter API v2.
+   */
+  async sendDM(recipientId, text) {
+    const url = `${this.apiBaseUrl}/2/dm_conversations/with/${recipientId}/messages`;
+    const response = await this.twitterFetchOAuth(url, "POST", { text });
+    const data = response;
+    if (!data.data) {
+      throw new NetworkError(
+        "twitter",
+        "Twitter DM API returned no data"
+      );
+    }
+    return data.data;
+  }
+  /**
+   * Make an authenticated API call using OAuth 1.0a.
+   */
+  async twitterFetchOAuth(urlOrPath, method, body) {
+    const url = urlOrPath.startsWith("http") ? urlOrPath : `${this.apiBaseUrl}${urlOrPath}`;
+    const authHeader = await generateOAuth1Header({
+      method,
+      url,
+      consumerKey: this.consumerKey,
+      consumerSecret: this.consumerSecret,
+      accessToken: this.accessToken,
+      accessTokenSecret: this.accessTokenSecret
+    });
+    let response;
+    try {
+      response = await fetch(url, {
+        method,
+        headers: {
+          Authorization: authHeader,
+          "Content-Type": "application/json"
+        },
+        body: body ? JSON.stringify(body) : void 0
+      });
+    } catch (error) {
+      throw new NetworkError(
+        "twitter",
+        `Network error calling Twitter API: ${method} ${urlOrPath}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    if (response.status === 204) {
+      return {};
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      throw new NetworkError(
+        "twitter",
+        `Failed to parse Twitter API response for ${method} ${urlOrPath}`
+      );
+    }
+    if (!response.ok) {
+      this.throwTwitterApiError(method, urlOrPath, response.status, data);
+    }
+    return data;
+  }
+  /**
+   * Make an authenticated API call using Bearer Token (API v2 read endpoints).
+   */
+  async twitterFetchV2(path, method, queryParams) {
+    const url = new URL(`${this.apiBaseUrl}${path}`);
+    if (queryParams) {
+      for (const [key, value] of Object.entries(queryParams)) {
+        url.searchParams.set(key, value);
+      }
+    }
+    let response;
+    try {
+      response = await fetch(url.toString(), {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.bearerToken}`
+        }
+      });
+    } catch (error) {
+      throw new NetworkError(
+        "twitter",
+        `Network error calling Twitter API: ${method} ${path}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      throw new NetworkError(
+        "twitter",
+        `Failed to parse Twitter API v2 response for ${method} ${path}`
+      );
+    }
+    if (!response.ok) {
+      this.throwTwitterApiError(method, path, response.status, data);
+    }
+    return data.data ?? null;
+  }
+  /**
+   * Map HTTP status codes to appropriate error classes.
+   */
+  throwTwitterApiError(method, path, status, data) {
+    const errors = data?.errors;
+    const firstError = errors?.[0];
+    const description = firstError?.detail ?? firstError?.message ?? `Twitter API ${method} ${path} failed`;
+    if (status === 429) {
+      throw new AdapterRateLimitError("twitter");
+    }
+    if (status === 401) {
+      throw new AuthenticationError("twitter", description);
+    }
+    if (status === 403) {
+      throw new PermissionError("twitter", `${method} ${path}`);
+    }
+    if (status === 404) {
+      throw new ResourceNotFoundError("twitter", path);
+    }
+    if (status >= 400 && status < 500) {
+      throw new ValidationError("twitter", description);
+    }
+    throw new NetworkError(
+      "twitter",
+      `${description} (status ${status})`
+    );
+  }
+  truncateMessage(text) {
+    if (text.length <= TWITTER_DM_MESSAGE_LIMIT) {
+      return text;
+    }
+    return `${text.slice(0, TWITTER_DM_MESSAGE_LIMIT - 3)}...`;
+  }
+  escapeRegex(input) {
+    return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+  cacheMessage(message) {
+    const existing = this.messageCache.get(message.threadId) ?? [];
+    const index = existing.findIndex((item) => item.id === message.id);
+    if (index >= 0) {
+      existing[index] = message;
+    } else {
+      existing.push(message);
+    }
+    existing.sort((a, b) => this.compareMessages(a, b));
+    this.messageCache.set(message.threadId, existing);
+  }
+  findCachedMessage(messageId) {
+    for (const messages of this.messageCache.values()) {
+      const found = messages.find((message) => message.id === messageId);
+      if (found) {
+        return found;
+      }
+    }
+    return void 0;
+  }
+  deleteCachedMessage(messageId) {
+    for (const [threadId, messages] of this.messageCache.entries()) {
+      const filtered = messages.filter(
+        (message) => message.id !== messageId
+      );
+      if (filtered.length === 0) {
+        this.messageCache.delete(threadId);
+      } else if (filtered.length !== messages.length) {
+        this.messageCache.set(threadId, filtered);
+      }
+    }
+  }
+  compareMessages(a, b) {
+    return a.metadata.dateSent.getTime() - b.metadata.dateSent.getTime();
+  }
+  paginateMessages(messages, options) {
+    const limit = Math.max(1, Math.min(options.limit ?? 50, 100));
+    const direction = options.direction ?? "backward";
+    if (messages.length === 0) {
+      return { messages: [] };
+    }
+    const messageIndexById = new Map(
+      messages.map((message, index) => [message.id, index])
+    );
+    if (direction === "backward") {
+      const end2 = options.cursor && messageIndexById.has(options.cursor) ? messageIndexById.get(options.cursor) ?? messages.length : messages.length;
+      const start2 = Math.max(0, end2 - limit);
+      const page2 = messages.slice(start2, end2);
+      return {
+        messages: page2,
+        nextCursor: start2 > 0 ? page2[0]?.id : void 0
+      };
+    }
+    const start = options.cursor && messageIndexById.has(options.cursor) ? (messageIndexById.get(options.cursor) ?? -1) + 1 : 0;
+    const end = Math.min(messages.length, start + limit);
+    const page = messages.slice(start, end);
+    return {
+      messages: page,
+      nextCursor: end < messages.length ? page.at(-1)?.id : void 0
+    };
+  }
+};
+function createTwitterAdapter(config) {
+  return new TwitterAdapter(config ?? {});
+}
+export {
+  TwitterAdapter,
+  TwitterFormatConverter,
+  createTwitterAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/markdown.ts"],"sourcesContent":["import {\n  AdapterRateLimitError,\n  AuthenticationError,\n  cardToFallbackText,\n  extractCard,\n  NetworkError,\n  PermissionError,\n  ResourceNotFoundError,\n  ValidationError,\n} from \"@chat-adapter/shared\";\nimport type {\n  Adapter,\n  AdapterPostableMessage,\n  Attachment,\n  ChatInstance,\n  EmojiValue,\n  FetchOptions,\n  FetchResult,\n  FormattedContent,\n  Logger,\n  RawMessage,\n  ThreadInfo,\n  WebhookOptions,\n} from \"chat\";\nimport { ConsoleLogger, Message, NotImplementedError } from \"chat\";\nimport { TwitterFormatConverter } from \"./markdown\";\nimport type {\n  TwitterAccountActivityPayload,\n  TwitterAdapterConfig,\n  TwitterApiV2Response,\n  TwitterDirectMessageEvent,\n  TwitterDMSendResponse,\n  TwitterRawMessage,\n  TwitterThreadId,\n  TwitterUser,\n  TwitterUserV2,\n} from \"./types\";\n\nconst TWITTER_API_BASE = \"https://api.twitter.com\";\nconst TWITTER_DM_MESSAGE_LIMIT = 10000;\nconst CRC_TOKEN_PARAM = \"crc_token\";\n\ninterface TwitterMessageAuthor {\n  fullName: string;\n  isBot: boolean | \"unknown\";\n  isMe: boolean;\n  userId: string;\n  userName: string;\n}\n\n/**\n * Compute HMAC-SHA256 for CRC validation.\n * Uses the Web Crypto API (available in Node 18+ and edge runtimes).\n */\nasync function computeHmacSha256(\n  key: string,\n  message: string\n): Promise<string> {\n  const encoder = new TextEncoder();\n  const keyData = encoder.encode(key);\n  const messageData = encoder.encode(message);\n\n  const cryptoKey = await crypto.subtle.importKey(\n    \"raw\",\n    keyData,\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"]\n  );\n\n  const signature = await crypto.subtle.sign(\"HMAC\", cryptoKey, messageData);\n  return btoa(String.fromCharCode(...new Uint8Array(signature)));\n}\n\n/**\n * Generate OAuth 1.0a Authorization header.\n *\n * This is a simplified OAuth 1.0a implementation for the X API.\n * It generates the HMAC-SHA1 signature required by Twitter's API.\n */\nasync function generateOAuth1Header(params: {\n  method: string;\n  url: string;\n  consumerKey: string;\n  consumerSecret: string;\n  accessToken: string;\n  accessTokenSecret: string;\n  additionalParams?: Record<string, string>;\n}): Promise<string> {\n  const {\n    method,\n    url,\n    consumerKey,\n    consumerSecret,\n    accessToken,\n    accessTokenSecret,\n    additionalParams,\n  } = params;\n\n  const timestamp = Math.floor(Date.now() / 1000).toString();\n  const nonce = crypto.randomUUID().replace(/-/g, \"\");\n\n  const oauthParams: Record<string, string> = {\n    oauth_consumer_key: consumerKey,\n    oauth_nonce: nonce,\n    oauth_signature_method: \"HMAC-SHA1\",\n    oauth_timestamp: timestamp,\n    oauth_token: accessToken,\n    oauth_version: \"1.0\",\n    ...additionalParams,\n  };\n\n  // Parse URL to get any query parameters\n  const parsedUrl = new URL(url);\n  for (const [key, value] of parsedUrl.searchParams.entries()) {\n    oauthParams[key] = value;\n  }\n\n  // Sort parameters\n  const sortedParams = Object.entries(oauthParams)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(\n      ([key, value]) =>\n        `${encodeURIComponent(key)}=${encodeURIComponent(value)}`\n    )\n    .join(\"&\");\n\n  // Base URL without query string\n  const baseUrl = `${parsedUrl.origin}${parsedUrl.pathname}`;\n\n  // Create signature base string\n  const signatureBase = `${method.toUpperCase()}&${encodeURIComponent(baseUrl)}&${encodeURIComponent(sortedParams)}`;\n  const signingKey = `${encodeURIComponent(consumerSecret)}&${encodeURIComponent(accessTokenSecret)}`;\n\n  // Compute HMAC-SHA1\n  const encoder = new TextEncoder();\n  const keyData = encoder.encode(signingKey);\n  const messageData = encoder.encode(signatureBase);\n\n  const cryptoKey = await crypto.subtle.importKey(\n    \"raw\",\n    keyData,\n    { name: \"HMAC\", hash: \"SHA-1\" },\n    false,\n    [\"sign\"]\n  );\n\n  const signature = await crypto.subtle.sign(\"HMAC\", cryptoKey, messageData);\n  const signatureBase64 = btoa(\n    String.fromCharCode(...new Uint8Array(signature))\n  );\n\n  // Build Authorization header\n  const authParams: Record<string, string> = {\n    oauth_consumer_key: consumerKey,\n    oauth_nonce: nonce,\n    oauth_signature: signatureBase64,\n    oauth_signature_method: \"HMAC-SHA1\",\n    oauth_timestamp: timestamp,\n    oauth_token: accessToken,\n    oauth_version: \"1.0\",\n  };\n\n  const authHeader = Object.entries(authParams)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(\n      ([key, value]) =>\n        `${encodeURIComponent(key)}=\"${encodeURIComponent(value)}\"`\n    )\n    .join(\", \");\n\n  return `OAuth ${authHeader}`;\n}\n\nexport class TwitterAdapter\n  implements Adapter<TwitterThreadId, TwitterRawMessage>\n{\n  readonly name = \"twitter\";\n  readonly persistMessageHistory = true;\n\n  private readonly consumerKey: string;\n  private readonly consumerSecret: string;\n  private readonly accessToken: string;\n  private readonly accessTokenSecret: string;\n  private readonly bearerToken: string;\n  private readonly apiBaseUrl: string;\n  private readonly webhookEnvironment: string;\n  private readonly logger: Logger;\n  private readonly formatConverter = new TwitterFormatConverter();\n  private readonly messageCache = new Map<\n    string,\n    Message<TwitterRawMessage>[]\n  >();\n\n  private chat: ChatInstance | null = null;\n  private _botUserId?: string;\n  private _userName: string;\n  private readonly hasExplicitUserName: boolean;\n\n  get botUserId(): string | undefined {\n    return this._botUserId;\n  }\n\n  get userName(): string {\n    return this._userName;\n  }\n\n  constructor(config: TwitterAdapterConfig = {}) {\n    const consumerKey =\n      config.consumerKey ?? process.env.TWITTER_CONSUMER_KEY;\n    const consumerSecret =\n      config.consumerSecret ?? process.env.TWITTER_CONSUMER_SECRET;\n    const accessToken =\n      config.accessToken ?? process.env.TWITTER_ACCESS_TOKEN;\n    const accessTokenSecret =\n      config.accessTokenSecret ?? process.env.TWITTER_ACCESS_TOKEN_SECRET;\n    const bearerToken =\n      config.bearerToken ?? process.env.TWITTER_BEARER_TOKEN;\n\n    if (!consumerKey) {\n      throw new ValidationError(\n        \"twitter\",\n        \"Consumer key is required. Set TWITTER_CONSUMER_KEY or provide it in config.\"\n      );\n    }\n    if (!consumerSecret) {\n      throw new ValidationError(\n        \"twitter\",\n        \"Consumer secret is required. Set TWITTER_CONSUMER_SECRET or provide it in config.\"\n      );\n    }\n    if (!accessToken) {\n      throw new ValidationError(\n        \"twitter\",\n        \"Access token is required. Set TWITTER_ACCESS_TOKEN or provide it in config.\"\n      );\n    }\n    if (!accessTokenSecret) {\n      throw new ValidationError(\n        \"twitter\",\n        \"Access token secret is required. Set TWITTER_ACCESS_TOKEN_SECRET or provide it in config.\"\n      );\n    }\n    if (!bearerToken) {\n      throw new ValidationError(\n        \"twitter\",\n        \"Bearer token is required. Set TWITTER_BEARER_TOKEN or provide it in config.\"\n      );\n    }\n\n    this.consumerKey = consumerKey;\n    this.consumerSecret = consumerSecret;\n    this.accessToken = accessToken;\n    this.accessTokenSecret = accessTokenSecret;\n    this.bearerToken = bearerToken;\n    this.apiBaseUrl = (\n      config.apiBaseUrl ??\n      process.env.TWITTER_API_BASE_URL ??\n      TWITTER_API_BASE\n    ).replace(/\\/+$/, \"\");\n    this.webhookEnvironment =\n      config.webhookEnvironment ??\n      process.env.TWITTER_WEBHOOK_ENV ??\n      \"production\";\n    this.logger =\n      config.logger ?? new ConsoleLogger(\"info\").child(\"twitter\");\n\n    const userName =\n      config.userName ?? process.env.TWITTER_BOT_USERNAME;\n    this._userName = userName ?? \"bot\";\n    this.hasExplicitUserName = Boolean(userName);\n  }\n\n  async initialize(chat: ChatInstance): Promise<void> {\n    this.chat = chat;\n\n    if (!this.hasExplicitUserName) {\n      const chatUserName = chat.getUserName?.();\n      if (typeof chatUserName === \"string\" && chatUserName.trim()) {\n        this._userName = chatUserName;\n      }\n    }\n\n    // Fetch bot's own user info via API v2\n    try {\n      const me = await this.twitterFetchV2<TwitterUserV2>(\n        \"/2/users/me\",\n        \"GET\"\n      );\n      if (me) {\n        this._botUserId = me.id;\n        if (!this.hasExplicitUserName && me.username) {\n          this._userName = me.username;\n        }\n      }\n\n      this.logger.info(\"Twitter adapter initialized\", {\n        botUserId: this._botUserId,\n        userName: this._userName,\n      });\n    } catch (error) {\n      this.logger.warn(\"Failed to fetch Twitter bot identity\", {\n        error: String(error),\n      });\n    }\n  }\n\n  /**\n   * Handle incoming webhook requests from the X Account Activity API.\n   *\n   * GET requests are CRC challenges — we respond with the HMAC-SHA256 hash.\n   * POST requests are webhook events (DMs, tweets, etc.).\n   */\n  async handleWebhook(\n    request: Request,\n    options?: WebhookOptions\n  ): Promise<Response> {\n    // Handle CRC challenge (GET request)\n    if (request.method === \"GET\") {\n      return this.handleCrcChallenge(request);\n    }\n\n    // For POST requests, verify the webhook signature\n    const body = await request.text();\n\n    // Parse the payload\n    let payload: TwitterAccountActivityPayload;\n    try {\n      payload = JSON.parse(body) as TwitterAccountActivityPayload;\n    } catch {\n      return new Response(\"Invalid JSON\", { status: 400 });\n    }\n\n    if (!this.chat) {\n      this.logger.warn(\n        \"Chat instance not initialized, ignoring Twitter webhook\"\n      );\n      return new Response(\"OK\", { status: 200 });\n    }\n\n    // Process DM events\n    try {\n      this.processDMEvents(payload, options);\n    } catch (error) {\n      this.logger.warn(\"Failed to process Twitter webhook payload\", {\n        error: String(error),\n        forUserId: payload.for_user_id,\n      });\n    }\n\n    return new Response(\"OK\", { status: 200 });\n  }\n\n  /**\n   * Handle CRC challenge from the X Account Activity API.\n   * Responds with HMAC-SHA256 hash of the crc_token using consumer secret.\n   */\n  private async handleCrcChallenge(request: Request): Promise<Response> {\n    const url = new URL(request.url);\n    const crcToken = url.searchParams.get(CRC_TOKEN_PARAM);\n\n    if (!crcToken) {\n      return new Response(\"Missing crc_token parameter\", { status: 400 });\n    }\n\n    const responseToken = await computeHmacSha256(\n      this.consumerSecret,\n      crcToken\n    );\n\n    return new Response(\n      JSON.stringify({\n        response_token: `sha256=${responseToken}`,\n      }),\n      {\n        status: 200,\n        headers: { \"Content-Type\": \"application/json\" },\n      }\n    );\n  }\n\n  /**\n   * Process DM events from the Account Activity webhook payload.\n   */\n  private processDMEvents(\n    payload: TwitterAccountActivityPayload,\n    options?: WebhookOptions\n  ): void {\n    if (!this.chat || !payload.direct_message_events) {\n      return;\n    }\n\n    for (const dmEvent of payload.direct_message_events) {\n      if (dmEvent.type !== \"message_create\") {\n        continue;\n      }\n\n      // Skip messages sent by the bot itself to prevent loops\n      const senderId = dmEvent.message_create.sender_id;\n      if (senderId === this._botUserId) {\n        continue;\n      }\n\n      // Skip messages sent by the bot to the `for_user_id`\n      // (outbound DMs also appear in the webhook)\n      if (senderId === payload.for_user_id && senderId === this._botUserId) {\n        continue;\n      }\n\n      // Duplicate suppression: if two subscribed users are in the same DM,\n      // we receive the event twice (once per user). We only process events\n      // where `for_user_id` matches our bot's user ID.\n      if (this._botUserId && payload.for_user_id !== this._botUserId) {\n        continue;\n      }\n\n      // Determine the conversation ID\n      // In a 1:1 DM, the conversation ID is derived from the user IDs\n      const recipientId = dmEvent.message_create.target.recipient_id;\n      const conversationId = this.deriveConversationId(senderId, recipientId);\n\n      const threadId = this.encodeThreadId({ conversationId });\n\n      const parsedMessage = this.parseDMEvent(\n        dmEvent,\n        threadId,\n        payload.users\n      );\n      this.cacheMessage(parsedMessage);\n\n      this.chat.processMessage(this, threadId, parsedMessage, options);\n    }\n  }\n\n  /**\n   * Derive a deterministic conversation ID from two user IDs.\n   * Twitter's 1:1 DM conversation IDs are formed by sorting the two user\n   * IDs and joining them. For simplicity, we use the smaller ID first.\n   */\n  private deriveConversationId(\n    userId1: string,\n    userId2: string\n  ): string {\n    const ids = [userId1, userId2].sort();\n    return `${ids[0]}-${ids[1]}`;\n  }\n\n  /**\n   * Parse a Twitter DM event into a normalized Message.\n   */\n  private parseDMEvent(\n    dmEvent: TwitterDirectMessageEvent,\n    threadId: string,\n    users?: Record<string, TwitterUser>\n  ): Message<TwitterRawMessage> {\n    const senderId = dmEvent.message_create.sender_id;\n    const text = dmEvent.message_create.message_data.text;\n    const user = users?.[senderId];\n\n    const author: TwitterMessageAuthor = {\n      userId: senderId,\n      userName: user?.screen_name ?? senderId,\n      fullName: user?.name ?? user?.screen_name ?? senderId,\n      isBot: senderId === this._botUserId,\n      isMe: senderId === this._botUserId,\n    };\n\n    const attachments = this.extractAttachments(dmEvent);\n    const isMention = this.checkMention(text);\n\n    return new Message<TwitterRawMessage>({\n      id: dmEvent.id,\n      threadId,\n      text,\n      formatted: this.formatConverter.toAst(text),\n      raw: dmEvent,\n      author,\n      metadata: {\n        dateSent: new Date(Number.parseInt(dmEvent.created_timestamp, 10)),\n        edited: false,\n      },\n      attachments,\n      isMention,\n    });\n  }\n\n  /**\n   * Extract attachments from a DM event.\n   */\n  private extractAttachments(\n    dmEvent: TwitterDirectMessageEvent\n  ): Attachment[] {\n    const attachments: Attachment[] = [];\n    const attachment = dmEvent.message_create.message_data.attachment;\n\n    if (attachment?.media) {\n      const media = attachment.media;\n      const type = media.type === \"video\" ? \"video\" : \"image\";\n\n      // Find the largest image size\n      const largestSize = media.sizes\n        ? Object.values(media.sizes).reduce(\n            (acc, size) =>\n              size.w * size.h > (acc?.w ?? 0) * (acc?.h ?? 0) ? size : acc,\n            undefined as { w: number; h: number; resize: string } | undefined\n          )\n        : undefined;\n\n      attachments.push({\n        type,\n        url: media.media_url_https,\n        width: largestSize?.w,\n        height: largestSize?.h,\n      });\n    }\n\n    return attachments;\n  }\n\n  /**\n   * Check if the bot is mentioned in the text.\n   */\n  private checkMention(text: string): boolean {\n    if (!text || !this._userName) {\n      return false;\n    }\n\n    const mentionPattern = new RegExp(\n      `@${this.escapeRegex(this._userName)}\\\\b`,\n      \"i\"\n    );\n    return mentionPattern.test(text);\n  }\n\n  async postMessage(\n    threadId: string,\n    message: AdapterPostableMessage\n  ): Promise<RawMessage<TwitterRawMessage>> {\n    const { conversationId } = this.resolveThreadId(threadId);\n\n    const card = extractCard(message);\n    const text = this.truncateMessage(\n      card\n        ? cardToFallbackText(card)\n        : this.formatConverter.renderPostable(message)\n    );\n\n    if (!text.trim()) {\n      throw new ValidationError(\"twitter\", \"Message text cannot be empty\");\n    }\n\n    // Determine the recipient from the conversation ID\n    const recipientId = this.getRecipientFromConversation(conversationId);\n\n    const response = await this.sendDM(recipientId, text);\n\n    // Create a synthetic raw DM event for the sent message\n    const syntheticEvent: TwitterDirectMessageEvent = {\n      type: \"message_create\",\n      id: response.dm_event_id,\n      created_timestamp: String(Date.now()),\n      message_create: {\n        target: { recipient_id: recipientId },\n        sender_id: this._botUserId ?? \"\",\n        message_data: { text },\n      },\n    };\n\n    const resultThreadId = this.encodeThreadId({\n      conversationId: response.dm_conversation_id,\n    });\n\n    const parsedMessage = new Message<TwitterRawMessage>({\n      id: response.dm_event_id,\n      threadId: resultThreadId,\n      text,\n      formatted: this.formatConverter.toAst(text),\n      raw: syntheticEvent,\n      author: {\n        userId: this._botUserId ?? \"\",\n        userName: this._userName,\n        fullName: this._userName,\n        isBot: true,\n        isMe: true,\n      },\n      metadata: {\n        dateSent: new Date(),\n        edited: false,\n      },\n      attachments: [],\n    });\n\n    this.cacheMessage(parsedMessage);\n\n    return {\n      id: parsedMessage.id,\n      threadId: parsedMessage.threadId,\n      raw: syntheticEvent,\n    };\n  }\n\n  async editMessage(\n    _threadId: string,\n    _messageId: string,\n    _message: AdapterPostableMessage\n  ): Promise<RawMessage<TwitterRawMessage>> {\n    throw new NotImplementedError(\n      \"Twitter DMs cannot be edited after sending\",\n      \"editMessage\"\n    );\n  }\n\n  async deleteMessage(\n    _threadId: string,\n    messageId: string\n  ): Promise<void> {\n    // Twitter API v2 supports deleting DM events\n    await this.twitterFetchOAuth(\n      `/2/dm_conversations/events/${messageId}`,\n      \"DELETE\"\n    );\n\n    this.deleteCachedMessage(messageId);\n  }\n\n  async addReaction(\n    _threadId: string,\n    _messageId: string,\n    _emoji: EmojiValue | string\n  ): Promise<void> {\n    // Twitter DMs do support reactions, but the API is limited.\n    // For now, log a warning that this is not fully supported.\n    this.logger.warn(\n      \"Twitter DM reactions via API are not fully supported\"\n    );\n  }\n\n  async removeReaction(\n    _threadId: string,\n    _messageId: string,\n    _emoji: EmojiValue | string\n  ): Promise<void> {\n    this.logger.warn(\n      \"Twitter DM reaction removal via API is not fully supported\"\n    );\n  }\n\n  async startTyping(_threadId: string): Promise<void> {\n    // Twitter DM API doesn't have a native typing indicator endpoint.\n    // No-op to fulfill the interface contract.\n  }\n\n  async fetchMessages(\n    threadId: string,\n    options: FetchOptions = {}\n  ): Promise<FetchResult<TwitterRawMessage>> {\n    const messages = [\n      ...(this.messageCache.get(threadId) ?? []),\n    ].sort((a, b) => this.compareMessages(a, b));\n\n    return this.paginateMessages(messages, options);\n  }\n\n  async fetchThread(threadId: string): Promise<ThreadInfo> {\n    const { conversationId } = this.resolveThreadId(threadId);\n\n    return {\n      id: threadId,\n      channelId: conversationId,\n      isDM: true,\n      metadata: {\n        conversationId,\n      },\n    };\n  }\n\n  channelIdFromThreadId(threadId: string): string {\n    const { conversationId } = this.resolveThreadId(threadId);\n    return `twitter:${conversationId}`;\n  }\n\n  async openDM(userId: string): Promise<string> {\n    if (!this._botUserId) {\n      throw new ValidationError(\n        \"twitter\",\n        \"Bot user ID is not available. Ensure the adapter is initialized.\"\n      );\n    }\n\n    const conversationId = this.deriveConversationId(\n      this._botUserId,\n      userId\n    );\n    return this.encodeThreadId({ conversationId });\n  }\n\n  isDM(_threadId: string): boolean {\n    // All Twitter adapter threads are DM conversations\n    return true;\n  }\n\n  encodeThreadId(platformData: TwitterThreadId): string {\n    return `twitter:${platformData.conversationId}`;\n  }\n\n  decodeThreadId(threadId: string): TwitterThreadId {\n    const parts = threadId.split(\":\");\n    if (parts[0] !== \"twitter\" || parts.length !== 2) {\n      throw new ValidationError(\n        \"twitter\",\n        `Invalid Twitter thread ID: ${threadId}`\n      );\n    }\n\n    const conversationId = parts[1];\n    if (!conversationId) {\n      throw new ValidationError(\n        \"twitter\",\n        `Invalid Twitter thread ID: ${threadId}`\n      );\n    }\n\n    return { conversationId };\n  }\n\n  parseMessage(raw: TwitterRawMessage): Message<TwitterRawMessage> {\n    const senderId = raw.message_create.sender_id;\n    const recipientId = raw.message_create.target.recipient_id;\n    const conversationId = this.deriveConversationId(senderId, recipientId);\n    const threadId = this.encodeThreadId({ conversationId });\n\n    const message = this.parseDMEvent(raw, threadId);\n    this.cacheMessage(message);\n    return message;\n  }\n\n  renderFormatted(content: FormattedContent): string {\n    return this.formatConverter.fromAst(content);\n  }\n\n  // ─── Private Helpers ──────────────────────────────────────────────────\n\n  private resolveThreadId(value: string): TwitterThreadId {\n    if (value.startsWith(\"twitter:\")) {\n      return this.decodeThreadId(value);\n    }\n    return { conversationId: value };\n  }\n\n  /**\n   * Get the recipient user ID from a conversation ID.\n   * Conversation IDs are in the format `{smallerId}-{largerId}`.\n   * The recipient is the ID that is NOT the bot's.\n   */\n  private getRecipientFromConversation(conversationId: string): string {\n    const parts = conversationId.split(\"-\");\n    if (parts.length !== 2) {\n      throw new ValidationError(\n        \"twitter\",\n        `Cannot determine recipient from conversation ID: ${conversationId}`\n      );\n    }\n\n    const [id1, id2] = parts;\n    if (id1 === this._botUserId) {\n      return id2;\n    }\n    if (id2 === this._botUserId) {\n      return id1;\n    }\n\n    // If bot user ID is unknown, default to the second ID\n    return id2;\n  }\n\n  /**\n   * Send a DM via the Twitter API v2.\n   */\n  private async sendDM(\n    recipientId: string,\n    text: string\n  ): Promise<{ dm_event_id: string; dm_conversation_id: string }> {\n    const url = `${this.apiBaseUrl}/2/dm_conversations/with/${recipientId}/messages`;\n\n    const response = await this.twitterFetchOAuth(url, \"POST\", { text });\n\n    const data = response as { data?: { dm_event_id: string; dm_conversation_id: string } };\n    if (!data.data) {\n      throw new NetworkError(\n        \"twitter\",\n        \"Twitter DM API returned no data\"\n      );\n    }\n\n    return data.data;\n  }\n\n  /**\n   * Make an authenticated API call using OAuth 1.0a.\n   */\n  private async twitterFetchOAuth(\n    urlOrPath: string,\n    method: string,\n    body?: Record<string, unknown>\n  ): Promise<unknown> {\n    const url = urlOrPath.startsWith(\"http\")\n      ? urlOrPath\n      : `${this.apiBaseUrl}${urlOrPath}`;\n\n    const authHeader = await generateOAuth1Header({\n      method,\n      url,\n      consumerKey: this.consumerKey,\n      consumerSecret: this.consumerSecret,\n      accessToken: this.accessToken,\n      accessTokenSecret: this.accessTokenSecret,\n    });\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method,\n        headers: {\n          Authorization: authHeader,\n          \"Content-Type\": \"application/json\",\n        },\n        body: body ? JSON.stringify(body) : undefined,\n      });\n    } catch (error) {\n      throw new NetworkError(\n        \"twitter\",\n        `Network error calling Twitter API: ${method} ${urlOrPath}`,\n        error instanceof Error ? error : undefined\n      );\n    }\n\n    if (response.status === 204) {\n      return {};\n    }\n\n    let data: unknown;\n    try {\n      data = await response.json();\n    } catch {\n      throw new NetworkError(\n        \"twitter\",\n        `Failed to parse Twitter API response for ${method} ${urlOrPath}`\n      );\n    }\n\n    if (!response.ok) {\n      this.throwTwitterApiError(method, urlOrPath, response.status, data);\n    }\n\n    return data;\n  }\n\n  /**\n   * Make an authenticated API call using Bearer Token (API v2 read endpoints).\n   */\n  private async twitterFetchV2<TResult>(\n    path: string,\n    method: string,\n    queryParams?: Record<string, string>\n  ): Promise<TResult | null> {\n    const url = new URL(`${this.apiBaseUrl}${path}`);\n    if (queryParams) {\n      for (const [key, value] of Object.entries(queryParams)) {\n        url.searchParams.set(key, value);\n      }\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(url.toString(), {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.bearerToken}`,\n        },\n      });\n    } catch (error) {\n      throw new NetworkError(\n        \"twitter\",\n        `Network error calling Twitter API: ${method} ${path}`,\n        error instanceof Error ? error : undefined\n      );\n    }\n\n    let data: TwitterApiV2Response<TResult>;\n    try {\n      data = (await response.json()) as TwitterApiV2Response<TResult>;\n    } catch {\n      throw new NetworkError(\n        \"twitter\",\n        `Failed to parse Twitter API v2 response for ${method} ${path}`\n      );\n    }\n\n    if (!response.ok) {\n      this.throwTwitterApiError(method, path, response.status, data);\n    }\n\n    return data.data ?? null;\n  }\n\n  /**\n   * Map HTTP status codes to appropriate error classes.\n   */\n  private throwTwitterApiError(\n    method: string,\n    path: string,\n    status: number,\n    data: unknown\n  ): never {\n    const errors = (data as { errors?: Array<{ message?: string; detail?: string }> })\n      ?.errors;\n    const firstError = errors?.[0];\n    const description =\n      firstError?.detail ??\n      firstError?.message ??\n      `Twitter API ${method} ${path} failed`;\n\n    if (status === 429) {\n      throw new AdapterRateLimitError(\"twitter\");\n    }\n\n    if (status === 401) {\n      throw new AuthenticationError(\"twitter\", description);\n    }\n\n    if (status === 403) {\n      throw new PermissionError(\"twitter\", `${method} ${path}`);\n    }\n\n    if (status === 404) {\n      throw new ResourceNotFoundError(\"twitter\", path);\n    }\n\n    if (status >= 400 && status < 500) {\n      throw new ValidationError(\"twitter\", description);\n    }\n\n    throw new NetworkError(\n      \"twitter\",\n      `${description} (status ${status})`\n    );\n  }\n\n  private truncateMessage(text: string): string {\n    if (text.length <= TWITTER_DM_MESSAGE_LIMIT) {\n      return text;\n    }\n    return `${text.slice(0, TWITTER_DM_MESSAGE_LIMIT - 3)}...`;\n  }\n\n  private escapeRegex(input: string): string {\n    return input.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n\n  private cacheMessage(message: Message<TwitterRawMessage>): void {\n    const existing = this.messageCache.get(message.threadId) ?? [];\n    const index = existing.findIndex((item) => item.id === message.id);\n\n    if (index >= 0) {\n      existing[index] = message;\n    } else {\n      existing.push(message);\n    }\n\n    existing.sort((a, b) => this.compareMessages(a, b));\n    this.messageCache.set(message.threadId, existing);\n  }\n\n  private findCachedMessage(\n    messageId: string\n  ): Message<TwitterRawMessage> | undefined {\n    for (const messages of this.messageCache.values()) {\n      const found = messages.find((message) => message.id === messageId);\n      if (found) {\n        return found;\n      }\n    }\n    return undefined;\n  }\n\n  private deleteCachedMessage(messageId: string): void {\n    for (const [threadId, messages] of this.messageCache.entries()) {\n      const filtered = messages.filter(\n        (message) => message.id !== messageId\n      );\n      if (filtered.length === 0) {\n        this.messageCache.delete(threadId);\n      } else if (filtered.length !== messages.length) {\n        this.messageCache.set(threadId, filtered);\n      }\n    }\n  }\n\n  private compareMessages(\n    a: Message<TwitterRawMessage>,\n    b: Message<TwitterRawMessage>\n  ): number {\n    return (\n      a.metadata.dateSent.getTime() - b.metadata.dateSent.getTime()\n    );\n  }\n\n  private paginateMessages(\n    messages: Message<TwitterRawMessage>[],\n    options: FetchOptions\n  ): FetchResult<TwitterRawMessage> {\n    const limit = Math.max(1, Math.min(options.limit ?? 50, 100));\n    const direction = options.direction ?? \"backward\";\n\n    if (messages.length === 0) {\n      return { messages: [] };\n    }\n\n    const messageIndexById = new Map(\n      messages.map((message, index) => [message.id, index])\n    );\n\n    if (direction === \"backward\") {\n      const end =\n        options.cursor && messageIndexById.has(options.cursor)\n          ? (messageIndexById.get(options.cursor) ?? messages.length)\n          : messages.length;\n      const start = Math.max(0, end - limit);\n      const page = messages.slice(start, end);\n\n      return {\n        messages: page,\n        nextCursor: start > 0 ? page[0]?.id : undefined,\n      };\n    }\n\n    const start =\n      options.cursor && messageIndexById.has(options.cursor)\n        ? (messageIndexById.get(options.cursor) ?? -1) + 1\n        : 0;\n    const end = Math.min(messages.length, start + limit);\n    const page = messages.slice(start, end);\n\n    return {\n      messages: page,\n      nextCursor: end < messages.length ? page.at(-1)?.id : undefined,\n    };\n  }\n}\n\nexport function createTwitterAdapter(\n  config?: TwitterAdapterConfig\n): TwitterAdapter {\n  return new TwitterAdapter(config ?? {});\n}\n\nexport { TwitterFormatConverter } from \"./markdown\";\nexport type {\n  TwitterAccountActivityPayload,\n  TwitterAdapterConfig,\n  TwitterDirectMessageEvent,\n  TwitterDMEventV2,\n  TwitterDMSendResponse,\n  TwitterRawMessage,\n  TwitterThreadId,\n  TwitterUser,\n  TwitterUserV2,\n} from \"./types\";\n","/**\n * Twitter / X format conversion.\n *\n * Twitter DMs use plain text with entity annotations (similar to Telegram).\n * For outbound messages, we send plain text since the DM API doesn't\n * support rich formatting (bold/italic/etc.) natively.\n */\n\nimport {\n  type AdapterPostableMessage,\n  BaseFormatConverter,\n  type Content,\n  isTableNode,\n  parseMarkdown,\n  type Root,\n  stringifyMarkdown,\n  tableToAscii,\n  walkAst,\n} from \"chat\";\n\nexport class TwitterFormatConverter extends BaseFormatConverter {\n  /**\n   * Convert platform text to mdast AST.\n   * Twitter DMs are plain text — we parse as if they were markdown\n   * so that any user-typed markdown is preserved in the AST.\n   */\n  toAst(text: string): Root {\n    return parseMarkdown(text);\n  }\n\n  /**\n   * Convert mdast AST to platform text format.\n   * Twitter DMs don't support rich formatting, so we try to\n   * produce readable plain text. Tables get converted to ASCII art.\n   */\n  fromAst(ast: Root): string {\n    const transformed = walkAst(structuredClone(ast), (node: Content) => {\n      if (isTableNode(node)) {\n        return {\n          type: \"code\" as const,\n          value: tableToAscii(node),\n          lang: undefined,\n        } as Content;\n      }\n      return node;\n    });\n    return stringifyMarkdown(transformed).trim();\n  }\n\n  override renderPostable(message: AdapterPostableMessage): string {\n    if (typeof message === \"string\") {\n      return message;\n    }\n    if (\"raw\" in message) {\n      return message.raw;\n    }\n    if (\"markdown\" in message) {\n      return this.fromMarkdown(message.markdown);\n    }\n    if (\"ast\" in message) {\n      return this.fromAst(message.ast);\n    }\n    return super.renderPostable(message);\n  }\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAeP,SAAS,eAAe,SAAS,2BAA2B;;;AChB5D;AAAA,EAEE;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,IAAM,yBAAN,cAAqC,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM9D,MAAM,MAAoB;AACxB,WAAO,cAAc,IAAI;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAQ,KAAmB;AACzB,UAAM,cAAc,QAAQ,gBAAgB,GAAG,GAAG,CAAC,SAAkB;AACnE,UAAI,YAAY,IAAI,GAAG;AACrB,eAAO;AAAA,UACL,MAAM;AAAA,UACN,OAAO,aAAa,IAAI;AAAA,UACxB,MAAM;AAAA,QACR;AAAA,MACF;AACA,aAAO;AAAA,IACT,CAAC;AACD,WAAO,kBAAkB,WAAW,EAAE,KAAK;AAAA,EAC7C;AAAA,EAES,eAAe,SAAyC;AAC/D,QAAI,OAAO,YAAY,UAAU;AAC/B,aAAO;AAAA,IACT;AACA,QAAI,SAAS,SAAS;AACpB,aAAO,QAAQ;AAAA,IACjB;AACA,QAAI,cAAc,SAAS;AACzB,aAAO,KAAK,aAAa,QAAQ,QAAQ;AAAA,IAC3C;AACA,QAAI,SAAS,SAAS;AACpB,aAAO,KAAK,QAAQ,QAAQ,GAAG;AAAA,IACjC;AACA,WAAO,MAAM,eAAe,OAAO;AAAA,EACrC;AACF;;;AD1BA,IAAM,mBAAmB;AACzB,IAAM,2BAA2B;AACjC,IAAM,kBAAkB;AAcxB,eAAe,kBACb,KACA,SACiB;AACjB,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,UAAU,QAAQ,OAAO,GAAG;AAClC,QAAM,cAAc,QAAQ,OAAO,OAAO;AAE1C,QAAM,YAAY,MAAM,OAAO,OAAO;AAAA,IACpC;AAAA,IACA;AAAA,IACA,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,IAChC;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,OAAO,OAAO,KAAK,QAAQ,WAAW,WAAW;AACzE,SAAO,KAAK,OAAO,aAAa,GAAG,IAAI,WAAW,SAAS,CAAC,CAAC;AAC/D;AAQA,eAAe,qBAAqB,QAQhB;AAClB,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,YAAY,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,EAAE,SAAS;AACzD,QAAM,QAAQ,OAAO,WAAW,EAAE,QAAQ,MAAM,EAAE;AAElD,QAAM,cAAsC;AAAA,IAC1C,oBAAoB;AAAA,IACpB,aAAa;AAAA,IACb,wBAAwB;AAAA,IACxB,iBAAiB;AAAA,IACjB,aAAa;AAAA,IACb,eAAe;AAAA,IACf,GAAG;AAAA,EACL;AAGA,QAAM,YAAY,IAAI,IAAI,GAAG;AAC7B,aAAW,CAAC,KAAK,KAAK,KAAK,UAAU,aAAa,QAAQ,GAAG;AAC3D,gBAAY,GAAG,IAAI;AAAA,EACrB;AAGA,QAAM,eAAe,OAAO,QAAQ,WAAW,EAC5C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EACrC;AAAA,IACC,CAAC,CAAC,KAAK,KAAK,MACV,GAAG,mBAAmB,GAAG,CAAC,IAAI,mBAAmB,KAAK,CAAC;AAAA,EAC3D,EACC,KAAK,GAAG;AAGX,QAAM,UAAU,GAAG,UAAU,MAAM,GAAG,UAAU,QAAQ;AAGxD,QAAM,gBAAgB,GAAG,OAAO,YAAY,CAAC,IAAI,mBAAmB,OAAO,CAAC,IAAI,mBAAmB,YAAY,CAAC;AAChH,QAAM,aAAa,GAAG,mBAAmB,cAAc,CAAC,IAAI,mBAAmB,iBAAiB,CAAC;AAGjG,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,UAAU,QAAQ,OAAO,UAAU;AACzC,QAAM,cAAc,QAAQ,OAAO,aAAa;AAEhD,QAAM,YAAY,MAAM,OAAO,OAAO;AAAA,IACpC;AAAA,IACA;AAAA,IACA,EAAE,MAAM,QAAQ,MAAM,QAAQ;AAAA,IAC9B;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,OAAO,OAAO,KAAK,QAAQ,WAAW,WAAW;AACzE,QAAM,kBAAkB;AAAA,IACtB,OAAO,aAAa,GAAG,IAAI,WAAW,SAAS,CAAC;AAAA,EAClD;AAGA,QAAM,aAAqC;AAAA,IACzC,oBAAoB;AAAA,IACpB,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,wBAAwB;AAAA,IACxB,iBAAiB;AAAA,IACjB,aAAa;AAAA,IACb,eAAe;AAAA,EACjB;AAEA,QAAM,aAAa,OAAO,QAAQ,UAAU,EACzC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EACrC;AAAA,IACC,CAAC,CAAC,KAAK,KAAK,MACV,GAAG,mBAAmB,GAAG,CAAC,KAAK,mBAAmB,KAAK,CAAC;AAAA,EAC5D,EACC,KAAK,IAAI;AAEZ,SAAO,SAAS,UAAU;AAC5B;AAEO,IAAM,iBAAN,MAEP;AAAA,EACW,OAAO;AAAA,EACP,wBAAwB;AAAA,EAEhB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB,IAAI,uBAAuB;AAAA,EAC7C,eAAe,oBAAI,IAGlC;AAAA,EAEM,OAA4B;AAAA,EAC5B;AAAA,EACA;AAAA,EACS;AAAA,EAEjB,IAAI,YAAgC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,WAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,SAA+B,CAAC,GAAG;AAC7C,UAAM,cACJ,OAAO,eAAe,QAAQ,IAAI;AACpC,UAAM,iBACJ,OAAO,kBAAkB,QAAQ,IAAI;AACvC,UAAM,cACJ,OAAO,eAAe,QAAQ,IAAI;AACpC,UAAM,oBACJ,OAAO,qBAAqB,QAAQ,IAAI;AAC1C,UAAM,cACJ,OAAO,eAAe,QAAQ,IAAI;AAEpC,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,gBAAgB;AACnB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,mBAAmB;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,SAAK,cAAc;AACnB,SAAK,iBAAiB;AACtB,SAAK,cAAc;AACnB,SAAK,oBAAoB;AACzB,SAAK,cAAc;AACnB,SAAK,cACH,OAAO,cACP,QAAQ,IAAI,wBACZ,kBACA,QAAQ,QAAQ,EAAE;AACpB,SAAK,qBACH,OAAO,sBACP,QAAQ,IAAI,uBACZ;AACF,SAAK,SACH,OAAO,UAAU,IAAI,cAAc,MAAM,EAAE,MAAM,SAAS;AAE5D,UAAM,WACJ,OAAO,YAAY,QAAQ,IAAI;AACjC,SAAK,YAAY,YAAY;AAC7B,SAAK,sBAAsB,QAAQ,QAAQ;AAAA,EAC7C;AAAA,EAEA,MAAM,WAAW,MAAmC;AAClD,SAAK,OAAO;AAEZ,QAAI,CAAC,KAAK,qBAAqB;AAC7B,YAAM,eAAe,KAAK,cAAc;AACxC,UAAI,OAAO,iBAAiB,YAAY,aAAa,KAAK,GAAG;AAC3D,aAAK,YAAY;AAAA,MACnB;AAAA,IACF;AAGA,QAAI;AACF,YAAM,KAAK,MAAM,KAAK;AAAA,QACpB;AAAA,QACA;AAAA,MACF;AACA,UAAI,IAAI;AACN,aAAK,aAAa,GAAG;AACrB,YAAI,CAAC,KAAK,uBAAuB,GAAG,UAAU;AAC5C,eAAK,YAAY,GAAG;AAAA,QACtB;AAAA,MACF;AAEA,WAAK,OAAO,KAAK,+BAA+B;AAAA,QAC9C,WAAW,KAAK;AAAA,QAChB,UAAU,KAAK;AAAA,MACjB,CAAC;AAAA,IACH,SAAS,OAAO;AACd,WAAK,OAAO,KAAK,wCAAwC;AAAA,QACvD,OAAO,OAAO,KAAK;AAAA,MACrB,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,cACJ,SACA,SACmB;AAEnB,QAAI,QAAQ,WAAW,OAAO;AAC5B,aAAO,KAAK,mBAAmB,OAAO;AAAA,IACxC;AAGA,UAAM,OAAO,MAAM,QAAQ,KAAK;AAGhC,QAAI;AACJ,QAAI;AACF,gBAAU,KAAK,MAAM,IAAI;AAAA,IAC3B,QAAQ;AACN,aAAO,IAAI,SAAS,gBAAgB,EAAE,QAAQ,IAAI,CAAC;AAAA,IACrD;AAEA,QAAI,CAAC,KAAK,MAAM;AACd,WAAK,OAAO;AAAA,QACV;AAAA,MACF;AACA,aAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC3C;AAGA,QAAI;AACF,WAAK,gBAAgB,SAAS,OAAO;AAAA,IACvC,SAAS,OAAO;AACd,WAAK,OAAO,KAAK,6CAA6C;AAAA,QAC5D,OAAO,OAAO,KAAK;AAAA,QACnB,WAAW,QAAQ;AAAA,MACrB,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,mBAAmB,SAAqC;AACpE,UAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,UAAM,WAAW,IAAI,aAAa,IAAI,eAAe;AAErD,QAAI,CAAC,UAAU;AACb,aAAO,IAAI,SAAS,+BAA+B,EAAE,QAAQ,IAAI,CAAC;AAAA,IACpE;AAEA,UAAM,gBAAgB,MAAM;AAAA,MAC1B,KAAK;AAAA,MACL;AAAA,IACF;AAEA,WAAO,IAAI;AAAA,MACT,KAAK,UAAU;AAAA,QACb,gBAAgB,UAAU,aAAa;AAAA,MACzC,CAAC;AAAA,MACD;AAAA,QACE,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,gBACN,SACA,SACM;AACN,QAAI,CAAC,KAAK,QAAQ,CAAC,QAAQ,uBAAuB;AAChD;AAAA,IACF;AAEA,eAAW,WAAW,QAAQ,uBAAuB;AACnD,UAAI,QAAQ,SAAS,kBAAkB;AACrC;AAAA,MACF;AAGA,YAAM,WAAW,QAAQ,eAAe;AACxC,UAAI,aAAa,KAAK,YAAY;AAChC;AAAA,MACF;AAIA,UAAI,aAAa,QAAQ,eAAe,aAAa,KAAK,YAAY;AACpE;AAAA,MACF;AAKA,UAAI,KAAK,cAAc,QAAQ,gBAAgB,KAAK,YAAY;AAC9D;AAAA,MACF;AAIA,YAAM,cAAc,QAAQ,eAAe,OAAO;AAClD,YAAM,iBAAiB,KAAK,qBAAqB,UAAU,WAAW;AAEtE,YAAM,WAAW,KAAK,eAAe,EAAE,eAAe,CAAC;AAEvD,YAAM,gBAAgB,KAAK;AAAA,QACzB;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,MACV;AACA,WAAK,aAAa,aAAa;AAE/B,WAAK,KAAK,eAAe,MAAM,UAAU,eAAe,OAAO;AAAA,IACjE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,qBACN,SACA,SACQ;AACR,UAAM,MAAM,CAAC,SAAS,OAAO,EAAE,KAAK;AACpC,WAAO,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKQ,aACN,SACA,UACA,OAC4B;AAC5B,UAAM,WAAW,QAAQ,eAAe;AACxC,UAAM,OAAO,QAAQ,eAAe,aAAa;AACjD,UAAM,OAAO,QAAQ,QAAQ;AAE7B,UAAM,SAA+B;AAAA,MACnC,QAAQ;AAAA,MACR,UAAU,MAAM,eAAe;AAAA,MAC/B,UAAU,MAAM,QAAQ,MAAM,eAAe;AAAA,MAC7C,OAAO,aAAa,KAAK;AAAA,MACzB,MAAM,aAAa,KAAK;AAAA,IAC1B;AAEA,UAAM,cAAc,KAAK,mBAAmB,OAAO;AACnD,UAAM,YAAY,KAAK,aAAa,IAAI;AAExC,WAAO,IAAI,QAA2B;AAAA,MACpC,IAAI,QAAQ;AAAA,MACZ;AAAA,MACA;AAAA,MACA,WAAW,KAAK,gBAAgB,MAAM,IAAI;AAAA,MAC1C,KAAK;AAAA,MACL;AAAA,MACA,UAAU;AAAA,QACR,UAAU,IAAI,KAAK,OAAO,SAAS,QAAQ,mBAAmB,EAAE,CAAC;AAAA,QACjE,QAAQ;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,mBACN,SACc;AACd,UAAM,cAA4B,CAAC;AACnC,UAAM,aAAa,QAAQ,eAAe,aAAa;AAEvD,QAAI,YAAY,OAAO;AACrB,YAAM,QAAQ,WAAW;AACzB,YAAM,OAAO,MAAM,SAAS,UAAU,UAAU;AAGhD,YAAM,cAAc,MAAM,QACtB,OAAO,OAAO,MAAM,KAAK,EAAE;AAAA,QACzB,CAAC,KAAK,SACJ,KAAK,IAAI,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,OAAO;AAAA,QAC3D;AAAA,MACF,IACA;AAEJ,kBAAY,KAAK;AAAA,QACf;AAAA,QACA,KAAK,MAAM;AAAA,QACX,OAAO,aAAa;AAAA,QACpB,QAAQ,aAAa;AAAA,MACvB,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,aAAa,MAAuB;AAC1C,QAAI,CAAC,QAAQ,CAAC,KAAK,WAAW;AAC5B,aAAO;AAAA,IACT;AAEA,UAAM,iBAAiB,IAAI;AAAA,MACzB,IAAI,KAAK,YAAY,KAAK,SAAS,CAAC;AAAA,MACpC;AAAA,IACF;AACA,WAAO,eAAe,KAAK,IAAI;AAAA,EACjC;AAAA,EAEA,MAAM,YACJ,UACA,SACwC;AACxC,UAAM,EAAE,eAAe,IAAI,KAAK,gBAAgB,QAAQ;AAExD,UAAM,OAAO,YAAY,OAAO;AAChC,UAAM,OAAO,KAAK;AAAA,MAChB,OACI,mBAAmB,IAAI,IACvB,KAAK,gBAAgB,eAAe,OAAO;AAAA,IACjD;AAEA,QAAI,CAAC,KAAK,KAAK,GAAG;AAChB,YAAM,IAAI,gBAAgB,WAAW,8BAA8B;AAAA,IACrE;AAGA,UAAM,cAAc,KAAK,6BAA6B,cAAc;AAEpE,UAAM,WAAW,MAAM,KAAK,OAAO,aAAa,IAAI;AAGpD,UAAM,iBAA4C;AAAA,MAChD,MAAM;AAAA,MACN,IAAI,SAAS;AAAA,MACb,mBAAmB,OAAO,KAAK,IAAI,CAAC;AAAA,MACpC,gBAAgB;AAAA,QACd,QAAQ,EAAE,cAAc,YAAY;AAAA,QACpC,WAAW,KAAK,cAAc;AAAA,QAC9B,cAAc,EAAE,KAAK;AAAA,MACvB;AAAA,IACF;AAEA,UAAM,iBAAiB,KAAK,eAAe;AAAA,MACzC,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAED,UAAM,gBAAgB,IAAI,QAA2B;AAAA,MACnD,IAAI,SAAS;AAAA,MACb,UAAU;AAAA,MACV;AAAA,MACA,WAAW,KAAK,gBAAgB,MAAM,IAAI;AAAA,MAC1C,KAAK;AAAA,MACL,QAAQ;AAAA,QACN,QAAQ,KAAK,cAAc;AAAA,QAC3B,UAAU,KAAK;AAAA,QACf,UAAU,KAAK;AAAA,QACf,OAAO;AAAA,QACP,MAAM;AAAA,MACR;AAAA,MACA,UAAU;AAAA,QACR,UAAU,oBAAI,KAAK;AAAA,QACnB,QAAQ;AAAA,MACV;AAAA,MACA,aAAa,CAAC;AAAA,IAChB,CAAC;AAED,SAAK,aAAa,aAAa;AAE/B,WAAO;AAAA,MACL,IAAI,cAAc;AAAA,MAClB,UAAU,cAAc;AAAA,MACxB,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,YACJ,WACA,YACA,UACwC;AACxC,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,cACJ,WACA,WACe;AAEf,UAAM,KAAK;AAAA,MACT,8BAA8B,SAAS;AAAA,MACvC;AAAA,IACF;AAEA,SAAK,oBAAoB,SAAS;AAAA,EACpC;AAAA,EAEA,MAAM,YACJ,WACA,YACA,QACe;AAGf,SAAK,OAAO;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,eACJ,WACA,YACA,QACe;AACf,SAAK,OAAO;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,WAAkC;AAAA,EAGpD;AAAA,EAEA,MAAM,cACJ,UACA,UAAwB,CAAC,GACgB;AACzC,UAAM,WAAW;AAAA,MACf,GAAI,KAAK,aAAa,IAAI,QAAQ,KAAK,CAAC;AAAA,IAC1C,EAAE,KAAK,CAAC,GAAG,MAAM,KAAK,gBAAgB,GAAG,CAAC,CAAC;AAE3C,WAAO,KAAK,iBAAiB,UAAU,OAAO;AAAA,EAChD;AAAA,EAEA,MAAM,YAAY,UAAuC;AACvD,UAAM,EAAE,eAAe,IAAI,KAAK,gBAAgB,QAAQ;AAExD,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,sBAAsB,UAA0B;AAC9C,UAAM,EAAE,eAAe,IAAI,KAAK,gBAAgB,QAAQ;AACxD,WAAO,WAAW,cAAc;AAAA,EAClC;AAAA,EAEA,MAAM,OAAO,QAAiC;AAC5C,QAAI,CAAC,KAAK,YAAY;AACpB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,iBAAiB,KAAK;AAAA,MAC1B,KAAK;AAAA,MACL;AAAA,IACF;AACA,WAAO,KAAK,eAAe,EAAE,eAAe,CAAC;AAAA,EAC/C;AAAA,EAEA,KAAK,WAA4B;AAE/B,WAAO;AAAA,EACT;AAAA,EAEA,eAAe,cAAuC;AACpD,WAAO,WAAW,aAAa,cAAc;AAAA,EAC/C;AAAA,EAEA,eAAe,UAAmC;AAChD,UAAM,QAAQ,SAAS,MAAM,GAAG;AAChC,QAAI,MAAM,CAAC,MAAM,aAAa,MAAM,WAAW,GAAG;AAChD,YAAM,IAAI;AAAA,QACR;AAAA,QACA,8BAA8B,QAAQ;AAAA,MACxC;AAAA,IACF;AAEA,UAAM,iBAAiB,MAAM,CAAC;AAC9B,QAAI,CAAC,gBAAgB;AACnB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,8BAA8B,QAAQ;AAAA,MACxC;AAAA,IACF;AAEA,WAAO,EAAE,eAAe;AAAA,EAC1B;AAAA,EAEA,aAAa,KAAoD;AAC/D,UAAM,WAAW,IAAI,eAAe;AACpC,UAAM,cAAc,IAAI,eAAe,OAAO;AAC9C,UAAM,iBAAiB,KAAK,qBAAqB,UAAU,WAAW;AACtE,UAAM,WAAW,KAAK,eAAe,EAAE,eAAe,CAAC;AAEvD,UAAM,UAAU,KAAK,aAAa,KAAK,QAAQ;AAC/C,SAAK,aAAa,OAAO;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,gBAAgB,SAAmC;AACjD,WAAO,KAAK,gBAAgB,QAAQ,OAAO;AAAA,EAC7C;AAAA;AAAA,EAIQ,gBAAgB,OAAgC;AACtD,QAAI,MAAM,WAAW,UAAU,GAAG;AAChC,aAAO,KAAK,eAAe,KAAK;AAAA,IAClC;AACA,WAAO,EAAE,gBAAgB,MAAM;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,6BAA6B,gBAAgC;AACnE,UAAM,QAAQ,eAAe,MAAM,GAAG;AACtC,QAAI,MAAM,WAAW,GAAG;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,oDAAoD,cAAc;AAAA,MACpE;AAAA,IACF;AAEA,UAAM,CAAC,KAAK,GAAG,IAAI;AACnB,QAAI,QAAQ,KAAK,YAAY;AAC3B,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,KAAK,YAAY;AAC3B,aAAO;AAAA,IACT;AAGA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,OACZ,aACA,MAC8D;AAC9D,UAAM,MAAM,GAAG,KAAK,UAAU,4BAA4B,WAAW;AAErE,UAAM,WAAW,MAAM,KAAK,kBAAkB,KAAK,QAAQ,EAAE,KAAK,CAAC;AAEnE,UAAM,OAAO;AACb,QAAI,CAAC,KAAK,MAAM;AACd,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,kBACZ,WACA,QACA,MACkB;AAClB,UAAM,MAAM,UAAU,WAAW,MAAM,IACnC,YACA,GAAG,KAAK,UAAU,GAAG,SAAS;AAElC,UAAM,aAAa,MAAM,qBAAqB;AAAA,MAC5C;AAAA,MACA;AAAA,MACA,aAAa,KAAK;AAAA,MAClB,gBAAgB,KAAK;AAAA,MACrB,aAAa,KAAK;AAAA,MAClB,mBAAmB,KAAK;AAAA,IAC1B,CAAC;AAED,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,MAAM,KAAK;AAAA,QAC1B;AAAA,QACA,SAAS;AAAA,UACP,eAAe;AAAA,UACf,gBAAgB;AAAA,QAClB;AAAA,QACA,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,MACtC,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR;AAAA,QACA,sCAAsC,MAAM,IAAI,SAAS;AAAA,QACzD,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AAAA,IACF;AAEA,QAAI,SAAS,WAAW,KAAK;AAC3B,aAAO,CAAC;AAAA,IACV;AAEA,QAAI;AACJ,QAAI;AACF,aAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,QACA,4CAA4C,MAAM,IAAI,SAAS;AAAA,MACjE;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,WAAK,qBAAqB,QAAQ,WAAW,SAAS,QAAQ,IAAI;AAAA,IACpE;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,eACZ,MACA,QACA,aACyB;AACzB,UAAM,MAAM,IAAI,IAAI,GAAG,KAAK,UAAU,GAAG,IAAI,EAAE;AAC/C,QAAI,aAAa;AACf,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,GAAG;AACtD,YAAI,aAAa,IAAI,KAAK,KAAK;AAAA,MACjC;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,MAAM,IAAI,SAAS,GAAG;AAAA,QACrC;AAAA,QACA,SAAS;AAAA,UACP,eAAe,UAAU,KAAK,WAAW;AAAA,QAC3C;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR;AAAA,QACA,sCAAsC,MAAM,IAAI,IAAI;AAAA,QACpD,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,QACA,+CAA+C,MAAM,IAAI,IAAI;AAAA,MAC/D;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,WAAK,qBAAqB,QAAQ,MAAM,SAAS,QAAQ,IAAI;AAAA,IAC/D;AAEA,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA,EAKQ,qBACN,QACA,MACA,QACA,MACO;AACP,UAAM,SAAU,MACZ;AACJ,UAAM,aAAa,SAAS,CAAC;AAC7B,UAAM,cACJ,YAAY,UACZ,YAAY,WACZ,eAAe,MAAM,IAAI,IAAI;AAE/B,QAAI,WAAW,KAAK;AAClB,YAAM,IAAI,sBAAsB,SAAS;AAAA,IAC3C;AAEA,QAAI,WAAW,KAAK;AAClB,YAAM,IAAI,oBAAoB,WAAW,WAAW;AAAA,IACtD;AAEA,QAAI,WAAW,KAAK;AAClB,YAAM,IAAI,gBAAgB,WAAW,GAAG,MAAM,IAAI,IAAI,EAAE;AAAA,IAC1D;AAEA,QAAI,WAAW,KAAK;AAClB,YAAM,IAAI,sBAAsB,WAAW,IAAI;AAAA,IACjD;AAEA,QAAI,UAAU,OAAO,SAAS,KAAK;AACjC,YAAM,IAAI,gBAAgB,WAAW,WAAW;AAAA,IAClD;AAEA,UAAM,IAAI;AAAA,MACR;AAAA,MACA,GAAG,WAAW,YAAY,MAAM;AAAA,IAClC;AAAA,EACF;AAAA,EAEQ,gBAAgB,MAAsB;AAC5C,QAAI,KAAK,UAAU,0BAA0B;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,GAAG,KAAK,MAAM,GAAG,2BAA2B,CAAC,CAAC;AAAA,EACvD;AAAA,EAEQ,YAAY,OAAuB;AACzC,WAAO,MAAM,QAAQ,uBAAuB,MAAM;AAAA,EACpD;AAAA,EAEQ,aAAa,SAA2C;AAC9D,UAAM,WAAW,KAAK,aAAa,IAAI,QAAQ,QAAQ,KAAK,CAAC;AAC7D,UAAM,QAAQ,SAAS,UAAU,CAAC,SAAS,KAAK,OAAO,QAAQ,EAAE;AAEjE,QAAI,SAAS,GAAG;AACd,eAAS,KAAK,IAAI;AAAA,IACpB,OAAO;AACL,eAAS,KAAK,OAAO;AAAA,IACvB;AAEA,aAAS,KAAK,CAAC,GAAG,MAAM,KAAK,gBAAgB,GAAG,CAAC,CAAC;AAClD,SAAK,aAAa,IAAI,QAAQ,UAAU,QAAQ;AAAA,EAClD;AAAA,EAEQ,kBACN,WACwC;AACxC,eAAW,YAAY,KAAK,aAAa,OAAO,GAAG;AACjD,YAAM,QAAQ,SAAS,KAAK,CAAC,YAAY,QAAQ,OAAO,SAAS;AACjE,UAAI,OAAO;AACT,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,oBAAoB,WAAyB;AACnD,eAAW,CAAC,UAAU,QAAQ,KAAK,KAAK,aAAa,QAAQ,GAAG;AAC9D,YAAM,WAAW,SAAS;AAAA,QACxB,CAAC,YAAY,QAAQ,OAAO;AAAA,MAC9B;AACA,UAAI,SAAS,WAAW,GAAG;AACzB,aAAK,aAAa,OAAO,QAAQ;AAAA,MACnC,WAAW,SAAS,WAAW,SAAS,QAAQ;AAC9C,aAAK,aAAa,IAAI,UAAU,QAAQ;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,gBACN,GACA,GACQ;AACR,WACE,EAAE,SAAS,SAAS,QAAQ,IAAI,EAAE,SAAS,SAAS,QAAQ;AAAA,EAEhE;AAAA,EAEQ,iBACN,UACA,SACgC;AAChC,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,SAAS,IAAI,GAAG,CAAC;AAC5D,UAAM,YAAY,QAAQ,aAAa;AAEvC,QAAI,SAAS,WAAW,GAAG;AACzB,aAAO,EAAE,UAAU,CAAC,EAAE;AAAA,IACxB;AAEA,UAAM,mBAAmB,IAAI;AAAA,MAC3B,SAAS,IAAI,CAAC,SAAS,UAAU,CAAC,QAAQ,IAAI,KAAK,CAAC;AAAA,IACtD;AAEA,QAAI,cAAc,YAAY;AAC5B,YAAMA,OACJ,QAAQ,UAAU,iBAAiB,IAAI,QAAQ,MAAM,IAChD,iBAAiB,IAAI,QAAQ,MAAM,KAAK,SAAS,SAClD,SAAS;AACf,YAAMC,SAAQ,KAAK,IAAI,GAAGD,OAAM,KAAK;AACrC,YAAME,QAAO,SAAS,MAAMD,QAAOD,IAAG;AAEtC,aAAO;AAAA,QACL,UAAUE;AAAA,QACV,YAAYD,SAAQ,IAAIC,MAAK,CAAC,GAAG,KAAK;AAAA,MACxC;AAAA,IACF;AAEA,UAAM,QACJ,QAAQ,UAAU,iBAAiB,IAAI,QAAQ,MAAM,KAChD,iBAAiB,IAAI,QAAQ,MAAM,KAAK,MAAM,IAC/C;AACN,UAAM,MAAM,KAAK,IAAI,SAAS,QAAQ,QAAQ,KAAK;AACnD,UAAM,OAAO,SAAS,MAAM,OAAO,GAAG;AAEtC,WAAO;AAAA,MACL,UAAU;AAAA,MACV,YAAY,MAAM,SAAS,SAAS,KAAK,GAAG,EAAE,GAAG,KAAK;AAAA,IACxD;AAAA,EACF;AACF;AAEO,SAAS,qBACd,QACgB;AAChB,SAAO,IAAI,eAAe,UAAU,CAAC,CAAC;AACxC;","names":["end","start","page"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "chat-adapter-twitter",
+  "version": "0.1.0",
+  "description": "Twitter / X adapter for chat",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@chat-adapter/shared": "^4.20.2"
+  },
+  "peerDependencies": {
+    "chat": "^4.20.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vercel/chat.git",
+    "directory": "packages/adapter-twitter"
+  },
+  "homepage": "https://github.com/vercel/chat#readme",
+  "bugs": {
+    "url": "https://github.com/vercel/chat/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "chat",
+    "twitter",
+    "x",
+    "bot",
+    "adapter"
+  ],
+  "license": "MIT"
+}