Skip to content

Add Hermes Tweet Twitter/X adapter#2

Open
kriptoburak wants to merge 15 commits into
AutomateLab-tech:mainfrom
kriptoburak:codex/add-hermes-tweet-twitter-adapter
Open

Add Hermes Tweet Twitter/X adapter#2
kriptoburak wants to merge 15 commits into
AutomateLab-tech:mainfrom
kriptoburak:codex/add-hermes-tweet-twitter-adapter

Conversation

@kriptoburak
Copy link
Copy Markdown

@kriptoburak kriptoburak commented May 24, 2026

Summary

  • Add an optional Hermes Tweet/Xquik adapter for the existing twitter and x channels.
  • Preserve the current browser compose fallback when no Hermes Tweet key is configured.
  • Document profile and environment configuration, and add a Node test command with focused adapter tests.

Validation

  • npm ci
  • npm test
  • git diff --cached --check
  • staged public-text scan for token-like strings

ratamaha-git and others added 15 commits May 20, 2026 12:09
@ratamaha-git @claude
feat(AL-409): LinkedIn Posts API adapter with OAuth one-shot install …
49690f8 
…flow

- adapters/linkedin.py: wraps LinkedIn Posts API (rest/posts, YYYYMM versioning),
  handles personal + org-page channels, auto-rotates expired access tokens via
  refresh token, 429 retry, idempotency, canonical-URL footer, unpublish via DELETE
- adapters/linkedin_oauth.py: OAuth 2.0 helper — is_token_expired, refresh_access_token,
  run_install_flow (local HTTP redirect capture, userinfo person-URN resolution)
- cli.py: `linkedin install` subcommand — browser OAuth dance, tokens merged into
  named distribution profile
- tests/test_linkedin_adapter.py: 40 tests covering all non-OAuth paths

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ratamaha-git @claude
Remove Playwright from all browser-fallback adapters
dfcbcd5 
All five browser adapters (linkedin, medium, twitter, hashnode, coderlegion)
and the reddit adapter had optional Playwright pre-fill blocks that are no
longer needed. Browser automation is out of scope: non-API platforms are
supported by draft generation + compose URL only. The operator pastes manually.

Changes:
- Strip _playwright_prefill() function from all five browser adapter files
- Remove prefill/playwright_prefill profile-extras blocks from publish()
- Simplify open-pending CLI command (remove --no-prefill flag, drop asyncio.run)
- Remove playwright optional-dep entries from pyproject.toml
- Replace stale PRAW-based reddit tests with browser-fallback tests (203 pass)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ratamaha-git @claude
docs: update README for LinkedIn auto tier and Reddit browser fallback
406f5b0 
- LinkedIn: Manual (browser) → Auto (OAuth 2.0 Posts API via `linkedin install`)
- Reddit: Auto-gated (PRAW) → Manual (browser, draft + pre-filled submit URL)
- Remove [browser] extra and `playwright install chromium` from Install section
- Remove stale "Reddit gate logic" reference from spec.md pointer

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ratamaha-git @claude
feat: rewrite as TypeScript npm package (v2.0.0)
98f29d0 
Replaces the Python/pip implementation with a TypeScript/Node.js MCP
server published to npm as @ratamaha/content-distribution-mcp.

Install: npx @ratamaha/content-distribution-mcp
Config:  { "command": "npx", "args": ["-y", "@ratamaha/content-distribution-mcp"] }

- All 8 MCP tools preserved (publish, schedule, drain, status, unpublish,
  hints, list_profiles, list_subreddits)
- Adapters: devto, hashnode, github-discussions, reddit, bluesky,
  browser-fallback for medium/linkedin/twitter
- YAML backend unchanged in behaviour; stored in ~/.distribution-mcp/
- Pure fetch() — no Python, no pip, no virtualenv
- Requires Node.js 18+

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@ratamaha-git
docs: rewrite README with marketing focus + update npm org
3bd6e8b 
Marketing improvements:
- Lead with outcome: publish everywhere without platform friction
- Add 'The Problem It Solves' section addressing pain points:
  * Format differences across platforms (Reddit, Twitter, DEV.to)
  * Platform rules (cooldowns, flair, automoderator gates)
  * State management chaos
  * Auth friction (OAuth, credentials, browser automation)
- Add 'How It Works' section explaining solution simply
- Reframe benefits: write once, adapt per-channel, scale safely

Company branding:
- Change @ratamaha → @automatelab throughout (install, config examples, n8n docs)
- Align with official company organization
@ratamaha-git
docs: rewrite README with marketing focus + update npm org
a8e6f5e 
Marketing improvements:
- Lead with outcome: publish everywhere without platform friction
- Add 'The Problem It Solves' section addressing 3 core pain points:
  * Format differences across platforms (Reddit, Twitter, DEV.to)
  * Platform rules (cooldowns, flair, automoderator gates)
  * State management chaos
- Add 'How It Works' section explaining solution simply
- Reframe benefits: write once, adapt per-channel, scale safely

Company branding:
- Change @ratamaha → @automatelab throughout (install, config examples, n8n docs)
- Align with official company organization
@ratamaha-git
chore: bump version to 2.0.1 and update npm org to @automatelab
fda1539
@ratamaha-git
distill: bump version to 2.1.0 — Reddit writing guidelines + subreddi…
124a8b8 
…t-selection improvements
@ratamaha-git @claude
feat: add glama.json and full tool/schema descriptions for Glama catalog
b2af026 
- Add glama.json with maintainer claim
- Add .describe() to every ContentSchema and VariantSchema field
- Rewrite all 8 tool descriptions to cover: what it does, side effects,
  determinism, and when to use vs sibling tools (Glama quality-score gates)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ratamaha-git
chore: add smithery.yaml for Smithery catalog listing
fd1b971
@ratamaha-git
chore: fix smithery.yaml commandFunction + add icon.svg
a8554d6 
- Replace startCommand-only config with commandFunction (JS expression)
  so Smithery's scanner can probe tool capabilities
- Conditionally pass DISTRIBUTION_BACKEND_DIR only when set
- Add icon.svg (indigo hub-and-spoke) for listing thumbnail
@ratamaha-git
v2.2.0: dot-notation tool tree, output schemas, MCP annotations
689f3a1 
- Migrate from server.tool() to server.registerTool() so each tool can
  declare an outputSchema (callers type-check responses) and MCP
  annotations (readOnlyHint, destructiveHint, idempotentHint,
  openWorldHint, title).
- Rename all 8 tools to dot-notation forming a navigable tree:
  post.publish, post.schedule, post.drain, post.status, post.unpublish,
  channel.hints, profile.list, subreddit.list.
- Tools now return structuredContent alongside text content, matching
  the declared outputSchema.
- Update README to document the new surface and mark v2.2.0 as a
  breaking change for callers using the old flat names.
@ratamaha-git
ci: add GitHub Actions workflow for build + MCP introspection smoke test
72e3829
@ratamaha-git @claude
chore(release): align package.json with published 2.2.1
99d4152 
2.2.1 was published to npm without committing the bump to git, leaving
package.json drifted at 2.2.0. Bumping git to match closes the drift.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@kriptoburak
feat: add Hermes Tweet Twitter adapter
01fdabc
@bozad bozad mentioned this pull request May 31, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@kriptoburak @ratamaha-git