singleclaw-connectors

Small, marketing-first connector runtime code for Singleclaw.

This package is intentionally narrower than Activepieces:

• one focused code folder per provider
• explicit OAuth helpers
• explicit account sync
• explicit publish/action helpers
• no generic workflow engine

Current scope

• reusable connector core
• LinkedIn OAuth
• LinkedIn token refresh
• LinkedIn account sync
• LinkedIn text, link, and image post publishing

Design rules

• platform app credentials stay outside brand connection state
• brand connection state stores brand-level config and encrypted tokens
• synced accounts stay connector-local but map cleanly to Singleclaw's BrandConnectionAccountRecord
• provider logic stays inside src/<provider>/

LinkedIn flow

1. Frontend or gateway asks the connector for an authorization URL.
2. Callback exchanges the code for tokens.
3. Tokens are stored by the caller.
4. Caller runs account sync and stores the returned accounts.
5. Agent tools or UI call publishPost.
6. The connector refreshes tokens when needed and returns updated tokens if they changed.

Notes

• The LinkedIn implementation in this package is a clean Singleclaw-oriented port, not an embedded Activepieces runtime.
• Some LinkedIn request shapes were informed by the MIT-licensed Activepieces LinkedIn piece in the local repo.