robot_lab-ractor 0.2.8 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 18c5395ad674a2e28bc7f8de111971c2091857e15f39b26fa8cfbac525c4062c
4
- data.tar.gz: 351f987a54ab19f90684f177c887916b7aa34bca70539c985f2b75768ae1683e
3
+ metadata.gz: bc3ef6cd79094f1b71c29392b35e37dc1a166586e073ca19b94d6c2e6f471dbe
4
+ data.tar.gz: c2c828e8e9f7bf82df0878a197672ba01aec61d7afa11d0cf956115e82d1e66d
5
5
  SHA512:
6
- metadata.gz: 2b944c485e86fd49e268cf1a1f1a7dee1821640fe81c6af22af77ec81f2e82eb63bb9a307e005578c0e7475458ca13d95f97e21e440b6bcd78648ca9d387e9c9
7
- data.tar.gz: 16e68dd71e3753c71e2b87f1852b31413a0355a956ea8c559121974182912ce70a9e7964cc1d7b5b3bc32bea561d9bf648e459728ca30f610995216b5f09bedb
6
+ metadata.gz: 0756a7d4a4ec763dc094b5ebeb3a9b500d6e5627231c30b08dd347f35068f6546fed209a2d96d1a0b9971cc3876684333fbd67b06a4f7aec25015a8bfd94878b
7
+ data.tar.gz: 31a1111b1bd58948527614fe9caf99c823ed64dea2f6d137ae87c560ca46c192ce35e06eeab61470cd8a41c0d6f7e93e65c3d37394cbe3b01b78fe1458edfdde
data/.envrc CHANGED
@@ -2,5 +2,5 @@
2
2
 
3
3
  source_up
4
4
 
5
- export RR=`pwd`
6
- export BUNDLE_GEMFILE=Gemfile
5
+ export RR=$(pwd)
6
+ # BUNDLE_GEMFILE is inherited from the project root .envrc (asgard dev|prod)
data/.ruby-version ADDED
@@ -0,0 +1 @@
1
+ 4.0.9
data/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  ## [Unreleased]
2
2
 
3
+ ## [0.6.1] - 2026-11-19
4
+
5
+ ### Changed
6
+
7
+ - **Minimum Ruby raised to 4.0.9.** `required_ruby_version` is now `>= 4.0.9` (was `>= 3.2.0`), and a `.ruby-version` file pins development to 4.0.9.
8
+ - **Requires `robot_lab ~> 0.6`** (was `~> 0.3.0`). Verified against robot_lab 0.6.1 and ruby_llm 2.2.3; no code changes were needed.
9
+
3
10
  ## [0.2.8] - 2026-09-09
4
11
 
5
12
  Released in lockstep with `robot_lab` core v0.2.8: this gem now resolves the released core gem from RubyGems instead of the local sibling checkout (local-path development remains available via `BUNDLE_GEMFILE=Gemfile.local`). Also in this release: 5 reek false positives annotated inline, reek added to the development bundle, and gem lifecycle tasks moved to asgard.
@@ -417,7 +417,7 @@ at_exit { RobotLab.shutdown_ractor_pool }
417
417
  - **No mutable class-level state.** Class variables and module globals accessed from `execute` must be frozen.
418
418
  - **`parallel_mode: :ractor` returns a plain Hash**, not a `SimpleFlow::Result`. If downstream code depends on `result.context` or `result.value`, use `:async` mode.
419
419
  - **Memory subscriptions don't transfer.** Subscriptions registered on the outer `Memory` before a Ractor dispatch are not triggered by writes made via `RactorMemoryProxy#set` inside workers during the run.
420
- - **Ruby version.** Ractors require Ruby 3.0+. `Ractor#value` / `Ractor#join` are the supported APIs from Ruby 4.0 onwards (`Ractor#take` was removed).
420
+ - **Ruby version.** This gem requires Ruby 4.0.9+. `Ractor#value` / `Ractor#join` are the supported APIs from Ruby 4.0 onwards (`Ractor#take` was removed).
421
421
 
422
422
  ---
423
423
 
@@ -45,7 +45,7 @@ end
45
45
  class WordStatsTool < TextTool
46
46
  description "Count words, sentences, and average word length"
47
47
 
48
- param :text, type: :string, desc: "Text to analyze"
48
+ parameter :text, type: :string, description: "Text to analyze"
49
49
 
50
50
  def execute(text:)
51
51
  words = text.scan(/\b\w+\b/)
@@ -60,7 +60,7 @@ end
60
60
  class ReadabilityTool < TextTool
61
61
  description "Estimate words-per-sentence and long-word density"
62
62
 
63
- param :text, type: :string, desc: "Text to analyze"
63
+ parameter :text, type: :string, description: "Text to analyze"
64
64
 
65
65
  def execute(text:)
66
66
  words = text.scan(/\b\w+\b/)
@@ -85,7 +85,7 @@ class HeavyDigestTool < TextTool
85
85
 
86
86
  ROUNDS = 500_000
87
87
 
88
- param :text, type: :string, desc: "Seed text"
88
+ parameter :text, type: :string, description: "Seed text"
89
89
 
90
90
  def execute(text:)
91
91
  digest = text
@@ -101,7 +101,7 @@ class RequestCounterTool < RobotLab::Tool
101
101
 
102
102
  @@hits = 0 # mutable class variable — Ractor workers cannot access this
103
103
 
104
- param :text, type: :string, desc: "Text to count"
104
+ parameter :text, type: :string, description: "Text to count"
105
105
 
106
106
  def execute(text:)
107
107
  @@hits += 1
@@ -138,27 +138,28 @@ section("Part 2: Network.new(parallel_mode: :ractor)")
138
138
  # routes through RactorNetworkScheduler instead of SimpleFlow::Pipeline.
139
139
  # The default mode is :async (unchanged SimpleFlow behavior).
140
140
 
141
- model = "claude-haiku-4-5-20251001"
141
+ model = "qwen/qwen3.8-27b"
142
+ provider = "lms"
142
143
 
143
144
  network = RobotLab::Network.new(name: "research_pipeline", parallel_mode: :ractor) do
144
145
  task :headline_finder, RobotLab.build(name: "headline_finder",
145
146
  system_prompt: "Find the 3 most relevant news headlines. Be concise.",
146
- model: model),
147
+ model: model, provider: provider),
147
148
  depends_on: :none
148
149
 
149
150
  task :background_brief, RobotLab.build(name: "background_brief",
150
151
  system_prompt: "Provide a 2-sentence background on the topic.",
151
- model: model),
152
+ model: model, provider: provider),
152
153
  depends_on: :none
153
154
 
154
155
  task :fact_checker, RobotLab.build(name: "fact_checker",
155
156
  system_prompt: "List 3 verifiable facts about the topic.",
156
- model: model),
157
+ model: model, provider: provider),
157
158
  depends_on: :none
158
159
 
159
160
  task :report_writer, RobotLab.build(name: "report_writer",
160
161
  system_prompt: "Synthesize the provided context into a 3-sentence report.",
161
- model: model),
162
+ model: model, provider: provider),
162
163
  depends_on: ["headline_finder", "background_brief", "fact_checker"]
163
164
  end
164
165
 
data/examples/common.rb CHANGED
@@ -7,6 +7,7 @@ $LOAD_PATH.unshift File.expand_path("../lib", __dir__)
7
7
 
8
8
  require "robot_lab"
9
9
  require "robot_lab/ractor"
10
+ require "ruby_llm/providers/lms"
10
11
 
11
12
  # Unbuffered stdout so Ractor-generated output interleaves correctly with
12
13
  # main-thread headers when viewed in a terminal or redirected to a pipe.
@@ -15,13 +16,12 @@ $stdout.sync = true
15
16
  # Fallback for when direnv has not activated examples/.envrc
16
17
  ENV["ROBOT_LAB_TEMPLATE_PATH"] ||= File.join(__dir__, "prompts")
17
18
 
19
+ # Local models via LM Studio (ruby_llm-providers-lms). qwen3.8 for the
20
+ # tool-heavy demos; no API keys needed.
18
21
  RubyLLM.configure do |c|
19
- c.logger = Logger.new(File::NULL)
20
- c.default_model = "claude-haiku-4-5-20251001"
21
- c.anthropic_api_key = ENV["ANTHROPIC_API_KEY"]
22
- c.openai_api_key = ENV["OPENAI_API_KEY"]
23
- c.openai_organization_id = ENV["OPENAI_ORGANIZATION_ID"]
24
- c.openai_project_id = ENV["OPENAI_PROJECT_ID"]
22
+ c.logger = Logger.new(File::NULL)
23
+ c.default_model = "qwen/qwen3.8-27b"
24
+ c.lms_api_base = ENV.fetch("LMS_API_BASE", "http://localhost:1234/v1")
25
25
  end
26
26
 
27
27
  RobotLab.configure do |c|
@@ -4,6 +4,6 @@ module RobotLab
4
4
  # RactorPool (not Ractor) avoids shadowing Ruby's built-in Ractor class
5
5
  # for all code within the RobotLab namespace.
6
6
  module RactorPool
7
- VERSION = '0.2.8'
7
+ VERSION = '0.6.1'
8
8
  end
9
9
  end
metadata CHANGED
@@ -1,117 +1,122 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: robot_lab-ractor
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.8
4
+ version: 0.6.1
5
5
  platform: ruby
6
6
  authors:
7
- - Dewayne VanHoozer
7
+ - Dewayne VanHoozer
8
8
  bindir: bin
9
9
  cert_chain: []
10
10
  date: 1980-01-02 00:00:00.000000000 Z
11
11
  dependencies:
12
- - !ruby/object:Gem::Dependency
13
- name: ractor_queue
14
- requirement: !ruby/object:Gem::Requirement
15
- requirements:
16
- - - ">="
17
- - !ruby/object:Gem::Version
18
- version: '0'
19
- type: :runtime
20
- prerelease: false
21
- version_requirements: !ruby/object:Gem::Requirement
22
- requirements:
23
- - - ">="
24
- - !ruby/object:Gem::Version
25
- version: '0'
26
- - !ruby/object:Gem::Dependency
27
- name: ractor-wrapper
28
- requirement: !ruby/object:Gem::Requirement
29
- requirements:
30
- - - ">="
31
- - !ruby/object:Gem::Version
32
- version: '0'
33
- type: :runtime
34
- prerelease: false
35
- version_requirements: !ruby/object:Gem::Requirement
36
- requirements:
37
- - - ">="
38
- - !ruby/object:Gem::Version
39
- version: '0'
40
- - !ruby/object:Gem::Dependency
41
- name: robot_lab
42
- requirement: !ruby/object:Gem::Requirement
43
- requirements:
44
- - - "~>"
45
- - !ruby/object:Gem::Version
46
- version: 0.2.0
47
- type: :runtime
48
- prerelease: false
49
- version_requirements: !ruby/object:Gem::Requirement
50
- requirements:
51
- - - "~>"
52
- - !ruby/object:Gem::Version
53
- version: 0.2.0
54
- description: Provides RobotLab::RactorWorkerPool — a pool of Ruby Ractor workers for
55
- executing CPU-bound, Ractor-safe tools in parallel. Includes RactorBoundary (deep-freeze
56
- utility for crossing Ractor boundaries), RactorJob/RactorJobError/RobotSpec (frozen
57
- data carriers), RactorMemoryProxy (shared Memory access from inside Ractors), and
58
- RactorNetworkScheduler (dependency-ordered pipeline across Ractors).
12
+ - !ruby/object:Gem::Dependency
13
+ name: ractor_queue
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ -
17
+ - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: "0"
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ -
25
+ - ">="
26
+ - !ruby/object:Gem::Version
27
+ version: "0"
28
+ - !ruby/object:Gem::Dependency
29
+ name: ractor-wrapper
30
+ requirement: !ruby/object:Gem::Requirement
31
+ requirements:
32
+ -
33
+ - ">="
34
+ - !ruby/object:Gem::Version
35
+ version: "0"
36
+ type: :runtime
37
+ prerelease: false
38
+ version_requirements: !ruby/object:Gem::Requirement
39
+ requirements:
40
+ -
41
+ - ">="
42
+ - !ruby/object:Gem::Version
43
+ version: "0"
44
+ - !ruby/object:Gem::Dependency
45
+ name: robot_lab
46
+ requirement: !ruby/object:Gem::Requirement
47
+ requirements:
48
+ -
49
+ - ~>
50
+ - !ruby/object:Gem::Version
51
+ version: "0.6"
52
+ type: :runtime
53
+ prerelease: false
54
+ version_requirements: !ruby/object:Gem::Requirement
55
+ requirements:
56
+ -
57
+ - ~>
58
+ - !ruby/object:Gem::Version
59
+ version: "0.6"
60
+ description: "Provides RobotLab::RactorWorkerPool — a pool of Ruby Ractor workers for executing CPU-bound, Ractor-safe tools in parallel. Includes RactorBoundary (deep-freeze utility for crossing Ractor boundaries), RactorJob/RactorJobError/RobotSpec (frozen data carriers), RactorMemoryProxy (shared Memory access from inside Ractors), and RactorNetworkScheduler (dependency-ordered pipeline across Ractors)."
59
61
  email:
60
- - dvanhoozer@gmail.com
62
+ - dvanhoozer@gmail.com
61
63
  executables: []
62
64
  extensions: []
63
65
  extra_rdoc_files: []
64
66
  files:
65
- - ".envrc"
66
- - ".github/workflows/deploy-github-pages.yml"
67
- - ".loki"
68
- - ".quality/reek_baseline.txt"
69
- - ".rubocop.yml"
70
- - CHANGELOG.md
71
- - CLAUDE.md
72
- - LICENSE.txt
73
- - README.md
74
- - Rakefile
75
- - docs/guides/ractor-parallelism.md
76
- - docs/index.md
77
- - docs/superpowers/plans/2026-04-14-ractor-integration.md
78
- - docs/superpowers/specs/2026-04-14-ractor-integration-design.md
79
- - examples/01_ractor_tools.rb
80
- - examples/02_ractor_network.rb
81
- - examples/03_ractor_hooks.rb
82
- - examples/common.rb
83
- - examples/xyzzy.rb
84
- - lib/robot_lab/ractor.rb
85
- - lib/robot_lab/ractor/version.rb
86
- - lib/robot_lab/ractor_boundary.rb
87
- - lib/robot_lab/ractor_job.rb
88
- - lib/robot_lab/ractor_memory_proxy.rb
89
- - lib/robot_lab/ractor_network_scheduler.rb
90
- - lib/robot_lab/ractor_worker_pool.rb
91
- - mkdocs.yml
92
- homepage: https://github.com/MadBomber/robot_lab-ractor
67
+ - .envrc
68
+ - .github/workflows/deploy-github-pages.yml
69
+ - .loki
70
+ - .quality/reek_baseline.txt
71
+ - .rubocop.yml
72
+ - .ruby-version
73
+ - CHANGELOG.md
74
+ - CLAUDE.md
75
+ - LICENSE.txt
76
+ - README.md
77
+ - Rakefile
78
+ - docs/guides/ractor-parallelism.md
79
+ - docs/index.md
80
+ - docs/superpowers/plans/2026-04-14-ractor-integration.md
81
+ - docs/superpowers/specs/2026-04-14-ractor-integration-design.md
82
+ - examples/01_ractor_tools.rb
83
+ - examples/02_ractor_network.rb
84
+ - examples/03_ractor_hooks.rb
85
+ - examples/common.rb
86
+ - examples/xyzzy.rb
87
+ - lib/robot_lab/ractor.rb
88
+ - lib/robot_lab/ractor/version.rb
89
+ - lib/robot_lab/ractor_boundary.rb
90
+ - lib/robot_lab/ractor_job.rb
91
+ - lib/robot_lab/ractor_memory_proxy.rb
92
+ - lib/robot_lab/ractor_network_scheduler.rb
93
+ - lib/robot_lab/ractor_worker_pool.rb
94
+ - mkdocs.yml
95
+ homepage: "https://github.com/MadBomber/robot_lab-ractor"
93
96
  licenses:
94
- - MIT
97
+ - MIT
95
98
  metadata:
96
- homepage_uri: https://github.com/MadBomber/robot_lab-ractor
97
- source_code_uri: https://github.com/MadBomber/robot_lab-ractor
98
- changelog_uri: https://github.com/MadBomber/robot_lab-ractor/blob/main/CHANGELOG.md
99
- rubygems_mfa_required: 'true'
99
+ homepage_uri: "https://github.com/MadBomber/robot_lab-ractor"
100
+ source_code_uri: "https://github.com/MadBomber/robot_lab-ractor"
101
+ changelog_uri: "https://github.com/MadBomber/robot_lab-ractor/blob/main/CHANGELOG.md"
102
+ rubygems_mfa_required: "true"
100
103
  rdoc_options: []
101
104
  require_paths:
102
- - lib
105
+ - lib
103
106
  required_ruby_version: !ruby/object:Gem::Requirement
104
107
  requirements:
105
- - - ">="
106
- - !ruby/object:Gem::Version
107
- version: 3.2.0
108
+ -
109
+ - ">="
110
+ - !ruby/object:Gem::Version
111
+ version: 4.0.9
108
112
  required_rubygems_version: !ruby/object:Gem::Requirement
109
113
  requirements:
110
- - - ">="
111
- - !ruby/object:Gem::Version
112
- version: '0'
114
+ -
115
+ - ">="
116
+ - !ruby/object:Gem::Version
117
+ version: "0"
113
118
  requirements: []
114
- rubygems_version: 4.0.20
119
+ rubygems_version: 4.1.0
115
120
  specification_version: 4
116
121
  summary: Ractor-based parallel tool execution for RobotLab agents
117
122
  test_files: []