crucible 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4771fcbedbfd9b7b399fe26a494fb532a7de06a43fc94542fa46aa5e6180d474
-  data.tar.gz: d52db121156f2b816656236c92a3d3d2ac49d9f055f7d9e20ed4b9dcbd9e89ef
+  metadata.gz: 5d114209ba5bb5fa541f65747389b48c4b074bf947482697e9438994a2fca193
+  data.tar.gz: 27bac72f974e0af3397d8a6da864f8672a6f8a5535c7bc5a8eb34821cd23cf2c
 SHA512:
-  metadata.gz: ffb2ba2fd2519eee9b10b9f278bf539d9236e38761ee7aae5b5625dac7b48c7bf09d202a9fd9617c7b7b1cf054d4df8a636af1041ed6b28d64ad78540004910a
-  data.tar.gz: f32e845e2211187384d3230e0c883c15218a46c4c46ccb8af5847a1739117f06f6ca33c288f812749e9a4565cb56051f399023bf5499c82219247a906f2fc9ad
+  metadata.gz: bffe986b41fb2150493f5164ed1ad64bfbd5bf573cfc546d46ad88a4008b818502b60ddbb294ab7e327b088998ae8636452ec6b67b44b1e792dec7364da59340
+  data.tar.gz: 84e6552d826c7abe0b72300764cd7cdd1c1ada144b0148f26117ca225f16117fd9b0cff9032b42c9cba12c56dbffd97fe9eb804efef1ab04912fcd452231926b

data/README.md

@@ -4,6 +4,12 @@ A Ruby MCP (Model Context Protocol) server for browser automation using [Ferrum]
 
 ## Installation
 
+```bash
+gem install crucible
+```
+
+Or from source:
+
 ```bash
 git clone https://github.com/joshfng/crucible.git
 cd crucible
@@ -50,18 +56,18 @@ bundle install
 
 ### Claude Code Integration
 
+```bash
+gem install crucible
+```
+
 Add to your Claude Code MCP settings (`~/.claude/settings.json`):
 
 ```json
 {
   "mcpServers": {
     "crucible": {
-      "command": "ruby",
-      "args": [
-        "-I",
-        "/path/to/crucible/lib",
-        "/path/to/crucible/exe/crucible"
-      ]
+      "command": "crucible",
+      "args": ["--config", "~/.config/crucible/config.yml"]
     }
   }
 }
@@ -134,11 +140,11 @@ Add to your Claude Code MCP settings (`~/.claude/settings.json`):
 | `get_stealth_status`  | Get stealth mode status for a session                 |
 | `set_stealth_profile` | Change the stealth profile (minimal/moderate/maximum) |
 
-## Sessions
+## Session Management
 
 All tools accept an optional `session` parameter to manage multiple independent browser instances:
 
-```
+```ruby
 # These run in separate browsers
 navigate(session: "login-flow", url: "https://example.com/login")
 navigate(session: "signup-flow", url: "https://example.com/signup")
@@ -160,7 +166,7 @@ Sessions are created automatically on first use and persist until explicitly clo
 
 ### Basic Navigation
 
-```
+```ruby
 navigate(url: "https://example.com")
 wait_for(selector: ".content")
 get_content(format: "text")
@@ -168,7 +174,7 @@ get_content(format: "text")
 
 ### Form Submission
 
-```
+```ruby
 navigate(url: "https://example.com/login")
 type(selector: "#email", text: "user@example.com")
 type(selector: "#password", text: "secret123")
@@ -178,7 +184,7 @@ wait_for(selector: ".dashboard")
 
 ### Screenshots & PDFs
 
-```
+```ruby
 # Viewport screenshot (returns base64)
 screenshot()
 
@@ -200,7 +206,7 @@ pdf(format: "Letter", landscape: true)   # Custom format
 
 ### JavaScript Execution
 
-```
+```ruby
 # Get page dimensions
 evaluate(expression: "[window.innerWidth, window.innerHeight]")
 
@@ -213,7 +219,7 @@ evaluate(expression: "document.querySelectorAll('a').length")
 
 ### File Downloads
 
-```
+```ruby
 # Set download directory
 set_download_path(path: "/tmp/downloads")
 
@@ -262,7 +268,7 @@ The stealth module includes evasions ported from [puppeteer-extra](https://githu
 
 ### Runtime Control
 
-```
+```ruby
 # Check stealth status
 get_stealth_status(session: "default")
 
@@ -296,7 +302,7 @@ server:
 
 ## Project Structure
 
-```
+```text
 crucible/
 ├── exe/crucible                # CLI executable
 ├── crucible.gemspec            # Gem specification

data/lib/crucible/tools/stealth.rb

@@ -4,162 +4,162 @@ module Crucible
   module Tools
     # MCP tools for stealth mode management
     module Stealth
-      extend Helpers
-
       VALID_PROFILES = %w[minimal moderate maximum].freeze
 
-      module_function
-
-      # Returns all stealth tools
-      # @param sessions [SessionManager]
-      # @param config [Configuration]
-      # @return [Array<MCP::Tool>]
-      def tools(sessions, config)
-        [
-          enable_stealth_tool(sessions, config),
-          disable_stealth_tool(sessions),
-          get_stealth_status_tool(sessions),
-          set_stealth_profile_tool(sessions, config)
-        ]
-      end
+      class << self
+        # Returns all stealth tools
+        # @param sessions [SessionManager]
+        # @param config [Configuration]
+        # @return [Array<MCP::Tool>]
+        def tools(sessions, config)
+          [
+            enable_stealth_tool(sessions, config),
+            disable_stealth_tool(sessions),
+            get_stealth_status_tool(sessions),
+            set_stealth_profile_tool(sessions, config)
+          ]
+        end
 
-      # Tool: Enable stealth mode for a session
-      def enable_stealth_tool(sessions, _config)
-        MCP::Tool.new(
-          name: 'enable_stealth',
-          description: 'Enable stealth mode for a browser session. Stealth mode applies various ' \
-                       'evasion techniques to make the browser appear as a regular user browser ' \
-                       'to bot detection systems.',
-          input_schema: {
-            type: 'object',
-            properties: {
-              session: {
-                type: 'string',
-                description: 'Session name',
-                default: 'default'
+        private
+
+        # Tool: Enable stealth mode for a session
+        def enable_stealth_tool(sessions, _config)
+          MCP::Tool.define(
+            name: 'enable_stealth',
+            description: 'Enable stealth mode for a browser session. Stealth mode applies various ' \
+                         'evasion techniques to make the browser appear as a regular user browser ' \
+                         'to bot detection systems.',
+            input_schema: {
+              type: 'object',
+              properties: {
+                session: {
+                  type: 'string',
+                  description: 'Session name',
+                  default: 'default'
+                },
+                profile: {
+                  type: 'string',
+                  enum: VALID_PROFILES,
+                  description: 'Stealth profile: minimal (basic evasions), moderate (common evasions), ' \
+                               'or maximum (all evasions for strictest detection)'
+                }
               },
-              profile: {
-                type: 'string',
-                enum: VALID_PROFILES,
-                description: 'Stealth profile: minimal (basic evasions), moderate (common evasions), ' \
-                             'or maximum (all evasions for strictest detection)'
-              }
-            },
-            required: []
-          }
-        ) do |args|
-          session = args['session'] || 'default'
-          profile = args['profile']&.to_sym
-
-          sessions.enable_stealth(session, profile: profile)
-
-          info = sessions.stealth_info(session)
-          build_result("Stealth mode enabled for session '#{session}' with profile: #{info[:profile]}")
-        rescue Crucible::SessionNotFoundError => e
-          build_error(e.message)
-        rescue Crucible::Error => e
-          build_error(e.message)
+              required: []
+            }
+          ) do |session: 'default', profile: nil, **|
+            profile_sym = profile&.to_sym
+
+            sessions.enable_stealth(session, profile: profile_sym)
+
+            info = sessions.stealth_info(session)
+            MCP::Tool::Response.new([{
+              type: 'text',
+              text: "Stealth mode enabled for session '#{session}' with profile: #{info[:profile]}"
+            }])
+          rescue Crucible::SessionNotFoundError, Crucible::Error => e
+            MCP::Tool::Response.new([{ type: 'text', text: e.message }], is_error: true)
+          end
         end
-      end
-
-      # Tool: Disable stealth mode for a session
-      def disable_stealth_tool(sessions)
-        MCP::Tool.new(
-          name: 'disable_stealth',
-          description: 'Disable stealth mode for a browser session. Note: Already-applied evasions ' \
-                       'cannot be removed, but this prevents new evasions from being applied.',
-          input_schema: {
-            type: 'object',
-            properties: {
-              session: {
-                type: 'string',
-                description: 'Session name',
-                default: 'default'
-              }
-            },
-            required: []
-          }
-        ) do |args|
-          session = args['session'] || 'default'
 
-          sessions.disable_stealth(session)
-
-          build_result("Stealth mode disabled for session '#{session}'")
-        rescue Crucible::SessionNotFoundError => e
-          build_error(e.message)
+        # Tool: Disable stealth mode for a session
+        def disable_stealth_tool(sessions)
+          MCP::Tool.define(
+            name: 'disable_stealth',
+            description: 'Disable stealth mode for a browser session. Note: Already-applied evasions ' \
+                         'cannot be removed, but this prevents new evasions from being applied.',
+            input_schema: {
+              type: 'object',
+              properties: {
+                session: {
+                  type: 'string',
+                  description: 'Session name',
+                  default: 'default'
+                }
+              },
+              required: []
+            }
+          ) do |session: 'default', **|
+            sessions.disable_stealth(session)
+
+            MCP::Tool::Response.new([{
+              type: 'text',
+              text: "Stealth mode disabled for session '#{session}'"
+            }])
+          rescue Crucible::SessionNotFoundError => e
+            MCP::Tool::Response.new([{ type: 'text', text: e.message }], is_error: true)
+          end
         end
-      end
-
-      # Tool: Get stealth status for a session
-      def get_stealth_status_tool(sessions)
-        MCP::Tool.new(
-          name: 'get_stealth_status',
-          description: 'Get the current stealth mode status for a browser session.',
-          input_schema: {
-            type: 'object',
-            properties: {
-              session: {
-                type: 'string',
-                description: 'Session name',
-                default: 'default'
-              }
-            },
-            required: []
-          }
-        ) do |args|
-          session = args['session'] || 'default'
 
-          info = sessions.stealth_info(session)
-
-          status = {
-            session: session,
-            stealth_enabled: info[:enabled],
-            profile: info[:profile]
-          }
-
-          build_result(JSON.pretty_generate(status))
-        rescue Crucible::SessionNotFoundError => e
-          build_error(e.message)
+        # Tool: Get stealth status for a session
+        def get_stealth_status_tool(sessions)
+          MCP::Tool.define(
+            name: 'get_stealth_status',
+            description: 'Get the current stealth mode status for a browser session.',
+            input_schema: {
+              type: 'object',
+              properties: {
+                session: {
+                  type: 'string',
+                  description: 'Session name',
+                  default: 'default'
+                }
+              },
+              required: []
+            }
+          ) do |session: 'default', **|
+            info = sessions.stealth_info(session)
+
+            status = {
+              session: session,
+              stealth_enabled: info[:enabled],
+              profile: info[:profile]
+            }
+
+            MCP::Tool::Response.new([{
+              type: 'text',
+              text: JSON.pretty_generate(status)
+            }])
+          rescue Crucible::SessionNotFoundError => e
+            MCP::Tool::Response.new([{ type: 'text', text: e.message }], is_error: true)
+          end
         end
-      end
 
-      # Tool: Set stealth profile (change profile for existing session)
-      def set_stealth_profile_tool(sessions, _config)
-        MCP::Tool.new(
-          name: 'set_stealth_profile',
-          description: 'Change the stealth profile for a session. This enables stealth mode with ' \
-                       'the new profile if not already enabled.',
-          input_schema: {
-            type: 'object',
-            properties: {
-              session: {
-                type: 'string',
-                description: 'Session name',
-                default: 'default'
+        # Tool: Set stealth profile (change profile for existing session)
+        def set_stealth_profile_tool(sessions, _config)
+          MCP::Tool.define(
+            name: 'set_stealth_profile',
+            description: 'Change the stealth profile for a session. This enables stealth mode with ' \
+                         'the new profile if not already enabled.',
+            input_schema: {
+              type: 'object',
+              properties: {
+                session: {
+                  type: 'string',
+                  description: 'Session name',
+                  default: 'default'
+                },
+                profile: {
+                  type: 'string',
+                  enum: VALID_PROFILES,
+                  description: 'Stealth profile: minimal, moderate, or maximum'
+                }
               },
-              profile: {
-                type: 'string',
-                enum: VALID_PROFILES,
-                description: 'Stealth profile: minimal, moderate, or maximum'
-              }
-            },
-            required: ['profile']
-          }
-        ) do |args|
-          session = args['session'] || 'default'
-          profile = args['profile']&.to_sym
-
-          unless VALID_PROFILES.include?(args['profile'])
-            raise Crucible::Error, "Invalid profile: #{args['profile']}. Must be one of: #{VALID_PROFILES.join(', ')}"
+              required: ['profile']
+            }
+          ) do |profile:, session: 'default', **|
+            unless VALID_PROFILES.include?(profile)
+              raise Crucible::Error, "Invalid profile: #{profile}. Must be one of: #{VALID_PROFILES.join(', ')}"
+            end
+
+            sessions.enable_stealth(session, profile: profile.to_sym)
+
+            MCP::Tool::Response.new([{
+              type: 'text',
+              text: "Stealth profile set to '#{profile}' for session '#{session}'"
+            }])
+          rescue Crucible::SessionNotFoundError, Crucible::Error => e
+            MCP::Tool::Response.new([{ type: 'text', text: e.message }], is_error: true)
           end
-
-          sessions.enable_stealth(session, profile: profile)
-
-          build_result("Stealth profile set to '#{profile}' for session '#{session}'")
-        rescue Crucible::SessionNotFoundError => e
-          build_error(e.message)
-        rescue Crucible::Error => e
-          build_error(e.message)
         end
       end
     end

data/lib/crucible/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Crucible
-  VERSION = '0.1.4'
+  VERSION = '0.1.5'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: crucible
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Josh Frye
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ferrum
@@ -182,7 +181,6 @@ metadata:
   source_code_uri: https://github.com/joshfng/crucible
   changelog_uri: https://github.com/joshfng/crucible/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -197,8 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: MCP server for browser automation using Ferrum/Chrome
 test_files: []