RubyGems - agent99 - Versions diffs - 0.0.3 → 0.0.5 - Mend

agent99 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (103) hide show

checksums.yaml +4 -4
data/A2A_SPEC-dev.md +1829 -0
data/CHANGELOG.md +38 -0
data/COMMITS.md +196 -0
data/DOCS.md +96 -0
data/README.md +212 -84
data/Rakefile +62 -0
data/docs/AI/htm.md +215 -0
data/docs/AI/htm.rb +141 -0
data/docs/AI/htm_demo.db +0 -0
data/docs/AI/notes_on_htm_implementation.md +1319 -0
data/docs/AI/some_code.rb +692 -0
data/docs/advanced-topics/a2a-protocol.md +13 -0
data/docs/{advanced_features.md → advanced-topics/advanced-features.md} +9 -4
data/docs/{control_actions.md → advanced-topics/control-actions.md} +2 -0
data/docs/advanced-topics/model-context-protocol.md +4 -0
data/docs/advanced-topics/multi-agent-processing.md +674 -0
data/docs/agent-development/request-response-handling.md +512 -0
data/docs/agent99_framework/central_registry.md +94 -0
data/docs/agent99_framework/message_client.md +120 -0
data/docs/agent99_framework/registry_client.md +119 -0
data/docs/api-reference/agent99-base.md +463 -0
data/docs/api-reference/message-clients.md +495 -0
data/docs/{api_reference.md → api-reference/overview.md} +14 -4
data/docs/api-reference/registry-client.md +470 -0
data/docs/api-reference/schemas.md +518 -0
data/docs/assets/css/custom.css +27 -0
data/docs/assets/images/agent-lifecycle.svg +73 -0
data/docs/assets/images/agent-registry-process.svg +86 -0
data/docs/assets/images/agent-registry-processes.svg +114 -0
data/docs/assets/images/agent-types-overview.svg +51 -0
data/docs/assets/images/agent99-architecture.svg +85 -0
data/docs/assets/images/agent99_logo.png +0 -0
data/docs/assets/images/control-actions-state.svg +83 -0
data/docs/assets/images/knowledge-graph.svg +77 -0
data/docs/assets/images/message-processing-flow.svg +148 -0
data/docs/assets/images/multi-agent-system.svg +66 -0
data/docs/assets/images/proxy-pattern-sequence.svg +48 -0
data/docs/assets/images/request-flow.svg +97 -0
data/docs/assets/images/request-processing-lifecycle.svg +50 -0
data/docs/assets/images/request-response-sequence.svg +39 -0
data/docs/{agent_lifecycle.md → core-concepts/agent-lifecycle.md} +2 -0
data/docs/core-concepts/agent-types.md +255 -0
data/docs/{architecture.md → core-concepts/architecture.md} +5 -5
data/docs/core-concepts/what-is-an-agent.md +293 -0
data/docs/diagrams/message-flow-sequence.svg +198 -0
data/docs/diagrams/p2p-network-topology.svg +181 -0
data/docs/diagrams/smart-transport-routing.svg +165 -0
data/docs/diagrams/three-layer-architecture.svg +77 -0
data/docs/diagrams/transport-extension-api.svg +309 -0
data/docs/diagrams/transport-extension-architecture.svg +234 -0
data/docs/diagrams/transport-selection-flowchart.svg +264 -0
data/docs/examples/advanced-examples.md +951 -0
data/docs/examples/basic-examples.md +268 -0
data/docs/{agent_discovery.md → framework-components/agent-discovery.md} +9 -5
data/docs/{agent_registry_processes.md → framework-components/agent-registry.md} +9 -3
data/docs/{message_processing.md → framework-components/message-processing.md} +3 -1
data/docs/getting-started/basic-example.md +306 -0
data/docs/getting-started/installation.md +160 -0
data/docs/getting-started/overview.md +64 -0
data/docs/getting-started/quick-start.md +179 -0
data/docs/index.md +97 -0
data/docs/operations/breaking-changes.md +26 -0
data/examples/DEMO.md +148 -0
data/examples/README.md +50 -0
data/examples/agent_watcher.rb +5 -1
data/examples/bad_agent.rb +32 -0
data/examples/chief_agent.rb +17 -6
data/examples/control.rb +16 -7
data/examples/example_agent.rb +16 -3
data/examples/maxwell_agent86.rb +15 -26
data/examples/registry.rb +10 -9
data/examples/run_demo.rb +433 -0
data/lib/agent99/agent_discovery.rb +4 -0
data/lib/agent99/agent_lifecycle.rb +34 -10
data/lib/agent99/amqp_message_client.rb +2 -2
data/lib/agent99/base.rb +6 -2
data/lib/agent99/message_processing.rb +6 -10
data/lib/agent99/registry_client.rb +15 -11
data/lib/agent99/tcp_message_client.rb +183 -0
data/lib/agent99/version.rb +1 -1
data/lib/agent99.rb +1 -1
data/mkdocs.yml +195 -0
data/p2p_plan.md +533 -0
data/p2p_roadmap.md +299 -0
data/registry_plan.md +1818 -0
metadata +93 -30
data/docs/README.md +0 -57
data/docs/diagrams/agent_registry_processes.dot +0 -42
data/docs/diagrams/agent_registry_processes.png +0 -0
data/docs/diagrams/high_level_architecture.dot +0 -26
data/docs/diagrams/high_level_architecture.png +0 -0
data/docs/diagrams/request_flow.dot +0 -42
data/docs/diagrams/request_flow.png +0 -0
/data/docs/{extending_the_framework.md → advanced-topics/extending-the-framework.md} +0 -0
/data/docs/{custom_agent_implementation.md → agent-development/custom-agent-implementation.md} +0 -0
/data/docs/{error_handling_and_logging.md → agent-development/error-handling-and-logging.md} +0 -0
/data/docs/{schema_definition.md → agent-development/schema-definition.md} +0 -0
/data/docs/{messaging_system.md → framework-components/messaging-system.md} +0 -0
/data/docs/{configuration.md → operations/configuration.md} +0 -0
/data/docs/{preformance_considerations.md → operations/performance-considerations.md} +0 -0
/data/docs/{security.md → operations/security.md} +0 -0
/data/docs/{troubleshooting.md → operations/troubleshooting.md} +0 -0

data/docs/diagrams/transport-extension-api.svg ADDED Viewed

@@ -0,0 +1,309 @@
+<svg width="1000" height="900" 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">
+    SmartMessage Transport Extension API Design
+  </text>
+  <!-- Core SmartMessage Interface -->
+  <rect x="50" y="70" width="900" height="120"
+        fill="#553c9a" stroke="#7c3aed" stroke-width="2" rx="8"/>
+  <text x="500" y="100" text-anchor="middle" fill="#e9d5ff"
+        font-family="Arial, sans-serif" font-size="16" font-weight="bold">
+    SmartMessage::Transport::Base (Core Interface)
+  </text>
+  <!-- Core methods -->
+  <text x="80" y="125" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def publish(message, options = {})
+  </text>
+  <text x="350" y="125" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def subscribe(queue, &amp;block)
+  </text>
+  <text x="620" y="125" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def connect
+  </text>
+  <text x="750" y="125" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def disconnect
+  </text>
+  <text x="80" y="145" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def setup(config)
+  </text>
+  <text x="250" y="145" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def healthy?
+  </text>
+  <text x="380" y="145" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def stats
+  </text>
+  <text x="500" y="145" fill="#c4b5fd"
+        font-family="monospace" font-size="11" font-weight="bold">
+    def cleanup
+  </text>
+  <text x="80" y="165" fill="#a78bfa"
+        font-family="Arial, sans-serif" font-size="10">
+    Required methods all transport extensions must implement
+  </text>
+  <!-- Extension Implementations -->
+  <!-- AMQP Extension -->
+  <rect x="50" y="220" width="430" height="160"
+        fill="#7c2d12" stroke="#dc2626" stroke-width="2" rx="8" opacity="0.9"/>
+  <text x="265" y="245" text-anchor="middle" fill="#fef2f2"
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    smart_message-transport-amqp
+  </text>
+  <text x="70" y="270" fill="#fecaca"
+        font-family="monospace" font-size="10">
+    class SmartMessage::Transport::AMQP &lt; Base
+  </text>
+  <text x="70" y="290" fill="#fecaca"
+        font-family="monospace" font-size="9">
+      def publish(message, options = {})
+  </text>
+  <text x="90" y="305" fill="#fca5a5"
+        font-family="monospace" font-size="9">
+        @bunny_exchange.publish(message.to_json,
+  </text>
+  <text x="90" y="320" fill="#fca5a5"
+        font-family="monospace" font-size="9">
+          routing_key: message.to)
+  </text>
+  <text x="70" y="340" fill="#fecaca"
+        font-family="monospace" font-size="9">
+      def subscribe(queue, &amp;block)
+  </text>
+  <text x="90" y="355" fill="#fca5a5"
+        font-family="monospace" font-size="9">
+        @bunny_queue.subscribe do |delivery, props, body|
+  </text>
+  <text x="90" y="370" fill="#fca5a5"
+        font-family="monospace" font-size="9">
+          yield SmartMessage.parse(body)
+  </text>
+  <!-- Lanet Extension -->
+  <rect x="520" y="220" width="430" height="160"
+        fill="#065f46" stroke="#10b981" stroke-width="2" rx="8" opacity="0.9"/>
+  <text x="735" y="245" text-anchor="middle" fill="#d1fae5"
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    smart_message-transport-lanet
+  </text>
+  <text x="540" y="270" fill="#a7f3d0"
+        font-family="monospace" font-size="10">
+    class SmartMessage::Transport::Lanet &lt; Base
+  </text>
+  <text x="540" y="290" fill="#a7f3d0"
+        font-family="monospace" font-size="9">
+      def publish(message, options = {})
+  </text>
+  <text x="560" y="305" fill="#6ee7b7"
+        font-family="monospace" font-size="9">
+        target_ip = resolve_agent_ip(message.to)
+  </text>
+  <text x="560" y="320" fill="#6ee7b7"
+        font-family="monospace" font-size="9">
+        @lanet.send_to(target_ip, message.to_json)
+  </text>
+  <text x="540" y="340" fill="#a7f3d0"
+        font-family="monospace" font-size="9">
+      def subscribe(queue, &amp;block)
+  </text>
+  <text x="560" y="355" fill="#6ee7b7"
+        font-family="monospace" font-size="9">
+        @lanet.listen do |msg|
+  </text>
+  <text x="560" y="370" fill="#6ee7b7"
+        font-family="monospace" font-size="9">
+          yield SmartMessage.parse(msg)
+  </text>
+  <!-- NATS Extension -->
+  <rect x="50" y="410" width="430" height="160"
+        fill="#1e40af" stroke="#3b82f6" stroke-width="2" rx="8" opacity="0.9"/>
+  <text x="265" y="435" text-anchor="middle" fill="#dbeafe"
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    smart_message-transport-nats
+  </text>
+  <text x="70" y="460" fill="#bfdbfe"
+        font-family="monospace" font-size="10">
+    class SmartMessage::Transport::NATS &lt; Base
+  </text>
+  <text x="70" y="480" fill="#bfdbfe"
+        font-family="monospace" font-size="9">
+      def publish(message, options = {})
+  </text>
+  <text x="90" y="495" fill="#93c5fd"
+        font-family="monospace" font-size="9">
+        subject = build_subject(message)
+  </text>
+  <text x="90" y="510" fill="#93c5fd"
+        font-family="monospace" font-size="9">
+        @nats.publish(subject, message.to_json)
+  </text>
+  <text x="70" y="530" fill="#bfdbfe"
+        font-family="monospace" font-size="9">
+      def subscribe(queue, &amp;block)
+  </text>
+  <text x="90" y="545" fill="#93c5fd"
+        font-family="monospace" font-size="9">
+        @nats.subscribe(queue) do |msg|
+  </text>
+  <text x="90" y="560" fill="#93c5fd"
+        font-family="monospace" font-size="9">
+          yield SmartMessage.parse(msg.data)
+  </text>
+  <!-- Plugin Registration -->
+  <rect x="520" y="410" width="430" height="160"
+        fill="#1f2937" stroke="#374151" stroke-width="2" rx="8" opacity="0.9"/>
+  <text x="735" y="435" text-anchor="middle" fill="#f9fafb"
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    Plugin Registration System
+  </text>
+  <text x="540" y="460" fill="#e5e7eb"
+        font-family="monospace" font-size="10">
+    SmartMessage::Transport.register(:amqp) do
+  </text>
+  <text x="560" y="475" fill="#d1d5db"
+        font-family="monospace" font-size="9">
+      SmartMessage::Transport::AMQP
+  </text>
+  <text x="540" y="490" fill="#e5e7eb"
+        font-family="monospace" font-size="10">
+    end
+  </text>
+  <text x="540" y="510" fill="#e5e7eb"
+        font-family="monospace" font-size="10">
+    SmartMessage::Transport.register(:lanet) do
+  </text>
+  <text x="560" y="525" fill="#d1d5db"
+        font-family="monospace" font-size="9">
+      SmartMessage::Transport::Lanet
+  </text>
+  <text x="540" y="540" fill="#e5e7eb"
+        font-family="monospace" font-size="10">
+    end
+  </text>
+  <text x="540" y="555" fill="#9ca3af"
+        font-family="Arial, sans-serif" font-size="9">
+    Auto-discovered when gem is loaded
+  </text>
+  <!-- Usage Examples -->
+  <rect x="50" y="600" width="900" height="120"
+        fill="#0f172a" stroke="#334155" stroke-width="2" rx="8" opacity="0.9"/>
+  <text x="500" y="625" text-anchor="middle" fill="#f1f5f9"
+        font-family="Arial, sans-serif" font-size="16" font-weight="bold">
+    Usage Examples
+  </text>
+  <text x="70" y="650" fill="#60a5fa"
+        font-family="monospace" font-size="11" font-weight="bold">
+    # Agent99 with enhanced BunnyFarm
+  </text>
+  <text x="70" y="665" fill="#93c5fd"
+        font-family="monospace" font-size="10">
+    class CapabilityRequest &lt; SmartMessage::Base
+  </text>
+  <text x="90" y="680" fill="#bfdbfe"
+        font-family="monospace" font-size="10">
+      config do
+  </text>
+  <text x="110" y="695" fill="#dbeafe"
+        font-family="monospace" font-size="10">
+        transport :amqp  # or :lanet, :nats, :redis, :memory
+  </text>
+  <text x="90" y="710" fill="#bfdbfe"
+        font-family="monospace" font-size="10">
+      end
+  </text>
+  <text x="500" y="650" fill="#fbbf24"
+        font-family="monospace" font-size="11" font-weight="bold">
+    # Dynamic transport selection
+  </text>
+  <text x="500" y="665" fill="#fcd34d"
+        font-family="monospace" font-size="10">
+    message.config do
+  </text>
+  <text x="520" y="680" fill="#fde68a"
+        font-family="monospace" font-size="10">
+      transport select_transport(target_agent)
+  </text>
+  <text x="500" y="695" fill="#fcd34d"
+        font-family="monospace" font-size="10">
+    end
+  </text>
+  <text x="500" y="710" fill="#fcd34d"
+        font-family="monospace" font-size="10">
+    message.publish
+  </text>
+  <!-- Configuration -->
+  <rect x="50" y="750" width="900" height="120"
+        fill="#1a202c" stroke="#2d3748" stroke-width="1" rx="5" opacity="0.9"/>
+  <text x="500" y="775" text-anchor="middle" fill="#f7fafc"
+        font-family="Arial, sans-serif" font-size="16" font-weight="bold">
+    Configuration &amp; Installation
+  </text>
+  <text x="70" y="800" fill="#68d391"
+        font-family="monospace" font-size="11" font-weight="bold">
+    # Gemfile
+  </text>
+  <text x="70" y="815" fill="#9ae6b4"
+        font-family="monospace" font-size="10">
+    gem 'smart_message'                    # Core + Memory/Redis
+  </text>
+  <text x="70" y="830" fill="#9ae6b4"
+        font-family="monospace" font-size="10">
+    gem 'smart_message-transport-amqp'     # Enterprise messaging
+  </text>
+  <text x="70" y="845" fill="#9ae6b4"
+        font-family="monospace" font-size="10">
+    gem 'smart_message-transport-lanet'    # P2P LAN optimization
+  </text>
+  <text x="70" y="860" fill="#9ae6b4"
+        font-family="monospace" font-size="10">
+    gem 'smart_message-transport-nats'     # High-performance distributed
+  </text>
+  <text x="500" y="800" fill="#fbb6ce"
+        font-family="monospace" font-size="11" font-weight="bold">
+    # Auto-registration on require
+  </text>
+  <text x="500" y="815" fill="#f687b3"
+        font-family="monospace" font-size="10">
+    require 'smart_message-transport-amqp'
+  </text>
+  <text x="500" y="830" fill="#f687b3"
+        font-family="monospace" font-size="10">
+    # Transport now available as :amqp
+  </text>
+  <text x="500" y="845" fill="#f687b3"
+        font-family="monospace" font-size="10">
+    SmartMessage::Transport.available_transports
+  </text>
+  <text x="500" y="860" fill="#f687b3"
+        font-family="monospace" font-size="10">
+    # => [:memory, :redis, :amqp]
+  </text>
+</svg>

data/docs/diagrams/transport-extension-architecture.svg ADDED Viewed

@@ -0,0 +1,234 @@
+<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">
+    SmartMessage Transport Extension Architecture
+  </text>
+  <!-- Agent99 Layer -->
+  <rect x="50" y="70" width="900" height="80"
+        fill="#2d3748" stroke="#4a5568" stroke-width="2" rx="8"/>
+  <text x="500" y="100" text-anchor="middle" fill="#e2e8f0"
+        font-family="Arial, sans-serif" font-size="18" font-weight="bold">
+    Agent99: Multi-Process Agent Coordination
+  </text>
+  <text x="500" y="125" text-anchor="middle" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="14">
+    Coordinates agent objects across multiple processes executing anywhere
+  </text>
+  <!-- Enhanced BunnyFarm Layer -->
+  <rect x="50" y="170" width="900" height="80"
+        fill="#1a365d" stroke="#2c5282" stroke-width="2" rx="8"/>
+  <text x="500" y="200" text-anchor="middle" fill="#bee3f8"
+        font-family="Arial, sans-serif" font-size="18" font-weight="bold">
+    Enhanced BunnyFarm: Workflow + SmartMessage Integration
+  </text>
+  <text x="500" y="220" text-anchor="middle" fill="#90cdf4"
+        font-family="Arial, sans-serif" font-size="14">
+    Message workflows with transport abstraction capabilities
+  </text>
+  <!-- SmartMessage Core Layer -->
+  <rect x="50" y="270" width="900" height="80"
+        fill="#553c9a" stroke="#7c3aed" stroke-width="2" rx="8"/>
+  <text x="500" y="300" text-anchor="middle" fill="#e9d5ff"
+        font-family="Arial, sans-serif" font-size="18" font-weight="bold">
+    SmartMessage Core: Transport Abstraction + Plugin System
+  </text>
+  <text x="500" y="320" text-anchor="middle" fill="#c4b5fd"
+        font-family="Arial, sans-serif" font-size="14">
+    Core gem with Memory + Redis transports, plugin architecture for extensions
+  </text>
+  <!-- Transport Extensions Layer -->
+  <rect x="50" y="370" width="900" height="120"
+        fill="#1a202c" stroke="#2d3748" stroke-width="2" rx="8"/>
+  <text x="500" y="400" text-anchor="middle" fill="#f7fafc"
+        font-family="Arial, sans-serif" font-size="18" font-weight="bold">
+    Transport Extensions (Plugin Ecosystem)
+  </text>
+  <!-- Core Transports -->
+  <text x="150" y="430" text-anchor="middle" fill="#a0aec0"
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Core Transports
+  </text>
+  <rect x="80" y="440" width="140" height="40"
+        fill="#2f855a" stroke="#48bb78" stroke-width="1" rx="4"/>
+  <text x="150" y="465" text-anchor="middle" fill="#f0fff4"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    Memory
+  </text>
+  <text x="150" y="475" text-anchor="middle" fill="#c6f6d5"
+        font-family="Arial, sans-serif" font-size="9">
+    Single Process
+  </text>
+  <rect x="240" y="440" width="140" height="40"
+        fill="#d69e2e" stroke="#ed8936" stroke-width="1" rx="4"/>
+  <text x="310" y="465" text-anchor="middle" fill="#fffbeb"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    Redis
+  </text>
+  <text x="310" y="475" text-anchor="middle" fill="#fde68a"
+        font-family="Arial, sans-serif" font-size="9">
+    Multi-Process Local
+  </text>
+  <!-- Extension Transports -->
+  <text x="650" y="430" text-anchor="middle" fill="#a0aec0"
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Extension Gems
+  </text>
+  <rect x="420" y="440" width="160" height="40"
+        fill="#7c2d12" stroke="#dc2626" stroke-width="1" rx="4"/>
+  <text x="500" y="460" text-anchor="middle" fill="#fef2f2"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    smart_message-
+  </text>
+  <text x="500" y="470" text-anchor="middle" fill="#fecaca"
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    transport-amqp
+  </text>
+  <text x="500" y="480" text-anchor="middle" fill="#fca5a5"
+        font-family="Arial, sans-serif" font-size="8">
+    Enterprise Reliable
+  </text>
+  <rect x="600" y="440" width="160" height="40"
+        fill="#065f46" stroke="#10b981" stroke-width="1" rx="4"/>
+  <text x="680" y="460" text-anchor="middle" fill="#d1fae5"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    smart_message-
+  </text>
+  <text x="680" y="470" text-anchor="middle" fill="#a7f3d0"
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    transport-lanet
+  </text>
+  <text x="680" y="480" text-anchor="middle" fill="#6ee7b7"
+        font-family="Arial, sans-serif" font-size="8">
+    LAN P2P Direct
+  </text>
+  <rect x="780" y="440" width="160" height="40"
+        fill="#1e40af" stroke="#3b82f6" stroke-width="1" rx="4"/>
+  <text x="860" y="460" text-anchor="middle" fill="#dbeafe"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    smart_message-
+  </text>
+  <text x="860" y="470" text-anchor="middle" fill="#bfdbfe"
+        font-family="Arial, sans-serif" font-size="10" font-weight="bold">
+    transport-nats
+  </text>
+  <text x="860" y="480" text-anchor="middle" fill="#93c5fd"
+        font-family="Arial, sans-serif" font-size="8">
+    High-Perf Distributed
+  </text>
+  <!-- Use Cases -->
+  <rect x="50" y="510" width="900" height="100"
+        fill="#0f172a" stroke="#334155" stroke-width="1" rx="5" opacity="0.9"/>
+  <text x="70" y="535" fill="#f1f5f9"
+        font-family="Arial, sans-serif" font-size="14" font-weight="bold">
+    Transport Selection Strategy:
+  </text>
+  <text x="90" y="555" fill="#10b981"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    Memory:
+  </text>
+  <text x="150" y="555" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="10">
+    Same process agent communication
+  </text>
+  <text x="350" y="555" fill="#ed8936"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    Redis:
+  </text>
+  <text x="390" y="555" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="10">
+    Multi-process, same machine
+  </text>
+  <text x="90" y="575" fill="#dc2626"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    AMQP:
+  </text>
+  <text x="140" y="575" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="10">
+    Enterprise, guaranteed delivery
+  </text>
+  <text x="350" y="575" fill="#10b981"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    Lanet:
+  </text>
+  <text x="395" y="575" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="10">
+    LAN P2P, encrypted, low latency
+  </text>
+  <text x="600" y="575" fill="#3b82f6"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    NATS:
+  </text>
+  <text x="640" y="575" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="10">
+    High-throughput, distributed coordination
+  </text>
+  <text x="90" y="595" fill="#f1f5f9"
+        font-family="Arial, sans-serif" font-size="11" font-weight="bold">
+    Plugin Benefits:
+  </text>
+  <text x="190" y="595" fill="#cbd5e0"
+        font-family="Arial, sans-serif" font-size="10">
+    • Modular architecture • Optional dependencies • Independent evolution • Community ecosystem
+  </text>
+  <!-- Arrows showing flow -->
+  <defs>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7"
+            refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#cbd5e0"/>
+    </marker>
+  </defs>
+  <!-- Flow arrows -->
+  <line x1="500" y1="150" x2="500" y2="165"
+        stroke="#cbd5e0" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <line x1="500" y1="250" x2="500" y2="265"
+        stroke="#cbd5e0" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <line x1="500" y1="350" x2="500" y2="365"
+        stroke="#cbd5e0" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <!-- Gem installation info -->
+  <rect x="50" y="630" width="900" height="50"
+        fill="#1f2937" stroke="#374151" stroke-width="1" rx="5"/>
+  <text x="70" y="650" fill="#f9fafb"
+        font-family="Arial, sans-serif" font-size="12" font-weight="bold">
+    Gem Installation:
+  </text>
+  <text x="70" y="665" fill="#d1d5db"
+        font-family="Arial, sans-serif" font-size="10">
+    gem 'smart_message' # Core + Memory/Redis
+  </text>
+  <text x="300" y="665" fill="#d1d5db"
+        font-family="Arial, sans-serif" font-size="10">
+    gem 'smart_message-transport-amqp' # Enterprise
+  </text>
+  <text x="550" y="665" fill="#d1d5db"
+        font-family="Arial, sans-serif" font-size="10">
+    gem 'smart_message-transport-lanet' # P2P
+  </text>
+  <text x="750" y="665" fill="#d1d5db"
+        font-family="Arial, sans-serif" font-size="10">
+    gem 'smart_message-transport-nats' # Distributed
+  </text>
+</svg>