@vm0/cli 9.129.2 → 9.130.0

package/package.json

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

package/zero.js

@@ -130,7 +130,7 @@ import {
   upsertZeroOrgModelProvider,
   withErrorHandler,
   zeroAgentCustomSkillNameSchema
-} from "./chunk-F23UIP5L.js";
+} from "./chunk-V5JAHNBR.js";
 import {
   __toESM,
   init_esm_shims
@@ -1167,17 +1167,135 @@ init_esm_shims();
 // src/commands/zero/agent/create.ts
 init_esm_shims();
 import { readFileSync } from "fs";
+
+// src/commands/zero/agent/avatar.ts
+init_esm_shims();
+var SKIN_MAP = {
+  light: 0,
+  "light-medium": 1,
+  medium: 2,
+  "medium-dark": 3,
+  dark: 4
+};
+var HAIR_COLOR_MAP = {
+  blonde: 1,
+  teal: 2,
+  grey: 3,
+  pink: 4,
+  brown: 5
+};
+var EXPRESSION_MAP = {
+  calm: 1,
+  content: 2,
+  neutral: 3,
+  pleasant: 4,
+  excited: 5
+};
+var INTENSITY_MAP = {
+  chill: "d",
+  normal: "m",
+  hyped: "h"
+};
+function lookupRequired(value, map, flag) {
+  if (!(value in map)) {
+    throw new Error(
+      `Invalid ${flag} "${value}". Must be one of: ${Object.keys(map).join(", ")}`
+    );
+  }
+  return map[value];
+}
+function parseIntRange(value, flag, min, max) {
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < min || n > max) {
+    throw new Error(`Invalid ${flag} "${value}". Must be ${min}\u2013${max}`);
+  }
+  return n;
+}
+function buildCustomSvgAvatar(opts) {
+  const r = opts.avatarRotation !== void 0 ? parseIntRange(opts.avatarRotation, "--avatar-rotation", 1, 5) : 3;
+  const h = opts.avatarHairStyle !== void 0 ? parseIntRange(opts.avatarHairStyle, "--avatar-hair-style", 1, 5) : 1;
+  const s = opts.avatarSkin !== void 0 ? lookupRequired(opts.avatarSkin, SKIN_MAP, "--avatar-skin") : 2;
+  const c = opts.avatarHairColor !== void 0 ? lookupRequired(
+    opts.avatarHairColor,
+    HAIR_COLOR_MAP,
+    "--avatar-hair-color"
+  ) : 5;
+  const f = opts.avatarExpression !== void 0 ? lookupRequired(
+    opts.avatarExpression,
+    EXPRESSION_MAP,
+    "--avatar-expression"
+  ) : 1;
+  const i = opts.avatarIntensity !== void 0 ? lookupRequired(
+    opts.avatarIntensity,
+    INTENSITY_MAP,
+    "--avatar-intensity"
+  ) : "m";
+  return `svg:r${r}s${s}h${h}c${c}f${f}${i}`;
+}
+function resolveAvatarUrl(opts) {
+  const hasPreset = opts.avatar !== void 0;
+  const hasCustom = opts.avatarRotation !== void 0 || opts.avatarSkin !== void 0 || opts.avatarHairStyle !== void 0 || opts.avatarHairColor !== void 0 || opts.avatarExpression !== void 0 || opts.avatarIntensity !== void 0;
+  if (!hasPreset && !hasCustom) return void 0;
+  if (hasPreset && hasCustom) {
+    throw new Error(
+      "--avatar cannot be combined with --avatar-* attribute options"
+    );
+  }
+  if (hasPreset) {
+    if (!/^preset:[0-4]$/.test(opts.avatar)) {
+      throw new Error(
+        `Invalid --avatar "${opts.avatar}". Use preset:0 through preset:4`
+      );
+    }
+    return opts.avatar;
+  }
+  return buildCustomSvgAvatar(opts);
+}
+
+// src/commands/zero/agent/create.ts
 var createCommand = new Command().name("create").description("Create a new zero agent").option(
   "--skills <items>",
   "Comma-separated custom skill names to attach (e.g. my-skill,other-skill)"
 ).option("--display-name <name>", "Agent display name").option("--description <text>", "Agent description").option(
   "--sound <tone>",
   "Agent tone: professional, friendly, direct, supportive"
-).option("--instructions-file <path>", "Path to instructions file").addHelpText(
+).option("--avatar <preset>", "Avatar preset: preset:0 through preset:4").option(
+  "--avatar-rotation <1-5>",
+  "Head angle: 1=far-left  3=center  5=far-right"
+).option(
+  "--avatar-skin <tone>",
+  "Skin tone: light | light-medium | medium | medium-dark | dark"
+).option("--avatar-hair-style <1-5>", "Hair style: 1\u20135").option(
+  "--avatar-hair-color <color>",
+  "Hair color: blonde | teal | grey | pink | brown"
+).option(
+  "--avatar-expression <expr>",
+  "Expression: calm | content | neutral | pleasant | excited"
+).option("--avatar-intensity <level>", "Intensity: chill | normal | hyped").option("--instructions-file <path>", "Path to instructions file").addHelpText(
   "after",
   `
+Avatar:
+  Quick presets (--avatar):
+    preset:0  light skin, brown hair, calm, hyped
+    preset:1  light-medium skin, grey hair, calm, normal
+    preset:2  medium skin, pink hair, neutral, chill
+    preset:3  medium-dark skin, blonde hair, pleasant, hyped
+    preset:4  dark skin, teal hair, excited, normal
+
+  Custom attributes (--avatar-* flags, omitted fields use defaults):
+    --avatar-rotation    1=far-left  3=center(default)  5=far-right
+    --avatar-skin        light / light-medium / medium(default) / medium-dark / dark
+    --avatar-hair-style  1\u20135 (default: 1)
+    --avatar-hair-color  blonde / teal / grey / pink / brown(default)
+    --avatar-expression  calm(default) / content / neutral / pleasant / excited
+    --avatar-intensity   chill / normal(default) / hyped
+
+  Note: --avatar and --avatar-* cannot be used together.
+
 Examples:
   Minimal:               zero agent create --display-name "My Agent"
+  Quick preset:          zero agent create --display-name "My Agent" --avatar preset:2
+  Custom avatar:         zero agent create --display-name "My Agent" --avatar-skin dark --avatar-hair-color teal --avatar-intensity hyped
   With skills:           zero agent create --skills my-skill,other-skill --display-name "My Agent"
   With instructions:     zero agent create --display-name "My Agent" --instructions-file ./instructions.md`
 ).action(
@@ -1196,10 +1314,12 @@ Examples:
           }
         }
       }
+      const avatarUrl = resolveAvatarUrl(options);
       const agent = await createZeroAgent({
         displayName: options.displayName,
         description: options.description,
         sound: options.sound,
+        avatarUrl,
         customSkills
       });
       if (options.instructionsFile) {
@@ -1233,18 +1353,25 @@ Examples:
 // src/commands/zero/agent/edit.ts
 init_esm_shims();
 import { readFileSync as readFileSync2 } from "fs";
+function hasAvatarUpdate(options) {
+  return options.avatar !== void 0 || options.avatarRotation !== void 0 || options.avatarSkin !== void 0 || options.avatarHairStyle !== void 0 || options.avatarHairColor !== void 0 || options.avatarExpression !== void 0 || options.avatarIntensity !== void 0;
+}
 function hasAgentFieldUpdate(options) {
-  return options.displayName !== void 0 || options.description !== void 0 || options.sound !== void 0 || options.skills !== void 0 || options.addSkill !== void 0 || options.removeSkill !== void 0 || options.modelProvider !== void 0 || options.model !== void 0;
+  return options.displayName !== void 0 || options.description !== void 0 || options.sound !== void 0 || hasAvatarUpdate(options) || options.skills !== void 0 || options.addSkill !== void 0 || options.removeSkill !== void 0 || options.modelProvider !== void 0 || options.model !== void 0;
 }
 async function applyAgentUpdate(agentId, options) {
+  const hasAvatar = hasAvatarUpdate(options);
+  const resolvedAvatarUrl = hasAvatar ? resolveAvatarUrl(options) : void 0;
   const current = await getZeroAgent(agentId);
   const customSkills = resolveCustomSkills(options, current.customSkills ?? []);
   const modelProviderId = options.modelProvider !== void 0 ? parseModelFlag(options.modelProvider) : current.modelProviderId;
   const selectedModel = options.model !== void 0 ? parseModelFlag(options.model) : current.selectedModel;
+  const avatarUrl = hasAvatar ? resolvedAvatarUrl : current.avatarUrl ?? void 0;
   await updateZeroAgent(agentId, {
     displayName: options.displayName !== void 0 ? options.displayName : current.displayName ?? void 0,
     description: options.description !== void 0 ? options.description : current.description ?? void 0,
     sound: options.sound !== void 0 ? options.sound : current.sound ?? void 0,
+    avatarUrl,
     customSkills,
     modelProviderId,
     selectedModel
@@ -1295,7 +1422,19 @@ function resolveCustomSkills(options, existing) {
 var editCommand = new Command().name("edit").description("Edit a zero agent").argument("<agent-id>", "Agent ID").option("--display-name <name>", "New display name").option("--description <text>", "New description").option(
   "--sound <tone>",
   "New tone: professional, friendly, direct, supportive"
+).option("--avatar <preset>", "Avatar preset: preset:0 through preset:4").option(
+  "--avatar-rotation <1-5>",
+  "Head angle: 1=far-left  3=center  5=far-right"
+).option(
+  "--avatar-skin <tone>",
+  "Skin tone: light | light-medium | medium | medium-dark | dark"
+).option("--avatar-hair-style <1-5>", "Hair style: 1\u20135").option(
+  "--avatar-hair-color <color>",
+  "Hair color: blonde | teal | grey | pink | brown"
 ).option(
+  "--avatar-expression <expr>",
+  "Expression: calm | content | neutral | pleasant | excited"
+).option("--avatar-intensity <level>", "Intensity: chill | normal | hyped").option(
   "--skills <items>",
   "Comma-separated custom skill names to attach (replaces existing)"
 ).option("--add-skill <name>", "Add a custom skill to the agent").option("--remove-skill <name>", "Remove a custom skill from the agent").option("--instructions-file <path>", "Path to new instructions file").option(
@@ -1307,9 +1446,29 @@ var editCommand = new Command().name("edit").description("Edit a zero agent").ar
 ).addHelpText(
   "after",
   `
+Avatar:
+  Quick presets (--avatar):
+    preset:0  light skin, brown hair, calm, hyped
+    preset:1  light-medium skin, grey hair, calm, normal
+    preset:2  medium skin, pink hair, neutral, chill
+    preset:3  medium-dark skin, blonde hair, pleasant, hyped
+    preset:4  dark skin, teal hair, excited, normal
+
+  Custom attributes (--avatar-* flags, replace the entire avatar):
+    --avatar-rotation    1=far-left  3=center(default)  5=far-right
+    --avatar-skin        light / light-medium / medium(default) / medium-dark / dark
+    --avatar-hair-style  1\u20135 (default: 1)
+    --avatar-hair-color  blonde / teal / grey / pink / brown(default)
+    --avatar-expression  calm(default) / content / neutral / pleasant / excited
+    --avatar-intensity   chill / normal(default) / hyped
+
+  Note: --avatar and --avatar-* cannot be used together.
+
 Examples:
   Update description:      zero agent edit <agent-id> --description "new role"
   Update tone:             zero agent edit <agent-id> --sound friendly
+  Quick preset avatar:     zero agent edit <agent-id> --avatar preset:2
+  Custom avatar:           zero agent edit <agent-id> --avatar-skin dark --avatar-hair-color teal --avatar-intensity hyped
   Replace all skills:      zero agent edit <agent-id> --skills my-skill,other-skill
   Add a skill:             zero agent edit <agent-id> --add-skill my-skill
   Remove a skill:          zero agent edit <agent-id> --remove-skill my-skill
@@ -1330,7 +1489,7 @@ Notes:
     const hasAgentUpdate = hasAgentFieldUpdate(options);
     if (!hasAgentUpdate && !options.instructionsFile) {
       throw new Error(
-        "At least one option is required (--display-name, --description, --sound, --skills, --add-skill, --remove-skill, --model-provider, --model, --instructions-file)"
+        "At least one option is required (--display-name, --description, --sound, --avatar, --avatar-*, --skills, --add-skill, --remove-skill, --model-provider, --model, --instructions-file)"
       );
     }
     if (hasAgentUpdate) {
@@ -6637,7 +6796,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.129.2").addHelpText(
+).version("9.130.0").addHelpText(
   "after",
   `
 Examples: