Skip to content

LeoYeAI/agent-master-skills / skills/agent-comm-hub

agent-comm-hub

Flagged

多智能体协同通信基础设施——基于 MCP+SSE 的实时消息、任务调度、记忆共享与进化引擎。支持 WorkBuddy、Hermes、QClaw 及任意 MCP 兼容 Agent 接入。53 个 MCP 工具、4 级权限、零外部依赖 Python SDK。触发词:agent通信、智能体通信、hub通信、多智能体、跨agent通信、任务调度、assign_task、send_message、hermes通信、workbuddy通信、agent hub、通信hub、mcp通信、记忆共享、进化引擎、策略共享、经验分享、共享记忆,共同进化

FileKindSize
.clawhub/origin.jsonconfig146 B
API_REFERENCE.mdmarkdown18.4 KB
HERMES-SETUP.mdmarkdown5.5 KB
README.mdmarkdown8.8 KB
SKILL.mdskill md16.4 KB
_meta.jsonconfig133 B
client-sdk/agent-client.d.tsscript11.6 KB
client-sdk/agent-client.jsscript28.6 KB
client-sdk/agent-client.tsscript29.8 KB
client-sdk/hermes-integration.d.tsscript785 B
client-sdk/hermes-integration.jsscript6.3 KB
client-sdk/hermes-integration.tsscript6.1 KB
client-sdk/hub_client.pyscript50.8 KB
client-sdk/workbuddy-integration.d.tsscript11 B
client-sdk/workbuddy-integration.jsscript4.3 KB
client-sdk/workbuddy-integration.tsscript4.2 KB
deploy/docker-compose.ymlconfig2.0 KB
deploy/grafana/dashboard.jsonconfig16.4 KB
deploy/grafana/provisioning/dashboards/dashboards.ymlconfig258 B
deploy/grafana/provisioning/datasources/prometheus.ymlconfig186 B
deploy/prometheus.ymlconfig408 B
docs/advanced-orchestration-guide.mdmarkdown11.8 KB
docs/evolution-engine-guide.mdmarkdown16.6 KB
docs/hermes-integration-guide.mdmarkdown22.3 KB
package-lock.jsonmanifest139.0 KB
package.jsonmanifest861 B
scripts/hub_task_runner.pyscript6.0 KB
scripts/hub_watcher.pyscript13.9 KB
scripts/install.shscript549 B
scripts/migrate_evolution_db.pyscript6.5 KB
scripts/migrate_from_agent.jsscript2.5 KB
scripts/wb_task_trigger.pyscript2.2 KB
src/db.d.tsscript3.7 KB
src/db.jsscript34.0 KB
src/db.tsscript37.4 KB
src/dedup.d.tsscript2.4 KB
src/dedup.jsscript8.5 KB
src/dedup.tsscript8.7 KB
src/errors.tsscript3.4 KB
src/evolution.d.tsscript6.6 KB
src/evolution.jsscript26.4 KB
src/evolution.tsscript31.0 KB
src/identity.d.tsscript3.4 KB
src/identity.jsscript15.9 KB
src/identity.tsscript17.1 KB
src/logger.d.tsscript1.1 KB
src/logger.jsscript2.8 KB
src/logger.tsscript3.5 KB
src/memory.d.tsscript2.1 KB
src/memory.jsscript13.0 KB
src/memory.tsscript14.3 KB
src/metrics.d.tsscript1.8 KB
src/metrics.jsscript8.4 KB
src/metrics.tsscript9.1 KB
src/orchestrator.d.tsscript6.1 KB
src/orchestrator.jsscript30.4 KB
src/orchestrator.tsscript33.4 KB
src/repo/interfaces.d.tsscript3.6 KB
src/repo/interfaces.jsscript49 B
src/repo/interfaces.tsscript4.2 KB
src/repo/sqlite-impl.d.tsscript225 B
src/repo/sqlite-impl.jsscript7.7 KB
src/repo/sqlite-impl.tsscript8.8 KB
src/repo/types.d.tsscript1021 B
src/repo/types.jsscript116 B
src/repo/types.tsscript1.6 KB
src/security.d.tsscript3.7 KB
src/security.jsscript15.0 KB
src/security.tsscript16.4 KB
src/server.d.tsscript11 B
src/server.jsscript24.7 KB
src/server.tsscript24.7 KB
src/sse.d.tsscript1.6 KB
src/sse.jsscript3.3 KB
src/sse.tsscript3.6 KB
src/stdio.d.tsscript11 B
src/stdio.jsscript1.7 KB
src/stdio.tsscript1.6 KB
src/tokenizer.d.tsscript1.3 KB
src/tokenizer.jsscript3.4 KB
src/tokenizer.tsscript3.2 KB
src/tools.d.tsscript474 B
src/tools.jsscript1.1 KB
src/tools.tsscript1.3 KB
src/tools/consumed.d.tsscript361 B
src/tools/consumed.jsscript5.5 KB
src/tools/consumed.tsscript5.3 KB
src/tools/evolution.d.tsscript660 B
src/tools/evolution.jsscript19.3 KB
src/tools/evolution.tsscript17.6 KB
src/tools/file.d.tsscript348 B
src/tools/file.jsscript7.1 KB
src/tools/file.tsscript6.5 KB
src/tools/identity.d.tsscript438 B
src/tools/identity.jsscript9.8 KB
src/tools/identity.tsscript9.3 KB
src/tools/memory.d.tsscript410 B
src/tools/memory.jsscript11.9 KB
src/tools/memory.tsscript10.8 KB
src/tools/message.d.tsscript467 B
src/tools/message.jsscript17.2 KB
src/tools/message.tsscript15.8 KB
src/tools/orchestrator.d.tsscript746 B
src/tools/orchestrator.jsscript27.8 KB
src/tools/orchestrator.tsscript24.3 KB
src/tools/security.d.tsscript386 B
src/tools/security.jsscript9.0 KB
src/tools/security.tsscript7.8 KB
src/types.tsscript5.9 KB
src/utils.d.tsscript421 B
src/utils.jsscript1.3 KB
src/utils.tsscript3.0 KB
tsconfig.jsonconfig337 B
vitest.config.tsscript1.2 KB

client-sdk/hermes-integration.ts

View on GitHub
/**
 * hermes-integration.ts
 * Hermes 侧接入示例
 *
 * Hermes 需要做的配置(3步,10分钟完成):
 *
 * 步骤 1:安装依赖
 *   npm install eventsource
 *
 * 步骤 2:在 Hermes 的启动脚本/入口文件中引入本文件
 *   import "./hermes-integration.js";
 *
 * 步骤 3:设置环境变量
 *   export HUB_URL=http://localhost:3100  (Hub 服务器地址)
 *   export HERMES_ID=hermes               (本 Agent 的唯一 ID,可自定义)
 *
 * 完成!Hermes 启动后会自动:
 *  - 连接 Hub 的 SSE 端点
 *  - 接收 WorkBuddy 分配的任务并自主执行
 *  - 汇报执行进度和结果
 *  - 断线后自动重连
 */
import { AgentClient } from "../client-sdk/agent-client.js";

const HERMES_ID = process.env.HERMES_ID ?? "hermes";
const HUB_URL   = process.env.HUB_URL   ?? "http://localhost:3100";

// ─── 1. 创建 Hermes 客户端 ─────────────────────────────
const hermes = new AgentClient({
  agentId: HERMES_ID,
  hubUrl:  HUB_URL,

  // ╔══════════════════════════════════════════════════╗
  // ║  核心:收到任务时自主执行,无需人工干预              ║
  // ╚══════════════════════════════════════════════════╝
  onTaskAssigned: async (task) => {
    console.log(`\n[Hermes] 📋 收到来自 ${task.assigned_by} 的任务`);
    console.log(`  任务ID:  ${task.id}`);
    console.log(`  优先级: ${task.priority}`);
    console.log(`  描述:    ${task.description}`);
    if (task.context) console.log(`  上下文: ${task.context}`);

    // ── 第一步:立刻回报"已接收,开始执行" ─────────────
    await hermes.updateTaskStatus(task.id, "in_progress", undefined, 5);

    try {
      // ── 第二步:调用 Hermes 自己的执行能力 ────────────
      // 在这里对接你的 Hermes Agent 核心逻辑
      // 可以是:LLM 调用、工具调用、文件操作、数据处理等
      const result = await executeHermesTask(task);

      // ── 第三步:汇报完成 ────────────────────────────
      await hermes.updateTaskStatus(task.id, "completed", result, 100);
      console.log(`[Hermes] ✅ 任务 ${task.id} 已完成`);

    } catch (err: any) {
      await hermes.updateTaskStatus(task.id, "failed", `执行错误: ${err.message}`, 0);
      console.error(`[Hermes] ❌ 任务 ${task.id} 失败:`, err.message);
    }
  },

  // ── 收到普通消息 ───────────────────────────────────
  onMessage: async (msg) => {
    console.log(`\n[Hermes] 💬 来自 ${msg.from_agent}: ${msg.content}`);

    // 处理不同类型的消息
    if (msg.type === "ack") {
      console.log(`[Hermes] 收到确认消息,无需回复`);
      return;
    }

    // 普通消息,可触发 Hermes 的对话能力
    await handleHermesMessage(msg);
  },

  // ── 收到任务进度更新(自己委托给别人的任务)────────────
  onTaskUpdated: async (upd) => {
    const icon = upd.status === "completed" ? "✅" : upd.status === "failed" ? "❌" : "⏳";
    console.log(`\n[Hermes] ${icon} 委托任务进度: ${upd.task_id}`);
    console.log(`  状态: ${upd.status}  进度: ${upd.progress}%`);
    if (upd.result) {
      console.log(`  结果: ${upd.result}`);
      // 可以在这里把 WorkBuddy 的执行结果进一步处理
      await processTaskResult(upd.task_id, upd.result);
    }
  },
});

// ─── 2. 启动 Hermes 客户端 ─────────────────────────────
hermes.start();
console.log(`[Hermes] 已启动,Agent ID: ${HERMES_ID}`);
console.log(`[Hermes] 正在连接 Hub: ${HUB_URL}`);

// ─── 任务执行核心逻辑(对接你的 Hermes 业务代码)──────────
async function executeHermesTask(task: any): Promise<string> {
  const { description, context, id } = task;

  // ── 中途汇报进度示例 ───────────────────────────────
  await hermes.updateTaskStatus(id, "in_progress", "正在收集数据...", 20);

  // TODO: 在这里对接 Hermes 的实际能力:
  //  - 调用 LLM(如 Claude API)
  //  - 执行 MCP 工具(WebSearch、文件读写等)
  //  - 访问数据库或外部 API
  //  - 运行 Python 脚本等

  // 示例:模拟分阶段执行
  await new Promise(r => setTimeout(r, 1500));
  await hermes.updateTaskStatus(id, "in_progress", "正在分析处理...", 60);

  await new Promise(r => setTimeout(r, 1500));
  await hermes.updateTaskStatus(id, "in_progress", "正在生成报告...", 90);

  await new Promise(r => setTimeout(r, 500));

  // 返回结构化结果
  return JSON.stringify({
    summary:  `Hermes 完成了任务:${description.slice(0, 80)}`,
    data:     { processed: true, context },
    timestamp: new Date().toISOString(),
  }, null, 2);
}

// ─── 消息处理逻辑 ──────────────────────────────────────
async function handleHermesMessage(msg: any): Promise<void> {
  // TODO: 根据业务需求处理消息
  // 示例:简单回复
  if (msg.content.includes("你好")) {
    await hermes.sendMessage(msg.from_agent, "你好!Hermes 在线,随时待命。");
  }
}

// ─── 处理收到的任务结果 ────────────────────────────────
async function processTaskResult(taskId: string, result: string): Promise<void> {
  // TODO: 处理 WorkBuddy 返回的结果
  console.log(`[Hermes] 处理任务 ${taskId} 的结果...`);
}

// ─── 导出实例(供其他模块使用)──────────────────────────
export { hermes };
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall