hermoso 0.1.213 → 0.1.215

package/mcp/tools.mjs

@@ -2578,10 +2578,15 @@ function buildTools(rawServer, opts = {}, sink = null) {
     if (g && !TOOL_GROUP_NAMES.includes(g)) return { content: [{ type: 'text', text: `Unknown group "${g}". Groups: ${TOOL_GROUP_NAMES.join(', ')}.` }], isError: true };
     const rows = [];
     const tokenWeight = tokenWeightFor(ctx);
+    const _offGroup = new Map(); // name → { grp, h } for tools the group filter excluded (see below)
     for (const [name, h] of Object.entries(ctx.handleOf)) {
       if (!h) continue;
       const grp = ctx.groupOf[name] || 'core';
-      if (g && grp !== g) continue;
+      // A GROUP FILTER NARROWS, IT NEVER HIDES (2026-09-07). `find_tools({query:'tiktok_creator_info', group:'channels'})` reported a
+      // dead end because the tool lives in channel_admin — the exact-name hit was thrown away by the filter, and the agent
+      // was told we have no such tool. Off-group matches are kept aside; if the scoped search finds nothing, they are
+      // returned WITH their real group so the caller learns which group to enable instead of giving up.
+      if (g && grp !== g) { if (!_offGroup.has(name)) _offGroup.set(name, { grp, h }); continue; }
       const desc = String(h.description || '');
       let score = 0;
       if (q) {
@@ -2615,6 +2620,14 @@ function buildTools(rawServer, opts = {}, sink = null) {
     // THE MOST VALUABLE ROW ON THE DEFECT BOARD: what a user asked for, in their agent's words, that our catalog could
     // not name. Unquoted and lowercased on purpose — the ledger collapses quoted strings to <q>, and one group per
     // distinct ask is exactly what we want to read.
+    if (!total && g && _offGroup.size) {
+      // Re-score the excluded tools by NAME only (the cheap, unambiguous half): an exact or token hit outside the
+      // asked-for group is an answer, not a dead end — "it exists, in channel_admin; enable that group".
+      const qw = String(q || '').toLowerCase().split(/[^a-z0-9_]+/).filter(Boolean);
+      const off = [..._offGroup.entries()].filter(([name]) => qw.some((w) => name === w || name.includes(w))).slice(0, cap)
+        .map(([name, { grp, h }]) => `• ${name} [${grp}, not in the ${g} group] — ${String(h.description || '').replace(/\s+/g, ' ').slice(0, 200)}`);
+      if (off.length) return ok(`Nothing in the ${g} group matches, but these tools do — they live in another group (enable it with enable_tools, or call them by name through run_tool):\n${off.join('\n')}`, { query: q, group: g, offGroup: off.length });
+    }
     if (!total) reportDeadEnd('no_match', 'find_tools', `find_tools found nothing for: ${(q || '(empty)').replace(/["'`]/g, '').slice(0, 80)}${g ? ' in group ' + g : ''}`, { query: q, group: g });
     for (const r of top) r.params = compactParams(ctx.handleOf[r.name]);
     const lines = top.map((r) => `• ${r.name} [${r.group}${r.inRoster ? '' : ', not in your list'}${r.hold ? ', ' + r.hold : ''}] — ${r.description}\n    params: ${Object.entries(r.params).map(([k, v]) => `${k}: ${v}`).join(' | ') || '(none)'}`);
@@ -3914,7 +3927,7 @@ function buildTools(rawServer, opts = {}, sink = null) {
 
   server.registerTool('list_threads_profile_posts', {
     title: 'Read a public Threads account\u2019s posts',
-    description: 'The recent PUBLIC posts of any Threads account \u2014 the raw material for a teardown, for mine_angles, and for ad copy in the language the market actually uses. Use it after threads_profile, or on its own when you already know the handle, and then USE what it returns: draft the brand\u2019s next post or plan_ad off the angles you found. AN EMPTY LIST IS NEVER PROOF THEY HAVE NOT POSTED \u2014 Meta returns nothing for a private account, for any account under 100 followers, and for handles our app is not yet approved to read (the `threads_profile_discovery` permission); the note says which of those applies. Read-only, 0 credits. Needs Threads connected.',
+    description: 'The recent PUBLIC posts of any Threads account \u2014 the raw material for a teardown, for mine_angles, and for ad copy in the language the market actually uses. Use it after threads_profile, or on its own when you already know the handle, and then USE what it returns: draft the brand\u2019s next post or plan_ad off the angles you found. AN EMPTY LIST IS NEVER PROOF THEY HAVE NOT POSTED \u2014 Meta returns nothing for a private account, for any account under 100 followers, and when the Threads connection predates the `threads_profile_discovery` permission (approved for the app 2026-09-05; reconnect Threads to grant it); the note says which of those applies. Read-only, 0 credits. Needs Threads connected.',
     inputSchema: {
       username: z.string().describe('the Threads handle \u2014 "nike", "@nike", or a threads.net profile link'),
       limit: z.number().optional().describe('how many posts (1\u201350, default 25)'),
@@ -6779,6 +6792,10 @@ function buildTools(rawServer, opts = {}, sink = null) {
   // onboarding (user token + marketing_messages_messenger) rides the existing Meta connection. App-Review gated:
   // until Meta grants the scope it works for app-role holders only, and list_messenger_subscribers says which.
   // Every endpoint, limit and error code: lib/messenger-marketing.mjs (read live 2026-09-05).
+  // MESSENGER MARKETING MESSAGES ARE A CHANNEL CAPABILITY, NOT PAID ADS (2026-09-07). This block was registered inside
+  // the ads section, so it rode the heaviest opt-in group while dispatching to no paid-advertising route — unreachable
+  // for anyone who had not switched on 'ads', and counted as 'ads' tools on an account with no ad platform at all.
+  server.group('channel_admin'); // Messenger marketing — the marker at the end of this block re-opens 'ads'
   server.registerTool('list_messenger_subscribers', {
     title: 'List Messenger marketing-message subscribers',
     description: 'The people who OPTED IN to marketing messages from a Facebook Page — their subscription tokens, the only address a paid Messenger marketing message can go to (there is no "message everyone"). Also reports whether this Meta connection carries the marketing_messages_messenger permission; a connection made before it was added must be reconnected. Free.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermoso",
-  "version": "0.1.213",
+  "version": "0.1.215",
   "mcpName": "io.github.hermoso-ai/hermoso",
   "description": "AI ad studio and marketing MCP server with 801 tools. Research the ads already running in any market, generate finished image, video and UGC avatar ads, publish and schedule them to your own channels, build and manage the ad campaigns behind them, and read what they achieved. 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, Instagram, YouTube, Threads and Reddit. ANALYTICS: Google Analytics 4, Google Search Console and every connected platform's own post and campaign insights. Also brand onboarding, 50+ image and video generation models, ad scoring, competitor teardowns, Google Drive and OneDrive, a CLI and installable Claude skills.",
   "type": "module",