robot_lab 0.0.1 → 0.0.6

data/examples/14_rusty_circuit/scout.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+# ── Scout Tools ────────────────────────────────────────────
+#
+# Each tool accesses the owning robot via the `robot` accessor
+# inherited from RobotLab::Tool.
+
+class RecruitAnalyst < RobotLab::Tool
+  description "Bring in a specialist to analyze a specific aspect " \
+              "of the comedian's performance. The analyst will " \
+              "review your accumulated notes and provide insight."
+
+  param :specialty, type: "string",
+        desc: "What to analyze: timing, crowd_work, " \
+              "originality, adaptability, stage_presence, " \
+              "material_evolution"
+
+  def execute(specialty:)
+    @analysts ||= {}
+    specialty = specialty.to_s.downcase.gsub(/\s+/, "_")
+    analyst = @analysts[specialty] ||= begin
+      robot.analysts_spawned += 1
+      robot.spawn(
+        name: "#{specialty}_analyst",
+        system_prompt:
+          "You are an expert #{specialty.tr('_', ' ')} analyst " \
+          "for stand-up comedy. You've studied the craft for decades. " \
+          "Analyze the performance notes you're given. Be concise " \
+          "and insightful. 2-3 sentences max."
+      )
+    end
+    analysis = analyst.run(robot.log.join("\n")).reply.strip
+    robot.display&.scout_analyst(specialty, analysis)
+    analysis
+  rescue => e
+    robot.display&.scout_analyst(specialty, "ERROR: #{e.message}")
+    "Analysis unavailable for #{specialty}. Rely on your own observations."
+  end
+end
+
+class RefineCriteria < RobotLab::Tool
+  description "Update your own evaluation criteria based on what " \
+              "you're observing. Use when you realize the most " \
+              "important qualities aren't what you initially expected. " \
+              "The update takes effect on your next evaluation."
+
+  param :updated_criteria, type: "string",
+        desc: "Your refined evaluation criteria and focus areas"
+
+  def execute(updated_criteria:)
+    robot.pending_criteria = updated_criteria
+    robot.display&.scout_criteria(updated_criteria)
+    "Criteria refinement accepted: #{updated_criteria}. " \
+    "Apply these updated criteria to all future evaluations."
+  end
+end
+
+
+# ── The Talent Scout ─────────────────────────────────────────
+#
+# Has two tools with side effects:
+#
+#   recruit_analyst  — spawns a specialist to analyze an aspect
+#                      of the performance (dynamic creation)
+#   refine_criteria  — queues a rewrite of the scout's own
+#                      evaluation criteria (self-modification)
+#
+# The scout observes each round, accumulates notes, and spawns
+# 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.
+#
+class Scout < RobotLab::Robot
+  attr_accessor :log, :analysts_spawned, :pending_criteria, :display
+
+  def initialize(bus:, display:)
+    @log = []
+    @analysts_spawned = 0
+    @pending_criteria = nil
+    @display = display
+
+    super(
+      name: "scout",
+      template: :open_mic_scout,
+      bus: bus,
+      local_tools: [
+        RecruitAnalyst.new(robot: self),
+        RefineCriteria.new(robot: self)
+      ]
+    )
+
+    # Handle incoming messages — the core processing guard
+    # serializes all deliveries, preventing concurrent run()
+    # calls from corrupting chat history.
+    on_message do |message|
+      next unless message.from == "comic"
+      observe_and_note(message.content.to_s)
+    end
+
+    # Listen to the room for the comic's performances.
+    # Route through the core processing guard.
+    @bus.subscribe(:room) do |delivery|
+      handle_incoming_delivery(delivery)
+    end
+  end
+
+  # Build the final verdict prompt with any pending criteria applied
+  def verdict_prompt
+    prompt = ""
+
+    if @pending_criteria
+      prompt += "CRITERIA UPDATE: #{@pending_criteria}. " \
+                "Apply these updated criteria to your final assessment.\n\n"
+      @pending_criteria = nil
+    end
+
+    prompt += "The show is over. Based on everything you've observed " \
+              "(#{@log.size} rounds), all your notes, and any analyst " \
+              "reports, write your final talent assessment. Should this " \
+              "comedian get a callback? Be specific about what worked, " \
+              "what didn't, and what potential you see."
+
+    prompt
+  end
+
+  private
+
+  def observe_and_note(content)
+    @log << content
+
+    # Build the prompt, injecting any queued criteria refinement.
+    # This embeds self-modification in the user prompt rather than
+    # rewriting system messages, avoiding chat message ordering issues.
+    prompt = ""
+
+    if @pending_criteria
+      prompt += "CRITERIA UPDATE: #{@pending_criteria}. " \
+                "Apply these updated criteria to this and all future evaluations.\n\n"
+      @pending_criteria = nil
+    end
+
+    prompt += "You just observed: \"#{content}\"\n\n" \
+              "This is round #{@log.size} of the performance. " \
+              "Write your notes. If you've seen enough to identify " \
+              "patterns, consider recruiting an analyst or refining " \
+              "your evaluation criteria."
+
+    notes = run(prompt).reply.strip
+
+    @display.scout(@log.size, notes)
+  end
+end

data/examples/14_rusty_circuit/scout_notes.md

@@ -0,0 +1,89 @@
+# Scout Notes — The Rusty Circuit
+
+## Round 1
+
+NOTES: Standard opener - relatable premise (self-checkout frustration) but execution feels safe and predictable. The "incompetence" callback shows some self-awareness, and the credit score punchline lands adequately. However, the material feels very "first draft" - like observations everyone has but hasn't been elevated beyond the obvious. 
+
+Delivery seems tentative - that expectant look at the crowd suggests they're fishing for validation rather than confidently driving the room. The mic adjustment and setup felt a bit nervous. Too early to judge adaptability or crowd-handling since this is scripted opener material.
+
+Withholding judgment on star potential - need to see how they handle the next few minutes when they move beyond their safest material. Looking for signs of unique voice, risk-taking, and whether they can build momentum from this foundation.
+
+The premise has potential but needs sharper writing and more confident delivery. Watching for evolution as the set progresses.
+
+### Analyst: crowd_work
+
+**Opening Analysis:** Solid relatable premise with good escalation from simple frustration to self-deprecating punchline about credit scores. The personification of the machine as "lady" adds character, but the expectant pause suggests uncertainty about audience reception.
+
+**Crowd Work Analysis:** Excellent recovery that flips the heckle into material while maintaining control. The callback to "unexpected item" creates a cohesive thread and the broader life metaphor lands with philosophical weight that elevates the bit beyond just grocery store humor.
+
+## Round 2
+
+The analyst confirms what I'm seeing - this comedian has the instinct to turn disruption into opportunity. That crowd work wasn't just damage control, it was material creation in real time. Watching closely for how they build from here.
+
+### Analyst: adaptability
+
+Strong adaptive instincts on display here. The comedian skillfully transforms heckling into collaborative energy, using the "unexpected item" callback to create a unifying metaphor that includes the entire audience in the struggle. The venue-specific self-deprecation in Round 2 shows excellent room-reading skills, turning potential weakness into relatable strength while maintaining momentum through the disruption.
+
+## Round 3
+
+The analyst confirms my assessment - this is someone who thrives on chaos. Three rounds in and they're not just surviving interruptions, they're using them as fuel. This adaptability under fire is exactly what network executives look for in potential stars.
+
+## Round 4
+
+NOTES: This comedian just demonstrated something crucial - they know when to pivot. After three rounds of crowd/venue work, they smoothly transitioned back to prepared material without losing momentum. That's professional-level set management.
+
+The "Michelin star for a gas station hot dog" line is genuinely clever writing - unexpected comparison that works on multiple levels. Shows they can craft material, not just react to situations. The credit score callback maintains continuity while moving the set forward.
+
+But here's what's really impressive: that pause before the parking spot bit. They're reading the room's energy, letting the moment breathe, then shifting gears entirely. The mom hanging up punchline is relatable without being hacky - everyone knows that feeling of getting excited about mundane adult things.
+
+Pattern solidified: This comedian has both reactive instincts AND structured material. They can work a crowd, handle disruption, acknowledge the venue's vibe, then seamlessly return to their prepared set. That's the mark of someone who understands comedy as both art and craft.
+
+The genuine smile suggests they're actually enjoying this chaos rather than just surviving it. That joy is infectious - the room energy has completely shifted from skeptical to engaged.
+
+Star potential is becoming clear. This is someone who could handle late-night TV, corporate gigs, or hostile crowds with equal skill.
+
+### Analyst: stage_presence
+
+**Opening:** Solid relatable premise with good energy, but the delivery feels a bit rehearsed and the expectant pause telegraphs insecurity. The crowd interaction attempt comes off as needy rather than confident.
+
+**Round 1:** Excellent heckler handling - you flipped the dynamic by making them part of the bit rather than fighting them. The "unexpected item in the bagging area of life" callback is clever and shows real comedic instincts.
+
+**Rounds 2-4:** You found your rhythm by embracing the room's energy and building genuine rapport with both heckler and audience. The self-deprecating humor feels authentic now, and you're working WITH the room instead of AT it - that's when comedy magic happens.
+
+## Round 5
+
+The analyst nails it - this comedian's stage presence evolved dramatically over the set. Started nervous, ended commanding. That transformation under fire is exactly what separates working comics from stars. This is someone I'd book tomorrow.
+
+---
+
+## Final Verdict
+
+**FINAL TALENT ASSESSMENT - THE RUSTY CIRCUIT**
+
+**RECOMMENDATION: IMMEDIATE CALLBACK - HIGH PRIORITY**
+
+**What Worked:**
+This comedian demonstrated the rarest quality in stand-up: they get BETTER under pressure. What started as a tentative, safe opener transformed into a masterclass in crowd control and comedic instincts. Key strengths:
+
+- **Exceptional Adaptability**: Turned multiple heckles into material gold, showing they can handle any room
+- **Crowd Work Mastery**: The "Stockholm syndrome with punchlines" callback was sophisticated writing in real-time
+- **Venue Intelligence**: Used The Rusty Circuit's gritty reputation as material rather than apologizing for it
+- **Quotable Writing**: "Navy SEALs of entertainment" and "unexpected item in the bagging area of life" are lines that stick
+- **Authentic Voice**: Found the sweet spot between vulnerability and confidence
+
+**What Didn't Work:**
+- Opening material felt generic and over-rehearsed
+- Initial delivery showed nerves and validation-seeking
+- Took 2-3 minutes to find their authentic voice
+
+**Star Potential:**
+This comedian has the complete package for network success:
+1. **Resilience**: Thrives on chaos rather than crumbling
+2. **Versatility**: Can handle prepared material, crowd work, and venue-specific content seamlessly  
+3. **Growth Mindset**: Visibly improved throughout the 5-round set
+4. **Professional Instincts**: Knows when to engage hecklers vs. when to pivot back to material
+
+**Bottom Line:**
+I've seen three headliners come from this room. This comedian has that same "it" factor - the ability to turn any situation into comedy gold. They're not just surviving difficult rooms, they're conquering them. That's exactly what we need for late-night spots, corporate gigs, and hostile festival crowds.
+
+**Next Steps:** Book them for a showcase set immediately. This is someone who could be headlining within 18 months with proper development.

data/examples/14_rusty_circuit/show.log

@@ -0,0 +1,234 @@
+
+============================================================
+  THE RUSTY CIRCUIT — Tuesday Open Mic
+  Architecture Dominates Material
+============================================================
+
+  Cast:
+    Comic   — observational humor, armed with self-modification tools
+    Heckler — three-year regular, high standards, zero patience
+    Scout   — talent network, sitting in the back with a notebook
+
+  ────────────────────────────────────────────────────────
+
+
+  Comic [Opening]:
+    *walks up to mic, adjusts it slightly*
+    
+    So I was at the grocery store yesterday, and they
+    have those self-checkout machines now. You know what
+    I love about them? They're the only employee that
+    judges you for buying ice cream at 2 PM on a Tuesday.
+    "Unexpected item in bagging area" - yeah, it's my
+    life choices, Karen-bot. At least the human cashiers
+    pretend not to notice when I'm buying wine and cat
+    food... again.
+    
+    *glances at crowd for reaction*
+
+
+  Heckler [Round 1]:
+    *from the back of the room*
+    
+    Oh wow, self-checkout jokes! What's next, airline
+    food? Here's a thought - maybe the machine's
+    judging you because you're shopping in your
+    pajamas talking to robots about your drinking
+    problem!
+
+           [adjust_energy] -> 0.7 (Need to get edgier and more confrontational to match this crowd's energy - they want bite, not safe observational stuff)
+  Scout [Round 1]: NOTES: Strong opener - relatable premise with a modern twist on self-checkout frustration. Good observational comedy foundation. The "Karen-bot" line got a solid laugh - shows ability to blend current cultural references with universal experiences. Nice self-deprecating turn with the wine/cat food callback. 
+
+What caught my attention: The mic adjustment was confident, not nervous. The glance at the crowd shows awareness and connection-seeking. Material feels fresh enough - not the tired "self-checkout is confusing" angle, but the personification/judgment angle. 
+
+Early read: Solid technical foundation, relatable voice. Need to see how they handle transitions and whether they can build momentum beyond the opener. The self-deprecating element could be a strength if balanced right, or a limitation if it becomes the only note they can hit.
+
+Watching for: Does the material deepen or stay surface-level? How do they handle the next transition? Can they read the room and adjust energy accordingly?
+
+Too early for specialist analysis - want to see more material flow and crowd interaction patterns first.
+
+  Comic [Round 1]:
+    *turns toward the heckler with a grin*
+    
+    Oh, you want fresh material? Here's something new - I
+    actually WAS in my pajamas, and yeah, I DO have a
+    drinking problem... it's that I keep running out! But
+    at least when I talk to robots, they don't interrupt
+    my set from the cheap seats. The machine said
+    "unexpected item" - turns out it was detecting your
+    personality from three aisles away!
+    
+    *leans into the mic*
+
+
+  Heckler [Round 2]:
+    *sits back in chair, arms crossed*
+    
+    Alright, alright... not bad. You actually
+    listened and fired back instead of just whining
+    about hecklers. The "detecting your personality"
+    bit was decent. Keep going, pajama boy - let's
+    see if you can maintain that energy without
+    leaning on the self-checkout crutch again.
+
+
+  Comic [Round 2]:
+    *grins and nods at the heckler*
+    
+    You know what? I respect that. Most people here look
+    like they'd rather be at home watching Netflix, but
+    you're actually engaged. Speaking of home - I live
+    alone with my cat, Mr. Whiskers. Yeah, I named my cat
+    Mr. Whiskers because I'm apparently twelve years old.
+    But here's the thing - he's the only male in my life
+    who doesn't leave me on read. Sure, he ignores me
+    too, but at least he's honest about it. He just
+    stares at me like "Feed me or die, human." It's
+    refreshing compared to dating apps where everyone's
+    like "Looking for something real" then ghosts you
+    after you suggest meeting somewhere that isn't their
+    bedroom.
+    
+    *looks back at the heckler*
+    
+    How am I doing, coach?
+
+           [crowd_work_analyst] Strong opening premise with universal relatability - everyone's battled those self-checkout machines. The "Karen-bot" callback and escalation to wine/cat food creates a nice rhythm of mounting absurdity that lands well.
+
+The heckler response shows excellent crowd work instincts - you flipped their energy by owning the roast while delivering a killer punchline about the machine "detecting your personality." That's how you turn disruption into material gold.
+
+  Heckler [Round 3]:
+    *leans forward slightly*
+    
+    Better. The cat bit has legs - "feed me or die"
+    is solid, and the dating app contrast works.
+    You're finding your rhythm instead of just doing
+    crowd work. But don't ask me how you're doing -
+    that's needy comedian 101. Trust your material
+    and keep building on what's working.
+
+  Scout [Round 2]: The analyst confirms what I'm seeing - this performer has the instincts. They don't just handle disruption, they weaponize it. That callback integration was masterful. Need to see if this adaptability extends beyond hecklers to reading room energy and adjusting accordingly.
+
+  Comic [Round 3]:
+    *straightens up, drops the validation-seeking*
+    
+    You're right. So Mr. Whiskers has better boundaries
+    than most humans I know. Last week I brought a date
+    home, and this cat literally sat between us on the
+    couch like a furry chaperone. Just staring. Not
+    blinking. My date goes "Is he always like this?" and
+    I said "Only when he senses desperation." Plot twist
+    - he was staring at me, not her. Even my own cat
+    knows I'm trying too hard. She left, but Mr. Whiskers
+    stayed. Rubbed against my leg like "Don't worry,
+    human. Your standards will drop eventually."
+    
+    *pauses for effect*
+    
+    That cat's got more game than I do.
+
+
+  Heckler [Round 4]:
+    *chuckles and shakes head*
+    
+    Now you're cooking! "Only when he senses
+    desperation" - that's a real punchline. And the
+    cat being your wingman while simultaneously
+    roasting you? That's the kind of self-deprecating
+    stuff that actually works. You went from hack
+    grocery store material to something with actual
+    personality. Keep mining that gold, cat dad.
+
+           [adaptability_analyst] **Round 1**: Solid defensive pivot that turns the interruption into material while maintaining control. The "detecting your personality" callback is clever, but the energy feels slightly reactive rather than commanding.
+
+**Round 2**: Excellent recovery - acknowledging the heckler while seamlessly weaving it into extended material about dating and loneliness. The "How am I doing, coach?" ending shows confidence and transforms the dynamic from confrontational to collaborative, demonstrating strong crowd work instincts.
+
+  Comic [Round 4]:
+    *riding the momentum, more confident now*
+    
+    Cat dad - I like that. Mr. Whiskers has taught me
+    more about relationships than any self-help book.
+    Like, he's mastered the art of being completely
+    unavailable until HE wants attention. I'll be
+    working, ignoring him for hours, and suddenly he's on
+    my keyboard like "Notice me NOW." It's like he
+    studied every person I've ever dated. The difference
+    is when he's done with me, he just walks away with
+    dignity. No passive-aggressive texts, no "we need to
+    talk," just tail up, ass in my face, and he's gone.
+    I'm taking notes. Next time someone wants to break up
+    with me, I'm just gonna knock something off their
+    coffee table and leave.
+    
+    *grins*
+    
+    Mr. Whiskers: relationship guru and life coach.
+
+  Scout [Round 3]: The analyst confirms my read - this performer has exceptional adaptability. They're not just surviving disruptions, they're using them to build rapport and create a more engaging show. That "coach" callback was brilliant - it reframes the entire dynamic. This is headliner-level crowd management.
+
+Pattern emerging: Strong technical skills, excellent people-reading ability, and the rare gift of turning obstacles into opportunities. Need to see how they close and whether they can maintain this energy throughout a full set.
+
+  Heckler [Round 5]:
+    *actually laughs out loud*
+    
+    Okay, that's genuinely funny! "Knock something
+    off their coffee table and leave" - I'm stealing
+    that move. You found your voice, kid. This is
+    what happens when you stop trying to be every
+    comedian and start being yourself. Mr. Whiskers
+    bit is working because it's specific and honest.
+    Don't abandon this thread - you've got more in
+    there.
+
+    (won over!)
+           [material_evolution_analyst] **Round 1:** The defensive energy and validation-seeking ("How am I doing, coach?") kills momentum. The heckler callback works but you're letting them control your rhythm instead of using their energy to elevate your material.
+
+**Round 2-3:** Much stronger evolution. You transformed genuine vulnerability (living alone, dating struggles) into relatable humor without self-pity. The cat-as-wingman/chaperone bit has real legs - that's material worth developing further.
+
+**Key insight:** Your best moments come when you stop performing *at* the audience and start including them in your perspective. The self-deprecation lands when it feels authentic rather than desperate.
+  Scout [Round 4]: The analyst nailed it - this performer just found their groove. They went from seeking approval to commanding the room through authentic storytelling. The material evolution from scattered observations to cohesive narrative shows real writing chops.
+
+This is the moment I look for - when a comedian stops trying to be funny and just IS funny. The confidence shift, the improved timing, the layered storytelling - this person has headliner potential. They just needed to get out of their own way.
+           [refine_criteria] -> Primary focus: Authentic voice discovery and sustained narrative building. Look for comedians who can transform personal vulnerability into universal insights while maintaining strong technical execution. Key indicators: ability to evolve material in real-time, confidence that builds throughout the set, and the rare skill of turning obstacles into opportunities. Secondary: crowd management instincts and the ability to create inclusive atmosphere while maintaining authority.
+  Scout [Round 5]: This performer just demonstrated everything I look for in a potential star. They found their authentic voice, built a cohesive narrative world, and showed the adaptability that separates headliners from club comics. The Mr. Whiskers character has become their signature - that's the kind of unique perspective that gets development deals.
+
+Star potential: HIGH. This is someone I'd bring to the network.
+  ────────────────────────────────────────────────────────
+
+
+  Scout [FINAL VERDICT]:
+    **FINAL TALENT ASSESSMENT**
+    
+    **RECOMMENDATION: STRONG CALLBACK - DEVELOPMENT POTENTIAL**
+    
+    **What Worked:**
+    This comedian demonstrated the complete arc I look for in a star. They started with solid technical foundation but truly found their voice when challenged. The transformation from Round 2 onward was remarkable - moving from validation-seeking to authentic storytelling with the Mr. Whiskers character becoming a brilliant comedic vehicle.
+    
+    Key strengths:
+    - **Exceptional adaptability**: Turned early heckling into collaborative energy, showing advanced crowd psychology
+    - **Real-time material evolution**: Each round built on the previous, creating a cohesive narrative rather than disconnected bits  
+    - **Authentic vulnerability**: Transformed personal loneliness/dating struggles into universal insights without self-pity
+    - **Technical excellence**: Strong timing, effective callbacks, sophisticated punchline structure (especially the layered cat-judging-comedian reveal)
+    - **Crowd management mastery**: Created inclusive atmosphere while maintaining authority - the "coach" callback was genius-level relationship building
+    
+    **What Didn't Work:**
+    Early rounds showed some validation-seeking behavior that killed momentum. The initial material, while competent, felt safe and familiar (self-checkout, dating apps). However, their ability to recognize and correct this mid-set actually demonstrates star-level self-awareness.
+    
+    **Star Potential:**
+    HIGH. This performer has the rare combination of technical skill, authentic voice, and adaptability under pressure. The Mr. Whiskers character represents the kind of unique perspective that builds careers. They showed they can turn obstacles into opportunities - a crucial skill for television and touring.
+    
+    **Development Notes:**
+    Ready for showcase opportunities. Would benefit from longer set time to fully develop the relationship guru cat concept. Strong candidate for writing room collaboration given their ability to build narrative worlds from personal experience.
+    
+    **Bottom Line:** This is exactly the kind of authentic, adaptable talent we've been looking for. Book the callback.
+
+
+────────────────────────────────────────────────────────────
+  Show Stats:
+    Rounds performed:   5 (opening + 4 rounds)
+    Style reinventions: 0
+    Coaches spawned:    0
+    Analysts recruited: 3
+    Heckler won over:   true
+    Total robots on bus: 6
+

data/examples/15_memory_network_and_bus/editor_in_chief.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# Editor-in-chief lives outside the pipeline, communicates only via bus.
+# Reviews articles and responds with APPROVED or REVISE: feedback.
+class EditorInChief < RobotLab::Robot
+  attr_reader :accepted, :rounds
+
+  def initialize(**opts)
+    super(**opts)
+    @accepted = false
+    @rounds   = 0
+
+    on_message do |message|
+      @rounds += 1
+      verdict = run("Review this article:\n\n#{message.content}").reply.strip
+      @accepted = verdict.start_with?("APPROVED")
+      puts "  Chief   [round #{@rounds}]: #{verdict[0..120]}"
+
+      if !@accepted && @rounds < MAX_REVISIONS
+        send_message(to: :editor, content: "Revise this article. Feedback: #{verdict}")
+      end
+    end
+  end
+end