agent99 0.0.4 → 0.0.5

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: agent99
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Dewayne VanHoozer
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny
@@ -136,6 +135,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: "`agent99` is a Ruby gem designed to facilitate the creation and management
   \nof smart agents, providing a straightforward interface for tasks such \nas natural
   language processing, context handling, and conversing with various AI \nmodels.
@@ -148,42 +161,83 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".envrc"
+- A2A_SPEC-dev.md
 - CHANGELOG.md
+- COMMITS.md
+- DOCS.md
 - LICENSE
 - README.md
 - Rakefile
-- docs/README.md
-- docs/advanced_features.md
+- docs/AI/htm.md
+- docs/AI/htm.rb
+- docs/AI/htm_demo.db
+- docs/AI/notes_on_htm_implementation.md
+- docs/AI/some_code.rb
+- docs/advanced-topics/a2a-protocol.md
+- docs/advanced-topics/advanced-features.md
+- docs/advanced-topics/control-actions.md
+- docs/advanced-topics/extending-the-framework.md
+- docs/advanced-topics/model-context-protocol.md
+- docs/advanced-topics/multi-agent-processing.md
+- docs/agent-development/custom-agent-implementation.md
+- docs/agent-development/error-handling-and-logging.md
+- docs/agent-development/request-response-handling.md
+- docs/agent-development/schema-definition.md
 - docs/agent99_framework/central_registry.md
 - docs/agent99_framework/message_client.md
 - docs/agent99_framework/registry_client.md
-- docs/agent_discovery.md
-- docs/agent_lifecycle.md
-- docs/agent_registry_processes.md
-- docs/api_reference.md
-- docs/architecture.md
-- docs/breaking_change_v0.0.4.md
-- docs/configuration.md
-- docs/control_actions.md
-- docs/custom_agent_implementation.md
-- docs/diagrams/agent_registry_processes.dot
-- docs/diagrams/agent_registry_processes.png
-- docs/diagrams/high_level_architecture.dot
-- docs/diagrams/high_level_architecture.png
-- docs/diagrams/request_flow.dot
-- docs/diagrams/request_flow.png
-- docs/error_handling_and_logging.md
-- docs/extending_the_framework.md
-- docs/message_processing.md
-- docs/messaging_system.md
-- docs/preformance_considerations.md
-- docs/schema_definition.md
-- docs/security.md
-- docs/troubleshooting.md
-- docs/what_is_an_agent.md
+- docs/api-reference/agent99-base.md
+- docs/api-reference/message-clients.md
+- docs/api-reference/overview.md
+- docs/api-reference/registry-client.md
+- docs/api-reference/schemas.md
+- docs/assets/css/custom.css
+- docs/assets/images/agent-lifecycle.svg
+- docs/assets/images/agent-registry-process.svg
+- docs/assets/images/agent-registry-processes.svg
+- docs/assets/images/agent-types-overview.svg
+- docs/assets/images/agent99-architecture.svg
+- docs/assets/images/agent99_logo.png
+- docs/assets/images/control-actions-state.svg
+- docs/assets/images/knowledge-graph.svg
+- docs/assets/images/message-processing-flow.svg
+- docs/assets/images/multi-agent-system.svg
+- docs/assets/images/proxy-pattern-sequence.svg
+- docs/assets/images/request-flow.svg
+- docs/assets/images/request-processing-lifecycle.svg
+- docs/assets/images/request-response-sequence.svg
+- docs/core-concepts/agent-lifecycle.md
+- docs/core-concepts/agent-types.md
+- docs/core-concepts/architecture.md
+- docs/core-concepts/what-is-an-agent.md
+- docs/diagrams/message-flow-sequence.svg
+- docs/diagrams/p2p-network-topology.svg
+- docs/diagrams/smart-transport-routing.svg
+- docs/diagrams/three-layer-architecture.svg
+- docs/diagrams/transport-extension-api.svg
+- docs/diagrams/transport-extension-architecture.svg
+- docs/diagrams/transport-selection-flowchart.svg
+- docs/examples/advanced-examples.md
+- docs/examples/basic-examples.md
+- docs/framework-components/agent-discovery.md
+- docs/framework-components/agent-registry.md
+- docs/framework-components/message-processing.md
+- docs/framework-components/messaging-system.md
+- docs/getting-started/basic-example.md
+- docs/getting-started/installation.md
+- docs/getting-started/overview.md
+- docs/getting-started/quick-start.md
+- docs/index.md
+- docs/operations/breaking-changes.md
+- docs/operations/configuration.md
+- docs/operations/performance-considerations.md
+- docs/operations/security.md
+- docs/operations/troubleshooting.md
+- examples/DEMO.md
 - examples/README.md
 - examples/agent_watcher.rb
 - examples/agents/.keep
+- examples/bad_agent.rb
 - examples/chief_agent.rb
 - examples/control.rb
 - examples/diagram.dot
@@ -193,6 +247,7 @@ files:
 - examples/maxwell_agent86.rb
 - examples/maxwell_request.rb
 - examples/registry.rb
+- examples/run_demo.rb
 - examples/start_rabbitmq_and_registry.sh
 - lib/agent99.rb
 - lib/agent99/.irbrc
@@ -209,6 +264,10 @@ files:
 - lib/agent99/tcp_message_client.rb
 - lib/agent99/timestamp.rb
 - lib/agent99/version.rb
+- mkdocs.yml
+- p2p_plan.md
+- p2p_roadmap.md
+- registry_plan.md
 - sig/ai_agent.rbs
 homepage: https://github.com/MadBomber/agent99
 licenses:
@@ -218,7 +277,6 @@ metadata:
   homepage_uri: https://github.com/MadBomber/agent99
   source_code_uri: https://github.com/MadBomber/agent99
   changelog_uri: https://github.com/MadBomber/agent99/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -234,8 +292,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.7.1
 specification_version: 4
 summary: An intelligent agent framework for Ruby
 test_files: []

data/docs/README.md

@@ -1,57 +0,0 @@
-# Agent99 Framework Documentation
-
-Welcome to the Agent99 Framework documentation! Below is a table of contents and brief summaries of each markdown file available in this directory.  Explore each document for more detailed information on the Agent99 Framework and how to effectively utilize it in your projects!
-
-## Table of Contents
-
-1. **[Agent Discovery](agent_discovery.md)**
-      - This document explains how agents within the Agent99 framework discover each other based on their declared capabilities, including the registration and querying processes involved.
-
-2. **[Agent Lifecycle](agent_lifecycle.md)**
-      - Learn about the various stages an agent undergoes during its lifetime, from creation and initialization to running and graceful shutdown.
-
-3. **[Agent Registry Processes](agent_registry_processes.md)**
-      - This file details the processes handled by the Agent registry, including registration, discovery, and withdrawal of agents, along with example code to illustrate these concepts.
-
-4. **[API Reference](api_reference.md)**
-      - The API Reference provides comprehensive details about public methods and classes within Agent99, ensuring developers can leverage its full capabilities.
-
-5. **[Architecture Overview](architecture_overview.md)**
-      - An overview of the architecture of Agent99, describing its microservices-oriented structure, communication workflows, and how agents operate within the system.
-
-6. **[Configuration](configuration.md)**
-      - Discover how to configure agents using environment variables, including important settings such as the registry base URL.
-
-7. **[Control Actions](control_actions.md)**
-      - This document lists the control actions available to agents, such as shutdown, pause, and resume, along with instructions on how to create custom actions.
-
-8. **[Custom Agent Implementation](custom_agent_implementation.md)**
-      - Guidelines on creating custom agents, including subclassing, defining schemas, and implementing request and response handling.
-
-9. **[Error Handling and Logging](error_handling_and_logging.md)**
-      - Understanding the error handling mechanisms in Agent99, as well as how to configure logging for better monitoring and debugging.
-
-10. **[Extending the Framework](extending_the_framework.md)**
-      - Instructions on how to extend Agent99 by implementing custom modules, defining new message types, and using hooks for additional functionality.
-
-11. **[Message Processing](message_processing.md)**
-      - This document outlines the different message types supported by Agent99, how they are processed, and the importance of schema validation.
-
-12. **[Messaging Systems](messaging_systems.md)**
-      - Overview of the messaging protocols supported by Agent99, including AMQP and NATS, and guidance on how to switch between them.
-
-13. **[Advanced Features](advanced_features.md)**
-      - Learn about dynamic agent loading, multi-agent processing, and best practices for running multiple agents within the same process.
-
-14. **[Performance Considerations](performance_considerations.md)**
-      - Best practices for ensuring optimal performance within the framework, including optimization techniques and profiling performance.
-
-15. **[Schema Definition](schema_definition.md)**
-      - Detailed instructions on how to define schemas using `SimpleJsonSchemaBuilder`, with examples to guide you through the process.
-
-16. **[Security](security.md)**
-      - Recommendations on implementing security measures within Agent99, focusing on message encryption and access control.
-
-17. **[Troubleshooting](troubleshooting.md)**
-      - Common issues encountered while using Agent99 and suggested steps for debugging, including examining logs and configuration settings.
-

data/docs/diagrams/agent_registry_processes.dot

@@ -1,42 +0,0 @@
-digraph AgentRegistration {
-  rankdir=LR;
-  node [shape=box, style=rounded];
-  edge [fontsize=10];
-
-  MyAgent [label="MyAgent"];
-  RegistryClient [label="RegistryClient"];
-  CentralRegistry [label="Central Registry\n(Sinatra Server)"];
-
-  subgraph cluster_registration {
-    label="Registration Process";
-    color=lightgrey;
-    style=filled;
-
-    MyAgent -> RegistryClient [label="1. initialize"];
-    RegistryClient -> CentralRegistry [label="2. POST /register\n{name, capabilities}"];
-    CentralRegistry -> RegistryClient [label="3. 201 Created\n{uuid}"];
-    RegistryClient -> MyAgent [label="4. Return uuid"];
-  }
-
-  subgraph cluster_discovery {
-    label="Discovery Process";
-    color=lightblue;
-    style=filled;
-
-    MyAgent -> RegistryClient [label="5. discover(capability)"];
-    RegistryClient -> CentralRegistry [label="6. GET /discover?capability=..."];
-    CentralRegistry -> RegistryClient [label="7. 200 OK\n[matching agents]"];
-    RegistryClient -> MyAgent [label="8. Return matching agents"];
-  }
-
-  subgraph cluster_withdrawal {
-    label="Withdrawal Process";
-    color=lightpink;
-    style=filled;
-
-    MyAgent -> RegistryClient [label="9. withdraw(uuid)"];
-    RegistryClient -> CentralRegistry [label="10. DELETE /withdraw/:uuid"];
-    CentralRegistry -> RegistryClient [label="11. 204 No Content"];
-    RegistryClient -> MyAgent [label="12. Confirm withdrawal"];
-  }
-}

data/docs/diagrams/high_level_architecture.dot

@@ -1,26 +0,0 @@
-digraph Agent99Architecture {
-    rankdir=LR;
-    node [shape=box, style=rounded];
-    
-    subgraph cluster_0 {
-        label="Agent99 Framework";
-        style=dashed;
-        
-        Agent1 [label="Agent 1\n(Client)"];
-        Agent2 [label="Agent 2\n(Server)"];
-        Agent3 [label="Agent 3\n(Hybrid)"];
-    }
-    
-    Registry [shape=cylinder, label="Registry\nService"];
-    MessageBroker [shape=diamond, label="Message Broker\n(AMQP/NATS)"];
-    
-    // Registration flows
-    Agent1 -> Registry [label="register/discover", style=dashed];
-    Agent2 -> Registry [label="register/discover", style=dashed];
-    Agent3 -> Registry [label="register/discover", style=dashed];
-    
-    // Message flows
-    Agent1 -> MessageBroker [dir=both, label="publish/subscribe"];
-    Agent2 -> MessageBroker [dir=both, label="publish/subscribe"];
-    Agent3 -> MessageBroker [dir=both, label="publish/subscribe"];
-}

data/docs/diagrams/request_flow.dot

@@ -1,42 +0,0 @@
-digraph RequestFlow {
-    rankdir=TB;
-    node [shape=box, style=rounded];
-    
-    // Message arrival and initial processing
-    start [shape=oval, label="Message Arrives"];
-    dispatch [label="dispatcher()\nMessage Processing Loop"];
-    process [label="process_request(message)"];
-    validate [label="validate_schema()"];
-    
-    // Main processing branch
-    receive [label="receive_request()\nAgent Implementation"];
-    send [label="send_response()\nOptional Response"];
-    
-    // Error handling branch
-    error [label="Error Handler"];
-    error_response [label="Send Error Response"];
-    
-    // Flow connections
-    start -> dispatch;
-    dispatch -> process;
-    process -> validate;
-    
-    // Success path
-    validate -> receive [label="Valid"];
-    receive -> send [style=dashed];
-    
-    // Error path
-    validate -> error [label="Invalid"];
-    error -> error_response;
-    
-    // Styling
-    {
-        node [shape=note, style=filled, fillcolor=lightyellow];
-        note1 [label="Schema validation\nensures message\nintegrity"];
-        note2 [label="Custom processing\nin agent subclass"];
-    }
-    
-    // Connect notes
-    validate -> note1 [style=dotted, arrowhead=none];
-    receive -> note2 [style=dotted, arrowhead=none];
-}