@agentmeshhq/agent 0.2.1 → 0.3.0

package/dist/__tests__/shared-resource-guards.test.js

@@ -0,0 +1,260 @@
+/**
+ * Shared Resource Guards Tests
+ *
+ * Tests for workdir conflict detection, serve port collision detection,
+ * HQ workdir per-agent expansion, and servePort state persistence.
+ */
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+// These tests exercise the guard logic used in daemon.ts without
+// instantiating the full daemon. We replicate the inline checks.
+describe("Workdir conflict guard", () => {
+    function findWorkdirConflict(agents, agentName, workdir, isRunning) {
+        const resolvedWorkdir = path.resolve(workdir);
+        return agents.find((a) => a.name !== agentName &&
+            a.workdir &&
+            path.resolve(a.workdir) === resolvedWorkdir &&
+            a.pid > 0 &&
+            isRunning(a.pid));
+    }
+    it("detects conflict when another running agent uses same workdir", () => {
+        const agents = [
+            {
+                name: "agent-1",
+                agentId: "id-1",
+                pid: 1001,
+                tmuxSession: "s1",
+                startedAt: "2024-01-01T00:00:00Z",
+                workdir: "/Users/dev/project",
+            },
+        ];
+        const conflict = findWorkdirConflict(agents, "agent-2", "/Users/dev/project", () => true);
+        expect(conflict).toBeDefined();
+        expect(conflict.name).toBe("agent-1");
+    });
+    it("no conflict when same agent name (self-check)", () => {
+        const agents = [
+            {
+                name: "agent-1",
+                agentId: "id-1",
+                pid: 1001,
+                tmuxSession: "s1",
+                startedAt: "2024-01-01T00:00:00Z",
+                workdir: "/Users/dev/project",
+            },
+        ];
+        const conflict = findWorkdirConflict(agents, "agent-1", "/Users/dev/project", () => true);
+        expect(conflict).toBeUndefined();
+    });
+    it("no conflict when other agent process is dead", () => {
+        const agents = [
+            {
+                name: "agent-1",
+                agentId: "id-1",
+                pid: 1001,
+                tmuxSession: "s1",
+                startedAt: "2024-01-01T00:00:00Z",
+                workdir: "/Users/dev/project",
+            },
+        ];
+        const conflict = findWorkdirConflict(agents, "agent-2", "/Users/dev/project", () => false);
+        expect(conflict).toBeUndefined();
+    });
+    it("no conflict when workdirs differ", () => {
+        const agents = [
+            {
+                name: "agent-1",
+                agentId: "id-1",
+                pid: 1001,
+                tmuxSession: "s1",
+                startedAt: "2024-01-01T00:00:00Z",
+                workdir: "/Users/dev/project-agent-1",
+            },
+        ];
+        const conflict = findWorkdirConflict(agents, "agent-2", "/Users/dev/project-agent-2", () => true);
+        expect(conflict).toBeUndefined();
+    });
+    it("no conflict when other agent has no workdir", () => {
+        const agents = [
+            {
+                name: "agent-1",
+                agentId: "id-1",
+                pid: 1001,
+                tmuxSession: "s1",
+                startedAt: "2024-01-01T00:00:00Z",
+            },
+        ];
+        const conflict = findWorkdirConflict(agents, "agent-2", "/Users/dev/project", () => true);
+        expect(conflict).toBeUndefined();
+    });
+    it("resolves relative paths correctly", () => {
+        const agents = [
+            {
+                name: "agent-1",
+                agentId: "id-1",
+                pid: 1001,
+                tmuxSession: "s1",
+                startedAt: "2024-01-01T00:00:00Z",
+                workdir: path.resolve("./project"),
+            },
+        ];
+        const conflict = findWorkdirConflict(agents, "agent-2", "./project", () => true);
+        expect(conflict).toBeDefined();
+    });
+});
+describe("Serve port collision guard", () => {
+    function findPortConflict(agents, agentName, servePort, isRunning) {
+        return agents.find((a) => a.name !== agentName &&
+            a.servePort === servePort &&
+            a.pid > 0 &&
+            isRunning(a.pid));
+    }
+    it("detects port collision with running agent", () => {
+        const agents = [
+            {
+                name: "serve-agent-1",
+                agentId: "id-1",
+                pid: 2001,
+                tmuxSession: "serve:3001",
+                startedAt: "2024-01-01T00:00:00Z",
+                servePort: 3001,
+            },
+        ];
+        const conflict = findPortConflict(agents, "serve-agent-2", 3001, () => true);
+        expect(conflict).toBeDefined();
+        expect(conflict.name).toBe("serve-agent-1");
+    });
+    it("no collision when same agent (self-check)", () => {
+        const agents = [
+            {
+                name: "serve-agent-1",
+                agentId: "id-1",
+                pid: 2001,
+                tmuxSession: "serve:3001",
+                startedAt: "2024-01-01T00:00:00Z",
+                servePort: 3001,
+            },
+        ];
+        const conflict = findPortConflict(agents, "serve-agent-1", 3001, () => true);
+        expect(conflict).toBeUndefined();
+    });
+    it("no collision when other agent process is dead", () => {
+        const agents = [
+            {
+                name: "serve-agent-1",
+                agentId: "id-1",
+                pid: 2001,
+                tmuxSession: "serve:3001",
+                startedAt: "2024-01-01T00:00:00Z",
+                servePort: 3001,
+            },
+        ];
+        const conflict = findPortConflict(agents, "serve-agent-2", 3001, () => false);
+        expect(conflict).toBeUndefined();
+    });
+    it("no collision when ports differ", () => {
+        const agents = [
+            {
+                name: "serve-agent-1",
+                agentId: "id-1",
+                pid: 2001,
+                tmuxSession: "serve:3001",
+                startedAt: "2024-01-01T00:00:00Z",
+                servePort: 3001,
+            },
+        ];
+        const conflict = findPortConflict(agents, "serve-agent-2", 3002, () => true);
+        expect(conflict).toBeUndefined();
+    });
+    it("no collision when other agent has no servePort", () => {
+        const agents = [
+            {
+                name: "tmux-agent",
+                agentId: "id-1",
+                pid: 2001,
+                tmuxSession: "agentmesh-tmux-agent",
+                startedAt: "2024-01-01T00:00:00Z",
+            },
+        ];
+        const conflict = findPortConflict(agents, "serve-agent-2", 3001, () => true);
+        expect(conflict).toBeUndefined();
+    });
+});
+describe("HQ workdir per-agent expansion", () => {
+    it("appends agent name as sibling directory", () => {
+        const baseWorkdir = "/Users/raju/Dev/agentmesh";
+        const agentName = "atlas-dev-1";
+        const uniqueWorkdir = path.join(path.dirname(baseWorkdir), `${path.basename(baseWorkdir)}-${agentName}`);
+        expect(uniqueWorkdir).toBe("/Users/raju/Dev/agentmesh-atlas-dev-1");
+    });
+    it("produces unique paths for different agents", () => {
+        const baseWorkdir = "/Users/raju/Dev/agentmesh";
+        const workdir1 = path.join(path.dirname(baseWorkdir), `${path.basename(baseWorkdir)}-agent-1`);
+        const workdir2 = path.join(path.dirname(baseWorkdir), `${path.basename(baseWorkdir)}-agent-2`);
+        expect(workdir1).not.toBe(workdir2);
+        expect(workdir1).toBe("/Users/raju/Dev/agentmesh-agent-1");
+        expect(workdir2).toBe("/Users/raju/Dev/agentmesh-agent-2");
+    });
+    it("handles nested paths correctly", () => {
+        const baseWorkdir = "/home/user/projects/my-app";
+        const agentName = "worker";
+        const uniqueWorkdir = path.join(path.dirname(baseWorkdir), `${path.basename(baseWorkdir)}-${agentName}`);
+        expect(uniqueWorkdir).toBe("/home/user/projects/my-app-worker");
+    });
+    it("handles trailing slash in base workdir", () => {
+        // path.basename and path.dirname handle trailing slashes correctly on POSIX
+        const baseWorkdir = "/Users/raju/Dev/agentmesh";
+        const agentName = "test";
+        const uniqueWorkdir = path.join(path.dirname(baseWorkdir), `${path.basename(baseWorkdir)}-${agentName}`);
+        expect(uniqueWorkdir).toBe("/Users/raju/Dev/agentmesh-test");
+    });
+});
+describe("servePort in AgentState", () => {
+    it("servePort field is included in state", () => {
+        const agent = {
+            name: "serve-agent",
+            agentId: "id-1",
+            pid: 3001,
+            tmuxSession: "serve:3001",
+            startedAt: "2024-01-01T00:00:00Z",
+            servePort: 3001,
+        };
+        expect(agent.servePort).toBe(3001);
+    });
+    it("servePort is optional (undefined for tmux agents)", () => {
+        const agent = {
+            name: "tmux-agent",
+            agentId: "id-2",
+            pid: 4001,
+            tmuxSession: "agentmesh-tmux-agent",
+            startedAt: "2024-01-01T00:00:00Z",
+        };
+        expect(agent.servePort).toBeUndefined();
+    });
+    it("servePort serializes correctly in state JSON", () => {
+        const state = {
+            agents: [
+                {
+                    name: "serve-agent",
+                    agentId: "id-1",
+                    pid: 3001,
+                    tmuxSession: "serve:3001",
+                    startedAt: "2024-01-01T00:00:00Z",
+                    servePort: 3001,
+                },
+                {
+                    name: "tmux-agent",
+                    agentId: "id-2",
+                    pid: 4001,
+                    tmuxSession: "agentmesh-tmux",
+                    startedAt: "2024-01-01T00:00:00Z",
+                },
+            ],
+        };
+        const json = JSON.stringify(state);
+        const parsed = JSON.parse(json);
+        expect(parsed.agents[0].servePort).toBe(3001);
+        expect(parsed.agents[1].servePort).toBeUndefined();
+    });
+});
+//# sourceMappingURL=shared-resource-guards.test.js.map

package/dist/__tests__/shared-resource-guards.test.js.map

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

package/dist/cli/inbox.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Inbox CLI Command
+ * Shows agent's assigned issues and pending handoffs
+ */
+export declare function inbox(): Promise<void>;

package/dist/cli/inbox.js

@@ -0,0 +1,123 @@
+/**
+ * Inbox CLI Command
+ * Shows agent's assigned issues and pending handoffs
+ */
+import pc from "picocolors";
+import { loadConfig, getAgentState } from "../config/loader.js";
+import { loadCache } from "../core/issue-cache.js";
+async function getHubUrl() {
+    const config = loadConfig();
+    return config?.hubUrl || process.env.AGENTMESH_HUB_URL || "https://agentmeshhq.dev";
+}
+async function getToken() {
+    const state = getAgentState(process.env.AGENT_NAME || "");
+    if (state?.token)
+        return state.token;
+    if (process.env.AGENT_TOKEN)
+        return process.env.AGENT_TOKEN;
+    return null;
+}
+async function getWorkspace() {
+    const config = loadConfig();
+    return config?.workspace || process.env.AGENTMESH_WORKSPACE || "agentmesh";
+}
+async function apiRequest(path) {
+    const hubUrl = await getHubUrl();
+    const token = await getToken();
+    try {
+        const response = await fetch(`${hubUrl}${path}`, {
+            headers: {
+                "Content-Type": "application/json",
+                ...(token && { Authorization: `Bearer ${token}` }),
+            },
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            return { error: error.error || response.statusText };
+        }
+        const data = await response.json();
+        return { data: data };
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+function getStatusColor(status) {
+    switch (status) {
+        case "open":
+            return pc.yellow;
+        case "in_progress":
+            return pc.blue;
+        case "review":
+            return pc.magenta;
+        case "closed":
+            return pc.green;
+        default:
+            return pc.dim;
+    }
+}
+function getPriorityColor(priority) {
+    switch (priority) {
+        case "P0":
+            return pc.red;
+        case "P1":
+            return (s) => pc.yellow(pc.bold(s));
+        case "P2":
+            return pc.yellow;
+        default:
+            return pc.dim;
+    }
+}
+export async function inbox() {
+    console.log(pc.bold("Your Inbox"));
+    console.log();
+    // Fetch issues assigned to me
+    const issuesResult = await apiRequest("/api/v1/agents/me/inbox");
+    if (issuesResult.error) {
+        if (issuesResult.error.includes("fetch") || issuesResult.error.includes("network")) {
+            console.log(pc.yellow("Offline - showing cached assigned issues"));
+            const workspace = await getWorkspace();
+            const cache = loadCache(workspace);
+            const state = getAgentState(process.env.AGENT_NAME || "");
+            const myIssues = cache.issues.filter((i) => i.assignee_agent_id === state?.agentId && i.status !== "closed");
+            displayInbox(myIssues);
+            return;
+        }
+        console.error(pc.red(`Error fetching inbox: ${issuesResult.error}`));
+        process.exit(1);
+    }
+    displayInbox(issuesResult.data?.issues || []);
+}
+function displayInbox(issues) {
+    if (issues.length === 0) {
+        console.log(pc.dim("No assigned issues. Use 'agentmesh ready' to find available work."));
+        return;
+    }
+    // Group by status
+    const inProgress = issues.filter((i) => i.status === "in_progress");
+    const review = issues.filter((i) => i.status === "review");
+    const open = issues.filter((i) => i.status === "open");
+    if (inProgress.length > 0) {
+        console.log(pc.blue(pc.bold("In Progress")));
+        for (const issue of inProgress) {
+            console.log(`  ${pc.cyan(issue.issue_id)} ${getPriorityColor(issue.priority)(issue.priority)} ${issue.title}`);
+        }
+        console.log();
+    }
+    if (review.length > 0) {
+        console.log(pc.magenta(pc.bold("In Review")));
+        for (const issue of review) {
+            console.log(`  ${pc.cyan(issue.issue_id)} ${getPriorityColor(issue.priority)(issue.priority)} ${issue.title}`);
+        }
+        console.log();
+    }
+    if (open.length > 0) {
+        console.log(pc.yellow(pc.bold("Open")));
+        for (const issue of open) {
+            console.log(`  ${pc.cyan(issue.issue_id)} ${getPriorityColor(issue.priority)(issue.priority)} ${issue.title}`);
+        }
+        console.log();
+    }
+    console.log(pc.dim(`Total: ${issues.length} issue(s) assigned to you`));
+}
+//# sourceMappingURL=inbox.js.map

package/dist/cli/inbox.js.map

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

package/dist/cli/issue.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Issue CLI Commands
+ * Integrated issue tracking for agents
+ */
+export interface CreateIssueOptions {
+    title: string;
+    description?: string;
+    type?: string;
+    priority?: string;
+    project?: string;
+    parent?: string;
+    labels?: string[];
+}
+export declare function createIssue(options: CreateIssueOptions): Promise<void>;
+export interface ListIssuesOptions {
+    status?: string;
+    type?: string;
+    priority?: string;
+    assignee?: string;
+    project?: string;
+    limit?: number;
+}
+export declare function listIssues(options?: ListIssuesOptions): Promise<void>;
+export declare function showIssue(issueId: string): Promise<void>;
+export interface UpdateIssueOptions {
+    title?: string;
+    description?: string;
+    type?: string;
+    priority?: string;
+    status?: string;
+    project?: string;
+    assignee?: string;
+    labels?: string[];
+}
+export declare function updateIssue(issueId: string, options: UpdateIssueOptions): Promise<void>;
+export declare function closeIssue(issueId: string): Promise<void>;
+export declare function claimIssue(issueId: string): Promise<void>;
+export interface HandoffOptions {
+    to: string;
+    reason?: string;
+}
+export declare function handoffIssue(issueId: string, options: HandoffOptions): Promise<void>;