hermoso 0.1.152 → 0.1.157

package/README.md

@@ -5,13 +5,14 @@ scripts. Research the ads already winning in a market, generate finished image &
 composited in, copy + CTA included), publish them to your own social channels, and build & manage the ad
 campaigns behind them — all over [MCP](https://modelcontextprotocol.io) tools, a CLI, or installable Claude skills.
 
-**709 tools.** `tools/list` is always the authoritative set; `hermoso_capabilities` (free) returns the live model
+**714 tools.** `tools/list` is always the authoritative set; `hermoso_capabilities` (free) returns the live model
 catalog with exact per-render credit costs plus the full capability map.
 
 **What it connects to.** Ad platforms: Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads,
 Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads and ChatGPT Ads, plus product feeds in
-Google Merchant Center. Publishing and scheduling: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn,
-Pinterest, Bluesky and Telegram. Ad research: the Meta, Google and LinkedIn ad libraries plus organic TikTok,
+Google Merchant Center. Publishing and scheduling — **ten** channels: Facebook, Instagram, Threads, TikTok,
+YouTube, X, LinkedIn, Pinterest, Bluesky and Telegram. Messaging: WhatsApp (you message a person, so it is not an
+eleventh publishing channel). Ad research: the Meta, Google and LinkedIn ad libraries plus organic TikTok,
 Instagram, YouTube, Threads and Reddit. Analytics: Google Analytics 4, Google Search Console and every
 connected platform's own post and campaign insights. Files: Google Drive, Sheets, Docs and OneDrive.
 
@@ -36,7 +37,7 @@ Two shapes, and the right one is decided by **what your client can do**, not by
 | | tools in range | loaded per session |
 | --- | --- | --- |
 | Hosted connector, default roster | 291 | **166,043 tokens** |
-| Hosted connector, `?tools=all` | 703 | **456,392 tokens** |
+| Hosted connector, `?tools=all` | 706 | **456,392 tokens** |
 | stdio server (`npx -y hermoso mcp`) | 269 | **153,257 tokens** |
 | **CLI** | **all 681** | **0** |
 
@@ -118,7 +119,7 @@ block entirely if you signed in above; it is there for CI, where the process can
 
 Then ask your agent: *“Generate an image ad with Hermoso.”*
 
-### What the 709 tools cover
+### What the 714 tools cover
 
 **Ad spy / research** — `find_competitors`, `competitor_teardown`, `pull_competitor_ads`, `research_ads`; the
 Meta / Google / LinkedIn ad libraries (`search_meta_ads`, `search_google_ads`, `search_linkedin_ads`); organic
@@ -145,14 +146,28 @@ routed by a narrower auto-pool.
 per-render credit cost) with no ad framing: `generate_image` / `generate_video` with `useBrand:false`,
 `generate_voice`, `generate_text`.
 
-**Publish to your own channels** — Facebook, Instagram and Threads (`post_to_meta`), TikTok (`post_to_tiktok`),
-YouTube (`post_to_youtube` + `update_youtube_video`, `youtube_video_insights`, comments read/reply), X
-(`post_to_x`, `x_post_metrics`, `x_post_insights`, `x_mentions`), LinkedIn profile **and** company Pages
-(`post_to_linkedin`, `post_to_linkedin_page`), Pinterest (`post_to_pinterest` + boards), and Google Business
-Profile (`post_to_google_business` — Google grants this API per project, so access must be approved before Posts
-publish). `schedule_post` / `list_scheduled` / `cancel_scheduled` give you one content calendar across channels.
-`upload_file` brings in any external or local media, not just Hermoso renders.
+**Publish to your own channels** — **ten** of them: Facebook, Instagram and Threads (`post_to_meta`), TikTok
+(`post_to_tiktok`), YouTube (`post_to_youtube` + `update_youtube_video`, `youtube_video_insights`, comments
+read/reply), X (`post_to_x`, `x_post_metrics`, `x_post_insights`, `x_mentions`, `list_x_dms`, `send_x_dm`),
+LinkedIn profile **and** company Pages (`post_to_linkedin`, `post_to_linkedin_page`), Pinterest
+(`post_to_pinterest` + boards), Bluesky (`post_to_bluesky`, `delete_bluesky_post`, `bluesky_post_metrics`, plus
+`list_bluesky_convos` / `read_bluesky_dm` / `send_bluesky_dm`) and Telegram (`post_to_telegram`,
+`delete_telegram_message`, `list_telegram_chats`). `schedule_post` / `list_scheduled` / `cancel_scheduled` give
+you one content calendar over exactly that set. `upload_file` brings in any external or local media, not just
+Hermoso renders.
 *X posting bills credits per API call (X charges per request); a post containing a link costs 13× one without.*
+*Held back, and named rather than hidden:* **Google Business Profile** is built (`post_to_google_business`,
+reviews, Q&A, insights) and is not offered — Google allowlists that API per project and ours reads 0 QPM, so
+every call would 403 for every user. It is in `schedule_post`'s channel enum and refused at enqueue.
+
+**Message customers on WhatsApp** — messaging, not an eleventh publishing channel: you message a person, and
+there is no `post_to_whatsapp`. `list_whatsapp_accounts` / `whatsapp_account` find the Business Account and its
+numbers, `list_whatsapp_templates` / `create_whatsapp_template` / `delete_whatsapp_template` manage the templates
+Meta reviews, and `send_whatsapp_message` sends one — confirm-gated, because it reaches a real phone and Meta
+bills the business for the conversation. Two limits that are permanent facts about Meta's API rather than
+anything pending: **Hermoso does not receive WhatsApp webhooks, so there is no message history to read** — it is
+not an inbox surface and `list_inbox` does not cover it — and **outside the 24-hour window that opens when the
+customer messages first, WhatsApp accepts an APPROVED template and nothing else.**
 
 **Run the ads** — full campaign trees, built paused and read back before anything is reported, with every spend
 change confirm-gated, on **eleven** platforms: **Meta**, **Google Ads**, **LinkedIn Ads**, **Reddit Ads**,