@sparkleideas/hooks 3.0.0-alpha.7-patch.17 → 3.0.0-alpha.7-patch.18

package/dist/swarm/index.d.ts

@@ -1,271 +0,0 @@
-/**
- * V3 Swarm Communication Hooks
- *
- * Enables agent-to-agent communication, pattern broadcasting,
- * consensus building, and task handoff coordination.
- *
- * @module @sparkleideas/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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swarm/index.ts"],"names":[],"mappings":"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"}