@vm0/cli 9.90.1 → 9.90.3

package/package.json

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

package/zero.js

@@ -7,13 +7,13 @@ import {
   allowsCustomModel,
   configureGlobalProxyFromEnv,
   connectorTypeSchema,
-  createAgentSkill,
+  createSkill,
   createZeroAgent,
   createZeroComputerConnector,
   createZeroConnectorSession,
   createZeroRun,
   decodeZeroTokenPayload,
-  deleteAgentSkill,
+  deleteSkill,
   deleteZeroAgent,
   deleteZeroComputerConnector,
   deleteZeroConnector,
@@ -29,7 +29,6 @@ import {
   enableZeroSchedule,
   findMatchingPermissions,
   getActiveOrg,
-  getAgentSkill,
   getApiUrl,
   getAskUserAnswer,
   getAuthMethodsForType,
@@ -44,6 +43,7 @@ import {
   getScopeDiff,
   getSecretsForAuthMethod,
   getSelectableProviderTypes,
+  getSkill,
   getToken,
   getZeroAgent,
   getZeroAgentInstructions,
@@ -64,7 +64,7 @@ import {
   isInteractive,
   isUUID,
   leaveZeroOrg,
-  listAgentSkills,
+  listSkills,
   listZeroAgents,
   listZeroConnectors,
   listZeroOrgModelProviders,
@@ -93,7 +93,7 @@ import {
   setZeroSecret,
   setZeroVariable,
   switchZeroOrg,
-  updateAgentSkill,
+  updateSkill,
   updateZeroAgent,
   updateZeroAgentInstructions,
   updateZeroOrg,
@@ -101,7 +101,7 @@ import {
   updateZeroUserPreferences,
   upsertZeroOrgModelProvider,
   withErrorHandler
-} from "./chunk-RJS4OQ2I.js";
+} from "./chunk-HZQ6GQVS.js";
 
 // src/zero.ts
 import { Command as Command68 } from "commander";
@@ -1132,37 +1132,69 @@ Examples:
 import { Command as Command25 } from "commander";
 import { readFileSync as readFileSync2 } from "fs";
 import chalk22 from "chalk";
+function resolveCustomSkills(options, existing) {
+  if (options.skills && (options.addSkill || options.removeSkill)) {
+    throw new Error("Cannot use --skills with --add-skill or --remove-skill");
+  }
+  if (options.skills) {
+    return options.skills.split(",").map((s) => s.trim());
+  }
+  if (options.addSkill) {
+    if (existing.includes(options.addSkill)) {
+      throw new Error(
+        `Skill "${options.addSkill}" is already attached to this agent`
+      );
+    }
+    return [...existing, options.addSkill];
+  }
+  if (options.removeSkill) {
+    if (!existing.includes(options.removeSkill)) {
+      throw new Error(
+        `Skill "${options.removeSkill}" is not attached to this agent`
+      );
+    }
+    return existing.filter((s) => s !== options.removeSkill);
+  }
+  return void 0;
+}
 var editCommand = new Command25().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(
   "--skills <items>",
   "Comma-separated custom skill names to attach (replaces existing)"
-).option("--instructions-file <path>", "Path to new instructions file").addHelpText(
+).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").addHelpText(
   "after",
   `
 Examples:
   Update description:      zero agent edit <agent-id> --description "new role"
   Update tone:             zero agent edit <agent-id> --sound friendly
-  Update skills:           zero agent edit <agent-id> --skills my-skill,other-skill
+  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
   Update instructions:     zero agent edit <agent-id> --instructions-file ./instructions.md
   Update yourself:         zero agent edit $ZERO_AGENT_ID --description "new role"
 
 Notes:
   - At least one option is required
-  - Unspecified fields are preserved (not cleared)`
+  - Unspecified fields are preserved (not cleared)
+  - --skills replaces the entire skill list; --add-skill/--remove-skill modify incrementally
+  - --skills cannot be combined with --add-skill or --remove-skill`
 ).action(
   withErrorHandler(
     async (agentId, options) => {
-      const hasAgentUpdate = options.displayName !== void 0 || options.description !== void 0 || options.sound !== void 0 || options.skills !== void 0;
+      const hasAgentUpdate = options.displayName !== void 0 || options.description !== void 0 || options.sound !== void 0 || options.skills !== void 0 || options.addSkill !== void 0 || options.removeSkill !== void 0;
       if (!hasAgentUpdate && !options.instructionsFile) {
         throw new Error(
-          "At least one option is required (--display-name, --description, --sound, --skills, --instructions-file)"
+          "At least one option is required (--display-name, --description, --sound, --skills, --add-skill, --remove-skill, --instructions-file)"
         );
       }
       if (hasAgentUpdate) {
         const current = await getZeroAgent(agentId);
-        const customSkills = options.skills ? options.skills.split(",").map((s) => s.trim()) : void 0;
+        const customSkills = resolveCustomSkills(
+          options,
+          current.customSkills ?? []
+        );
         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,
@@ -3611,32 +3643,26 @@ import { Command as Command62 } from "commander";
 import { readFileSync as readFileSync4, existsSync } from "fs";
 import { join as join2 } from "path";
 import chalk48 from "chalk";
-var createCommand2 = new Command62().name("create").description("Create a custom skill for a zero agent").argument("<name>", "Skill name (lowercase alphanumeric with hyphens)").requiredOption("--dir <path>", "Path to directory containing SKILL.md").option("--agent <id>", "Agent ID (defaults to $ZERO_AGENT_ID)").option("--display-name <name>", "Skill display name").option("--description <text>", "Skill description").addHelpText(
+var createCommand2 = new Command62().name("create").description("Create a custom skill in the organization").argument("<name>", "Skill name (lowercase alphanumeric with hyphens)").requiredOption("--dir <path>", "Path to directory containing SKILL.md").option("--display-name <name>", "Skill display name").option("--description <text>", "Skill description").addHelpText(
   "after",
   `
 Examples:
   zero skill create my-skill --dir ./skills/my-skill/
-  zero skill create my-skill --dir ./skills/my-skill/ --agent <id>
   zero skill create my-skill --dir ./skills/my-skill/ --display-name "My Skill" --description "Does things"
 
 Notes:
   - The directory must contain a SKILL.md file
-  - Agent ID defaults to $ZERO_AGENT_ID if --agent is not provided`
+  - The skill is created in the organization but not bound to any agent
+  - Use 'zero agent edit <id> --add-skill <name>' to bind a skill to an agent`
 ).action(
   withErrorHandler(
     async (name, options) => {
-      const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
-      if (!agentId) {
-        throw new Error(
-          "Agent ID required: use --agent <id> or set $ZERO_AGENT_ID"
-        );
-      }
       const skillMdPath = join2(options.dir, "SKILL.md");
       if (!existsSync(skillMdPath)) {
         throw new Error(`SKILL.md not found in ${options.dir}`);
       }
       const content = readFileSync4(skillMdPath, "utf-8");
-      const skill = await createAgentSkill(agentId, {
+      const skill = await createSkill({
         name,
         content,
         displayName: options.displayName,
@@ -3644,7 +3670,6 @@ Notes:
       });
       console.log(chalk48.green(`\u2713 Skill "${skill.name}" created`));
       console.log(`  Name:         ${skill.name}`);
-      console.log(`  Agent:        ${agentId}`);
       if (skill.displayName) {
         console.log(`  Display Name: ${skill.displayName}`);
       }
@@ -3663,50 +3688,34 @@ import chalk49 from "chalk";
 var editCommand2 = new Command63().name("edit").description("Update a custom skill's content").argument("<name>", "Skill name").requiredOption(
   "--dir <path>",
   "Path to directory containing updated SKILL.md"
-).option("--agent <id>", "Agent ID (defaults to $ZERO_AGENT_ID)").addHelpText(
+).addHelpText(
   "after",
   `
 Examples:
-  zero skill edit my-skill --dir ./skills/my-skill/
-  zero skill edit my-skill --dir ./skills/my-skill/ --agent <id>`
+  zero skill edit my-skill --dir ./skills/my-skill/`
 ).action(
-  withErrorHandler(
-    async (name, options) => {
-      const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
-      if (!agentId) {
-        throw new Error(
-          "Agent ID required: use --agent <id> or set $ZERO_AGENT_ID"
-        );
-      }
-      const skillMdPath = join3(options.dir, "SKILL.md");
-      if (!existsSync2(skillMdPath)) {
-        throw new Error(`SKILL.md not found in ${options.dir}`);
-      }
-      const content = readFileSync5(skillMdPath, "utf-8");
-      await updateAgentSkill(agentId, name, { content });
-      console.log(chalk49.green(`\u2713 Skill "${name}" updated`));
+  withErrorHandler(async (name, options) => {
+    const skillMdPath = join3(options.dir, "SKILL.md");
+    if (!existsSync2(skillMdPath)) {
+      throw new Error(`SKILL.md not found in ${options.dir}`);
     }
-  )
+    const content = readFileSync5(skillMdPath, "utf-8");
+    await updateSkill(name, { content });
+    console.log(chalk49.green(`\u2713 Skill "${name}" updated`));
+  })
 );
 
 // src/commands/zero/skill/view.ts
 import { Command as Command64 } from "commander";
 import chalk50 from "chalk";
-var viewCommand2 = new Command64().name("view").description("View a custom skill").argument("<name>", "Skill name").option("--agent <id>", "Agent ID (defaults to $ZERO_AGENT_ID)").addHelpText(
+var viewCommand2 = new Command64().name("view").description("View a custom skill").argument("<name>", "Skill name").addHelpText(
   "after",
   `
 Examples:
-  zero skill view my-skill
-  zero skill view my-skill --agent <id>`
+  zero skill view my-skill`
 ).action(
-  withErrorHandler(async (name, options) => {
-    const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
-    if (!agentId) {
-      throw new Error(
-        "Agent ID required: use --agent <id> or set $ZERO_AGENT_ID"
-      );
-    }
-    const skill = await getAgentSkill(agentId, name);
+  withErrorHandler(async (name) => {
+    const skill = await getSkill(name);
     console.log(chalk50.bold(skill.name));
     if (skill.displayName) console.log(chalk50.dim(skill.displayName));
     console.log();
@@ -3726,21 +3735,14 @@ Examples:
 // src/commands/zero/skill/list.ts
 import { Command as Command65 } from "commander";
 import chalk51 from "chalk";
-var listCommand10 = new Command65().name("list").alias("ls").description("List custom skills for a zero agent").option("--agent <id>", "Agent ID (defaults to $ZERO_AGENT_ID)").addHelpText(
+var listCommand10 = new Command65().name("list").alias("ls").description("List custom skills in the organization").addHelpText(
   "after",
   `
 Examples:
-  zero skill list
-  zero skill list --agent <id>`
+  zero skill list`
 ).action(
-  withErrorHandler(async (options) => {
-    const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
-    if (!agentId) {
-      throw new Error(
-        "Agent ID required: use --agent <id> or set $ZERO_AGENT_ID"
-      );
-    }
-    const skills = await listAgentSkills(agentId);
+  withErrorHandler(async () => {
+    const skills = await listSkills();
     if (skills.length === 0) {
       console.log(chalk51.dim("No custom skills found"));
       console.log(
@@ -3773,58 +3775,52 @@ Examples:
 // src/commands/zero/skill/delete.ts
 import { Command as Command66 } from "commander";
 import chalk52 from "chalk";
-var deleteCommand6 = new Command66().name("delete").alias("rm").description("Delete a custom skill").argument("<name>", "Skill name").option("--agent <id>", "Agent ID (defaults to $ZERO_AGENT_ID)").option("-y, --yes", "Skip confirmation prompt").addHelpText(
+var deleteCommand6 = new Command66().name("delete").alias("rm").description("Delete a custom skill from the organization").argument("<name>", "Skill name").option("-y, --yes", "Skip confirmation prompt").addHelpText(
   "after",
   `
 Examples:
   zero skill delete my-skill
   zero skill delete my-skill -y
-  zero skill delete my-skill --agent <id>
 
 Notes:
+  - This removes the skill from the organization and unbinds it from all agents
   - Use -y to skip confirmation in non-interactive mode`
 ).action(
-  withErrorHandler(
-    async (name, options) => {
-      const agentId = options.agent ?? process.env.ZERO_AGENT_ID;
-      if (!agentId) {
-        throw new Error(
-          "Agent ID required: use --agent <id> or set $ZERO_AGENT_ID"
-        );
+  withErrorHandler(async (name, options) => {
+    await getSkill(name);
+    if (!options.yes) {
+      if (!isInteractive()) {
+        throw new Error("--yes flag is required in non-interactive mode");
       }
-      await getAgentSkill(agentId, name);
-      if (!options.yes) {
-        if (!isInteractive()) {
-          throw new Error("--yes flag is required in non-interactive mode");
-        }
-        const confirmed = await promptConfirm(
-          `Delete skill '${name}'?`,
-          false
-        );
-        if (!confirmed) {
-          console.log(chalk52.dim("Cancelled"));
-          return;
-        }
+      const confirmed = await promptConfirm(
+        `Delete skill '${name}'? This will unbind it from all agents.`,
+        false
+      );
+      if (!confirmed) {
+        console.log(chalk52.dim("Cancelled"));
+        return;
       }
-      await deleteAgentSkill(agentId, name);
-      console.log(chalk52.green(`\u2713 Skill "${name}" deleted`));
     }
-  )
+    await deleteSkill(name);
+    console.log(chalk52.green(`\u2713 Skill "${name}" deleted`));
+  })
 );
 
 // src/commands/zero/skill/index.ts
-var zeroSkillCommand = new Command67("skill").description("Manage custom skills for zero agents").addCommand(createCommand2).addCommand(editCommand2).addCommand(viewCommand2).addCommand(listCommand10).addCommand(deleteCommand6).addHelpText(
+var zeroSkillCommand = new Command67("skill").description("Manage custom skills").addCommand(createCommand2).addCommand(editCommand2).addCommand(viewCommand2).addCommand(listCommand10).addCommand(deleteCommand6).addHelpText(
   "after",
   `
 Examples:
   Create from directory:   zero skill create my-skill --dir ./skills/my-skill/
-  List agent's skills:     zero skill list --agent <id>
+  List all skills:         zero skill list
   View skill content:      zero skill view my-skill
   Update skill content:    zero skill edit my-skill --dir ./skills/my-skill/
   Delete a skill:          zero skill delete my-skill -y
 
-Notes:
-  Agent ID comes from --agent flag or $ZERO_AGENT_ID environment variable`
+Skill Binding:
+  Bind to agent:           zero agent edit <id> --add-skill my-skill
+  Unbind from agent:       zero agent edit <id> --remove-skill my-skill
+  Replace all skills:      zero agent edit <id> --skills a,b,c`
 );
 
 // src/zero.ts
@@ -3870,7 +3866,7 @@ function registerZeroCommands(prog, commands) {
 var program = new Command68();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.90.1").addHelpText(
+).version("9.90.3").addHelpText(
   "after",
   `
 Examples: