@vm0/cli 9.176.5 → 9.177.0

package/index.js

@@ -67,7 +67,7 @@ import {
   source_default,
   volumeConfigSchema,
   withErrorHandler
-} from "./chunk-4XXIJOZP.js";
+} from "./chunk-IL6D4DEA.js";
 import {
   __toESM,
   init_esm_shims
@@ -400,7 +400,7 @@ function getConfigPath() {
   return join(os.homedir(), ".vm0", "config.json");
 }
 var infoCommand = new Command().name("info").description("Display environment and debug information").action(async () => {
-  console.log(source_default.bold(`VM0 CLI v${"9.176.5"}`));
+  console.log(source_default.bold(`VM0 CLI v${"9.177.0"}`));
   console.log();
   const config = await loadConfig();
   const hasEnvToken = !!process.env.VM0_TOKEN;
@@ -4293,7 +4293,7 @@ var composeCommand = new Command().name("compose").description("Create or update
         options.autoUpdate = false;
       }
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.176.5");
+        await startSilentUpgrade("9.177.0");
       }
       try {
         let result;
@@ -4395,7 +4395,7 @@ var mainRunCommand = new Command().name("run").description("Run an agent").argum
   withErrorHandler(
     async (identifier, prompt, options) => {
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.176.5");
+        await startSilentUpgrade("9.177.0");
       }
       const { name, version } = parseIdentifier(identifier);
       let composeId;
@@ -6189,13 +6189,13 @@ var upgradeCommand = new Command().name("upgrade").description("Upgrade vm0 CLI
     if (latestVersion === null) {
       throw new Error("Could not check for updates. Please try again later.");
     }
-    if (latestVersion === "9.176.5") {
-      console.log(source_default.green(`\u2713 Already up to date (${"9.176.5"})`));
+    if (latestVersion === "9.177.0") {
+      console.log(source_default.green(`\u2713 Already up to date (${"9.177.0"})`));
       return;
     }
     console.log(
       source_default.yellow(
-        `Current version: ${"9.176.5"} -> Latest version: ${latestVersion}`
+        `Current version: ${"9.177.0"} -> Latest version: ${latestVersion}`
       )
     );
     console.log();
@@ -6222,7 +6222,7 @@ var upgradeCommand = new Command().name("upgrade").description("Upgrade vm0 CLI
     const success = await performUpgrade(packageManager);
     if (success) {
       console.log(
-        source_default.green(`\u2713 Upgraded from ${"9.176.5"} to ${latestVersion}`)
+        source_default.green(`\u2713 Upgraded from ${"9.177.0"} to ${latestVersion}`)
       );
       return;
     }
@@ -6289,7 +6289,7 @@ var whoamiCommand = new Command().name("whoami").description("Show current ident
 
 // src/index.ts
 var program = new Command();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.176.5");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.177.0");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "9.176.5",
+  "version": "9.177.0",
   "description": "CLI application",
   "repository": {
     "type": "git",

package/zero.js

@@ -144,7 +144,7 @@ import {
   upsertZeroOrgModelProvider,
   withErrorHandler,
   zeroAgentCustomSkillNameSchema
-} from "./chunk-4XXIJOZP.js";
+} from "./chunk-IL6D4DEA.js";
 import {
   __toESM,
   init_esm_shims
@@ -10285,6 +10285,11 @@ var BUILT_IN_GENERATION_COMMANDS = {
     command: "zero generate website -h",
     models: "gpt-5.5"
   },
+  sprite: {
+    label: "Built-in sprite asset generation",
+    command: "zero generate sprite -h",
+    models: "gpt-image-2 (recommended) via built-in image generation"
+  },
   voice: {
     label: "Built-in voice generation",
     command: "zero generate voice --provider built-in -h",
@@ -10312,6 +10317,7 @@ var GENERATION_TYPE_LABELS = {
   poster: "Poster",
   presentation: "Presentation",
   report: "Report",
+  sprite: "Sprite",
   text: "Text",
   video: "Video",
   voice: "Voice",
@@ -10328,6 +10334,7 @@ function getConnectorGenerationType(generationType) {
     case "poster":
     case "presentation":
     case "report":
+    case "sprite":
     case "website":
       return null;
     case "audio":
@@ -11425,6 +11432,309 @@ var presentationCommand = createPresentationGenerateCommand({
   Show choices:          zero generate presentation`
 });
 
+// src/commands/zero/generate/sprite.ts
+init_esm_shims();
+
+// src/commands/zero/shared/sprite-authoring.ts
+init_esm_shims();
+var SPRITE_SKILL = {
+  repo: "0x0funky/agent-sprite-forge",
+  ref: "main",
+  skillPath: "skills/generate2dsprite/SKILL.md",
+  references: [
+    "skills/generate2dsprite/references/prompt-rules.md",
+    "skills/generate2dsprite/references/modes.md"
+  ],
+  script: "skills/generate2dsprite/scripts/generate2dsprite.py"
+};
+var CORE_INVARIANTS = [
+  "Every raw sprite image must come from built-in image generation. Never draw raw sprite art with Three.js, Canvas, SVG, HTML/CSS, PIL shapes, procedural geometry, placeholder primitives, or code-rendered screenshots. Code may only assemble layout guides, postprocess generated images, or display finished assets at runtime.",
+  "Background is 100% solid flat magenta `#FF00FF` with no gradient, so the local processor can chroma-key it to transparency. Keep this rule unless the user explicitly wants a different processing workflow.",
+  "No text, labels, UI, speech bubbles, borders, or frames between cells. Generate the exact requested grid count only.",
+  "Keep the same asset identity, the same bounding box, and the same pixel scale across every frame.",
+  "Containment: the entire subject fits fully inside each cell with magenta margin on all four sides. No limb, weapon, tail, wing tip, orb, spark, or trail may cross a cell edge.",
+  "Do not use raw single-row sheets (1x4, 1x6, 1x8, 1xN) for any body subject \u2014 players, heroes, creatures, NPCs, enemies, summons, or animated props. Use centered multi-row grids: 4 frames -> 2x2, 6 -> 2x3, 8 -> 2x4, 9 -> 3x3, 12 -> 3x4 or 4x3, 16 -> 4x4.",
+  "For controllable heroes and main characters, attack/shoot/cast body sheets are body-only by default and must preserve idle/run body scale and the feet/bottom anchor. Generate slash arcs, weapon trails, muzzle flashes, projectiles, dust, and impacts as separate fx/projectile/impact sheets unless the runtime explicitly supports wider per-action cells plus per-action origins.",
+  "For map prop packs, classify props first. Square 2x2/3x3/4x4 packs are only for compact props. Floors, platforms, bridges, walls, ladders, gates, doors, long hazards, wide/tall props, collision-bearing objects, and tileset/strip pieces use one-by-one generation, 1x3/1x4 strips, custom wide cells, or a tileset-like atlas instead.",
+  "Mixed-action atlases (4x4, 5x5, custom) are a deterministic delivery step assembled from separate per-action sheets after each passes QC \u2014 never one raw mixed-action image. Raw multi-cell grids are valid only for one coherent action family, canonical directional locomotion, prop packs, or tileset-like atlases."
+];
+var WORKFLOW = [
+  "1. Resolve the upstream skill below, then infer or confirm the asset plan. Pick the smallest useful output and do not pad unrelated actions into one raw sheet.",
+  "2. Write the art prompt by hand using the skill's prompt-rules. Lock the art style, the exact sheet shape, the solid magenta background, the identity, and the containment rules. Do not delegate prompt writing to a script.",
+  "3. Generate each raw sheet with built-in image generation using the recommended model below. If a reference is involved, make it visible to the model first (view a local file before generating); never pass a bare filesystem path as the visual reference.",
+  "4. Postprocess each raw sheet locally with the skill's processor script: magenta cleanup, frame extraction, alignment, shared-scale normalization, component filtering, QC metadata, transparent sheet export, and GIF export.",
+  "5. QC each sheet: no frame touches a cell edge, scale is consistent, detached FX did not become noise, the sheet reads as one coherent animation, and hero/player body height matches the accepted idle/run scale within ~10-15%. Reprocess or regenerate if it fails.",
+  "6. Return the bundle for the resolved plan (single sheet, unit/spell/combat bundle, line bundle, or hero action bundle with separate FX assets and an optional assembled engine atlas after per-action QC)."
+];
+var EXPECTED_OUTPUTS = [
+  "`raw-sheet.png` (and one raw sheet per action for bundles)",
+  "`raw-sheet-clean.png` (magenta cleaned)",
+  "`sheet-transparent.png`",
+  "per-frame PNGs",
+  "`animation.gif` (per direction/action where applicable)",
+  "`prompt-used.txt`",
+  "`pipeline-meta.json`"
+];
+function createSpriteAuthoringPacket(options) {
+  const { prompt, plan } = options;
+  const outputDir2 = `./generated/sprites/${plan.name}`;
+  const planEntries = [
+    ["Asset type", plan.assetType],
+    ["Action", plan.action],
+    ["View", plan.view],
+    ["Sheet / grid", plan.sheet],
+    ["Frames", plan.frames],
+    ["Bundle", plan.bundle],
+    ["Art style", plan.artStyle],
+    ["Anchor", plan.anchor],
+    ["Margin", plan.margin],
+    ["Effect policy", plan.effectPolicy],
+    ["Reference", plan.reference]
+  ];
+  const instructions = [
+    "# Zero generate sprite",
+    "",
+    "This is a federated generation source-selection packet for the current agent.",
+    "Zero is not generating these sprites on the server. You resolve the sprite skill below, write the art prompt yourself, generate each raw sheet with built-in image generation, then run the skill's local processor for chroma-key cleanup, frame extraction, alignment, QC, and transparent/GIF export.",
+    "",
+    "## User Prompt",
+    prompt,
+    "",
+    "## Sprite Plan",
+    "These parameters were resolved from the command. `agent decides` means the flag was not set \u2014 infer the best value from the prompt and the skill's modes reference; do not force the user to spell it out.",
+    "",
+    ...planEntries.map(([label, value]) => {
+      return `- ${label}: ${value}`;
+    }),
+    `- Output name: ${plan.name}`,
+    "",
+    "## Recommended Model",
+    `- Use \`${plan.model}\` for every raw sheet via built-in image generation (\`zero generate image --provider built-in --model ${plan.model} --skip-style --prompt "..."\`, or the in-context image tool).`,
+    "- gpt-image-2 is recommended for sprite sheets: it accepts flexible WIDTHxHEIGHT sizes and high quality for crisp, evenly-spaced grids. It does not emit transparent backgrounds, which is expected here \u2014 the solid magenta background is chroma-keyed by the local processor.",
+    "- Pick a sheet-friendly square or grid-aligned size (for example 1024x1024 for 2x2/3x3/4x4) so each cell stays evenly spaced.",
+    "",
+    "## Workflow Skill",
+    "Resolve this skill before authoring; it is the authority for sprite prompt patterns, sheet/bundle selection, and the postprocessing primitive.",
+    "",
+    `- Repo: \`${SPRITE_SKILL.repo}@${SPRITE_SKILL.ref}\``,
+    `- Skill: \`${SPRITE_SKILL.skillPath}\``,
+    `- References: ${SPRITE_SKILL.references.map((ref) => {
+      return `\`${ref}\``;
+    }).join(", ")}`,
+    `- Processor script: \`${SPRITE_SKILL.script}\``,
+    "- For map props that must match a tile map, prefer the sibling `generate2dmap` skill in the same repo.",
+    "- If a source file cannot be fetched, state that limitation and fall back to the core invariants below.",
+    "",
+    "## Core Invariants",
+    ...CORE_INVARIANTS.map((rule) => {
+      return `- ${rule}`;
+    }),
+    "",
+    "## Workflow",
+    ...WORKFLOW,
+    "",
+    "## Output Contract",
+    `- Write the bundle under \`${outputDir2}/\`.`,
+    "- Keep the original generated images and produce, per sheet:",
+    ...EXPECTED_OUTPUTS.map((item) => {
+      return `  - ${item}`;
+    }),
+    "- For bundles, create one subfolder per asset and keep the per-action FX/projectile/impact sheets separate.",
+    "",
+    "## Verification",
+    "- Confirm each transparent sheet and its frames are nonblank and free of magenta fringing.",
+    "- Confirm no frame touches a cell edge and that scale and identity stay consistent across frames.",
+    "- For hero/player body actions, confirm body height matches the accepted idle/run scale within ~10-15%.",
+    "- Report the output directory, the final assets, and the resolved plan."
+  ].join("\n");
+  return {
+    type: "generation-source-selection",
+    kind: "sprite",
+    prompt,
+    plan,
+    model: plan.model,
+    outputDir: outputDir2,
+    skill: SPRITE_SKILL,
+    instructions
+  };
+}
+
+// src/commands/zero/generate/sprite.ts
+var SPRITE_USAGE_COMMAND = "zero generate sprite";
+var DEFAULT_MODEL = "gpt-image-2";
+var AGENT_DECIDES = "agent decides";
+var ASSET_TYPES = [
+  "player",
+  "npc",
+  "creature",
+  "character",
+  "spell",
+  "projectile",
+  "impact",
+  "prop",
+  "summon",
+  "fx"
+];
+var ACTIONS = [
+  "single",
+  "idle",
+  "cast",
+  "attack",
+  "shoot",
+  "jump",
+  "hurt",
+  "combat",
+  "walk",
+  "run",
+  "hover",
+  "charge",
+  "projectile",
+  "impact",
+  "explode",
+  "death"
+];
+var VIEWS = ["topdown", "side", "3-4"];
+var SHEETS = [
+  "auto",
+  "2x2",
+  "2x3",
+  "2x4",
+  "3x3",
+  "3x4",
+  "4x4",
+  "5x5",
+  "strip-1x3",
+  "strip-1x4",
+  "custom"
+];
+var BUNDLES = [
+  "single",
+  "unit",
+  "spell",
+  "combat",
+  "line",
+  "hero-action",
+  "engine-atlas"
+];
+var ART_STYLES = [
+  "pixel-art",
+  "clean-hd",
+  "pixel-inspired",
+  "retro-pixel",
+  "map-style",
+  "project-native"
+];
+var ANCHORS = ["center", "bottom", "feet"];
+var MARGINS = ["tight", "normal", "safe"];
+var EFFECT_POLICIES = ["all", "largest"];
+function validateEnum(flag, value, allowed) {
+  if (value !== void 0 && !allowed.includes(value)) {
+    throw new Error(
+      `${flag} must be one of: ${allowed.join(", ")} (got "${value}")`
+    );
+  }
+}
+function resolveFrames(value) {
+  if (value === void 0) {
+    return AGENT_DECIDES;
+  }
+  if (value === "auto") {
+    return value;
+  }
+  const frames = Number(value);
+  if (!Number.isInteger(frames) || frames < 1 || frames > 64) {
+    throw new Error("--frames must be 'auto' or an integer from 1 to 64");
+  }
+  return String(frames);
+}
+function slugify2(value) {
+  const slug = value.toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "").replace(/-{2,}/gu, "-").slice(0, 48).replace(/-+$/u, "");
+  return slug.length >= 3 ? slug : "sprite";
+}
+var spriteCommand = new Command().name("sprite").description(
+  "Prepare 2D game sprite/asset authoring instructions from a prompt"
+).option("--prompt <text>", "Sprite prompt/theme; can also be piped via stdin").option("--asset-type <type>", `Asset type: ${ASSET_TYPES.join(", ")}`).option("--action <action>", `Animation/action: ${ACTIONS.join(", ")}`).option(
+  "--view <view>",
+  `Camera view: ${VIEWS.join(", ")} (3-4 means 3/4 view)`
+).option("--sheet <grid>", `Sheet/grid shape: ${SHEETS.join(", ")}`, "auto").option("--frames <count>", "Frame count: 'auto' or an integer (1-64)").option("--bundle <preset>", `Bundle preset: ${BUNDLES.join(", ")}`).option(
+  "--art-style <style>",
+  `Sprite art style (the sprite analog of 'zero generate image --style'): ${ART_STYLES.join(", ")}`
+).option("--anchor <anchor>", `Frame anchor: ${ANCHORS.join(", ")}`).option("--margin <margin>", `Safe-area margin: ${MARGINS.join(", ")}`).option(
+  "--effect-policy <policy>",
+  `Detached-FX component policy: ${EFFECT_POLICIES.join(", ")}`
+).option(
+  "--reference <url>",
+  "Reference image URL for identity/style consistency"
+).option(
+  "--model <model>",
+  "Recommended image model for raw sheets",
+  DEFAULT_MODEL
+).option("--name <slug>", "Output bundle name/slug").addHelpText(
+  "after",
+  `
+Examples:
+  Generate sprite:       ${SPRITE_USAGE_COMMAND} --prompt "A green slime monster idle loop"
+  Pick asset + action:   ${SPRITE_USAGE_COMMAND} --asset-type creature --action idle --sheet 3x3 --prompt "A fire dragon boss"
+  Hero action bundle:    ${SPRITE_USAGE_COMMAND} --asset-type player --bundle hero-action --view side --prompt "A knight with idle, run, attack, jump"
+  4-direction walk:      ${SPRITE_USAGE_COMMAND} --asset-type player --action walk --view topdown --sheet 4x4 --prompt "A 16-bit RPG villager"
+  Pixel art style:       ${SPRITE_USAGE_COMMAND} --art-style pixel-art --prompt "A retro fireball projectile" --sheet 2x2
+  Match a reference:     ${SPRITE_USAGE_COMMAND} --reference https://example.com/hero.png --action attack --prompt "Attack animation for this hero"
+  Pipe prompt:           cat brief.txt | ${SPRITE_USAGE_COMMAND}
+  Show choices:          ${SPRITE_USAGE_COMMAND}
+
+Output:
+  Prints a sprite source-selection packet for the current agent: the resolved
+  plan, the recommended image model, the upstream sprite skill to resolve, and
+  the hard containment rules for grids, identity, and FX.
+  With no --prompt and no piped input, prints the generation choices instead.
+
+Notes:
+  - The agent generates each raw sheet with built-in image generation
+    (gpt-image-2 recommended) on a solid magenta background, then runs the
+    sprite skill's local processor for chroma-key cleanup, frame extraction,
+    alignment, QC, and transparent/GIF export.
+  - Raw sprite art must originate from image generation, never from code-drawn
+    primitives (Three.js/Canvas/SVG/HTML/PIL).
+  - Unset flags resolve to "agent decides"; the agent infers them from the
+    prompt and the skill's modes reference.`
+).action(
+  withErrorHandler(async (options) => {
+    validateEnum("--asset-type", options.assetType, ASSET_TYPES);
+    validateEnum("--action", options.action, ACTIONS);
+    validateEnum("--view", options.view, VIEWS);
+    validateEnum("--sheet", options.sheet, SHEETS);
+    validateEnum("--bundle", options.bundle, BUNDLES);
+    validateEnum("--art-style", options.artStyle, ART_STYLES);
+    validateEnum("--anchor", options.anchor, ANCHORS);
+    validateEnum("--margin", options.margin, MARGINS);
+    validateEnum("--effect-policy", options.effectPolicy, EFFECT_POLICIES);
+    const frames = resolveFrames(options.frames);
+    const dispatch = await dispatchGenerate({
+      generationType: "sprite",
+      prompt: options.prompt
+    });
+    if (dispatch.outcome === "handled") return;
+    const prompt = dispatch.prompt;
+    const plan = {
+      assetType: options.assetType ?? AGENT_DECIDES,
+      action: options.action ?? AGENT_DECIDES,
+      view: options.view ?? AGENT_DECIDES,
+      sheet: options.sheet ?? "auto",
+      frames,
+      bundle: options.bundle ?? AGENT_DECIDES,
+      artStyle: options.artStyle ?? AGENT_DECIDES,
+      anchor: options.anchor ?? AGENT_DECIDES,
+      margin: options.margin ?? AGENT_DECIDES,
+      effectPolicy: options.effectPolicy ?? AGENT_DECIDES,
+      reference: options.reference ?? "none",
+      model: options.model,
+      name: slugify2(options.name ?? prompt)
+    };
+    const packet = createSpriteAuthoringPacket({ prompt, plan });
+    console.log(packet.instructions);
+  })
+);
+
 // src/commands/zero/generate/video.ts
 init_esm_shims();
 
@@ -11979,6 +12289,7 @@ function buildGenerateHelpText() {
     '  Generate docs:         zero generate docs-design --prompt "A setup guide"',
     '  Generate video:        zero generate video --prompt "A cinematic city shot"',
     '  Generate site:         zero generate website --prompt "A launch site"',
+    '  Generate sprite:       zero generate sprite --prompt "A slime monster idle loop"',
     '  Generate speech:       zero generate voice --prompt "Hello"',
     "  Show music choices:    zero generate music",
     "",
@@ -11998,7 +12309,7 @@ Notes:
 }
 var generateCommand = new Command().name("generate").description(
   "Generate assets via vm0's built-in pipelines or get connector skill-invocation guidance"
-).addCommand(imageCommand).addCommand(presentationCommand).addCommand(reportCommand).addCommand(docsDesignCommand).addCommand(posterCommand).addCommand(dashboardDesignCommand).addCommand(mobileAppDesignCommand).addCommand(videoCommand).addCommand(websiteCommand).addCommand(voiceCommand).addCommand(musicCommand).addCommand(textCommand).addCommand(codeCommand).addCommand(documentCommand).addHelpText("after", buildGenerateHelpText);
+).addCommand(imageCommand).addCommand(presentationCommand).addCommand(reportCommand).addCommand(docsDesignCommand).addCommand(posterCommand).addCommand(dashboardDesignCommand).addCommand(mobileAppDesignCommand).addCommand(videoCommand).addCommand(websiteCommand).addCommand(spriteCommand).addCommand(voiceCommand).addCommand(musicCommand).addCommand(textCommand).addCommand(codeCommand).addCommand(documentCommand).addHelpText("after", buildGenerateHelpText);
 
 // src/commands/zero/web/index.ts
 init_esm_shims();
@@ -12827,7 +13138,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.176.5").addHelpText("after", () => {
+).version("9.177.0").addHelpText("after", () => {
   return buildZeroHelpText();
 });
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {