robot_lab-a2a 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35293bad787439bd0df0a795e18cc14422c5e1a9bf513e1482c5cafdb52b11e0
-  data.tar.gz: fc1830e74ae5570420684c3728652241726484cf5c73e8d2b027d7bfb0f20275
+  metadata.gz: 6c741a3c521ca8442b326ef4bff336e8bcc5daaab9075055fda53dba9f57a50c
+  data.tar.gz: 06e2356682717b7e281fb738be8923e0cf8b0189b341b0aa9d7f9baacc76b8b6
 SHA512:
-  metadata.gz: 7e4cd7143ca99b4df4af69ea6a2ab189cc936eb638b5b0237e68d99ed697a82f70afb7a7856609682980c3069c61dbe0a4454f70a2de1c20282fcfa82732317a
-  data.tar.gz: ef3cd22a82035f60dfb3c491e552d35b3a73ee169e87dad449d9456442c77f9c60ea4fbd8e5180c188f9e256db5c813196aeba27950213f11ef820b20b41d8b0
+  metadata.gz: 34c7333a443240f595631ca7299f0ab3f57f87d0542b2a67c20f92909d12459ab98d5eee0e1aa434eee6041793230817e08a099c0db926fa47c956bff412aae9
+  data.tar.gz: a982730ee7ab5c12b2b01f6c5ba90fcf550ee2753a01bd9026a73a2658e9f630af6f6217a74c4aa1fa2c10827d37eae521bb3730ece0d002b56ebef154738c29

data/.envrc

@@ -1,3 +1,6 @@
+# robot_lab_project/robot_lab-a2a/.envrc
+
 source_up
+
 export RR=`pwd`
 export BUNDLE_GEMFILE=Gemfile

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.8] - 2026-09-09
+
+Released in lockstep with `robot_lab` core v0.2.8: this gem now resolves the released core gem from RubyGems instead of the local sibling checkout (local-path development remains available via `BUNDLE_GEMFILE=Gemfile.local`). Also in this release: reek warnings triaged to zero, and the gem lifecycle tasks (build/install/release) moved from the Rakefile to the asgard task runner.
+
 ### Added
 - `.loki` Asgard task file: `test`, `rubocop`, `rubocop_fix`, `flog`, `flay`, `quality`, `build`, `install`, `release`, and `console` tasks via the Asgard task runner
 - `flay_check` Rake task: structural code duplication gate (mass threshold 50); integrated into the `quality` Rake task

data/CLAUDE.md

@@ -10,8 +10,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ```bash
 rake test              # Run full test suite (default rake task)
-rake build             # Build the gem package
-rake install           # Install gem locally
+asgard build           # Build the gem package
+asgard install         # Install gem locally
 
 bin/setup              # Install dependencies
 bin/console            # IRB session with gem loaded

data/README.md

@@ -85,8 +85,8 @@ Full documentation lives in [`docs/`](docs/):
 ```bash
 bin/setup        # install dependencies
 rake test        # run the full test suite
-rake quality     # static analysis (if configured)
-rake build       # build the gem package
+asgard quality   # static analysis quality gates
+asgard build     # build the gem package
 ```
 
 Run a single test file:

data/Rakefile

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'bundler/gem_tasks'
 require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|

data/lib/robot_lab/a2a/ask_user_tool.rb

@@ -18,6 +18,12 @@ module RobotLab
 
       attr_writer :event_queue, :answer_queue
 
+      def initialize(robot: nil)
+        super
+        @event_queue  = nil
+        @answer_queue = nil
+      end
+
       def execute(question:, choices: nil, default: nil)
         raise 'A2A queues not injected — use RobotLab::A2A::RobotAdapter' unless @event_queue
 

data/lib/robot_lab/a2a/io_bridge.rb

@@ -56,20 +56,23 @@ module RobotLab
       # --- input side (robot.input) ---
 
       def gets
-        prompt_text = @buffer_mutex.synchronize do
-          text = @output_buffer.dup.strip
-          @output_buffer.clear
-          text
-        end
-
-        prompt = ::A2A::Models::Message.agent(
-          prompt_text.empty? ? 'Input required:' : prompt_text
-        )
-        @event_queue.push({ type: :ask, prompt: prompt })
+        prompt = ::A2A::Models::Message.agent(drain_prompt_text)
+        @event_queue.push({ type: :ask, prompt: })
 
         answer = @answer_queue.pop
         "#{answer}\n"
       end
+
+      private
+
+      # Atomically empty the output buffer and return its text as the prompt.
+      def drain_prompt_text
+        @buffer_mutex.synchronize do
+          text = @output_buffer.dup.strip
+          @output_buffer.clear
+          text.empty? ? 'Input required:' : text
+        end
+      end
     end
   end
 end

data/lib/robot_lab/a2a/network_adapter.rb

@@ -8,6 +8,8 @@ module RobotLab
     # per-robot queue injection across all network robots, planned for a future
     # release. Wrap individual robots with RobotAdapter for interactive flows.
     class NetworkAdapter < ::A2A::Server::AgentExecutor
+      # :reek:ControlParameter -- interactive is only validated here; anything
+      # but :none is rejected with a pointer to RobotAdapter.
       def initialize(network, interactive: :none)
         super()
         if interactive != :none
@@ -19,6 +21,8 @@ module RobotLab
         @network = network
       end
 
+      # :reek:FeatureEnvy -- AgentExecutor protocol method: it drives the task
+      # lifecycle (start/complete/emit) on the request context handed to it.
       def call(context)
         context.task.start!
         context.emit_status

data/lib/robot_lab/a2a/registry.rb

@@ -4,6 +4,9 @@ module RobotLab
   module A2A
     # Tracks live robot threads for in-progress interactive runs.
     # Keyed by A2A task_id. Entries are removed when the robot thread finishes.
+    #
+    # :reek:InstanceVariableAssumption -- @mutex and @entries are class-level
+    # singleton state, assigned once in the class body; there is no #initialize.
     class Registry
       Entry = Data.define(:thread, :event_queue, :answer_queue)
 

data/lib/robot_lab/a2a/robot_adapter.rb

@@ -16,6 +16,11 @@ module RobotLab
     #
     # Interactive modes keep the robot thread alive between A2A INPUT_REQUIRED
     # and resume. Only works with in-process (Memory) storage.
+    #
+    # :reek:DataClump -- robot plus its event/answer queue pair thread through
+    # the per-mode injection helpers; a wrapper object would outlive its one use.
+    # :reek:RepeatedConditional -- @interactive is the adapter's mode switch;
+    # run, setup and teardown each dispatch on it once.
     class RobotAdapter < ::A2A::Server::AgentExecutor
       VALID_MODES = %i[none a2a_tool io_bridge].freeze
 
@@ -55,6 +60,8 @@ module RobotLab
 
       # ── :none mode ────────────────────────────────────────────
 
+      # :reek:FeatureEnvy -- executor lifecycle: drives start/complete/emit on
+      # the request context handed to it by the A2A server.
       def run_simple(context, input_text)
         context.task.start!
         context.emit_status
@@ -70,6 +77,8 @@ module RobotLab
 
       # ── interactive modes ─────────────────────────────────────
 
+      # :reek:FeatureEnvy -- resume-vs-fresh dispatch on the request context;
+      # the fail/emit calls belong to the A2A task lifecycle, not another home.
       def run_interactive(context, input_text, task_id)
         if context.is_a?(::A2A::Server::ResumeContext)
           entry = Registry.fetch(task_id)
@@ -85,6 +94,8 @@ module RobotLab
         end
       end
 
+      # :reek:TooManyStatements -- linear bootstrap of one interactive run:
+      # build queues, start task, spawn robot thread, register, then monitor.
       def start_interactive_run(context, input_text, task_id)
         event_queue  = Queue.new
         answer_queue = Queue.new
@@ -116,21 +127,20 @@ module RobotLab
 
       def monitor_task(context, entry, _task_id)
         event = entry.event_queue.pop
+        task  = context.task
         case event[:type]
         when :ask
-          context.task.require_input!(message: event[:prompt])
-          context.emit_status(final: true)
+          task.require_input!(message: event[:prompt])
         when :done
           artifact = ::A2A::Models::Artifact.new(
             parts: [::A2A::Models::Part.text(event[:reply].to_s)],
             name: 'reply'
           )
-          context.task.complete!(artifacts: [artifact])
-          context.emit_status(final: true)
+          task.complete!(artifacts: [artifact])
         when :error
-          context.task.fail!(message: event[:error].message)
-          context.emit_status(final: true)
+          task.fail!(message: event[:error].message)
         end
+        context.emit_status(final: true)
       end
 
       # ── interactive setup / teardown ──────────────────────────

data/lib/robot_lab/a2a/server.rb

@@ -29,9 +29,13 @@ module RobotLab
     #   map "/agents" do
     #     run RobotLab::A2A::Server.new.add_robot(my_robot).to_app
     #   end
+    #
+    # :reek:DataClump -- name/description/path is the agent-card identity trio;
+    # add_robot and add_network resolve caller overrides, build_agent_card consumes.
     class Server
       DEFAULT_VERSION = '1.0'
 
+      # :reek:ControlParameter -- nil storage means "default to in-process Memory".
       def initialize(host: 'localhost', port: 9292, storage: nil, interactive: :none)
         @host        = host
         @port        = port
@@ -47,6 +51,8 @@ module RobotLab
       # @param description [String, nil] overrides robot.description
       # @param path [String, nil] URL path prefix (defaults to "/dns-label")
       # @return [self] for chaining
+      # :reek:ControlParameter -- nil name/description/path mean "derive from
+      # the robot"; each `||` is a default, not a behavior switch.
       def add_robot(robot, name: nil, description: nil, path: nil)
         agent_name = (name || robot.name).to_s
         agent_desc = description || robot.description || agent_name
@@ -65,6 +71,8 @@ module RobotLab
       # @param description [String, nil]
       # @param path [String, nil] URL path prefix (defaults to "/dns-label")
       # @return [self] for chaining
+      # :reek:ControlParameter -- nil description/path mean "derive from name";
+      # each `||` is a default, not a behavior switch.
       def add_network(network, name:, description: nil, path: nil)
         if @interactive != :none
           raise ArgumentError,
@@ -88,6 +96,8 @@ module RobotLab
       end
 
       # Return a Rack app for embedding in other servers (e.g. Rails, Puma).
+      # :reek:FeatureEnvy -- maps each registered agent config into its
+      # simple_a2a rack app; the config hashes are this class's own @agents values.
       def to_app
         url_map = @agents.transform_values do |cfg|
           ::A2A.server(

data/lib/robot_lab/a2a/version.rb

@@ -2,6 +2,6 @@
 
 module RobotLab
   module A2A
-    VERSION = '0.2.7'
+    VERSION = '0.2.8'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: robot_lab-a2a
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -125,7 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Agent2Agent (A2A) protocol adapter for RobotLab
 test_files: []