robot_lab 0.2.6 → 0.2.7

data/examples/06_prompt_templates.rb

@@ -8,7 +8,7 @@
 # system with dynamic context injection using SimpleFlow's optional task routing.
 #
 # Usage:
-#   ANTHROPIC_API_KEY=your_key ruby examples/06_prompt_templates.rb
+#   ruby examples/06_prompt_templates.rb
 #
 # Template Structure (prompt_manager .md files with YAML front matter):
 #   examples/prompts/
@@ -196,12 +196,12 @@ triage_robot = TriageRobot.new(
     company_name: COMPANY_NAME,
     categories: CATEGORIES
   },
-  model: LLM[:default].model
+  **llm_opts
 )
 
 # Order Support Robot
 order_robot = RobotLab.build(
-  model: LLM[:default].model,
+  **llm_opts,
   name: "order",
   description: "Handles order-related inquiries with full order history",
   template: :order_support,
@@ -215,7 +215,7 @@ order_robot = RobotLab.build(
 
 # Product Support Robot
 product_robot = RobotLab.build(
-  model: LLM[:default].model,
+  **llm_opts,
   name: "product",
   description: "Answers product questions with catalog knowledge",
   template: :product_support,
@@ -230,7 +230,7 @@ product_robot = RobotLab.build(
 
 # Escalation Robot
 escalation_robot = RobotLab.build(
-  model: LLM[:default].model,
+  **llm_opts,
   name: "escalation",
   description: "Handles complex cases requiring special authority",
   template: :escalation,
@@ -245,11 +245,15 @@ escalation_robot = RobotLab.build(
 # Create Network with Optional Task Routing
 # -----------------------------------------------------------------------------
 
+# tools: :inherit on each task. Task#to_run_params forwards it to robot.run,
+# which otherwise defaults to :none and would send the provider an empty tool
+# list — the AskUser tool would be attached to each robot but never offered
+# to the model.
 network = RobotLab.create_network(name: "ecommerce_support") do
-  task :triage, triage_robot, depends_on: :none
-  task :order, order_robot, depends_on: :optional
-  task :product, product_robot, depends_on: :optional
-  task :escalation, escalation_robot, depends_on: :optional
+  task :triage, triage_robot, depends_on: :none, tools: :inherit
+  task :order, order_robot, depends_on: :optional, tools: :inherit
+  task :product, product_robot, depends_on: :optional, tools: :inherit
+  task :escalation, escalation_robot, depends_on: :optional, tools: :inherit
 end
 
 # -----------------------------------------------------------------------------

data/examples/07_network_memory.rb

@@ -39,7 +39,7 @@
 #   └─────────────────────────────────────────────────────────────┘
 #
 # Usage:
-#   ANTHROPIC_API_KEY=your_key ruby examples/07_network_memory.rb
+#   ruby examples/07_network_memory.rb
 
 require_relative "common"
 require "json"
@@ -147,27 +147,27 @@ sentiment_robot = AnalysisRobot.new(
   name: "sentiment_analyzer",
   template: :sentiment_analyzer,
   memory_key: :sentiment,
-  model: LLM[:default].model
+  **llm_opts
 )
 
 entity_robot = AnalysisRobot.new(
   name: "entity_extractor",
   template: :entity_extractor,
   memory_key: :entities,
-  model: LLM[:default].model
+  **llm_opts
 )
 
 keyword_robot = AnalysisRobot.new(
   name: "keyword_extractor",
   template: :keyword_extractor,
   memory_key: :keywords,
-  model: LLM[:default].model
+  **llm_opts
 )
 
 synthesizer = SynthesizerRobot.new(
   name: "synthesizer",
   template: :synthesizer,
-  model: LLM[:default].model
+  **llm_opts
 )
 
 # -----------------------------------------------------------------------------

data/examples/08_llm_config.rb

@@ -20,14 +20,14 @@
 # Environment is determined by ROBOT_LAB_ENV, RAILS_ENV, or RACK_ENV.
 #
 # Environment variable examples:
-#   ROBOT_LAB_RUBY_LLM__ANTHROPIC_API_KEY=sk-ant-...
-#   ROBOT_LAB_RUBY_LLM__MODEL=gpt-4
+#   ROBOT_LAB_RUBY_LLM__MODEL=qwen3.6:latest
 #   ROBOT_LAB_RUBY_LLM__REQUEST_TIMEOUT=180
+#   OLLAMA_API_BASE=http://localhost:11434/v1
 #
 # Usage:
-#   ANTHROPIC_API_KEY=your_key ruby examples/08_llm_config.rb
-#   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
+#   ruby examples/08_llm_config.rb
+#   ROBOT_LAB_ENV=test ruby examples/08_llm_config.rb
+#   ROBOT_LAB_ENV=production ruby examples/08_llm_config.rb
 
 require_relative "common"
 
@@ -62,9 +62,9 @@ puts "  request_timeout:    #{config.ruby_llm.request_timeout}s"
 puts "  max_retries:        #{config.ruby_llm.max_retries}"
 puts "  log_level:          #{config.ruby_llm.log_level}"
 
-# Show API key status without revealing values
-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)')}"
+# Show where the LLM traffic actually goes
+puts "  ollama_api_base:    #{OLLAMA_API_BASE}"
+puts "  (local inference — no API key in play)"
 puts
 
 section "Configuration Hierarchy (highest priority first)"
@@ -89,9 +89,12 @@ puts "   1. Bundled defaults:      lib/robot_lab/config/defaults.yml + env overr
 section "RunConfig: Shared Operational Defaults"
 
 shared = RobotLab::RunConfig.new(model: LLM[:default].model, temperature: 0.5)
-puts "  shared = RunConfig.new(model: \"gpt-5.4\", temperature: 0.5)"
+puts "  shared = RunConfig.new(model: #{LLM[:default].model.inspect}, temperature: 0.5)"
 puts "  shared.to_h => #{shared.to_h.inspect}"
 puts
+puts "  Note: RunConfig carries no `provider` field, so an Ollama model still"
+puts "  needs provider: passed to each robot alongside the shared config."
+puts
 
 creative = RobotLab::RunConfig.new(temperature: 0.9)
 merged = shared.merge(creative)
@@ -103,14 +106,16 @@ puts
 
 # Create a robot using the configuration
 robot = RobotLab.build(
-  model: LLM[:default].model,
+  **llm_opts,
   name: "config_demo",
   template: :llm_config_demo,
   local_tools: [RobotLab::AskUser],
+  # These are TEMPLATE parameters, not robot kwargs — the template renders
+  # them into its prompt text.
   context: {
     environment: env,
-    model: LLM[:default].model,
-    provider: LLM[:default].provider
+    model:       LLM[:default].model,
+    provider:    LLM[:default].provider
   }
 )
 
@@ -141,14 +146,14 @@ 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: "gpt-5.4", temperature: 0.5)
+    shared = RobotLab::RunConfig.new(model: #{LLM[:default].model.inspect}, temperature: 0.5)
     network = RobotLab.create_network(name: "team", config: shared) { ... }
     robot = RobotLab.build(name: "bot", config: shared, temperature: 0.9)
 
   Example environment variable overrides:
-    ROBOT_LAB_RUBY_LLM__MODEL=gpt-4
+    ROBOT_LAB_RUBY_LLM__MODEL=#{LLM[:default].model}
     ROBOT_LAB_RUBY_LLM__REQUEST_TIMEOUT=180
-    ROBOT_LAB_RUBY_LLM__ANTHROPIC_API_KEY=sk-ant-...
+    OLLAMA_API_BASE=http://localhost:11434/v1
 
   Try running with different environments:
     ROBOT_LAB_ENV=test ruby examples/08_llm_config.rb

data/examples/09_chaining.rb

@@ -63,7 +63,7 @@ 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,
+  **llm_opts,
   name: "chameleon",
   template: :configurable,
   context: { task_type: "analysis" }
@@ -116,7 +116,7 @@ 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,
+  **llm_opts,
   name: "override_demo",
   template: :configurable,
   context: { task_type: "creative" },
@@ -142,7 +142,7 @@ puts
 
 # Robot inherits from RunConfig; constructor kwargs still override
 robot3 = RobotLab.build(
-  model: LLM[:default].model,
+  **llm_opts,
   name: "runconfig_demo",
   template: :configurable,
   context: { task_type: "analysis" },
@@ -214,7 +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,
+  **llm_opts,
   name: "interactive_demo",
   template: :configurable,
   local_tools: [RobotLab::AskUser]

data/examples/11_network_introspection.rb

@@ -56,9 +56,9 @@ shared_config = RobotLab::RunConfig.new(model: LLM[:default].model, temperature:
 creative_config = RobotLab::RunConfig.new(temperature: 0.9)
 
 # Build robots (no LLM calls, just instances)
-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")
+classifier = RobotLab.build(**llm_opts, name: "classifier", system_prompt: "Classify input")
+analyst    = RobotLab.build(**llm_opts, name: "analyst",    system_prompt: "Analyze data")
+writer     = RobotLab.build(**llm_opts, 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
@@ -140,7 +140,7 @@ puts
 
 section "Section 3: Dynamic Robot Addition"
 
-reviewer = RobotLab.build(model: LLM[:default].model, name: "reviewer", system_prompt: "Review output")
+reviewer = RobotLab.build(**llm_opts, name: "reviewer", system_prompt: "Review output")
 network.add_robot(reviewer)
 
 puts "After add_robot(reviewer):"

data/examples/12_message_bus.rb

@@ -19,7 +19,7 @@ class Comedian < RobotLab::Robot
   TEMP_STEP  = 0.2
 
   def initialize(bus:)
-    super(name: "bob", model: LLM[:default].model, template: :comedian, bus: bus, temperature: TEMP_START)
+    super(name: "bob", **llm_opts, template: :comedian, bus: bus, temperature: TEMP_START)
     @attempts = 0
     on_message do |message|
       @attempts += 1
@@ -36,7 +36,7 @@ end
 
 class ComedyCritic < RobotLab::Robot
   def initialize(bus:)
-    super(name: "alice", model: LLM[:default].model, template: :comedy_critic, bus: bus)
+    super(name: "alice", **llm_opts, template: :comedy_critic, bus: bus)
     @accepted = false
     @rounds   = 0
     on_message do |message|

data/examples/13_spawn.rb

@@ -25,7 +25,7 @@ class Dispatcher < RobotLab::Robot
   attr_reader :spawned
 
   def initialize(bus: nil)
-    super(name: "dispatcher", model: LLM[:default].model, template: :dispatcher, bus: bus)
+    super(name: "dispatcher", **llm_opts, template: :dispatcher, bus: bus)
     @spawned = {}
     @pending = {}
 
@@ -49,7 +49,7 @@ class Dispatcher < RobotLab::Robot
     # Spawn the specialist (reuse if already spawned)
     specialist = @spawned[role] ||= spawn(
       name: role,
-      model: LLM[:default].model,
+      **llm_opts,
       system_prompt: instruction
     )
 

data/examples/14_rusty_circuit/README.md

@@ -0,0 +1 @@
+execute the open_mic.rb file

data/examples/14_rusty_circuit/comic.rb

@@ -56,7 +56,7 @@ class GetCoaching < RobotLab::Tool
       robot.coaches_spawned += 1
       robot.spawn(
         name: "comedy_coach",
-        model: LLM[:default].model,
+        **llm_opts,
         system_prompt:
           "You are a veteran comedy coach backstage at a live show. " \
           "A comedian is struggling and needs quick, actionable advice. " \
@@ -64,6 +64,7 @@ class GetCoaching < RobotLab::Tool
           "exactly what to do differently in their next bit."
       )
     end
+    robot.display&.working("Comic", "backstage with the coach")
     advice = coach.run(situation).reply.strip
     robot.display&.comic_tool("[get_coaching] -> #{advice[0..70]}...")
     advice
@@ -101,7 +102,7 @@ class Comic < RobotLab::Robot
 
     super(
       name: "comic",
-      model: LLM[:default].model,
+      **llm_opts,
       template: :open_mic_comic,
       bus: bus,
       local_tools: [
@@ -133,7 +134,10 @@ class Comic < RobotLab::Robot
                 "use your tools to adapt — reinvent your style, adjust " \
                 "your energy, or get coaching. Then deliver your next bit."
 
-      result = run(prompt)
+      # tools: :inherit — without it run() defaults to :none and the comic's
+      # three self-modification tools are never offered to the model, which
+      # kills the whole point of the demo.
+      result = run(prompt, tools: :inherit)
       bit = result.reply.strip
 
       @display.comic("Comic [Round #{@round}]", bit)

data/examples/14_rusty_circuit/display.rb

@@ -69,6 +69,20 @@ class Display
     log("    #{text}")
   end
 
+  # ── Liveness ────────────────────────────────────────────
+  #
+  # The scout writes its notes to a file, so a scout turn produces NO
+  # terminal output at all — and a scout turn is 1-4 sequential LLM calls
+  # (observe, then any tool round-trips, then a spawned analyst's own run).
+  # On a local model that is minutes of dead-silent terminal, which reads
+  # as a hang. These lines prove the show is still moving.
+
+  def working(who, what)
+    puts Rainbow("  · #{who} #{what}…").darkgray
+    $stdout.flush
+    log("  · #{who} #{what}...")
+  end
+
   # ── Scout (file only) ───────────────────────────────────
 
   def scout(round_num, notes)

data/examples/14_rusty_circuit/heckler.rb

@@ -11,8 +11,9 @@
 # own jokes using the comedian as the punch line.
 #
 # Subscribes to the :room channel to hear performances.
-# Room deliveries are routed through the core processing guard,
-# which serializes run() calls to prevent Async fiber interleaving.
+# Room deliveries are handed to the robot's BusPoller via
+# enqueue_delivery, which serializes run() calls so Async fiber
+# interleaving can't corrupt chat history.
 # Sends feedback directly to the comic's personal channel.
 #
 class Heckler < RobotLab::Robot
@@ -23,7 +24,7 @@ class Heckler < RobotLab::Robot
     @won_over = false
     @display  = display
 
-    super(name: "heckler", model: LLM[:default].model, template: :open_mic_heckler, bus: bus)
+    super(name: "heckler", **llm_opts, template: :open_mic_heckler, bus: bus)
 
     # Handle incoming messages — the core processing guard
     # serializes all deliveries, preventing concurrent run()
@@ -54,10 +55,11 @@ class Heckler < RobotLab::Robot
       send_reply(to: message.from.to_sym, content: verdict, in_reply_to: message.key) if @rounds < MAX_ROUNDS
     end
 
-    # Listen to the room for the comic's performances.
-    # Route through the core processing guard.
+    # Listen to the room for the comic's performances. Deliveries go to
+    # the robot's own BusPoller, which serializes them behind any run()
+    # already in flight before handing them to the on_message handler.
     @bus.subscribe(:room) do |delivery|
-      handle_incoming_delivery(delivery)
+      enqueue_delivery(delivery)
     end
   end
 end

data/examples/14_rusty_circuit/open_mic.rb

@@ -23,15 +23,24 @@
 # Communication uses a shared :room channel — the comic publishes
 # performances there, and both the heckler and scout subscribe.
 # The heckler sends feedback directly to the comic's personal channel.
-# Room deliveries are routed through the core processing guard
-# (BusMessaging#handle_incoming_delivery), which serializes all
-# run() calls to prevent Async fiber interleaving from corrupting
-# chat history.
+# Room deliveries are handed to each robot's BusPoller via
+# BusMessaging#enqueue_delivery, which serializes all run() calls so
+# Async fiber interleaving can't corrupt chat history.
 #
 # Style reinventions are injected into the next round's user prompt
 # rather than modifying the chat's system messages, avoiding message
 # ordering issues while achieving genuine self-modification.
 #
+# RUNTIME: this is the most expensive example in the suite. A full show is
+# ~30 LLM calls (16 minimum, plus a round-trip per tool call and a full run
+# for every robot the comic or scout spawns). On a 20B+ local model at ~60s
+# per call that is 30+ minutes. Long silent stretches are the scout thinking,
+# not a hang — it writes notes to output/scout_notes.md rather than STDOUT,
+# so the "· Scout …" lines are your liveness signal.
+#
+# For a demo you can watch in a few minutes, point it at a smaller model:
+#   LLM_PROFILE=small bundle exec ruby examples/14_rusty_circuit/open_mic.rb
+#
 # Usage:
 #   bundle exec ruby examples/14_rusty_circuit/open_mic.rb
 #   bundle exec ruby examples/14_rusty_circuit/open_mic.rb --log show.log
@@ -86,7 +95,8 @@ display.separator
 # The opening bit — comic performs, then enters the feedback loop
 opening = comic.run(
   "You just stepped on stage at The Rusty Circuit open mic. " \
-  "The crowd looks tough. Do your opening bit."
+  "The crowd looks tough. Do your opening bit.",
+  tools: :inherit
 ).reply.strip
 
 display.comic("Comic [Opening]", opening)
@@ -102,7 +112,8 @@ comic.send_message(to: :room, content: "OPENING: #{opening}")
 display.separator
 
 # Final verdict from the talent scout
-verdict = scout.run(scout.verdict_prompt).reply.strip
+display.working("Scout", "writing the final verdict")
+verdict = scout.run(scout.verdict_prompt, tools: :inherit).reply.strip
 
 display.verdict("Scout [FINAL VERDICT]", verdict)
 

data/examples/14_rusty_circuit/scout.rb

@@ -22,7 +22,7 @@ class RecruitAnalyst < RobotLab::Tool
       robot.analysts_spawned += 1
       robot.spawn(
         name: "#{specialty}_analyst",
-        model: LLM[:default].model,
+        **llm_opts,
         system_prompt:
           "You are an expert #{specialty.tr('_', ' ')} analyst " \
           "for stand-up comedy. You've studied the craft for decades. " \
@@ -30,6 +30,7 @@ class RecruitAnalyst < RobotLab::Tool
           "and insightful. 2-3 sentences max."
       )
     end
+    robot.display&.working("Scout", "consulting the #{specialty.tr('_', ' ')} analyst")
     analysis = analyst.run(robot.log.join("\n")).reply.strip
     robot.display&.scout_analyst(specialty, analysis)
     analysis
@@ -70,10 +71,9 @@ end
 # analysts when they see something worth examining closely.
 #
 # Subscribes to the :room channel to observe performances.
-# Room deliveries are routed through the core processing guard
-# (BusMessaging#handle_incoming_delivery), which serializes all
-# run() calls to prevent Async fiber interleaving from corrupting
-# chat history.
+# Room deliveries are handed to the robot's BusPoller via
+# BusMessaging#enqueue_delivery, which serializes all run() calls so
+# Async fiber interleaving can't corrupt chat history.
 #
 class Scout < RobotLab::Robot
   attr_accessor :log, :analysts_spawned, :pending_criteria, :display
@@ -86,7 +86,7 @@ class Scout < RobotLab::Robot
 
     super(
       name: "scout",
-      model: LLM[:default].model,
+      **llm_opts,
       template: :open_mic_scout,
       bus: bus,
       local_tools: [
@@ -103,10 +103,11 @@ class Scout < RobotLab::Robot
       observe_and_note(message.content.to_s)
     end
 
-    # Listen to the room for the comic's performances.
-    # Route through the core processing guard.
+    # Listen to the room for the comic's performances. Deliveries go to
+    # the robot's own BusPoller, which serializes them behind any run()
+    # already in flight before handing them to the on_message handler.
     @bus.subscribe(:room) do |delivery|
-      handle_incoming_delivery(delivery)
+      enqueue_delivery(delivery)
     end
   end
 
@@ -151,7 +152,13 @@ class Scout < RobotLab::Robot
               "patterns, consider recruiting an analyst or refining " \
               "your evaluation criteria."
 
-    notes = run(prompt).reply.strip
+    # The scout's notes go to a file, so announce the turn on STDOUT first —
+    # otherwise this is several minutes of silent terminal on a local model.
+    @display.working("Scout", "taking notes on round #{@log.size}")
+
+    # tools: :inherit — run() defaults to :none, which would leave
+    # recruit_analyst and refine_criteria attached but never offered.
+    notes = run(prompt, tools: :inherit).reply.strip
 
     @display.scout(@log.size, notes)
   end

data/examples/15_memory_network_and_bus/editorial_pipeline.rb

@@ -57,7 +57,7 @@ bus = TypedBus::MessageBus.new
 
 mac_writer = OsWriter.new(
   name: "mac_writer",
-  model: LLM[:default].model,
+  **llm_opts,
   template: :os_advocate,
   local_tools: [RobotLab::AskUser],
   context: {
@@ -69,7 +69,7 @@ mac_writer = OsWriter.new(
 
 win_writer = OsWriter.new(
   name: "win_writer",
-  model: LLM[:default].model,
+  **llm_opts,
   template: :os_advocate,
   local_tools: [RobotLab::AskUser],
   context: {
@@ -81,7 +81,7 @@ win_writer = OsWriter.new(
 
 linux_writer = LinuxWriter.new(
   name: "linux_writer",
-  model: LLM[:default].model,
+  **llm_opts,
   template: :os_advocate,
   local_tools: [RobotLab::AskUser],
   context: {
@@ -94,7 +94,7 @@ linux_writer = LinuxWriter.new(
 
 editor = OsEditor.new(
   name: "editor",
-  model: LLM[:default].model,
+  **llm_opts,
   template: :os_editor,
   bus: bus
 )
@@ -103,7 +103,7 @@ editor = OsEditor.new(
 revision_count = 0
 editor.on_message do |message|
   revised = editor.run(message.content).reply.strip
-  editor.instance_variable_set(:@article, revised)
+  editor.article = revised
 
   revision_count += 1
   path = File.join(OUTPUT_DIR, "revision_#{revision_count}.md")
@@ -116,16 +116,20 @@ end
 
 chief = EditorInChief.new(
   name: "chief",
-  model: LLM[:default].model,
+  **llm_opts,
   template: :os_chief,
   bus: bus
 )
 
-# Network orchestrates the writing pipeline
+# Network orchestrates the writing pipeline.
+#
+# tools: :inherit on the writer tasks — Task forwards it to robot.run, which
+# defaults to :none and would otherwise hand the provider an empty tool list,
+# leaving each writer's AskUser tool attached but never offered to the model.
 network = RobotLab.create_network(name: "os_editorial") do
-  task :mac_writer,   mac_writer,   depends_on: :none
-  task :win_writer,   win_writer,   depends_on: :none
-  task :linux_writer, linux_writer, depends_on: :none
+  task :mac_writer,   mac_writer,   depends_on: :none, tools: :inherit
+  task :win_writer,   win_writer,   depends_on: :none, tools: :inherit
+  task :linux_writer, linux_writer, depends_on: :none, tools: :inherit
   task :editor,       editor,       depends_on: [:mac_writer, :win_writer, :linux_writer]
 end
 

data/examples/15_memory_network_and_bus/linux_writer.rb

@@ -26,7 +26,7 @@ class LinuxWriter < OsWriter
       #{distro_analyses}
     PROMPT
 
-    robot_result = run(enriched, network_memory: @shared_memory)
+    robot_result = run(enriched, network_memory: @shared_memory, tools: :inherit)
 
     if @shared_memory
       draft = robot_result.reply.to_s
@@ -57,7 +57,7 @@ class LinuxWriter < OsWriter
 
     distros.each do |distro|
       puts "  [#{@name}] Spawning #{distro[:label]} specialist..."
-      specialist = spawn(name: distro[:name], model: LLM[:default].model, system_prompt: distro[:prompt])
+      specialist = spawn(name: distro[:name], **llm_opts, system_prompt: distro[:prompt])
       @specialists << specialist
 
       analysis = specialist.run(

data/examples/15_memory_network_and_bus/os_editor.rb

@@ -7,7 +7,9 @@
 # extract_run_context mutation issue with parallel pipeline steps.
 class OsEditor < RobotLab::Robot
   attr_accessor :shared_memory
-  attr_reader :article
+  # article is writable so the chief's revision loop can install a revised
+  # draft without reaching for instance_variable_set.
+  attr_accessor :article
 
   def initialize(**opts)
     super(**opts)

data/examples/15_memory_network_and_bus/os_writer.rb

@@ -18,7 +18,10 @@ class OsWriter < RobotLab::Robot
   def call(result)
     message = extract_message(result)
 
-    robot_result = run(message, network_memory: @shared_memory)
+    # tools: :inherit is passed explicitly. This override bypasses
+    # extract_run_context (see the note above), so the task's tools setting
+    # never reaches run() on its own — and run() defaults to :none.
+    robot_result = run(message, network_memory: @shared_memory, tools: :inherit)
 
     if @shared_memory
       draft = robot_result.reply.to_s