agenthub-multiagent-mcp 1.1.2 → 1.1.4

package/src/client.ts

@@ -1,286 +1,293 @@
-/**
- * HTTP client for AgentHub API
- */
-
-export interface Agent {
-  id: string;
-  name: string;
-  owner: string;
-  model: string;
-  model_provider: string;
-  status: "online" | "busy" | "offline";
-  working_dir: string;
-  current_task: string;
-  task_started_at?: string;
-  channels: string[];
-  registered_at: string;
-  last_heartbeat: string;
-}
-
-export interface PendingTask {
-  id: string;
-  assigned_to: string;
-  assigned_by: string;
-  assigned_by_name?: string;
-  task: string;
-  priority: string;
-  status: string;
-  created_at: string;
-}
-
-export interface TaskCompletionResponse {
-  task_id: string;
-  elapsed_time: string;
-  slack_posted: boolean;
-  agents_notified: number;
-  pending_tasks_count: number;
-}
-
-export interface Message {
-  id: string;
-  from_agent: string;
-  to_agent?: string;
-  to_channel?: string;
-  broadcast: boolean;
-  type: "task" | "status" | "question" | "response" | "context";
-  subject: string;
-  body: string;
-  reply_to?: string;
-  status: "pending" | "delivered" | "read" | "responded";
-  priority: "normal" | "high" | "urgent";
-  created_at: string;
-  delivered_at?: string;
-  read_at?: string;
-}
-
-export interface Channel {
-  name: string;
-  description: string;
-  members: string[];
-  member_count: number;
-  created_at: string;
-}
-
-export class ApiClient {
-  private baseUrl: string;
-  private apiKey: string;
-
-  constructor(baseUrl: string, apiKey: string) {
-    this.baseUrl = baseUrl.replace(/\/$/, "");
-    this.apiKey = apiKey;
-  }
-
-  private async request<T>(
-    method: string,
-    path: string,
-    body?: unknown
-  ): Promise<T> {
-    const url = `${this.baseUrl}${path}`;
-
-    const response = await fetch(url, {
-      method,
-      headers: {
-        "Content-Type": "application/json",
-        "X-API-Key": this.apiKey,
-      },
-      body: body ? JSON.stringify(body) : undefined,
-    });
-
-    const data = await response.json() as Record<string, unknown>;
-
-    if (!response.ok) {
-      const message = typeof data.message === 'string' ? data.message : `Request failed: ${response.status}`;
-      throw new Error(message);
-    }
-
-    return data as T;
-  }
-
-  // Agent methods
-  async registerAgent(
-    id: string,
-    name?: string,
-    owner?: string,
-    workingDir?: string,
-    model?: string
-  ): Promise<{
-    agent_id: string;
-    token: string;
-    model: string;
-    model_provider: string;
-    registered_at: string;
-    slack_notified: boolean;
-    pending_tasks_count: number;
-    unread_messages_count: number;
-  }> {
-    return this.request("POST", "/agents/register", {
-      id,
-      name,
-      owner,
-      working_dir: workingDir,
-      model,
-    });
-  }
-
-  async reconnectAgent(
-    agentId: string,
-    token: string,
-    owner?: string
-  ): Promise<{
-    reconnected: boolean;
-    agent_id: string;
-    was_offline: boolean;
-    pending_tasks_count: number;
-    unread_messages_count: number;
-    slack_notified: boolean;
-  }> {
-    return this.request("POST", "/agents/reconnect", {
-      agent_id: agentId,
-      token,
-      owner,
-    });
-  }
-
-  async startWork(
-    agentId: string,
-    task: string,
-    project?: string
-  ): Promise<{ acknowledged: boolean; slack_posted: boolean }> {
-    return this.request("POST", `/agents/${agentId}/start-work`, {
-      task,
-      project,
-    });
-  }
-
-  async heartbeat(
-    agentId: string,
-    status?: "online" | "busy"
-  ): Promise<{ acknowledged: boolean; timestamp: string }> {
-    return this.request("POST", `/agents/${agentId}/heartbeat`, { status });
-  }
-
-  async disconnect(agentId: string): Promise<{ unregistered: boolean }> {
-    return this.request("DELETE", `/agents/${agentId}`);
-  }
-
-  async getAgent(agentId: string): Promise<Agent> {
-    return this.request("GET", `/agents/${agentId}`);
-  }
-
-  async listAgents(status?: string): Promise<{ agents: Agent[]; total: number }> {
-    const query = status ? `?status=${status}` : "";
-    return this.request("GET", `/agents${query}`);
-  }
-
-  // Message methods
-  async sendMessage(params: {
-    from_agent?: string;
-    to_agent?: string;
-    to_channel?: string;
-    broadcast?: boolean;
-    type: string;
-    subject: string;
-    body: string;
-    reply_to?: string;
-    priority?: string;
-  }): Promise<{ message_id: string; status: string; created_at: string }> {
-    return this.request("POST", "/messages", params);
-  }
-
-  async getInbox(
-    agentId: string,
-    unreadOnly?: boolean,
-    limit?: number
-  ): Promise<{ messages: Message[]; total: number }> {
-    const params = new URLSearchParams();
-    if (unreadOnly) params.set("unread_only", "true");
-    if (limit) params.set("limit", String(limit));
-    const query = params.toString() ? `?${params}` : "";
-    return this.request("GET", `/messages/inbox/${agentId}${query}`);
-  }
-
-  async markRead(messageId: string): Promise<{ updated: boolean }> {
-    return this.request("PATCH", `/messages/${messageId}/status`, {
-      status: "read",
-    });
-  }
-
-  async reply(
-    messageId: string,
-    fromAgent: string,
-    body: string
-  ): Promise<{ message_id: string }> {
-    // Get original message to find recipient
-    const original = await this.request<Message>("GET", `/messages/${messageId}`);
-
-    return this.request("POST", "/messages", {
-      from_agent: fromAgent,
-      to_agent: original.from_agent,
-      type: "response",
-      subject: `Re: ${original.subject}`,
-      body,
-      reply_to: messageId,
-    });
-  }
-
-  // Channel methods
-  async listChannels(): Promise<{ channels: Channel[]; total: number }> {
-    return this.request("GET", "/channels");
-  }
-
-  async joinChannel(
-    channelName: string,
-    agentId: string
-  ): Promise<{ subscribed: boolean }> {
-    return this.request("POST", `/channels/${channelName}/subscribe`, {
-      agent_id: agentId,
-    });
-  }
-
-  async leaveChannel(
-    channelName: string,
-    agentId: string
-  ): Promise<{ unsubscribed: boolean }> {
-    return this.request("DELETE", `/channels/${channelName}/unsubscribe/${agentId}`);
-  }
-
-  // Task completion methods
-  async completeTask(
-    agentId: string,
-    params: {
-      summary: string;
-      outcome: "completed" | "blocked" | "partial" | "needs_review" | "handed_off";
-      files_changed?: string[];
-      time_spent?: string;
-      next_steps?: string;
-    }
-  ): Promise<TaskCompletionResponse> {
-    return this.request("POST", `/agents/${agentId}/complete-task`, params);
-  }
-
-  async getPendingTasks(
-    agentId: string
-  ): Promise<{ tasks: PendingTask[]; total: number }> {
-    return this.request("GET", `/agents/${agentId}/pending-tasks`);
-  }
-
-  async acceptTask(
-    agentId: string,
-    taskId: string
-  ): Promise<{ acknowledged: boolean; task: string; started_at: string }> {
-    return this.request("POST", `/agents/${agentId}/accept-task`, {
-      task_id: taskId,
-    });
-  }
-
-  async declineTask(
-    agentId: string,
-    taskId: string,
-    reason: string
-  ): Promise<{ acknowledged: boolean }> {
-    return this.request("POST", `/agents/${agentId}/decline-task`, {
-      task_id: taskId,
-      reason,
-    });
-  }
-}
+/**
+ * HTTP client for AgentHub API
+ */
+
+export interface Agent {
+  id: string;
+  name: string;
+  owner: string;
+  model: string;
+  model_provider: string;
+  status: "online" | "busy" | "offline";
+  working_dir: string;
+  current_task: string;
+  task_started_at?: string;
+  channels: string[];
+  registered_at: string;
+  last_heartbeat: string;
+}
+
+export interface PendingTask {
+  id: string;
+  assigned_to: string;
+  assigned_by: string;
+  assigned_by_name?: string;
+  task: string;
+  priority: string;
+  status: string;
+  created_at: string;
+}
+
+export interface TaskCompletionResponse {
+  task_id: string;
+  elapsed_time: string;
+  slack_posted: boolean;
+  agents_notified: number;
+  pending_tasks_count: number;
+}
+
+export interface Message {
+  id: string;
+  from_agent: string;
+  to_agent?: string;
+  to_channel?: string;
+  broadcast: boolean;
+  type: "task" | "status" | "question" | "response" | "context";
+  subject: string;
+  body: string;
+  reply_to?: string;
+  status: "pending" | "delivered" | "read" | "responded";
+  priority: "normal" | "high" | "urgent";
+  created_at: string;
+  delivered_at?: string;
+  read_at?: string;
+}
+
+export interface Channel {
+  name: string;
+  description: string;
+  members: string[];
+  member_count: number;
+  created_at: string;
+}
+
+export class ApiClient {
+  private baseUrl: string;
+  private apiKey: string;
+
+  constructor(baseUrl: string, apiKey: string) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown
+  ): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+
+    const response = await fetch(url, {
+      method,
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": this.apiKey,
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+
+    const data = await response.json() as Record<string, unknown>;
+
+    if (!response.ok) {
+      const message = typeof data.message === 'string' ? data.message : `Request failed: ${response.status}`;
+      throw new Error(message);
+    }
+
+    return data as T;
+  }
+
+  // Agent methods
+  async registerAgent(
+    id: string,
+    name?: string,
+    owner?: string,
+    workingDir?: string,
+    model?: string
+  ): Promise<{
+    agent_id: string;
+    token: string;
+    model: string;
+    model_provider: string;
+    registered_at: string;
+    slack_notified: boolean;
+    pending_tasks_count: number;
+    unread_messages_count: number;
+  }> {
+    return this.request("POST", "/agents/register", {
+      id,
+      name,
+      owner,
+      working_dir: workingDir,
+      model,
+    });
+  }
+
+  async reconnectAgent(
+    agentId: string,
+    token: string,
+    owner?: string,
+    model?: string
+  ): Promise<{
+    reconnected: boolean;
+    agent_id: string;
+    was_offline: boolean;
+    pending_tasks_count: number;
+    unread_messages_count: number;
+    slack_notified: boolean;
+  }> {
+    return this.request("POST", "/agents/reconnect", {
+      agent_id: agentId,
+      token,
+      owner,
+      model,
+    });
+  }
+
+  async startWork(
+    agentId: string,
+    task: string,
+    project?: string
+  ): Promise<{ acknowledged: boolean; slack_posted: boolean }> {
+    return this.request("POST", `/agents/${agentId}/start-work`, {
+      task,
+      project,
+    });
+  }
+
+  async heartbeat(
+    agentId: string,
+    status?: "online" | "busy"
+  ): Promise<{
+    acknowledged: boolean;
+    timestamp: string;
+    pending_tasks_count: number;
+    unread_messages_count: number;
+  }> {
+    return this.request("POST", `/agents/${agentId}/heartbeat`, { status });
+  }
+
+  async disconnect(agentId: string): Promise<{ unregistered: boolean }> {
+    return this.request("DELETE", `/agents/${agentId}`);
+  }
+
+  async getAgent(agentId: string): Promise<Agent> {
+    return this.request("GET", `/agents/${agentId}`);
+  }
+
+  async listAgents(status?: string): Promise<{ agents: Agent[]; total: number }> {
+    const query = status ? `?status=${status}` : "";
+    return this.request("GET", `/agents${query}`);
+  }
+
+  // Message methods
+  async sendMessage(params: {
+    from_agent?: string;
+    to_agent?: string;
+    to_channel?: string;
+    broadcast?: boolean;
+    type: string;
+    subject: string;
+    body: string;
+    reply_to?: string;
+    priority?: string;
+  }): Promise<{ message_id: string; status: string; created_at: string }> {
+    return this.request("POST", "/messages", params);
+  }
+
+  async getInbox(
+    agentId: string,
+    unreadOnly?: boolean,
+    limit?: number
+  ): Promise<{ messages: Message[]; total: number }> {
+    const params = new URLSearchParams();
+    if (unreadOnly) params.set("unread_only", "true");
+    if (limit) params.set("limit", String(limit));
+    const query = params.toString() ? `?${params}` : "";
+    return this.request("GET", `/messages/inbox/${agentId}${query}`);
+  }
+
+  async markRead(messageId: string): Promise<{ updated: boolean }> {
+    return this.request("PATCH", `/messages/${messageId}/status`, {
+      status: "read",
+    });
+  }
+
+  async reply(
+    messageId: string,
+    fromAgent: string,
+    body: string
+  ): Promise<{ message_id: string }> {
+    // Get original message to find recipient
+    const original = await this.request<Message>("GET", `/messages/${messageId}`);
+
+    return this.request("POST", "/messages", {
+      from_agent: fromAgent,
+      to_agent: original.from_agent,
+      type: "response",
+      subject: `Re: ${original.subject}`,
+      body,
+      reply_to: messageId,
+    });
+  }
+
+  // Channel methods
+  async listChannels(): Promise<{ channels: Channel[]; total: number }> {
+    return this.request("GET", "/channels");
+  }
+
+  async joinChannel(
+    channelName: string,
+    agentId: string
+  ): Promise<{ subscribed: boolean }> {
+    return this.request("POST", `/channels/${channelName}/subscribe`, {
+      agent_id: agentId,
+    });
+  }
+
+  async leaveChannel(
+    channelName: string,
+    agentId: string
+  ): Promise<{ unsubscribed: boolean }> {
+    return this.request("DELETE", `/channels/${channelName}/unsubscribe/${agentId}`);
+  }
+
+  // Task completion methods
+  async completeTask(
+    agentId: string,
+    params: {
+      summary: string;
+      outcome: "completed" | "blocked" | "partial" | "needs_review" | "handed_off";
+      files_changed?: string[];
+      time_spent?: string;
+      next_steps?: string;
+    }
+  ): Promise<TaskCompletionResponse> {
+    return this.request("POST", `/agents/${agentId}/complete-task`, params);
+  }
+
+  async getPendingTasks(
+    agentId: string
+  ): Promise<{ tasks: PendingTask[]; total: number }> {
+    return this.request("GET", `/agents/${agentId}/pending-tasks`);
+  }
+
+  async acceptTask(
+    agentId: string,
+    taskId: string
+  ): Promise<{ acknowledged: boolean; task: string; started_at: string }> {
+    return this.request("POST", `/agents/${agentId}/accept-task`, {
+      task_id: taskId,
+    });
+  }
+
+  async declineTask(
+    agentId: string,
+    taskId: string,
+    reason: string
+  ): Promise<{ acknowledged: boolean }> {
+    return this.request("POST", `/agents/${agentId}/decline-task`, {
+      task_id: taskId,
+      reason,
+    });
+  }
+}