🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
checkpoint: File edit:
rUv22561c80bcb6
diff --git a/.claude/helpers/swarm-comms.sh b/.claude/helpers/swarm-comms.shnew file mode 100644index 0000000000..bcab13c02e--- /dev/null+++ b/.claude/helpers/swarm-comms.sh@@ -0,0 +1,354 @@+#!/bin/bash+# Claude Flow V3 - Optimized Swarm Communications+# Non-blocking, batched, priority-based inter-agent messaging++set -euo pipefail++SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"+SWARM_DIR="$PROJECT_ROOT/.claude-flow/swarm"+QUEUE_DIR="$SWARM_DIR/queue"+BATCH_DIR="$SWARM_DIR/batch"+POOL_FILE="$SWARM_DIR/connection-pool.json"++mkdir -p "$QUEUE_DIR" "$BATCH_DIR"++# Priority levels+PRIORITY_CRITICAL=0+PRIORITY_HIGH=1+PRIORITY_NORMAL=2+PRIORITY_LOW=3++# Batch settings+BATCH_SIZE=10+BATCH_TIMEOUT_MS=100++# =============================================================================+# NON-BLOCKING MESSAGE QUEUE+# =============================================================================++# Enqueue message (instant return, async processing)+enqueue() {+ local to="${1:-*}"+ local content="${2:-}"+ local priority="${3:-$PRIORITY_NORMAL}"+ local msg_type="${4:-context}"++ local msg_id="msg_$(date +%s%N)"+ local timestamp=$(date +%s)++ # Write to priority queue (non-blocking)+ cat > "$QUEUE_DIR/${priority}_${msg_id}.json" << EOF+{"id":"$msg_id","to":"$to","content":"$content","type":"$msg_type","priority":$priority,"timestamp":$timestamp}+EOF++ echo "$msg_id"+}++# Process queue in background+process_queue() {+ local processed=0++ # Process by priority (0=critical first)+ for priority in 0 1 2 3; do+ for msg_file in "$QUEUE_DIR"/${priority}_*.json 2>/dev/null; do+ [ -f "$msg_file" ] || continue++ # Process message+ local msg=$(cat "$msg_file")+ local to=$(echo "$msg" | jq -r '.to' 2>/dev/null)++ # Route to agent mailbox+ if [ "$to" != "*" ]; then+ mkdir -p "$SWARM_DIR/mailbox/$to"+ mv "$msg_file" "$SWARM_DIR/mailbox/$to/"+ else+ # Broadcast - copy to all agent mailboxes+ for agent_dir in "$SWARM_DIR/mailbox"/*; do+ [ -d "$agent_dir" ] && cp "$msg_file" "$agent_dir/"+ done+ rm "$msg_file"+ fi++ processed=$((processed + 1))+ done+ done++ echo "$processed"+}++# =============================================================================+# MESSAGE BATCHING+# =============================================================================++# Add to batch (collects messages, flushes when full or timeout)+batch_add() {+ local agent_id="${1:-}"+ local content="${2:-}"+ local batch_file="$BATCH_DIR/${agent_id}.batch"++ # Append to batch+ echo "$content" >> "$batch_file"++ # Check batch size+ local count=$(wc -l < "$batch_file" 2>/dev/null || echo "0")++ if [ "$count" -ge "$BATCH_SIZE" ]; then+ batch_flush "$agent_id"+ fi+}++# Flush batch (send all at once)+batch_flush() {+ local agent_id="${1:-}"+ local batch_file="$BATCH_DIR/${agent_id}.batch"++ if [ -f "$batch_file" ]; then+ local content=$(cat "$batch_file")+ rm "$batch_file"++ # Send as single batched message+ enqueue "$agent_id" "$content" "$PRIORITY_NORMAL" "batch"+ fi+}++# Flush all pending batches+batch_flush_all() {+ for batch_file in "$BATCH_DIR"/*.batch 2>/dev/null; do+ [ -f "$batch_file" ] || continue+ local agent_id=$(basename "$batch_file" .batch)+ batch_flush "$agent_id"+ done+}++# =============================================================================+# CONNECTION POOLING+# =============================================================================++# Initialize connection pool+pool_init() {+ cat > "$POOL_FILE" << EOF+{+ "maxConnections": 10,+ "activeConnections": 0,+ "available": [],+ "inUse": [],+ "lastUpdated": "$(date -Iseconds)"+}+EOF+}++# Get connection from pool (or create new)+pool_acquire() {+ local agent_id="${1:-}"++ if [ ! -f "$POOL_FILE" ]; then+ pool_init+ fi++ # Check for available connection+ local available=$(jq -r '.available[0] // ""' "$POOL_FILE" 2>/dev/null)++ if [ -n "$available" ]; then+ # Reuse existing connection+ jq ".available = .available[1:] | .inUse += [\"$available\"]" "$POOL_FILE" > "$POOL_FILE.tmp" && mv "$POOL_FILE.tmp" "$POOL_FILE"+ echo "$available"+ else+ # Create new connection ID+ local conn_id="conn_$(date +%s%N | tail -c 8)"+ jq ".inUse += [\"$conn_id\"] | .activeConnections += 1" "$POOL_FILE" > "$POOL_FILE.tmp" && mv "$POOL_FILE.tmp" "$POOL_FILE"+ echo "$conn_id"+ fi+}++# Release connection back to pool+pool_release() {+ local conn_id="${1:-}"++ if [ -f "$POOL_FILE" ]; then+ jq ".inUse = (.inUse | map(select(. != \"$conn_id\"))) | .available += [\"$conn_id\"]" "$POOL_FILE" > "$POOL_FILE.tmp" && mv "$POOL_FILE.tmp" "$POOL_FILE"+ fi+}++# =============================================================================+# ASYNC PATTERN BROADCAST+# =============================================================================++# Broadcast pattern to swarm (non-blocking)+broadcast_pattern_async() {+ local strategy="${1:-}"+ local domain="${2:-general}"+ local quality="${3:-0.7}"++ # Fire and forget+ (+ local broadcast_id="pattern_$(date +%s%N)"++ # Write pattern broadcast+ mkdir -p "$SWARM_DIR/patterns"+ cat > "$SWARM_DIR/patterns/$broadcast_id.json" << EOF+{"id":"$broadcast_id","strategy":"$strategy","domain":"$domain","quality":$quality,"timestamp":$(date +%s),"status":"pending"}+EOF++ # Notify all agents via queue+ enqueue "*" "{\"type\":\"pattern_broadcast\",\"id\":\"$broadcast_id\"}" "$PRIORITY_HIGH" "event"++ ) &++ echo "pattern_broadcast_queued"+}++# =============================================================================+# OPTIMIZED CONSENSUS+# =============================================================================++# Start consensus (non-blocking)+start_consensus_async() {+ local question="${1:-}"+ local options="${2:-}"+ local timeout="${3:-30}"++ (+ local consensus_id="consensus_$(date +%s%N)"+ mkdir -p "$SWARM_DIR/consensus"++ cat > "$SWARM_DIR/consensus/$consensus_id.json" << EOF+{"id":"$consensus_id","question":"$question","options":"$options","votes":{},"timeout":$timeout,"created":$(date +%s),"status":"open"}+EOF++ # Notify agents+ enqueue "*" "{\"type\":\"consensus_request\",\"id\":\"$consensus_id\"}" "$PRIORITY_HIGH" "event"++ # Auto-resolve after timeout (background)+ (+ sleep "$timeout"+ if [ -f "$SWARM_DIR/consensus/$consensus_id.json" ]; then+ jq '.status = "resolved"' "$SWARM_DIR/consensus/$consensus_id.json" > "$SWARM_DIR/consensus/$consensus_id.json.tmp" && mv "$SWARM_DIR/consensus/$consensus_id.json.tmp" "$SWARM_DIR/consensus/$consensus_id.json"+ fi+ ) &++ echo "$consensus_id"+ ) &+}++# Vote on consensus (non-blocking)+vote_async() {+ local consensus_id="${1:-}"+ local vote="${2:-}"+ local agent_id="${AGENTIC_FLOW_AGENT_ID:-anonymous}"++ (+ local file="$SWARM_DIR/consensus/$consensus_id.json"+ if [ -f "$file" ]; then+ jq ".votes[\"$agent_id\"] = \"$vote\"" "$file" > "$file.tmp" && mv "$file.tmp" "$file"+ fi+ ) &+}++# =============================================================================+# PERFORMANCE METRICS+# =============================================================================++get_comms_stats() {+ local queued=$(ls "$QUEUE_DIR"/*.json 2>/dev/null | wc -l || echo "0")+ local batched=$(ls "$BATCH_DIR"/*.batch 2>/dev/null | wc -l || echo "0")+ local patterns=$(ls "$SWARM_DIR/patterns"/*.json 2>/dev/null | wc -l || echo "0")+ local consensus=$(ls "$SWARM_DIR/consensus"/*.json 2>/dev/null | wc -l || echo "0")++ local pool_active=0+ if [ -f "$POOL_FILE" ]; then+ pool_active=$(jq '.activeConnections // 0' "$POOL_FILE" 2>/dev/null || echo "0")+ fi++ cat << EOF+{+ "queue": {"pending": $queued},+ "batch": {"pending": $batched},+ "patterns": {"active": $patterns},+ "consensus": {"active": $consensus},+ "pool": {"connections": $pool_active}+}+EOF+}++# =============================================================================+# MAIN DISPATCHER+# =============================================================================++case "${1:-help}" in+ # Queue operations+ "enqueue"|"send")+ enqueue "${2:-*}" "${3:-}" "${4:-2}" "${5:-context}"+ ;;+ "process")+ process_queue+ ;;++ # Batch operations+ "batch")+ batch_add "${2:-}" "${3:-}"+ ;;+ "flush")+ batch_flush_all+ ;;++ # Pool operations+ "acquire")+ pool_acquire "${2:-}"+ ;;+ "release")+ pool_release "${2:-}"+ ;;++ # Async operations+ "broadcast-pattern")+ broadcast_pattern_async "${2:-}" "${3:-general}" "${4:-0.7}"+ ;;+ "consensus")+ start_consensus_async "${2:-}" "${3:-}" "${4:-30}"+ ;;+ "vote")+ vote_async "${2:-}" "${3:-}"+ ;;++ # Stats+ "stats")+ get_comms_stats+ ;;++ "help"|*)+ cat << 'EOF'+Claude Flow V3 - Optimized Swarm Communications++Non-blocking, batched, priority-based inter-agent messaging.++Usage: swarm-comms.sh <command> [args]++Queue (Non-blocking):+ enqueue <to> <content> [priority] [type] Add to queue (instant return)+ process Process pending queue++Batching:+ batch <agent> <content> Add to batch+ flush Flush all batches++Connection Pool:+ acquire [agent] Get connection from pool+ release <conn_id> Return connection to pool++Async Operations:+ broadcast-pattern <strategy> [domain] [quality] Async pattern broadcast+ consensus <question> <options> [timeout] Start async consensus+ vote <consensus_id> <vote> Vote (non-blocking)++Stats:+ stats Get communication stats++Priority Levels:+ 0 = Critical (processed first)+ 1 = High+ 2 = Normal (default)+ 3 = Low+EOF+ ;;+esac