gunni 0.3.5 → 0.3.7

package/dist/index.js

@@ -69400,7 +69400,8 @@ async function downloadImage(url2, outputPath, onProgress) {
   const correctExt = await detectImageFormat(outputPath);
   const currentExt = extname(outputPath).toLowerCase();
   if (correctExt && correctExt !== currentExt) {
-    const fixedPath = outputPath.slice(0, -currentExt.length) + correctExt;
+    const basePath = currentExt ? outputPath.slice(0, -currentExt.length) : outputPath;
+    const fixedPath = basePath + correctExt;
     await rename(outputPath, fixedPath);
     return fixedPath;
   }
@@ -69431,7 +69432,8 @@ async function saveImageData(data, outputPath, onProgress) {
   const correctExt = await detectImageFormat(outputPath);
   const currentExt = extname(outputPath).toLowerCase();
   if (correctExt && correctExt !== currentExt) {
-    const fixedPath = outputPath.slice(0, -currentExt.length) + correctExt;
+    const basePath = currentExt ? outputPath.slice(0, -currentExt.length) : outputPath;
+    const fixedPath = basePath + correctExt;
     await rename(outputPath, fixedPath);
     return fixedPath;
   }
@@ -70466,7 +70468,7 @@ var ModelRouter = class {
     const provider = this.resolveProvider(opts.model);
     let spinner;
     if (opts.showSpinner !== false) {
-      spinner = ora("Starting\u2026").start();
+      spinner = ora("Painting pixels\u2026").start();
     }
     const updateSpinner = (status) => {
       if (spinner) spinner.text = status;
@@ -86261,7 +86263,7 @@ var RemoteClient = class {
         }
       }
     );
-    this.client = new Client({ name: "gunni-cli", version: "0.3.5" });
+    this.client = new Client({ name: "gunni-cli", version: "0.3.7" });
     await this.client.connect(transport);
   }
   async callTool(name, args) {
@@ -86553,7 +86555,14 @@ function resolveVariantPath(template, index) {
   return `${base}-${index}${ext}`;
 }
 async function handleRemote(input, prompt, operation, opts, json2, apiKey, serverUrl) {
-  const spinner = json2 ? void 0 : ora("Connecting to Gunni API\u2026").start();
+  const spinnerLabels = {
+    generate: "Painting pixels\u2026",
+    edit: "Reworking the canvas\u2026",
+    describe: "Studying the image\u2026",
+    upscale: "Enhancing resolution\u2026",
+    "remove-bg": "Cutting out the background\u2026"
+  };
+  const spinner = json2 ? void 0 : ora(spinnerLabels[operation]).start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -86603,7 +86612,7 @@ async function handleRemote(input, prompt, operation, opts, json2, apiKey, serve
     if (opts.width) toolArgs.width = opts.width;
     if (opts.height) toolArgs.height = opts.height;
     if (opts.seed !== void 0) toolArgs.seed = opts.seed;
-    update("Calling Gunni API\u2026");
+    update(spinnerLabels[operation]);
     const client2 = new RemoteClient();
     await client2.connect(apiKey, serverUrl);
     const result = await client2.callTool("image", toolArgs);
@@ -86624,7 +86633,7 @@ async function handleRemote(input, prompt, operation, opts, json2, apiKey, serve
         const r2 = remoteResults[i2];
         if (!r2.assetUrl) continue;
         const requestedPath2 = remoteResults.length === 1 ? opts.output ?? `gunni-${operation}-${Date.now()}.png` : opts.output ? resolveVariantPath(opts.output, i2 + 1) : `gunni-${operation}-${Date.now()}-${i2 + 1}.png`;
-        update("Downloading result\u2026");
+        update("Saving to disk\u2026");
         const finalPath2 = await downloadImage(r2.assetUrl, requestedPath2, update);
         downloadedResults.push({
           image: { path: finalPath2, url: r2.assetUrl, width: r2.width ?? 0, height: r2.height ?? 0 },
@@ -86656,7 +86665,7 @@ async function handleRemote(input, prompt, operation, opts, json2, apiKey, serve
       throw new GunniError("No image in remote response", "NO_IMAGE");
     }
     const requestedPath = opts.output ?? `gunni-${operation}-${Date.now()}.png`;
-    update("Downloading result\u2026");
+    update("Saving to disk\u2026");
     const finalPath = await downloadImage(img.assetUrl, requestedPath, update);
     spinner?.succeed("Done");
     if (json2) {
@@ -86724,9 +86733,9 @@ async function handleGenerate(prompt, modelId, opts, json2) {
     return;
   }
   const results = [];
-  const spinner = json2 ? void 0 : ora(`Generating variant 1 of ${variantCount}\u2026`).start();
+  const spinner = json2 ? void 0 : ora(`Painting variant 1 of ${variantCount}\u2026`).start();
   for (let i2 = 1; i2 <= variantCount; i2++) {
-    if (spinner) spinner.text = `Generating variant ${i2} of ${variantCount}\u2026`;
+    if (spinner) spinner.text = `Painting variant ${i2} of ${variantCount}\u2026`;
     const outputPath = opts.output ? resolveVariantPath(opts.output, i2) : `gunni-${modelId}-${Date.now()}-${i2}.png`;
     const router = new ModelRouter();
     const result = await router.generate({
@@ -86775,15 +86784,15 @@ async function handleGenerate(prompt, modelId, opts, json2) {
 }
 async function handleEdit(imagePath, prompt, modelId, opts, json2) {
   const variantCount = opts.variants ?? 1;
-  const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+  const spinner = json2 ? void 0 : ora("Reworking the canvas\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
   const provider = getProviderForModel(modelId);
   const results = [];
   for (let i2 = 1; i2 <= variantCount; i2++) {
-    if (variantCount > 1) update(`Editing variant ${i2} of ${variantCount}\u2026`);
-    else update("Editing\u2026");
+    if (variantCount > 1) update(`Reworking variant ${i2} of ${variantCount}\u2026`);
+    else update("Reworking the canvas\u2026");
     const editResult = await provider.editImage({
       imagePath,
       prompt,
@@ -86843,7 +86852,7 @@ async function handleEdit(imagePath, prompt, modelId, opts, json2) {
   }
 }
 async function handleDescribe(imagePath, modelId, json2) {
-  const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+  const spinner = json2 ? void 0 : ora("Studying the image\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -86857,7 +86866,7 @@ async function handleDescribe(imagePath, modelId, json2) {
     );
   }
   const imageUrl = await uploadToFal(imagePath, update);
-  update("Analyzing\u2026");
+  update("Reading the pixels\u2026");
   const provider = new FalProvider();
   const result = await provider.call(
     modelDef.endpoint,
@@ -86888,7 +86897,7 @@ async function handleDescribe(imagePath, modelId, json2) {
   }
 }
 async function handleUpscale(imagePath, modelId, opts, json2) {
-  const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+  const spinner = json2 ? void 0 : ora("Enhancing resolution\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -86898,7 +86907,7 @@ async function handleUpscale(imagePath, modelId, opts, json2) {
     throw new GunniError(`Unknown model: ${modelId}`, "UNKNOWN_MODEL");
   }
   const imageUrl = await uploadToFal(imagePath, update);
-  update("Upscaling\u2026");
+  update("Adding more pixels\u2026");
   const provider = new FalProvider();
   const result = await provider.call(
     modelDef.endpoint,
@@ -86947,7 +86956,7 @@ async function handleUpscale(imagePath, modelId, opts, json2) {
   }
 }
 async function handleRemoveBg(imagePath, modelId, opts, json2) {
-  const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+  const spinner = json2 ? void 0 : ora("Cutting out the background\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -86957,7 +86966,7 @@ async function handleRemoveBg(imagePath, modelId, opts, json2) {
     throw new GunniError(`Unknown model: ${modelId}`, "UNKNOWN_MODEL");
   }
   const imageUrl = await uploadToFal(imagePath, update);
-  update("Removing background\u2026");
+  update("Snipping away\u2026");
   const provider = new FalProvider();
   const result = await provider.call(
     modelDef.endpoint,
@@ -87044,7 +87053,7 @@ Run 'gunni list models --type video' for details.
         "NO_API_KEY",
         json2 ? void 0 : `Run ${import_picocolors4.default.bold("gunni")} to set up, or: gunni config --set-gunni-key YOUR_KEY`
       );
-      const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+      const spinner = json2 ? void 0 : ora("Rolling camera\u2026").start();
       const update = (s2) => {
         if (spinner) spinner.text = s2;
       };
@@ -87101,7 +87110,7 @@ Run 'gunni list models --type video' for details.
         }
       }
       const provider = getProviderForModel(modelId);
-      update("Generating video\u2026");
+      update("Rendering frames\u2026");
       const result = await provider.generateVideo({
         prompt,
         model: modelId,
@@ -87160,7 +87169,7 @@ Run 'gunni list models --type video' for details.
   });
 }
 async function handleRemote2(input, opts, json2, apiKey, serverUrl) {
-  const spinner = json2 ? void 0 : ora("Connecting to Gunni API\u2026").start();
+  const spinner = json2 ? void 0 : ora("Rolling camera\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -87224,7 +87233,7 @@ async function handleRemote2(input, opts, json2, apiKey, serverUrl) {
     if (imageUrl) toolArgs.image = imageUrl;
     if (opts.duration !== void 0) toolArgs.duration = opts.duration;
     if (opts.style) toolArgs.style = opts.style;
-    update("Generating video\u2026");
+    update("Rendering frames\u2026");
     const client2 = new RemoteClient();
     await client2.connect(apiKey, serverUrl);
     let result = await client2.callTool("video", toolArgs);
@@ -87250,7 +87259,7 @@ async function handleRemote2(input, opts, json2, apiKey, serverUrl) {
       spinner?.fail("No video returned");
       throw new GunniError("No video in remote response", "NO_VIDEO");
     }
-    update("Downloading video\u2026");
+    update("Saving to disk\u2026");
     const finalPath = await downloadMedia(videoAssetUrl, requestedPath, update);
     let audioPath;
     const audioAssetUrl = result.audio?.assetUrl;
@@ -87325,7 +87334,7 @@ Run 'gunni list models --type audio' for details.
         "NO_API_KEY",
         json2 ? void 0 : `Run ${import_picocolors5.default.bold("gunni")} to set up, or: gunni config --set-gunni-key YOUR_KEY`
       );
-      const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+      const spinner = json2 ? void 0 : ora("Finding the right voice\u2026").start();
       const update = (s2) => {
         if (spinner) spinner.text = s2;
       };
@@ -87349,7 +87358,7 @@ Run 'gunni list models --type audio' for details.
           falInput.audio_url = opts.voice;
         }
       }
-      update("Generating audio\u2026");
+      update("Recording the take\u2026");
       const provider = new FalProvider();
       const result = await provider.call(endpoint, falInput, update);
       const data = result.data;
@@ -87401,7 +87410,7 @@ function getEndpoint(modelId) {
   return model.endpoint;
 }
 async function handleRemote3(text, opts, json2, apiKey, serverUrl) {
-  const spinner = json2 ? void 0 : ora("Generating audio\u2026").start();
+  const spinner = json2 ? void 0 : ora("Finding the right voice\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -87419,7 +87428,7 @@ async function handleRemote3(text, opts, json2, apiKey, serverUrl) {
       throw new GunniError("No audio in remote response", "NO_AUDIO");
     }
     const requestedPath = opts.output ?? `gunni-audio-${Date.now()}.mp3`;
-    update("Downloading audio\u2026");
+    update("Saving to disk\u2026");
     const finalPath = await downloadMedia(audioAssetUrl, requestedPath, update);
     spinner?.succeed("Done");
     const output = {
@@ -87493,7 +87502,7 @@ Run 'gunni list models --type lipsync' for details.
         "NO_API_KEY",
         json2 ? void 0 : `Run ${import_picocolors6.default.bold("gunni")} to set up, or: gunni config --set-gunni-key YOUR_KEY`
       );
-      const spinner = json2 ? void 0 : ora("Starting\u2026").start();
+      const spinner = json2 ? void 0 : ora("Matching lips to audio\u2026").start();
       const update = (s2) => {
         if (spinner) spinner.text = s2;
       };
@@ -87506,7 +87515,7 @@ Run 'gunni list models --type lipsync' for details.
         );
       }
       const provider = new FalProvider();
-      update("Generating lip sync\u2026");
+      update("Animating the performance\u2026");
       const result = await provider.generateLipsync({
         model: modelId,
         videoPath: opts.video,
@@ -87556,7 +87565,7 @@ Run 'gunni list models --type lipsync' for details.
   });
 }
 async function handleRemote4(audio, opts, json2, apiKey, serverUrl) {
-  const spinner = json2 ? void 0 : ora("Connecting to Gunni API\u2026").start();
+  const spinner = json2 ? void 0 : ora("Matching lips to audio\u2026").start();
   const update = (s2) => {
     if (spinner) spinner.text = s2;
   };
@@ -87591,7 +87600,7 @@ async function handleRemote4(audio, opts, json2, apiKey, serverUrl) {
     };
     if (videoUrl) toolArgs.video = videoUrl;
     if (imageUrl) toolArgs.image = imageUrl;
-    update("Generating lip sync\u2026");
+    update("Animating the performance\u2026");
     const client2 = new RemoteClient();
     await client2.connect(apiKey, serverUrl);
     let result = await client2.callTool("lipsync", toolArgs);
@@ -87617,7 +87626,7 @@ async function handleRemote4(audio, opts, json2, apiKey, serverUrl) {
       throw new GunniError("No video in remote lip sync response", "NO_VIDEO");
     }
     const requestedPath = opts.output ?? `gunni-lipsync-${Date.now()}.mp4`;
-    update("Downloading video\u2026");
+    update("Saving to disk\u2026");
     const finalPath = await downloadMedia(videoAssetUrl, requestedPath, update);
     spinner?.succeed("Done");
     const output = {
@@ -87884,7 +87893,7 @@ KEY PRINCIPLES
     }
   },
   latest: {
-    version: "0.3.4",
+    version: "0.3.7",
     date: "2026-03-29",
     updates: [
       "Production system: templates (proven prompts with variables), styles (visual direction), presets (platform rules), pipelines (multi-step workflows).",
@@ -87962,9 +87971,27 @@ ${import_picocolors8.default.dim("Run: gunni learn <topic>")}
 `);
       } else {
         console.log(`
-${import_picocolors8.default.bold(result.title)}
+${import_picocolors8.default.bold(import_picocolors8.default.cyan(result.title))}
 `);
-        console.log(result.content);
+        const lines = result.content.split("\n");
+        for (const line of lines) {
+          if (/^[A-Z][A-Z _/()]+:/.test(line)) {
+            const colonIdx = line.indexOf(":");
+            console.log(`${import_picocolors8.default.bold(line.slice(0, colonIdx + 1))}${import_picocolors8.default.dim(line.slice(colonIdx + 1))}`);
+          } else if (line.startsWith("- ")) {
+            const dashEnd = line.indexOf(" ", 2);
+            const toolMatch = line.match(/^- (\w+\(\)[^ ]*)(.*)/);
+            if (toolMatch) {
+              console.log(`  ${import_picocolors8.default.green("\u2022")} ${import_picocolors8.default.cyan(toolMatch[1])}${import_picocolors8.default.dim(toolMatch[2])}`);
+            } else {
+              console.log(`  ${import_picocolors8.default.green("\u2022")} ${line.slice(2)}`);
+            }
+          } else if (/^\d+\./.test(line)) {
+            console.log(`  ${import_picocolors8.default.dim(line)}`);
+          } else {
+            console.log(line);
+          }
+        }
         console.log();
       }
     } catch (err) {
@@ -89384,7 +89411,8 @@ Examples:
       console.log(`
 ${import_picocolors14.default.bold(import_picocolors14.default.cyan(category.toUpperCase()))}`);
       for (const m2 of catModels) {
-        console.log(`  ${import_picocolors14.default.bold(m2.id)}  ${import_picocolors14.default.dim(m2.description)}`);
+        const tag = m2.isDefault ? import_picocolors14.default.green(" \u2605") : "";
+        console.log(`  ${import_picocolors14.default.bold(m2.id)}${tag}  ${import_picocolors14.default.dim(m2.description)}`);
       }
     }
     console.log();
@@ -90889,7 +90917,7 @@ async function runOnboarding() {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("gunni").description("AI media toolkit \u2014 give any agent the ability to create professional media").version("0.3.5").option("--json", "Output results as JSON").addHelpText(
+program2.name("gunni").description("AI media toolkit \u2014 give any agent the ability to create professional media").version("0.3.7").option("--json", "Output results as JSON").addHelpText(
   "after",
   `
 Examples:
@@ -90899,18 +90927,18 @@ Examples:
     $ gunni init --template brand                           # Start a brand project
 
   Image (generate, edit, describe, upscale, remove-bg):
-    $ gunni image "a coffee bag on white background" -o bag.png
-    $ gunni image bag.png --remove-bg -o bag-clean.png
-    $ gunni image bag-clean.png "place on marble counter" -o hero.png
-    $ gunni image hero.png --upscale -o hero-final.png
-    $ gunni image hero-final.png                            # describe
+    $ gunni image "a coffee bag on white background" -o bag
+    $ gunni image bag.jpg --remove-bg -o bag-clean
+    $ gunni image bag-clean.png "place on marble counter" -o hero
+    $ gunni image hero.jpg --upscale -o hero-final
+    $ gunni image hero-final.jpg                            # describe
 
   Video & audio:
-    $ gunni video hero.png -p "slow cinematic zoom in" -o hero.mp4
+    $ gunni video hero.jpg -p "slow cinematic zoom in" -o hero.mp4
     $ gunni audio "Welcome to our roastery" -o intro.mp3
 
   Explore with variants:
-    $ gunni image "logo concepts" --variants 4 -o logo-{n}.png
+    $ gunni image "logo concepts" --variants 4 -o logo-{n}
 
   Creative expertise:
     $ gunni learn exploration                               # How to explore creatively
@@ -90919,8 +90947,8 @@ Examples:
   Agent workflow (structured JSON):
     $ gunni --json learn overview                           # Load capabilities
     $ gunni --json image "product photo" --variants 3       # Explore
-    $ gunni --json image best.png "refine the lighting"     # Iterate
-    $ gunni --json image final.png --upscale                # Polish
+    $ gunni --json image best.jpg "refine the lighting"     # Iterate
+    $ gunni --json image final.jpg --upscale                # Polish
 `
 );
 registerImageCommand(program2);
@@ -90941,7 +90969,7 @@ program2.command("models").description("List available models (alias for: gunni
     return;
   }
   if (models.length === 0) {
-    console.log(`No models found${opts.type ? ` for category "${opts.type}"` : ""}.`);
+    console.log(import_picocolors23.default.dim(`No models found${opts.type ? ` for category "${opts.type}"` : ""}.`));
     return;
   }
   const grouped = /* @__PURE__ */ new Map();
@@ -90952,9 +90980,10 @@ program2.command("models").description("List available models (alias for: gunni
   }
   for (const [category, catModels] of grouped) {
     console.log(`
-${category.toUpperCase()}`);
+${import_picocolors23.default.bold(import_picocolors23.default.cyan(category.toUpperCase()))}`);
     for (const m2 of catModels) {
-      console.log(`  ${m2.id}  ${m2.description}`);
+      const tag = m2.isDefault ? import_picocolors23.default.green(" \u2605") : "";
+      console.log(`  ${import_picocolors23.default.bold(m2.id)}${tag}  ${import_picocolors23.default.dim(m2.description)}`);
     }
   }
   console.log();
@@ -90988,7 +91017,7 @@ program2.action(async () => {
       { name: "models", usage: "gunni models [--type <category>]", description: "List available models" },
       { name: "config", usage: "gunni config", description: "Manage API keys" }
     ];
-    console.log(JSON.stringify({ version: "0.3.5", commands, categories, models }, null, 2));
+    console.log(JSON.stringify({ version: "0.3.7", commands, categories, models }, null, 2));
     return;
   }
   const configured = await hasGunniKey();
@@ -91044,10 +91073,10 @@ ${import_picocolors23.default.bold("Models:")} ${import_picocolors23.default.dim
   }
   console.log(`
 ${import_picocolors23.default.bold("Quick start:")}
-  ${import_picocolors23.default.dim("$")} gunni image "coffee bag product shot" -o bag.png
-  ${import_picocolors23.default.dim("$")} gunni image bag.png --remove-bg -o bag-clean.png
-  ${import_picocolors23.default.dim("$")} gunni image bag-clean.png "on marble counter" -o hero.png
-  ${import_picocolors23.default.dim("$")} gunni image hero.png --upscale -o hero-final.png
+  ${import_picocolors23.default.dim("$")} gunni image "coffee bag product shot" -o bag
+  ${import_picocolors23.default.dim("$")} gunni image bag.jpg --remove-bg -o bag-clean
+  ${import_picocolors23.default.dim("$")} gunni image bag-clean.png "on marble counter" -o hero
+  ${import_picocolors23.default.dim("$")} gunni image hero.jpg --upscale -o hero-final
 
 ${import_picocolors23.default.dim("Add --json to any command for structured output.")}
 ${import_picocolors23.default.dim("Run gunni learn to load creative expertise.")}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gunni",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "AI media toolkit — give any agent the ability to create professional media",
   "type": "module",
   "bin": {