One Agent, Every Platform
sanctumos/sanctum-social is a unified social media toolkit for AI agents. Instead of writing separate bots for each platform, you define your agent once and Sanctum Social handles the platform-specific plumbing. It launched with three integrations and went through a rapid hardening cycle in late October.
Platform Support
- X (Twitter): Tool registration, mention processing, and user block handling.
- Bluesky: Thread structure analysis, reply functions with message validation, and session management with file-backed persistence.
- Discord: Built following the same patterns as X and Bluesky — event handlers, queue management, and channel management all flow through the same plugin architecture.
Under the Hood
The October commits show serious engineering work beyond just "make it post":
- Pydantic V2 migration: All validators updated from V1 to V2 style.
- Bot detection hardening: False positives in handle normalization were causing the agent to ignore real users.
- Queue management: Robust error handling with proper resource cleanup, especially on Windows file systems.
- Configuration validation: YAML/JSON config files are now validated at load time with clear error messages.
- Comprehensive test coverage: Core modules got full test suites — queue manager, register tools, Bluesky utils, session management.
The major release commit on October 24 landed the official "Sanctum Social" rebrand, consolidating all of this into a coherent product.