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/metrics.ts

View on GitHub
/**
 * metrics.ts — Prometheus 兼容指标(Phase 5b / Phase 3.1)
 * 零依赖实现,内存存储
 *
 * 指标:
 *   - mcp_calls_total{tool_name, status, role} : Counter
 *   - active_sse_connections : Gauge
 *   - message_delivery_total{status} : Counter
 *   - http_requests_total{method, path, status} : Counter
 *   - http_request_duration_ms{method, path} : Histogram (简易)
 *   - db_query_duration_ms{operation} : Histogram (简易)
 *   ──────────────────────────────── Phase 3.1 新增 ────────────────────────────────
 *   - hub_agents_online : Gauge
 *   - hub_messages_total{status} : Gauge
 *   - hub_trust_scores{agent_id} : Gauge
 */

import type { Database as DatabaseType } from "better-sqlite3";

// ─── Counter ─────────────────────────────────────────────

interface CounterMetric {
  _type: "counter";
  value: number;
  labels: Record<string, string>;
}

const counters: CounterMetric[] = [];

function getOrCreateCounter(name: string, labels: Record<string, string>): CounterMetric {
  for (const c of counters) {
    if (c.labels._name !== name) continue;
    let match = true;
    for (const k of Object.keys(labels)) {
      if (c.labels[k] !== labels[k]) { match = false; break; }
    }
    if (match) return c;
  }
  const c: CounterMetric = { _type: "counter", value: 0, labels: { _name: name, ...labels } };
  counters.push(c);
  return c;
}

export function incrementCounter(name: string, labels: Record<string, string> = {}, value = 1): void {
  const c = getOrCreateCounter(name, labels);
  c.value += value;
}

// ─── Gauge ───────────────────────────────────────────────

const gauges: Record<string, number> = {};

export function setGauge(name: string, value: number): void {
  gauges[name] = value;
}

export function incrementGauge(name: string, value = 1): void {
  gauges[name] = (gauges[name] ?? 0) + value;
}

export function decrementGauge(name: string, value = 1): void {
  gauges[name] = (gauges[name] ?? 0) - value;
}

// ─── Histogram(简易分桶)─────────────────────────────────

interface HistogramMetric {
  _type: "histogram";
  _sum: number;
  _count: number;
  _min: number;
  _max: number;
  buckets: Record<string, number>;
  labels: Record<string, string>;
}

const histograms: HistogramMetric[] = [];
const HISTOGRAM_BUCKETS = [5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000];

function getOrCreateHistogram(name: string, labels: Record<string, string>): HistogramMetric {
  for (const h of histograms) {
    if (h.labels._name !== name) continue;
    let match = true;
    for (const k of Object.keys(labels)) {
      if (h.labels[k] !== labels[k]) { match = false; break; }
    }
    if (match) return h;
  }
  const h: HistogramMetric = {
    _type: "histogram",
    _sum: 0, _count: 0, _min: Infinity, _max: 0,
    buckets: {},
    labels: { _name: name, ...labels },
  };
  for (const b of HISTOGRAM_BUCKETS) h.buckets[String(b)] = 0;
  h.buckets["+Inf"] = 0;
  histograms.push(h);
  return h;
}

export function observeHistogram(name: string, valueMs: number, labels: Record<string, string> = {}): void {
  const h = getOrCreateHistogram(name, labels);
  h._sum += valueMs;
  h._count += 1;
  if (valueMs < h._min) h._min = valueMs;
  if (valueMs > h._max) h._max = valueMs;
  for (const b of HISTOGRAM_BUCKETS) {
    if (valueMs <= b) h.buckets[String(b)]++;
  }
  h.buckets["+Inf"]++;
}

// ─── Prometheus 文本输出 ─────────────────────────────────

function escapeLabelValue(s: string): string {
  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n");
}

function formatLabels(labels: Record<string, string>): string {
  const entries = Object.entries(labels)
    .filter(([k]) => k !== "_name")
    .map(([k, v]) => `${k}="${escapeLabelValue(v)}"`);
  return entries.length > 0 ? `{${entries.join(",")}}` : "";
}

export function getMetricsOutput(): string {
  const lines: string[] = [];

  // 声明所有已知指标类型(即使无数据也输出 # TYPE,便于 Prometheus 发现)
  const declaredTypes: Record<string, string> = {
    mcp_calls_total: "counter",
    active_sse_connections: "gauge",
    message_delivery_total: "counter",
    http_requests_total: "counter",
    http_request_duration_ms: "histogram",
    db_query_duration_ms: "histogram",
    // Phase 3.1: Hub 数据库指标
    hub_agents_online: "gauge",
    hub_messages_total: "gauge",
    hub_trust_scores: "gauge",
  };

  const seenTypes = new Set<string>();

  // Counters
  for (const c of counters) {
    const name = c.labels._name;
    seenTypes.add(name);
    const lbl = formatLabels(c.labels);
    lines.push(`# TYPE ${name} counter`);
    lines.push(`${name}${lbl} ${c.value}`);
  }

  // Gauges
  for (const [name, value] of Object.entries(gauges)) {
    seenTypes.add(name);
    lines.push(`# TYPE ${name} gauge`);
    lines.push(`${name} ${value}`);
  }

  // Histograms
  for (const h of histograms) {
    const name = h.labels._name;
    seenTypes.add(name);
    const lbl = formatLabels(h.labels);
    lines.push(`# TYPE ${name} histogram`);
    // _sum, _count
    lines.push(`${name}_sum${lbl} ${Math.round(h._sum * 100) / 100}`);
    lines.push(`${name}_count${lbl} ${h._count}`);
    // _bucket
    for (const b of HISTOGRAM_BUCKETS) {
      lines.push(`${name}_bucket{le="${b}"${lbl ? ", " + lbl.slice(1, -1) : ""}} ${h.buckets[String(b)] ?? 0}`);
    }
    lines.push(`${name}_bucket{le="+Inf"${lbl ? ", " + lbl.slice(1, -1) : ""}} ${h.buckets["+Inf"] ?? 0}`);
  }

  // 声明尚未有数据的指标类型
  for (const [name, type] of Object.entries(declaredTypes)) {
    if (!seenTypes.has(name)) {
      lines.push(`# TYPE ${name} ${type}`);
      if (type === "counter" || type === "gauge") {
        lines.push(`${name} 0`);
      }
    }
  }

  return lines.join("\n") + "\n";
}

// ─── 便捷函数(供 tools.ts / server.ts 埋点用) ───────────

export function incrementMcpCall(toolName: string, status: "success" | "error" | "denied", role: string): void {
  incrementCounter("mcp_calls_total", { tool_name: toolName, status, role });
}

export function trackHttpRequest(method: string, path: string, statusCode: number, durationMs: number): void {
  incrementCounter("http_requests_total", { method, path: simplifyPath(path), status: String(statusCode) });
  observeHistogram("http_request_duration_ms", durationMs, { method, path: simplifyPath(path) });
}

export function trackDbQuery(operation: string, durationMs: number): void {
  observeHistogram("db_query_duration_ms", durationMs, { operation });
}

function simplifyPath(path: string): string {
  // /api/tasks/abc123 → /api/tasks/:id
  return path.replace(/\/[a-f0-9-]{8,}/g, "/:id").replace(/\/\d+/g, "/:id");
}

// ─── Phase 3.1: Hub 数据库指标采集 ────────────────────────────────────────

/**
 * 从 SQLite 数据库采集 Hub 层指标,返回 Prometheus 文本格式字符串。
 * 由 server.ts 在 /metrics 路由中调用。
 */
export function collectHubMetrics(db: DatabaseType): string {
  const lines: string[] = [];

  // 1. hub_agents_online — 在线 Agent 数量
  try {
    const row = db.prepare(
      `SELECT COUNT(*) as cnt FROM agents WHERE status = 'online'`
    ).get() as { cnt: number };
    lines.push(`# TYPE hub_agents_online gauge`);
    lines.push(`# HELP hub_agents_online Number of agents currently online`);
    lines.push(`hub_agents_online ${row.cnt}`);
  } catch (e) {
    lines.push(`# TYPE hub_agents_online gauge`);
    lines.push(`hub_agents_online 0`);
  }

  // 2. hub_messages_total — 消息总数(按 status 分类)
  try {
    const rows = db.prepare(
      `SELECT status, COUNT(*) as cnt FROM messages GROUP BY status`
    ).all() as { status: string; cnt: number }[];
    lines.push(`# TYPE hub_messages_total gauge`);
    lines.push(`# HELP hub_messages_total Total messages by delivery status`);
    for (const r of rows) {
      lines.push(`hub_messages_total{status="${escapeLabelValue(r.status)}"} ${r.cnt}`);
    }
  } catch (e) {
    lines.push(`# TYPE hub_messages_total gauge`);
    lines.push(`hub_messages_total{status="unknown"} 0`);
  }

  // 3. hub_trust_scores — 各 Agent 的 trust_score
  try {
    const rows = db.prepare(
      `SELECT agent_id, trust_score FROM agents`
    ).all() as { agent_id: string; trust_score: number }[];
    lines.push(`# TYPE hub_trust_scores gauge`);
    lines.push(`# HELP hub_trust_scores Trust score per agent (0-100)`);
    for (const r of rows) {
      lines.push(`hub_trust_scores{agent_id="${escapeLabelValue(r.agent_id)}"} ${r.trust_score}`);
    }
  } catch (e) {
    lines.push(`# TYPE hub_trust_scores gauge`);
    lines.push(`hub_trust_scores{agent_id="unknown"} 0`);
  }

  return lines.join("\n") + "\n";
}
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