ruby_llm-browser 0.1.0 → 0.2.0

data/lib/ruby_llm/browser/doctor.rb

@@ -2,12 +2,13 @@
 
 module RubyLLM
   module Browser
-    # Read-only preflight diagnostics for a live browser deployment.
+    # Read-only configuration diagnostics for an offline or live backend.
     #
     # The Doctor never makes a network call, never starts a session and never prints a
-    # credential. It reports the version pins, the environment overrides that the SDK
-    # would otherwise honour, and whether the configured backend is qualified to start a
-    # session. A `:fail` check means live use must not proceed.
+    # credential. Common checks report RubyLLM compatibility and backend capabilities.
+    # Only Stagehand backends inspect Stagehand's SDK and environment. FakeBackend
+    # checks do not load the SDK or inspect provider credentials. A local pass never
+    # qualifies a provider's actual guarantees. A `:fail` check blocks use.
     #
     #   report = RubyLLM::Browser::Doctor.new(backend: backend).report
     #   raise report[:summary] unless report[:ok]
@@ -23,13 +24,15 @@ module RubyLLM
         @env = env
       end
 
-      # @return [Hash] `{ ok:, summary:, checks: [...] }`, safe to log
+      # @return [Hash] `{ mode:, ok:, summary:, checks: [...] }`, safe to log.
+      #   Mode is `:offline` for FakeBackend in fake mode, `:unconfigured` without
+      #   a backend, and `:live` otherwise. Existing report keys remain available.
       def report
-        checks = [
-          ruby_llm_check, stagehand_check, egress_check, local_binary_check,
-          custom_headers_check, base_url_check, credentials_check
-        ].compact
+        checks = [ ruby_llm_check, egress_check, local_binary_check, custom_headers_check ]
+        checks.concat([ stagehand_check, base_url_check, credentials_check ]) if backend.is_a?(StagehandBackend)
+        checks.compact!
         {
+          mode: mode,
           ok: checks.none? { |check| check[:status] == :fail },
           summary: summary_for(checks),
           checks: checks
@@ -40,6 +43,13 @@ module RubyLLM
 
       private
 
+      def mode
+        return :unconfigured unless backend
+        return :offline if backend.is_a?(FakeBackend) && backend.capabilities.server_mode == :fake
+
+        :live
+      end
+
       def ruby_llm_check
         version = Gem::Version.new(RubyLLM::VERSION)
         required = Gem::Version.new("2.0.0")
@@ -72,7 +82,12 @@ module RubyLLM
                        "Stagehand backend is unsupported until provider egress and cleanup are qualified")
         end
         if capabilities.enforced_egress?
-          check(:egress_isolation, :pass, "the backend asserts enforced, browser-side egress isolation")
+          detail = if mode == :offline
+            "FakeBackend performs no network I/O; live egress is not verified"
+          else
+            "the backend asserts enforced, browser-side egress isolation"
+          end
+          check(:egress_isolation, :pass, detail)
         else
           check(:egress_isolation, :fail,
                 "the backend does not assert enforced egress isolation; live sessions are refused")

data/lib/ruby_llm/browser/version.rb

@@ -4,6 +4,6 @@ module RubyLLM
   module Browser
     # The Gem version. Development happens ahead of any public release: the packaged
     # version is not a RubyGems publication claim.
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/ruby_llm/browser.rb

@@ -47,6 +47,17 @@ module RubyLLM
   # operation and session lifecycle, budgets and one-use action approvals.
   module Browser
     class << self
+      # Builds the read-only tool pair for a host-supplied context and schema.
+      #
+      #   chat.with_tools(*RubyLLM::Browser.tools(context: context, schema: schema))
+      #
+      # No operation is dispatched. Act is never included. Constructor validation
+      # applies here; the host policy validates schema contents when Extract runs.
+      # @return [Array<Inspect, Extract>] fresh instances sharing the supplied context
+      def tools(context:, schema:)
+        [ Inspect.new(context: context), Extract.new(context: context, schema: schema) ]
+      end
+
       # Process-wide defaults (see {Configuration}).
       def configuration
         @configuration ||= Configuration.new

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-browser
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Andy Wang
@@ -171,9 +171,11 @@ files:
 - docs/SECURITY_MODEL.md
 - docs/SPEC_BASELINE.md
 - docs/WORK.md
+- docs/_advanced/development-and-testing.md
 - docs/_advanced/live-backend-qualification.md
 - docs/_advanced/rails-integration.md
 - docs/_config.yml
+- docs/_core_features/diagnostics.md
 - docs/_core_features/inspect-extract.md
 - docs/_core_features/offline-act.md
 - docs/_core_features/operation-lifecycle.md
@@ -184,9 +186,12 @@ files:
 - docs/_getting_started/configuration.md
 - docs/_getting_started/getting-started.md
 - docs/_getting_started/overview.md
+- docs/_getting_started/whats-new-in-0-2.md
 - docs/_plugins/versioned_docs.rb
+- docs/_reference/api-and-configuration.md
 - docs/_reference/api-reference.md
 - docs/_reference/release-history.md
+- docs/_reference/roadmap.md
 - docs/_reference/upgrading.md
 - docs/bin/build-api.sh
 - docs/bin/build.sh