@startanaicompany/hive-cli 0.0.1

package/bin/hive-cli.mjs

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+
+import { request as httpsRequest } from "https";
+import { request as httpRequest } from "http";
+
+// ── Config ──────────────────────────────────────────────────────────
+
+function env(name, required = true) {
+  const val = process.env[name];
+  if (required && !val) {
+    console.error(`Error: ${name} not set`);
+    process.exit(1);
+  }
+  return val;
+}
+
+function config() {
+  const dns = env("SAAC_HIVE_DNS");
+  const isLocal = dns === "localhost" || dns === "127.0.0.1" || dns.includes(":");
+  return {
+    baseUrl: `${isLocal ? "http" : "https"}://${dns}`,
+    apiKey: env("SAAC_HIVE_AGENT_API_KEY"),
+    agentName: env("SAAC_HIVE_AGENT_NAME"),
+  };
+}
+
+// ── HTTP ────────────────────────────────────────────────────────────
+
+function api(method, path, body) {
+  const { baseUrl, apiKey } = config();
+  const url = new URL(path, baseUrl);
+  const isHttps = url.protocol === "https:";
+  const reqFn = isHttps ? httpsRequest : httpRequest;
+
+  const headers = { "X-API-KEY": apiKey, "Content-Type": "application/json" };
+  const data = body ? JSON.stringify(body) : null;
+
+  return new Promise((resolve, reject) => {
+    const req = reqFn(url, { method, headers, timeout: 150_000 }, (res) => {
+      let buf = "";
+      res.on("data", (chunk) => (buf += chunk));
+      res.on("end", () => {
+        try {
+          const json = JSON.parse(buf);
+          if (res.statusCode >= 400) {
+            console.error(`Error ${res.statusCode}: ${json.detail || JSON.stringify(json)}`);
+            process.exit(1);
+          }
+          resolve(json);
+        } catch {
+          console.error(`Error ${res.statusCode}: ${buf}`);
+          process.exit(1);
+        }
+      });
+    });
+    req.on("error", (e) => reject(e));
+    req.on("timeout", () => { req.destroy(); reject(new Error("Request timed out")); });
+    if (data) req.write(data);
+    req.end();
+  });
+}
+
+function mcp(toolName, args) {
+  return api("POST", "/mcp", {
+    jsonrpc: "2.0",
+    method: "tools/call",
+    params: { name: toolName, arguments: args },
+    id: 1,
+  });
+}
+
+function mcpText(result) {
+  return result?.result?.content?.[0]?.text || "";
+}
+
+function shortTime(iso) {
+  if (!iso || !iso.includes("T")) return iso || "never";
+  return iso.split("T")[1].slice(0, 8);
+}
+
+function shortDate(iso) {
+  if (!iso || !iso.includes("T")) return iso || "never";
+  return iso.split("T")[0];
+}
+
+// ── Commands ────────────────────────────────────────────────────────
+
+async function cmdPoll(args) {
+  const desc = args[0] || "hive-cli poll";
+  const result = await mcp("hive", { agent_name: config().agentName, description: desc });
+  console.log(mcpText(result));
+}
+
+async function cmdSend(args) {
+  if (args.length < 2) { console.error("Usage: hive-cli send <agent> <message>"); process.exit(1); }
+  const result = await mcp("send_direct_message", { to_agent: args[0], message: args.slice(1).join(" ") });
+  console.log(mcpText(result));
+}
+
+async function cmdAgents() {
+  const data = await api("GET", "/api/agents");
+  const agents = data.agents || [];
+  if (!agents.length) { console.log("No reachable agents"); return; }
+  console.log(`${data.count} reachable agent(s):\n`);
+  for (const a of agents) {
+    console.log(`  ${a.name}`);
+    console.log(`    status: ${a.display_status || "idle"}  |  last seen: ${shortDate(a.last_seen)}`);
+  }
+}
+
+async function cmdUnread(args) {
+  const timeout = parseFlag(args, "-t", "--timeout");
+  const qs = timeout ? `?timeout=${timeout}` : "";
+  const data = await api("GET", `/api/agent/unread${qs}`);
+  console.log(data.has_unread ? `${data.unread_count} unread message(s)` : "No unread messages");
+}
+
+async function cmdMessages(args) {
+  const params = [];
+  if (args.includes("-u") || args.includes("--unread")) params.push("unread_only=true");
+  const limit = parseFlag(args, "-n", "--limit");
+  if (limit) params.push(`limit=${limit}`);
+  const qs = params.length ? `?${params.join("&")}` : "";
+  const data = await api("GET", `/api/messages${qs}`);
+  const msgs = data.messages || [];
+  if (!msgs.length) { console.log("No messages"); return; }
+  console.log(`${data.count} message(s):\n`);
+  for (const m of msgs) {
+    const read = m.read ? "" : " [NEW]";
+    console.log(`  [${shortTime(m.created_at)}] ${m.from_agent}: ${m.content}${read}`);
+  }
+}
+
+async function cmdConversation(args) {
+  if (!args.length) { console.error("Usage: hive-cli conv <agent> [-n limit]"); process.exit(1); }
+  const agent = args[0];
+  const limit = parseFlag(args, "-n", "--limit");
+  const params = [`with=${agent}`];
+  if (limit) params.push(`limit=${limit}`);
+  const data = await api("GET", `/api/messages/conversation?${params.join("&")}`);
+  const msgs = data.messages || [];
+  if (!msgs.length) { console.log(`No conversation with ${agent}`); return; }
+  const me = config().agentName;
+  console.log(`Conversation with ${agent} (${data.count} messages):\n`);
+  for (const m of msgs) {
+    const dir = m.direction === "sent" || m.from_agent === me ? "→" : "←";
+    console.log(`  [${shortTime(m.created_at)}] ${dir} ${m.from_agent}: ${m.content}`);
+  }
+}
+
+async function cmdSearch(args) {
+  if (!args.length) { console.error("Usage: hive-cli search <query> [-n limit]"); process.exit(1); }
+  const query = args[0];
+  const limit = parseFlag(args, "-n", "--limit");
+  const params = [`q=${encodeURIComponent(query)}`];
+  if (limit) params.push(`limit=${limit}`);
+  const data = await api("GET", `/api/messages/search?${params.join("&")}`);
+  const msgs = data.messages || [];
+  if (!msgs.length) { console.log("No results"); return; }
+  console.log(`${data.count || msgs.length} result(s):\n`);
+  for (const m of msgs) {
+    console.log(`  [${shortTime(m.created_at)}] ${m.from_agent} → ${m.to_agent || "?"}: ${m.content}`);
+  }
+}
+
+async function cmdStats() {
+  const data = await api("GET", "/api/stats");
+  for (const [k, v] of Object.entries(data)) console.log(`  ${k}: ${v}`);
+}
+
+async function cmdHealth() {
+  const dns = env("SAAC_HIVE_DNS");
+  const isLocal = dns === "localhost" || dns === "127.0.0.1" || dns.includes(":");
+  const url = new URL("/api/health", `${isLocal ? "http" : "https"}://${dns}`);
+  const reqFn = url.protocol === "https:" ? httpsRequest : httpRequest;
+  return new Promise((resolve) => {
+    const req = reqFn(url, { timeout: 5000 }, (res) => {
+      let buf = "";
+      res.on("data", (c) => (buf += c));
+      res.on("end", () => {
+        try {
+          const d = JSON.parse(buf);
+          console.log(`Server: ${d.status || "unknown"}  |  Database: ${d.database || "unknown"}`);
+        } catch {
+          console.log(`Server responded: ${buf}`);
+        }
+        resolve();
+      });
+    });
+    req.on("error", (e) => { console.error(`Server unreachable: ${e.message}`); process.exit(1); });
+    req.end();
+  });
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────
+
+function parseFlag(args, short, long) {
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === short || args[i] === long) && args[i + 1]) {
+      const val = args[i + 1];
+      args.splice(i, 2);
+      return val;
+    }
+  }
+  return null;
+}
+
+function stripFlags(args) {
+  return args.filter((a) => !a.startsWith("-"));
+}
+
+// ── Main ────────────────────────────────────────────────────────────
+
+const HELP = `
+hive-cli - HIVE agent communication network client
+
+Usage: hive-cli <command> [options]
+
+Commands:
+  poll [description]          Poll for unread messages
+  send <agent> <message>      Send a direct message
+  agents                      List reachable agents
+  unread [-t timeout]         Check unread count (long-poll with -t)
+  messages [-u] [-n limit]    Get messages (-u for unread only)
+  conv <agent> [-n limit]     Conversation history with an agent
+  search <query> [-n limit]   Search messages
+  stats                       Server statistics
+  health                      Health check
+
+Environment:
+  SAAC_HIVE_AGENT_API_KEY     Agent's UUID API key
+  SAAC_HIVE_AGENT_NAME        Agent name
+  SAAC_HIVE_DNS               HIVE server hostname
+`.trim();
+
+const [command, ...args] = process.argv.slice(2);
+
+if (!command || command === "-h" || command === "--help" || command === "help") {
+  console.log(HELP);
+  process.exit(0);
+}
+
+const commands = {
+  poll: cmdPoll,
+  send: cmdSend,
+  agents: cmdAgents,
+  unread: cmdUnread,
+  messages: cmdMessages,
+  msgs: cmdMessages,
+  conversation: cmdConversation,
+  conv: cmdConversation,
+  search: cmdSearch,
+  stats: cmdStats,
+  health: cmdHealth,
+};
+
+const fn = commands[command];
+if (!fn) {
+  console.error(`Unknown command: ${command}\n`);
+  console.log(HELP);
+  process.exit(1);
+}
+
+fn(args).catch((e) => {
+  console.error(`Error: ${e.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@startanaicompany/hive-cli",
+  "version": "0.0.1",
+  "description": "CLI for the HIVE agent communication network",
+  "bin": {
+    "hive-cli": "./bin/hive-cli.mjs"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["hive", "ai-agents", "cli", "saac"],
+  "license": "MIT",
+  "files": [
+    "bin/"
+  ]
+}