hermoso 0.1.397 → 0.1.400

package/README.md

@@ -1,6 +1,6 @@
-# Hermoso — MCP, CLI & Skills
+# Hermoso: MCP, CLI & Skills
 
-Run your whole marketing operation from **any AI agent**: Claude Code, Claude.ai, Cursor, Codex, or your own
+**Marketing on autopilot**, run from **any AI agent**: Claude Code, Claude.ai, Cursor, Codex, or your own
 scripts. Research the ads already winning in a market, generate finished image & video ads (your real product
 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.
@@ -8,6 +8,10 @@ campaigns behind them, all over [MCP](https://modelcontextprotocol.io) tools, a
 **906 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.
 
+**A Chrome extension too.** [Hermoso: save and clone ads](https://chromewebstore.google.com/detail/hermoso-save-and-clone-ad/kmknkbldeilchhblbfddfnfbadmgcklc)
+saves any ad to your swipefile in one click, clones it for your brand, and pulls any company's ads from its
+website.
+
 **Most of it costs nothing.** Publishing and scheduling posts, building and managing paid campaigns, analytics
 and insights, comments and DMs, connectors, profiles and team seats are **free on every plan**, with no
 per-post or per-channel fee and no seat pricing. Credits are spent only on running an AI model (image, video,
@@ -19,8 +23,8 @@ charges per API request.
 Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads, ChatGPT Ads and AppLovin Ads, plus
 product feeds in 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) and Instagram DM automations (a keyword comment, a DM, a
-story reply or an ig.me link gets an automatic private reply). Ad research: the Meta, Google and LinkedIn ad libraries plus organic TikTok,
+person, so it is not an eleventh publishing channel) and DM automations on Instagram, Facebook Pages and
+Messenger, and X (a keyword comment, a DM, a story reply or an ig.me / m.me link gets an automatic reply). 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.
 
@@ -254,9 +258,18 @@ take** with native synchronized audio. `hermoso_capabilities` is the live list
 exact credit cost of every tier — and naming that model in `model` is how you get it, since an unnamed render is
 routed by a narrower auto-pool.
 
+**Ads Studio** (`make_static_ads`): pick products and a count and get a batch of finished static ads in one call,
+each a different selling angle and a different layout, with your real product photo and logo laid on. The product
+catalog it draws from (`list_products`, `add_product`, `refresh_products`, `update_product`, `remove_product`) is a
+cache of each product's live page, so names, photos and prices come from the page itself.
+
+**Swap a person into any video** (`recast_hook`, `recast_motion`): keep the scene, the cuts and the sound and change
+who is on screen, using your own photo, a saved creator or an AI person (in the web Studio you can describe a presenter in words).
+Real faces from your own photos need a paid plan; AI people work on every plan.
+
 **Raw model playground** — the full catalog (30+ image / video / voice / writing models, each with its exact
 per-render credit cost) with no ad framing: `generate_image` / `generate_video` with `useBrand:false`,
-`generate_voice`, `generate_text`.
+`generate_voice`, `generate_text`. The image default is Nano Banana 2.1.
 
 **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
@@ -297,6 +310,12 @@ DMed you, and a DM saying STOP opts that person out. Facebook is free like Insta
 automation is charged in credits for every mention, reply or DM X delivers plus each reply or DM sent, and running out
 of credits stops its X rules.
 
+**Autopilot posting** (`set_post_refill`, `get_post_refill`, `run_post_refill`): say how often, where and what
+about ("2 posts a day on Instagram and Bluesky about our slow-morning routine, let me review first") and Hermoso
+makes new posts from your brand and fills your calendar. Pick review first (each batch waits for your approval,
+edit or redo) or post automatically (straight onto the schedule, still pullable). It follows the notes you leave and
+writes from what has worked on each channel. Credits are used only when a post is made.
+
 **Run the ads** — full campaign trees, built paused and read back before anything is reported, with every spend
 change confirm-gated, on **twelve** platforms: **Meta**, **Google Ads**, **LinkedIn Ads**, **Reddit Ads**,
 **Pinterest Ads**, **Microsoft Advertising**, **ChatGPT Ads** (OpenAI's Advertiser API), **X Ads**, **TikTok Ads**,

package/mcp/tools.mjs

@@ -21186,7 +21186,7 @@ function memoryNoteVerdict(text) {
 
   server.registerTool('recast_motion', {
     title: 'Recast motion',
-    description: "Motion transfer: re-perform a clip's motion, camera and timing with YOUR character, product, clothes or place; the clip's sound is kept. image (+ images, named @Image1, @Image2… in prompt) supply who and what. engine auto (default): a person clip recast with photos of people -> h3 (H3 Max Recast: ≤4 photos, one per person, 5-30s, no shot over 15s, keeps the set, light, cuts and every beat); otherwise seedance (Seedance 2.5, ≤9 pictures, 4-30s, keeps the set and every beat; a person clip needs it to be our render or faceRoute, else wan ≤15s / kling). kling = Kling Motion Control (ONE picture, its background becomes the set, 3-30s); wan = Wan 3.0 Prime (≤9 pictures, keeps the set, ≤15s). Billed per output second; ~5 min for 5s; dryRun quotes it.",
+    description: "Motion transfer: re-perform a clip's motion, camera and timing with YOUR character, product, clothes or place; sound kept. image (+ images, @Image1, @Image2… in prompt) = who and what. engine auto (default), a person clip recast with people: one photo (talking, dance or full-body) or an AI person made from words, ≤15s -> wan (on the beat, keeps set and framing, follows every blink and mouth shape); several photos (one per person) or >15s -> h3 (H3 Max Recast: ≤4 photos, one per person, 5-30s, no shot over 15s, keeps set, light, cuts; engine h3 picks it by name); otherwise seedance (Seedance 2.5, ≤9 pictures, 4-30s, keeps set and beats; a person clip only if our render or faceRoute, else wan/kling). kling = Kling Motion Control (ONE picture, its background becomes the set, 3-30s); wan = Wan 3.0 Prime (≤9 pictures, keeps the set, ≤15s). Billed per output second, ~5 min per 5s; dryRun quotes.",
     inputSchema: {
       image: z.string().optional().describe('who performs it: the actor/character image URL (@Image1). Required on kling. No one yet: generate_image a portrait of an AI person from words (no reference photo) and pass its url, or a saved / preset creator’s portrait (list_creators). ' + LIKENESS_TERMS),
       images: z.array(z.string()).max(8).optional().describe('seedance/wan: more pictures, @Image2…: a character, product, outfit or place'),
@@ -21196,14 +21196,19 @@ function memoryNoteVerdict(text) {
       resolution: z.enum(['480p', '720p', '1080p']).optional().describe('seedance and wan default 1080p; h3 takes 720p or 1080p, default the clip’s own'),
       orientation: z.enum(['video', 'image']).optional().describe("kling only: which aspect to keep: the video's (default) or the image's"),
       faceRoute: z.enum(['face_lane']).optional().describe(FACE_ROUTE_CLIP_DESC),
+      dryRun: z.boolean().optional().describe('return the credits this exact job would hold and the engine auto picks, without rendering'),
       tier: z.enum(['pro', 'standard']).optional().describe("kling only: 'pro' (default): 1080p and real hand-object interaction. 'standard': about 25% fewer credits and faster, but 720p, and it tends to mime a held object with empty hands. hermoso_capabilities lists the exact credits for both"),
     },
     outputSchema: { ...JOB_OUT },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
-  }, wrap(async ({ image, images, video, prompt = '', engine, resolution, orientation = 'video', tier, faceRoute }) => {
+  }, wrap(async ({ image, images, video, prompt = '', engine, resolution, orientation = 'video', tier, faceRoute, dryRun }) => {
     const more = Array.isArray(images) ? (await Promise.all(images.slice(0, 8).map(toRef))).filter(Boolean) : [];
     if (!image && !more.length && !String(prompt || '').trim()) return { content: [{ type: 'text', text: 'Pass image (who performs it), images, or a prompt saying who or what performs the clip.' }], isError: true };
-    const r = await renderJob('motion', { ...(image ? { image: await toRef(image) } : {}), ...(more.length ? { images: more } : {}), video, prompt, orientation, engine: engine || 'auto', ...(resolution ? { resolution } : {}), ...(tier ? { tier } : {}), ...(faceRoute === 'face_lane' ? { faceRoute } : {}) }, 'Motion recast');
+    const _in = { ...(image ? { image: await toRef(image) } : {}), ...(more.length ? { images: more } : {}), video, prompt, orientation, engine: engine || 'auto', ...(resolution ? { resolution } : {}), ...(tier ? { tier } : {}), ...(faceRoute === 'face_lane' ? { faceRoute } : {}) };
+    // dryRun (2026-10-06): the description has promised "dryRun quotes" while the schema had no such field, so zod dropped
+    // it and an agent asking for a price got a PAID render. Now a quote: the worker's own hold, nothing queued.
+    if (dryRun) { const q = await quoteJob('motion', _in); return ok(`${quoteText(q, 'This motion recast')}${q?.label ? ` Engine: ${String(q.label).replace(/^Motion transfer · /, '')}.` : ''}`, { raw: q }); }
+    const r = await renderJob('motion', _in, 'Motion recast');
     const p = renderPayload(r) || {};
     return okVideo(`Recast video: ${r.url}${r.model ? `  (${r.model})` : ''}${p.note ? `\n${p.note}` : ''}`, r);
   }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermoso",
-  "version": "0.1.397",
+  "version": "0.1.400",
   "mcpName": "io.github.hermoso-ai/hermoso",
   "description": "Marketing on autopilot, run from your own AI agent. 906 tools. Publishing, scheduling, ad campaign management, comments, DMs and analytics cost no credits on every plan; credits are only for generating creative and for Ad Spy research. AD PLATFORMS: Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads, Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads, ChatGPT Ads and AppLovin Ads, plus product feeds in Google Merchant Center. PUBLISHING AND SCHEDULING: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky and Telegram. INSTAGRAM DM AUTOMATIONS: a keyword comment, a DM, a story reply or an ig.me link gets an automatic private reply from the brand. 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",