agent99 0.0.3 → 0.0.5

data/examples/README.md

@@ -1,5 +1,7 @@
 # Agent99 Framework Examples - 86 and the Chief
 
+FYI ... I am in the process of extracting this examples directory out into its own repository:  [MadBomber/agent99_examples](https://github.com/MadBomber/agent99_examples)
+
 This folder contains example implementations using the Agent99 framework. The framework provides a foundation for building AI agents that can communicate with each other through a message-based system.
 
 ## Files
@@ -90,6 +92,40 @@ Note: To use the example_agent.rb, first run the AgentWatcher, then copy example
 
 ## Usage
 
+There are two ways to run the Agent99 examples:
+
+### 🚀 Automated Demo Runner (Recommended)
+
+The easiest way to run examples is with the comprehensive demo runner:
+
+```bash
+./run_demo.rb --list                    # List all available scenarios
+./run_demo.rb                          # Run default 'basic' scenario  
+./run_demo.rb -s basic                  # Basic Maxwell/Chief interaction
+./run_demo.rb -s control                # Control agent demonstration  
+./run_demo.rb -s watcher                # Dynamic agent loading demo
+./run_demo.rb -s security               # Security demonstration (KAOS spy)
+./run_demo.rb -s all                    # Run multiple scenarios in sequence
+./run_demo.rb -v -s basic               # Verbose output
+./run_demo.rb --help                    # Show all options
+```
+
+The demo runner automatically:
+- ✅ Checks dependencies (RabbitMQ, boxes command, etc.)
+- 🏗️ Starts infrastructure (registry service, RabbitMQ if available)
+- 🎬 Orchestrates multiple agents with proper timing
+- 🧹 Handles cleanup on exit or interrupt
+- 📊 Provides progress feedback and duration estimates
+
+**Available Scenarios:**
+- **basic** (~10s): Maxwell Agent86 and Chief interaction
+- **control** (~15s): Control agent managing other agents  
+- **watcher** (~20s): Agent watcher dynamically loading new agents
+- **security** (~10s): KAOS spy demonstration (educational security example)
+- **all** (~60s): Run multiple scenarios in sequence
+
+### 📋 Manual Setup (Original Method)
+
 From the examples directory you will need to start three different processes.  You will want to keep them all in the forgound so it would be best to start them in different terminal windows.
 
 Start the sample registry first: `./registry.rb`
@@ -104,6 +140,20 @@ But first the Chief asks the registry for the UUIDs of all agents who can handle
 
 Run the chief a few times in a roll.  Some times the agent to whom the Chief issues his requests does not always respond the you would expect.
 
+### 🔧 Optional Dependencies
+
+For the best experience, install these optional dependencies:
+
+```bash
+# For message broker (recommended)
+brew install rabbitmq-server
+
+# For enhanced chief agent output
+brew install boxes
+```
+
+**Note:** The framework works without these dependencies using fallback implementations.
+
 ![Agent99 Framework Diagram](diagram.png)
 
 

data/examples/agent_watcher.rb

@@ -28,7 +28,11 @@ require_relative '../lib/agent99'
 class AgentWatcher < Agent99::Base
   TYPE = :client
 
-  def capabilities = %w[ launch_agents watcher launcher ]
+  def capabilities = {
+    info: {
+      capabilities: %w[ launch_agents watcher launcher ]
+    }
+  }
 
   def init
     @watch_path = ENV.fetch('AGENT_WATCH_PATH', './agents')

data/examples/bad_agent.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# examples/bad_agent.rb
+#
+# This agent is meant to cause errors.
+
+require_relative '../lib/agent99'
+
+class BadAgent < Agent99::Base
+  # this information is made available when the agent
+  # registers with the central registry service.  It is
+  # made available during the discovery process.
+  #
+  def info
+    {
+      name:             self.class.to_s,
+      type:             :server,
+      kapabilities:     %w[ rubber_stamp yes_man example ],
+      # request_schema:   {}, # ExampleRequest.schema,
+      # response_schema:  {}, # Agent99::RESPONSE.schema
+      # control_schema:   {}, # Agent99::CONTROL.schema
+      # error_schema:     {}, # Agent99::ERROR.schema
+    }
+  end  
+
+  
+  def receive_request
+    logger.info "Example agent received request: #{payload}"
+    send_response(status: 'success')
+  end
+end
+
+BadAgent.new.run

data/examples/chief_agent.rb

@@ -14,7 +14,23 @@
 require_relative '../lib/agent99'
 
 class ChiefAgent < Agent99::Base
-  TYPE = :client
+  # this information is made available when the agent
+  # registers with the central registry service.  It is
+  # made available during the discovery process.
+  #
+  def info
+    {
+      name:             self.class.to_s,
+      type:             :client,
+      capabilities:     ['Chief of Control'],
+      # request_schema:   ChiefRequest.schema,
+      # response_schema:  {}, # Agent99::RESPONSE.schema
+      # control_schema:   {}, # Agent99::CONTROL.schema
+      # error_schema:     {}, # Agent99::ERROR.schema
+    }
+  end
+
+
 
   # init is called at the end of the initialization process.
   # It may be only something that a :client type agent would do.
@@ -82,11 +98,6 @@ class ChiefAgent < Agent99::Base
 
     exit(0)
   end
-
-
-  def capabilities
-    ['Chief of Control']
-  end
 end
 
 

data/examples/control.rb

@@ -4,7 +4,21 @@
 require_relative '../lib/agent99'
 
 class Control < Agent99::Base
-  TYPE = :hybrid
+  # this information is made available when the agent
+  # registers with the central registry service.  It is
+  # made available during the discovery process.
+  #
+  def info
+    {
+      name:             self.class.to_s,
+      type:             :hybrid,
+      capabilities:     ['control', 'headquarters', 'secret underground base'],
+      # request_schema:   ControlRequest.schema,
+      # response_schema:  {}, # Agent99::RESPONSE.schema
+      # control_schema:   {}, # Agent99::CONTROL.schema
+      # error_schema:     {}, # Agent99::ERROR.schema
+    }
+  end
 
   attr_accessor :statuses
 
@@ -14,11 +28,6 @@ class Control < Agent99::Base
   end
 
 
-  def capabilities
-    ['control', 'headquarters', 'secret underground base']
-  end
-
-
   def send_control_message(message:, payload: {})
     @agents.each do |agent|
       response = @message_client.publish(
@@ -48,7 +57,7 @@ class Control < Agent99::Base
 
 
   def stop_all
-    send_control_message(message: 'stop')
+    send_control_message(message: 'shutdown')
   end
 
   def get_all_status

data/examples/example_agent.rb

@@ -15,9 +15,22 @@
 require_relative '../../lib/agent99'
 
 class ExampleAgent < Agent99::Base
-  TYPE = :server
-  
-  def capabilities = %w[ rubber_stamp yes_man example ]
+  # this information is made available when the agent
+  # registers with the central registry service.  It is
+  # made available during the discovery process.
+  #
+  def info
+    {
+      name:             self.class.to_s,
+      type:             :server,
+      capabilities:     %w[ rubber_stamp yes_man example ],
+      # request_schema:   {}, # ExampleRequest.schema,
+      # response_schema:  {}, # Agent99::RESPONSE.schema
+      # control_schema:   {}, # Agent99::CONTROL.schema
+      # error_schema:     {}, # Agent99::ERROR.schema
+    }
+  end  
+
   
   def receive_request
     logger.info "Example agent received request: #{payload}"

data/examples/maxwell_agent86.rb

@@ -10,12 +10,21 @@ require_relative '../lib/agent99'
 require_relative 'maxwell_request'
 
 class MaxwellAgent86 < Agent99::Base
-  REQUEST_SCHEMA  = MaxwellRequest.schema
-  TYPE            = :server
-
-  # RESPONSE_SCHEMA = Agent99::RESPONSE.schema
-  # ERROR_SCHEMA    = Agent99::ERROR.schema
-
+  # this information is made available when the agent
+  # registers with the central registry service.  It is
+  # made available during the discovery process.
+  #
+  def info
+    {
+      name:             self.class.to_s,
+      type:             :server,
+      capabilities:     %w[ greeter hello_world hello-world hello],
+      request_schema:   MaxwellRequest.schema,
+      # response_schema:  {}, # Agent99::RESPONSE.schema
+      # control_schema:   {}, # Agent99::CONTROL.schema
+      # error_schema:     {}, # Agent99::ERROR.schema
+    }
+  end
 
   #######################################
   private
@@ -90,26 +99,6 @@ class MaxwellAgent86 < Agent99::Base
   def receive_response(response)
     loger.warn("Unexpected response type message: response.inspect")
   end
-
-
-  # Phase One Implementation is to do a search
-  # using the String#include? and the Array#include?
-  # methods.  If you want discrete word-based selection
-  # then use an Array of Strings to define the different
-  # things this agent can do.
-  #
-  # If you want to match on sub-strings then define the
-  # the capabilities as a String.
-  #
-  # Subsequent implementations may use a semantic search
-  # to find the agents to use in which case capabilities may
-  # be constrained to be a String.
-  #
-  # For now, lets just go with the Array of Strings.
-  #
-  def capabilities
-    %w[ greeter hello_world hello-world hello]   
-  end
 end
 
 # Example usage

data/examples/registry.rb

@@ -27,13 +27,14 @@ end
 # Endpoint to register an agent
 post '/register' do
   request.body.rewind
-  agent_info = JSON.parse(request.body.read, symbolize_names: true)
-  agent_name = agent_info[:name]
-  agent_uuid = SecureRandom.uuid
-
-  agent_info[:capabilities].map!{|c| c.downcase}
-
-  AGENT_REGISTRY << agent_info.merge({uuid: agent_uuid})
+  request_data  = JSON.parse(request.body.read, symbolize_names: true)
+  agent_name    = request_data[:name]
+  agent_uuid    = SecureRandom.uuid
+  
+  # Ensure capabilities are lowercase
+  request_data[:capabilities].map!{|c| c.downcase}
+  
+  AGENT_REGISTRY << request_data.merge({uuid: agent_uuid})
 
   status 201
   content_type :json
@@ -47,7 +48,7 @@ get '/discover' do
   capability = params['capability'].downcase
 
   matching_agents = AGENT_REGISTRY.select do |agent|
-    agent[:capabilities].include?(capability)
+    agent[:capabilities]&.include?(capability)
   end
 
   content_type :json
@@ -79,4 +80,4 @@ end
 # Start the Sinatra server
 if __FILE__ == $PROGRAM_NAME
   Sinatra::Application.run!
-end
+end