fix(cli): stop agents command from being unrecognized (#16267) (#16293)

Merged via /review-pr -> /prepare-pr -> /merge-pr.

Prepared head SHA: d7288f57fada313b3f474f28d9fc62075025ae81
Co-authored-by: yinghaosang <261132136+yinghaosang@users.noreply.github.com>
Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com>
Reviewed-by: @gumadeiras

src/cli/program/command-registry.test.ts

@@ -0,0 +1,34 @@
+import { Command } from "commander";
+import { describe, expect, it } from "vitest";
+import type { ProgramContext } from "./context.js";
+import { getCoreCliCommandNames, registerCoreCliByName } from "./command-registry.js";
+
+const stubCtx: ProgramContext = {
+  programVersion: "0.0.0-test",
+  agentChannelOptions: "web",
+};
+
+describe("command-registry", () => {
+  it("includes both agent and agents in core CLI command names", () => {
+    const names = getCoreCliCommandNames();
+    expect(names).toContain("agent");
+    expect(names).toContain("agents");
+  });
+
+  it("registerCoreCliByName resolves agents to the agent entry", async () => {
+    const program = new Command();
+    const found = await registerCoreCliByName(program, stubCtx, "agents");
+    expect(found).toBe(true);
+    const agentsCmd = program.commands.find((c) => c.name() === "agents");
+    expect(agentsCmd).toBeDefined();
+    // The registrar also installs the singular "agent" command from the same entry
+    const agentCmd = program.commands.find((c) => c.name() === "agent");
+    expect(agentCmd).toBeDefined();
+  });
+
+  it("registerCoreCliByName returns false for unknown commands", async () => {
+    const program = new Command();
+    const found = await registerCoreCliByName(program, stubCtx, "nonexistent");
+    expect(found).toBe(false);
+  });
+});

src/cli/program/command-registry.ts

@@ -78,7 +78,10 @@ const coreEntries: CoreCliEntry[] = [
     },
   },
   {
-    commands: [{ name: "agent", description: "Agent commands" }],
+    commands: [
+      { name: "agent", description: "Agent commands" },
+      { name: "agents", description: "Manage isolated agents" },
+    ],
     register: async ({ program, ctx }) => {
       const mod = await import("./register.agent.js");
       mod.registerAgentCommands(program, { agentChannelOptions: ctx.agentChannelOptions });