ruby_llm-browser 0.1.0 → 0.3.0

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.
Files changed (41) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +34 -0
  3. data/CONTRIBUTING.md +8 -1
  4. data/README.md +25 -96
  5. data/docs/API.md +5 -172
  6. data/docs/RAILS.md +5 -162
  7. data/docs/README.md +23 -12
  8. data/docs/RELEASE_ACTION_PLAN.md +28 -13
  9. data/docs/RELEASE_AUDIT.md +19 -0
  10. data/docs/RELEASING.md +24 -12
  11. data/docs/SECURITY_MODEL.md +1 -1
  12. data/docs/WORK.md +22 -0
  13. data/docs/_advanced/development-and-testing.md +107 -0
  14. data/docs/_advanced/live-backend-qualification.md +5 -0
  15. data/docs/_advanced/rails-integration.md +147 -29
  16. data/docs/_advanced/result-delivery.md +119 -0
  17. data/docs/_config.yml +8 -4
  18. data/docs/_core_features/diagnostics.md +68 -0
  19. data/docs/_core_features/inspect-extract.md +18 -2
  20. data/docs/_data/navigation.yml +2 -0
  21. data/docs/_getting_started/getting-started.md +11 -1
  22. data/docs/_getting_started/overview.md +3 -0
  23. data/docs/_getting_started/whats-new-in-0-3.md +48 -0
  24. data/docs/_plugins/versioned_docs.rb +3 -3
  25. data/docs/_reference/api-and-configuration.md +203 -0
  26. data/docs/_reference/api-reference.md +3 -2
  27. data/docs/_reference/release-history.md +3 -1
  28. data/docs/_reference/roadmap.md +171 -0
  29. data/docs/_reference/upgrading.md +48 -14
  30. data/docs/_reference/whats-new-in-0-2.md +46 -0
  31. data/docs/index.md +2 -3
  32. data/examples/plain_ruby.rb +7 -4
  33. data/examples/rails_results.rb +141 -0
  34. data/lib/ruby_llm/browser/doctor.rb +25 -10
  35. data/lib/ruby_llm/browser/rails/operation_job.rb +16 -4
  36. data/lib/ruby_llm/browser/rails/result_delivery_error.rb +22 -0
  37. data/lib/ruby_llm/browser/rails.rb +16 -0
  38. data/lib/ruby_llm/browser/result.rb +3 -3
  39. data/lib/ruby_llm/browser/version.rb +1 -1
  40. data/lib/ruby_llm/browser.rb +11 -0
  41. metadata +11 -2
@@ -27,15 +27,15 @@ module RubyLLM
27
27
  def initialize(status:, operation_id: nil, final_url: nil, captured_at: nil, locator: nil,
28
28
  digest: nil, data: nil, truncated: false, error_code: nil, error_message: nil)
29
29
  @status = normalize_status(status)
30
- @operation_id = operation_id
30
+ @operation_id = Immutable.copy(operation_id)
31
31
  @final_url = Immutable.copy(final_url)
32
32
  @captured_at = Immutable.copy(captured_at)
33
33
  @locator = Immutable.copy(locator)
34
34
  @digest = Immutable.copy(digest)
35
35
  @data = Immutable.copy(data)
36
36
  @truncated = truncated ? true : false
37
- @error_code = error_code
38
- @error_message = error_message
37
+ @error_code = Immutable.copy(error_code)
38
+ @error_message = Immutable.copy(error_message)
39
39
  freeze
40
40
  end
41
41
 
@@ -4,6 +4,6 @@ module RubyLLM
4
4
  module Browser
5
5
  # The Gem version. Development happens ahead of any public release: the packaged
6
6
  # version is not a RubyGems publication claim.
7
- VERSION = "0.1.0"
7
+ VERSION = "0.3.0"
8
8
  end
9
9
  end
@@ -47,6 +47,17 @@ module RubyLLM
47
47
  # operation and session lifecycle, budgets and one-use action approvals.
48
48
  module Browser
49
49
  class << self
50
+ # Builds the read-only tool pair for a host-supplied context and schema.
51
+ #
52
+ # chat.with_tools(*RubyLLM::Browser.tools(context: context, schema: schema))
53
+ #
54
+ # No operation is dispatched. Act is never included. Constructor validation
55
+ # applies here; the host policy validates schema contents when Extract runs.
56
+ # @return [Array<Inspect, Extract>] fresh instances sharing the supplied context
57
+ def tools(context:, schema:)
58
+ [ Inspect.new(context: context), Extract.new(context: context, schema: schema) ]
59
+ end
60
+
50
61
  # Process-wide defaults (see {Configuration}).
51
62
  def configuration
52
63
  @configuration ||= Configuration.new
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: ruby_llm-browser
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Andy Wang
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-10-18 00:00:00.000000000 Z
11
+ date: 2026-10-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: ruby_llm
@@ -171,9 +171,12 @@ files:
171
171
  - docs/SECURITY_MODEL.md
172
172
  - docs/SPEC_BASELINE.md
173
173
  - docs/WORK.md
174
+ - docs/_advanced/development-and-testing.md
174
175
  - docs/_advanced/live-backend-qualification.md
175
176
  - docs/_advanced/rails-integration.md
177
+ - docs/_advanced/result-delivery.md
176
178
  - docs/_config.yml
179
+ - docs/_core_features/diagnostics.md
177
180
  - docs/_core_features/inspect-extract.md
178
181
  - docs/_core_features/offline-act.md
179
182
  - docs/_core_features/operation-lifecycle.md
@@ -184,10 +187,14 @@ files:
184
187
  - docs/_getting_started/configuration.md
185
188
  - docs/_getting_started/getting-started.md
186
189
  - docs/_getting_started/overview.md
190
+ - docs/_getting_started/whats-new-in-0-3.md
187
191
  - docs/_plugins/versioned_docs.rb
192
+ - docs/_reference/api-and-configuration.md
188
193
  - docs/_reference/api-reference.md
189
194
  - docs/_reference/release-history.md
195
+ - docs/_reference/roadmap.md
190
196
  - docs/_reference/upgrading.md
197
+ - docs/_reference/whats-new-in-0-2.md
191
198
  - docs/bin/build-api.sh
192
199
  - docs/bin/build.sh
193
200
  - docs/bin/export-api-markdown.rb
@@ -199,6 +206,7 @@ files:
199
206
  - docs/index.md
200
207
  - examples/plain_ruby.rb
201
208
  - examples/rails_adapter.rb
209
+ - examples/rails_results.rb
202
210
  - lib/generators/ruby_llm/browser/install_generator.rb
203
211
  - lib/generators/ruby_llm/browser/templates/create_ruby_llm_browser_tables.rb.tt
204
212
  - lib/ruby_llm/browser.rb
@@ -227,6 +235,7 @@ files:
227
235
  - lib/ruby_llm/browser/rails/operation_job.rb
228
236
  - lib/ruby_llm/browser/rails/operation_record.rb
229
237
  - lib/ruby_llm/browser/rails/reaper.rb
238
+ - lib/ruby_llm/browser/rails/result_delivery_error.rb
230
239
  - lib/ruby_llm/browser/rails/schema.rb
231
240
  - lib/ruby_llm/browser/redactor.rb
232
241
  - lib/ruby_llm/browser/result.rb