feat: CRM Clinicas SaaS - MVP completo
- Auth: Login/Register con creacion de clinica - Dashboard: KPIs reales, graficas recharts - Pacientes: CRUD completo con busqueda - Agenda: FullCalendar, drag-and-drop, vista recepcion - Expediente: Notas SOAP, signos vitales, CIE-10 - Facturacion: Facturas con IVA, campos CFDI SAT - Inventario: Productos, stock, movimientos, alertas - Configuracion: Clinica, equipo, catalogo servicios - Supabase self-hosted: 18 tablas con RLS multi-tenant - Docker + Nginx para produccion Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
Consultoria AS
761
.claude/helpers/swarm-hooks.sh
Executable file
761
.claude/helpers/swarm-hooks.sh
Executable file
@@ -0,0 +1,761 @@
|
||||
#!/bin/bash
|
||||
# Claude Flow V3 - Swarm Communication Hooks
|
||||
# Enables agent-to-agent messaging, pattern sharing, consensus, and task handoffs
|
||||
#
|
||||
# Integration with:
|
||||
# - @claude-flow/hooks SwarmCommunication module
|
||||
# - agentic-flow@alpha swarm coordination
|
||||
# - Local hooks system for real-time agent coordination
|
||||
#
|
||||
# Key mechanisms:
|
||||
# - Exit 0 + stdout = Context added to Claude's view
|
||||
# - Exit 2 + stderr = Block with explanation
|
||||
# - JSON additionalContext = Swarm coordination messages
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
|
||||
SWARM_DIR="$PROJECT_ROOT/.claude-flow/swarm"
|
||||
MESSAGES_DIR="$SWARM_DIR/messages"
|
||||
PATTERNS_DIR="$SWARM_DIR/patterns"
|
||||
CONSENSUS_DIR="$SWARM_DIR/consensus"
|
||||
HANDOFFS_DIR="$SWARM_DIR/handoffs"
|
||||
AGENTS_FILE="$SWARM_DIR/agents.json"
|
||||
STATS_FILE="$SWARM_DIR/stats.json"
|
||||
|
||||
# Agent identity
|
||||
AGENT_ID="${AGENTIC_FLOW_AGENT_ID:-agent_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)}"
|
||||
AGENT_NAME="${AGENTIC_FLOW_AGENT_NAME:-claude-code}"
|
||||
|
||||
# Initialize directories
|
||||
mkdir -p "$MESSAGES_DIR" "$PATTERNS_DIR" "$CONSENSUS_DIR" "$HANDOFFS_DIR"
|
||||
|
||||
# =============================================================================
|
||||
# UTILITY FUNCTIONS
|
||||
# =============================================================================
|
||||
|
||||
init_stats() {
|
||||
if [ ! -f "$STATS_FILE" ]; then
|
||||
cat > "$STATS_FILE" << EOF
|
||||
{
|
||||
"messagesSent": 0,
|
||||
"messagesReceived": 0,
|
||||
"patternsBroadcast": 0,
|
||||
"consensusInitiated": 0,
|
||||
"consensusResolved": 0,
|
||||
"handoffsInitiated": 0,
|
||||
"handoffsCompleted": 0,
|
||||
"lastUpdated": "$(date -Iseconds)"
|
||||
}
|
||||
EOF
|
||||
fi
|
||||
}
|
||||
|
||||
update_stat() {
|
||||
local key="$1"
|
||||
local increment="${2:-1}"
|
||||
init_stats
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
local current=$(jq -r ".$key // 0" "$STATS_FILE")
|
||||
local new=$((current + increment))
|
||||
jq ".$key = $new | .lastUpdated = \"$(date -Iseconds)\"" "$STATS_FILE" > "$STATS_FILE.tmp" && mv "$STATS_FILE.tmp" "$STATS_FILE"
|
||||
fi
|
||||
}
|
||||
|
||||
register_agent() {
|
||||
init_stats
|
||||
local timestamp=$(date +%s)
|
||||
|
||||
if [ ! -f "$AGENTS_FILE" ]; then
|
||||
echo '{"agents":[]}' > "$AGENTS_FILE"
|
||||
fi
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
# Check if agent already exists
|
||||
local exists=$(jq -r ".agents[] | select(.id == \"$AGENT_ID\") | .id" "$AGENTS_FILE" 2>/dev/null || echo "")
|
||||
|
||||
if [ -z "$exists" ]; then
|
||||
jq ".agents += [{\"id\":\"$AGENT_ID\",\"name\":\"$AGENT_NAME\",\"status\":\"active\",\"lastSeen\":$timestamp}]" "$AGENTS_FILE" > "$AGENTS_FILE.tmp" && mv "$AGENTS_FILE.tmp" "$AGENTS_FILE"
|
||||
else
|
||||
# Update lastSeen
|
||||
jq "(.agents[] | select(.id == \"$AGENT_ID\")).lastSeen = $timestamp" "$AGENTS_FILE" > "$AGENTS_FILE.tmp" && mv "$AGENTS_FILE.tmp" "$AGENTS_FILE"
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# AGENT-TO-AGENT MESSAGING
|
||||
# =============================================================================
|
||||
|
||||
send_message() {
|
||||
local to="${1:-*}"
|
||||
local content="${2:-}"
|
||||
local msg_type="${3:-context}"
|
||||
local priority="${4:-normal}"
|
||||
|
||||
local msg_id="msg_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
|
||||
local timestamp=$(date +%s)
|
||||
|
||||
local msg_file="$MESSAGES_DIR/$msg_id.json"
|
||||
cat > "$msg_file" << EOF
|
||||
{
|
||||
"id": "$msg_id",
|
||||
"from": "$AGENT_ID",
|
||||
"fromName": "$AGENT_NAME",
|
||||
"to": "$to",
|
||||
"type": "$msg_type",
|
||||
"content": $(echo "$content" | jq -Rs .),
|
||||
"priority": "$priority",
|
||||
"timestamp": $timestamp,
|
||||
"read": false
|
||||
}
|
||||
EOF
|
||||
|
||||
update_stat "messagesSent"
|
||||
|
||||
echo "$msg_id"
|
||||
exit 0
|
||||
}
|
||||
|
||||
get_messages() {
|
||||
local limit="${1:-10}"
|
||||
local msg_type="${2:-}"
|
||||
|
||||
register_agent
|
||||
|
||||
local messages="[]"
|
||||
local count=0
|
||||
|
||||
for msg_file in $(ls -t "$MESSAGES_DIR"/*.json 2>/dev/null | head -n "$limit"); do
|
||||
if [ -f "$msg_file" ]; then
|
||||
local to=$(jq -r '.to' "$msg_file" 2>/dev/null)
|
||||
|
||||
# Check if message is for us or broadcast
|
||||
if [ "$to" = "$AGENT_ID" ] || [ "$to" = "*" ] || [ "$to" = "$AGENT_NAME" ]; then
|
||||
# Filter by type if specified
|
||||
if [ -n "$msg_type" ]; then
|
||||
local mtype=$(jq -r '.type' "$msg_file" 2>/dev/null)
|
||||
if [ "$mtype" != "$msg_type" ]; then
|
||||
continue
|
||||
fi
|
||||
fi
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
messages=$(echo "$messages" | jq ". += [$(cat "$msg_file")]")
|
||||
count=$((count + 1))
|
||||
|
||||
# Mark as read
|
||||
jq '.read = true' "$msg_file" > "$msg_file.tmp" && mv "$msg_file.tmp" "$msg_file"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
update_stat "messagesReceived" "$count"
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
echo "$messages" | jq -c "{count: $count, messages: .}"
|
||||
else
|
||||
echo "{\"count\": $count, \"messages\": []}"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
broadcast_context() {
|
||||
local content="${1:-}"
|
||||
send_message "*" "$content" "context" "normal"
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# PATTERN BROADCASTING
|
||||
# =============================================================================
|
||||
|
||||
broadcast_pattern() {
|
||||
local strategy="${1:-}"
|
||||
local domain="${2:-general}"
|
||||
local quality="${3:-0.7}"
|
||||
|
||||
local bc_id="bc_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
|
||||
local timestamp=$(date +%s)
|
||||
|
||||
local bc_file="$PATTERNS_DIR/$bc_id.json"
|
||||
cat > "$bc_file" << EOF
|
||||
{
|
||||
"id": "$bc_id",
|
||||
"sourceAgent": "$AGENT_ID",
|
||||
"sourceAgentName": "$AGENT_NAME",
|
||||
"pattern": {
|
||||
"strategy": $(echo "$strategy" | jq -Rs .),
|
||||
"domain": "$domain",
|
||||
"quality": $quality
|
||||
},
|
||||
"broadcastTime": $timestamp,
|
||||
"acknowledgments": []
|
||||
}
|
||||
EOF
|
||||
|
||||
update_stat "patternsBroadcast"
|
||||
|
||||
# Also store in learning hooks if available
|
||||
if [ -f "$SCRIPT_DIR/learning-hooks.sh" ]; then
|
||||
"$SCRIPT_DIR/learning-hooks.sh" store "$strategy" "$domain" "$quality" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
cat << EOF
|
||||
{"broadcastId":"$bc_id","strategy":$(echo "$strategy" | jq -Rs .),"domain":"$domain","quality":$quality}
|
||||
EOF
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
get_pattern_broadcasts() {
|
||||
local domain="${1:-}"
|
||||
local min_quality="${2:-0}"
|
||||
local limit="${3:-10}"
|
||||
|
||||
local broadcasts="[]"
|
||||
local count=0
|
||||
|
||||
for bc_file in $(ls -t "$PATTERNS_DIR"/*.json 2>/dev/null | head -n "$limit"); do
|
||||
if [ -f "$bc_file" ] && command -v jq &>/dev/null; then
|
||||
local bc_domain=$(jq -r '.pattern.domain' "$bc_file" 2>/dev/null)
|
||||
local bc_quality=$(jq -r '.pattern.quality' "$bc_file" 2>/dev/null)
|
||||
|
||||
# Filter by domain if specified
|
||||
if [ -n "$domain" ] && [ "$bc_domain" != "$domain" ]; then
|
||||
continue
|
||||
fi
|
||||
|
||||
# Filter by quality
|
||||
if [ "$(echo "$bc_quality >= $min_quality" | bc -l 2>/dev/null || echo "1")" = "1" ]; then
|
||||
broadcasts=$(echo "$broadcasts" | jq ". += [$(cat "$bc_file")]")
|
||||
count=$((count + 1))
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
echo "$broadcasts" | jq -c "{count: $count, broadcasts: .}"
|
||||
exit 0
|
||||
}
|
||||
|
||||
import_pattern() {
|
||||
local bc_id="$1"
|
||||
local bc_file="$PATTERNS_DIR/$bc_id.json"
|
||||
|
||||
if [ ! -f "$bc_file" ]; then
|
||||
echo '{"imported": false, "error": "Broadcast not found"}'
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Acknowledge the broadcast
|
||||
if command -v jq &>/dev/null; then
|
||||
jq ".acknowledgments += [\"$AGENT_ID\"]" "$bc_file" > "$bc_file.tmp" && mv "$bc_file.tmp" "$bc_file"
|
||||
|
||||
# Import to local learning
|
||||
local strategy=$(jq -r '.pattern.strategy' "$bc_file")
|
||||
local domain=$(jq -r '.pattern.domain' "$bc_file")
|
||||
local quality=$(jq -r '.pattern.quality' "$bc_file")
|
||||
|
||||
if [ -f "$SCRIPT_DIR/learning-hooks.sh" ]; then
|
||||
"$SCRIPT_DIR/learning-hooks.sh" store "$strategy" "$domain" "$quality" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
echo "{\"imported\": true, \"broadcastId\": \"$bc_id\"}"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# CONSENSUS GUIDANCE
|
||||
# =============================================================================
|
||||
|
||||
initiate_consensus() {
|
||||
local question="${1:-}"
|
||||
local options_str="${2:-}" # comma-separated
|
||||
local timeout="${3:-30000}"
|
||||
|
||||
local cons_id="cons_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
|
||||
local timestamp=$(date +%s)
|
||||
local deadline=$((timestamp + timeout / 1000))
|
||||
|
||||
# Parse options
|
||||
local options_json="[]"
|
||||
IFS=',' read -ra opts <<< "$options_str"
|
||||
for opt in "${opts[@]}"; do
|
||||
opt=$(echo "$opt" | xargs) # trim whitespace
|
||||
if command -v jq &>/dev/null; then
|
||||
options_json=$(echo "$options_json" | jq ". += [\"$opt\"]")
|
||||
fi
|
||||
done
|
||||
|
||||
local cons_file="$CONSENSUS_DIR/$cons_id.json"
|
||||
cat > "$cons_file" << EOF
|
||||
{
|
||||
"id": "$cons_id",
|
||||
"initiator": "$AGENT_ID",
|
||||
"initiatorName": "$AGENT_NAME",
|
||||
"question": $(echo "$question" | jq -Rs .),
|
||||
"options": $options_json,
|
||||
"votes": {},
|
||||
"deadline": $deadline,
|
||||
"status": "pending"
|
||||
}
|
||||
EOF
|
||||
|
||||
update_stat "consensusInitiated"
|
||||
|
||||
# Broadcast consensus request
|
||||
send_message "*" "Consensus request: $question. Options: $options_str. Vote by replying with your choice." "consensus" "high" >/dev/null
|
||||
|
||||
cat << EOF
|
||||
{"consensusId":"$cons_id","question":$(echo "$question" | jq -Rs .),"options":$options_json,"deadline":$deadline}
|
||||
EOF
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
vote_consensus() {
|
||||
local cons_id="$1"
|
||||
local vote="$2"
|
||||
|
||||
local cons_file="$CONSENSUS_DIR/$cons_id.json"
|
||||
|
||||
if [ ! -f "$cons_file" ]; then
|
||||
echo '{"accepted": false, "error": "Consensus not found"}'
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
local status=$(jq -r '.status' "$cons_file")
|
||||
if [ "$status" != "pending" ]; then
|
||||
echo '{"accepted": false, "error": "Consensus already resolved"}'
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Check if vote is valid option
|
||||
local valid=$(jq -r ".options | index(\"$vote\") // -1" "$cons_file")
|
||||
if [ "$valid" = "-1" ]; then
|
||||
echo "{\"accepted\": false, \"error\": \"Invalid option: $vote\"}"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Record vote
|
||||
jq ".votes[\"$AGENT_ID\"] = \"$vote\"" "$cons_file" > "$cons_file.tmp" && mv "$cons_file.tmp" "$cons_file"
|
||||
|
||||
echo "{\"accepted\": true, \"consensusId\": \"$cons_id\", \"vote\": \"$vote\"}"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
resolve_consensus() {
|
||||
local cons_id="$1"
|
||||
local cons_file="$CONSENSUS_DIR/$cons_id.json"
|
||||
|
||||
if [ ! -f "$cons_file" ]; then
|
||||
echo '{"resolved": false, "error": "Consensus not found"}'
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
# Count votes
|
||||
local result=$(jq -r '
|
||||
.votes | to_entries | group_by(.value) |
|
||||
map({option: .[0].value, count: length}) |
|
||||
sort_by(-.count) | .[0] // {option: "none", count: 0}
|
||||
' "$cons_file")
|
||||
|
||||
local winner=$(echo "$result" | jq -r '.option')
|
||||
local count=$(echo "$result" | jq -r '.count')
|
||||
local total=$(jq '.votes | length' "$cons_file")
|
||||
|
||||
local confidence=0
|
||||
if [ "$total" -gt 0 ]; then
|
||||
confidence=$(echo "scale=2; $count / $total * 100" | bc 2>/dev/null || echo "0")
|
||||
fi
|
||||
|
||||
# Update status
|
||||
jq ".status = \"resolved\" | .result = {\"winner\": \"$winner\", \"confidence\": $confidence, \"totalVotes\": $total}" "$cons_file" > "$cons_file.tmp" && mv "$cons_file.tmp" "$cons_file"
|
||||
|
||||
update_stat "consensusResolved"
|
||||
|
||||
echo "{\"resolved\": true, \"winner\": \"$winner\", \"confidence\": $confidence, \"totalVotes\": $total}"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
get_consensus_status() {
|
||||
local cons_id="${1:-}"
|
||||
|
||||
if [ -n "$cons_id" ]; then
|
||||
local cons_file="$CONSENSUS_DIR/$cons_id.json"
|
||||
if [ -f "$cons_file" ]; then
|
||||
cat "$cons_file"
|
||||
else
|
||||
echo '{"error": "Consensus not found"}'
|
||||
exit 1
|
||||
fi
|
||||
else
|
||||
# List pending consensus
|
||||
local pending="[]"
|
||||
for cons_file in "$CONSENSUS_DIR"/*.json; do
|
||||
if [ -f "$cons_file" ] && command -v jq &>/dev/null; then
|
||||
local status=$(jq -r '.status' "$cons_file")
|
||||
if [ "$status" = "pending" ]; then
|
||||
pending=$(echo "$pending" | jq ". += [$(cat "$cons_file")]")
|
||||
fi
|
||||
fi
|
||||
done
|
||||
echo "$pending" | jq -c .
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# TASK HANDOFF
|
||||
# =============================================================================
|
||||
|
||||
initiate_handoff() {
|
||||
local to_agent="$1"
|
||||
local description="${2:-}"
|
||||
local context_json="$3"
|
||||
[ -z "$context_json" ] && context_json='{}'
|
||||
|
||||
local ho_id="ho_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
|
||||
local timestamp=$(date +%s)
|
||||
|
||||
# Parse context or use defaults - ensure valid JSON
|
||||
local context
|
||||
if command -v jq &>/dev/null && [ -n "$context_json" ] && [ "$context_json" != "{}" ]; then
|
||||
# Try to parse and merge with defaults
|
||||
context=$(jq -c '{
|
||||
filesModified: (.filesModified // []),
|
||||
patternsUsed: (.patternsUsed // []),
|
||||
decisions: (.decisions // []),
|
||||
blockers: (.blockers // []),
|
||||
nextSteps: (.nextSteps // [])
|
||||
}' <<< "$context_json" 2>/dev/null)
|
||||
|
||||
# If parsing failed, use defaults
|
||||
if [ -z "$context" ] || [ "$context" = "null" ]; then
|
||||
context='{"filesModified":[],"patternsUsed":[],"decisions":[],"blockers":[],"nextSteps":[]}'
|
||||
fi
|
||||
else
|
||||
context='{"filesModified":[],"patternsUsed":[],"decisions":[],"blockers":[],"nextSteps":[]}'
|
||||
fi
|
||||
|
||||
local desc_escaped=$(echo -n "$description" | jq -Rs .)
|
||||
|
||||
local ho_file="$HANDOFFS_DIR/$ho_id.json"
|
||||
cat > "$ho_file" << EOF
|
||||
{
|
||||
"id": "$ho_id",
|
||||
"fromAgent": "$AGENT_ID",
|
||||
"fromAgentName": "$AGENT_NAME",
|
||||
"toAgent": "$to_agent",
|
||||
"description": $desc_escaped,
|
||||
"context": $context,
|
||||
"status": "pending",
|
||||
"timestamp": $timestamp
|
||||
}
|
||||
EOF
|
||||
|
||||
update_stat "handoffsInitiated"
|
||||
|
||||
# Send handoff notification (inline, don't call function which exits)
|
||||
local msg_id="msg_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
|
||||
local msg_file="$MESSAGES_DIR/$msg_id.json"
|
||||
cat > "$msg_file" << MSGEOF
|
||||
{
|
||||
"id": "$msg_id",
|
||||
"from": "$AGENT_ID",
|
||||
"fromName": "$AGENT_NAME",
|
||||
"to": "$to_agent",
|
||||
"type": "handoff",
|
||||
"content": "Task handoff: $description",
|
||||
"priority": "high",
|
||||
"timestamp": $timestamp,
|
||||
"read": false,
|
||||
"handoffId": "$ho_id"
|
||||
}
|
||||
MSGEOF
|
||||
update_stat "messagesSent"
|
||||
|
||||
cat << EOF
|
||||
{"handoffId":"$ho_id","toAgent":"$to_agent","description":$desc_escaped,"status":"pending","context":$context}
|
||||
EOF
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
accept_handoff() {
|
||||
local ho_id="$1"
|
||||
local ho_file="$HANDOFFS_DIR/$ho_id.json"
|
||||
|
||||
if [ ! -f "$ho_file" ]; then
|
||||
echo '{"accepted": false, "error": "Handoff not found"}'
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
jq ".status = \"accepted\" | .acceptedAt = $(date +%s)" "$ho_file" > "$ho_file.tmp" && mv "$ho_file.tmp" "$ho_file"
|
||||
|
||||
# Generate context for Claude
|
||||
local description=$(jq -r '.description' "$ho_file")
|
||||
local from=$(jq -r '.fromAgentName' "$ho_file")
|
||||
local files=$(jq -r '.context.filesModified | join(", ")' "$ho_file")
|
||||
local patterns=$(jq -r '.context.patternsUsed | join(", ")' "$ho_file")
|
||||
local decisions=$(jq -r '.context.decisions | join("; ")' "$ho_file")
|
||||
local next=$(jq -r '.context.nextSteps | join("; ")' "$ho_file")
|
||||
|
||||
cat << EOF
|
||||
## Task Handoff Accepted
|
||||
|
||||
**From**: $from
|
||||
**Task**: $description
|
||||
|
||||
**Files Modified**: $files
|
||||
**Patterns Used**: $patterns
|
||||
**Decisions Made**: $decisions
|
||||
**Next Steps**: $next
|
||||
|
||||
This context has been transferred. Continue from where the previous agent left off.
|
||||
EOF
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
complete_handoff() {
|
||||
local ho_id="$1"
|
||||
local result_json="${2:-{}}"
|
||||
|
||||
local ho_file="$HANDOFFS_DIR/$ho_id.json"
|
||||
|
||||
if [ ! -f "$ho_file" ]; then
|
||||
echo '{"completed": false, "error": "Handoff not found"}'
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
jq ".status = \"completed\" | .completedAt = $(date +%s) | .result = $result_json" "$ho_file" > "$ho_file.tmp" && mv "$ho_file.tmp" "$ho_file"
|
||||
|
||||
update_stat "handoffsCompleted"
|
||||
|
||||
echo "{\"completed\": true, \"handoffId\": \"$ho_id\"}"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
get_pending_handoffs() {
|
||||
local pending="[]"
|
||||
|
||||
for ho_file in "$HANDOFFS_DIR"/*.json; do
|
||||
if [ -f "$ho_file" ] && command -v jq &>/dev/null; then
|
||||
local to=$(jq -r '.toAgent' "$ho_file")
|
||||
local status=$(jq -r '.status' "$ho_file")
|
||||
|
||||
# Check if handoff is for us and pending
|
||||
if [ "$status" = "pending" ] && ([ "$to" = "$AGENT_ID" ] || [ "$to" = "$AGENT_NAME" ]); then
|
||||
pending=$(echo "$pending" | jq ". += [$(cat "$ho_file")]")
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
echo "$pending" | jq -c .
|
||||
exit 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# SWARM STATUS & AGENTS
|
||||
# =============================================================================
|
||||
|
||||
get_agents() {
|
||||
register_agent
|
||||
|
||||
if [ -f "$AGENTS_FILE" ] && command -v jq &>/dev/null; then
|
||||
cat "$AGENTS_FILE"
|
||||
else
|
||||
echo '{"agents":[]}'
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
get_stats() {
|
||||
init_stats
|
||||
|
||||
if command -v jq &>/dev/null; then
|
||||
jq ". + {agentId: \"$AGENT_ID\", agentName: \"$AGENT_NAME\"}" "$STATS_FILE"
|
||||
else
|
||||
cat "$STATS_FILE"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# HOOK INTEGRATION - Output for Claude hooks
|
||||
# =============================================================================
|
||||
|
||||
pre_task_swarm_context() {
|
||||
local task="${1:-}"
|
||||
|
||||
register_agent
|
||||
|
||||
# Check for pending handoffs
|
||||
local handoffs=$(get_pending_handoffs 2>/dev/null || echo "[]")
|
||||
local handoff_count=$(echo "$handoffs" | jq 'length' 2>/dev/null || echo "0")
|
||||
|
||||
# Check for new messages
|
||||
local messages=$(get_messages 5 2>/dev/null || echo '{"count":0}')
|
||||
local msg_count=$(echo "$messages" | jq '.count' 2>/dev/null || echo "0")
|
||||
|
||||
# Check for pending consensus
|
||||
local consensus=$(get_consensus_status 2>/dev/null || echo "[]")
|
||||
local cons_count=$(echo "$consensus" | jq 'length' 2>/dev/null || echo "0")
|
||||
|
||||
if [ "$handoff_count" -gt 0 ] || [ "$msg_count" -gt 0 ] || [ "$cons_count" -gt 0 ]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","additionalContext":"**Swarm Activity**:\n- Pending handoffs: $handoff_count\n- New messages: $msg_count\n- Active consensus: $cons_count\n\nCheck swarm status before proceeding on complex tasks."}}
|
||||
EOF
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
post_task_swarm_update() {
|
||||
local task="${1:-}"
|
||||
local success="${2:-true}"
|
||||
|
||||
# Broadcast task completion
|
||||
if [ "$success" = "true" ]; then
|
||||
send_message "*" "Completed: $(echo "$task" | head -c 100)" "result" "low" >/dev/null 2>&1 || true
|
||||
fi
|
||||
|
||||
exit 0
|
||||
}
|
||||
|
||||
# =============================================================================
|
||||
# Main dispatcher
|
||||
# =============================================================================
|
||||
case "${1:-help}" in
|
||||
# Messaging
|
||||
"send")
|
||||
send_message "${2:-*}" "${3:-}" "${4:-context}" "${5:-normal}"
|
||||
;;
|
||||
"messages")
|
||||
get_messages "${2:-10}" "${3:-}"
|
||||
;;
|
||||
"broadcast")
|
||||
broadcast_context "${2:-}"
|
||||
;;
|
||||
|
||||
# Pattern broadcasting
|
||||
"broadcast-pattern")
|
||||
broadcast_pattern "${2:-}" "${3:-general}" "${4:-0.7}"
|
||||
;;
|
||||
"patterns")
|
||||
get_pattern_broadcasts "${2:-}" "${3:-0}" "${4:-10}"
|
||||
;;
|
||||
"import-pattern")
|
||||
import_pattern "${2:-}"
|
||||
;;
|
||||
|
||||
# Consensus
|
||||
"consensus")
|
||||
initiate_consensus "${2:-}" "${3:-}" "${4:-30000}"
|
||||
;;
|
||||
"vote")
|
||||
vote_consensus "${2:-}" "${3:-}"
|
||||
;;
|
||||
"resolve-consensus")
|
||||
resolve_consensus "${2:-}"
|
||||
;;
|
||||
"consensus-status")
|
||||
get_consensus_status "${2:-}"
|
||||
;;
|
||||
|
||||
# Task handoff
|
||||
"handoff")
|
||||
initiate_handoff "${2:-}" "${3:-}" "${4:-}"
|
||||
;;
|
||||
"accept-handoff")
|
||||
accept_handoff "${2:-}"
|
||||
;;
|
||||
"complete-handoff")
|
||||
complete_handoff "${2:-}" "${3:-{}}"
|
||||
;;
|
||||
"pending-handoffs")
|
||||
get_pending_handoffs
|
||||
;;
|
||||
|
||||
# Status
|
||||
"agents")
|
||||
get_agents
|
||||
;;
|
||||
"stats")
|
||||
get_stats
|
||||
;;
|
||||
|
||||
# Hook integration
|
||||
"pre-task")
|
||||
pre_task_swarm_context "${2:-}"
|
||||
;;
|
||||
"post-task")
|
||||
post_task_swarm_update "${2:-}" "${3:-true}"
|
||||
;;
|
||||
|
||||
"help"|"-h"|"--help")
|
||||
cat << 'EOF'
|
||||
Claude Flow V3 - Swarm Communication Hooks
|
||||
|
||||
Usage: swarm-hooks.sh <command> [args]
|
||||
|
||||
Agent Messaging:
|
||||
send <to> <content> [type] [priority] Send message to agent
|
||||
messages [limit] [type] Get messages for this agent
|
||||
broadcast <content> Broadcast to all agents
|
||||
|
||||
Pattern Broadcasting:
|
||||
broadcast-pattern <strategy> [domain] [quality] Share pattern with swarm
|
||||
patterns [domain] [min-quality] [limit] List pattern broadcasts
|
||||
import-pattern <broadcast-id> Import broadcast pattern
|
||||
|
||||
Consensus:
|
||||
consensus <question> <options> [timeout] Start consensus (options: comma-separated)
|
||||
vote <consensus-id> <vote> Vote on consensus
|
||||
resolve-consensus <consensus-id> Force resolve consensus
|
||||
consensus-status [consensus-id] Get consensus status
|
||||
|
||||
Task Handoff:
|
||||
handoff <to-agent> <description> [context-json] Initiate handoff
|
||||
accept-handoff <handoff-id> Accept pending handoff
|
||||
complete-handoff <handoff-id> [result-json] Complete handoff
|
||||
pending-handoffs List pending handoffs
|
||||
|
||||
Status:
|
||||
agents List registered agents
|
||||
stats Get swarm statistics
|
||||
|
||||
Hook Integration:
|
||||
pre-task <task> Check swarm before task (for hooks)
|
||||
post-task <task> [success] Update swarm after task (for hooks)
|
||||
|
||||
Environment:
|
||||
AGENTIC_FLOW_AGENT_ID Agent identifier
|
||||
AGENTIC_FLOW_AGENT_NAME Agent display name
|
||||
EOF
|
||||
;;
|
||||
*)
|
||||
echo "Unknown command: $1" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
Reference in New Issue
Block a user