hermoso 0.1.8 → 0.1.9

package/bin/hermoso.mjs

@@ -4,7 +4,7 @@
 // in skills/ wrap these commands. Same /api as the MCP server.
 //
 //   npm i -g  (from this repo)  OR  node bin/hermoso.mjs <cmd>
-//   hermoso auth login --token <key>                   # key from app.hermoso.ai → Settings → Agents & API
+//   hermoso auth login                                 # browser sign-in (loopback, like gh/heroku); --token <key> for CI
 //   hermoso capabilities                                 # learn valid model ids + costs (run first)
 //   hermoso create --brand Flourish --product "protein pancakes" --format image
 //   hermoso generate image --prompt "…" --ref ./bag.png --wait

package/mcp/tools.mjs

@@ -662,6 +662,38 @@ export function registerTools(server) {
     return okVideo(`Finished video ready: ${r.url}  [job ${r.jobId}]`, r);
   }));
 
+
+  server.registerTool('post_edit', {
+    title: 'Post-production edit',
+    description: "MECHANICAL post-production on an EXISTING rendered video (its served mp4 URL) — an ordered plan of whitelisted primitives executed by ffmpeg (+ Chrome for typeset cards) in seconds for ~2 credits flat, NO AI model, the original untouched (returns a NEW video). The lane for: append a branded end card ('add an end card with our logo and website' — ADDS its seconds, never re-renders), trim, speed (0.5-2x), mute (whole or a window), audio_gain (-20..+6 dB), fade_out, corner logo watermark, anti-AI film grain. Up to 6 ops per plan, applied in order. Brand assets (name/domain/logo/accent) load from the workspace brand automatically; override per-call if needed. NEVER use generate_video/render_ad for these mechanical asks.",
+    inputSchema: {
+      videoUrl: z.string().describe('the served URL of the video to edit'),
+      ops: z.array(z.object({
+        op: z.enum(['trim', 'speed', 'mute', 'audio_gain', 'fade_out', 'append_card', 'watermark', 'grain']),
+        start: z.number().optional().describe('trim/mute window start (s)'),
+        end: z.number().optional().describe('trim/mute window end (s)'),
+        factor: z.number().optional().describe('speed 0.5-2'),
+        db: z.number().optional().describe('audio_gain -20..+6 dB'),
+        seconds: z.number().optional().describe('fade_out 0.3-3s / append_card 2-5s'),
+        headline: z.string().optional().describe('append_card: line instead of the brand name'),
+        sub: z.string().optional().describe('append_card: small line under it (defaults to the brand website)'),
+        corner: z.enum(['tl', 'tr', 'bl', 'br']).optional().describe('watermark corner (default br)'),
+        intensity: z.enum(['default', 'strong']).optional().describe('grain look'),
+      })).describe('the ordered edit plan (max 6 ops)'),
+      brandName: z.string().optional().describe('override the workspace brand name'),
+      domain: z.string().optional().describe('override the brand website'),
+      accent: z.string().optional().describe('override the brand accent hex'),
+    },
+    outputSchema: { ...JOB_OUT },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  }, wrap(async (a) => {
+    let b = {};
+    try { const bk = PROFILE !== 'default' ? `heist.brand.v1.${PROFILE}` : 'heist.brand.v1'; b = JSON.parse((await apiGet(`/api/store/${encodeURIComponent(bk)}`))?.value || 'null') || {}; } catch {}
+    const pal = (Array.isArray(b.palette) ? b.palette : []).filter(c => /^#[0-9a-f]{6}$/i.test(String(c || '')));
+    const r = await renderJob('postedit', { videoUrl: a.videoUrl, ops: (a.ops || []).slice(0, 6), brandName: a.brandName || b.name || '', domain: a.domain || b.domain || '', logo: b.logo || '', accent: a.accent || pal[0] || '' }, 'MCP post edit');
+    return okVideo(`Edited video ready: ${r.url}${Array.isArray(r?.raw?.applied) ? `  (${r.raw.applied.join(', ')})` : ''}  [job ${r.jobId}]`, r);
+  }));
+
   server.registerTool('fix_beat', {
     title: 'Fix a video beat',
     description: "Surgically re-render ONE time window (1.5-8s) of an existing rendered video and splice it back on the VIDEO TRACK ONLY — the rest of the video and ALL audio stay byte-identical. Use when one beat/shot is broken ('the shot at 8 seconds glitches') and a full re-render would waste the parts that worked; bills only the replacement clip's seconds (~1/3 of a full render). Do NOT pick a window covering spoken dialogue (a video-only splice under speech breaks lip-sync) — pass speechWindows to enforce this.",
@@ -1187,6 +1219,29 @@ export function registerTools(server) {
   }));
 
   // ---------- assets ----------
+
+  server.registerTool('list_library', {
+    title: 'List library',
+    description: "Browse this workspace's Library — every image/video generated in the Studio, newest first (the same Library the web app shows). Returns served URLs you can open directly or hand to fetch_asset for a download link, plus each asset's kind, model, and age. Free, read-only.",
+    inputSchema: {
+      kind: z.enum(['image', 'video', 'all']).optional().describe("filter by asset kind (default 'all')"),
+      limit: z.number().optional().describe('max assets to return (default 20, max 60)'),
+    },
+    outputSchema: { assets: z.array(z.object({ url: z.string(), kind: z.string().optional(), model: z.string().optional(), ageHours: z.number().optional() })).optional() },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  }, wrap(async (a) => {
+    const ak = PROFILE !== 'default' ? `heist.assets.v1.${PROFILE}` : 'heist.assets.v1';
+    let list = [];
+    try { list = JSON.parse((await apiGet(`/api/store/${encodeURIComponent(ak)}`))?.value || 'null') || []; } catch {}
+    if (!Array.isArray(list)) list = [];
+    const kind = a.kind && a.kind !== 'all' ? a.kind : null;
+    const lim = Math.min(60, Math.max(1, +a.limit || 20));
+    const assets = list.filter(x => x && x.url && (!kind || x.kind === kind)).slice(0, lim)
+      .map(x => ({ url: /^https?:/.test(x.url) ? x.url : `${API_BASE}${x.url}`, kind: x.kind || '', model: x.model || '', ageHours: x.at ? Math.round((Date.now() - x.at) / 36e5) : undefined }));
+    if (!assets.length) return ok('The Library is empty for this workspace — render something first.', { assets: [] });
+    return ok(`${assets.length} asset${assets.length === 1 ? '' : 's'} (newest first):\n` + assets.map((x, i) => `  ${i + 1}. [${x.kind || '?'}${x.model ? ' · ' + x.model : ''}${x.ageHours != null ? ' · ' + x.ageHours + 'h ago' : ''}] ${x.url}`).join('\n'), { assets });
+  }));
+
   server.registerTool('fetch_asset', {
     title: 'Fetch asset',
     description: 'Resolve a generated asset reference (a /generated/… path or any URL) to a clickable absolute URL + a direct download URL.',

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "hermoso",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "mcpName": "io.github.hermoso-ai/hermoso",
-  "description": "Generate finished VIDEO ADS, image ads and UGC avatar ads for any brand with AI \u2014 and spy on competitor ads across the Meta, Google and LinkedIn ad libraries plus TikTok/Instagram/YouTube organic. MCP server, CLI and Claude skills for Hermoso, the AI ad studio: brand onboarding, 30+ image/video models, finished-ad pipeline (script, voiceover, music, brand end card), ad scoring and competitor teardowns.",
+  "description": "Generate finished VIDEO ADS, image ads and UGC avatar ads for any brand with AI — and spy on competitor ads across the Meta, Google and LinkedIn ad libraries plus TikTok/Instagram/YouTube organic. MCP server, CLI and Claude skills for Hermoso, the AI ad studio: brand onboarding, 30+ image/video models, finished-ad pipeline (script, voiceover, music, brand end card), ad scoring and competitor teardowns.",
   "type": "module",
   "bin": {
     "hermoso": "bin/hermoso.mjs"