fix(cli): register agents command in lazy core CLI entries (#16267)

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 });