gunni 0.3.7 → 0.3.8

package/dist/index.js

@@ -86263,7 +86263,7 @@ var RemoteClient = class {
         }
       }
     );
-    this.client = new Client({ name: "gunni-cli", version: "0.3.7" });
+    this.client = new Client({ name: "gunni-cli", version: "0.3.8" });
     await this.client.connect(transport);
   }
   async callTool(name, args) {
@@ -86437,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.",
@@ -86478,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",
@@ -86555,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"
@@ -86569,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;
@@ -90917,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.7").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:
@@ -91017,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.7", commands, categories, models }, null, 2));
+    console.log(JSON.stringify({ version: "0.3.8", commands, categories, models }, null, 2));
     return;
   }
   const configured = await hasGunniKey();

package/package.json

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