agenthub-multiagent-mcp 1.32.0 → 1.33.0

package/dist/employee.js

@@ -0,0 +1,128 @@
+/**
+ * add-ai-agent-employees §1 — the employee layer for the dispatcher.
+ *
+ * An "employee" is an agent bound to a versioned Charter and a seniority tier
+ * (server-side, Phase 0). The dispatcher (daemon) loads this context once at
+ * startup and, for every work trigger, builds a charter-grounded SHIFT PROMPT:
+ * the worker session perceives → plans → acts → reports, with tier-appropriate
+ * supervision rules embedded.
+ *
+ * Enforcement layering (be honest about which layer does what):
+ *  - capability invokes: HARD-gated server-side by the Phase-0 policy
+ *    chokepoint (gate → plan-review 202; deny → 403) regardless of anything
+ *    the worker session does locally.
+ *  - git-level irreversible actions (merge, push to main): enforced by repo
+ *    branch protection + the shift prompt's standing rules; probationary/
+ *    junior workers must submit_plan and wait for approval.
+ */
+/**
+ * fetchEmployee loads the employee + charter for an agent. Returns null when
+ * the agent is not an employee (404), the feature is off (503), or the server
+ * is unreachable — the daemon then behaves exactly as it does today.
+ */
+export async function fetchEmployee(apiUrl, apiKey, agentId) {
+    try {
+        const resp = await fetch(`${apiUrl}/api/employees/${encodeURIComponent(agentId)}`, { headers: { "X-API-Key": apiKey } });
+        if (!resp.ok)
+            return null; // 404 not_employee | 503 employees_disabled
+        const data = (await resp.json());
+        if (!data.employee || !data.charter || data.employee.status !== "active") {
+            return null;
+        }
+        return {
+            agentId,
+            tier: data.employee.tier ?? "probationary",
+            status: data.employee.status,
+            model: data.employee.model ?? "",
+            charter: data.charter,
+        };
+    }
+    catch {
+        return null; // network failure → plain-daemon behaviour, never crash startup
+    }
+}
+/** Tiers whose irreversible actions always require an approved plan-review. */
+const SUPERVISED_TIERS = new Set(["probationary", "junior"]);
+/**
+ * buildShiftPrompt renders the charter-grounded worker prompt for one trigger.
+ * Structure: identity+charter → standing rules (tier-dependent) → the trigger
+ * → the shift loop contract (perceive/plan/act/report).
+ */
+export function buildShiftPrompt(ctx, trigger) {
+    const c = ctx.charter;
+    const supervised = SUPERVISED_TIERS.has(ctx.tier);
+    const charterBlock = [
+        `You are "${ctx.agentId}", an AI employee on AgentHub.`,
+        `Role: ${c.role_name} (charter v${c.version}, tier: ${ctx.tier})`,
+        c.mission ? `Mission: ${c.mission}` : "",
+        c.responsibilities ? `Responsibilities: ${c.responsibilities}` : "",
+        c.scope ? `Scope of authority: ${c.scope}` : "",
+        c.success_metrics ? `Success metrics: ${c.success_metrics}` : "",
+    ].filter(Boolean).join("\n");
+    const rules = [
+        "STANDING RULES (non-negotiable):",
+        "- Work ONLY within your charter's scope. If a step falls outside it, stop and escalate via send_message to your owner instead of improvising.",
+        "- All code work happens on a feature branch. NEVER merge, never push to main/master.",
+        supervised
+            ? "- Your tier is supervised: before ANY irreversible action (opening a PR counts as the end of your shift; merging, deploying, sending outbound, or spending are FORBIDDEN), call submit_plan describing the action and wait for approval via check_review_status. If denied, stop and report."
+            : "- Gate high-risk irreversible actions through submit_plan; low-risk actions within your charter may proceed.",
+        "- If a capability invoke returns 202 pending_review, that is the policy gate: poll check_review_status; re-invoke only after approval. A 403 policy_denied is final — escalate, do not retry.",
+    ].join("\n");
+    const triggerBlock = trigger.kind === "task"
+        ? [
+            "TRIGGER — assigned task:",
+            `Task ID: ${trigger.taskId ?? ""}`,
+            `Task: ${trigger.task ?? ""}`,
+            `Assigned by: ${trigger.assignedBy ?? ""}`,
+            `Priority: ${trigger.priority ?? "normal"}`,
+        ].join("\n")
+        : [
+            "TRIGGER — message:",
+            `From: ${trigger.fromAgent ?? ""}`,
+            `Subject: ${trigger.subject ?? ""}`,
+            `Body:\n${trigger.body ?? ""}`,
+            trigger.messageId ? `Reply with the reply tool to message_id="${trigger.messageId}".` : "",
+        ].filter(Boolean).join("\n");
+    const loop = [
+        "SHIFT LOOP:",
+        "1. PERCEIVE — check_inbox (unread_only=true); if this is a task, accept_task with the task id; read any context the task references.",
+        "2. PLAN — outline the steps; for supervised tiers submit_plan before irreversible steps.",
+        "3. ACT — do the work. For tasks: report_progress at meaningful milestones (25/50/75).",
+        "4. REPORT — when done (or blocked): agent_complete_task (or agent_report_blocked with the blocker), then close the shift with session_close_report summarising what shipped and what's next.",
+    ].join("\n");
+    return [charterBlock, rules, triggerBlock, loop].join("\n\n");
+}
+/**
+ * Engineering IC charter template — the P1 first hire. Used as the default by
+ * employee_hire when role_name is "Engineering IC" and no guardrails given.
+ */
+export const CHARTER_TEMPLATES = {
+    "Platform Ops": {
+        role_name: "Platform Ops",
+        mission: "Monitor platform health, post digests and alerts, keep agents unblocked.",
+        responsibilities: "Watch deploys/CI/stalls; triage incidents; escalate real risk; run periodic reviews of reports.",
+        scope: "Read/alert autonomously; deployment-class actions gate.",
+        success_metrics: "Stall detection latency; escalation accuracy; rollback rate.",
+        guardrails: { allowed_capabilities: ["*"], break_glass: ["prod_deploy", "deploy"] },
+    },
+    Coordinator: {
+        role_name: "Coordinator",
+        mission: "Synthesize status, route work between agents, keep the org brain current.",
+        responsibilities: "Standup synthesis; task routing; brain hygiene; onboarding context for new agents.",
+        scope: "Read everything; outbound communication gates.",
+        success_metrics: "Routing accuracy; escalation accuracy; brain freshness.",
+        guardrails: { allowed_capabilities: ["*"], irreversible: ["send_email", "broadcast"], break_glass: ["prod_deploy", "deploy"] },
+    },
+};
+export const ENG_IC_CHARTER = {
+    role_name: "Engineering IC",
+    mission: "Pick up assigned tickets, implement them end-to-end on feature branches with tests, open PRs, and respond to review feedback.",
+    responsibilities: "Claim assigned tasks; implement with TDD; keep commits small; open a PR per task; report progress and close each shift with a session report.",
+    scope: "Code changes on feature branches in the bound project's repositories. No merges, no deploys, no outbound communication beyond AgentHub messages.",
+    success_metrics: "Task completion rate; review approval ratio; rollback rate; escalation accuracy.",
+    guardrails: {
+        allowed_capabilities: ["*"],
+        break_glass: ["prod_deploy", "deploy"],
+    },
+};
+//# sourceMappingURL=employee.js.map

package/dist/employee.js.map

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

package/dist/employee.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=employee.test.d.ts.map

package/dist/employee.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"employee.test.d.ts","sourceRoot":"","sources":["../src/employee.test.ts"],"names":[],"mappings":""}

package/dist/employee.test.js

@@ -0,0 +1,116 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { fetchEmployee, buildShiftPrompt, ENG_IC_CHARTER, } from "./employee.js";
+// add-ai-agent-employees §1 — the employee layer must (a) never break the
+// plain daemon when the agent isn't an employee / the feature is off, and
+// (b) render shift prompts that carry the charter + tier supervision rules.
+function ctx(tier) {
+    return {
+        agentId: "eng-ic-1",
+        tier,
+        status: "active",
+        charter: {
+            id: "ch-1",
+            role_name: "Engineering IC",
+            version: 2,
+            mission: "Ship tickets end-to-end.",
+            scope: "Feature branches only.",
+            guardrails: { allowed_capabilities: ["*"] },
+        },
+    };
+}
+describe("fetchEmployee", () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = vi.fn();
+        vi.stubGlobal("fetch", fetchMock);
+    });
+    afterEach(() => vi.unstubAllGlobals());
+    it("returns context for an active employee (incl. model pin)", async () => {
+        fetchMock.mockResolvedValue(new Response(JSON.stringify({
+            employee: { tier: "junior", status: "active", model: "claude-haiku-4-5" },
+            charter: { id: "c1", role_name: "Engineering IC", version: 1, guardrails: {} },
+        }), { status: 200 }));
+        const got = await fetchEmployee("https://hub.test", "key", "eng-ic-1");
+        expect(got?.tier).toBe("junior");
+        expect(got?.model).toBe("claude-haiku-4-5");
+        expect(got?.charter.role_name).toBe("Engineering IC");
+        // Auth header present
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toContain("/api/employees/eng-ic-1");
+        expect(init.headers).toMatchObject({ "X-API-Key": "key" });
+    });
+    it.each([404, 503])("returns null on HTTP %d (non-employee / feature off)", async (status) => {
+        fetchMock.mockResolvedValue(new Response("{}", { status }));
+        expect(await fetchEmployee("https://hub.test", "key", "a")).toBeNull();
+    });
+    it("returns null for a suspended employee", async () => {
+        fetchMock.mockResolvedValue(new Response(JSON.stringify({
+            employee: { tier: "junior", status: "suspended" },
+            charter: { id: "c1", role_name: "R", version: 1, guardrails: {} },
+        }), { status: 200 }));
+        expect(await fetchEmployee("https://hub.test", "key", "a")).toBeNull();
+    });
+    it("returns null on network failure (daemon must not crash)", async () => {
+        fetchMock.mockRejectedValue(new Error("ECONNREFUSED"));
+        expect(await fetchEmployee("https://hub.test", "key", "a")).toBeNull();
+    });
+});
+describe("buildShiftPrompt", () => {
+    it("embeds charter identity, role, version, and tier", () => {
+        const p = buildShiftPrompt(ctx("probationary"), { kind: "task", taskId: "t1", task: "Fix bug" });
+        expect(p).toContain('You are "eng-ic-1"');
+        expect(p).toContain("Engineering IC (charter v2, tier: probationary)");
+        expect(p).toContain("Mission: Ship tickets end-to-end.");
+        expect(p).toContain("Scope of authority: Feature branches only.");
+    });
+    it("supervised tiers must submit_plan before irreversible actions", () => {
+        for (const tier of ["probationary", "junior"]) {
+            const p = buildShiftPrompt(ctx(tier), { kind: "task", taskId: "t1", task: "X" });
+            expect(p).toContain("Your tier is supervised");
+            expect(p).toContain("submit_plan");
+            expect(p).toContain("check_review_status");
+        }
+    });
+    it("senior/lead get the lighter gate rule, not the supervised one", () => {
+        for (const tier of ["senior", "lead"]) {
+            const p = buildShiftPrompt(ctx(tier), { kind: "task", taskId: "t1", task: "X" });
+            expect(p).not.toContain("Your tier is supervised");
+            expect(p).toContain("Gate high-risk irreversible actions");
+        }
+    });
+    it("never allows merging or pushing to main at any tier", () => {
+        for (const tier of ["probationary", "junior", "senior", "lead"]) {
+            const p = buildShiftPrompt(ctx(tier), { kind: "task", taskId: "t1", task: "X" });
+            expect(p).toContain("NEVER merge, never push to main/master");
+        }
+    });
+    it("task triggers carry id/title/assigner; the loop closes with a session report", () => {
+        const p = buildShiftPrompt(ctx("junior"), {
+            kind: "task", taskId: "t42", task: "Add endpoint", assignedBy: "sumit", priority: "high",
+        });
+        expect(p).toContain("Task ID: t42");
+        expect(p).toContain("Add endpoint");
+        expect(p).toContain("Assigned by: sumit");
+        expect(p).toContain("session_close_report");
+        expect(p).toContain("report_progress");
+    });
+    it("message triggers include reply instructions with the message id", () => {
+        const p = buildShiftPrompt(ctx("junior"), {
+            kind: "message", messageId: "m7", fromAgent: "ops", subject: "S", body: "B",
+        });
+        expect(p).toContain('message_id="m7"');
+        expect(p).toContain("From: ops");
+    });
+    it("explains the 202 pending_review policy-gate protocol", () => {
+        const p = buildShiftPrompt(ctx("junior"), { kind: "task", taskId: "t1", task: "X" });
+        expect(p).toContain("202 pending_review");
+        expect(p).toContain("403 policy_denied");
+    });
+});
+describe("ENG_IC_CHARTER template", () => {
+    it("declares deploys as break-glass and feature-branch-only scope", () => {
+        expect(ENG_IC_CHARTER.guardrails.break_glass).toContain("prod_deploy");
+        expect(ENG_IC_CHARTER.scope).toContain("feature branches");
+    });
+});
+//# sourceMappingURL=employee.test.js.map

package/dist/employee.test.js.map

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

package/dist/run-claude.sh

@@ -1,21 +1,42 @@
-#!/bin/bash
-# Wrapper script for daemon to invoke claude -p with prompt from file
-# Usage: run-claude.sh <prompt-file> <mcp-config-file> <max-turns>
-
-PROMPT_FILE="$1"
-MCP_CONFIG="$2"
-MAX_TURNS="${3:-1}"
-
-if [ ! -f "$PROMPT_FILE" ]; then
-  echo "Error: prompt file not found: $PROMPT_FILE" >&2
-  exit 1
-fi
-
-PROMPT="$(cat "$PROMPT_FILE")"
-
-claude -p "$PROMPT" \
-  --dangerously-skip-permissions \
-  --max-turns "$MAX_TURNS" \
-  --output-format text \
-  --mcp-config "$MCP_CONFIG" \
-  --strict-mcp-config
+#!/bin/bash
+# Wrapper script for daemon/worker to invoke claude -p with prompt from file
+# Usage: run-claude.sh <prompt-file> <mcp-config-file> <max-turns> [settings-file] [channels]
+
+PROMPT_FILE="$1"
+MCP_CONFIG="$2"
+MAX_TURNS="${3:-3}"
+SETTINGS_FILE="$4"
+CHANNELS="$5"
+MODEL="$6"
+
+if [ ! -f "$PROMPT_FILE" ]; then
+  echo "Error: prompt file not found: $PROMPT_FILE" >&2
+  exit 1
+fi
+
+PROMPT="$(cat "$PROMPT_FILE")"
+
+# Build optional flags
+EXTRA_FLAGS=""
+if [ -n "$SETTINGS_FILE" ] && [ -f "$SETTINGS_FILE" ]; then
+  EXTRA_FLAGS="$EXTRA_FLAGS --settings $SETTINGS_FILE"
+fi
+if [ -n "$CHANNELS" ]; then
+  EXTRA_FLAGS="$EXTRA_FLAGS --dangerously-load-development-channels $CHANNELS"
+fi
+if [ -n "$MODEL" ]; then
+  EXTRA_FLAGS="$EXTRA_FLAGS --model $MODEL"
+fi
+
+# Run claude, filter out "Reached max turns" error from stdout
+OUTPUT=$(claude -p "$PROMPT" \
+  --dangerously-skip-permissions \
+  --max-turns "$MAX_TURNS" \
+  --output-format text \
+  --mcp-config "$MCP_CONFIG" \
+  $EXTRA_FLAGS 2>/dev/null)
+
+# Strip "Error: Reached max turns" line if present
+echo "$OUTPUT" | grep -v "^Error: Reached max turns"
+
+exit 0

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;AACrG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA6B/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,cAAc,EAAE,MAAM,WAAW,CAAC;CACnC;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;AAwJD,wBAAgB,aAAa,IAAI,IAAI,EAAE,CA8xEtC;AAED,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,CAkqElB"}
+{"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;AACrG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA8B/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,cAAc,EAAE,MAAM,WAAW,CAAC;CACnC;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;AAwJD,wBAAgB,aAAa,IAAI,IAAI,EAAE,CAs0EtC;AAED,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,CAitElB"}

package/dist/tools/index.js

@@ -9,6 +9,7 @@ import { getBrain } from "../brain/backend.js";
 import open from "open";
 import { registerOpenSpecVizTools, handleOpenSpecVizToolCall } from "./openspec-viz/index.js";
 import { getServerTime, useTimeInjection } from "../lib/server-time.js";
+import { ENG_IC_CHARTER } from "../employee.js";
 /**
  * Background sync: pushes local context to server after every save.
  * Non-blocking — logs errors but never throws.
@@ -1178,6 +1179,42 @@ export function registerTools() {
                 required: ["task_id", "progress"],
             },
         },
+        // AI employees (add-ai-agent-employees §1)
+        {
+            name: "employee_hire",
+            description: "Hire an agent as an AI employee: creates a versioned Charter (role, mission, guardrails) and binds the agent at tier probationary. role_name 'Engineering IC' with no guardrails uses the built-in Eng-IC template. Requires AGENTHUB_EMPLOYEES_ENABLED on the server.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    agent_id: { type: "string", description: "Agent to hire" },
+                    role_name: { type: "string", description: "Role title, e.g. 'Engineering IC'" },
+                    mission: { type: "string", description: "One-paragraph mission" },
+                    responsibilities: { type: "string", description: "What the role does day-to-day" },
+                    scope: { type: "string", description: "Scope of authority" },
+                    success_metrics: { type: "string", description: "How performance is judged" },
+                    guardrails: {
+                        type: "object",
+                        description: "Policy guardrails: {allowed_capabilities:[...]/['*'], irreversible:[], low_risk:[], break_glass:[]}",
+                    },
+                    tier: {
+                        type: "string",
+                        description: "Starting tier (default probationary)",
+                        enum: ["probationary", "junior", "senior", "lead"],
+                    },
+                },
+                required: ["agent_id", "role_name"],
+            },
+        },
+        {
+            name: "employee_get",
+            description: "Get an agent's employee record + charter (role, tier, guardrails). 404 when the agent is not an employee; 503 when employees are disabled.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    agent_id: { type: "string", description: "Agent to look up (defaults to self)" },
+                },
+            },
+        },
         // Ticket creation tools
         {
             name: "create_epic",
@@ -3303,6 +3340,53 @@ export async function handleToolCall(name, args, client, context) {
                 ],
             };
         }
+        // AI employees (add-ai-agent-employees §1)
+        case "employee_hire": {
+            if (!agentId)
+                throw new Error("Not registered. Call agent_register first.");
+            const roleName = args.role_name;
+            let req = {
+                agent_id: args.agent_id,
+                role_name: roleName,
+                mission: args.mission,
+                responsibilities: args.responsibilities,
+                scope: args.scope,
+                success_metrics: args.success_metrics,
+                guardrails: args.guardrails,
+                tier: args.tier,
+            };
+            // No guardrails for the canonical first hire → built-in Eng-IC template.
+            if (!args.guardrails && roleName === ENG_IC_CHARTER.role_name) {
+                req = {
+                    ...req,
+                    mission: req.mission ?? ENG_IC_CHARTER.mission,
+                    responsibilities: req.responsibilities ?? ENG_IC_CHARTER.responsibilities,
+                    scope: req.scope ?? ENG_IC_CHARTER.scope,
+                    success_metrics: req.success_metrics ?? ENG_IC_CHARTER.success_metrics,
+                    guardrails: ENG_IC_CHARTER.guardrails,
+                };
+            }
+            const result = await client.hireEmployee(req);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Hired ${req.agent_id} as "${roleName}":\n${JSON.stringify(result, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        case "employee_get": {
+            const target = args.agent_id || agentId;
+            if (!target)
+                throw new Error("Not registered. Call agent_register first.");
+            const result = await client.getEmployee(target);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
         // Ticket creation tools
         case "create_epic": {
             if (!agentId)