@annals/agent-mesh 0.13.1 → 0.15.0

package/dist/index.js

@@ -2611,7 +2611,8 @@ var ERROR_HINTS = {
   github_required: "GitHub account required. Visit https://agents.hot/settings to link one.",
   validation_error: "Invalid input. Check your skill.json or command flags.",
   permission_denied: "You don't have permission to modify this skill.",
-  file_too_large: "Package file exceeds the 50MB limit."
+  file_too_large: "Package file exceeds the 50MB limit.",
+  subscription_required: "This is a private agent. Subscribe first: agent-mesh subscribe <author-login>"
 };
 var PlatformClient = class {
   token;
@@ -2942,18 +2943,18 @@ async function asyncChat(opts) {
     }
     throw new Error(msg);
   }
-  const { task_id, status, error_message, error_code } = await res.json();
+  const { request_id, status, error_message, error_code } = await res.json();
   if (status === "failed") {
     throw new Error(`Task failed: ${error_message || error_code}`);
   }
-  process.stderr.write(`${GRAY}[async] task=${task_id.slice(0, 8)}... polling${RESET}`);
+  process.stderr.write(`${GRAY}[async] request=${request_id.slice(0, 8)}... polling${RESET}`);
   const maxWait = 5 * 60 * 1e3;
   const pollInterval = 2e3;
   const startTime = Date.now();
   while (Date.now() - startTime < maxWait) {
     if (opts.signal?.aborted) throw new Error("Aborted");
     await sleep4(pollInterval);
-    const pollRes = await fetch(`${opts.baseUrl}/api/tasks/${task_id}`, {
+    const pollRes = await fetch(`${opts.baseUrl}/api/agents/${opts.agentId}/task-status/${request_id}`, {
       headers: { Authorization: `Bearer ${opts.token}` },
       signal: opts.signal
     });
@@ -2979,7 +2980,7 @@ async function asyncChat(opts) {
   throw new Error("Task timed out waiting for result");
 }
 async function streamChat(opts) {
-  if ((opts.mode ?? "async") === "async") {
+  if (opts.mode === "async") {
     return asyncChat(opts);
   }
   const res = await fetch(`${opts.baseUrl}/api/agents/${opts.agentId}/chat`, {
@@ -3082,7 +3083,7 @@ ${"\x1B[31m"}Error: ${event.errorText}${RESET}
   }
 }
 function registerChatCommand(program2) {
-  program2.command("chat <agent> [message]").description("Chat with an agent through the platform (for debugging)").option("--no-thinking", "Hide thinking/reasoning output").option("--stream", "Force SSE streaming mode (default is async)").option("--base-url <url>", "Platform base URL", DEFAULT_BASE_URL3).action(async (agentInput, inlineMessage, opts) => {
+  program2.command("chat <agent> [message]").description("Chat with an agent through the platform (for debugging)").option("--no-thinking", "Hide thinking/reasoning output").option("--async", "Use async polling mode (default is stream)").option("--base-url <url>", "Platform base URL", DEFAULT_BASE_URL3).action(async (agentInput, inlineMessage, opts) => {
     const token = loadToken();
     if (!token) {
       log.error("Not authenticated. Run `agent-mesh login` first.");
@@ -3099,7 +3100,7 @@ function registerChatCommand(program2) {
       log.error(err.message);
       process.exit(1);
     }
-    const mode = opts.stream ? "stream" : "async";
+    const mode = opts.async ? "async" : "stream";
     if (inlineMessage) {
       log.info(`Chatting with ${BOLD}${agentName}${RESET} (${mode})`);
       try {
@@ -3807,7 +3808,10 @@ function registerDiscoverCommand(program2) {
       params.set("limit", opts.limit);
       params.set("offset", opts.offset);
       const url = `${BASE_URL}/api/agents/discover?${params}`;
-      const res = await fetch(url);
+      const token = loadToken();
+      const headers = {};
+      if (token) headers["Authorization"] = `Bearer ${token}`;
+      const res = await fetch(url, { headers });
       if (!res.ok) {
         const body = await res.json().catch(() => ({}));
         console.error(`  Error: ${body.message ?? `HTTP ${res.status}`}`);
@@ -3849,6 +3853,9 @@ function registerDiscoverCommand(program2) {
 // src/commands/call.ts
 import { readFileSync, writeFileSync as writeFileSync2 } from "fs";
 var DEFAULT_BASE_URL4 = "https://agents.hot";
+function sleep5(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
 function handleError2(err) {
   if (err instanceof PlatformApiError) {
     log.error(err.message);
@@ -3857,8 +3864,228 @@ function handleError2(err) {
   }
   process.exit(1);
 }
+async function asyncCall(opts) {
+  const selfAgentId = process.env.AGENT_BRIDGE_AGENT_ID;
+  const res = await fetch(`${DEFAULT_BASE_URL4}/api/agents/${opts.id}/call`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${opts.token}`,
+      "Content-Type": "application/json",
+      ...selfAgentId ? { "X-Caller-Agent-Id": selfAgentId } : {}
+    },
+    body: JSON.stringify({ task_description: opts.taskDescription, mode: "async" }),
+    signal: opts.signal
+  });
+  if (!res.ok) {
+    let msg = `HTTP ${res.status}`;
+    let errorCode = "";
+    try {
+      const body = await res.json();
+      errorCode = body.error || "";
+      msg = body.message || body.error || msg;
+    } catch {
+    }
+    if (errorCode === "subscription_required") {
+      log.error("This is a private agent.");
+      console.error(`  Subscribe first: agent-mesh subscribe <author-login>`);
+    } else {
+      log.error(msg);
+    }
+    process.exit(1);
+  }
+  const { request_id, call_id, status, error_message, error_code } = await res.json();
+  if (status === "failed") {
+    log.error(`Call failed: ${error_message || error_code}`);
+    process.exit(1);
+  }
+  if (!opts.json) {
+    process.stderr.write(`${GRAY}[async] call=${call_id.slice(0, 8)}... request=${request_id.slice(0, 8)}... polling${RESET}`);
+  }
+  const pollInterval = 2e3;
+  const startTime = Date.now();
+  while (Date.now() - startTime < opts.timeoutMs) {
+    if (opts.signal?.aborted) {
+      log.error("Aborted");
+      process.exit(1);
+    }
+    await sleep5(pollInterval);
+    const pollRes = await fetch(`${DEFAULT_BASE_URL4}/api/agents/${opts.id}/task-status/${request_id}`, {
+      headers: { Authorization: `Bearer ${opts.token}` },
+      signal: opts.signal
+    });
+    if (!pollRes.ok) {
+      log.error(`Poll failed: HTTP ${pollRes.status}`);
+      process.exit(1);
+    }
+    const task = await pollRes.json();
+    if (task.status === "completed") {
+      if (!opts.json) {
+        process.stderr.write(` done
+`);
+      }
+      const result = task.result || "";
+      if (opts.json) {
+        console.log(JSON.stringify({ call_id, request_id, status: "completed", result }));
+      } else {
+        process.stdout.write(result + "\n");
+      }
+      if (opts.outputFile && result) {
+        writeFileSync2(opts.outputFile, result);
+        if (!opts.json) log.info(`Saved to ${opts.outputFile}`);
+      }
+      return;
+    }
+    if (task.status === "failed") {
+      if (!opts.json) {
+        process.stderr.write(` failed
+`);
+      }
+      log.error(`Call failed: ${task.error_message || task.error_code}`);
+      process.exit(1);
+    }
+    if (!opts.json) {
+      process.stderr.write(".");
+    }
+  }
+  if (!opts.json) {
+    process.stderr.write(` timeout
+`);
+  }
+  log.error("Call timed out waiting for result");
+  process.exit(1);
+}
+async function streamCall(opts) {
+  const selfAgentId = process.env.AGENT_BRIDGE_AGENT_ID;
+  const res = await fetch(`${DEFAULT_BASE_URL4}/api/agents/${opts.id}/call`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${opts.token}`,
+      "Content-Type": "application/json",
+      Accept: "text/event-stream",
+      ...selfAgentId ? { "X-Caller-Agent-Id": selfAgentId } : {}
+    },
+    body: JSON.stringify({ task_description: opts.taskDescription }),
+    signal: opts.signal
+  });
+  if (!res.ok) {
+    let msg = `HTTP ${res.status}`;
+    let errorCode = "";
+    try {
+      const body = await res.json();
+      errorCode = body.error || "";
+      msg = body.message || body.error || msg;
+    } catch {
+    }
+    if (errorCode === "subscription_required") {
+      log.error("This is a private agent.");
+      console.error(`  Subscribe first: agent-mesh subscribe <author-login>`);
+    } else {
+      log.error(msg);
+    }
+    process.exit(1);
+  }
+  const contentType = res.headers.get("Content-Type") || "";
+  if (contentType.includes("application/json")) {
+    const result = await res.json();
+    if (opts.json) {
+      console.log(JSON.stringify(result));
+    } else {
+      console.log("");
+      log.success(`Call created for ${BOLD}${opts.name}${RESET}`);
+      console.log(`  ${GRAY}Call ID${RESET}    ${result.call_id}`);
+      console.log(`  ${GRAY}Status${RESET}     ${result.status}`);
+      console.log(`  ${GRAY}Created${RESET}    ${result.created_at}`);
+      console.log("");
+    }
+    return;
+  }
+  if (!res.body) {
+    log.error("Empty response body");
+    process.exit(1);
+  }
+  if (!opts.json) {
+    log.info(`Calling ${BOLD}${opts.name}${RESET}...`);
+    console.log("");
+  }
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let outputBuffer = "";
+  let inThinkingBlock = false;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    const chunk = decoder.decode(value, { stream: true });
+    const parsed = parseSseChunk(chunk, buffer);
+    buffer = parsed.carry;
+    for (const data of parsed.events) {
+      if (data === "[DONE]") continue;
+      try {
+        const event = JSON.parse(data);
+        if (opts.json) {
+          console.log(JSON.stringify(event));
+        } else {
+          if (event.type === "chunk" && event.delta) {
+            process.stdout.write(event.delta);
+            if (!event.kind || event.kind === "text") {
+              const delta = event.delta;
+              if (delta.startsWith("{") && delta.includes('"type":')) {
+                if (delta.includes('"type":"thinking"') && delta.includes("content_block_start")) {
+                  inThinkingBlock = true;
+                } else if (delta.includes('"type":"text"') && delta.includes("content_block_start")) {
+                  inThinkingBlock = false;
+                }
+              } else if (!inThinkingBlock) {
+                outputBuffer += delta;
+              }
+            }
+          } else if (event.type === "done" && event.attachments?.length) {
+            console.log("");
+            for (const att of event.attachments) {
+              log.info(`  ${GRAY}File:${RESET} ${att.name}  ${GRAY}${att.url}${RESET}`);
+            }
+          } else if (event.type === "error") {
+            process.stderr.write(`
+Error: ${event.message}
+`);
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  if (buffer.trim()) {
+    const parsed = parseSseChunk("\n\n", buffer);
+    for (const data of parsed.events) {
+      if (data === "[DONE]") continue;
+      try {
+        const event = JSON.parse(data);
+        if (opts.json) {
+          console.log(JSON.stringify(event));
+        } else if (event.type === "chunk" && event.delta) {
+          process.stdout.write(event.delta);
+          if (!event.kind || event.kind === "text") {
+            const delta = event.delta;
+            if (!(delta.startsWith("{") && delta.includes('"type":')) && !inThinkingBlock) {
+              outputBuffer += delta;
+            }
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  if (opts.outputFile && outputBuffer) {
+    writeFileSync2(opts.outputFile, outputBuffer);
+    if (!opts.json) log.info(`Saved to ${opts.outputFile}`);
+  }
+  if (!opts.json) {
+    console.log("\n");
+    log.success("Call completed");
+  }
+}
 function registerCallCommand(program2) {
-  program2.command("call <agent>").description("Call an agent on the A2A network").requiredOption("--task <description>", "Task description").option("--input-file <path>", "Read file and append to task description").option("--output-file <path>", "Save response text to file").option("--json", "Output JSONL events").option("--timeout <seconds>", "Timeout in seconds", "300").action(async (agentInput, opts) => {
+  program2.command("call <agent>").description("Call an agent on the A2A network (default: async polling)").requiredOption("--task <description>", "Task description").option("--input-file <path>", "Read file and append to task description").option("--output-file <path>", "Save response text to file").option("--stream", "Use SSE streaming instead of async polling").option("--json", "Output JSONL events").option("--timeout <seconds>", "Timeout in seconds", "300").action(async (agentInput, opts) => {
     try {
       const token = loadToken();
       if (!token) {
@@ -3879,128 +4106,22 @@ ${content}`;
       const timeoutMs = parseInt(opts.timeout || "300", 10) * 1e3;
       const abortController = new AbortController();
       const timer = setTimeout(() => abortController.abort(), timeoutMs);
-      const selfAgentId = process.env.AGENT_BRIDGE_AGENT_ID;
-      const res = await fetch(`${DEFAULT_BASE_URL4}/api/agents/${id}/call`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "Content-Type": "application/json",
-          Accept: "text/event-stream",
-          ...selfAgentId ? { "X-Caller-Agent-Id": selfAgentId } : {}
-        },
-        body: JSON.stringify({ task_description: taskDescription }),
+      const callOpts = {
+        id,
+        name,
+        token,
+        taskDescription,
+        timeoutMs,
+        json: opts.json,
+        outputFile: opts.outputFile,
         signal: abortController.signal
-      });
-      clearTimeout(timer);
-      if (!res.ok) {
-        let msg = `HTTP ${res.status}`;
-        try {
-          const body = await res.json();
-          msg = body.message || body.error || msg;
-        } catch {
-        }
-        log.error(msg);
-        process.exit(1);
-      }
-      const contentType = res.headers.get("Content-Type") || "";
-      if (contentType.includes("application/json")) {
-        const result = await res.json();
-        if (opts.json) {
-          console.log(JSON.stringify(result));
-        } else {
-          console.log("");
-          log.success(`Call created for ${BOLD}${name}${RESET}`);
-          console.log(`  ${GRAY}Call ID${RESET}    ${result.call_id}`);
-          console.log(`  ${GRAY}Status${RESET}     ${result.status}`);
-          console.log(`  ${GRAY}Created${RESET}    ${result.created_at}`);
-          console.log("");
-        }
-        return;
-      }
-      if (!res.body) {
-        log.error("Empty response body");
-        process.exit(1);
-      }
-      if (!opts.json) {
-        log.info(`Calling ${BOLD}${name}${RESET}...`);
-        console.log("");
-      }
-      const reader = res.body.getReader();
-      const decoder = new TextDecoder();
-      let buffer = "";
-      let outputBuffer = "";
-      let inThinkingBlock = false;
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        const chunk = decoder.decode(value, { stream: true });
-        const parsed = parseSseChunk(chunk, buffer);
-        buffer = parsed.carry;
-        for (const data of parsed.events) {
-          if (data === "[DONE]") continue;
-          try {
-            const event = JSON.parse(data);
-            if (opts.json) {
-              console.log(JSON.stringify(event));
-            } else {
-              if (event.type === "chunk" && event.delta) {
-                process.stdout.write(event.delta);
-                if (!event.kind || event.kind === "text") {
-                  const delta = event.delta;
-                  if (delta.startsWith("{") && delta.includes('"type":')) {
-                    if (delta.includes('"type":"thinking"') && delta.includes("content_block_start")) {
-                      inThinkingBlock = true;
-                    } else if (delta.includes('"type":"text"') && delta.includes("content_block_start")) {
-                      inThinkingBlock = false;
-                    }
-                  } else if (!inThinkingBlock) {
-                    outputBuffer += delta;
-                  }
-                }
-              } else if (event.type === "done" && event.attachments?.length) {
-                console.log("");
-                for (const att of event.attachments) {
-                  log.info(`  ${GRAY}File:${RESET} ${att.name}  ${GRAY}${att.url}${RESET}`);
-                }
-              } else if (event.type === "error") {
-                process.stderr.write(`
-Error: ${event.message}
-`);
-              }
-            }
-          } catch {
-          }
-        }
-      }
-      if (buffer.trim()) {
-        const parsed = parseSseChunk("\n\n", buffer);
-        for (const data of parsed.events) {
-          if (data === "[DONE]") continue;
-          try {
-            const event = JSON.parse(data);
-            if (opts.json) {
-              console.log(JSON.stringify(event));
-            } else if (event.type === "chunk" && event.delta) {
-              process.stdout.write(event.delta);
-              if (!event.kind || event.kind === "text") {
-                const delta = event.delta;
-                if (!(delta.startsWith("{") && delta.includes('"type":')) && !inThinkingBlock) {
-                  outputBuffer += delta;
-                }
-              }
-            }
-          } catch {
-          }
-        }
-      }
-      if (opts.outputFile && outputBuffer) {
-        writeFileSync2(opts.outputFile, outputBuffer);
-        if (!opts.json) log.info(`Saved to ${opts.outputFile}`);
-      }
-      if (!opts.json) {
-        console.log("\n");
-        log.success("Call completed");
+      };
+      if (opts.stream) {
+        await streamCall(callOpts);
+      } else {
+        await asyncCall(callOpts);
       }
+      clearTimeout(timer);
     } catch (err) {
       if (err.name === "AbortError") {
         log.error("Call timed out");
@@ -4164,6 +4285,142 @@ function printAgentStats(name, stats) {
   console.log("");
 }
 
+// src/commands/subscribe.ts
+var BASE_URL2 = "https://agents.hot";
+function handleError5(err) {
+  if (err instanceof PlatformApiError) {
+    log.error(err.message);
+  } else {
+    log.error(err.message);
+  }
+  process.exit(1);
+}
+async function resolveAuthorLogin(login) {
+  const res = await fetch(`${BASE_URL2}/api/authors/resolve?login=${encodeURIComponent(login)}`);
+  if (!res.ok) {
+    if (res.status === 404) {
+      throw new PlatformApiError(404, "not_found", `Author not found: ${login}`);
+    }
+    throw new PlatformApiError(res.status, "unknown", `Failed to resolve author: HTTP ${res.status}`);
+  }
+  return res.json();
+}
+function registerSubscribeCommand(program2) {
+  program2.command("subscribe <author-login>").description("Subscribe to an author to access their private agents").action(async (authorLogin) => {
+    try {
+      const client = createClient();
+      const author = await resolveAuthorLogin(authorLogin);
+      await client.post(`/api/authors/${author.id}/subscribe`);
+      log.success(`Subscribed to ${author.github_login}${author.name ? ` (${author.name})` : ""}`);
+    } catch (err) {
+      handleError5(err);
+    }
+  });
+  program2.command("unsubscribe <author-login>").description("Unsubscribe from an author").action(async (authorLogin) => {
+    try {
+      const client = createClient();
+      const author = await resolveAuthorLogin(authorLogin);
+      await client.del(`/api/authors/${author.id}/subscribe`);
+      log.success(`Unsubscribed from ${author.github_login}`);
+    } catch (err) {
+      handleError5(err);
+    }
+  });
+  program2.command("subscriptions").description("List your author subscriptions").option("--json", "Output raw JSON").action(async (opts) => {
+    try {
+      const client = createClient();
+      const data = await client.get("/api/user/subscriptions");
+      if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+      }
+      if (data.subscriptions.length === 0) {
+        console.log("  No subscriptions yet.");
+        return;
+      }
+      const table = renderTable(
+        [
+          { key: "login", label: "AUTHOR", width: 24 },
+          { key: "name", label: "NAME", width: 24 },
+          { key: "since", label: "SINCE", width: 20 }
+        ],
+        data.subscriptions.map((s) => ({
+          login: s.author.github_login,
+          name: s.author.name || `${GRAY}\u2014${RESET}`,
+          since: new Date(s.created_at).toLocaleDateString()
+        }))
+      );
+      console.log(table);
+      console.log(`
+  ${GRAY}${data.subscriptions.length} subscription(s)${RESET}`);
+    } catch (err) {
+      handleError5(err);
+    }
+  });
+}
+
+// src/commands/register.ts
+var DEFAULT_BASE_URL5 = "https://agents.hot";
+var VALID_AGENT_TYPES = ["openclaw", "claude-code", "cursor", "windsurf", "custom"];
+function registerRegisterCommand(program2) {
+  program2.command("register").description("Register a new agent on the platform and get an API key").requiredOption("--name <name>", "Agent name (alphanumeric + hyphens, 3-64 chars)").option("--type <type>", "Agent type", "claude-code").option("--description <text>", "Agent description").option("--capabilities <list>", "Comma-separated capabilities").option("--base-url <url>", "Platform base URL", DEFAULT_BASE_URL5).action(async (opts) => {
+    if (!VALID_AGENT_TYPES.includes(opts.type)) {
+      log.error(`Invalid agent type: ${opts.type}. Must be one of: ${VALID_AGENT_TYPES.join(", ")}`);
+      process.exit(1);
+    }
+    const capabilities = opts.capabilities ? opts.capabilities.split(",").map((c) => c.trim()).filter(Boolean) : [];
+    log.info(`Registering agent ${BOLD}${opts.name}${RESET}...`);
+    let res;
+    try {
+      res = await fetch(`${opts.baseUrl}/api/auth/agent/register`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          agent_name: opts.name,
+          agent_type: opts.type,
+          description: opts.description,
+          capabilities
+        })
+      });
+    } catch (err) {
+      log.error(`Network error: ${err.message}`);
+      process.exit(1);
+    }
+    if (!res.ok) {
+      let msg = `HTTP ${res.status}`;
+      try {
+        const body = await res.json();
+        msg = body.message || body.error || msg;
+      } catch {
+      }
+      log.error(msg);
+      process.exit(1);
+    }
+    const data = await res.json();
+    if (!hasToken()) {
+      saveToken(data.api_key);
+      log.info("Saved API key as platform token (auto-login)");
+    }
+    const slug = uniqueSlug(opts.name);
+    const workspaceDir = getAgentWorkspaceDir(slug);
+    addAgent(slug, {
+      agentId: data.agent_id,
+      agentType: opts.type,
+      bridgeUrl: opts.baseUrl.replace("https://", "wss://").replace("http://", "ws://") + "/ws",
+      projectPath: workspaceDir,
+      addedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    log.success(`Agent registered: ${BOLD}${data.agent_name}${RESET}`);
+    console.log("");
+    console.log(`  Agent ID:  ${data.agent_id}`);
+    console.log(`  API Key:   ${data.api_key}`);
+    console.log(`  Type:      ${data.agent_type}`);
+    console.log(`  Workspace: ${workspaceDir}`);
+    console.log("");
+    console.log(`${GRAY}Next: agent-mesh connect ${slug}${RESET}`);
+  });
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -4190,4 +4447,6 @@ registerDiscoverCommand(program);
 registerCallCommand(program);
 registerConfigCommand(program);
 registerStatsCommand(program);
+registerSubscribeCommand(program);
+registerRegisterCommand(program);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@annals/agent-mesh",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "description": "CLI bridge connecting local AI agents to the Agents.Hot platform",
   "type": "module",
   "bin": {