@vm0/cli 9.129.2 → 9.131.0

package/package.json

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

package/zero.js

@@ -130,7 +130,7 @@ import {
   upsertZeroOrgModelProvider,
   withErrorHandler,
   zeroAgentCustomSkillNameSchema
-} from "./chunk-F23UIP5L.js";
+} from "./chunk-65M57PU6.js";
 import {
   __toESM,
   init_esm_shims
@@ -1167,17 +1167,210 @@ 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);
+}
+var REVERSE_SKIN_MAP = {
+  0: "light",
+  1: "light-medium",
+  2: "medium",
+  3: "medium-dark",
+  4: "dark"
+};
+var REVERSE_HAIR_COLOR_MAP = {
+  1: "blonde",
+  2: "teal",
+  3: "grey",
+  4: "pink",
+  5: "brown"
+};
+var REVERSE_EXPRESSION_MAP = {
+  1: "calm",
+  2: "content",
+  3: "neutral",
+  4: "pleasant",
+  5: "excited"
+};
+var REVERSE_INTENSITY_MAP = {
+  d: "chill",
+  m: "normal",
+  h: "hyped"
+};
+var PRESET_DESCRIPTIONS = {
+  "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"
+};
+function parseSvgAvatar(svg) {
+  const match = svg.match(/^svg:r(\d)s(\d)h(\d)c(\d)f(\d)([dmh])$/);
+  if (!match) return void 0;
+  const [, r, s, h, c, f, i] = match;
+  const parts = [];
+  const skin = REVERSE_SKIN_MAP[Number(s)];
+  if (skin) parts.push(`${skin} skin`);
+  const hairColor = REVERSE_HAIR_COLOR_MAP[Number(c)];
+  if (hairColor) parts.push(`${hairColor} hair`);
+  const expression = REVERSE_EXPRESSION_MAP[Number(f)];
+  if (expression) parts.push(expression);
+  const intensity = REVERSE_INTENSITY_MAP[i];
+  if (intensity) parts.push(intensity);
+  if (parts.length === 0) return void 0;
+  let desc = parts.join(", ");
+  if (r !== "3") {
+    const rotationLabels = {
+      "1": "far-left",
+      "2": "left",
+      "4": "right",
+      "5": "far-right"
+    };
+    const rot = rotationLabels[r];
+    if (rot) desc += `, ${rot}`;
+  }
+  if (h !== "1") {
+    desc += `, hair style ${h}`;
+  }
+  return desc;
+}
+function formatAvatar(avatarUrl) {
+  if (!avatarUrl) return void 0;
+  if (avatarUrl.startsWith("preset:")) {
+    const desc = PRESET_DESCRIPTIONS[avatarUrl];
+    return desc ? `${avatarUrl} (${desc})` : avatarUrl;
+  }
+  if (avatarUrl.startsWith("svg:")) {
+    const desc = parseSvgAvatar(avatarUrl);
+    return desc ? `custom (${desc})` : avatarUrl;
+  }
+  return avatarUrl;
+}
+
+// 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 +1389,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 +1428,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 +1497,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 +1521,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 +1564,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) {
@@ -1488,6 +1722,8 @@ Examples:
       if (agent.description)
         console.log(`Description:  ${agent.description}`);
       if (agent.sound) console.log(`Sound:        ${agent.sound}`);
+      const avatar = formatAvatar(agent.avatarUrl);
+      if (avatar) console.log(`Avatar:       ${avatar}`);
       if (options.permissions && connectorInfos.length > 0) {
         console.log();
         console.log(source_default.bold("Connectors:"));
@@ -6637,7 +6873,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.131.0").addHelpText(
   "after",
   `
 Examples: