robot_lab 0.3.0 → 0.5.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: robot_lab
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -41,16 +41,22 @@ dependencies:
   name: ruby_llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.1.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.1.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: ruby_llm-providers-apfel
   requirement: !ruby/object:Gem::Requirement
@@ -149,34 +155,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: async-http
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.60'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.60'
-- !ruby/object:Gem::Dependency
-  name: async-websocket
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.30'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.30'
 description: |
   RobotLab is a Ruby framework for building and orchestrating multi-robot LLM workflows.
   Built on ruby_llm, it provides robots with template-based prompts, tools, and shared
@@ -192,253 +170,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".architecture/AGENTS.md"
-- ".architecture/config.yml"
-- ".architecture/members.yml"
-- ".architecture/reviews/feature-free-will.md"
-- ".architecture/reviews/overall-codebase.md"
-- ".claude/settings.local.json"
-- ".codex/config.toml"
-- ".envrc"
-- ".github/workflows/deploy-github-pages.yml"
-- ".irbrc"
-- ".loki"
-- ".quality/reek_baseline.txt"
-- ".rubocop.yml"
-- Archspec.rb
 - CHANGELOG.md
-- CLAUDE.md
-- COMMITS.md
 - LICENSE.txt
 - README.md
-- Rakefile
-- _typos.toml
-- agent2agent_review.md
-- agentf_improvements.md
-- agents.md
-- docs/api/core/index.md
-- docs/api/core/memory.md
-- docs/api/core/network.md
-- docs/api/core/result.md
-- docs/api/core/robot.md
-- docs/api/core/state.md
-- docs/api/core/tool.md
-- docs/api/errors.md
-- docs/api/hooks.md
-- docs/api/index.md
-- docs/api/mcp/client.md
-- docs/api/mcp/index.md
-- docs/api/mcp/server.md
-- docs/api/mcp/transports.md
-- docs/api/messages/index.md
-- docs/api/messages/text-message.md
-- docs/api/messages/tool-call-message.md
-- docs/api/messages/tool-result-message.md
-- docs/api/messages/user-message.md
-- docs/api/skills.md
-- docs/api/streaming/context.md
-- docs/api/streaming/events.md
-- docs/api/streaming/index.md
-- docs/api/support.md
-- docs/architecture/core-concepts.md
-- docs/architecture/index.md
-- docs/architecture/message-flow.md
-- docs/architecture/network-orchestration.md
-- docs/architecture/robot-execution.md
-- docs/architecture/state-management.md
-- docs/assets/css/custom.css
-- docs/assets/images/robot_lab.jpg
-- docs/concepts.md
-- docs/examples/basic-chat.md
-- docs/examples/index.md
-- docs/examples/mcp-server.md
-- docs/examples/multi-robot-network.md
-- docs/examples/tool-usage.md
-- docs/getting-started/configuration.md
-- docs/getting-started/index.md
-- docs/getting-started/installation.md
-- docs/getting-started/quick-start.md
-- docs/guides/building-robots.md
-- docs/guides/creating-networks.md
-- docs/guides/hooks.md
-- docs/guides/index.md
-- docs/guides/knowledge.md
-- docs/guides/mcp-integration.md
-- docs/guides/memory.md
-- docs/guides/observability.md
-- docs/guides/streaming.md
-- docs/guides/using-tools.md
-- docs/index.md
-- docs/superpowers/plans/2026-05-06-agentskills.md
-- docs/superpowers/specs/2026-05-06-agentskills-design.md
-- examples/.envrc
-- examples/01_simple_robot.rb
-- examples/02_tools.rb
-- examples/03_network.rb
-- examples/04_mcp.rb
-- examples/05_streaming.rb
-- examples/06_prompt_templates.rb
-- examples/07_network_memory.rb
-- examples/08_llm_config.rb
-- examples/09_chaining.rb
-- examples/10_memory.rb
-- examples/11_network_introspection.rb
-- examples/12_message_bus.rb
-- examples/13_spawn.rb
-- examples/14_rusty_circuit/.envrc
-- examples/14_rusty_circuit/.gitignore
-- examples/14_rusty_circuit/README.md
-- examples/14_rusty_circuit/comic.rb
-- examples/14_rusty_circuit/display.rb
-- examples/14_rusty_circuit/heckler.rb
-- examples/14_rusty_circuit/open_mic.rb
-- examples/14_rusty_circuit/prompts/open_mic_comic.md
-- examples/14_rusty_circuit/prompts/open_mic_heckler.md
-- examples/14_rusty_circuit/prompts/open_mic_scout.md
-- examples/14_rusty_circuit/scout.rb
-- examples/14_rusty_circuit/show.log
-- examples/15_memory_network_and_bus/.envrc
-- examples/15_memory_network_and_bus/README.md
-- examples/15_memory_network_and_bus/editor_in_chief.rb
-- examples/15_memory_network_and_bus/editorial_pipeline.rb
-- examples/15_memory_network_and_bus/linux_writer.rb
-- examples/15_memory_network_and_bus/os_editor.rb
-- examples/15_memory_network_and_bus/os_writer.rb
-- examples/15_memory_network_and_bus/output/combined_article.md
-- examples/15_memory_network_and_bus/output/final_article.md
-- examples/15_memory_network_and_bus/output/linux_draft.md
-- examples/15_memory_network_and_bus/output/mac_draft.md
-- examples/15_memory_network_and_bus/output/memory.json
-- examples/15_memory_network_and_bus/output/revision_1.md
-- examples/15_memory_network_and_bus/output/revision_2.md
-- examples/15_memory_network_and_bus/output/revision_3.md
-- examples/15_memory_network_and_bus/output/windows_draft.md
-- examples/15_memory_network_and_bus/prompts/os_advocate.md
-- examples/15_memory_network_and_bus/prompts/os_chief.md
-- examples/15_memory_network_and_bus/prompts/os_editor.md
-- examples/16_writers_room/.envrc
-- examples/16_writers_room/display.rb
-- examples/16_writers_room/output/.gitignore
-- examples/16_writers_room/output/README.md
-- examples/16_writers_room/output/opus_001.md
-- examples/16_writers_room/output/opus_001_notes.log
-- examples/16_writers_room/output/opus_002.md
-- examples/16_writers_room/output/opus_002_notes.log
-- examples/16_writers_room/output/opus_002_screenplay.md
-- examples/16_writers_room/output/opus_002_screenplay_notes.md
-- examples/16_writers_room/prompts/screenplay_writer.md
-- examples/16_writers_room/prompts/writer.md
-- examples/16_writers_room/room.rb
-- examples/16_writers_room/tools.rb
-- examples/16_writers_room/writer.rb
-- examples/16_writers_room/writers_room.rb
-- examples/17_skills.rb
-- examples/18_rails/.envrc
-- examples/18_rails/.gitignore
-- examples/18_rails/Gemfile
-- examples/18_rails/README.md
-- examples/18_rails/Rakefile
-- examples/18_rails/app/controllers/application_controller.rb
-- examples/18_rails/app/controllers/chat_controller.rb
-- examples/18_rails/app/jobs/application_job.rb
-- examples/18_rails/app/jobs/robot_run_job.rb
-- examples/18_rails/app/models/application_record.rb
-- examples/18_rails/app/models/robot_lab_result.rb
-- examples/18_rails/app/models/robot_lab_thread.rb
-- examples/18_rails/app/robots/chat_robot.rb
-- examples/18_rails/app/tools/time_tool.rb
-- examples/18_rails/app/views/chat/_user_message.html.erb
-- examples/18_rails/app/views/chat/index.html.erb
-- examples/18_rails/app/views/layouts/application.html.erb
-- examples/18_rails/bin/dev
-- examples/18_rails/bin/rails
-- examples/18_rails/bin/setup
-- examples/18_rails/config.ru
-- examples/18_rails/config/application.rb
-- examples/18_rails/config/cable.yml
-- examples/18_rails/config/database.yml
-- examples/18_rails/config/environment.rb
-- examples/18_rails/config/initializers/robot_lab.rb
-- examples/18_rails/config/routes.rb
-- examples/18_rails/db/migrate/001_create_robot_lab_tables.rb
-- examples/19_token_tracking.rb
-- examples/20_circuit_breaker.rb
-- examples/21_learning_loop.rb
-- examples/22_context_compression.rb
-- examples/23_convergence.rb
-- examples/24_structured_delegation.rb
-- examples/25_history_search.rb
-- examples/25_history_search/conversation.jsonl
-- examples/26_document_store.rb
-- examples/26_document_store/api_versioning_adr.md
-- examples/26_document_store/incident_postmortem.md
-- examples/26_document_store/postgres_runbook.md
-- examples/26_document_store/redis_caching_guide.md
-- examples/26_document_store/sidekiq_guide.md
-- examples/27_incident_response/README.md
-- examples/27_incident_response/incident_response.rb
-- examples/28_mcp_discovery.rb
-- examples/29_ractor_tools.rb
-- examples/30_ractor_network.rb
-- examples/31_launch_assessment.rb
-- examples/32_newsletter_reader.rb
-- examples/33_stock_generator.rb
-- examples/33_stock_predictor.rb
-- examples/34_agentskills.rb
-- examples/35_hooks.rb
-- examples/README.md
-- examples/common.rb
-- examples/prompts/assistant.md
-- examples/prompts/audit_trail.md
-- examples/prompts/billing.md
-- examples/prompts/classifier.md
-- examples/prompts/comedian.md
-- examples/prompts/comedy_critic.md
-- examples/prompts/configurable.md
-- examples/prompts/dispatcher.md
-- examples/prompts/entity_extractor.md
-- examples/prompts/escalation.md
-- examples/prompts/frontmatter_mcp_test.md
-- examples/prompts/frontmatter_named_test.md
-- examples/prompts/frontmatter_tools_test.md
-- examples/prompts/general.md
-- examples/prompts/github_assistant.md
-- examples/prompts/helper.md
-- examples/prompts/incident_responder.md
-- examples/prompts/keyword_extractor.md
-- examples/prompts/llm_config_demo.md
-- examples/prompts/order_support.md
-- examples/prompts/os_advocate.md
-- examples/prompts/os_chief.md
-- examples/prompts/os_editor.md
-- examples/prompts/parameterized_main_test.md
-- examples/prompts/pii_redactor.md
-- examples/prompts/product_support.md
-- examples/prompts/runbook_protocol.md
-- examples/prompts/sentiment_analyzer.md
-- examples/prompts/skill_a_test.md
-- examples/prompts/skill_b_test.md
-- examples/prompts/skill_config_test.md
-- examples/prompts/skill_cycle_a_test.md
-- examples/prompts/skill_cycle_b_test.md
-- examples/prompts/skill_description_test.md
-- examples/prompts/skill_leaf_test.md
-- examples/prompts/skill_nested_test.md
-- examples/prompts/skill_refs_main_test.md
-- examples/prompts/skill_self_ref_test.md
-- examples/prompts/skill_with_mcp_test.md
-- examples/prompts/skill_with_params_test.md
-- examples/prompts/skill_with_robot_name_test.md
-- examples/prompts/skill_with_tools_test.md
-- examples/prompts/sre_compliance.md
-- examples/prompts/structured_output.md
-- examples/prompts/synthesizer.md
-- examples/prompts/technical.md
-- examples/prompts/template_with_skills_test.md
-- examples/prompts/triage.md
-- examples/ruboruby.md
-- examples/run_all.rb
-- examples/xyzzy.rb
 - lib/robot_lab.rb
 - lib/robot_lab/agent_skill.rb
 - lib/robot_lab/agent_skill_catalog.rb
@@ -458,15 +192,10 @@ files:
 - lib/robot_lab/hook_context.rb
 - lib/robot_lab/hook_registry.rb
 - lib/robot_lab/hooks.rb
-- lib/robot_lab/mcp/client.rb
-- lib/robot_lab/mcp/connection_poller.rb
+- lib/robot_lab/mcp.rb
+- lib/robot_lab/mcp/registry.rb
 - lib/robot_lab/mcp/server.rb
 - lib/robot_lab/mcp/server_discovery.rb
-- lib/robot_lab/mcp/transports/base.rb
-- lib/robot_lab/mcp/transports/sse.rb
-- lib/robot_lab/mcp/transports/stdio.rb
-- lib/robot_lab/mcp/transports/streamable_http.rb
-- lib/robot_lab/mcp/transports/websocket.rb
 - lib/robot_lab/memory.rb
 - lib/robot_lab/memory_change.rb
 - lib/robot_lab/message.rb
@@ -482,6 +211,7 @@ files:
 - lib/robot_lab/robot/mcp_management.rb
 - lib/robot_lab/robot/result_building.rb
 - lib/robot_lab/robot/template_rendering.rb
+- lib/robot_lab/robot/tool_call_gating.rb
 - lib/robot_lab/robot_message.rb
 - lib/robot_lab/robot_result.rb
 - lib/robot_lab/run_config.rb
@@ -500,13 +230,7 @@ files:
 - lib/robot_lab/utils.rb
 - lib/robot_lab/version.rb
 - lib/robot_lab/waiter.rb
-- logfile
-- mkdocs.yml
-- robot_concurrency.md
 - sig/robot_lab.rbs
-- simple_acp_review.md
-- temp.md
-- tool_manifest_plan.md
 homepage: https://github.com/MadBomber/robot_lab
 licenses:
 - MIT
@@ -525,14 +249,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 4.0.9
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.21
+rubygems_version: 4.0.23
 specification_version: 4
 summary: Ruby framework for building and orchestrating multi-robot LLM workflows
 test_files: []

data/.architecture/AGENTS.md

@@ -1,32 +0,0 @@
-### Local Agent Context: .architecture
-
-# Setup & Commands — Exact commands + required env vars.
-
-- Configure project: Verify `project_name` and `version` in `.architecture/config.yml` are correct for current setup.
-- Quarterly review schedule is enforced automatically; ensure `review_schedule` is set to `quarterly` in `.architecture/config.yml`.
-
-# Code Style & Patterns — Must-follow conventions, backticked.
-
-- Ensure any new architectural documentation follows the naming pattern in `.architecture/reviews`.
-- For member roles, adhere to the structured format in `.architecture/members.yml` with fields like `id`, `name`, `title`, and `specialties`.
-- Document architectural reviews extensively, mirroring the detailed style found in `.architecture/reviews/feature-free-will.md`.
-
-# Implementation Details — Entry files + compressed playbooks (job/env/rollout).
-
-## Architectural Review Process
-
-1. **Conduct Review**:
-   - Read current state and previous findings in `.architecture/reviews/overall-codebase.md`.
-   - Compare changes and new resolutions against previous entries like `.architecture/reviews/feature-free-will.md`.
-
-2. **Document Review**:
-   - Record new findings and updates in a new markdown file within `.architecture/reviews/`.
-   - Follow the format example in existing review files for consistency and effectiveness.
-
-3. **Remove Dead Code**:
-   - Audit `network:` parameter usage in relevant function calls.
-   - Remove unused parameters and adjust corresponding method calls as documented in reviews.
-
-_Warning_: Removing architectural elements based on outdated assumptions can be destructive.
-
-By following these structured guidelines and file-specific practices, maintain a coherent and robust architectural documentation process inside the `.architecture` directory.

data/.architecture/config.yml

@@ -1,8 +0,0 @@
-project_name: RobotLab
-version: 0.0.5
-review_schedule: quarterly
-pragmatic_mode:
-  enabled: true
-  applies_to:
-    - reviews
-    - adrs

data/.architecture/members.yml

@@ -1,60 +0,0 @@
-members:
-  - id: systems_architect
-    name: Systems Architect
-    title: Principal Systems Architect
-    specialties:
-      - module decomposition
-      - dependency management
-      - API surface design
-      - Zeitwerk autoloading
-    perspective: Evaluates overall structure, module boundaries, and dependency flow
-
-  - id: concurrency_specialist
-    name: Concurrency Specialist
-    title: Async & Concurrency Engineer
-    specialties:
-      - async/await patterns
-      - fiber-based concurrency
-      - race condition prevention
-      - message bus architectures
-    perspective: Analyzes async patterns, race conditions, and message ordering guarantees
-
-  - id: api_design_lead
-    name: API Design Lead
-    title: Developer Experience Architect
-    specialties:
-      - public API ergonomics
-      - configuration hierarchies
-      - builder patterns
-      - Ruby idioms
-    perspective: Evaluates public API surface, developer experience, and Ruby idiomaticness
-
-  - id: reliability_engineer
-    name: Reliability Engineer
-    title: Error Handling & Resilience Specialist
-    specialties:
-      - error hierarchies
-      - retry/backoff strategies
-      - graceful degradation
-      - state machine correctness
-    perspective: Assesses error handling, failure modes, and system resilience
-
-  - id: testing_strategist
-    name: Testing Strategist
-    title: Quality Assurance Architect
-    specialties:
-      - test coverage analysis
-      - integration vs unit testing
-      - mock strategies
-      - CI reliability
-    perspective: Reviews test architecture, coverage gaps, and testing patterns
-
-  - id: pragmatic_enforcer
-    name: Pragmatic Enforcer
-    title: YAGNI & Simplicity Advocate
-    specialties:
-      - over-engineering detection
-      - complexity budgets
-      - deferred decisions
-      - MVP scoping
-    perspective: Challenges unnecessary complexity and advocates for simplest viable solutions