tidewave 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3375b13a00fb5b052a2bea5c6b720056379f16a26cc984ffde2973d2d2fca90
-  data.tar.gz: b5d7c9d2290e2273116712116fcb8336ddbc4009be187ca0413ec3c727b33e6b
+  metadata.gz: 2ecc3b3a79123c50c7ec933b8cea5e2e4f61aff33671db1237c69a7536b31071
+  data.tar.gz: 14781db2f527923f2c5a52c4830c055659abd2e06d49526dd4630df0cd63d22a
 SHA512:
-  metadata.gz: 6ad6d175fef2e61d40ab97de1bbf36bfaf3f37137ee7d54d6cc1f7987096e105e37381376e6f8263b70b31795065824b459225512d62e9ae5615c9dc098a8b2d
-  data.tar.gz: 2535c2570a69f70114705b2ec13f708b17bae00aefcaae504c97323c2c07edb3686a142d40f6a85f42a7619754f93fb8cbcd7267edcbb349fc621004f15c3ae2
+  metadata.gz: 39710ecba05ce8a3bf8686695c4602282fd6ee27356f4cc532cb78ea57a16403d2eb60059163b21ed5b3a3cc9225ae51a32a18df7eeee5b6e70197aae246ab26
+  data.tar.gz: e87dccaff2712bb7df136913ab409d9cc818f81444fb3892025541a274ba4ba4f17986bc425ba10c99e414668a7531a5773a8f5043c27b58b1af2d0c53a03538

data/README.md

@@ -2,11 +2,17 @@
 
 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
@@ -16,28 +22,31 @@ Now make sure [Tidewave is installed](https://hexdocs.pm/tidewave/installation.h
 
 ## Troubleshooting
 
-### Content security policy
+### Using multiple hosts/subdomains
 
-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.
+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`:
 
-### Production Environment
+```ruby
+config.session_store :cookie_store,
+  key: "__your_app_session",
+  same_site: :none,
+  secure: true,
+  assume_ssl: true
+```
 
-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.
+And make sure you are using `rack-session` version `2.1.0` or later.
 
-Tidewave will raise an error if it is used in any environment where code reloading is disabled (which typically includes production).
+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).
 
-### Localhost requirement
+### Content security policy
 
-> This requirement only matters if you are not using the Tidewave app/CLI.
+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.
 
-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`:
+### Production Environment
 
-```ruby
-config.hosts << "company.local"
-config.tidewave.allow_remote_access = true
-```
+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.
 
-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.
+Tidewave will raise an error if it is used in any environment where code reloading is disabled (which typically includes production).
 
 ## Configuration
 
@@ -57,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/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.1"
+  VERSION = "0.4.2"
 end

metadata

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