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 +4 -4
- data/.envrc +2 -2
- data/.ruby-version +1 -0
- data/CHANGELOG.md +7 -0
- data/docs/guides/ractor-parallelism.md +1 -1
- data/examples/01_ractor_tools.rb +4 -4
- data/examples/02_ractor_network.rb +6 -5
- data/examples/common.rb +6 -6
- data/lib/robot_lab/ractor/version.rb +1 -1
- metadata +96 -91
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: bc3ef6cd79094f1b71c29392b35e37dc1a166586e073ca19b94d6c2e6f471dbe
|
|
4
|
+
data.tar.gz: c2c828e8e9f7bf82df0878a197672ba01aec61d7afa11d0cf956115e82d1e66d
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 0756a7d4a4ec763dc094b5ebeb3a9b500d6e5627231c30b08dd347f35068f6546fed209a2d96d1a0b9971cc3876684333fbd67b06a4f7aec25015a8bfd94878b
|
|
7
|
+
data.tar.gz: 31a1111b1bd58948527614fe9caf99c823ed64dea2f6d137ae87c560ca46c192ce35e06eeab61470cd8a41c0d6f7e93e65c3d37394cbe3b01b78fe1458edfdde
|
data/.envrc
CHANGED
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.**
|
|
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
|
|
data/examples/01_ractor_tools.rb
CHANGED
|
@@ -45,7 +45,7 @@ end
|
|
|
45
45
|
class WordStatsTool < TextTool
|
|
46
46
|
description "Count words, sentences, and average word length"
|
|
47
47
|
|
|
48
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
20
|
-
c.default_model
|
|
21
|
-
c.
|
|
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|
|
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.
|
|
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
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
- !ruby/object:Gem::
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
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
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
- docs/
|
|
77
|
-
- docs/
|
|
78
|
-
- docs/superpowers/
|
|
79
|
-
-
|
|
80
|
-
- examples/
|
|
81
|
-
- examples/
|
|
82
|
-
- examples/
|
|
83
|
-
- examples/
|
|
84
|
-
-
|
|
85
|
-
- lib/robot_lab/ractor
|
|
86
|
-
- lib/robot_lab/
|
|
87
|
-
- lib/robot_lab/
|
|
88
|
-
- lib/robot_lab/
|
|
89
|
-
- lib/robot_lab/
|
|
90
|
-
- lib/robot_lab/
|
|
91
|
-
-
|
|
92
|
-
|
|
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:
|
|
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
|
-
|
|
107
|
-
|
|
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
|
-
|
|
112
|
-
|
|
114
|
+
-
|
|
115
|
+
- ">="
|
|
116
|
+
- !ruby/object:Gem::Version
|
|
117
|
+
version: "0"
|
|
113
118
|
requirements: []
|
|
114
|
-
rubygems_version: 4.0
|
|
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: []
|