@vm0/cli 9.169.2 → 9.171.0

package/zero.js

@@ -126,7 +126,6 @@ import {
   resolveFirewallPolicies,
   resolveZeroScheduleByAgent,
   saveConfig,
-  searchConnectors,
   searchZeroChat,
   searchZeroConnectors,
   searchZeroLogs,
@@ -153,7 +152,7 @@ import {
   zeroAgentCustomSkillNameSchema,
   zeroLocalAgentCommand,
   zeroTokenAllowsFeatureSwitch
-} from "./chunk-CZICABIP.js";
+} from "./chunk-HL3E2RLS.js";
 import {
   __toESM,
   init_esm_shims
@@ -1874,6 +1873,162 @@ var listCommand6 = new Command().name("list").alias("ls").description("List all
 
 // src/commands/zero/connector/search.ts
 init_esm_shims();
+
+// ../../packages/connectors/src/connector-search.ts
+init_esm_shims();
+var TOKEN_BOUNDARY = /[_\-\s]+/;
+var CASE_BOUNDARY = /(?<=[a-z])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/;
+var MIN_SCORE = 10;
+function tokenize(input) {
+  const tokens = /* @__PURE__ */ new Set();
+  for (const chunk of input.split(TOKEN_BOUNDARY)) {
+    if (!chunk) continue;
+    for (const sub of chunk.split(CASE_BOUNDARY)) {
+      const lower = sub.toLowerCase();
+      if (lower) tokens.add(lower);
+    }
+  }
+  return tokens;
+}
+function connectorAccessEnvBindings(access) {
+  switch (access.kind) {
+    case "static":
+    case "refresh-token":
+      return access.envBindings;
+    case "none":
+      return {};
+  }
+}
+function getManualGrantFields(method) {
+  return method.grant.kind === "manual" ? method.grant.fields : void 0;
+}
+function listSecretNames(config) {
+  const names = [];
+  for (const method of Object.values(config.authMethods)) {
+    for (const name of Object.keys(getManualGrantFields(method) ?? {})) {
+      names.push(name);
+    }
+    for (const valueRef of Object.values(
+      connectorAccessEnvBindings(method.access)
+    )) {
+      if (valueRef.startsWith("$secrets.")) {
+        names.push(valueRef.slice("$secrets.".length));
+      }
+    }
+  }
+  return names;
+}
+function findExactMatch(keywordLower, type, config) {
+  if (type.toLowerCase() === keywordLower) {
+    return { score: 100, matchedField: "type" };
+  }
+  for (const envName of Object.keys(getConnectorEnvBindings(type))) {
+    if (envName.toLowerCase() === keywordLower) {
+      return { score: 90, matchedField: `env:${envName}` };
+    }
+  }
+  if (config.label.toLowerCase() === keywordLower) {
+    return { score: 80, matchedField: "label" };
+  }
+  const tags = config.tags ?? [];
+  for (const tag of tags) {
+    if (tag === keywordLower) {
+      return { score: 70, matchedField: `tag:${tag}` };
+    }
+  }
+  return null;
+}
+function findSubstringMatch(keywordLower, type, config) {
+  if (type.toLowerCase().includes(keywordLower)) {
+    return { score: 50, matchedField: "type" };
+  }
+  if (config.label.toLowerCase().includes(keywordLower)) {
+    return { score: 50, matchedField: "label" };
+  }
+  for (const envName of Object.keys(getConnectorEnvBindings(type))) {
+    if (envName.toLowerCase().includes(keywordLower)) {
+      return { score: 40, matchedField: `env:${envName}` };
+    }
+  }
+  for (const name of listSecretNames(config)) {
+    if (name.toLowerCase().includes(keywordLower)) {
+      return { score: 30, matchedField: `secret:${name}` };
+    }
+  }
+  const tags = config.tags ?? [];
+  for (const tag of tags) {
+    if (tag.includes(keywordLower)) {
+      return { score: 25, matchedField: `tag:${tag}` };
+    }
+  }
+  return null;
+}
+function collectCandidateTokens(type, config) {
+  const tokens = /* @__PURE__ */ new Set();
+  const sources = [
+    type,
+    config.label,
+    ...Object.keys(getConnectorEnvBindings(type)),
+    ...listSecretNames(config),
+    ...config.tags ?? []
+  ];
+  for (const source of sources) {
+    for (const token of tokenize(source)) {
+      tokens.add(token);
+    }
+  }
+  return tokens;
+}
+function findTokenIntersection(keywordTokens, type, config) {
+  const candidateTokens = collectCandidateTokens(type, config);
+  let intersection = 0;
+  let firstCommon = "";
+  for (const token of keywordTokens) {
+    if (candidateTokens.has(token)) {
+      intersection++;
+      if (!firstCommon) firstCommon = token;
+    }
+  }
+  if (intersection === 0) return null;
+  return { score: 10 * intersection, matchedField: `token:${firstCommon}` };
+}
+function scoreConnector(keywordLower, keywordTokens, type, config) {
+  const exact = findExactMatch(keywordLower, type, config);
+  if (exact) return exact;
+  const candidates = [];
+  const substring = findSubstringMatch(keywordLower, type, config);
+  if (substring) candidates.push(substring);
+  const token = findTokenIntersection(keywordTokens, type, config);
+  if (token) candidates.push(token);
+  if (candidates.length === 0) return null;
+  const best = candidates.reduce((a, b) => {
+    return a.score >= b.score ? a : b;
+  });
+  if (best.score < MIN_SCORE) return null;
+  return best;
+}
+function searchConnectors(keyword, limit, filter) {
+  const trimmed = keyword.trim();
+  if (!trimmed) return { results: [], total: 0 };
+  const keywordLower = trimmed.toLowerCase();
+  const keywordTokens = tokenize(trimmed);
+  const hits = [];
+  for (const type of CONNECTOR_TYPE_KEYS) {
+    if (filter && !filter(type)) continue;
+    const config = CONNECTOR_TYPES[type];
+    const hit = scoreConnector(keywordLower, keywordTokens, type, config);
+    if (!hit) continue;
+    hits.push({ type, score: hit.score, matchedField: hit.matchedField });
+  }
+  hits.sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    return a.type.localeCompare(b.type);
+  });
+  const capped = limit > 0 ? hits.slice(0, limit) : hits;
+  return { results: capped, total: hits.length };
+}
+
+// src/commands/zero/connector/search.ts
 var DEFAULT_LIMIT = 5;
 var EXACT_MATCH_THRESHOLD = 80;
 function isConnectorType2(type) {
@@ -6523,6 +6678,13 @@ function extensionForMimeType(mimeType) {
   const suffix = mimeType.startsWith("image/") ? mimeType.slice(6) : "bin";
   return sanitizeFilenamePart(suffix, "bin").toLowerCase();
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringField(value, key) {
+  const field = value[key];
+  return typeof field === "string" ? field : void 0;
+}
 async function writeScreenshotDataUrl(result, dataUrl) {
   const match = DATA_URL_PATTERN.exec(dataUrl);
   if (!match) {
@@ -6543,20 +6705,41 @@ async function writeScreenshotDataUrl(result, dataUrl) {
   await writeFile(outputPath, Buffer.from(base64Data, "base64"));
   return outputPath;
 }
-async function formatComputerUseResultForConsole(result) {
-  const printable = { ...result };
-  if (typeof printable.screenshot === "string") {
-    const screenshotPath = await writeScreenshotDataUrl(
-      printable,
-      printable.screenshot
-    );
-    if (screenshotPath) {
-      printable.screenshot = screenshotPath;
+function compactActionResult(action) {
+  const compact = {};
+  for (const [key, value] of Object.entries(action)) {
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      compact[key] = value;
     }
   }
+  return compact;
+}
+async function formatComputerUseResultForConsole(result) {
+  const printable = { status: "succeeded" };
+  const apps = result.apps;
+  if (Array.isArray(apps)) {
+    printable.apps = apps;
+  }
+  const snapshotId = stringField(result, "snapshotId");
+  if (snapshotId) {
+    printable.snapshotId = snapshotId;
+  }
+  const appState = stringField(result, "appState");
+  if (appState) {
+    printable.appState = appState;
+  }
+  const screenshot = stringField(result, "screenshot");
+  if (screenshot) {
+    const screenshotPath = await writeScreenshotDataUrl(result, screenshot);
+    printable.screenshot = screenshotPath ?? screenshot;
+  }
+  const action = result.action;
+  if (isRecord(action)) {
+    printable.action = compactActionResult(action);
+  }
   return JSON.stringify(printable, null, 2);
 }
-async function resultText(command) {
+async function commandOutputText(command) {
   if (!command.result) {
     return "";
   }
@@ -6581,7 +6764,7 @@ async function waitForCommand(commandId, timeoutSeconds) {
         command.error ? `${command.error.code}: ${command.error.message}` : "Computer-use command failed"
       );
     }
-    const text = await resultText(command);
+    const text = await commandOutputText(command);
     if (text) {
       console.log(text);
     }
@@ -6755,8 +6938,8 @@ init_esm_shims();
 
 // src/commands/zero/shared/open-design-registry.ts
 init_esm_shims();
-var OPEN_DESIGN_REPO = "vm0-ai/open-design";
-var OPEN_DESIGN_COMMIT = "d021b04720ace133f1d6133d1487326f5fc28f07";
+var OPEN_DESIGN_REPO = "nexu-io/open-design";
+var OPEN_DESIGN_COMMIT = "3fb620af423534643677c7c6fae76be088fa770a";
 var VM0_SKILLS_REPO = "vm0-ai/vm0-skills";
 var VM0_SKILLS_REF = "main";
 var OPEN_DESIGN_REGISTRY_VERSION = `federated:${OPEN_DESIGN_REPO}@${OPEN_DESIGN_COMMIT}`;
@@ -9147,7 +9330,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Notion Illustration",
     description: "Zero-native illustration style for hand-drawn product spot illustrations with simple ink contours and soft backgrounds.",
     desc: 'Notion-editorial-style hand-drawn spot illustration. Black brush-pen ink on white, tapered confident strokes, solid-black curly hair, solid-black pants/shoes, 3/4 face turned toward viewer with closed-eye smile and soft nose hint, open breathing body outlines, and 1-3 supporting scene props + ambient marks that frame the moment. Trigger when user says /notion-illustration, asks for a "Notion-style illustration", "Notion spot illustration", or a new piece in this hand-drawn brush-pen Notion editorial style.',
-    source: { path: "illustration-template/notion-illustration" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/notion-illustration"
+    }
   },
   {
     id: "vm0:image-style:vm0-illustration",
@@ -9155,7 +9342,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "vm0 Illustration",
     description: "vm0 in-app spot illustration style with bold hand-drawn ink line art, white-filled interiors, and a soft rounded color backdrop.",
     desc: "Generate vm0-style vm0 in-app spot illustrations: bold hand-drawn ink line art with white-filled interiors, a soft rounded color backdrop, transparent output, and simple iconic metaphors for product states.",
-    source: { path: "illustration-template/vm0-illustration" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/vm0-illustration"
+    }
   },
   {
     id: "vm0:image-style:postcard-illustration",
@@ -9163,7 +9354,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Postcard Illustration",
     description: "Hand-drawn editorial postcard / travel-journal illustration with fine black ink linework, flat saturated gouache fills, sharp edges, dense small repeated ink patterns, paper-grain texture, sparse white speckles, and a tall portrait composition.",
     desc: 'Hand-drawn editorial postcard illustration style. Fine black marker/pen ink linework over flat saturated gouache color fills with sharp edges, dense small repeated ink patterns on surfaces (rows of windows, shingle curves, hatching, stippling), subtle paper-grain background texture, tiny scattered white speckles (snow / petals / sparkle), and a tall portrait composition with a layered foreground-midground-background. Travel-journal / urban-sketcher aesthetic. Trigger when the user says /postcard-illustration, asks for a "postcard illustration", "travel illustration", "urban sketcher style", or briefs a palette + scene archetype + complexity.',
-    source: { path: "illustration-template/postcard-illustration" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/postcard-illustration"
+    }
   },
   {
     id: "vm0:image-style:folk-storybook",
@@ -9171,7 +9366,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Folk Storybook Illustration",
     description: "Folk-art children's picture-book illustration \u2014 hand-painted gouache and watercolor scenes with anthropomorphic animal characters, closed-crescent-eye smiles, dusty muted folk palette, and decorative pattern surfaces.",
     desc: "Folk-art children's picture-book illustration style \u2014 hand-painted gouache/watercolor scene on aged paper, anthropomorphic animal characters with closed-crescent-eye smiles, dusty muted folk palette, decorative pattern surfaces (wallpaper, rugs, textiles), and a hushed lullaby mood. Trigger when users ask for a folk-art illustration, storybook scene, cozy animal illustration, or any new piece in this Eastern European picture-book style.",
-    source: { path: "illustration-template/folk-storybook" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/folk-storybook"
+    }
   },
   {
     id: "vm0:image-style:papernook",
@@ -9179,7 +9378,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Papernook",
     description: "Hand-drawn editorial illustration set in a cozy cluttered personal-studio scene with warm cream paper, scratchy ink, painterly gouache fills, dot-eye character face, and dense edge-to-edge thematic props.",
     desc: 'Hand-drawn editorial illustration in the spirit of a cluttered personal-studio scene. Loose scratchy black ink outlines that wobble, textured gouache fills with visible brush marks, warm cream paper background, simplified dot-eye character face, and a DENSE edge-to-edge composition where a centered character is orbited by thematic props that visually act out the scene metaphor. Default palette: dusty cornflower blue, soft coral pink, fresh sage green, charcoal, warm cream \u2014 no mustard, no burnt-orange. Trigger when user says /papernook, asks for a "papernook illustration", a "cozy cluttered editorial scene", a "warm-cream desk scene", or a new piece in this hand-drawn studio-clutter editorial style.',
-    source: { path: "illustration-template/papernook" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/papernook"
+    }
   },
   {
     id: "vm0:image-style:painterly-botanical",
@@ -9187,7 +9390,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Painterly Botanical",
     description: "Painterly watercolor + gouache portrait illustration with a single figure embraced by lush botanicals, closed-eye introspective expression, and a softly tinted paper-wash background.",
     desc: 'Painterly watercolor + gouache portrait illustration. Single figure (closed eyes, contemplative) embraced by botanicals \u2014 leaves, blossoms, grasses. Translucent washes with visible pigment bleeds, sparse crisp ink line accents on key edges, tiny handwritten cursive signature in an upper corner, and a tinted paper-wash background (never pure white). Eight user axes drive composition: subject, hair, pose, botanicals, palette, background wash, complexity (L1/L2/L3), and format. Trigger when a brief describes a contemplative figure with foliage, a "watercolor portrait", a "botanical embrace", or asks for a piece in this painterly editorial style.',
-    source: { path: "illustration-template/painterly-botanical" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/painterly-botanical"
+    }
   },
   {
     id: "vm0:image-style:iso-scene",
@@ -9195,7 +9402,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Isometric Editorial Scene",
     description: "Isometric editorial-magazine scene illustration with ultra-fine hairline outlines, flat fills, a saturated monochromatic background, and a scene-as-metaphor composition built from theme-native props.",
     desc: 'Isometric editorial-magazine scene illustration in a locked flat-vector style \u2014 ultra-fine hairline outlines, monochromatic saturated background filling the canvas, and a single composed scene whose props themselves embody the theme. Trigger when users say /iso-scene, ask for an "isometric editorial illustration", a "scene illustration in the editorial machine style", or brief with palette + scene archetype + complexity.',
-    source: { path: "illustration-template/iso-scene" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/iso-scene"
+    }
   },
   {
     id: "vm0:image-style:inkdab",
@@ -9203,7 +9414,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Inkdab Illustration",
     description: "Brush-pen editorial illustration where a free-floating color dab is painted first, then loose black ink linework is drawn freely on top \u2014 never as an outline around the color. Scribbled hatched hair, open-outline bodies, pure white background.",
     desc: 'Brush-pen editorial illustration style \u2014 a flat accent-color "dab" painted first, then loose black ink drawn freely on top. ONE flat accent-color shape per prop (painted-first, never outlined in black), black hand-wobbled ink on pure white background, scribbled hatched hair, open-outline bodies with zero fill, and one small solid-accent triangle floating freely as a recurring motif. Trigger when user says /inkdab, asks for an "inkdab illustration", a "brush-pen illustration with a single accent color", a "free-floating color block illustration", or briefs in the style of the included reference images.',
-    source: { path: "illustration-template/inkdab" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/inkdab"
+    }
   },
   {
     id: "vm0:image-style:riso-relic",
@@ -9211,7 +9426,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Riso Relic",
     description: 'Pop-art retro risograph poster of a single nostalgic everyday object on a saturated single-hue field \u2014 bold black ink outlines, halftone grain, hand-drawn doodle accents, tiny "SMALL OBJECTS IN TIME" banner up top, chunky retro headline with offset drop-shadow at the bottom.',
     desc: 'Pop-art retro risograph poster of a single nostalgic everyday object \u2014 saturated single-color background, bold black ink outlines, halftone/riso grain, hand-drawn doodle accents (sparkles, squiggles, dots, music notes, lightning), tiny white "SMALL OBJECTS IN TIME" banner at top, chunky retro display headline at bottom with offset black drop-shadow. Trigger when user says /riso-relic, asks for a "riso poster", a "small objects in time" illustration, or any new piece in this nostalgic pop-art relic-object style.',
-    source: { path: "illustration-template/riso-relic" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/riso-relic"
+    }
   },
   {
     id: "vm0:image-style:inkstomp",
@@ -9219,7 +9438,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Inkstomp",
     description: "Loud indie-packaging poster style \u2014 full-bleed saturated flat color, a two-line hand-lettered headline, and one weird-cute black brush-ink character.",
     desc: 'Inkstomp \u2014 a loud, hand-screened indie-packaging poster style. Full-bleed saturated flat color filling the entire canvas, a two-line hand-lettered headline (thin arched caps over chunky drop-shadowed display), and one weird-cute character drawn in thick uniform black brush ink. Trigger when the user says /inkstomp, asks for an "inkstomp poster", a "Ray Fenwick / Hattie Stewart packaging poster", an "indie brush-ink flavor card", or briefs in a "palette + headline + character" shape.',
-    source: { path: "illustration-template/inkstomp" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/inkstomp"
+    }
   },
   {
     id: "vm0:image-style:folk-muse",
@@ -9227,7 +9450,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Folk Muse",
     description: "Flat folk-art gouache portrait style \u2014 a single contemplative chest-up figure framed by an asymmetric botanical surround, with painted irises, smooth flat hair, a hand against the cheek, and a patterned robe.",
     desc: 'Flat folk-art gouache portrait illustration in the contemporary editorial style of Carson Ellis, Maja Tomljanovic, and Bodil Jane. A single chest-up figure with an elongated mannerist oval face, tiny almond half-lidded eyes, smooth flat hair, one hand pressed against the face, a patterned robe filling the lower frame, and an asymmetric botanical surround filling the background edge-to-edge. Hand-painted matte gouache texture, flat color blocks, no harsh outlines, no photorealism. Calm, slightly melancholic, contemplative mood. Trigger when the user says /folk-muse, asks for a "folk-art portrait", "gouache portrait", "Carson Ellis style portrait", or any new piece in this contemplative folk-portrait style.',
-    source: { path: "illustration-template/folk-muse" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/folk-muse"
+    }
   },
   {
     id: "vm0:image-style:sunlit-gouache",
@@ -9235,7 +9462,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Sunlit Gouache",
     description: "Bright pastel travel-painting illustration in opaque gouache on textured paper with chunky flat brushstrokes, vertical one-point perspective, and figures walking into warm sunlight.",
     desc: 'Sunlit Gouache travel-painting illustration. Opaque gouache on textured paper, visible chunky flat brushstrokes with dry-brush highlights, locked six-color palette (cream, butter-yellow, sky-blue, sage-green, terracotta, one small red accent), vertical 2:3 one-point-perspective composition drawing the eye into a bright sunlit focal point, figures seen from behind walking into the scene, an overhead band of hanging elements (awning, prayer flags, catenary, bunting, lanterns) creating depth, dappled painterly reflections on the ground, airy optimistic warm mood. Trigger when user says /sunlit-gouache, asks for a "sunlit gouache illustration", "painterly travel scene", "gouache caf\xE9/market/temple/station scene", or a new piece in this bright pastel painted-light style.',
-    source: { path: "illustration-template/sunlit-gouache" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/sunlit-gouache"
+    }
   },
   {
     id: "vm0:image-style:mosaic-still-life",
@@ -9243,7 +9474,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Mosaic Still Life",
     description: "Editorial still-life illustration in a mosaic-tile + painterly hybrid style \u2014 tessellated ground/sky/wall surfaces with crisp painterly objects, an animal companion, and a patterned textile peeking through.",
     desc: 'Mosaic-tile + painterly hybrid editorial illustration. Tessellated/pointillist mosaic surfaces (grass, sky, sand, walls, floors) anchor the scene, with crisp painterly still-life objects rendered ON TOP. Always features a still-life centerpiece on a table, an animal companion at the heart of the scene, and at least one patterned textile peeking through. Cozy, nostalgic, bucolic mood. Trigger when user says /mosaic-still-life, asks for a "mosaic illustration", "mosaic-tile editorial illustration", "tessellated still life", or briefs with a palette + scene + animal in this style.',
-    source: { path: "illustration-template/mosaic-still-life" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/mosaic-still-life"
+    }
   },
   {
     id: "vm0:image-style:ink-mascot",
@@ -9251,7 +9486,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Ink Mascot",
     description: "Vintage editorial marketing card. Bold serif headline and short serif descriptor over a hand-drawn black-ink anthropomorphic mascot (stick limbs, chunky white sneakers) on a single solid saturated flat color background.",
     desc: 'Generate a 3:5 portrait editorial marketing card in a locked vintage-textbook style. Bold serif headline plus an optional short serif descriptor sit on a single solid saturated flat color background (no gradient, no divider, no ground line). A hand-drawn black-ink anthropomorphic hero object \u2014 paint bucket, magnifying glass, envelope, notebook, funnel, megaphone, rocket, seedling, gift box, compass, etc. \u2014 stands with two thin stick arms, two stick legs, and chunky white sneakers with black laces (the signature detail). Crosshatch and stipple shading on rounded surfaces; floating ink doodles (sparkles, arrows, hearts, percent or dollar signs, motion lines) at the requested density. Dialable along six axes: concept, palette, hero object, action, doodle density (L1 minimal, L2 balanced, L3 packed), and type layout (A title-top, B headline-bottom, C headline-only, D big-word + tiny-descriptor). Trigger when user says /ink-mascot, asks for a "marketing card illustration", a "retro editorial mascot poster", or briefs with a marketing concept plus palette plus character.',
-    source: { path: "illustration-template/ink-mascot" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/ink-mascot"
+    }
   },
   {
     id: "vm0:image-style:sticker-sheet",
@@ -9259,7 +9498,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Sticker Sheet",
     description: "Hand-painted gouache sticker-sheet illustration with ~20 themed objects floating on white, punchy saturated palette, wobbly hand-drawn ink overlay, and tiny decorative marks on every item.",
     desc: 'Sticker Sheet \u2014 hand-painted gouache sticker-sheet illustration. ~20 small floating themed objects on pure white, punchy saturated palette (coral, mustard, sage, dusty pink, navy, cream, warm brown), flat brushy gouache fills with wobbly hand-drawn ink linework and tiny decorative marks (dots, hatches, squiggles) on every object. Each object slightly tilted, no drop shadows, cheerful cozy lifestyle journal mood. Trigger when user says /sticker-sheet, asks for a "sticker sheet illustration", "hand-painted gouache sticker pack", "themed object sheet", or briefs with a scene theme + object count in this house style.',
-    source: { path: "illustration-template/sticker-sheet" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/sticker-sheet"
+    }
   },
   {
     id: "vm0:image-style:flat-poster",
@@ -9267,7 +9510,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Flat Poster",
     description: "Vertical flat-color editorial poster style \u2014 saturated solid background, one centered hand-drawn vector subject in bold deep-navy outlines with strict two-tone fill, headline pinned top-left, wordmark pinned bottom-right.",
     desc: 'Flat Poster \u2014 a vertical flat-color editorial poster style for brand benefit cards, marketing posters, and in-app campaign visuals. Portrait 2:3 canvas filled edge-to-edge with one saturated hue; a single centered hand-drawn vector subject in deep-navy outlines with strict two-tone fill (pure white plus one darker bg-tint accent); a bold rounded sans-serif headline pinned top-left; a short wordmark (default VM0) pinned bottom-right; small floating accent marks around the subject; no body copy. Six creative dials: palette, subject archetype, composition preset, accent marks, headline voice, mood. Trigger when the user says /flat-poster, asks for a "flat-color editorial poster", a "brand benefit card", a "marketing card in the bold outline + flat color style", or briefs with a palette + subject + headline shape.',
-    source: { path: "illustration-template/flat-poster" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/flat-poster"
+    }
   },
   {
     id: "vm0:image-style:mellow-pop",
@@ -9275,7 +9522,11 @@ var OPEN_DESIGN_REGISTRY = [
     name: "Mellow Pop",
     description: "Chill flat-vector editorial poster of a serene recurring character on a fully saturated solid color background, with a signature pop of bright leaf-green and a scene-as-metaphor composition.",
     desc: 'Mellow-pop flat-vector editorial illustration: a recurring chill character with closed-eye smile, tiny nose hint, and short dark bobbed hair, posed inside a scene-as-metaphor composition on a single fully saturated solid color background, with a signature pop of bright leaf-green woven into every piece (hero prop, plants, motifs, or sweater). Thin uniform black outlines, flat solid fills only, no gradients or texture. Five dials per brief: palette, scene metaphor, complexity (L1/L2/L3), pose, outfit accent. Trigger when user says /mellow-pop, asks for a "mellow-pop illustration", "chill flat-vector poster", or briefs with a scene metaphor + palette + complexity.',
-    source: { path: "illustration-template/mellow-pop" }
+    source: {
+      repo: VM0_SKILLS_REPO,
+      ref: VM0_SKILLS_REF,
+      path: "illustration-template/mellow-pop"
+    }
   }
 ];
 function filterByKind(kind) {
@@ -9308,16 +9559,16 @@ function selectOpenDesignCandidates() {
     registryVersion: OPEN_DESIGN_REGISTRY_VERSION,
     source: {
       repo: OPEN_DESIGN_REPO,
-      commit: OPEN_DESIGN_COMMIT
+      ref: OPEN_DESIGN_COMMIT
     },
     sources: [
       {
         repo: OPEN_DESIGN_REPO,
-        commit: OPEN_DESIGN_COMMIT
+        ref: OPEN_DESIGN_COMMIT
       },
       {
         repo: VM0_SKILLS_REPO,
-        commit: VM0_SKILLS_REF
+        ref: VM0_SKILLS_REF
       }
     ],
     candidates: {
@@ -9395,7 +9646,7 @@ function createStyledImageAuthoringPacket(options) {
     `Registry: \`${candidateSlice.registryVersion}\``,
     "Sources:",
     ...candidateSlice.sources.map((src) => {
-      return `- \`${src.repo}@${src.commit}\``;
+      return `- \`${src.repo}@${src.ref}\``;
     }),
     "",
     "```json",
@@ -9404,7 +9655,7 @@ function createStyledImageAuthoringPacket(options) {
     "",
     "## Stage 2: Resolve Selected Resources",
     "- Fetch or read the selected resource source before generation.",
-    "- Source refs are pinned as `repo@commit:path`; use the commit in the packet for reproducibility.",
+    "- Each candidate carries a `source` object with `path` and optional `repo`/`ref`; when `repo`/`ref` are omitted, fall back to the registry-level source above.",
     "- For directory refs, inspect the most relevant files such as `SKILL.md`, references, examples, and templates.",
     "- If a source file cannot be fetched, state that limitation and fall back to the registry metadata for that resource.",
     "",
@@ -9574,6 +9825,12 @@ var BUILT_IN_GENERATION_PROVIDERS = {
       model: "fal-ai/bytedance/seedream/v4/text-to-image",
       command: "zero generate image --provider built-in --model seedream4 -h",
       reason: "available without connector setup"
+    },
+    {
+      label: "Built-in fal.ai",
+      model: "fal-ai/nano-banana-2",
+      command: "zero generate image --provider built-in --model nano-banana-2 -h",
+      reason: "available without connector setup"
     }
   ],
   presentation: [
@@ -9677,7 +9934,7 @@ var BUILT_IN_GENERATION_COMMANDS = {
   image: {
     label: "Built-in image generation",
     command: "zero generate image --provider built-in -h",
-    models: "fal.ai: gpt-image-1 (default), gpt-image-2, gpt-image-1.5, gpt-image-1-mini, flux-pro-1.1, flux-pro-1.1-ultra, qwen-image, seedream4"
+    models: "fal.ai: gpt-image-1 (default), gpt-image-2, gpt-image-1.5, gpt-image-1-mini, flux-pro-1.1, flux-pro-1.1-ultra, qwen-image, seedream4, nano-banana-2"
   },
   video: {
     label: "Built-in video generation",
@@ -10196,7 +10453,7 @@ function createImageGenerateCommand(config) {
     "When listing providers (no --prompt given), include unavailable or not-yet-authorized connectors"
   ).option(
     "--model <model>",
-    "Model: gpt-image-1 (default), gpt-image-2, gpt-image-1.5, gpt-image-1-mini, flux-pro-1.1, flux-pro-1.1-ultra, qwen-image, or seedream4",
+    "Model: gpt-image-1 (default), gpt-image-2, gpt-image-1.5, gpt-image-1-mini, flux-pro-1.1, flux-pro-1.1-ultra, qwen-image, seedream4, or nano-banana-2",
     "gpt-image-1"
   ).option(
     "--size <size>",
@@ -10253,7 +10510,7 @@ Notes:
 Models:
   - fal.ai: gpt-image-1 (default), gpt-image-2, gpt-image-1.5,
     gpt-image-1-mini, flux-pro-1.1, flux-pro-1.1-ultra, qwen-image,
-    seedream4.
+    seedream4, nano-banana-2.
     GPT Image models bill by fal output image quality and size.
     Other fal generations bill by output image or rounded-up output
     megapixel, depending on the model.
@@ -10272,15 +10529,15 @@ Options:
   - Quality: low, medium, high, or auto. Low is fastest for drafts.
   - Background: auto, opaque, or transparent when supported. gpt-image-2,
     Flux, Qwen, and Seedream do not support transparent backgrounds.
-  - Format: png, jpeg, or webp for GPT Image models; png or jpeg for the
-    other fal models.
-  - fal-only controls: --seed, --safety-tolerance for Flux, and
+  - Format: png, jpeg, or webp for GPT Image and Nano Banana 2 models; png or
+    jpeg for the other fal models.
+  - fal-only controls: --seed and --safety-tolerance for supported fal models;
     --enhance-prompt for flux-pro-1.1. --compression and --moderation low are
     not supported on the fal-backed image path.
   - Image-to-image: pass --image-url to use the model's fal edit/redux endpoint.
-    Flux Redux accepts --image-prompt-strength to override the provider
-    default; GPT edit models accept --input-fidelity and supported models
-    accept --mask-image-url.
+    Nano Banana 2 accepts up to 14 source images. Flux Redux accepts
+    --image-prompt-strength to override the provider default; GPT edit models
+    accept --input-fidelity and supported models accept --mask-image-url.
 
 Image Styles:
 ${formatStyleListing(styles)}`;
@@ -10390,6 +10647,7 @@ var imageCommand = createImageGenerateCommand({
   Pipe prompt:           cat prompt.txt | zero generate image --skip-style
   GPT Image model:       zero generate image --skip-style --model gpt-image-1.5 --prompt "A poster" --size 1024x1536 --quality high
   Flux model:            zero generate image --skip-style --model flux-pro-1.1 --prompt "A product hero shot" --seed 42
+  Nano Banana 2:         zero generate image --skip-style --model nano-banana-2 --prompt "A crisp launch poster with readable typography"
   Image-to-image:        zero generate image --skip-style --model flux-pro-1.1 --image-url https://example.com/mockup.png --prompt "Turn this mockup into a polished product shot"
   List providers:        zero generate image
   Use a connector:       zero generate image --provider replicate`
@@ -10496,7 +10754,7 @@ function createHtmlArtifactAuthoringPacket(options) {
     `Registry: \`${candidateSlice.registryVersion}\``,
     "Sources:",
     ...candidateSlice.sources.map((src) => {
-      return `- \`${src.repo}@${src.commit}\``;
+      return `- \`${src.repo}@${src.ref}\``;
     }),
     "",
     "```json",
@@ -10505,7 +10763,7 @@ function createHtmlArtifactAuthoringPacket(options) {
     "",
     "## Stage 2: Resolve Selected Resources",
     "- For every selected resource, fetch or read the referenced source before authoring.",
-    "- Source refs are pinned as `repo@commit:path`; use the commit in the packet for reproducibility.",
+    "- Each candidate carries a `source` object with `path` and optional `repo`/`ref`; when `repo`/`ref` are omitted, fall back to the registry-level source above.",
     "- For directory refs, inspect the most relevant files such as `SKILL.md`, `DESIGN.md`, `README.md`, tokens, examples, and templates.",
     "- If a source file cannot be fetched, state that limitation and fall back to the registry metadata for that resource.",
     "",
@@ -11539,7 +11797,7 @@ function parseLimit4(value) {
   }
   return parsed;
 }
-function resultText2(command) {
+function resultText(command) {
   if (!command.result) {
     return "";
   }
@@ -11572,7 +11830,7 @@ async function runReadCommand2(kind, options) {
         command.error ? `${command.error.code}: ${command.error.message}` : "Local-browser command failed"
       );
     }
-    const text = resultText2(command);
+    const text = resultText(command);
     if (text) {
       console.log(text);
     }
@@ -11599,7 +11857,7 @@ async function waitForCommand2(commandId, timeoutSeconds) {
         command.error ? `${command.error.code}: ${command.error.message}` : "Local-browser command failed"
       );
     }
-    const text = resultText2(command);
+    const text = resultText(command);
     if (text) {
       console.log(text);
     }
@@ -12566,7 +12824,7 @@ function registerZeroCommands(prog, commands) {
 var program = new Command();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.169.2").addHelpText("after", () => {
+).version("9.171.0").addHelpText("after", () => {
   return buildZeroHelpText();
 });
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {