Twitter channel

This pack gives an agent tweet posting, replies, quotes, threads, engagement, search, trends, direct messages, analytics and scheduling through twitter-api-v2.

Installation

npm install @framers/agentos-ext-channel-twitter

Peer dependency: @framers/agentos >=0.10.40.

Usage

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-channel-twitter',
        options: {
          bearerToken: process.env.TWITTER_BEARER_TOKEN,
          apiKey: process.env.TWITTER_API_KEY,
          apiSecret: process.env.TWITTER_API_SECRET,
          accessToken: process.env.TWITTER_ACCESS_TOKEN,
          accessSecret: process.env.TWITTER_ACCESS_SECRET,
        },
      },
    ],
  },
});

Configuration

Credentials resolve from options, then secrets, then the listed environment variables in order. options.secrets takes precedence over context.secrets. Resolution uses nullish fallback, so an empty string blocks later values.

Tools

twitterPost

twitterReply

twitterQuote

twitterLike

twitterRetweet

twitterSearch

twitterTrending

twitterTimeline

twitterDm

twitterAnalytics

twitterSchedule

twitterThread

Channel adapter

The adapter registers platform twitter. Sending posts the first text block, uploads image and video blocks through the SDK, attaches poll options and converts poll duration from hours to minutes. It reads replyToMessageId for replies and ignores conversationId. Failed media uploads are skipped. Reactions call the like operation regardless of the supplied reaction.

Activation initializes API clients. Connection status follows the service's running state, with initialization errors exposed in connection information. The adapter stores handlers but emits no inbound events. Typing indicators do nothing.

Notes

A bearer token supplies the read client. Posting, engagement, media uploads, home timeline and direct messages require apiKey, apiSecret, accessToken and accessSecret together. The service also uses that write client for reads when no bearer token is set, although the manifest declares twitter.bearerToken required.

If neither bearerToken nor apiKey is set, activation attempts to load a stored Twitter access token through FileTokenStore from @framers/agentos/auth. Initialization throws if no read or write client can be created.

Write tools publish tweets, send messages or change likes and retweets. Threads post sequentially without rollback. recipientId is passed directly to the SDK's sendDmInConversation method. Timeline and direct-message listing requests are capped at 100 results; search forwards maxResults without a local cap and defaults to relevancy sorting.

Scheduling stores timers in memory without persistence or cancellation. A past timestamp posts immediately and ignores mediaPath. Future scheduled posts upload media at execution time and silently discard failures. Pack deactivation shuts down the service but does not clear scheduled timers.

License

Apache-2.0