robot_lab 0.0.1 → 0.0.6

data/lib/robot_lab/utils.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module RobotLab
+  # Shared utility methods used across multiple classes.
+  #
+  # Include this module to get `dispatch_async` and `deep_dup`
+  # as private instance methods.
+  module Utils
+    private
+
+    # Dispatch a block asynchronously using Async fibers.
+    #
+    # When already inside an Async reactor, creates a child task.
+    # Otherwise, creates a temporary reactor that runs the block
+    # and cleans up automatically.
+    def dispatch_async(&block)
+      Async do
+        block.call
+      rescue => e
+        RobotLab.config.logger.error("dispatch_async error: #{e.class}: #{e.message}")
+      end
+    end
+
+    # Deep-duplicate a nested Hash/Array structure.
+    #
+    # @param obj [Object] the object to duplicate
+    # @return [Object] the deep copy
+    def deep_dup(obj)
+      case obj
+      when Hash
+        obj.transform_values { |v| deep_dup(v) }
+      when Array
+        obj.map { |v| deep_dup(v) }
+      else
+        obj.dup rescue obj
+      end
+    end
+  end
+end

data/lib/robot_lab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RobotLab
-  VERSION = "0.0.1"
+  VERSION = "0.0.6"
 end

data/lib/robot_lab.rb

@@ -1,13 +1,18 @@
 # frozen_string_literal: true
 
-require "zeitwerk"
-require "json"
-require "securerandom"
-require "digest"
+require 'zeitwerk'
+require 'json'
+require 'securerandom'
+require 'digest'
 
 # Core dependencies
-require "ruby_llm"
-require "async"
+# ActiveSupport delegation is required by ruby_llm (RubyLLM::Agent uses delegate)
+# but not declared in ruby_llm's gemspec. Load it before ruby_llm.
+require 'active_support/core_ext/module/delegation'
+require 'ruby_llm'
+require 'prompt_manager'
+require 'async'
+require 'typed_bus'
 
 # Define the module first so Zeitwerk can populate it
 #
@@ -29,10 +34,16 @@ require "async"
 #   result = network.run(message: "Process this document")
 #
 # @example Configuration
-#   RobotLab.configure do |config|
-#     config.anthropic_api_key = ENV["ANTHROPIC_API_KEY"]
-#     config.template_path = "app/templates"
-#   end
+#   # Via environment variables (ROBOT_LAB_* prefix)
+#   # ROBOT_LAB_DEFAULT_MODEL=gpt-4
+#   # ROBOT_LAB_RUBY_LLM__ANTHROPIC_API_KEY=sk-ant-...
+#
+#   # Or via config files (~/.config/robot_lab/config.yml or ./config/robot_lab.yml)
+#   # See lib/robot_lab/config/defaults.yml for all options
+#
+#   # Access configuration values:
+#   RobotLab.config.ruby_llm.model            #=> "claude-sonnet-4"
+#   RobotLab.config.ruby_llm.request_timeout  #=> 120
 #
 module RobotLab
 end
@@ -40,63 +51,94 @@ end
 loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
 loader.ignore("#{__dir__}/generators")
 loader.ignore("#{__dir__}/robot_lab/rails")
+loader.ignore("#{__dir__}/robot_lab/robot")
 
 # Custom inflections for classes that don't follow Zeitwerk naming conventions
 loader.inflector.inflect(
-  "robot_lab" => "RobotLab",
-  "robotic_model" => "RoboticModel",
-  "mcp" => "MCP",
-  "openai" => "OpenAI",
-  "sse" => "SSE",
-  "streamable_http" => "StreamableHTTP",
-  "websocket" => "WebSocket"
+  'robot_lab' => 'RobotLab',
+  'mcp' => 'MCP',
+  'openai' => 'OpenAI',
+  'sse' => 'SSE',
+  'streamable_http' => 'StreamableHTTP',
+  'websocket' => 'WebSocket'
 )
 
-# Note: adapters/ is NOT collapsed since files define RobotLab::Adapters::* classes
-
 loader.setup
 
-# Eager load for proper constant resolution
-loader.eager_load
+# These files define multiple classes that Zeitwerk cannot autoload
+# individually (e.g. TextMessage lives in message.rb, not text_message.rb).
+# Require them explicitly so their constants are available without eager loading.
+require_relative 'robot_lab/error'
+require_relative 'robot_lab/message'
+require_relative 'robot_lab/memory'
+
+# Eager load everything in Rails or when explicitly requested.
+# Otherwise Zeitwerk's lazy autoloading keeps boot fast.
+loader.eager_load if defined?(Rails::Engine) || ENV["ROBOT_LAB_EAGER_LOAD"]
 
 module RobotLab
   # Error classes are defined in lib/robot_lab/error.rb
 
   class << self
-    # @!attribute [w] configuration
-    #   @return [Configuration] the configuration object
-    attr_writer :configuration
-
-    # Returns the current configuration object.
+    # Returns the Config object (MywayConfig-based).
+    #
+    # Configuration is automatically loaded from:
+    # - Bundled defaults (lib/robot_lab/config/defaults.yml)
+    # - Environment-specific overrides (development, test, production)
+    # - XDG config files (~/.config/robot_lab/config.yml)
+    # - Project config (./config/robot_lab.yml)
+    # - Environment variables (ROBOT_LAB_*)
     #
-    # @return [Configuration] the configuration instance
-    def configuration
-      @configuration ||= Configuration.new
+    # @return [Config] the config instance
+    #
+    # @example
+    #   RobotLab.config.ruby_llm.model            #=> "claude-sonnet-4"
+    #   RobotLab.config.ruby_llm.request_timeout  #=> 120
+    #   RobotLab.config.development?              #=> true
+    def config
+      @config ||= Config.new.tap(&:after_load)
     end
 
-    # Yields the configuration object for modification.
+
+    # Yields the Config object for block-style configuration.
     #
-    # @yield [Configuration] the configuration object
-    # @return [void]
+    # @yield [Config] the config instance
+    # @return [Config] the config instance
     #
     # @example
-    #   RobotLab.configure do |config|
-    #     config.anthropic_api_key = "sk-..."
+    #   RobotLab.configure do |c|
+    #     c.default_model = "claude-sonnet-4"
     #   end
     def configure
-      yield(configuration)
+      yield config
     end
 
+
+    # Reload configuration from all sources.
+    #
+    # Clears the cached Config instance, forcing it to be
+    # reloaded on next access.
+    #
+    # @return [Config] the new config instance
+    def reload_config!
+      @config = nil
+      config
+    end
+
+
     # Factory method to create a new Robot instance.
     #
-    # @param name [String] the unique identifier for the robot
-    # @param template [Symbol, nil] the ERB template for the robot's prompt
+    # @param name [String, nil] the unique identifier for the robot (auto-generated if nil)
+    # @param template [Symbol, nil] the prompt_manager template for the robot's prompt
     # @param system_prompt [String, nil] inline system prompt (can be used alone or with template)
     # @param context [Hash] variables to pass to the template
     # @param enable_cache [Boolean] whether to enable semantic caching (default: true)
     # @param options [Hash] additional options passed to Robot.new
     # @return [Robot] a new Robot instance
-    # @raise [ArgumentError] if neither template nor system_prompt is provided
+    #
+    # @example Bare robot (no template or prompt)
+    #   robot = RobotLab.build
+    #   robot.with_instructions("You are helpful.").run("Hello!")
     #
     # @example Robot with template
     #   robot = RobotLab.build(
@@ -110,31 +152,20 @@ module RobotLab
     #     name: "helper",
     #     system_prompt: "You are a helpful assistant."
     #   )
-    #
-    # @example Robot with both template and system prompt
-    #   robot = RobotLab.build(
-    #     name: "support",
-    #     template: :support_agent,
-    #     system_prompt: "Today's date is #{Date.today}."
-    #   )
-    #
-    # @example Robot with caching disabled
-    #   robot = RobotLab.build(
-    #     name: "simple",
-    #     system_prompt: "You are helpful.",
-    #     enable_cache: false
-    #   )
-    def build(name:, template: nil, system_prompt: nil, context: {}, enable_cache: true, **options)
+    def build(name: "robot", template: nil, system_prompt: nil, context: {}, enable_cache: true, bus: nil, config: nil, **options)
       Robot.new(
         name: name,
         template: template,
         system_prompt: system_prompt,
         context: context,
         enable_cache: enable_cache,
+        bus: bus,
+        config: config,
         **options
       )
     end
 
+
     # Factory method to create a new Network of robots.
     #
     # @param name [String] the unique identifier for the network
@@ -162,10 +193,11 @@ module RobotLab
     #     step :entities, entity_bot, depends_on: [:fetch]
     #     step :merge, merger, depends_on: [:sentiment, :entities]
     #   end
-    def create_network(name:, concurrency: :auto, &block)
-      Network.new(name: name, concurrency: concurrency, &block)
+    def create_network(name:, concurrency: :auto, config: nil, &block)
+      Network.new(name: name, concurrency: concurrency, config: config, &block)
     end
 
+
     # Factory method to create a new Memory object.
     #
     # @param data [Hash] initial runtime data
@@ -190,6 +222,6 @@ end
 
 # Load Rails integration if Rails is defined
 if defined?(Rails::Engine)
-  require "robot_lab/rails/engine"
-  require "robot_lab/rails/railtie"
+  require 'robot_lab/rails/engine'
+  require 'robot_lab/rails/railtie'
 end

data/mkdocs.yml

@@ -168,7 +168,6 @@ nav:
       - Using Tools: guides/using-tools.md
       - MCP Integration: guides/mcp-integration.md
       - Streaming Responses: guides/streaming.md
-      - Conversation History: guides/history.md
       - Memory System: guides/memory.md
       - Rails Integration: guides/rails-integration.md
   - API Reference:
@@ -186,11 +185,6 @@ nav:
           - TextMessage: api/messages/text-message.md
           - ToolCallMessage: api/messages/tool-call-message.md
           - ToolResultMessage: api/messages/tool-result-message.md
-      - Adapters:
-          - api/adapters/index.md
-          - Anthropic: api/adapters/anthropic.md
-          - OpenAI: api/adapters/openai.md
-          - Gemini: api/adapters/gemini.md
       - MCP:
           - api/mcp/index.md
           - Client: api/mcp/client.md
@@ -200,11 +194,6 @@ nav:
           - api/streaming/index.md
           - Context: api/streaming/context.md
           - Events: api/streaming/events.md
-      - History:
-          - api/history/index.md
-          - Config: api/history/config.md
-          - ThreadManager: api/history/thread-manager.md
-          - ActiveRecordAdapter: api/history/active-record-adapter.md
   - Examples:
       - examples/index.md
       - Basic Chat: examples/basic-chat.md