@claude-flow/hooks 3.0.0-alpha.1

package/dist/swarm/index.d.ts

@@ -0,0 +1,271 @@
+/**
+ * V3 Swarm Communication Hooks
+ *
+ * Enables agent-to-agent communication, pattern broadcasting,
+ * consensus building, and task handoff coordination.
+ *
+ * @module @claude-flow/hooks/swarm
+ */
+import { EventEmitter } from 'node:events';
+import { type GuidancePattern } from '../reasoningbank/index.js';
+/**
+ * Message between agents
+ */
+export interface SwarmMessage {
+    id: string;
+    from: string;
+    to: string | '*';
+    type: 'context' | 'pattern' | 'handoff' | 'consensus' | 'result' | 'query';
+    content: string;
+    metadata: Record<string, unknown>;
+    timestamp: number;
+    ttl?: number;
+    priority: 'low' | 'normal' | 'high' | 'critical';
+}
+/**
+ * Pattern broadcast entry
+ */
+export interface PatternBroadcast {
+    id: string;
+    sourceAgent: string;
+    pattern: GuidancePattern;
+    broadcastTime: number;
+    recipients: string[];
+    acknowledgments: string[];
+}
+/**
+ * Consensus request
+ */
+export interface ConsensusRequest {
+    id: string;
+    initiator: string;
+    question: string;
+    options: string[];
+    votes: Map<string, string>;
+    deadline: number;
+    status: 'pending' | 'resolved' | 'expired';
+    result?: {
+        winner: string;
+        confidence: number;
+        participation: number;
+    };
+}
+/**
+ * Task handoff
+ */
+export interface TaskHandoff {
+    id: string;
+    taskId: string;
+    description: string;
+    fromAgent: string;
+    toAgent: string;
+    context: {
+        filesModified: string[];
+        patternsUsed: string[];
+        decisions: string[];
+        blockers: string[];
+        nextSteps: string[];
+    };
+    status: 'pending' | 'accepted' | 'rejected' | 'completed';
+    timestamp: number;
+    completedAt?: number;
+}
+/**
+ * Agent state in swarm
+ */
+export interface SwarmAgentState {
+    id: string;
+    name: string;
+    status: 'idle' | 'busy' | 'waiting' | 'offline';
+    currentTask?: string;
+    lastSeen: number;
+    capabilities: string[];
+    patternsShared: number;
+    handoffsReceived: number;
+    handoffsCompleted: number;
+}
+/**
+ * Swarm communication configuration
+ */
+export interface SwarmConfig {
+    /** Agent ID for this instance */
+    agentId: string;
+    /** Agent name/role */
+    agentName: string;
+    /** Message retention time (ms) */
+    messageRetention: number;
+    /** Consensus timeout (ms) */
+    consensusTimeout: number;
+    /** Auto-acknowledge messages */
+    autoAcknowledge: boolean;
+    /** Broadcast patterns automatically */
+    autoBroadcastPatterns: boolean;
+    /** Pattern broadcast threshold (quality) */
+    patternBroadcastThreshold: number;
+}
+/**
+ * Swarm Communication Hub
+ *
+ * Manages agent-to-agent communication within the swarm.
+ */
+export declare class SwarmCommunication extends EventEmitter {
+    private config;
+    private messages;
+    private broadcasts;
+    private consensusRequests;
+    private handoffs;
+    private agents;
+    private initialized;
+    private cleanupTimer?;
+    private metrics;
+    constructor(config?: Partial<SwarmConfig>);
+    /**
+     * Initialize swarm communication
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown swarm communication and cleanup resources
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Send a message to another agent
+     */
+    sendMessage(to: string, content: string, options?: {
+        type?: SwarmMessage['type'];
+        priority?: SwarmMessage['priority'];
+        metadata?: Record<string, unknown>;
+        ttl?: number;
+    }): Promise<SwarmMessage>;
+    /**
+     * Get messages for this agent
+     */
+    getMessages(options?: {
+        from?: string;
+        type?: SwarmMessage['type'];
+        since?: number;
+        limit?: number;
+    }): SwarmMessage[];
+    /**
+     * Broadcast context to all agents
+     */
+    broadcastContext(content: string, metadata?: Record<string, unknown>): Promise<SwarmMessage>;
+    /**
+     * Query other agents
+     */
+    queryAgents(query: string): Promise<SwarmMessage>;
+    /**
+     * Broadcast a learned pattern to the swarm
+     */
+    broadcastPattern(pattern: GuidancePattern, targetAgents?: string[]): Promise<PatternBroadcast>;
+    /**
+     * Acknowledge receipt of a pattern broadcast
+     */
+    acknowledgeBroadcast(broadcastId: string): boolean;
+    /**
+     * Get recent pattern broadcasts
+     */
+    getPatternBroadcasts(options?: {
+        since?: number;
+        domain?: string;
+        minQuality?: number;
+    }): PatternBroadcast[];
+    /**
+     * Import a broadcast pattern into local ReasoningBank
+     */
+    importBroadcastPattern(broadcastId: string): Promise<boolean>;
+    /**
+     * Initiate a consensus request
+     */
+    initiateConsensus(question: string, options: string[], timeout?: number): Promise<ConsensusRequest>;
+    /**
+     * Vote on a consensus request
+     */
+    voteConsensus(consensusId: string, vote: string): boolean;
+    /**
+     * Resolve a consensus request
+     */
+    private resolveConsensus;
+    /**
+     * Get consensus request by ID
+     */
+    getConsensus(consensusId: string): ConsensusRequest | undefined;
+    /**
+     * Get pending consensus requests
+     */
+    getPendingConsensus(): ConsensusRequest[];
+    /**
+     * Generate consensus guidance text
+     */
+    generateConsensusGuidance(consensusId: string): string;
+    /**
+     * Initiate a task handoff to another agent
+     */
+    initiateHandoff(toAgent: string, taskDescription: string, context: TaskHandoff['context']): Promise<TaskHandoff>;
+    /**
+     * Accept a task handoff
+     */
+    acceptHandoff(handoffId: string): boolean;
+    /**
+     * Reject a task handoff
+     */
+    rejectHandoff(handoffId: string, reason?: string): boolean;
+    /**
+     * Complete a task handoff
+     */
+    completeHandoff(handoffId: string, result?: Record<string, unknown>): boolean;
+    /**
+     * Get handoff by ID
+     */
+    getHandoff(handoffId: string): TaskHandoff | undefined;
+    /**
+     * Get pending handoffs for this agent
+     */
+    getPendingHandoffs(): TaskHandoff[];
+    /**
+     * Generate handoff context text for Claude
+     */
+    generateHandoffContext(handoffId: string): string;
+    /**
+     * Register an agent in the swarm
+     */
+    registerAgent(agent: SwarmAgentState): void;
+    /**
+     * Update agent status
+     */
+    updateAgentStatus(agentId: string, status: SwarmAgentState['status']): void;
+    /**
+     * Get all registered agents
+     */
+    getAgents(): SwarmAgentState[];
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId: string): SwarmAgentState | undefined;
+    /**
+     * Get communication statistics
+     */
+    getStats(): {
+        agentId: string;
+        agentCount: number;
+        metrics: {
+            messagesSent: number;
+            messagesReceived: number;
+            patternsBroadcast: number;
+            consensusInitiated: number;
+            consensusResolved: number;
+            handoffsInitiated: number;
+            handoffsCompleted: number;
+        };
+        pendingMessages: number;
+        pendingHandoffs: number;
+        pendingConsensus: number;
+    };
+    /**
+     * Cleanup old messages and data
+     */
+    private cleanup;
+    private ensureInitialized;
+}
+export declare const swarmComm: SwarmCommunication;
+export { SwarmCommunication as default, };
+//# sourceMappingURL=index.d.ts.map

package/dist/swarm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swarm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMhF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4CAA4C;IAC5C,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAgBD;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAiB;IAGtC,OAAO,CAAC,OAAO,CAQb;gBAEU,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAK7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B;;OAEG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,GAAG,CAAC,EAAE,MAAM,CAAC;KACT,GACL,OAAO,CAAC,YAAY,CAAC;IA4BxB;;OAEG;IACH,WAAW,CAAC,OAAO,GAAE;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,YAAY,EAAE;IAiCvB;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQtG;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAWvD;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAwC5B;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAYlD;;OAEG;IACH,oBAAoB,CAAC,OAAO,GAAE;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,gBAAgB,EAAE;IAkB3B;;OAEG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBnE;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC;IAoC5B;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAmBzD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/D;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,EAAE;IAKzC;;OAEG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAkCtD;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,GAC9B,OAAO,CAAC,WAAW,CAAC;IAiCvB;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAoBzC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAe1D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IA0B7E;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAItD;;OAEG;IACH,kBAAkB,IAAI,WAAW,EAAE;IAKnC;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IA0DjD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAK3C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,IAAI;IAS3E;;OAEG;IACH,SAAS,IAAI,eAAe,EAAE;IAI9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAQtD;;OAEG;IACH,QAAQ,IAAI;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YACP,YAAY,EAAE,MAAM,CAAC;YACrB,gBAAgB,EAAE,MAAM,CAAC;YACzB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,kBAAkB,EAAE,MAAM,CAAC;YAC3B,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;SAC3B,CAAC;QACF,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAWD;;OAEG;IACH,OAAO,CAAC,OAAO;YAiCD,iBAAiB;CAKhC;AAMD,eAAO,MAAM,SAAS,oBAA2B,CAAC;AAElD,OAAO,EACL,kBAAkB,IAAI,OAAO,GAC9B,CAAC"}