agent99 0.0.4 → 0.0.5

data/docs/core-concepts/agent-types.md

@@ -0,0 +1,255 @@
+# Agent Types
+
+Agent99 supports three fundamental agent types, each designed for different communication patterns and use cases. Understanding these types is crucial for designing effective distributed systems.
+
+## Overview
+
+![Agent Types Overview](../assets/images/agent-types-overview.svg)
+
+## Server Agents
+
+Server agents **receive and respond to requests** from other agents. They're the workhorses of the Agent99 ecosystem.
+
+### Characteristics
+
+- **Reactive**: Wait for incoming requests
+- **Stateless**: Each request is handled independently (by default)
+- **Specialized**: Usually focus on specific capabilities
+- **Discoverable**: Register their capabilities for others to find
+
+### Example: Server Agent
+
+```ruby
+class WeatherAgent < Agent99::Base
+  def info
+    {
+      name: self.class.to_s,
+      type: :server,  # This makes it a server agent
+      capabilities: ['weather', 'forecast', 'temperature']
+    }
+  end
+
+  def process_request(payload)
+    location = payload.dig(:location)
+    
+    # Simulate weather lookup
+    weather_data = {
+      location: location,
+      temperature: rand(15..35),
+      condition: ['sunny', 'cloudy', 'rainy'].sample,
+      timestamp: Time.now.iso8601
+    }
+    
+    send_response(weather_data)
+  end
+end
+```
+
+### When to Use Server Agents
+
+- **Services**: Database access, calculations, data processing
+- **APIs**: Wrapping external APIs or services  
+- **Workers**: Background job processing
+- **Specialists**: Domain-specific functionality
+
+## Client Agents
+
+Client agents **make requests to other agents** and handle their responses. They're the initiators of communication.
+
+### Characteristics
+
+- **Proactive**: Initiate communication
+- **Discovery-aware**: Find and connect to appropriate services
+- **Request-driven**: Send requests and wait for responses
+- **Orchestrating**: Can coordinate multiple service calls
+
+### Example: Client Agent
+
+```ruby
+class WeatherClientAgent < Agent99::Base
+  def info
+    {
+      name: self.class.to_s,
+      type: :client,  # This makes it a client agent
+      capabilities: ['weather_requester', 'data_aggregator']
+    }
+  end
+
+  def get_weather_report(locations)
+    # Find weather service agents
+    weather_agents = discover_agents(['weather'])
+    
+    if weather_agents.empty?
+      logger.warn "No weather agents available"
+      return nil
+    end
+
+    weather_agent = weather_agents.first
+    reports = []
+
+    locations.each do |location|
+      request = { location: location }
+      response = send_request(weather_agent[:name], request)
+      reports << response if response
+    end
+
+    reports
+  end
+end
+```
+
+### When to Use Client Agents
+
+- **Aggregators**: Combine data from multiple sources
+- **Workflows**: Multi-step business processes
+- **User Interfaces**: Frontend applications
+- **Schedulers**: Time-based or event-driven tasks
+
+## Hybrid Agents
+
+Hybrid agents can **both send and receive requests**. They're the most flexible but also the most complex.
+
+### Characteristics
+
+- **Bidirectional**: Can act as both client and server
+- **Mediating**: Often serve as intermediaries or proxies
+- **Stateful**: May maintain state across interactions
+- **Complex**: Handle multiple communication patterns
+
+### Example: Hybrid Agent
+
+```ruby
+class WeatherProxyAgent < Agent99::Base
+  def initialize
+    super
+    @cache = {}  # Simple caching
+    @stats = { requests: 0, cache_hits: 0 }
+  end
+
+  def info
+    {
+      name: self.class.to_s,
+      type: :hybrid,  # This makes it a hybrid agent
+      capabilities: ['weather_proxy', 'caching', 'analytics']
+    }
+  end
+
+  # Server behavior: respond to weather requests
+  def process_request(payload)
+    location = payload.dig(:location)
+    @stats[:requests] += 1
+
+    # Check cache first
+    if @cache[location] && fresh_enough?(@cache[location])
+      @stats[:cache_hits] += 1
+      logger.info "Cache hit for #{location}"
+      send_response(@cache[location][:data])
+      return
+    end
+
+    # Cache miss - get from weather service
+    weather_data = fetch_weather_data(location)
+    
+    if weather_data
+      @cache[location] = {
+        data: weather_data,
+        timestamp: Time.now
+      }
+      send_response(weather_data)
+    else
+      send_error("Weather data unavailable for #{location}")
+    end
+  end
+
+  # Client behavior: request from actual weather service
+  private def fetch_weather_data(location)
+    weather_agents = discover_agents(['weather'])
+    return nil if weather_agents.empty?
+
+    weather_agent = weather_agents.first
+    request = { location: location }
+    send_request(weather_agent[:name], request)
+  end
+
+  private def fresh_enough?(cache_entry)
+    Time.now - cache_entry[:timestamp] < 300  # 5 minutes
+  end
+
+  # Additional hybrid behavior: provide statistics
+  def get_statistics
+    {
+      total_requests: @stats[:requests],
+      cache_hits: @stats[:cache_hits],
+      cache_hit_rate: @stats[:requests] > 0 ? @stats[:cache_hits].to_f / @stats[:requests] : 0
+    }
+  end
+end
+```
+
+### When to Use Hybrid Agents
+
+- **Proxies**: Caching, load balancing, protocol translation
+- **Middleware**: Authentication, logging, monitoring
+- **State Managers**: Session management, workflow coordination
+- **Aggregators**: Collect, process, and redistribute data
+
+## Agent Type Comparison
+
+| Feature | Server | Client | Hybrid |
+|---------|--------|--------|---------|
+| **Receives Requests** | ✅ | ❌ | ✅ |
+| **Sends Requests** | ❌ | ✅ | ✅ |
+| **Complexity** | Low | Medium | High |
+| **Statefulness** | Usually stateless | Can be stateful | Often stateful |
+| **Use Cases** | Services, APIs | UIs, Schedulers | Proxies, Middleware |
+
+## Communication Patterns
+
+### Request-Response (Server/Client)
+
+![Request-Response Pattern](../assets/images/request-response-sequence.svg)
+
+### Proxy Pattern (Hybrid)
+
+![Proxy Pattern](../assets/images/proxy-pattern-sequence.svg)
+
+## Best Practices
+
+### Server Agents
+
+1. **Keep them focused**: One capability per agent
+2. **Make them stateless**: Each request independent
+3. **Validate inputs**: Use schemas for safety
+4. **Handle errors gracefully**: Always respond, even on error
+
+### Client Agents
+
+1. **Handle service unavailability**: Graceful degradation
+2. **Use timeouts**: Don't wait forever
+3. **Implement retries**: With exponential backoff
+4. **Cache discoveries**: Don't rediscover every time
+
+### Hybrid Agents
+
+1. **Separate concerns**: Clear distinction between client/server logic
+2. **Manage state carefully**: Consider thread safety
+3. **Monitor performance**: Track both directions
+4. **Document behavior**: Complex interactions need clear docs
+
+## Choosing the Right Type
+
+Ask yourself:
+
+- **Do I need to respond to requests?** → Server or Hybrid
+- **Do I need to make requests?** → Client or Hybrid  
+- **Do I need both?** → Hybrid
+- **Is simplicity important?** → Avoid Hybrid if possible
+- **Is this a leaf service?** → Probably Server
+- **Is this an orchestrator?** → Probably Client
+- **Is this middleware?** → Probably Hybrid
+
+## Next Steps
+
+- **[Agent Lifecycle](agent-lifecycle.md)** - How agents start, run, and stop
+- **[Architecture Overview](architecture.md)** - How agents fit into the bigger picture
+- **[Custom Agent Implementation](../agent-development/custom-agent-implementation.md)** - Build your own agents

data/docs/{architecture.md → core-concepts/architecture.md}

@@ -10,9 +10,9 @@ Agent99 is a Ruby-based framework designed for building and managing software ag
 
 ### System Components Diagram
 
-![High Level Architecture](diagrams/high_level_architecture.png)
+![Agent99 Architecture](../assets/images/agent99-architecture.svg)
 
-The diagram above (generated from `diagrams/high_level_architecture.dot`) illustrates the key components and their interactions:
+The diagram above illustrates the key components and their interactions:
 
 - **Agents**: Come in three types:
    - Client Agents: Only make requests
@@ -72,6 +72,6 @@ The framework supports three primary message types:
 ## Implementation Details
 
 For detailed implementation information, see:
-- [API Reference](api_reference.md) for method specifications
-- [Agent Lifecycle](agent_lifecycle.md) for lifecycle management
-- [Agent Discovery](agent_discovery.md) for discovery mechanisms
+- [API Reference](../api-reference/agent99-base.md) for method specifications
+- [Agent Lifecycle](agent-lifecycle.md) for lifecycle management
+- [Agent Discovery](../framework-components/agent-discovery.md) for discovery mechanisms

data/docs/{what_is_an_agent.md → core-concepts/what-is-an-agent.md}

@@ -156,7 +156,7 @@ It supports three core operations:
 
 #### 1. Register
 
-![Central Registry Process](/assets/images/agent_registry_process.png)
+![Central Registry Process](../assets/images/agent-registry-process.svg)
 
 Agents register by providing their information (e.g., name and capabilities) to the registry service. Here's how registration works in practice:
 

data/docs/diagrams/message-flow-sequence.svg

@@ -0,0 +1,198 @@
+<svg width="1100" height="800" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background transparent -->
+  
+  <!-- Title -->
+  <text x="550" y="30" text-anchor="middle" fill="#f7fafc" 
+        font-family="Arial, sans-serif" font-size="18" font-weight="bold">
+    Agent99 + SmartMessage + Lanet Message Flow
+  </text>
+  
+  <!-- Entity columns -->
+  <line x1="150" y1="60" x2="150" y2="750" stroke="#4a5568" stroke-width="2"/>
+  <rect x="80" y="60" width="140" height="40" fill="#1a365d" stroke="#3182ce" stroke-width="2" rx="5"/>
+  <text x="150" y="85" text-anchor="middle" fill="#bee3f8" 
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Source Agent
+  </text>
+  
+  <line x1="350" y1="60" x2="350" y2="750" stroke="#4a5568" stroke-width="2"/>
+  <rect x="275" y="60" width="150" height="40" fill="#553c9a" stroke="#7c3aed" stroke-width="2" rx="5"/>
+  <text x="350" y="85" text-anchor="middle" fill="#e9d5ff" 
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    SmartMessage
+  </text>
+  
+  <line x1="550" y1="60" x2="550" y2="750" stroke="#4a5568" stroke-width="2"/>
+  <rect x="480" y="60" width="140" height="40" fill="#065f46" stroke="#10b981" stroke-width="2" rx="5"/>
+  <text x="550" y="85" text-anchor="middle" fill="#d1fae5" 
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Lanet Transport
+  </text>
+  
+  <line x1="750" y1="60" x2="750" y2="750" stroke="#4a5568" stroke-width="2"/>
+  <rect x="680" y="60" width="140" height="40" fill="#92400e" stroke="#f59e0b" stroke-width="2" rx="5"/>
+  <text x="750" y="85" text-anchor="middle" fill="#fef3c7" 
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    NATS/AMQP
+  </text>
+  
+  <line x1="950" y1="60" x2="950" y2="750" stroke="#4a5568" stroke-width="2"/>
+  <rect x="880" y="60" width="140" height="40" fill="#2d3748" stroke="#4a5568" stroke-width="2" rx="5"/>
+  <text x="950" y="85" text-anchor="middle" fill="#e2e8f0" 
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Target Agent
+  </text>
+  
+  <!-- Arrow definitions -->
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="7" 
+            refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#cbd5e0"/>
+    </marker>
+    <marker id="greenarrow" markerWidth="10" markerHeight="7" 
+            refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#10b981"/>
+    </marker>
+    <marker id="yellowarrow" markerWidth="10" markerHeight="7" 
+            refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#f59e0b"/>
+    </marker>
+  </defs>
+  
+  <!-- Message Flow Steps -->
+  
+  <!-- Step 1: Agent publishes message -->
+  <line x1="150" y1="130" x2="340" y2="130" 
+        stroke="#cbd5e0" stroke-width="2" marker-end="url(#arrow)"/>
+  <text x="245" y="125" text-anchor="middle" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="10">
+    1. publish(:greeting, to: 'target_uuid')
+  </text>
+  
+  <!-- Step 2: SmartMessage routing decision -->
+  <rect x="270" y="150" width="160" height="60" 
+        fill="#44337a" stroke="#7c3aed" stroke-width="2" rx="5" opacity="0.8"/>
+  <text x="350" y="170" text-anchor="middle" fill="#e9d5ff" 
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    2. Transport Selection
+  </text>
+  <text x="350" y="185" text-anchor="middle" fill="#c4b5fd" 
+        font-family="Arial, sans-serif" font-size="10">
+    Check: same_lan?(target)
+  </text>
+  <text x="350" y="200" text-anchor="middle" fill="#c4b5fd" 
+        font-family="Arial, sans-serif" font-size="10">
+    → Use Lanet for LAN
+  </text>
+  
+  <!-- Step 3a: LAN route (Lanet) -->
+  <line x1="350" y1="230" x2="540" y2="250" 
+        stroke="#10b981" stroke-width="3" marker-end="url(#greenarrow)"/>
+  <text x="445" y="235" text-anchor="middle" fill="#10b981" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    3a. LAN: Lanet.send_to(ip, message)
+  </text>
+  
+  <!-- Step 3b: WAN route (NATS/AMQP) -->
+  <line x1="350" y1="280" x2="740" y2="300" 
+        stroke="#f59e0b" stroke-width="2" stroke-dasharray="8,4" marker-end="url(#yellowarrow)"/>
+  <text x="545" y="285" text-anchor="middle" fill="#f59e0b" 
+        font-family="Arial, sans-serif" font-size="10">
+    3b. WAN: broker.publish(queue, message)
+  </text>
+  
+  <!-- Step 4a: Lanet direct delivery -->
+  <line x1="550" y1="330" x2="940" y2="350" 
+        stroke="#10b981" stroke-width="3" marker-end="url(#greenarrow)"/>
+  <text x="745" y="335" text-anchor="middle" fill="#10b981" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    4a. Direct P2P delivery (encrypted)
+  </text>
+  
+  <!-- Step 4b: Broker delivery -->
+  <line x1="750" y1="380" x2="940" y2="400" 
+        stroke="#f59e0b" stroke-width="2" stroke-dasharray="8,4" marker-end="url(#yellowarrow)"/>
+  <text x="845" y="385" text-anchor="middle" fill="#f59e0b" 
+        font-family="Arial, sans-serif" font-size="10">
+    4b. Broker delivery
+  </text>
+  
+  <!-- Step 5: Message processing -->
+  <rect x="870" y="430" width="160" height="60" 
+        fill="#1f2937" stroke="#4b5563" stroke-width="2" rx="5" opacity="0.8"/>
+  <text x="950" y="450" text-anchor="middle" fill="#e5e7eb" 
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    5. Process Message
+  </text>
+  <text x="950" y="465" text-anchor="middle" fill="#d1d5db" 
+        font-family="Arial, sans-serif" font-size="10">
+    SmartMessage.handle()
+  </text>
+  <text x="950" y="480" text-anchor="middle" fill="#d1d5db" 
+        font-family="Arial, sans-serif" font-size="10">
+    → Agent business logic
+  </text>
+  
+  <!-- Response flow -->
+  <text x="550" y="540" text-anchor="middle" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    Response Flow (Same Path in Reverse)
+  </text>
+  
+  <!-- Response step 6 -->
+  <line x1="950" y1="570" x2="360" y2="590" 
+        stroke="#a78bfa" stroke-width="2" stroke-dasharray="3,3" marker-end="url(#arrow)"/>
+  <text x="655" y="575" text-anchor="middle" fill="#a78bfa" 
+        font-family="Arial, sans-serif" font-size="10">
+    6. Response via same transport path
+  </text>
+  
+  <!-- Response step 7 -->
+  <line x1="350" y1="620" x2="160" y2="640" 
+        stroke="#a78bfa" stroke-width="2" stroke-dasharray="3,3" marker-end="url(#arrow)"/>
+  <text x="255" y="625" text-anchor="middle" fill="#a78bfa" 
+        font-family="Arial, sans-serif" font-size="10">
+    7. Delivered to source agent
+  </text>
+  
+  <!-- Benefits box -->
+  <rect x="50" y="680" width="1000" height="60" 
+        fill="#0f172a" stroke="#334155" stroke-width="1" rx="5" opacity="0.9"/>
+  <text x="70" y="705" fill="#f1f5f9" 
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Benefits:
+  </text>
+  <text x="140" y="705" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • Automatic transport selection
+  </text>
+  <text x="320" y="705" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • Unified API regardless of transport
+  </text>
+  <text x="520" y="705" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • LAN optimization with Lanet P2P
+  </text>
+  <text x="720" y="705" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • WAN fallback with brokers
+  </text>
+  
+  <text x="140" y="725" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • Built-in encryption/security
+  </text>
+  <text x="320" y="725" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • Clean separation of concerns
+  </text>
+  <text x="520" y="725" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • Transparent to Agent99 logic
+  </text>
+  <text x="720" y="725" fill="#cbd5e0" 
+        font-family="Arial, sans-serif" font-size="11">
+    • Extensible plugin architecture
+  </text>
+</svg>

data/docs/diagrams/p2p-network-topology.svg

@@ -0,0 +1,181 @@
+<svg width="1000" height="700" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background transparent -->
+  
+  <!-- Title -->
+  <text x="500" y="30" text-anchor="middle" fill="#f7fafc" 
+        font-family="Arial, sans-serif" font-size="20" font-weight="bold">
+    Agent99 Hybrid P2P Network Topology
+  </text>
+  
+  <!-- LAN 1 -->
+  <rect x="50" y="80" width="400" height="250" 
+        fill="none" stroke="#10b981" stroke-width="2" stroke-dasharray="10,5" rx="15"/>
+  <text x="250" y="105" text-anchor="middle" fill="#10b981" 
+        font-family="Arial, sans-serif" font-size="16" font-weight="bold">
+    LAN Segment 1 (192.168.1.0/24)
+  </text>
+  
+  <!-- LAN 2 -->
+  <rect x="550" y="80" width="400" height="250" 
+        fill="none" stroke="#3b82f6" stroke-width="2" stroke-dasharray="10,5" rx="15"/>
+  <text x="750" y="105" text-anchor="middle" fill="#3b82f6" 
+        font-family="Arial, sans-serif" font-size="16" font-weight="bold">
+    LAN Segment 2 (192.168.2.0/24)
+  </text>
+  
+  <!-- Registry Server -->
+  <rect x="425" y="400" width="150" height="80" 
+        fill="#7c2d12" stroke="#dc2626" stroke-width="3" rx="10"/>
+  <text x="500" y="430" text-anchor="middle" fill="#fef2f2" 
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    Agent Registry
+  </text>
+  <text x="500" y="450" text-anchor="middle" fill="#fecaca" 
+        font-family="Arial, sans-serif" font-size="12">
+    Central Discovery
+  </text>
+  <text x="500" y="470" text-anchor="middle" fill="#fecaca" 
+        font-family="Arial, sans-serif" font-size="12">
+    &amp; Coordination
+  </text>
+  
+  <!-- NATS/AMQP Broker -->
+  <rect x="425" y="520" width="150" height="80" 
+        fill="#92400e" stroke="#f59e0b" stroke-width="3" rx="10"/>
+  <text x="500" y="550" text-anchor="middle" fill="#fef3c7" 
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    Message Broker
+  </text>
+  <text x="500" y="570" text-anchor="middle" fill="#fde68a" 
+        font-family="Arial, sans-serif" font-size="12">
+    NATS/AMQP
+  </text>
+  <text x="500" y="590" text-anchor="middle" fill="#fde68a" 
+        font-family="Arial, sans-serif" font-size="12">
+    Cross-LAN Bridge
+  </text>
+  
+  <!-- Agents in LAN 1 -->
+  <circle cx="150" cy="180" r="30" fill="#1a365d" stroke="#3182ce" stroke-width="2"/>
+  <text x="150" y="185" text-anchor="middle" fill="#bee3f8" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    Agent A
+  </text>
+  
+  <circle cx="280" cy="150" r="30" fill="#1a365d" stroke="#3182ce" stroke-width="2"/>
+  <text x="280" y="155" text-anchor="middle" fill="#bee3f8" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    Agent B
+  </text>
+  
+  <circle cx="350" cy="220" r="30" fill="#1a365d" stroke="#3182ce" stroke-width="2"/>
+  <text x="350" y="225" text-anchor="middle" fill="#bee3f8" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    Agent C
+  </text>
+  
+  <!-- Agents in LAN 2 -->
+  <circle cx="650" cy="180" r="30" fill="#2d3748" stroke="#4a5568" stroke-width="2"/>
+  <text x="650" y="185" text-anchor="middle" fill="#e2e8f0" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    Agent X
+  </text>
+  
+  <circle cx="780" cy="150" r="30" fill="#2d3748" stroke="#4a5568" stroke-width="2"/>
+  <text x="780" y="155" text-anchor="middle" fill="#e2e8f0" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    Agent Y
+  </text>
+  
+  <circle cx="850" cy="220" r="30" fill="#2d3748" stroke="#4a5568" stroke-width="2"/>
+  <text x="850" y="225" text-anchor="middle" fill="#e2e8f0" 
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    Agent Z
+  </text>
+  
+  <!-- Lanet P2P Connections within LANs (green) -->
+  <defs>
+    <marker id="greenarrow" markerWidth="8" markerHeight="6" 
+            refX="7" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#10b981"/>
+    </marker>
+    <marker id="yellowarrow" markerWidth="8" markerHeight="6" 
+            refX="7" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#f59e0b"/>
+    </marker>
+    <marker id="redarrow" markerWidth="8" markerHeight="6" 
+            refX="7" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#dc2626"/>
+    </marker>
+  </defs>
+  
+  <!-- P2P connections in LAN 1 -->
+  <line x1="180" y1="180" x2="250" y2="150" 
+        stroke="#10b981" stroke-width="3" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  <line x1="250" y1="170" x2="180" y2="180" 
+        stroke="#10b981" stroke-width="2" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  <line x1="310" y1="150" x2="340" y2="190" 
+        stroke="#10b981" stroke-width="3" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  
+  <!-- P2P connections in LAN 2 -->
+  <line x1="680" y1="180" x2="750" y2="150" 
+        stroke="#10b981" stroke-width="3" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  <line x1="750" y1="170" x2="680" y2="180" 
+        stroke="#10b981" stroke-width="2" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  <line x1="810" y1="150" x2="840" y2="190" 
+        stroke="#10b981" stroke-width="3" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  
+  <!-- Cross-LAN broker connections (yellow) -->
+  <line x1="350" y1="250" x2="450" y2="520" 
+        stroke="#f59e0b" stroke-width="2" 
+        marker-end="url(#yellowarrow)"/>
+  <line x1="650" y1="250" x2="550" y2="520" 
+        stroke="#f59e0b" stroke-width="2" 
+        marker-end="url(#yellowarrow)"/>
+  
+  <!-- Registry connections (red) -->
+  <line x1="280" y1="280" x2="450" y2="400" 
+        stroke="#dc2626" stroke-width="2" 
+        marker-end="url(#redarrow)"/>
+  <line x1="750" y1="280" x2="550" y2="400" 
+        stroke="#dc2626" stroke-width="2" 
+        marker-end="url(#redarrow)"/>
+  
+  <!-- Legend -->
+  <rect x="50" y="620" width="900" height="60" 
+        fill="#1a202c" stroke="#2d3748" stroke-width="1" rx="5"/>
+  <text x="70" y="645" fill="#f7fafc" 
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    Connection Types:
+  </text>
+  
+  <line x1="200" y1="650" x2="250" y2="650" 
+        stroke="#10b981" stroke-width="3" stroke-dasharray="5,3" 
+        marker-end="url(#greenarrow)"/>
+  <text x="260" y="655" fill="#10b981" 
+        font-family="Arial, sans-serif" font-size="12">
+    Lanet P2P (Same LAN)
+  </text>
+  
+  <line x1="420" y1="650" x2="470" y2="650" 
+        stroke="#f59e0b" stroke-width="2" 
+        marker-end="url(#yellowarrow)"/>
+  <text x="480" y="655" fill="#f59e0b" 
+        font-family="Arial, sans-serif" font-size="12">
+    Broker (Cross-LAN)
+  </text>
+  
+  <line x1="620" y1="650" x2="670" y2="650" 
+        stroke="#dc2626" stroke-width="2" 
+        marker-end="url(#redarrow)"/>
+  <text x="680" y="655" fill="#dc2626" 
+        font-family="Arial, sans-serif" font-size="12">
+    Registry (Discovery)
+  </text>
+</svg>