@agentmeshhq/agent 0.4.2 → 0.4.4

package/dist/cli/issue.js

@@ -0,0 +1,297 @@
+/**
+ * Issue CLI Commands
+ * Integrated issue tracking for agents
+ */
+import pc from "picocolors";
+import { getAgentState, loadConfig } from "../config/loader.js";
+import { loadCache, queueChange, updateCacheIssues } 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() {
+    // Try agent state first
+    const state = getAgentState(process.env.AGENT_NAME || "");
+    if (state?.token)
+        return state.token;
+    // Try environment
+    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(method, path, body) {
+    const hubUrl = await getHubUrl();
+    const token = await getToken();
+    try {
+        const response = await fetch(`${hubUrl}${path}`, {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                ...(token && { Authorization: `Bearer ${token}` }),
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            return { error: error.error || response.statusText };
+        }
+        if (response.status === 204) {
+            return { data: undefined };
+        }
+        const data = await response.json();
+        return { data: data };
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+export async function createIssue(options) {
+    const workspace = await getWorkspace();
+    console.log(pc.cyan("Creating issue..."));
+    const result = await apiRequest("POST", `/api/v1/workspaces/${workspace}/issues`, {
+        title: options.title,
+        description: options.description,
+        type: options.type || "task",
+        priority: options.priority || "P2",
+        project_id: options.project,
+        parent_issue_id: options.parent,
+        labels: options.labels,
+    });
+    if (result.error) {
+        // Queue for offline sync
+        if (result.error.includes("fetch") || result.error.includes("network")) {
+            console.log(pc.yellow("Offline - queuing change for later sync"));
+            queueChange(workspace, {
+                action: "create",
+                data: {
+                    title: options.title,
+                    description: options.description || null,
+                    type: options.type || "task",
+                    priority: options.priority || "P2",
+                    project_id: options.project || null,
+                    parent_issue_id: options.parent || null,
+                    labels: options.labels || [],
+                },
+                queuedAt: new Date().toISOString(),
+            });
+            return;
+        }
+        console.error(pc.red(`Error: ${result.error}`));
+        process.exit(1);
+    }
+    console.log(pc.green(`Created issue: ${result.data?.issue_id}`));
+}
+export async function listIssues(options = {}) {
+    const workspace = await getWorkspace();
+    const params = new URLSearchParams();
+    if (options.status)
+        params.set("status", options.status);
+    if (options.type)
+        params.set("type", options.type);
+    if (options.priority)
+        params.set("priority", options.priority);
+    if (options.assignee === "me") {
+        const state = getAgentState(process.env.AGENT_NAME || "");
+        if (state?.agentId)
+            params.set("assignee_agent_id", state.agentId);
+    }
+    else if (options.assignee) {
+        params.set("assignee_agent_id", options.assignee);
+    }
+    if (options.project)
+        params.set("project_id", options.project);
+    if (options.limit)
+        params.set("limit", String(options.limit));
+    const result = await apiRequest("GET", `/api/v1/workspaces/${workspace}/issues?${params}`);
+    if (result.error) {
+        // Try cache
+        if (result.error.includes("fetch") || result.error.includes("network")) {
+            console.log(pc.yellow("Offline - showing cached issues"));
+            const cache = loadCache(workspace);
+            displayIssueList(cache.issues.filter((i) => {
+                if (options.status && i.status !== options.status)
+                    return false;
+                if (options.type && i.type !== options.type)
+                    return false;
+                if (options.priority && i.priority !== options.priority)
+                    return false;
+                return true;
+            }));
+            return;
+        }
+        console.error(pc.red(`Error: ${result.error}`));
+        process.exit(1);
+    }
+    const issues = result.data?.issues || [];
+    // Update cache
+    updateCacheIssues(workspace, issues);
+    displayIssueList(issues);
+}
+function displayIssueList(issues) {
+    if (issues.length === 0) {
+        console.log(pc.dim("No issues found"));
+        return;
+    }
+    console.log();
+    console.log(pc.bold(`${issues.length} issue(s)`));
+    console.log();
+    for (const issue of issues) {
+        const statusColor = getStatusColor(issue.status);
+        const priorityColor = getPriorityColor(issue.priority);
+        console.log(`${pc.cyan(issue.issue_id)} ${statusColor(issue.status.padEnd(12))} ${priorityColor(issue.priority.padEnd(3))} ${issue.title}`);
+    }
+}
+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;
+        case "P3":
+            return pc.dim;
+        case "P4":
+            return pc.dim;
+        default:
+            return pc.dim;
+    }
+}
+export async function showIssue(issueId) {
+    const workspace = await getWorkspace();
+    const result = await apiRequest("GET", `/api/v1/workspaces/${workspace}/issues/${issueId}`);
+    if (result.error) {
+        // Try cache
+        if (result.error.includes("fetch") || result.error.includes("network")) {
+            console.log(pc.yellow("Offline - showing cached issue"));
+            const cache = loadCache(workspace);
+            const issue = cache.issues.find((i) => i.issue_id === issueId);
+            if (!issue) {
+                console.error(pc.red(`Issue ${issueId} not found in cache`));
+                process.exit(1);
+            }
+            displayIssue(issue);
+            return;
+        }
+        console.error(pc.red(`Error: ${result.error}`));
+        process.exit(1);
+    }
+    displayIssue(result.data);
+}
+function displayIssue(issue) {
+    console.log();
+    console.log(`${pc.bold(pc.cyan(issue.issue_id))} ${issue.title}`);
+    console.log();
+    console.log(`Status:     ${getStatusColor(issue.status)(issue.status)}`);
+    console.log(`Type:       ${issue.type}`);
+    console.log(`Priority:   ${getPriorityColor(issue.priority)(issue.priority)}`);
+    if (issue.assignee_agent_id) {
+        console.log(`Assignee:   ${issue.assignee_agent_id}`);
+    }
+    if (issue.project_id) {
+        console.log(`Project:    ${issue.project_id}`);
+    }
+    if (issue.labels && issue.labels.length > 0) {
+        console.log(`Labels:     ${issue.labels.join(", ")}`);
+    }
+    if (issue.external_ref) {
+        console.log(`External:   ${issue.external_provider}:${issue.external_ref}`);
+        if (issue.external_url) {
+            console.log(`URL:        ${issue.external_url}`);
+        }
+    }
+    console.log();
+    console.log(`Created:    ${issue.created_at}`);
+    console.log(`Updated:    ${issue.updated_at}`);
+    if (issue.description) {
+        console.log();
+        console.log(pc.dim("Description:"));
+        console.log(issue.description);
+    }
+}
+export async function updateIssue(issueId, options) {
+    const workspace = await getWorkspace();
+    console.log(pc.cyan(`Updating issue ${issueId}...`));
+    const body = {};
+    if (options.title)
+        body.title = options.title;
+    if (options.description)
+        body.description = options.description;
+    if (options.type)
+        body.type = options.type;
+    if (options.priority)
+        body.priority = options.priority;
+    if (options.status)
+        body.status = options.status;
+    if (options.project)
+        body.project_id = options.project;
+    if (options.assignee)
+        body.assignee_agent_id = options.assignee;
+    if (options.labels)
+        body.labels = options.labels;
+    const result = await apiRequest("PATCH", `/api/v1/workspaces/${workspace}/issues/${issueId}`, body);
+    if (result.error) {
+        if (result.error.includes("fetch") || result.error.includes("network")) {
+            console.log(pc.yellow("Offline - queuing change for later sync"));
+            queueChange(workspace, {
+                action: "update",
+                issueId,
+                data: body,
+                queuedAt: new Date().toISOString(),
+            });
+            return;
+        }
+        console.error(pc.red(`Error: ${result.error}`));
+        process.exit(1);
+    }
+    console.log(pc.green(`Updated issue ${issueId}`));
+}
+export async function closeIssue(issueId) {
+    await updateIssue(issueId, { status: "closed" });
+}
+// ============================================================================
+// Workflow Commands
+// ============================================================================
+export async function claimIssue(issueId) {
+    const workspace = await getWorkspace();
+    console.log(pc.cyan(`Claiming issue ${issueId}...`));
+    const result = await apiRequest("POST", `/api/v1/workspaces/${workspace}/issues/${issueId}/claim`);
+    if (result.error) {
+        console.error(pc.red(`Error: ${result.error}`));
+        process.exit(1);
+    }
+    console.log(pc.green(`Claimed issue ${issueId} - now assigned to you and in_progress`));
+}
+export async function handoffIssue(issueId, options) {
+    const workspace = await getWorkspace();
+    console.log(pc.cyan(`Creating handoff for issue ${issueId}...`));
+    const result = await apiRequest("POST", `/api/v1/workspaces/${workspace}/issues/${issueId}/handoff`, {
+        to_agent_id: options.to,
+        reason: options.reason,
+    });
+    if (result.error) {
+        console.error(pc.red(`Error: ${result.error}`));
+        process.exit(1);
+    }
+    console.log(pc.green(`Created handoff ${result.data?.handoff_id}`));
+    console.log(pc.dim("Note: Issue assignment unchanged. Target agent will see this in their inbox."));
+}
+//# sourceMappingURL=issue.js.map

package/dist/cli/issue.js.map

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

package/dist/cli/local.d.ts

@@ -1,9 +1,30 @@
-export declare function localUp(options?: {
+export interface LocalOptions {
+    /** Compose file path or target name (e.g. docker-compose.local.yml or full path) */
+    target?: string;
+    /** Slot number for deterministic port mapping (0-based) */
+    slot?: number;
+    /** Project name for compose namespace isolation */
+    project?: string;
     detach?: boolean;
-}): Promise<void>;
-export declare function localDown(): Promise<void>;
-export declare function localStatus(): Promise<void>;
-export declare function localLogs(options?: {
     follow?: boolean;
     service?: string;
-}): Promise<void>;
+}
+/**
+ * Compute the host port for a given internal service port when using slots.
+ * Slot 0 preserves default ports; slot N shifts by N * SLOT_PORT_BLOCK_SIZE.
+ */
+export declare function slotPort(internalPort: number, slot: number): number;
+/** Check if a TCP port is free on 127.0.0.1 */
+export declare function isPortFree(port: number): Promise<boolean>;
+export interface PreflightResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function runPreflight(options?: LocalOptions): Promise<PreflightResult>;
+export declare function localUp(options?: LocalOptions): Promise<void>;
+export declare function localDown(options?: LocalOptions): Promise<void>;
+export declare function localStatus(options?: LocalOptions): Promise<void>;
+export declare function localLogs(options?: LocalOptions): Promise<void>;
+export declare function localDoctor(options?: LocalOptions): Promise<void>;
+export declare function localSmoke(options?: LocalOptions): Promise<void>;