gunni 0.3.6 → 0.3.8

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;
   }
@@ -86261,7 +86263,7 @@ var RemoteClient = class {
         }
       }
     );
-    this.client = new Client({ name: "gunni-cli", version: "0.3.6" });
+    this.client = new Client({ name: "gunni-cli", version: "0.3.8" });
     await this.client.connect(transport);
   }
   async callTool(name, args) {
@@ -86435,40 +86437,58 @@ var DEFAULT_MODELS = {
   "remove-bg": "bria-bg-remove"
 };
 function registerImageCommand(program3) {
-  program3.command("image").description("Unified image command: generate, edit, describe, upscale, or remove background").argument("[input]", "Image path or text prompt").argument("[prompt]", "Edit instructions (when input is an image)").option("-m, --model <model>", "Model to use (auto-selected by operation if omitted)").option("-o, --output <path>", "Output file path (default: auto-generated)").option("--width <pixels>", "Image width in pixels", parseInt).option("--height <pixels>", "Image height in pixels", parseInt).option("--seed <number>", "Random seed for reproducibility", parseInt).option("--upscale", "Upscale the input image").option("--remove-bg", "Remove background from the input image").option("--scale <factor>", "Scale factor for upscale (default: 2)", parseInt, 2).option("--variants <count>", "Number of variants to generate", parseInt).option("--style <name>", "Apply a saved visual style").addHelpText(
+  program3.command("image").description("Unified image command: generate, edit, describe, upscale, or remove background").argument("[inputs...]", "Image path(s) or text prompt. Multiple images for multi-ref editing.").option("-m, --model <model>", "Model to use (auto-selected by operation if omitted)").option("-o, --output <path>", "Output file path (default: auto-generated)").option("--width <pixels>", "Image width in pixels", parseInt).option("--height <pixels>", "Image height in pixels", parseInt).option("--seed <number>", "Random seed for reproducibility", parseInt).option("--upscale", "Upscale the input image").option("--remove-bg", "Remove background from the input image").option("--scale <factor>", "Scale factor for upscale (default: 2)", parseInt, 2).option("--variants <count>", "Number of variants to generate", parseInt).option("--style <name>", "Apply a saved visual style").addHelpText(
     "after",
     `
 Examples:
 
   Generate an image:
-    $ gunni image "a cat on a beach" -o cat.png
-    $ gunni image "product photo" --model nano-banana -o product.png
+    $ gunni image "a cat on a beach" -o cat
+    $ gunni image "product photo" --model nano-banana -o product
 
   Edit an image:
-    $ gunni image photo.jpg "make the lighting warmer" -o photo-warm.jpg
-    $ gunni image logo.png "place on a coffee cup mockup" -o mockup.png
+    $ gunni image photo.jpg "make the lighting warmer" -o photo-warm
+    $ gunni image logo.png "place on a coffee cup mockup" -o mockup
+
+  Multi-image edit (combine references):
+    $ gunni image fox.jpg forest.jpg "place the fox from @image1 on the path in @image2"
+    $ gunni image character.png style-ref.png "redraw @image1 in the style of @image2"
 
   Describe an image:
     $ gunni image photo.jpg
 
-  Upscale an image:
-    $ gunni image photo.jpg --upscale -o photo-hires.jpg
-    $ gunni image photo.jpg --upscale --scale 4 -o photo-4x.jpg
-
-  Remove background:
-    $ gunni image product.png --remove-bg -o product-clean.png
+  Upscale / remove background:
+    $ gunni image photo.jpg --upscale -o photo-hires
+    $ gunni image product.png --remove-bg -o product-clean
 
   Explore with variants:
-    $ gunni image "logo concepts" --variants 4 -o concepts/logo-{n}.png
+    $ gunni image "logo concepts" --variants 4 -o concepts/logo-{n}
 
   Agent usage:
     $ gunni --json image "product photo" --variants 3
-
-    Returns: { operation, results: [{ image: { path, url, width, height }, seed }], model, prompt }
 `
-  ).action(async (input, prompt, opts) => {
+  ).action(async (inputs, opts) => {
     const json2 = program3.opts().json ?? false;
     try {
+      if (!inputs || inputs.length === 0) {
+        throw new GunniError(
+          "No input provided. Pass an image path or text prompt.",
+          "MISSING_INPUT",
+          "Run `gunni image --help` for usage examples."
+        );
+      }
+      const imagePaths = [];
+      let prompt;
+      for (const arg of inputs) {
+        if (existsSync(arg)) {
+          imagePaths.push(arg);
+        } else if (!prompt) {
+          prompt = arg;
+        } else {
+          prompt += " " + arg;
+        }
+      }
+      const input = imagePaths.length > 0 ? imagePaths[0] : prompt;
       if (!input) {
         throw new GunniError(
           "No input provided. Pass an image path or text prompt.",
@@ -86476,13 +86496,13 @@ Examples:
           "Run `gunni image --help` for usage examples."
         );
       }
-      const isFile = existsSync(input);
+      const isFile = imagePaths.length > 0;
       const operation = routeOperation(isFile, prompt, opts);
       const config2 = new ConfigManager();
       const gunniKey = await config2.getGunniApiKey();
       if (gunniKey) {
         const serverUrl = await config2.getServerUrl();
-        return handleRemote(input, prompt, operation, opts, json2, gunniKey, serverUrl);
+        return handleRemote(imagePaths.length > 1 ? imagePaths : input, prompt, operation, opts, json2, gunniKey, serverUrl);
       }
       throw new GunniError(
         "No API key configured",
@@ -86553,9 +86573,10 @@ function resolveVariantPath(template, index) {
   return `${base}-${index}${ext}`;
 }
 async function handleRemote(input, prompt, operation, opts, json2, apiKey, serverUrl) {
+  const isMultiImage = Array.isArray(input);
   const spinnerLabels = {
     generate: "Painting pixels\u2026",
-    edit: "Reworking the canvas\u2026",
+    edit: isMultiImage ? `Combining ${input.length} images\u2026` : "Reworking the canvas\u2026",
     describe: "Studying the image\u2026",
     upscale: "Enhancing resolution\u2026",
     "remove-bg": "Cutting out the background\u2026"
@@ -86567,8 +86588,17 @@ async function handleRemote(input, prompt, operation, opts, json2, apiKey, serve
   try {
     let imageUrl;
     if (operation !== "generate") {
-      update("Uploading image\u2026");
-      imageUrl = await uploadLocalFile(input, apiKey, serverUrl);
+      if (isMultiImage) {
+        const urls = [];
+        for (let i2 = 0; i2 < input.length; i2++) {
+          update(`Uploading image ${i2 + 1} of ${input.length}\u2026`);
+          urls.push(await uploadLocalFile(input[i2], apiKey, serverUrl));
+        }
+        imageUrl = urls;
+      } else {
+        update("Uploading image\u2026");
+        imageUrl = await uploadLocalFile(input, apiKey, serverUrl);
+      }
     }
     let effectiveModel = opts.model ?? DEFAULT_MODELS[operation];
     let effectivePrompt = operation === "generate" ? input : prompt;
@@ -87891,7 +87921,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).",
@@ -87969,9 +87999,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) {
@@ -89391,7 +89439,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();
@@ -90896,7 +90945,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.6").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.8").option("--json", "Output results as JSON").addHelpText(
   "after",
   `
 Examples:
@@ -90906,18 +90955,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
@@ -90926,8 +90975,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);
@@ -90948,7 +90997,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();
@@ -90959,9 +91008,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();
@@ -90995,7 +91045,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.6", commands, categories, models }, null, 2));
+    console.log(JSON.stringify({ version: "0.3.8", commands, categories, models }, null, 2));
     return;
   }
   const configured = await hasGunniKey();
@@ -91051,10 +91101,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.6",
+  "version": "0.3.8",
   "description": "AI media toolkit — give any agent the ability to create professional media",
   "type": "module",
   "bin": {