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

src/tools/memory.ts

View on GitHub
/**
 * memory.ts — MCP 工具:记忆存储模块
 * 包含:store_memory, recall_memory, list_memories, delete_memory, search_memories
 * 来源:tools.ts 第 665-849 + 2253-2317 行
 */
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
import {
  storeMemory as storeMemoryFromService,
  recallMemory,
  listMemories,
  deleteMemory as deleteMemoryFromService,
} from "../memory.js";
import { auditLog, type AuthContext } from "../security.js";
import { requireAuth, mcpFail, mcpError } from "../utils.js";

export function registerMemoryTools(server: McpServer, authContext?: AuthContext): void {

  // ────────────────────────────────────────────────────
  // Tool 14: store_memory (Phase 1 Week 2)
  // 存储记忆 — member 及以上
  // ────────────────────────────────────────────────────
  server.tool(
    "store_memory",
    "存储一条记忆到 Hub。支持 private(仅自己可见)、group(组内可见)、collective(全局可见)三种范围。存储后可通过 recall_memory 全文搜索召回。",
    {
      content: z.string().describe("记忆内容(最多 10000 字符)"),
      title:   z.string().optional().describe("记忆标题(最多 500 字符)"),
      scope:   z.enum(["private", "group", "collective"]).optional()
                .default("private").describe("可见范围"),
      tags:    z.array(z.string()).optional().describe("标签列表,如 ['work', 'important']"),
      source_task_id: z.string().optional().describe("关联任务 ID(用于溯源追踪)"),
    },
    async ({ content, title, scope, tags, source_task_id }) => {
      const ctx = requireAuth(authContext, "store_memory");

      // Phase 2 Day 4: collective/group 写入自动记录 source_agent_id
      const sourceAgentId = scope === "collective" || scope === "group" ? ctx.agentId : undefined;

      const result = storeMemoryFromService(ctx.agentId, content, {
        title,
        scope,
        tags,
        source_agent_id: sourceAgentId,
        source_task_id,
      });

      if (!result.ok) {
        return mcpFail(result.error, "store_memory");
      }

      auditLog("tool_store_memory", ctx.agentId, result.memory.id,
        `scope=${scope}, source_agent=${sourceAgentId ?? "none"}, task=${source_task_id ?? "none"}, tags=${tags ? JSON.stringify(tags) : "none"}`);

      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            success:   true,
            memory_id: result.memory.id,
            scope:     result.memory.scope,
            source_agent_id: result.memory.source_agent_id,
            source_task_id:  result.memory.source_task_id,
            note:      scope === "collective"
              ? "🌐 全局记忆已存储,所有 Agent 可搜索到(已记录写入者溯源)"
              : scope === "group"
                ? "👥 组内记忆已存储,组内 Agent 可搜索到(已记录写入者溯源)"
                : "🔒 私有记忆已存储,仅自己可见",
          }, null, 2),
        }],
      };
    }
  );

  // ────────────────────────────────────────────────────
  // Tool 15: recall_memory (Phase 1 Week 2)
  // 全文搜索召回记忆 — member 及以上
  // ────────────────────────────────────────────────────
  server.tool(
    "recall_memory",
    "通过关键词全文搜索召回记忆。搜索范围包括自己的私有记忆、组内共享记忆和全局记忆。使用 FTS5 引擎,支持多关键词、短语搜索。",
    {
      query: z.string().describe("搜索关键词(如 'Agent 通信协议 错误修复')"),
      scope: z.enum(["private", "group", "collective", "all"]).optional()
             .default("all").describe("搜索范围"),
      limit: z.number().min(1).max(50).optional().default(10)
             .describe("最大返回数量"),
    },
    async ({ query, scope, limit }) => {
      const ctx = requireAuth(authContext, "recall_memory");

      const results = recallMemory(query, ctx.agentId, { scope, limit });

      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            query,
            scope,
            results: results.map(m => ({
              id:                m.id,
              title:             m.title,
              content:           m.content,
              scope:             m.scope,
              tags:              m.tags ? JSON.parse(m.tags) : [],
              agent_id:          m.agent_id,
              source_agent_id:   m.source_agent_id,
              source_task_id:    m.source_task_id,
              source_trust_score: (m as any).source_trust_score ?? null,
              created_at:        m.created_at,
            })),
            count: results.length,
            queried_by: ctx.agentId,
          }, null, 2),
        }],
      };
    }
  );

  // ────────────────────────────────────────────────────
  // Tool 16: list_memories (Phase 1 Week 2)
  // 列出记忆 — member 及以上
  // ────────────────────────────────────────────────────
  server.tool(
    "list_memories",
    "列出可访问的记忆列表。按创建时间倒序排列。可按 scope 筛选。",
    {
      scope:  z.enum(["private", "group", "collective", "all"]).optional()
              .default("all").describe("可见范围筛选"),
      limit:  z.number().min(1).max(50).optional().default(20)
              .describe("最大返回数量"),
      offset: z.number().min(0).optional().default(0)
              .describe("分页偏移量"),
    },
    async ({ scope, limit, offset }) => {
      const ctx = requireAuth(authContext, "list_memories");

      const results = listMemories(ctx.agentId, { scope, limit, offset });

      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            memories: results.map(m => ({
              id:                m.id,
              title:             m.title,
              content:           m.content,
              scope:             m.scope,
              tags:              m.tags ? JSON.parse(m.tags) : [],
              agent_id:          m.agent_id,
              source_agent_id:   m.source_agent_id,
              source_task_id:    m.source_task_id,
              source_trust_score: (m as any).source_trust_score ?? null,
              created_at:        m.created_at,
              updated_at:        m.updated_at,
            })),
            count: results.length,
            queried_by: ctx.agentId,
          }, null, 2),
        }],
      };
    }
  );

  // ────────────────────────────────────────────────────
  // Tool 17: delete_memory (Phase 1 Week 2)
  // 删除记忆 — 仅限自己(admin 可删除任何)
  // ────────────────────────────────────────────────────
  server.tool(
    "delete_memory",
    "删除一条记忆。仅能删除自己的私有记忆(admin 可删除任何记忆)。",
    {
      memory_id: z.string().describe("要删除的记忆 ID"),
    },
    async ({ memory_id }) => {
      const ctx = requireAuth(authContext, "delete_memory");

      const result = deleteMemoryFromService(memory_id, ctx.agentId, ctx.role);

      if (!result.ok) {
        return mcpFail(result.error, "delete_memory");
      }

      auditLog("tool_delete_memory", ctx.agentId, memory_id);

      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            success:    true,
            memory_id,
            note:       "记忆已永久删除",
          }, null, 2),
        }],
      };
    }
  );

  // ────────────────────────────────────────────────────
  // Tool S2: search_memories — member 及以上
  // ────────────────────────────────────────────────────
  server.tool(
    "search_memories",
    "全文搜索记忆内容。使用 FTS5 引擎,支持多关键词、短语搜索。可按可见范围和标签筛选。",
    {
      query: z.string().describe("搜索关键词(如 '通信协议 错误修复')"),
      scope: z.enum(["private", "group", "collective", "all"]).optional()
             .default("all").describe("可见范围筛选"),
      tags:  z.array(z.string()).optional().describe("标签筛选(如 ['work', 'important'])"),
      limit: z.number().min(1).max(50).optional().default(10).describe("最大返回数量"),
    },
    async ({ query, scope, tags, limit }) => {
      const ctx = requireAuth(authContext, "search_memories");

      try {
        // 复用已有的 recallMemory(FTS5 引擎)
        let results = recallMemory(query, ctx.agentId, { scope, limit });

        // 按 tags 过滤(recallMemory 不直接支持 tags 参数)
        if (tags && tags.length > 0) {
          results = results.filter(m => {
            if (!m.tags) return false;
            try {
              const parsedTags: string[] = JSON.parse(m.tags);
              return tags.some(t => parsedTags.includes(t));
            } catch {
              return false;
            }
          });
        }

        return {
          content: [{
            type: "text",
            text: JSON.stringify({
              query,
              scope,
              tags:  tags ?? null,
              memories: results.map(m => ({
                id:                m.id,
                title:             m.title,
                content:           m.content,
                scope:             m.scope,
                tags:              m.tags ? JSON.parse(m.tags) : [],
                agent_id:          m.agent_id,
                source_agent_id:   m.source_agent_id,
                source_task_id:    m.source_task_id,
                source_trust_score: (m as any).source_trust_score ?? null,
                created_at:        m.created_at,
              })),
              count:      results.length,
              queried_by: ctx.agentId,
            }, null, 2),
          }],
        };
      } catch (err: unknown) {
        return mcpError(err, "search_memories");
      }
    }
  );

}
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