@poolzin/pool-bot 2026.3.7 → 2026.3.10

package/dist/cli/program/register.subclis.js

@@ -272,6 +272,15 @@ const entries = [
             mod.registerCompletionCli(program);
         },
     },
+    {
+        name: "telemetry",
+        description: "OpenTelemetry observability and metrics",
+        hasSubcommands: true,
+        register: async (program) => {
+            const mod = await import("../telemetry-cli/register.js");
+            mod.registerTelemetryCli(program);
+        },
+    },
 ];
 export function getSubCliEntries() {
     return entries;

package/dist/cli/swarm-cli/register.js

@@ -0,0 +1,8 @@
+import { registerSwarmCreateCommand, registerSwarmListCommand, registerSwarmStatusCommand, } from "./register.swarm-status.js";
+export function registerSwarmCommand(program) {
+    const swarm = program.command("swarm").description("Agent swarm coordination and management");
+    registerSwarmStatusCommand(swarm);
+    registerSwarmListCommand(swarm);
+    registerSwarmCreateCommand(swarm);
+    return swarm;
+}

package/dist/cli/swarm-cli/register.swarm-status.js

@@ -0,0 +1,488 @@
+import { danger } from "../../globals.js";
+import { defaultRuntime } from "../../runtime.js";
+import { colorize, isRich, theme } from "../../terminal/theme.js";
+import { renderTable } from "../../terminal/table.js";
+import { addGatewayClientOptions, callGatewayFromCli } from "../gateway-rpc.js";
+// Status icons
+const STATUS_ICONS = {
+    idle: "◌",
+    working: "▶",
+    error: "✖",
+    offline: "⊘",
+    pending: "○",
+    assigned: "◎",
+    in_progress: "◐",
+    completed: "●",
+    failed: "✖",
+    active: "●",
+    paused: "⏸",
+};
+// Format member status with icon
+function formatMemberStatus(status, rich) {
+    const icon = STATUS_ICONS[status] ?? "?";
+    if (!rich)
+        return status;
+    switch (status) {
+        case "idle":
+            return `${colorize(rich, theme.success, icon)} ${status}`;
+        case "working":
+            return `${colorize(rich, theme.warn, icon)} ${status}`;
+        case "error":
+            return `${colorize(rich, theme.error, icon)} ${status}`;
+        case "offline":
+            return `${colorize(rich, theme.muted, icon)} ${status}`;
+        default:
+            return status;
+    }
+}
+// Format task status with icon
+function formatTaskStatus(status, rich) {
+    const icon = STATUS_ICONS[status] ?? "?";
+    if (!rich)
+        return status;
+    switch (status) {
+        case "completed":
+            return `${colorize(rich, theme.success, icon)} ${status}`;
+        case "in_progress":
+            return `${colorize(rich, theme.warn, icon)} ${status}`;
+        case "failed":
+            return `${colorize(rich, theme.error, icon)} ${status}`;
+        case "assigned":
+            return `${colorize(rich, theme.accent, icon)} ${status}`;
+        default:
+            return `${colorize(rich, theme.muted, icon)} ${status}`;
+    }
+}
+// Format swarm status
+function formatSwarmStatus(status, rich) {
+    const icon = STATUS_ICONS[status] ?? "?";
+    if (!rich)
+        return status;
+    switch (status) {
+        case "active":
+            return `${colorize(rich, theme.success, icon)} ${status}`;
+        case "paused":
+            return `${colorize(rich, theme.warn, icon)} ${status}`;
+        case "completed":
+            return `${colorize(rich, theme.accentBright, icon)} ${status}`;
+        case "error":
+            return `${colorize(rich, theme.error, icon)} ${status}`;
+        default:
+            return status;
+    }
+}
+// Format relative time
+function formatRelativeTime(ms) {
+    const now = Date.now();
+    const delta = now - ms;
+    if (delta < 60_000)
+        return "just now";
+    if (delta < 3_600_000)
+        return `${Math.round(delta / 60_000)}m ago`;
+    if (delta < 86_400_000)
+        return `${Math.round(delta / 3_600_000)}h ago`;
+    return `${Math.round(delta / 86_400_000)}d ago`;
+}
+// Print swarm header
+function printSwarmHeader(swarm, runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.heading, "╔═══════════════════════════════════════════════════════════╗"));
+        runtime.log(colorize(rich, theme.heading, `║  🐝 SWARM: ${swarm.name.slice(0, 40).padEnd(40)} ║`));
+        runtime.log(colorize(rich, theme.heading, "╚═══════════════════════════════════════════════════════════╝"));
+    }
+    else {
+        runtime.log("═══════════════════════════════════════════════════════════");
+        runtime.log(`SWARM: ${swarm.name}`);
+        runtime.log("═══════════════════════════════════════════════════════════");
+    }
+    if (swarm.description) {
+        runtime.log(`  ${swarm.description}`);
+    }
+    runtime.log("");
+}
+// Print swarm stats
+function printSwarmStats(swarm, runtime = defaultRuntime) {
+    const rich = isRich();
+    const totalTasks = swarm.tasks.length;
+    const completedTasks = swarm.tasks.filter((t) => t.status === "completed").length;
+    const failedTasks = swarm.tasks.filter((t) => t.status === "failed").length;
+    const inProgressTasks = swarm.tasks.filter((t) => t.status === "in_progress").length;
+    const pendingTasks = swarm.tasks.filter((t) => t.status === "pending" || t.status === "assigned").length;
+    const activeMembers = swarm.members.filter((m) => m.status !== "offline").length;
+    const workingMembers = swarm.members.filter((m) => m.status === "working").length;
+    const completionRate = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+    if (rich) {
+        const stats = [
+            `${colorize(rich, theme.info, "Status:")} ${formatSwarmStatus(swarm.status, rich)}`,
+            `${colorize(rich, theme.info, "Strategy:")} ${swarm.strategy}`,
+            `${colorize(rich, theme.info, "Members:")} ${activeMembers}/${swarm.members.length} active`,
+            `${colorize(rich, theme.info, "Working:")} ${workingMembers}`,
+        ].join("  │  ");
+        runtime.log(`  ${stats}`);
+        const taskStats = [
+            `${colorize(rich, theme.success, "Completed:")} ${completedTasks}`,
+            `${colorize(rich, theme.warn, "In Progress:")} ${inProgressTasks}`,
+            `${colorize(rich, theme.muted, "Pending:")} ${pendingTasks}`,
+            `${colorize(rich, theme.error, "Failed:")} ${failedTasks}`,
+            `${colorize(rich, theme.accent, "Completion:")} ${completionRate}%`,
+        ].join("  │  ");
+        runtime.log(`  ${taskStats}`);
+    }
+    else {
+        runtime.log(`  Status: ${swarm.status} | Strategy: ${swarm.strategy}`);
+        runtime.log(`  Members: ${activeMembers}/${swarm.members.length} active | Working: ${workingMembers}`);
+        runtime.log(`  Tasks: ${completedTasks} completed | ${inProgressTasks} in progress | ${pendingTasks} pending | ${failedTasks} failed`);
+        runtime.log(`  Completion Rate: ${completionRate}%`);
+    }
+    runtime.log("");
+}
+// Print members table
+function printMembersTable(members, runtime = defaultRuntime) {
+    const rich = isRich();
+    if (members.length === 0) {
+        runtime.log(rich ? colorize(rich, theme.muted, "  No swarm members.") : "  No swarm members.");
+        return;
+    }
+    const sortedMembers = [...members].sort((a, b) => {
+        // Sort by status (working first, then idle, then error/offline)
+        const statusOrder = { working: 0, idle: 1, error: 2, offline: 3 };
+        return statusOrder[a.status] - statusOrder[b.status];
+    });
+    const columns = [
+        {
+            key: "agent",
+            header: rich ? colorize(rich, theme.heading, "Agent") : "Agent",
+            align: "left",
+            minWidth: 15,
+            flex: true,
+        },
+        {
+            key: "status",
+            header: rich ? colorize(rich, theme.heading, "Status") : "Status",
+            align: "left",
+            minWidth: 12,
+            maxWidth: 14,
+        },
+        {
+            key: "task",
+            header: rich ? colorize(rich, theme.heading, "Current Task") : "Current Task",
+            align: "left",
+            minWidth: 20,
+            flex: true,
+        },
+        {
+            key: "capabilities",
+            header: rich ? colorize(rich, theme.heading, "Capabilities") : "Capabilities",
+            align: "left",
+            minWidth: 15,
+            maxWidth: 20,
+        },
+        {
+            key: "completed",
+            header: rich ? colorize(rich, theme.heading, "Done") : "Done",
+            align: "right",
+            minWidth: 6,
+            maxWidth: 8,
+        },
+        {
+            key: "heartbeat",
+            header: rich ? colorize(rich, theme.heading, "Last Seen") : "Last Seen",
+            align: "right",
+            minWidth: 10,
+            maxWidth: 12,
+        },
+    ];
+    const rows = sortedMembers.map((member) => {
+        const capabilities = member.capabilities.slice(0, 3).join(", ") + (member.capabilities.length > 3 ? "..." : "");
+        return {
+            agent: rich ? colorize(rich, theme.info, member.agentId) : member.agentId,
+            status: formatMemberStatus(member.status, rich),
+            task: member.currentTaskId
+                ? rich
+                    ? colorize(rich, theme.accent, member.currentTaskId.slice(0, 25))
+                    : member.currentTaskId.slice(0, 25)
+                : rich
+                    ? colorize(rich, theme.muted, "-")
+                    : "-",
+            capabilities: capabilities || (rich ? colorize(rich, theme.muted, "-") : "-"),
+            completed: String(member.completedTasks),
+            heartbeat: formatRelativeTime(member.lastHeartbeatAt),
+        };
+    });
+    const table = renderTable({
+        columns,
+        rows,
+        border: rich ? "unicode" : "ascii",
+        padding: 1,
+    });
+    runtime.log(rich ? colorize(rich, theme.heading, "  Members:") : "  Members:");
+    runtime.log(table);
+}
+// Print tasks table
+function printTasksTable(tasks, runtime = defaultRuntime) {
+    const rich = isRich();
+    if (tasks.length === 0) {
+        runtime.log(rich ? colorize(rich, theme.muted, "  No tasks.") : "  No tasks.");
+        return;
+    }
+    // Sort: in_progress first, then assigned, pending, completed, failed
+    const statusOrder = {
+        in_progress: 0,
+        assigned: 1,
+        pending: 2,
+        completed: 3,
+        failed: 4,
+    };
+    const sortedTasks = [...tasks]
+        .sort((a, b) => {
+        if (statusOrder[a.status] !== statusOrder[b.status]) {
+            return statusOrder[a.status] - statusOrder[b.status];
+        }
+        return b.priority - a.priority;
+    })
+        .slice(0, 20); // Show top 20 tasks
+    const columns = [
+        {
+            key: "id",
+            header: rich ? colorize(rich, theme.heading, "Task") : "Task",
+            align: "left",
+            minWidth: 12,
+            maxWidth: 16,
+        },
+        {
+            key: "status",
+            header: rich ? colorize(rich, theme.heading, "Status") : "Status",
+            align: "left",
+            minWidth: 12,
+            maxWidth: 14,
+        },
+        {
+            key: "priority",
+            header: rich ? colorize(rich, theme.heading, "Prio") : "Prio",
+            align: "center",
+            minWidth: 6,
+            maxWidth: 8,
+        },
+        {
+            key: "assigned",
+            header: rich ? colorize(rich, theme.heading, "Assigned To") : "Assigned To",
+            align: "left",
+            minWidth: 12,
+            flex: true,
+        },
+        {
+            key: "description",
+            header: rich ? colorize(rich, theme.heading, "Description") : "Description",
+            align: "left",
+            minWidth: 25,
+            flex: true,
+        },
+    ];
+    const rows = sortedTasks.map((task) => {
+        const prioColor = task.priority >= 8 ? theme.error : task.priority >= 5 ? theme.warn : theme.muted;
+        return {
+            id: rich ? colorize(rich, theme.accent, task.id.slice(0, 12)) : task.id.slice(0, 12),
+            status: formatTaskStatus(task.status, rich),
+            priority: rich ? colorize(rich, prioColor, String(task.priority)) : String(task.priority),
+            assigned: task.assignedTo
+                ? rich
+                    ? colorize(rich, theme.info, task.assignedTo)
+                    : task.assignedTo
+                : rich
+                    ? colorize(rich, theme.muted, "-")
+                    : "-",
+            description: task.description.slice(0, 40) + (task.description.length > 40 ? "..." : ""),
+        };
+    });
+    const table = renderTable({
+        columns,
+        rows,
+        border: rich ? "unicode" : "ascii",
+        padding: 1,
+    });
+    runtime.log(rich ? colorize(rich, theme.heading, "  Tasks:") : "  Tasks:");
+    if (tasks.length > 20) {
+        runtime.log(rich
+            ? colorize(rich, theme.muted, `  (showing top 20 of ${tasks.length} tasks)`)
+            : `  (showing top 20 of ${tasks.length} tasks)`);
+    }
+    runtime.log(table);
+}
+// Print legend
+function printLegend(runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.muted, "  Legend:"));
+        runtime.log(`    Members: ${colorize(rich, theme.success, STATUS_ICONS.idle)} idle  ${colorize(rich, theme.warn, STATUS_ICONS.working)} working  ${colorize(rich, theme.error, STATUS_ICONS.error)} error  ${colorize(rich, theme.muted, STATUS_ICONS.offline)} offline`);
+        runtime.log(`    Tasks: ${colorize(rich, theme.muted, STATUS_ICONS.pending)} pending  ${colorize(rich, theme.accent, STATUS_ICONS.assigned)} assigned  ${colorize(rich, theme.warn, STATUS_ICONS.in_progress)} in progress  ${colorize(rich, theme.success, STATUS_ICONS.completed)} completed  ${colorize(rich, theme.error, STATUS_ICONS.failed)} failed`);
+    }
+    else {
+        runtime.log("  Legend:");
+        runtime.log("    Members: ◌ idle  ▶ working  ✖ error  ⊘ offline");
+        runtime.log("    Tasks: ○ pending  ◎ assigned  ◐ in progress  ● completed  ✖ failed");
+    }
+}
+// Print footer
+function printFooter(runtime = defaultRuntime) {
+    const rich = isRich();
+    runtime.log("");
+    if (rich) {
+        runtime.log(colorize(rich, theme.muted, "  Commands: poolbot swarm list | poolbot swarm create --help | poolbot swarm task add"));
+    }
+    else {
+        runtime.log("  Commands: poolbot swarm list | poolbot swarm create --help | poolbot swarm task add");
+    }
+    runtime.log("");
+}
+export function registerSwarmStatusCommand(swarm) {
+    addGatewayClientOptions(swarm
+        .command("status")
+        .description("Show swarm status dashboard")
+        .option("--id <swarmId>", "Swarm ID", "default")
+        .option("--json", "Output JSON", false)
+        .action(async (opts) => {
+        try {
+            const res = await callGatewayFromCli("swarm.status", opts, { swarmId: opts.id });
+            const swarmData = res.swarm;
+            if (!swarmData) {
+                defaultRuntime.error(danger("Swarm not found"));
+                defaultRuntime.exit(1);
+            }
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(swarmData, null, 2));
+                return;
+            }
+            printSwarmHeader(swarmData);
+            printSwarmStats(swarmData);
+            printMembersTable(swarmData.members);
+            defaultRuntime.log("");
+            printTasksTable(swarmData.tasks);
+            printLegend();
+            printFooter();
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    }));
+}
+export function registerSwarmListCommand(swarm) {
+    addGatewayClientOptions(swarm
+        .command("list")
+        .alias("ls")
+        .description("List all swarms")
+        .option("--json", "Output JSON", false)
+        .action(async (opts) => {
+        try {
+            const res = await callGatewayFromCli("swarm.list", opts, {});
+            const swarms = res.swarms;
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(swarms, null, 2));
+                return;
+            }
+            const rich = isRich();
+            const columns = [
+                {
+                    key: "id",
+                    header: rich ? colorize(rich, theme.heading, "ID") : "ID",
+                    align: "left",
+                    minWidth: 12,
+                    maxWidth: 14,
+                },
+                {
+                    key: "name",
+                    header: rich ? colorize(rich, theme.heading, "Name") : "Name",
+                    align: "left",
+                    minWidth: 20,
+                    flex: true,
+                },
+                {
+                    key: "status",
+                    header: rich ? colorize(rich, theme.heading, "Status") : "Status",
+                    align: "left",
+                    minWidth: 10,
+                    maxWidth: 12,
+                },
+                {
+                    key: "members",
+                    header: rich ? colorize(rich, theme.heading, "Members") : "Members",
+                    align: "center",
+                    minWidth: 8,
+                    maxWidth: 10,
+                },
+                {
+                    key: "tasks",
+                    header: rich ? colorize(rich, theme.heading, "Tasks") : "Tasks",
+                    align: "center",
+                    minWidth: 8,
+                    maxWidth: 10,
+                },
+            ];
+            const rows = swarms.map((s) => ({
+                id: rich ? colorize(rich, theme.accent, s.id) : s.id,
+                name: rich ? colorize(rich, theme.info, s.name) : s.name,
+                status: formatSwarmStatus(s.status, rich),
+                members: String(s.members),
+                tasks: String(s.tasks),
+            }));
+            const table = renderTable({
+                columns,
+                rows,
+                border: rich ? "unicode" : "ascii",
+                padding: 1,
+            });
+            defaultRuntime.log("");
+            defaultRuntime.log(rich ? colorize(rich, theme.heading, "Active Swarms:") : "Active Swarms:");
+            defaultRuntime.log(table);
+            defaultRuntime.log("");
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    }));
+}
+export function registerSwarmCreateCommand(swarm) {
+    addGatewayClientOptions(swarm
+        .command("create")
+        .description("Create a new agent swarm")
+        .requiredOption("--name <name>", "Swarm name")
+        .option("--description <text>", "Swarm description")
+        .option("--strategy <strategy>", "Task distribution strategy (round_robin|least_busy|capability_match|priority_queue)", "capability_match")
+        .option("--orchestrator <agentId>", "Orchestrator agent ID", "main")
+        .option("--json", "Output JSON", false)
+        .action(async (opts) => {
+        try {
+            const result = (await callGatewayFromCli("swarm.create", opts, {
+                name: opts.name,
+                description: opts.description,
+                strategy: opts.strategy,
+                orchestrator: opts.orchestrator,
+            }));
+            if (opts.json) {
+                defaultRuntime.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            const rich = isRich();
+            defaultRuntime.log("");
+            defaultRuntime.log(rich
+                ? colorize(rich, theme.success, `✓ Swarm "${result.name}" created successfully`)
+                : `✓ Swarm "${result.name}" created successfully`);
+            defaultRuntime.log(`  ID: ${result.id}`);
+            defaultRuntime.log(`  Strategy: ${result.strategy}`);
+            defaultRuntime.log(`  Orchestrator: ${result.orchestratorAgentId}`);
+            defaultRuntime.log("");
+            defaultRuntime.log(rich
+                ? colorize(rich, theme.muted, "  Use 'poolbot swarm join' to add agents to the swarm.")
+                : "  Use 'poolbot swarm join' to add agents to the swarm.");
+            defaultRuntime.log("");
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    }));
+}

package/dist/cli/telemetry-cli/register.js

@@ -0,0 +1,10 @@
+import { registerTelemetryStatusCommand } from "./register.telemetry-status.js";
+import { registerTelemetryMetricsCommand } from "./register.telemetry-metrics.js";
+export function registerTelemetryCli(program) {
+    const telemetry = program
+        .command("telemetry")
+        .alias("tel")
+        .description("OpenTelemetry observability and metrics");
+    registerTelemetryStatusCommand(telemetry);
+    registerTelemetryMetricsCommand(telemetry);
+}