gunni 0.3.4 → 0.3.5

package/dist/index.js

@@ -86261,7 +86261,7 @@ var RemoteClient = class {
         }
       }
     );
-    this.client = new Client({ name: "gunni-cli", version: "0.3.4" });
+    this.client = new Client({ name: "gunni-cli", version: "0.3.5" });
     await this.client.connect(transport);
   }
   async callTool(name, args) {
@@ -87715,7 +87715,32 @@ var knowledge_default = {
     overview: {
       topic: "overview",
       title: "Gunni Overview",
-      content: "Gunni tools for professional media creation:\n\nMEDIA: image (generate/edit/describe/upscale/remove-bg, routes by input), video, audio\nREFS: ref_save (save image as ref), refs (list or get refs by name), upload_ref (user uploads from their device)\nUTILITY: models (list models + updates), history (search past work), learn (you're here)\n\nROUTING (image): prompt only \u2192 generate, image+prompt \u2192 edit, image only \u2192 describe, +upscale/remove_bg flags\nMULTI-IMAGE: pass an array of URLs to image for multi-ref editing\n\nUSER IMAGE UPLOADS: When a user provides or pastes an image and you need to use it as input (for editing, video, describe, etc.), you MUST call upload_ref first. The image/video tools require a URL (https://...), not a local file path. Workflow:\n1. Call upload_ref with a name for the reference\n2. The user uploads their file via the Gunni Studio UI\n3. After upload completes, use the resulting URL in image/video tools\nNever pass a local file path to image or video. It will fail.\n\nPROJECT SYSTEM: BRIEF.md (creative direction), .gunni/assets.json (lineage), .gunni/seeds.json (proven seeds)\n\nIMPORTANT: Every generation response includes a galleryUrl. Always share it with the user so they can view results in full resolution."
+      content: `Gunni tools for professional media creation:
+
+CREATE: image (generate/edit/describe/upscale/remove-bg, routes by input), video, audio, lipsync
+PRODUCTION: templates (proven prompts with variables), styles (visual direction), presets (platform rules), pipelines (multi-step workflows), refs (reference images)
+UTILITY: models (list models + updates), history (search past work), learn (you're here)
+
+ROUTING (image): prompt only \u2192 generate, image+prompt \u2192 edit, image only \u2192 describe, +upscale/remove_bg flags
+MULTI-IMAGE: pass an array of URLs to image for multi-ref editing
+
+PRODUCTION SYSTEM:
+- templates() \u2014 Browse proven prompts with [variable] placeholders. Use template_save to create your own.
+- styles() \u2014 Saved visual directions (colors, mood, typography). Apply to any generation for brand consistency. Use style_create to save.
+- presets() \u2014 Platform rules (TikTok, IG, YouTube). Auto-applies aspect ratio, framing, prompt modifiers. Use preset_create to save.
+- pipelines() \u2014 Multi-step workflows chaining templates + presets + tools. Call pipelines(name) then orchestrate step by step. See learn("pipelines") for execution guide.
+- refs() \u2014 Reference images in collections. Save with ref_save, use as style/character refs or edit inputs.
+These compose: pipelines use templates and presets, presets reference styles, styles reference refs.
+
+USER IMAGE UPLOADS: When a user provides or pastes an image and you need to use it as input (for editing, video, describe, etc.), you MUST call upload_ref first. The image/video tools require a URL (https://...), not a local file path. Workflow:
+1. Call upload_ref with a name for the reference
+2. The user uploads their file via the Gunni Studio UI
+3. After upload completes, use the resulting URL in image/video tools
+Never pass a local file path to image or video. It will fail.
+
+PROJECT SYSTEM: BRIEF.md (creative direction), .gunni/assets.json (lineage), .gunni/seeds.json (proven seeds)
+
+IMPORTANT: Every generation response includes a galleryUrl. Always share it with the user so they can view results in full resolution.`
     },
     exploration: {
       topic: "exploration",
@@ -87859,14 +87884,17 @@ KEY PRINCIPLES
     }
   },
   latest: {
-    version: "0.2.0",
-    date: "2026-02-22",
+    version: "0.3.4",
+    date: "2026-03-29",
     updates: [
+      "Production system: templates (proven prompts with variables), styles (visual direction), presets (platform rules), pipelines (multi-step workflows).",
+      "Refs: save, organize, and reuse reference images across projects in named collections.",
+      "Lipsync: lip-sync audio onto video, or generate talking head from image + audio.",
+      "Visual research: discover visual trends and references for creative direction.",
+      'Pipeline orchestration: chain templates, presets, styles, and tools into complete deliverables. See learn("pipelines").',
       "Unified image tool: generate, edit, describe, upscale, remove-bg. Routes by input.",
-      "Multi-image editing: pass array of URLs for multi-ref edits (flux-kontext, flux-2-pro-edit, nano-banana-edit, gpt-image-edit).",
-      "Ref system: ref_save + refs for saving/retrieving reference images.",
-      "Variants flag for creative exploration.",
-      "Latest updates merged into models (pass updates=true). refs now handles both list and get."
+      "Multi-image editing: pass array of URLs for multi-ref edits.",
+      "Variants flag for creative exploration."
     ]
   }
 };
@@ -90861,7 +90889,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.4").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.5").option("--json", "Output results as JSON").addHelpText(
   "after",
   `
 Examples:
@@ -90947,14 +90975,20 @@ program2.action(async () => {
       { name: "image", usage: 'gunni image "<prompt>" -o output.png', description: "Generate, edit, describe, upscale, or remove background (smart routing)" },
       { name: "video", usage: 'gunni video <image> -p "<prompt>" -o output.mp4', description: "Generate video from image or text" },
       { name: "audio", usage: 'gunni audio "<text>" -o output.mp3', description: "Generate speech audio from text" },
+      { name: "template", usage: "gunni template list", description: "Browse & use proven prompt templates with fill-in variables" },
+      { name: "style", usage: "gunni style list", description: "Saved visual directions (colors, mood, tone) for consistent output" },
+      { name: "preset", usage: "gunni preset list", description: "Platform production rules (TikTok, IG, YouTube \u2014 aspect ratio, framing)" },
+      { name: "pipeline", usage: "gunni pipeline list", description: "Multi-step production workflows chaining templates, presets, and tools" },
+      { name: "ref", usage: "gunni ref list", description: "Reference images organized in collections for reuse across projects" },
       { name: "learn", usage: "gunni learn [topic]", description: "Load creative expertise and best practices" },
+      { name: "guide", usage: "gunni list guides", description: "Step-by-step creative playbooks with prompt templates" },
       { name: "latest", usage: "gunni latest", description: "Check for new models, features, updates" },
       { name: "init", usage: "gunni init [--template brand|ui|campaign]", description: "Initialize a Gunni project" },
       { name: "history", usage: 'gunni history ["query"]', description: "Search past generations" },
-      { name: "list models", usage: "gunni list models [--type <category>]", description: "List available models" },
+      { 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.4", commands, categories, models }, null, 2));
+    console.log(JSON.stringify({ version: "0.3.5", commands, categories, models }, null, 2));
     return;
   }
   const configured = await hasGunniKey();
@@ -90964,27 +90998,37 @@ program2.action(async () => {
     return;
   }
   console.log(`
-${import_picocolors23.default.bold("GUNNI")} ${import_picocolors23.default.dim("v0.3.0")} \u2014 AI media toolkit
+${import_picocolors23.default.cyan(` ________  ___  ___  ________   ________   ___`)}
+${import_picocolors23.default.cyan(`|\\   ____\\|\\  \\|\\  \\|\\   ___  \\|\\   ___  \\|\\  \\`)}
+${import_picocolors23.default.cyan(`\\ \\  \\___|\\ \\  \\\\\\  \\ \\  \\\\ \\  \\ \\  \\\\ \\  \\ \\  \\`)}
+${import_picocolors23.default.cyan(` \\ \\  \\  __\\ \\  \\\\\\  \\ \\  \\\\ \\  \\ \\  \\\\ \\  \\ \\  \\`)}
+${import_picocolors23.default.cyan(`  \\ \\  \\|\\  \\ \\  \\\\\\  \\ \\  \\\\ \\  \\ \\  \\\\ \\  \\ \\  \\`)}
+${import_picocolors23.default.cyan(`   \\ \\_______\\ \\_______\\ \\__\\\\ \\__\\ \\__\\\\ \\__\\ \\__\\`)}
+${import_picocolors23.default.cyan(`    \\|_______|\\|_______|\\|__| \\|__|\\|__| \\|__|\\|__|`)}
 
-${import_picocolors23.default.bold("Media:")}
+  ${import_picocolors23.default.dim(`v0.3.4 \u2014 AI media toolkit`)}
+
+${import_picocolors23.default.bold("Create:")}
   ${import_picocolors23.default.cyan("image")}       Generate, edit, describe, upscale, remove-bg   ${import_picocolors23.default.dim('gunni image "a cat" -o cat.png')}
   ${import_picocolors23.default.cyan("video")}       Image/text \u2192 video                             ${import_picocolors23.default.dim('gunni video hero.png -p "zoom in"')}
   ${import_picocolors23.default.cyan("audio")}       Text \u2192 speech                                  ${import_picocolors23.default.dim('gunni audio "Hello" -o hello.mp3')}
 
 ${import_picocolors23.default.bold("Production:")}
-  ${import_picocolors23.default.cyan("template")}    Browse & manage prompt templates                ${import_picocolors23.default.dim("gunni template list --category ugc")}
-  ${import_picocolors23.default.cyan("preset")}      Platform presets (framing, aspect ratio)        ${import_picocolors23.default.dim("gunni preset get tiktok-ugc")}
-  ${import_picocolors23.default.cyan("pipeline")}    Multi-step production workflows                 ${import_picocolors23.default.dim("gunni pipeline get ugc-product-reel")}
-  ${import_picocolors23.default.cyan("style")}       Visual styles (brand identity)                  ${import_picocolors23.default.dim("gunni style list")}
-
-${import_picocolors23.default.bold("Context:")}
-  ${import_picocolors23.default.cyan("learn")}       Creative expertise & best practices             ${import_picocolors23.default.dim("gunni learn exploration")}
+  ${import_picocolors23.default.cyan("template")}    Proven prompts with variables you fill in       ${import_picocolors23.default.dim("gunni template list")}
+  ${import_picocolors23.default.cyan("style")}       Saved visual direction (colors, mood, tone)     ${import_picocolors23.default.dim("gunni style list")}
+  ${import_picocolors23.default.cyan("preset")}      Platform rules (TikTok, IG, YouTube, etc.)     ${import_picocolors23.default.dim("gunni preset list")}
+  ${import_picocolors23.default.cyan("pipeline")}    Multi-step workflows that chain it all          ${import_picocolors23.default.dim("gunni pipeline list")}
+  ${import_picocolors23.default.cyan("ref")}         Reference images for consistent output          ${import_picocolors23.default.dim("gunni ref list")}
+
+${import_picocolors23.default.bold("Learn:")}
+  ${import_picocolors23.default.cyan("learn")}       Creative expertise & best practices             ${import_picocolors23.default.dim("gunni learn overview")}
+  ${import_picocolors23.default.cyan("guide")}       Step-by-step creative playbooks                 ${import_picocolors23.default.dim("gunni list guides")}
   ${import_picocolors23.default.cyan("latest")}      New models, features, updates                   ${import_picocolors23.default.dim("gunni latest")}
 
 ${import_picocolors23.default.bold("Utility:")}
   ${import_picocolors23.default.cyan("init")}        Start a new project                             ${import_picocolors23.default.dim("gunni init --template brand")}
   ${import_picocolors23.default.cyan("history")}     Search past work                                ${import_picocolors23.default.dim('gunni history "coffee"')}
-  ${import_picocolors23.default.cyan("list")}        Discover models                                 ${import_picocolors23.default.dim("gunni list models")}
+  ${import_picocolors23.default.cyan("models")}      Discover available models                       ${import_picocolors23.default.dim("gunni models")}
   ${import_picocolors23.default.cyan("config")}      API key setup                                   ${import_picocolors23.default.dim("gunni config")}
 
 ${import_picocolors23.default.bold("Models:")} ${import_picocolors23.default.dim(`${getAllModels().length} curated models`)}`);

package/package.json

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