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/security.d.ts

View on GitHub
import type { Request, Response, NextFunction } from "express";
declare global {
    namespace Express {
        interface Request {
            auth?: {
                agent?: AuthContext | undefined;
            };
        }
    }
}
export type AgentRole = "admin" | "member" | "group_admin";
export interface AuthContext {
    agentId: string;
    role: AgentRole;
}
/** SHA-256 哈希 */
export declare function sha256(input: string): string;
/** 生成明文 Token(一次性返回) */
export declare function generateToken(): string;
/** 验证 Token 并返回 AuthContext,失败返回 null */
export declare function verifyToken(plainToken: string): AuthContext | null;
export declare function rateLimiter(agentId: string): boolean;
/** 工具访问级别 */
type PermissionLevel = "public" | "member" | "admin";
export declare const TOOL_PERMISSIONS: Record<string, PermissionLevel>;
/**
 * 检查工具调用权限
 * group_admin 权限等同于 member(仅任务相关工具),其余 admin 工具不可用
 * @returns true=允许, false=拒绝
 */
export declare function checkPermission(toolName: string, role: AgentRole): boolean;
/**
 * 获取权限级别(用于返回错误信息)
 */
export declare function getRequiredPermission(toolName: string): PermissionLevel | undefined;
/**
 * 强制认证中间件 — 所有 API/MCP 端点使用
 * 无有效 Token → 401
 */
export declare function authMiddleware(req: Request, res: Response, next: NextFunction): void;
/**
 * 可选认证中间件 — SSE 端点使用
 * 有 Token 则验证,无 Token 则 auth = undefined
 * ⚠️ 关键:未认证时 auth 必须为 undefined,不能创建默认 authContext
 */
export declare function optionalAuthMiddleware(req: Request, res: Response, next: NextFunction): void;
/**
 * 生成邀请码(明文)
 * @returns 明文邀请码
 */
export declare function generateInviteCode(): string;
/**
 * 创建邀请码记录
 * @returns 明文邀请码(唯一一次可见)
 */
export declare function createInviteCode(role?: "admin" | "member"): string;
/**
 * 验证邀请码并标记已使用
 * @returns 有效邀请码的角色,或 null
 */
export declare function verifyInviteCode(plainCode: string): "admin" | "member" | null;
/**
 * 标记邀请码已使用
 */
export declare function markInviteCodeUsed(plainCode: string): void;
/**
 * 吊销 API Token
 */
export declare function revokeToken(tokenId: string): boolean;
/**
 * 记录审计日志(带哈希链)
 * 每条记录包含 prev_hash 和 record_hash,形成不可篡改链
 */
export declare function auditLog(action: string, agentId: string | null, target?: string, details?: string): void;
/**
 * 验证审计日志哈希链完整性
 * @returns { valid, total, checked, firstBreak } — valid=true 表示链完整
 */
export declare function verifyAuditChain(): {
    valid: boolean;
    total: number;
    checked: number;
    firstBreak?: {
        id: string;
        action: string;
        expected: string;
        actual: string;
    };
};
/**
 * 重新计算 Agent 信任评分
 *
 * 公式:
 *   base = 50
 *   + verified_capabilities × 3
 *   + auto_approved_strategies × 2
 *   + positive_feedback × 1
 *   - negative_feedback × 2
 *   - rejected_applications × 3
 *   - revoked_token_count × 10
 *   → clamp(0, 100)
 *
 * @returns 计算后的信任分数
 */
export declare function recalculateTrustScore(agentId: string): number;
/**
 * 重新计算所有 Agent 的信任评分
 * @returns { agent_id, score } 数组
 */
export declare function recalculateAllTrustScores(): Array<{
    agent_id: string;
    score: number;
}>;
/**
 * 检查路径是否安全(防止路径遍历)
 */
export declare function sanitizePath(inputPath: string): boolean;
export {};
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