agenthub-multiagent-mcp 1.75.0 → 1.76.0

package/dist/tools/employeeTraining.test.js

@@ -0,0 +1,190 @@
+/**
+ * Employee training MCP tools (add-employee-training-loops §1.3 manual trigger,
+ * §2–§3). Handlers against a mocked ApiClient for result/refusal shaping, and
+ * the real ApiClient with fetch stubbed for the wire contract.
+ */
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { EMPLOYEE_TRAINING_TOOLS, handleEmployeeTrainingToolCall, isEmployeeTrainingTool, registerEmployeeTrainingTools, } from "./employeeTraining.js";
+import { ApiClient } from "../client.js";
+function mockClient(overrides = {}) {
+    return {
+        getTrainingObservations: vi.fn(),
+        runTrainingPass: vi.fn(),
+        listTrainingRecords: vi.fn(),
+        getTrainingCurriculum: vi.fn(),
+        ...overrides,
+    };
+}
+const ok = (data, status = 200) => ({ ok: true, status, data });
+const fail = (status, error, message) => ({
+    ok: false,
+    status,
+    error,
+    message,
+    data: { error, message },
+});
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+});
+describe("employee training tool registration", () => {
+    it("registers the four training tools", () => {
+        expect(registerEmployeeTrainingTools().map((t) => t.name)).toEqual([...EMPLOYEE_TRAINING_TOOLS]);
+        expect(EMPLOYEE_TRAINING_TOOLS).toEqual([
+            "employee_training_observe",
+            "employee_training_run",
+            "employee_training_history",
+            "employee_training_curriculum",
+        ]);
+        expect(isEmployeeTrainingTool("employee_training_run")).toBe(true);
+        expect(isEmployeeTrainingTool("employee_get")).toBe(false);
+    });
+    it("offers only the charter fields the server accepts", () => {
+        const run = registerEmployeeTrainingTools().find((t) => t.name === "employee_training_run");
+        const edits = run.inputSchema.properties.charter_edits;
+        expect(edits.items.properties.field.enum).toEqual(["mission", "responsibilities", "scope", "success_metrics"]);
+        expect(run.inputSchema.required).toEqual(["agent_id"]);
+    });
+    it("says a charter edit is only a proposal", () => {
+        const run = registerEmployeeTrainingTools().find((t) => t.name === "employee_training_run");
+        expect(run.description).toMatch(/person/i);
+        expect(run.description).toMatch(/not applied|never applied|nothing changes/i);
+    });
+});
+describe("employee_training_run", () => {
+    it("passes lessons, edits and spend through and summarises the record", async () => {
+        const runTrainingPass = vi.fn().mockResolvedValue(ok({
+            record: {
+                id: "rec-1",
+                status: "completed",
+                lessons: [{ text: "a", duplicate: false }, { text: "b", duplicate: true }],
+                proposed_charter_edits: [{ field: "scope", review_id: "rev-1", state: "pending" }],
+                budget_spent: 900,
+                budget_limit: 50000,
+            },
+            scorecard: { score: 72, ladder: { decision: "hold" } },
+        }));
+        const client = mockClient({ runTrainingPass });
+        const out = (await handleEmployeeTrainingToolCall("employee_training_run", {
+            agent_id: "eng-ic-test",
+            lessons: ["a", "b"],
+            charter_edits: [{ field: "scope", after: "x", rationale: "y" }],
+            tokens_spent: 900,
+            window_days: 7,
+        }, client));
+        expect(runTrainingPass).toHaveBeenCalledWith("eng-ic-test", {
+            lessons: ["a", "b"],
+            charter_edits: [{ field: "scope", after: "x", rationale: "y" }],
+            tokens_spent: 900,
+            window_days: 7,
+        });
+        expect(out.ok).toBe(true);
+        expect(out.record_id).toBe("rec-1");
+        expect(out.message).toContain("1 new lesson");
+        expect(out.message).toContain("1 already known");
+        expect(out.message).toContain("rev-1");
+        expect(out.message).toMatch(/person/i);
+    });
+    it("passes practice and skills through and summarises them", async () => {
+        const runTrainingPass = vi.fn().mockResolvedValue(ok({
+            record: {
+                id: "rec-3",
+                status: "partial",
+                stop_reason: "budget_exhausted",
+                lessons: [],
+                proposed_charter_edits: [],
+                practice_scores: [
+                    { item_id: "cur-blocked", state: "graded", passed: true },
+                    { item_id: "cur-planning", state: "assigned" },
+                    { item_id: "cur-guardrails", state: "skipped_budget" },
+                ],
+                skills_added: [
+                    { name: "brag", state: "install_sent" },
+                    { name: "cybersecurity", state: "pending_approval", review_id: "rev-s" },
+                ],
+            },
+            scorecard: {},
+        }));
+        const client = mockClient({ runTrainingPass });
+        const practice = { item_ids: ["cur-blocked", "cur-planning", "cur-guardrails"] };
+        const skills = [{ pack: "brag" }, { pack: "cybersecurity", gap: "secrets" }];
+        const out = (await handleEmployeeTrainingToolCall("employee_training_run", { agent_id: "e", practice, skills }, client));
+        expect(runTrainingPass).toHaveBeenCalledWith("e", { practice, skills });
+        expect(out.message).toContain("1 graded (1 passed), 1 sent");
+        expect(out.message).toContain("1 not sent (budget)");
+        expect(out.message).toContain("rev-s");
+        expect(out.message).toMatch(/person/i);
+    });
+    it("describes the governed skill install", () => {
+        const run = registerEmployeeTrainingTools().find((t) => t.name === "employee_training_run");
+        const skills = run.inputSchema.properties.skills;
+        expect(skills.description).toMatch(/skill-pack:<name>/);
+        expect(skills.description).toMatch(/No agent can approve/);
+    });
+    it("reports a partial pass as stopped by the budget", async () => {
+        const client = mockClient({
+            runTrainingPass: vi.fn().mockResolvedValue(ok({
+                record: { id: "rec-2", status: "partial", stop_reason: "budget_exhausted", lessons: [], proposed_charter_edits: [] },
+                scorecard: {},
+            })),
+        });
+        const out = (await handleEmployeeTrainingToolCall("employee_training_run", { agent_id: "e" }, client));
+        expect(out.status).toBe("partial");
+        expect(out.message).toMatch(/budget/i);
+    });
+    it.each([
+        ["training_disabled", 503, /AGENTHUB_EMPLOYEE_TRAINING_ENABLED/],
+        ["self_training", 403, /cannot train itself/i],
+        ["trainer_required", 403, /trainer/i],
+        ["not_employee", 404, /not an employee/i],
+    ])("turns %s into an actionable refusal", async (code, status, pattern) => {
+        const client = mockClient({ runTrainingPass: vi.fn().mockResolvedValue(fail(status, code)) });
+        const out = (await handleEmployeeTrainingToolCall("employee_training_run", { agent_id: "e" }, client));
+        expect(out.ok).toBe(false);
+        expect(out.error).toBe(code);
+        expect(out.message).toMatch(pattern);
+    });
+    it("requires agent_id", async () => {
+        await expect(handleEmployeeTrainingToolCall("employee_training_run", {}, mockClient())).rejects.toThrow(/agent_id/);
+    });
+});
+describe("observe and history", () => {
+    it("returns observations unchanged", async () => {
+        const obs = { agent_id: "e", shifts: [{ message_id: "m1" }] };
+        const client = mockClient({ getTrainingObservations: vi.fn().mockResolvedValue(ok(obs)) });
+        const out = (await handleEmployeeTrainingToolCall("employee_training_observe", { agent_id: "e", window_days: 3 }, client));
+        expect(client.getTrainingObservations).toHaveBeenCalledWith("e", 3);
+        expect(out.ok).toBe(true);
+        expect(out.observations).toEqual(obs);
+    });
+    it("lists history", async () => {
+        const client = mockClient({ listTrainingRecords: vi.fn().mockResolvedValue(ok({ records: [{ id: "r" }], total: 1 })) });
+        const out = (await handleEmployeeTrainingToolCall("employee_training_history", { agent_id: "e" }, client));
+        expect(client.listTrainingRecords).toHaveBeenCalledWith("e", undefined);
+        expect(out.records).toEqual([{ id: "r" }]);
+    });
+});
+describe("wire contract", () => {
+    it("hits the employee training routes", async () => {
+        const fetchSpy = vi.fn(async () => ({
+            ok: true,
+            status: 200,
+            text: async () => JSON.stringify({ record: { id: "r" } }),
+        }));
+        vi.stubGlobal("fetch", fetchSpy);
+        const client = new ApiClient("https://hub.example/api", "key");
+        await client.runTrainingPass("eng ic", { lessons: ["x"] });
+        await client.getTrainingObservations("eng ic", 5);
+        await client.listTrainingRecords("eng ic", 10);
+        await client.getTrainingCurriculum("eng ic", 2);
+        const calls = fetchSpy.mock.calls;
+        expect(calls[0][0]).toBe("https://hub.example/api/employees/eng%20ic/training");
+        expect(calls[0][1].method).toBe("POST");
+        expect(JSON.parse(String(calls[0][1].body))).toEqual({ lessons: ["x"] });
+        expect(calls[1][0]).toBe("https://hub.example/api/employees/eng%20ic/training/observations?window_days=5");
+        expect(calls[1][1].method).toBe("GET");
+        expect(calls[2][0]).toBe("https://hub.example/api/employees/eng%20ic/training?limit=10");
+        expect(calls[3][0]).toBe("https://hub.example/api/employees/eng%20ic/training/curriculum?tickets=2");
+    });
+});
+//# sourceMappingURL=employeeTraining.test.js.map

package/dist/tools/employeeTraining.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"employeeTraining.test.js","sourceRoot":"","sources":["../../src/tools/employeeTraining.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAqD,MAAM,cAAc,CAAC;AAOrG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA4G/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,cAAc,EAAE,MAAM,WAAW,CAAC;IAClC,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,WAAW,CAAC;IACpC,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE;QAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,KAAK,IAAI,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyLD,wBAAgB,aAAa,IAAI,IAAI,EAAE,CA47FtC;AAqCD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAwuFlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAqD,MAAM,cAAc,CAAC;AAOrG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAkH/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,cAAc,EAAE,MAAM,WAAW,CAAC;IAClC,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,WAAW,CAAC;IACpC,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE;QAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,KAAK,IAAI,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyLD,wBAAgB,aAAa,IAAI,IAAI,EAAE,CAohGtC;AAqCD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAwyFlB"}

package/dist/tools/index.js

@@ -12,8 +12,10 @@ import open from "open";
 import { registerOpenSpecVizTools, handleOpenSpecVizToolCall } from "./openspec-viz/index.js";
 import { syncTaskGroups, describeTaskSync } from "./openspec-viz/taskSync.js";
 import { registerIntakeRequestTools, handleIntakeRequestToolCall, isIntakeRequestTool, } from "./intakeRequests.js";
+import { handleEmployeeTrainingToolCall, isEmployeeTrainingTool, registerEmployeeTrainingTools, } from "./employeeTraining.js";
 import { registerSessionControlTools, handleSessionControlToolCall, isSessionControlTool, } from "./sessionControl.js";
 import { registerGoshtiReadTools, handleGoshtiReadToolCall, isGoshtiReadTool, } from "./goshtiRead.js";
+import { registerRunTools, handleRunToolCall, isRunTool } from "./runs.js";
 import { installPackFromArchive } from "../skillPackInstaller.js";
 import { getServerTime, useTimeInjection } from "../lib/server-time.js";
 import { getPendingItems } from "../lib/pending-items.js";
@@ -2216,8 +2218,11 @@ export function registerTools() {
         ...registerSessionControlTools(),
         // Intake requests: file, triage, scope check (add-intake-requests §6.1)
         ...registerIntakeRequestTools(),
+        ...registerEmployeeTrainingTools(),
         // Reading Goshti as the agent's owner (add-agent-goshti-read §3.1)
         ...registerGoshtiReadTools(),
+        // Orchestrated runs for the dashboard Run view (add-live-animated-views §1.8)
+        ...registerRunTools(),
         // OpenSpec Visualizer tools
         ...registerOpenSpecVizTools(),
         // Intel layer tools (§2.5 — read-only MCP surface for intel.search + source catalog)
@@ -2373,7 +2378,7 @@ export function registerTools() {
         },
         {
             name: "brain_write_knowledge",
-            description: "Write an org knowledge fact (decision, convention, architecture insight, blocker, or alert) to the shared org brain.",
+            description: "Write an org knowledge fact (decision, convention, architecture insight, blocker, or alert) to the shared org brain. The result carries `check`: `created` for a new row (with its `id`), or `deduped` when an identical active fact already exists — then `canonical_id` names the existing row if it is your organization's, and nothing is named if the match belongs to another organization. A refusal (missing fact, unknown category) is an error.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -2827,6 +2832,86 @@ export function registerTools() {
                 required: ["project_id"],
             },
         },
+        // ── Scheduled Reporting (add-scheduled-reporting §6.2) ──
+        // Report schedules are their own rows — create_cron_job cannot express a
+        // report (its schema has no action field). Every tool answers
+        // 503 reporting_disabled while AGENTHUB_REPORTING_ENABLED is off.
+        {
+            name: "report_schedule_create",
+            description: "Create a recurring report schedule. The report composes the chosen sections (shipped_tickets, meeting_decisions, session_digests, roadmap, brain_knowledge, token_usage) over a lookback window, filters them for the audience, and delivers to Slack/chat channels and/or email. Members may deliver to channels and their own email; any other email recipient needs an org owner/admin (a person). Returns the schedule.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Unique name within the org" },
+                    schedule: { type: "string", description: "5-field cron, evaluated in UTC (e.g. '0 9 * * 1' = Mondays 09:00)" },
+                    sections: {
+                        type: "array",
+                        items: {
+                            type: "string",
+                            enum: ["shipped_tickets", "meeting_decisions", "session_digests", "roadmap", "brain_knowledge", "token_usage"],
+                        },
+                        description: "Sections to include (at least one)",
+                    },
+                    delivery_targets: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                kind: { type: "string", enum: ["slack", "email"] },
+                                target: { type: "string", description: "Channel (e.g. #leadership) or email address" },
+                            },
+                            required: ["kind", "target"],
+                        },
+                        description: "Where to deliver (at least one)",
+                    },
+                    project_id: { type: "string", description: "Optional project (required for the roadmap section)" },
+                    window: { type: "string", description: "Lookback as a Go duration, default 168h, at most 2160h" },
+                    audience: {
+                        type: "string",
+                        enum: ["investor", "leadership", "customer", "product"],
+                        description: "Audience filter. Omit for internal. customer/product strip sensitive entries (finance, partners, token spend).",
+                    },
+                    enabled: { type: "boolean", description: "Default true" },
+                },
+                required: ["name", "schedule", "sections", "delivery_targets"],
+            },
+        },
+        {
+            name: "report_schedule_list",
+            description: "List your org's report schedules (enabled flag, watermark, consecutive failures).",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "report_schedule_delete",
+            description: "Delete a report schedule. Past runs stay readable only while the schedule exists.",
+            inputSchema: {
+                type: "object",
+                properties: { schedule_id: { type: "string", description: "Schedule id" } },
+                required: ["schedule_id"],
+            },
+        },
+        {
+            name: "report_run_now",
+            description: "Force a run of a schedule now, through the same code the cron uses (it delivers, and advances the watermark on delivery). Returns the run: status success|partial|failed, window, per-source availability, per-channel delivery outcome, token accounting.",
+            inputSchema: {
+                type: "object",
+                properties: { schedule_id: { type: "string", description: "Schedule id" } },
+                required: ["schedule_id"],
+            },
+        },
+        {
+            name: "report_get",
+            description: "Read report runs. With run_id: one run, its snapshot, and (format=markdown, the default) the report as delivered. With schedule_id: that schedule's run history, newest first.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    run_id: { type: "string", description: "Run id" },
+                    schedule_id: { type: "string", description: "Schedule id (lists runs)" },
+                    format: { type: "string", enum: ["json", "markdown"], description: "For run_id: include the rendered markdown (default markdown)" },
+                    limit: { type: "number", description: "For schedule_id: max runs (default 50)" },
+                },
+            },
+        },
         // ── Secrets Vault ──
         {
             name: "secret_set",
@@ -3155,6 +3240,10 @@ export async function handleToolCall(name, args, client, context) {
     if (isIntakeRequestTool(name)) {
         return handleIntakeRequestToolCall(name, args, client, () => state.loadState(context.getWorkingDir())?.project_id);
     }
+    // Employee training (add-employee-training-loops). Same module pattern.
+    if (isEmployeeTrainingTool(name)) {
+        return handleEmployeeTrainingToolCall(name, args, client);
+    }
     // Goshti reads (add-agent-goshti-read §3.1). Same module pattern. The owner's
     // grant, the per-agent switch and the fixed tool list are all the server's
     // decisions; this only shapes the call and labels the answer as other
@@ -3162,6 +3251,20 @@ export async function handleToolCall(name, args, client, context) {
     if (isGoshtiReadTool(name)) {
         return handleGoshtiReadToolCall(name, args, client);
     }
+    // Orchestrated runs (add-live-animated-views §1.8). Same module pattern. The
+    // run id run_open returns is kept in .agenthub/state, so the other run tools
+    // (and sub-agents sharing the checkout's state) default to it.
+    if (isRunTool(name)) {
+        const workingDir = context.getWorkingDir();
+        return handleRunToolCall(name, args, client, {
+            get: () => state.loadState(workingDir)?.run_id,
+            set: (runId) => {
+                const current = state.loadState(workingDir);
+                if (current)
+                    state.saveState(workingDir, { ...current, run_id: runId });
+            },
+        });
+    }
     switch (name) {
         // Registration
         case "agent_register": {
@@ -5461,6 +5564,48 @@ export async function handleToolCall(name, args, client, context) {
                 body.audience = args.audience;
             return client.post(`/projects/${projectId}/roadmap/share/slack`, body);
         }
+        // ── Scheduled Reporting (add-scheduled-reporting §6.2) ──
+        case "report_schedule_create": {
+            const body = {
+                name: args.name,
+                schedule: args.schedule,
+                sections: args.sections,
+                delivery_targets: args.delivery_targets,
+            };
+            for (const k of ["project_id", "window", "audience", "enabled"]) {
+                if (args[k] !== undefined)
+                    body[k] = args[k];
+            }
+            return client.post("/reports/schedules", body);
+        }
+        case "report_schedule_list":
+            return client.get("/reports/schedules");
+        case "report_schedule_delete": {
+            const id = args.schedule_id;
+            if (!id)
+                throw new Error("schedule_id is required");
+            return client.del(`/reports/schedules/${encodeURIComponent(id)}`);
+        }
+        case "report_run_now": {
+            const id = args.schedule_id;
+            if (!id)
+                throw new Error("schedule_id is required");
+            return client.post(`/reports/schedules/${encodeURIComponent(id)}/run`, {});
+        }
+        case "report_get": {
+            const runId = args.run_id;
+            const scheduleId = args.schedule_id;
+            if (runId) {
+                const format = (args.format || "markdown").toLowerCase();
+                const suffix = format === "markdown" ? "?format=markdown" : "";
+                return client.get(`/reports/runs/${encodeURIComponent(runId)}${suffix}`);
+            }
+            if (scheduleId) {
+                const limit = args.limit !== undefined ? `?limit=${Number(args.limit)}` : "";
+                return client.get(`/reports/schedules/${encodeURIComponent(scheduleId)}/runs${limit}`);
+            }
+            throw new Error("run_id or schedule_id is required");
+        }
         // ── Capabilities (add-agent-capabilities Phase 2 §2.3) ──
         case "capability_list": {
             if (!agentId) {