tidewave 0.4.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 728311a2ea0525028ccf9209d06bc1079f9258e35d534409f4ac867ff5212d32
-  data.tar.gz: 11c1b092dc830897e59cb39f71de745b840acfd6f8845bf058c9010a06258e75
+  metadata.gz: 2ecc3b3a79123c50c7ec933b8cea5e2e4f61aff33671db1237c69a7536b31071
+  data.tar.gz: 14781db2f527923f2c5a52c4830c055659abd2e06d49526dd4630df0cd63d22a
 SHA512:
-  metadata.gz: f9b49181b3f571b668de00287f0fec47088256ee335e31036385cedcb3b8c34274529d70a4f21d9c114279d9a1f5e52a56cab75b8465546863e0fd539fd1b390
-  data.tar.gz: 1201a00a28892246592c158bc0e90cb5a6ce5d69a6a3533ef81bb8c853d2124d3544d029e8346613fa4d099010869f83cae49bcad82d890d1e935ee9f54903f4
+  metadata.gz: 39710ecba05ce8a3bf8686695c4602282fd6ee27356f4cc532cb78ea57a16403d2eb60059163b21ed5b3a3cc9225ae51a32a18df7eeee5b6e70197aae246ab26
+  data.tar.gz: e87dccaff2712bb7df136913ab409d9cc818f81444fb3892025541a274ba4ba4f17986bc425ba10c99e414668a7531a5773a8f5043c27b58b1af2d0c53a03538

data/README.md

@@ -1,42 +1,47 @@
 # Tidewave
 
-Tidewave is the coding agent for full-stack web app development, deeply integrated with Rails, from the database to the UI. [See our website](https://tidewave.ai) for more information.
+Tidewave is the coding agent for full-stack web app development. Integrate Claude Code, OpenAI Codex, and other agents with your web app and web framework at every layer, from UI to database. [See our website](https://tidewave.ai) for more information.
 
-This project can also be used as a standalone Model Context Protocol server for your editors.
+This project can also be used as [a standalone Model Context Protocol server](https://hexdocs.pm/tidewave/mcp.html).
 
 ## Installation
 
-You can install Tidewave by adding the `tidewave` gem to the development group in your Gemfile:
+You can install Tidewave by running:
+
+```shell
+bundle add tidewave --group development
+```
+
+or by manully adding the `tidewave` gem to the development group in your Gemfile:
 
 ```ruby
 gem "tidewave", group: :development
 ```
 
-Now access `/tidewave` route of your web application to enjoy Tidewave Web!
+Now make sure [Tidewave is installed](https://hexdocs.pm/tidewave/installation.html) and you are ready to connect Tidewave to your app.
 
 ## Troubleshooting
 
-### Localhost requirement
+### Using multiple hosts/subdomains
 
-Tidewave expects your web application to be running on `localhost`. If you are not running on localhost, you may need to set some additional configuration. In particular, you must configure Tidewave to allow `allow_remote_access` and [optionally configure your Rails hosts](https://guides.rubyonrails.org/configuring.html#actiondispatch-hostauthorization). For example, in your `config/environments/development.rb`:
+If you are using multiple hosts/subdomains during development, you must use `*.localhost`, as such domains are considered secure by browsers. Additionally, add the following to `config/initializers/development.rb`:
 
 ```ruby
-config.hosts << "company.local"
-config.tidewave.allow_remote_access = true
+config.session_store :cookie_store,
+  key: "__your_app_session",
+  same_site: :none,
+  secure: true,
+  assume_ssl: true
 ```
 
-If you want to use Docker for development, you either need to enable the configuration above or automatically redirect the relevant ports, as done by [devcontainers](https://code.visualstudio.com/docs/devcontainers/containers). See our [containers](https://hexdocs.pm/tidewave/containers.html) guide for more information.
+And make sure you are using `rack-session` version `2.1.0` or later.
+
+The above will allow your application to run embedded within Tidewave across multiple subdomains, as long as it is using a secure context (such as `admin.localhost`, `www.foobar.localhost`, etc).
 
 ### Content security policy
 
 If you have enabled Content-Security-Policy, Tidewave will automatically enable "unsafe-eval" under `script-src` in order for contextual browser testing to work correctly. It also disables the `frame-ancestors` directive.
 
-### Web server requirements
-
-At the moment, Tidewave requires all requests to be processed by the same process. In case Tidewave cannot connect to your application, consider starting your Rails application as follows:
-
-    RAILS_MAX_THREADS=1 WEB_CONCURRENCY=1 rails server
-
 ### Production Environment
 
 Tidewave is a powerful tool that can help you develop your web application faster and more efficiently. However, it is important to note that Tidewave is not meant to be used in a production environment.
@@ -48,12 +53,12 @@ Tidewave will raise an error if it is used in any environment where code reloadi
 You may configure `tidewave` using the following syntax:
 
 ```ruby
-  config.tidewave.allow_remote_access = true
+  config.tidewave.team = { id: "my-company" }
 ```
 
 The following config is available:
 
-  * `allow_remote_access` - Tidewave only allows requests from localhost by default, even if your server listens on other interfaces as well. If you trust your network and need to access Tidewave from a different machine, this configuration can be set to `true`
+  * `allow_remote_access` - Tidewave only allows requests from localhost by default, even if your server listens on other interfaces. If you trust your network and need to access Tidewave from a different machine, this configuration can be set to `true`
 
   * `logger_middleware` - The logger middleware Tidewave should wrap to silence its own logs
 
@@ -61,6 +66,26 @@ The following config is available:
 
   * `team` - set your Tidewave Team configuration, such as `config.tidewave.team = { id: "my-company" }`
 
+## Available tools
+
+- `execute_sql_query` - executes a SQL query within your application
+  database, useful for the agent to verify the result of an action
+
+- `get_docs` - get the documentation for a given module/class/method.
+  It consults the exact versions used by the project, ensuring you always
+  get correct information
+
+- `get_logs` - reads logs written by the server
+
+- `get_models` - lists all modules in the application and their location
+  for quick discovery
+
+- `get_source_location` - get the source location for a given module/class/method,
+  so an agent can directly read the source skipping search
+
+- `project_eval` - evaluates code within the Rails application itself, giving the agent
+  access to your runtime, dependencies, and in-memory data
+
 ## Acknowledgements
 
 A thank you to Yorick Jacquin, for creating [FastMCP](https://github.com/yjacquin/fast_mcp) and implementing the initial version of this project.

data/lib/tidewave/middleware.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "open3"
 require "ipaddr"
 require "fast_mcp"
 require "rack/request"
@@ -13,7 +12,6 @@ require_relative "streamable_http_transport"
 class Tidewave::Middleware
   TIDEWAVE_ROUTE = "tidewave".freeze
   MCP_ROUTE = "mcp".freeze
-  SHELL_ROUTE = "shell".freeze
   CONFIG_ROUTE = "config".freeze
 
   INVALID_IP = <<~TEXT.freeze
@@ -64,8 +62,6 @@ class Tidewave::Middleware
         return home(request)
       when [ "GET", [ TIDEWAVE_ROUTE, CONFIG_ROUTE ] ]
         return config_endpoint(request)
-      when [ "POST", [ TIDEWAVE_ROUTE, SHELL_ROUTE ] ]
-        return shell(request)
       end
     end
 
@@ -88,7 +84,6 @@ class Tidewave::Middleware
         <head>
           <meta charset="UTF-8" />
           <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-          <meta name="tidewave:config" content="#{ERB::Util.html_escape(JSON.generate(config))}" />
           <script type="module" src="#{@client_url}/tc/tc.js"></script>
         </head>
         <body></body>
@@ -116,66 +111,6 @@ class Tidewave::Middleware
     [ 403, { "Content-Type" => "text/plain" }, [ message ] ]
   end
 
-  def shell(request)
-    body = request.body.read
-    return [ 400, { "Content-Type" => "text/plain" }, [ "Command body is required" ] ] if body.blank?
-
-    begin
-      parsed_body = JSON.parse(body)
-      cmd = parsed_body["command"]
-      return [ 400, { "Content-Type" => "text/plain" }, [ "Command field is required" ] ] if cmd.blank?
-    rescue JSON::ParserError
-      return [ 400, { "Content-Type" => "text/plain" }, [ "Invalid JSON in request body" ] ]
-    end
-
-    response = Rack::Response.new
-    response.status = 200
-    response.headers["Content-Type"] = "text/plain"
-
-    response.finish do |res|
-      begin
-        Open3.popen3(*cmd) do |stdin, stdout, stderr, wait_thr|
-          stdin.close
-
-          # Merge stdout and stderr streams
-          ios = [ stdout, stderr ]
-
-          until ios.empty?
-            ready = IO.select(ios, nil, nil, 0.1)
-            next unless ready
-
-            ready[0].each do |io|
-              begin
-                data = io.read_nonblock(4096)
-                if data
-                  # Write binary chunk: type (0 for data) + 4-byte length + data
-                  chunk = [ 0, data.bytesize ].pack("CN") + data
-                  res.write(chunk)
-                end
-              rescue IO::WaitReadable
-                # No data available right now
-              rescue EOFError
-                # Stream ended
-                ios.delete(io)
-              end
-            end
-          end
-
-          # Wait for process to complete and get exit status
-          exit_status = wait_thr.value.exitstatus
-          status_json = JSON.generate({ status: exit_status })
-          # Write binary chunk: type (1 for status) + 4-byte length + JSON data
-          chunk = [ 1, status_json.bytesize ].pack("CN") + status_json
-          res.write(chunk)
-        end
-      rescue => e
-        error_json = JSON.generate({ status: 213 })
-        chunk = [ 1, error_json.bytesize ].pack("CN") + error_json
-        res.write(chunk)
-      end
-    end
-  end
-
   def valid_client_ip?(request)
     return true if @allow_remote_access
 

data/lib/tidewave/railtie.rb

@@ -10,6 +10,27 @@ require "tidewave/quiet_requests_middleware"
 gem_tools_path = File.expand_path("tools/**/*.rb", __dir__)
 Dir[gem_tools_path].each { |f| require f }
 
+# Temporary monkey patching to address regression in FastMCP
+if Dry::Schema::Macros::Hash.method_defined?(:original_call)
+  Dry::Schema::Macros::Hash.class_eval do
+    def call(*args, &block)
+      if block
+        # Use current context to track nested context if available
+        context = MetadataContext.current
+        if context
+          context.with_nested(name) do
+            original_call(*args, &block)
+          end
+        else
+          original_call(*args, &block)
+        end
+      else
+        original_call(*args)
+      end
+    end
+  end
+end
+
 module Tidewave
   class Railtie < Rails::Railtie
     config.tidewave = Tidewave::Configuration.new()

data/lib/tidewave/streamable_http_transport.rb

@@ -76,11 +76,15 @@ module Tidewave
 
         @logger.debug("Sending response: #{@captured_response.inspect}")
 
-        [
-          200,
-          { "Content-Type" => "application/json" },
-          [ JSON.generate(@captured_response) ]
-        ]
+        if @captured_response
+          [
+            200,
+            { "Content-Type" => "application/json" },
+            [ JSON.generate(@captured_response) ]
+          ]
+        else
+          [ 202, {}, [] ]
+        end
       rescue JSON::ParserError => e
         @logger.error("Invalid JSON in request: #{e.message}")
         json_rpc_error_response(400, -32700, "Parse error", nil)

data/lib/tidewave/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tidewave
-  VERSION = "0.4.0"
+  VERSION = "0.4.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tidewave
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - Yorick Jacquin
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-17 00:00:00.000000000 Z
+date: 2026-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails