agent-comm-hub 0.1.6

package/lib/setup.js

@@ -0,0 +1,168 @@
+// src/setup.ts
+import { copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+var DEFAULT_URL = "http://127.0.0.1:18764/mcp";
+var DEFAULT_SERVER = "agent-hub";
+function defaultSkillSrc() {
+  return join(dirname(fileURLToPath(import.meta.url)), "..", "agents", "SKILL.md");
+}
+function stamp() {
+  const now = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
+async function readJson(file) {
+  if (!existsSync(file)) return null;
+  try {
+    return JSON.parse(await readFile(file, "utf8"));
+  } catch (error) {
+    throw new Error(`cannot parse JSON ${file}: ${error.message}`);
+  }
+}
+async function writeJsonNoBom(file, doc) {
+  await mkdir(dirname(file), { recursive: true });
+  await writeFile(file, JSON.stringify(doc, null, 2) + "\n", "utf8");
+}
+async function backup(file) {
+  const bak = `${file}.bak-${stamp()}`;
+  await copyFile(file, bak);
+  return bak;
+}
+async function mergeJsonServer(file, section, entry, opts) {
+  if (!existsSync(file)) return "skipped";
+  const doc = await readJson(file);
+  if (doc === null) return "skipped";
+  let servers = doc[section];
+  if (servers === void 0 || typeof servers !== "object" || Array.isArray(servers)) {
+    servers = {};
+    doc[section] = servers;
+  }
+  const has = Object.prototype.hasOwnProperty.call(servers, opts.serverName);
+  if (opts.remove) {
+    if (!has) return "absent";
+    delete servers[opts.serverName];
+    await backup(file);
+    await writeJsonNoBom(file, doc);
+    return "removed";
+  }
+  if (has) {
+    const existing = servers[opts.serverName];
+    if (existing?.url === opts.url) return "unchanged";
+  }
+  servers[opts.serverName] = entry;
+  await backup(file);
+  await writeJsonNoBom(file, doc);
+  return "changed";
+}
+async function mergeTomlSection(file, opts) {
+  if (!existsSync(file)) return "skipped";
+  const text = await readFile(file, "utf8");
+  const marker = `[mcp_servers.${opts.serverName}]`;
+  const markerRe = new RegExp(`^\\[mcp_servers\\.${escapeRegExp(opts.serverName)}\\]`, "m");
+  if (opts.remove) {
+    if (!markerRe.test(text)) return "absent";
+    const cleaned = text.replace(new RegExp(`^\\[mcp_servers\\.${escapeRegExp(opts.serverName)}\\][^\\r\\n]*(\\r?\\n(?!\\[).*)*(\\r?\\n)?`, "m"), "");
+    await backup(file);
+    await writeFile(file, cleaned, "utf8");
+    return "removed";
+  }
+  if (markerRe.test(text)) return "unchanged";
+  const block = `
+${marker}
+type = "streamable-http"
+url = "${opts.url}"
+`;
+  await backup(file);
+  await writeFile(file, text.trimEnd() + block, "utf8");
+  return "changed";
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function syncSkill(skillDir, skillSrc, remove, log) {
+  if (remove) {
+    if (existsSync(skillDir)) {
+      await mkdir(dirname(skillDir), { recursive: true });
+      await rmRecursive(skillDir);
+      log(`  skill removed: ${skillDir}`);
+    }
+    return;
+  }
+  if (!existsSync(skillSrc)) {
+    log(`  SKILL.md source missing: ${skillSrc} (skipped)`);
+    return;
+  }
+  await mkdir(skillDir, { recursive: true });
+  await copyFile(skillSrc, join(skillDir, "SKILL.md"));
+  log(`  skill -> ${join(skillDir, "SKILL.md")}`);
+}
+async function rmRecursive(dir) {
+  const { rm } = await import("node:fs/promises");
+  await rm(dir, { recursive: true, force: true });
+}
+async function runSetup(options = {}) {
+  const url = options.url ?? DEFAULT_URL;
+  const serverName = options.serverName ?? DEFAULT_SERVER;
+  const home = options.homeDir ?? homedir();
+  const skillSrc = options.skillSrc ?? defaultSkillSrc();
+  const remove = options.remove === true;
+  const log = options.log ?? ((message) => console.log(message));
+  const summary = { done: [], unchanged: [], skipped: [], errors: [] };
+  const record = (status, label, file) => {
+    if (status === "changed" || status === "removed") summary.done.push(`${label}: ${file}`);
+    else if (status === "unchanged" || status === "absent") summary.unchanged.push(`${label}: ${file}`);
+    else if (status === "skipped") summary.skipped.push(`${label}: ${file}`);
+  };
+  const jsonTargets = [
+    { label: "mcode", file: join(home, ".minimax", "mcp.json"), section: "mcpServers", entry: { url, type: "streamable-http", enabled: true, configured: true, timeout: 12e4, description: "agent-comm-hub: talk to every other agent connected to the hub." } },
+    { label: "mcode", file: join(home, ".minimax", "mcp", "mcp.json"), section: "mcpServers", entry: { url, type: "streamable-http", enabled: true, configured: true, timeout: 12e4, description: "agent-comm-hub: talk to every other agent connected to the hub." } },
+    { label: "opencode", file: join(home, ".config", "opencode", "opencode.json"), section: "mcp", entry: { type: "remote", url, enabled: true } },
+    { label: "kimi-code", file: join(home, ".kimi-code", "mcp.json"), section: "mcpServers", entry: { transport: "http", url, startupTimeoutMs: 3e4, toolTimeoutMs: 12e4 } },
+    { label: "gemini-cli", file: join(home, ".gemini", "settings.json"), section: "mcpServers", entry: { type: "http", url } }
+  ];
+  for (const target of jsonTargets) {
+    try {
+      const status = await mergeJsonServer(target.file, target.section, target.entry, { serverName, url, remove });
+      record(status, target.label, target.file);
+    } catch (error) {
+      summary.errors.push(`${target.label}: ${target.file} \u2014 ${error.message}`);
+      log(`  ${target.label}: SKIPPED \u2014 ${error.message}`);
+    }
+  }
+  const codexFile = join(home, ".codex", "config.toml");
+  try {
+    const status = await mergeTomlSection(codexFile, { serverName, url, remove });
+    record(status, "codex", codexFile);
+  } catch (error) {
+    summary.errors.push(`codex: ${codexFile} \u2014 ${error.message}`);
+    log(`  codex: SKIPPED \u2014 ${error.message}`);
+  }
+  const skillDirs = [
+    join(home, ".agents", "skills", serverName),
+    // cross-agent standard
+    join(home, ".minimax", "skills", serverName),
+    join(home, ".config", "opencode", "skills", serverName),
+    join(home, ".kimi-code", "skills", serverName),
+    join(home, ".gemini", "skills", serverName),
+    join(home, ".codex", "skills", serverName),
+    join(home, ".claude", "skills", serverName)
+    // config is manual; skill still useful
+  ];
+  for (const dir of skillDirs) {
+    try {
+      await syncSkill(dir, skillSrc, remove, log);
+    } catch (error) {
+      summary.errors.push(`skill ${dir} \u2014 ${error.message}`);
+      log(`  skill ${dir}: SKIPPED \u2014 ${error.message}`);
+    }
+  }
+  if (remove) log("done. Manual targets (see agents/README.md): Claude Code (.mcp.json), DSH (cordis.patch.yml).");
+  else log("done. Manual targets (see agents/README.md): Claude Code (.mcp.json), DSH (cordis.patch.yml). Restart agent sessions to pick up the MCP server.");
+  return summary;
+}
+export {
+  runSetup
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "agent-comm-hub",
+  "version": "0.1.6",
+  "description": "Generic multi-peer MCP hub: any MCP-capable agent (MiniMax Code, Claude Code, opencode, Codex, Gemini CLI, DSH, ...) connects to one local streamable-http endpoint and they chat, delegate tasks, and acknowledge in real time",
+  "keywords": [
+    "mcp",
+    "agent",
+    "hub",
+    "multi-agent",
+    "communication",
+    "streamable-http",
+    "cli",
+    "ai"
+  ],
+  "author": "agent-comm-hub contributors",
+  "type": "module",
+  "main": "lib/index.js",
+  "bin": {
+    "agent-comm-hub": "lib/cli.js"
+  },
+  "files": [
+    "lib",
+    "agents",
+    "assets",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=lib/cli.js && esbuild src/index.ts --bundle --platform=node --format=esm --outfile=lib/index.js && esbuild src/setup.ts --bundle --platform=node --format=esm --outfile=lib/setup.js",
+    "build:test": "esbuild test/entry.ts --bundle --platform=node --format=esm --outfile=test/entry.mjs && esbuild test/setup-entry.ts --bundle --platform=node --format=esm --outfile=test/setup-entry.mjs && esbuild test/ops-entry.ts --bundle --platform=node --format=esm --outfile=test/ops-entry.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run build:test && node test/smoke.mjs && node test/setup.mjs && node test/ops.mjs",
+    "pack": "pnpm run build && pnpm pack",
+    "prepublishOnly": "pnpm run test && pnpm run build",
+    "prepare": "pnpm run build"
+  }
+}