robot_lab 0.1.0 → 0.2.1

data/examples/06_prompt_templates.rb

@@ -17,10 +17,7 @@
 #   ├── product_support.md
 #   └── escalation.md
 
-# Configure template path before loading (MywayConfig reads env vars on init)
-ENV['ROBOT_LAB_TEMPLATE_PATH'] ||= File.join(__dir__, "prompts")
-
-require_relative "../lib/robot_lab"
+require_relative "common"
 
 # =============================================================================
 # Sample Data
@@ -179,10 +176,8 @@ end
 # Main Demo
 # =============================================================================
 
-puts "=" * 70
-puts "RobotLab + Prompt Templates Demo"
+banner "RobotLab + Prompt Templates Demo"
 puts "E-Commerce Support Network with Dynamic Context"
-puts "=" * 70
 puts
 
 # Template path is set via ROBOT_LAB_TEMPLATE_PATH env var (see top of file)
@@ -201,11 +196,12 @@ triage_robot = TriageRobot.new(
     company_name: COMPANY_NAME,
     categories: CATEGORIES
   },
-  model: "claude-3-haiku-20240307"
+  model: LLM[:default].model
 )
 
 # Order Support Robot
 order_robot = RobotLab.build(
+  model: LLM[:default].model,
   name: "order",
   description: "Handles order-related inquiries with full order history",
   template: :order_support,
@@ -214,12 +210,12 @@ order_robot = RobotLab.build(
     company_name: COMPANY_NAME,
     policies: POLICIES,
     capabilities: ORDER_CAPABILITIES
-  },
-  model: "claude-3-haiku-20240307"
+  }
 )
 
 # Product Support Robot
 product_robot = RobotLab.build(
+  model: LLM[:default].model,
   name: "product",
   description: "Answers product questions with catalog knowledge",
   template: :product_support,
@@ -229,12 +225,12 @@ product_robot = RobotLab.build(
     products: PRODUCTS,
     promotions: PROMOTIONS,
     product_categories: PRODUCT_CATEGORIES
-  },
-  model: "claude-3-haiku-20240307"
+  }
 )
 
 # Escalation Robot
 escalation_robot = RobotLab.build(
+  model: LLM[:default].model,
   name: "escalation",
   description: "Handles complex cases requiring special authority",
   template: :escalation,
@@ -242,8 +238,7 @@ escalation_robot = RobotLab.build(
   context: {
     company_name: COMPANY_NAME,
     authorities: ESCALATION_AUTHORITIES
-  },
-  model: "claude-3-haiku-20240307"
+  }
 )
 
 # -----------------------------------------------------------------------------
@@ -277,10 +272,7 @@ demo_queries = [
 ]
 
 demo_queries.each_with_index do |query, index|
-  puts
-  puts "-" * 70
-  puts "Scenario #{index + 1}: #{query[:label]}"
-  puts "-" * 70
+  section "Scenario #{index + 1}: #{query[:label]}"
   puts "Customer: #{query[:message]}"
   puts
 
@@ -311,7 +303,7 @@ demo_queries.each_with_index do |query, index|
   end
 
   puts
-  puts "=" * 70
+  hr
 end
 
 puts

data/examples/07_network_memory.rb

@@ -41,16 +41,10 @@
 # Usage:
 #   ANTHROPIC_API_KEY=your_key ruby examples/07_network_memory.rb
 
-# Configure template path before loading (MywayConfig reads env vars on init)
-ENV['ROBOT_LAB_TEMPLATE_PATH'] ||= File.join(__dir__, "prompts")
-
-require_relative "../lib/robot_lab"
+require_relative "common"
 require "json"
 
-puts "=" * 60
-puts "Example 7: Network Memory with Concurrent Robots"
-puts "=" * 60
-puts
+banner "Network Memory with Concurrent Robots"
 
 # -----------------------------------------------------------------------------
 # Custom Robot Classes that Write to Shared Memory
@@ -153,27 +147,27 @@ sentiment_robot = AnalysisRobot.new(
   name: "sentiment_analyzer",
   template: :sentiment_analyzer,
   memory_key: :sentiment,
-  model: "claude-3-haiku-20240307"
+  model: LLM[:default].model
 )
 
 entity_robot = AnalysisRobot.new(
   name: "entity_extractor",
   template: :entity_extractor,
   memory_key: :entities,
-  model: "claude-3-haiku-20240307"
+  model: LLM[:default].model
 )
 
 keyword_robot = AnalysisRobot.new(
   name: "keyword_extractor",
   template: :keyword_extractor,
   memory_key: :keywords,
-  model: "claude-3-haiku-20240307"
+  model: LLM[:default].model
 )
 
 synthesizer = SynthesizerRobot.new(
   name: "synthesizer",
   template: :synthesizer,
-  model: "claude-3-haiku-20240307"
+  model: LLM[:default].model
 )
 
 # -----------------------------------------------------------------------------
@@ -231,10 +225,10 @@ TEXT
 puts "Network structure:"
 puts network.visualize
 puts
-puts "-" * 60
+hr
 puts "Input text:"
 puts sample_text.strip
-puts "-" * 60
+hr
 puts
 
 # Send a broadcast before starting
@@ -248,9 +242,9 @@ result = network.run(message: sample_text)
 
 elapsed = Time.now - start_time
 puts
-puts "-" * 60
+hr
 puts "Analysis complete in #{elapsed.round(2)} seconds"
-puts "-" * 60
+hr
 
 # Send completion broadcast
 network.broadcast(event: "analysis_complete", details: "All robots finished")
@@ -259,21 +253,15 @@ network.broadcast(event: "analysis_complete", details: "All robots finished")
 # Display Results
 # -----------------------------------------------------------------------------
 
-puts
-puts "=" * 60
-puts "FINAL SYNTHESIS"
-puts "=" * 60
-puts
+
+section "Final Synthesis"
 
 if result.value.is_a?(RobotLab::RobotResult)
   puts result.value.reply
 end
 
-puts
-puts "=" * 60
-puts "MEMORY STATE"
-puts "=" * 60
-puts
+
+section "Memory State"
 
 # Show what's in shared memory
 memory = network.memory
@@ -287,11 +275,8 @@ puts "Keywords: #{memory.get(:keywords)&.to_json}"
 # Demonstrate Blocking Wait (without pipeline dependencies)
 # -----------------------------------------------------------------------------
 
-puts
-puts "=" * 60
-puts "DEMONSTRATING BLOCKING WAIT"
-puts "=" * 60
-puts
+
+section "Demonstrating Blocking Wait"
 
 # Create a fresh memory for this demo
 demo_memory = RobotLab::Memory.new(network_name: "wait_demo")

data/examples/08_llm_config.rb

@@ -29,19 +29,13 @@
 #   ROBOT_LAB_ENV=test ANTHROPIC_API_KEY=your_key ruby examples/08_llm_config.rb
 #   ROBOT_LAB_ENV=production ANTHROPIC_API_KEY=your_key ruby examples/08_llm_config.rb
 
-# Configure template path before loading (MywayConfig reads env vars on init)
-ENV['ROBOT_LAB_TEMPLATE_PATH'] ||= File.join(__dir__, "prompts")
-
-require_relative "../lib/robot_lab"
+require_relative "common"
 
 # =============================================================================
 # Demonstration
 # =============================================================================
 
-puts "=" * 70
-puts "Example 8: LLM Configuration via MywayConfig"
-puts "=" * 70
-puts
+banner "LLM Configuration via MywayConfig"
 
 # --- Gather environment from the user via AskUser ---
 ask = RobotLab::AskUser.new
@@ -73,8 +67,7 @@ api_key = config.ruby_llm.anthropic_api_key
 puts "  anthropic_api_key:  #{api_key ? '[SET via config]' : (ENV['ANTHROPIC_API_KEY'] ? '[SET via env]' : '(not set)')}"
 puts
 
-puts "-" * 70
-puts "Configuration hierarchy (highest priority first):"
+section "Configuration Hierarchy (highest priority first)"
 puts
 puts "  Per-Robot (override global settings for a specific robot):"
 puts "  11. Run-time context:      kwargs to robot.run re-render template"
@@ -92,17 +85,11 @@ puts "   4. Environment variables: ROBOT_LAB_RUBY_LLM__MODEL, etc."
 puts "   3. Project config:        ./config/robot_lab.yml"
 puts "   2. User config:           ~/.config/robot_lab/config.yml"
 puts "   1. Bundled defaults:      lib/robot_lab/config/defaults.yml + env overrides"
-puts "-" * 70
-puts
 
-# --- RunConfig demonstration ---
-puts "-" * 70
-puts "RunConfig: Shared Operational Defaults"
-puts "-" * 70
-puts
+section "RunConfig: Shared Operational Defaults"
 
-shared = RobotLab::RunConfig.new(model: "claude-sonnet-4", temperature: 0.5)
-puts "  shared = RunConfig.new(model: \"claude-sonnet-4\", temperature: 0.5)"
+shared = RobotLab::RunConfig.new(model: LLM[:default].model, temperature: 0.5)
+puts "  shared = RunConfig.new(model: \"gpt-5.4\", temperature: 0.5)"
 puts "  shared.to_h => #{shared.to_h.inspect}"
 puts
 
@@ -116,13 +103,14 @@ puts
 
 # Create a robot using the configuration
 robot = RobotLab.build(
+  model: LLM[:default].model,
   name: "config_demo",
   template: :llm_config_demo,
   local_tools: [RobotLab::AskUser],
   context: {
     environment: env,
-    model: config.ruby_llm.model,
-    provider: config.ruby_llm.provider.to_s
+    model: LLM[:default].model,
+    provider: LLM[:default].provider
   }
 )
 
@@ -153,7 +141,7 @@ puts <<~FOOTER
     Per-Robot: RunConfig, template front matter, constructor params, with_*
 
   RunConfig lets you express shared defaults that flow through the hierarchy:
-    shared = RobotLab::RunConfig.new(model: "claude-sonnet-4", temperature: 0.5)
+    shared = RobotLab::RunConfig.new(model: "gpt-5.4", temperature: 0.5)
     network = RobotLab.create_network(name: "team", config: shared) { ... }
     robot = RobotLab.build(name: "bot", config: shared, temperature: 0.9)
 

data/examples/09_chaining.rb

@@ -17,10 +17,7 @@
 # Usage:
 #   bundle exec ruby examples/09_chaining.rb
 
-# Configure template path before loading
-ENV['ROBOT_LAB_TEMPLATE_PATH'] ||= File.join(__dir__, "prompts")
-
-require_relative "../lib/robot_lab"
+require_relative "common"
 require "amazing_print"
 require "hashdiff"
 require "stringio"
@@ -55,21 +52,18 @@ def show_config(robot, previous_config = nil)
   current
 end
 
-puts "=" * 70
-puts "Example 9: Robot Chaining & Reconfiguration"
-puts "=" * 70
-puts
+banner "Robot Chaining & Reconfiguration"
 
 # =============================================================================
 # Section 1: Template front matter config
 # =============================================================================
 
-puts "--- Section 1: Template Front Matter Config ---"
-puts
+section "Section 1: Template Front Matter Config"
 
 # The 'configurable' template sets temperature: 0.3 and max_tokens: 200
 # via YAML front matter. These are applied automatically.
 robot = RobotLab.build(
+  model: LLM[:default].model,
   name: "chameleon",
   template: :configurable,
   context: { task_type: "analysis" }
@@ -83,8 +77,7 @@ puts
 # Section 2: with_* method chaining
 # =============================================================================
 
-puts "--- Section 2: with_* Method Chaining ---"
-puts
+section "Section 2: with_* Method Chaining"
 
 # with_* methods return self, enabling fluent chaining.
 # These override whatever the template set.
@@ -98,8 +91,7 @@ puts
 # Section 3: update() for reconfiguration
 # =============================================================================
 
-puts "--- Section 3: update() for Reconfiguration ---"
-puts
+section "Section 3: update() for Reconfiguration"
 
 # update() can swap the template, model, temperature, and other settings.
 robot.update(template: :assistant, temperature: 0.5)
@@ -119,12 +111,12 @@ puts
 # Section 4: Constructor params override front matter
 # =============================================================================
 
-puts "--- Section 4: Constructor Params Override Front Matter ---"
-puts
+section "Section 4: Constructor Params Override Front Matter"
 
 # The configurable template sets temperature: 0.3 in front matter.
 # Passing temperature: 0.9 to the constructor overrides it.
 robot2 = RobotLab.build(
+  model: LLM[:default].model,
   name: "override_demo",
   template: :configurable,
   context: { task_type: "creative" },
@@ -139,18 +131,18 @@ puts
 # Section 5: RunConfig as alternative to individual kwargs
 # =============================================================================
 
-puts "--- Section 5: RunConfig as Alternative to Individual kwargs ---"
-puts
+section "Section 5: RunConfig as Alternative to Individual kwargs"
 
 # Instead of passing model:, temperature:, etc. individually,
 # use a RunConfig to express shared defaults.
-shared = RobotLab::RunConfig.new(model: "claude-sonnet-4", temperature: 0.5)
+shared = RobotLab::RunConfig.new(model: LLM[:default].model, temperature: 0.5)
 
 puts "RunConfig: #{shared.to_h.inspect}"
 puts
 
 # Robot inherits from RunConfig; constructor kwargs still override
 robot3 = RobotLab.build(
+  model: LLM[:default].model,
   name: "runconfig_demo",
   template: :configurable,
   context: { task_type: "analysis" },
@@ -178,8 +170,7 @@ puts
 # Section 6: Bare robot with chaining
 # =============================================================================
 
-puts "--- Section 6: Bare Robot with Chaining ---"
-puts
+section "Section 6: Bare Robot with Chaining"
 
 # A bare robot has no template. Configure entirely via chaining.
 bare = RobotLab.build(name: "bare")
@@ -200,8 +191,7 @@ puts
 # Section 7: with_template() on an existing robot
 # =============================================================================
 
-puts "--- Section 7: with_template() on Existing Robot ---"
-puts
+section "Section 7: with_template() on Existing Robot"
 
 # You can apply a template to a robot after creation.
 bare.with_template(:helper)
@@ -214,8 +204,7 @@ puts
 # Section 8: AskUser tool for gathering template parameters
 # =============================================================================
 
-puts "--- Section 8: AskUser for Template Parameters ---"
-puts
+section "Section 8: AskUser for Template Parameters"
 puts "The :configurable template declares `task_type: general` in its front"
 puts "matter. That default is offered to the user — they can accept it by"
 puts "pressing Enter or type something else. Parameters with null values"
@@ -225,6 +214,7 @@ puts
 # Build a robot with AskUser — the template's task_type default ("general")
 # is offered to the user, who can accept or override it.
 interactive = RobotLab.build(
+  model: LLM[:default].model,
   name: "interactive_demo",
   template: :configurable,
   local_tools: [RobotLab::AskUser]
@@ -257,6 +247,5 @@ puts
 puts "If the user had pressed Enter, the default \"general\" would be kept."
 puts
 
-puts "=" * 70
+hr
 puts "All sections completed without any LLM calls."
-puts "=" * 70

data/examples/10_memory.rb

@@ -18,25 +18,18 @@
 # Usage:
 #   bundle exec ruby examples/10_memory.rb
 
-# Configure template path before loading
-ENV['ROBOT_LAB_TEMPLATE_PATH'] ||= File.join(__dir__, "prompts")
-
-require_relative "../lib/robot_lab"
+require_relative "common"
 require "json"
 require "amazing_print"
 require "hashdiff"
 
-puts "=" * 70
-puts "Example 10: Advanced Memory Operations"
-puts "=" * 70
-puts
+banner "Advanced Memory Operations"
 
 # =============================================================================
 # Section 1: StateProxy for method-style access
 # =============================================================================
 
-puts "--- Section 1: StateProxy for Method-Style Access ---"
-puts
+section "Section 1: StateProxy for Method-Style Access"
 
 memory = RobotLab.create_memory(
   data: { category: nil, priority: "low" },
@@ -64,8 +57,7 @@ puts
 # Section 2: Subscriptions and MemoryChange
 # =============================================================================
 
-puts "--- Section 2: Subscriptions and MemoryChange ---"
-puts
+section "Section 2: Subscriptions and MemoryChange"
 
 changes = []
 
@@ -107,8 +99,7 @@ puts
 # Section 3: Pattern subscriptions
 # =============================================================================
 
-puts "--- Section 3: Pattern Subscriptions ---"
-puts
+section "Section 3: Pattern Subscriptions"
 
 pattern_changes = []
 
@@ -135,8 +126,7 @@ puts
 # Section 4: Unsubscribe
 # =============================================================================
 
-puts "--- Section 4: Unsubscribe ---"
-puts
+section "Section 4: Unsubscribe"
 
 count_before = changes.size
 memory.unsubscribe(sub_id)
@@ -152,8 +142,7 @@ puts
 # Section 5: Key management
 # =============================================================================
 
-puts "--- Section 5: Key Management ---"
-puts
+section "Section 5: Key Management"
 
 puts "memory.keys (non-reserved):"
 ap memory.keys
@@ -171,8 +160,7 @@ puts
 # Section 6: Serialization round-trip
 # =============================================================================
 
-puts "--- Section 6: Serialization Round-Trip ---"
-puts
+section "Section 6: Serialization Round-Trip"
 
 hash = memory.to_h
 puts "memory.to_h:"
@@ -214,8 +202,7 @@ puts
 # Section 7: Clone for isolation
 # =============================================================================
 
-puts "--- Section 7: Clone for Isolation ---"
-puts
+section "Section 7: Clone for Isolation"
 
 cloned = memory.clone
 cloned.set(:isolated_key, "only in clone")
@@ -244,8 +231,7 @@ puts
 # Section 8: Delete and reserved key protection
 # =============================================================================
 
-puts "--- Section 8: Delete and Reserved Key Protection ---"
-puts
+section "Section 8: Delete and Reserved Key Protection"
 
 before_delete = memory.to_h
 memory.delete(:status)
@@ -272,8 +258,7 @@ puts
 # Section 9: Clear vs Reset
 # =============================================================================
 
-puts "--- Section 9: Clear vs Reset ---"
-puts
+section "Section 9: Clear vs Reset"
 
 memory.set(:temp1, "value1")
 memory.set(:temp2, "value2")
@@ -326,6 +311,5 @@ Hashdiff.diff(before_reset, after_reset).each do |change|
 end
 puts
 
-puts "=" * 70
+hr
 puts "All sections completed without any LLM calls."
-puts "=" * 70

data/examples/11_network_introspection.rb

@@ -19,10 +19,7 @@
 # Usage:
 #   bundle exec ruby examples/11_network_introspection.rb
 
-# Configure template path before loading
-ENV['ROBOT_LAB_TEMPLATE_PATH'] ||= File.join(__dir__, "prompts")
-
-require_relative "../lib/robot_lab"
+require_relative "common"
 require "amazing_print"
 require "tempfile"
 
@@ -50,21 +47,18 @@ def render_dot_image(dot_source)
   end
 end
 
-puts "=" * 70
-puts "Example 11: Network Visualization & Introspection"
-puts "=" * 70
-puts
+banner "Network Visualization & Introspection"
 
 # Shared RunConfig for all robots in this network
-shared_config = RobotLab::RunConfig.new(model: "claude-sonnet-4", temperature: 0.5)
+shared_config = RobotLab::RunConfig.new(model: LLM[:default].model, temperature: 0.5)
 
 # Per-task RunConfig override for the writer (higher creativity)
 creative_config = RobotLab::RunConfig.new(temperature: 0.9)
 
 # Build robots (no LLM calls, just instances)
-classifier = RobotLab.build(name: "classifier", system_prompt: "Classify input")
-analyst    = RobotLab.build(name: "analyst",    system_prompt: "Analyze data")
-writer     = RobotLab.build(name: "writer",     system_prompt: "Write summary")
+classifier = RobotLab.build(model: LLM[:default].model, name: "classifier", system_prompt: "Classify input")
+analyst    = RobotLab.build(model: LLM[:default].model, name: "analyst",    system_prompt: "Analyze data")
+writer     = RobotLab.build(model: LLM[:default].model, name: "writer",     system_prompt: "Write summary")
 
 # Build network with RunConfig, dependencies, and per-task config
 network = RobotLab.create_network(name: "demo_pipeline", config: shared_config) do
@@ -77,8 +71,7 @@ end
 # Section 1: Visualization outputs
 # =============================================================================
 
-puts "--- Section 1: Visualization ---"
-puts
+section "Section 1: Visualization"
 
 mermaid = network.to_mermaid
 if mermaid
@@ -123,8 +116,7 @@ end
 # Section 2: Robot access
 # =============================================================================
 
-puts "--- Section 2: Robot Access ---"
-puts
+section "Section 2: Robot Access"
 
 # Access by task name with robot() method
 # Note: robots are keyed by task name (the first arg to task()), not robot.name
@@ -146,10 +138,9 @@ puts
 # Section 3: Dynamic robot addition
 # =============================================================================
 
-puts "--- Section 3: Dynamic Robot Addition ---"
-puts
+section "Section 3: Dynamic Robot Addition"
 
-reviewer = RobotLab.build(name: "reviewer", system_prompt: "Review output")
+reviewer = RobotLab.build(model: LLM[:default].model, name: "reviewer", system_prompt: "Review output")
 network.add_robot(reviewer)
 
 puts "After add_robot(reviewer):"
@@ -168,8 +159,7 @@ puts
 # Section 4: Network introspection
 # =============================================================================
 
-puts "--- Section 4: Network Introspection ---"
-puts
+section "Section 4: Network Introspection"
 
 puts "network.to_h:"
 ap network.to_h
@@ -188,8 +178,7 @@ puts
 # Section 5: RunConfig Introspection
 # =============================================================================
 
-puts "--- Section 5: RunConfig Introspection ---"
-puts
+section "Section 5: RunConfig Introspection"
 
 puts "Network RunConfig (shared defaults):"
 ap network.config.to_h
@@ -205,8 +194,7 @@ puts
 # Section 6: Broadcast
 # =============================================================================
 
-puts "--- Section 6: Broadcast ---"
-puts
+section "Section 6: Broadcast"
 
 broadcast_messages = []
 
@@ -233,8 +221,7 @@ puts
 # Section 7: Shared memory access
 # =============================================================================
 
-puts "--- Section 7: Shared Network Memory ---"
-puts
+section "Section 7: Shared Network Memory"
 
 puts "network.memory is a #{network.memory.class}"
 puts "network.memory.network_name = #{network.memory.network_name.inspect}"
@@ -248,6 +235,5 @@ puts "network.memory.to_h:"
 ap network.memory.to_h
 puts
 
-puts "=" * 70
+hr
 puts "All sections completed without any LLM calls."
-puts "=" * 70