feat: Twitter Post Action Implementation

[0xPBIT]

Relates to:

N/A - Plugin implementation for Twitter posting functionality via action

Risks

Low - This is a new plugin that adds Twitter posting capability. The main risks are:

• Failed tweets due to rate limiting or authentication issues
• Potential for tweets that are too long (mitigated by automatic truncation)
• No risk to existing functionality as this is an isolated plugin

Background

What does this PR do?

Adds a Twitter plugin that enables posting tweets through the agent-twitter-client package. Key features:

• Implements POST_TWEET action for sending tweets
• Handles Twitter authentication via environment variables
• Automatically truncates tweets that exceed character limits
• Provides detailed error handling and logging
• Supports dry run mode for testing

What kind of change is this?

Features (non-breaking change which adds functionality)

• Adds new Twitter posting capability
• Uses the standalone agent-twitter-client package
• Implements proper error handling and character limit enforcement

Documentation changes needed?

My changes require a change to the project documentation:

• Add Twitter plugin setup instructions
• Document required environment variables:
  • TWITTER_USERNAME
  • TWITTER_PASSWORD
  • TWITTER_EMAIL
  • TWITTER_DRY_RUN (optional)
  • TWITTER_2FA_SECRET (optional)

Testing

Where should a reviewer start?

1. Review packages/plugin-twitter/src/actions/post.ts for the main implementation
2. Check error handling in postTweet function
3. Review tweet composition logic in composeTweet function
4. Verify environment variable handling

Detailed testing steps

1. Set up environment variables in .env:

TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email
TWITTER_DRY_RUN=false

2. Test tweet posting:

# Start with dry run mode
TWITTER_DRY_RUN=true pnpm dev

# Test actual posting
TWITTER_DRY_RUN=false pnpm dev

3. Verify error handling:

• Try posting a tweet > 180 characters (should truncate)
• Try posting with invalid credentials (should show error)
• Try posting with missing credentials (should validate)

4. Check logging:

• Verify credential validation logs
• Check tweet content generation logs
• Verify error messages are descriptive

Deploy Notes

• Requires agent-twitter-client package
• Environment variables must be set for Twitter authentication
• No database changes required

[0xPBIT]

Several people have commented in the discord coders chat about twitter functionality from an action instead of the hard coded client loop. I've opened this PR just to show an example of how this can be done.

This is a small demo where I workshop a tweet with c3po agent to come up with a tweet. Then I can say "go tweet that" and the agent will put it on their twitter profile -- without using the client-twitter package.

[monilpat]

Amazing work thanks for doing this please address comments

[0xPBIT]

thanks for the review @monilpat this is my first time opening a PR so I'll address the changes.