tidewave 0.8.2 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e88f6c0da8ac82856c1663c96b1c6eabea60f9c4784464743b162fd6bdd27203
-  data.tar.gz: 758b4b72b27d505a6e9645ecb10dd8db993c3c72336529eeaf2bccd6816b3c50
+  metadata.gz: 4ab18eddab48d627b651d3a52e46a351506e57401015706b088910f11c91e54f
+  data.tar.gz: 0740650fc83bb249def8d108beeb3434dfb3313e3a740755ac305be2663202ac
 SHA512:
-  metadata.gz: 630ee8e8a59f4fe6f83aae684f1dfbe496f90200879453aeed9aaa1aae714ee92b4a5e7cd29f7feb1565387d5823641c0cfec17362797bad1b1a19e2393f2fcf
-  data.tar.gz: 25925a77d58572342a333ef86b82a87b8f1b43aba22208c4832b077a0fccaf2aa758cf4a53c69d1a1f99159562a3caeec4bb16fe242ad2dd3988281b25c83df6
+  metadata.gz: 9d7a8ecabbc3139ce103a77d44f8e317044c2b78128914ee52c9bca5b4e60ee157f5506920117fd8df257daa9b2df29901882de6cdd77eb95e3fd1d8a0d72e64
+  data.tar.gz: eb30a267b41ffd08940674265c51757511ae8a7598eed87c8f19e9a75e70753c1357d5da7a1ee3cd3d104965bb95c86d5626b7cd8e15c8ed5b21a8155620b813

data/README.md

@@ -74,22 +74,6 @@ Looks up the documentation for a class, method, or constant, reading from the ex
 
 Your agent can use it when it's unsure how a class or method works, so the code it generates is grounded in the docs for the exact versions of the gems your app uses, rather than training data that may be stale or a generic docs lookup that can't guarantee it matches the version your app depends on.
 
-### `get_logs`
-
-Returns output from your running server's log.
-
-[![get_logs demo](docs/assets/get_logs-poster.png)](https://asciinema.org/a/1260413)
-
-Your agent can use it to see what happened after a request. For example, reading the request log and backtrace when something misbehaves, or checking the log after an action to confirm the request came in with the expected params.
-
-### `get_models`
-
-Lists all of your app's models and where each one is defined, by file and line.
-
-[![get_models demo](docs/assets/get_models-poster.png)](https://asciinema.org/a/qeELC7wEgMEI5T7n)
-
-Your agent can use it to map the data domain and find where each model lives before opening files, rather than grepping around for class definitions.
-
 ### `get_source_location`
 
 Returns the file and line where a class, module, or method is defined, across both your app and its dependencies.

data/lib/tidewave/database_adapter.rb

@@ -20,9 +20,5 @@ class Tidewave
     def execute_query(query, arguments = [])
       raise NotImplementedError, "Subclasses must implement execute_query"
     end
-
-    def get_models
-      raise NotImplementedError, "Subclasses must implement get_models"
-    end
   end
 end

data/lib/tidewave/database_adapters/active_record.rb

@@ -24,10 +24,6 @@ class Tidewave
           database: conn.pool.db_config.database
         }
       end
-
-      def get_models
-        ::ActiveRecord::Base.descendants
-      end
     end
   end
 end

data/lib/tidewave/database_adapters/sequel.rb

@@ -28,23 +28,6 @@ class Tidewave
           database: db.opts[:database]
         }
       end
-
-      def get_models
-        # Filter out anonymous Sequel models that can't be resolved as constants
-        descendants_of(::Sequel::Model).reject { |model| model.name&.start_with?("Sequel::_Model(") }
-      end
-
-      private
-
-      def descendants_of(base)
-        if base.respond_to?(:descendants)
-          base.descendants
-        elsif base.respond_to?(:subclasses)
-          base.subclasses.flat_map { |subclass| [ subclass ] + descendants_of(subclass) }
-        else
-          []
-        end
-      end
     end
   end
 end

data/lib/tidewave/railtie.rb

@@ -68,6 +68,10 @@ class Tidewave
             script_src_elem << client_origin unless script_src_elem.include?(client_origin)
           end
 
+          directives["connect-src"].try do |connect_src|
+            connect_src << client_origin unless connect_src.include?(client_origin)
+          end
+
           directives.delete("frame-ancestors")
         end
       end

data/lib/tidewave/tool.rb

@@ -24,6 +24,10 @@ class Tidewave
       raise NotImplementedError, "#{self.class} must implement #call"
     end
 
+    def include_in_tool_list?
+      true
+    end
+
     def validate_and_call(arguments, context = {})
       arguments ||= {}
 

data/lib/tidewave/tools/create_design_canvas.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "net/http"
+require "pathname"
+require "uri"
+
+class Tidewave::Tools::CreateDesignCanvas < Tidewave::Tool
+  class Error < StandardError; end
+
+  DESCRIPTION = <<~DESCRIPTION.freeze
+    Creates a new design canvas, an HTML file for presenting design explorations.
+
+    The tool returns the absolute path of the HTML file. The file includes usage
+    instructions, read it, then edit it to author the actual design.
+  DESCRIPTION
+
+  FETCH_TIMEOUT_SECONDS = 15
+
+  def initialize(options = {})
+    super
+    @client_url = options[:client_url]
+  end
+
+  def browser_tool?
+    true
+  end
+
+  def definition
+    {
+      "name" => "create_design_canvas",
+      "description" => DESCRIPTION,
+      "inputSchema" => {
+        "type" => "object",
+        "properties" => {
+          "path" => {
+            "type" => "string",
+            "description" =>
+              "The absolute path for the canvas file, with .html file extension. The file must not exist yet."
+          }
+        },
+        "required" => [ "path" ]
+      }
+    }
+  end
+
+  def call(arguments)
+    path = arguments.fetch("path")
+
+    unless Pathname.new(path).absolute? && path.end_with?(".html")
+      return error_result("Invalid path #{path.inspect}. It must be an absolute path with the .html file extension.")
+    end
+
+    html = fetch_canvas_html
+    write_canvas(path, html)
+
+    "Design canvas created at: <path>#{path}</path>. Read the file for usage instructions."
+  rescue Error => error
+    error_result(error.message)
+  end
+
+  private
+
+  def write_canvas(path, html)
+    begin
+      FileUtils.mkdir_p(File.dirname(path))
+    rescue SystemCallError => error
+      raise Error, "Failed to create the design canvas directory: #{error.message}"
+    end
+
+    File.write(path, html, mode: "wx")
+  rescue Errno::EEXIST
+    raise Error, "Failed to create the design canvas file, the file already exists."
+  rescue SystemCallError => error
+    raise Error, "Failed to create the design canvas file: #{error.message}"
+  end
+
+  def fetch_canvas_html
+    url = @client_url.to_s.sub(%r{/\z}, "") + "/tc/data/canvas.json"
+    uri = URI.parse(url)
+
+    response =
+      Net::HTTP.start(
+        uri.host,
+        uri.port,
+        use_ssl: uri.scheme == "https",
+        open_timeout: FETCH_TIMEOUT_SECONDS,
+        read_timeout: FETCH_TIMEOUT_SECONDS
+      ) { |http| http.request(Net::HTTP::Get.new(uri)) }
+
+    unless response.is_a?(Net::HTTPOK)
+      raise Error, "Failed to fetch the design canvas template, request to #{url} failed with status #{response.code}"
+    end
+
+    parse_canvas_html(response.body, url)
+  rescue SystemCallError, SocketError, IOError, Timeout::Error, OpenSSL::SSL::SSLError => error
+    raise Error, "Failed to fetch the design canvas template, request to #{url} failed: #{error.message}"
+  end
+
+  def parse_canvas_html(body, url)
+    payload =
+      begin
+        JSON.parse(body)
+      rescue JSON::ParserError
+        nil
+      end
+
+    html = payload["html"] if payload.is_a?(Hash)
+
+    unless html.is_a?(String)
+      raise Error, "Failed to fetch the design canvas template, unexpected response from #{url}"
+    end
+
+    html
+  end
+
+  def error_result(text)
+    {
+      "content" => [ { "type" => "text", "text" => text } ],
+      "isError" => true
+    }
+  end
+end

data/lib/tidewave/tools/get_logs.rb

@@ -58,6 +58,10 @@ class Tidewave::Tools::GetLogs < Tidewave::Tool
     matching_lines.join
   end
 
+  def include_in_tool_list?
+    false
+  end
+
   private
 
   def tail_lines(file_path)

data/lib/tidewave/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Tidewave
-  VERSION = "0.8.2"
+  VERSION = "0.9.1"
 end

data/lib/tidewave.rb

@@ -76,6 +76,15 @@ class Tidewave
   UPLOAD_ROUTE = "upload".freeze
   WS_ROUTE = "ws".freeze
   PROTOCOL_VERSION = "2025-03-26".freeze
+  INSTRUCTIONS = <<~TEXT
+    Tidewave connects you to this Rails application while it is running in development: the same process, database and logs the developer is using. Anything you would run through `rails runner` or `ruby -e` can run inside the already-booted app instead, with no startup cost per call. Questions about the app's actual state (data, loaded code, etc) are answered from the live process rather than inferred from files.
+
+    What is available and when each is relevant:
+    - project_eval: run Ruby inside the running app: models, queries, any expression or snippet. Relevant whenever you would otherwise write a script or start `rails runner` or a console.
+    - execute_sql_query: query the development database directly. Relevant when the answer is in the database (counts, rows, what a record looks like).
+    - get_source_location: where a class, module or method is defined, across the app and every gem, including Rails itself. Uses runtime information, so it works even across meta-programming. Use when you know the exact name and would otherwise grep
+    - get_docs: documentation for a class, module or method, app or dependency, for the exact versions this app has installed.
+  TEXT
   MAX_UPLOAD_SIZE = 10_000_000
   ALLOWED_UPLOAD_CONTENT_TYPES = [ "image/png", "image/jpeg", "video/webm" ].freeze
   ALLOWED_UPLOAD_TYPES = [ "screenshot", "recording" ].freeze
@@ -361,6 +370,7 @@ class Tidewave
       "tidewave" => config_data(request),
       "root" => @root.to_s,
       "wsl_distro" => ENV["WSL_DISTRO_NAME"],
+      "host_path" => ENV["TIDEWAVE_HOST_PATH"],
       "framework" => {}
     }
 
@@ -572,7 +582,8 @@ class Tidewave
         "name" => "tidewave",
         "version" => VERSION
       },
-      "tools" => tool_definitions(context)
+      "tools" => tool_definitions(context),
+      "instructions" => INSTRUCTIONS
     })
   end
 
@@ -616,7 +627,7 @@ class Tidewave
   end
 
   def tool_definitions(context)
-    context[:tools].values.map(&:definition)
+    context[:tools].values.select(&:include_in_tool_list?).map(&:definition)
   end
 
   def tool_error_result(message)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tidewave
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.1
 platform: ruby
 authors:
 - Yorick Jacquin
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-05 00:00:00.000000000 Z
+date: 2026-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -47,10 +47,10 @@ files:
 - lib/tidewave/railtie.rb
 - lib/tidewave/tool.rb
 - lib/tidewave/tools/browser_eval.rb
+- lib/tidewave/tools/create_design_canvas.rb
 - lib/tidewave/tools/execute_sql_query.rb
 - lib/tidewave/tools/get_docs.rb
 - lib/tidewave/tools/get_logs.rb
-- lib/tidewave/tools/get_models.rb
 - lib/tidewave/tools/get_source_location.rb
 - lib/tidewave/tools/project_eval.rb
 - lib/tidewave/version.rb

data/lib/tidewave/tools/get_models.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-
-class Tidewave::Tools::GetModels < Tidewave::Tool
-  DESCRIPTION = <<~DESCRIPTION.freeze
-    Returns a list of all database-backed models in the application.
-  DESCRIPTION
-
-  def initialize(options = {})
-    @root = options[:root] ? Pathname.new(options[:root].to_s) : Pathname.pwd
-    @database_adapter = Tidewave::DatabaseAdapter.for(options[:orm_adapter]) if options[:orm_adapter]
-    @before_reload = options[:before_reload]
-  end
-
-  def definition
-    return nil unless @database_adapter
-
-    {
-      "name" => "get_models",
-      "description" => DESCRIPTION,
-      "inputSchema" => {
-        "type" => "object",
-        "properties" => {}
-      }
-    }
-  end
-
-  def call(_arguments)
-    @before_reload&.call
-
-    models = @database_adapter.get_models
-
-    models.map do |model|
-      display_name = model.name || model.to_s
-
-      if location = get_relative_source_location(model.name)
-        "* #{display_name} at #{location}"
-      else
-        "* #{display_name}"
-      end
-    end.join("\n")
-  end
-
-  private
-
-  def get_relative_source_location(model_name)
-    return nil if model_name.nil? || model_name.empty?
-
-    source_location = Object.const_source_location(model_name)
-    return nil unless source_location
-
-    file_path, line_number = source_location
-    relative_path = Pathname.new(file_path).relative_path_from(@root)
-    "#{relative_path}:#{line_number}"
-  rescue ArgumentError
-    "#{file_path}:#{line_number}"
-  end
-end