robot_lab 0.2.1 → 0.2.6

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: robot_lab
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.6
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -149,6 +149,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: ractor_queue
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: async-http
   requirement: !ruby/object:Gem::Requirement
@@ -186,7 +200,7 @@ description: |
   durable learning (robot_lab-durable), Ractor concurrency (robot_lab-ractor), and
   document storage (robot_lab-document_store).
 email:
-- dewayne@vanhoozer.me
+- dvanhoozer@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -201,6 +215,8 @@ files:
 - ".envrc"
 - ".github/workflows/deploy-github-pages.yml"
 - ".irbrc"
+- ".loki"
+- ".quality/reek_baseline.txt"
 - ".rubocop.yml"
 - CHANGELOG.md
 - CLAUDE.md
@@ -252,6 +268,7 @@ files:
 - docs/getting-started/quick-start.md
 - docs/guides/building-robots.md
 - docs/guides/creating-networks.md
+- docs/guides/hooks.md
 - docs/guides/index.md
 - docs/guides/knowledge.md
 - docs/guides/mcp-integration.md
@@ -372,6 +389,7 @@ files:
 - examples/33_stock_generator.rb
 - examples/33_stock_predictor.rb
 - examples/34_agentskills.rb
+- examples/35_hooks.rb
 - examples/README.md
 - examples/common.rb
 - examples/prompts/assistant.md
@@ -423,19 +441,26 @@ files:
 - examples/prompts/template_with_skills_test.md
 - examples/prompts/triage.md
 - examples/ruboruby.md
-- examples/temp.md
+- examples/xyzzy.rb
 - lib/robot_lab.rb
 - lib/robot_lab/agent_skill.rb
 - lib/robot_lab/agent_skill_catalog.rb
 - lib/robot_lab/ask_user.rb
+- lib/robot_lab/budget/ledger.rb
 - lib/robot_lab/bus_poller.rb
+- lib/robot_lab/capabilities.rb
 - lib/robot_lab/config.rb
 - lib/robot_lab/config/defaults.yml
 - lib/robot_lab/convergence.rb
 - lib/robot_lab/delegation_future.rb
 - lib/robot_lab/doom_loop_detector.rb
 - lib/robot_lab/error.rb
+- lib/robot_lab/errors.rb
 - lib/robot_lab/history_compressor.rb
+- lib/robot_lab/hook.rb
+- lib/robot_lab/hook_context.rb
+- lib/robot_lab/hook_registry.rb
+- lib/robot_lab/hooks.rb
 - lib/robot_lab/mcp/client.rb
 - lib/robot_lab/mcp/connection_poller.rb
 - lib/robot_lab/mcp/server.rb
@@ -448,16 +473,23 @@ files:
 - lib/robot_lab/memory.rb
 - lib/robot_lab/memory_change.rb
 - lib/robot_lab/message.rb
+- lib/robot_lab/narrator.rb
 - lib/robot_lab/network.rb
 - lib/robot_lab/robot.rb
 - lib/robot_lab/robot/agent_skill_matching.rb
+- lib/robot_lab/robot/budget.rb
 - lib/robot_lab/robot/bus_messaging.rb
 - lib/robot_lab/robot/history_search.rb
+- lib/robot_lab/robot/hooking.rb
 - lib/robot_lab/robot/mcp_management.rb
 - lib/robot_lab/robot/template_rendering.rb
 - lib/robot_lab/robot_message.rb
 - lib/robot_lab/robot_result.rb
 - lib/robot_lab/run_config.rb
+- lib/robot_lab/runnable.rb
+- lib/robot_lab/sandbox.rb
+- lib/robot_lab/sandbox/null.rb
+- lib/robot_lab/sandbox/seatbelt.rb
 - lib/robot_lab/script_tool.rb
 - lib/robot_lab/state_proxy.rb
 - lib/robot_lab/streaming/context.rb
@@ -477,101 +509,6 @@ files:
 - robot_concurrency.md
 - sig/robot_lab.rbs
 - simple_acp_review.md
-- site/404.html
-- site/api/core/index.html
-- site/api/core/memory/index.html
-- site/api/core/network/index.html
-- site/api/core/robot/index.html
-- site/api/core/state/index.html
-- site/api/core/tool/index.html
-- site/api/index.html
-- site/api/mcp/client/index.html
-- site/api/mcp/index.html
-- site/api/mcp/server/index.html
-- site/api/mcp/transports/index.html
-- site/api/messages/index.html
-- site/api/messages/text-message/index.html
-- site/api/messages/tool-call-message/index.html
-- site/api/messages/tool-result-message/index.html
-- site/api/messages/user-message/index.html
-- site/api/streaming/context/index.html
-- site/api/streaming/events/index.html
-- site/api/streaming/index.html
-- site/architecture/core-concepts/index.html
-- site/architecture/index.html
-- site/architecture/message-flow/index.html
-- site/architecture/network-orchestration/index.html
-- site/architecture/robot-execution/index.html
-- site/architecture/state-management/index.html
-- site/assets/css/custom.css
-- site/assets/images/favicon.png
-- site/assets/images/robot_lab.jpg
-- site/assets/javascripts/bundle.79ae519e.min.js
-- site/assets/javascripts/bundle.79ae519e.min.js.map
-- site/assets/javascripts/lunr/min/lunr.ar.min.js
-- site/assets/javascripts/lunr/min/lunr.da.min.js
-- site/assets/javascripts/lunr/min/lunr.de.min.js
-- site/assets/javascripts/lunr/min/lunr.du.min.js
-- site/assets/javascripts/lunr/min/lunr.el.min.js
-- site/assets/javascripts/lunr/min/lunr.es.min.js
-- site/assets/javascripts/lunr/min/lunr.fi.min.js
-- site/assets/javascripts/lunr/min/lunr.fr.min.js
-- site/assets/javascripts/lunr/min/lunr.he.min.js
-- site/assets/javascripts/lunr/min/lunr.hi.min.js
-- site/assets/javascripts/lunr/min/lunr.hu.min.js
-- site/assets/javascripts/lunr/min/lunr.hy.min.js
-- site/assets/javascripts/lunr/min/lunr.it.min.js
-- site/assets/javascripts/lunr/min/lunr.ja.min.js
-- site/assets/javascripts/lunr/min/lunr.jp.min.js
-- site/assets/javascripts/lunr/min/lunr.kn.min.js
-- site/assets/javascripts/lunr/min/lunr.ko.min.js
-- site/assets/javascripts/lunr/min/lunr.multi.min.js
-- site/assets/javascripts/lunr/min/lunr.nl.min.js
-- site/assets/javascripts/lunr/min/lunr.no.min.js
-- site/assets/javascripts/lunr/min/lunr.pt.min.js
-- site/assets/javascripts/lunr/min/lunr.ro.min.js
-- site/assets/javascripts/lunr/min/lunr.ru.min.js
-- site/assets/javascripts/lunr/min/lunr.sa.min.js
-- site/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
-- site/assets/javascripts/lunr/min/lunr.sv.min.js
-- site/assets/javascripts/lunr/min/lunr.ta.min.js
-- site/assets/javascripts/lunr/min/lunr.te.min.js
-- site/assets/javascripts/lunr/min/lunr.th.min.js
-- site/assets/javascripts/lunr/min/lunr.tr.min.js
-- site/assets/javascripts/lunr/min/lunr.vi.min.js
-- site/assets/javascripts/lunr/min/lunr.zh.min.js
-- site/assets/javascripts/lunr/tinyseg.js
-- site/assets/javascripts/lunr/wordcut.js
-- site/assets/javascripts/workers/search.2c215733.min.js
-- site/assets/javascripts/workers/search.2c215733.min.js.map
-- site/assets/stylesheets/main.484c7ddc.min.css
-- site/assets/stylesheets/main.484c7ddc.min.css.map
-- site/assets/stylesheets/palette.ab4e12ef.min.css
-- site/assets/stylesheets/palette.ab4e12ef.min.css.map
-- site/concepts/index.html
-- site/examples/basic-chat/index.html
-- site/examples/index.html
-- site/examples/mcp-server/index.html
-- site/examples/multi-robot-network/index.html
-- site/examples/rails-application/index.html
-- site/examples/tool-usage/index.html
-- site/getting-started/configuration/index.html
-- site/getting-started/index.html
-- site/getting-started/installation/index.html
-- site/getting-started/quick-start/index.html
-- site/guides/building-robots/index.html
-- site/guides/creating-networks/index.html
-- site/guides/index.html
-- site/guides/mcp-integration/index.html
-- site/guides/memory/index.html
-- site/guides/rails-integration/index.html
-- site/guides/streaming/index.html
-- site/guides/using-tools/index.html
-- site/index.html
-- site/search/search_index.json
-- site/sitemap.xml
-- site/sitemap.xml.gz
-- site/tags.json
 - temp.md
 - tool_manifest_plan.md
 homepage: https://github.com/MadBomber/robot_lab
@@ -599,7 +536,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Ruby framework for building and orchestrating multi-robot LLM workflows
 test_files: []

data/examples/temp.md

@@ -1,51 +0,0 @@
-## RoboRuby Ruby AI Newsletter Summary – Issue 29 (April 30, 2026)
-
-### 🔥 **Headline Story: Ruby's I/O Revolution for AI Workloads**
-
-Performance is now the narrative. [Carmine Paolino's work on Solid Queue](https://paolino.me/solid-queue-doesnt-need-a-thread-per-job/) shows fiber-based concurrency nets **12% throughput gains** for LLM streaming tasks—and [Shopify just proved it scales](https://speakerdeck.com/ioquatix/surviving-black-friday-329-billion-requests-with-falcon): 329 billion requests during 2025 Black Friday on Falcon (Samuel Williams' fiber-based server), peaking at 1.5M req/sec with zero drops. The message is clear: threads are legacy; fibers are the future for AI-heavy I/O patterns that spend 99% of their time waiting on tokens and webhooks. Ruby's defaults are catching up to its workloads.
-
----
-
-### **Headline Story #2: Matz Ships a Compiler in a Month (with Claude)**
-
-[Spinel](https://github.com/matz/spinel)—Matz's new ahead-of-time Ruby compiler built in ~30 days with Claude as co-author—produces standalone native executables via whole-program type inference and optimized C emission. The kicker: it drops `eval`, `instance_eval`, `class_eval`, `send`, `method_missing`, and `define_method`. Dynamic metaprogramming was always about code compression for humans; with AI writing the alternative on your behalf, static Ruby becomes viable. At RubyKaigi, Matz revealed 1/3 of Ruby core already writes 50% of code with AI; he writes 100% his way. [Sam Ruby's Roundhouse transpiler](https://intertwingly.net/blog/2026/04/28/Round-Trip.html) proves the concept: two `make` commands from a fresh clone yield a real Rails app running on localhost as a single native binary. The door to Spinel-compiled Rails is open.
-
----
-
-### **Headline Story #3: Rails Gets Its First AI-Native Command**
-
-[`rails query` shipped in Rails 8.2](https://github.com/basecamp/console1984/pull/154)—a CLI designed for AI agents to safely examine production databases with **structured JSON output** instead of unstructured strings. It prevents destructive commands, returns explicit `columns`, `rows`, and `meta`, provides pagination cursors and generated SQL, and emits auditable `query.rails` notifications. Lewis Buckley also released a [Claude Code skill](https://github.com/lewispb/rails-query-skill) teaching Claude to translate natural questions into `bin/rails query` calls. This is Rails designing agent-native interfaces directly into the runtime—not documentation, not third-party gems.
-
----
-
-### **Notable Gems & Tools**
-
-- **[LLM Cost Tracker](https://github.com/sergey-homenko/llm_cost_tracker)** — Logs every LLM API call with token counts, costs, latency; includes a mountable dashboard and budget guardrails.
-- **[Ragents](https://github.com/activeagents/ragents)** — Ruby AI agent framework using Ractors for isolated parallel execution; near-linear scaling for agent swarms on Ruby 4.x.
-- **[Inkmark](https://github.com/yaroslav/inkmark)** — AI-first Markdown gem (built on Rust's pulldown-cmark) for RAG pipelines with heading-based chunking, block-aware truncation, and structured extraction.
-- **[Kernai](https://github.com/Eth3rnit3/kernai)** — Minimal agentic framework with deterministic loops, progressive skill discovery, and MCP integration for lightweight portability.
-- **[Kreuzcrawl](https://github.com/kreuzberg-dev/kreuzcrawl)** — High-performance Rust web crawler with Ruby bindings, MCP server for agents, and headless browser rendering.
-- **[llm.rb v5.4.0](https://0x1eef.github.io/x/llm.rb/file.CHANGELOG.html)** — Database persistence for contexts, agentic loops, context compaction, and scoped MCP client lifecycle.
-
----
-
-### **Key Articles & Tutorials**
-
-- **[Ruby Concurrency: What Actually Happens](https://paolino.me/ruby-concurrency-what-actually-happens/)** — Carmine's definitive explainer on fibers vs. threads, addressing real questions from the community with corrections from core committer Jean Boussier.
-- **[PII Filtering for RubyLLM with Top Secret](https://thoughtbot.com/blog/ruby-llm-top-secret)** — Steve Polito on filtering sensitive data before sending to LLM providers; integrates cleanly with ActiveRecord chats.
-- **[Claude Code for the Semi-Reluctant Rails Developer](https://robbyonrails.com/claude-code-curious-rails-developers/)** — Robby Russell's practical guide on model selection, testing workflows, debugging, and minimal CLAUDE.md configuration.
-- **[Rails Security Auditor](https://maquina.app/documentation/ai-tools/rails-security-auditor/)** — Claude Code plugin that scans Rails apps across 10 security categories and can auto-fix issues.
-
----
-
-### **Quick Takes**
-
-- 🎯 **New Announcements:** [Compound Engineering v3](https://x.com/trevin/status/2047066108763770998) unified the agentic plugin namespace; [Ruby CrewAI](https://github.com/MuhammadIbtisam/ruby-crewai) wraps CrewAI's HTTP API for multi-agent orchestration; [RailsPress](https://railspress.org/) is a mountable Rails 8 blogging engine with AI-agent-friendly REST APIs.
-- 🏗️ **Tools for Agents:** [Stripe Link for Agents](https://x.com/stripe/status/2049529444092838116) lets AI spend on user behalf via scoped merchant tokens; [Cursor's @cursor/sdk](https://cursor.com/blog/typescript-sdk) exposes its own runtime so you can run coding agents from CI/CD; [Cloudflare Artifacts](https://blog.cloudflare.com/artifacts-git-for-agents-beta/) is a Git-compatible versioned filesystem for agent state.
-- 📊 **Model Sizing:** Bojie Li's [Incompressible Knowledge Probes](https://01.me/research/ikp/) calibrate closed LLM sizes—GPT-5.5 at ~9T params, Claude Opus at ~4.7T, Gemini 2.5 Pro at ~1.2T.
-- 🎤 **Conference Alert:** [Rails World 2026](https://rubyonrails.org/2026/4/23/big-rails-world-2026-update-CFP) (Sept 23–24 in Austin) now emphasizes AI-native development; CFP closes May 16th.
-- 📈 **Community Pulse:** [2026 Rails Community Survey](https://blog.planetargon.com/blog/entries/the-2026-ruby-on-rails-community-survey-is-open) now asks about AI tool usage, JS frameworks, and infrastructure—open through July 3rd.
-
----
-
-**Bottom Line:** Ruby's ecosystem is doubling down on event-driven I/O, native compilation, and agent-native tooling. The era of threads-by-default and human-first interfaces is over. If your Rails app handles long-tail I/O or needs production-safe agent introspection, the framework is building for you now.