tidewave 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d708afbfcf6d89cc1456bd7bcefdc660952571cda0c6635b8c6b14b8fa31d91e
-  data.tar.gz: da923b2f69608fe95eb11f76795cef1598f9cc24941afe50081afc4b76c66cfa
+  metadata.gz: d140360315f54166fc14e330f33fc5dd62e561c49ba3d6cb5044a8e7b5247e41
+  data.tar.gz: c69a1a0363ce0f50a396599f2b551896a602431929731dd9fbf4fbe283823cf1
 SHA512:
-  metadata.gz: 9b0eaa2a77690e4dda1720e5c2c84b02ea93d9b69955e2e430745da483d30014ba3fc5d59dc40c92b0ccdedd4413f4198012813a33f2332fd7ca08a9fac79fc1
-  data.tar.gz: 501103bf39a69932a408ebf9e455640fc8fb97a507163d6b4f42faf27aead8811927ecc249858978c8c5a46213dbe5b1d8635ade60817f546645ec99fa4c203a
+  metadata.gz: 6f3203bbce1c31681fcb2b21575ea62a8714a469f61ec30be8d59ccd22028592b7a33317b4f434e0d7a4051caaf1db1aa82247d395a961d4a09f1a1538cc6cd8
+  data.tar.gz: 968742eed4690b5c2a1f8c0ecf233e4742a19bc2ac8a700d4f64eca2878bea8f70d1d2228cffc472019462790eb122601b7acfc608fd7950c100974f3c9053d4

data/README.md

@@ -1,10 +1,8 @@
 # Tidewave
 
-Tidewave speeds up development with an AI assistant that understands your web application,
-how it runs, and what it delivers. Our current release connects your editor's
-assistant to your web framework runtime via [MCP](https://modelcontextprotocol.io/).
+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.
 
-[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.
 
 ## Installation
 
@@ -14,9 +12,7 @@ You can install Tidewave by adding the `tidewave` gem to the development group i
 gem "tidewave", group: :development
 ```
 
-Tidewave will now run on the same port as your regular Rails application.
-In particular, the MCP is located by default at http://localhost:3000/tidewave/mcp.
-[You must configure your editor and AI assistants accordingly](https://hexdocs.pm/tidewave/mcp.html).
+Now access `/tidewave` route of your web application to enjoy Tidewave Web!
 
 ## Troubleshooting
 
@@ -29,22 +25,24 @@ config.hosts << "company.local"
 config.tidewave.allow_remote_access = 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 [containars](https://hexdocs.pm/tidewave/containers.html) guide for more information.
+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.
 
 ### 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.
 
+### 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.
 
 Tidewave will raise an error if it is used in any environment where code reloading is disabled (which typically includes production).
 
-### Web server requirements
-
-Tidewave currently requires a threaded web server like Puma.
-
 ## Configuration
 
 You may configure `tidewave` using the following syntax:
@@ -53,11 +51,13 @@ You may configure `tidewave` using the following syntax:
   config.tidewave.allow_remote_access = true
 ```
 
-The following options are available:
+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 as well. If you trust your network and need to access Tidewave from a different machine, this configuration can be set to `true`
+  * `preferred_orm` - which ORM to use, either `:active_record` (default) or `:sequel`
 
-  * `:preferred_orm` - which ORM to use, either `:active_record` (default) or `:sequel`
+  * `team` - set your team configuration, such as `config.tidewave.team = { id: "my-company }`
 
 ## Acknowledgements
 

data/lib/tidewave/configuration.rb

@@ -2,7 +2,7 @@
 
 module Tidewave
   class Configuration
-    attr_accessor :logger, :allow_remote_access, :preferred_orm, :credentials, :client_url
+    attr_accessor :logger, :allow_remote_access, :preferred_orm, :credentials, :client_url, :team
 
     def initialize
       @logger = nil
@@ -10,6 +10,7 @@ module Tidewave
       @preferred_orm = :active_record
       @credentials = {}
       @client_url = "https://tidewave.ai"
+      @team = {}
     end
   end
 end

data/lib/tidewave/middleware.rb

@@ -25,6 +25,7 @@ class Tidewave::Middleware
   def initialize(app, config)
     @allow_remote_access = config.allow_remote_access
     @client_url = config.client_url
+    @team = config.team
     @project_name = Rails.application.class.module_parent.name
 
     @app = FastMcp.rack_middleware(app,
@@ -78,7 +79,8 @@ class Tidewave::Middleware
     config = {
       "project_name" => @project_name,
       "framework_type" => "rails",
-      "tidewave_version" => Tidewave::VERSION
+      "tidewave_version" => Tidewave::VERSION,
+      "team" => @team
     }
 
     html = <<~HTML

data/lib/tidewave/quiet_requests_middleware.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class Tidewave::QuietRequestsMiddleware
+  def initialize(app)
+    @app = app
+  end
+
+  def call(env)
+    if env["PATH_INFO"].start_with?("/tidewave")
+      Rails.logger.silence { @app.call(env) }
+    else
+      @app.call(env)
+    end
+  end
+end

data/lib/tidewave/railtie.rb

@@ -5,6 +5,7 @@ require "fileutils"
 require "tidewave/configuration"
 require "tidewave/middleware"
 require "tidewave/exceptions_middleware"
+require "tidewave/quiet_requests_middleware"
 
 gem_tools_path = File.expand_path("tools/**/*.rb", __dir__)
 Dir[gem_tools_path].each { |f| require f }
@@ -45,5 +46,10 @@ module Tidewave
 
       app.middleware.insert_before(ActionDispatch::DebugExceptions, Tidewave::ExceptionsMiddleware)
     end
+
+    initializer "tidewave.logging" do |app|
+      # Do not pollute user logs with tidewave requests.
+      app.middleware.insert_before(Rails::Rack::Logger, Tidewave::QuietRequestsMiddleware)
+    end
   end
 end

data/lib/tidewave/tools/get_logs.rb

@@ -10,13 +10,20 @@ class Tidewave::Tools::GetLogs < Tidewave::Tools::Base
 
   arguments do
     required(:tail).filled(:integer).description("The number of log entries to return from the end of the log")
+    optional(:grep).filled(:string).description("Filter logs with the given regular expression (case insensitive). E.g. \"error\" when you want to capture errors in particular")
   end
 
-  def call(tail:)
+  def call(tail:, grep: nil)
     log_file = Rails.root.join("log", "#{Rails.env}.log")
     return "Log file not found" unless File.exist?(log_file)
 
-    logs = File.readlines(log_file).last(tail)
-    logs.join
+    logs = File.readlines(log_file)
+
+    if grep
+      regex = Regexp.new(grep, Regexp::IGNORECASE)
+      logs = logs.select { |line| line.match?(regex) }
+    end
+
+    logs.last(tail).join
   end
 end

data/lib/tidewave/tools/get_models.rb

@@ -3,7 +3,7 @@
 class Tidewave::Tools::GetModels < Tidewave::Tools::Base
   tool_name "get_models"
   description <<~DESCRIPTION
-    Returns a list of all models in the application.
+    Returns a list of all database-backed models in the application.
   DESCRIPTION
 
   def call

data/lib/tidewave/tools/get_source_location.rb

@@ -10,10 +10,11 @@ class Tidewave::Tools::GetSourceLocation < Tidewave::Tools::Base
     such as `String`, an instance method, such as `String#gsub`, or class
     method, such as `File.executable?`
 
-    This works for methods in the current project, as well as dependencies.
-
-    This tool only works if you know the specific constant/method being targeted.
+    This tool only works if you know the specific constant/method being targeted,
+    and it works across the current project and all dependencies.
     If that is the case, prefer this tool over grepping the file system.
+
+    You may also get the root location of a gem, you can use "dep:PACKAGE_NAME".
   DESCRIPTION
 
   arguments do
@@ -21,6 +22,12 @@ class Tidewave::Tools::GetSourceLocation < Tidewave::Tools::Base
   end
 
   def call(reference:)
+    # Check if this is a package location request
+    if reference.start_with?("dep:")
+      package_name = reference.gsub("dep:", "")
+      return get_package_location(package_name)
+    end
+
     file_path, line_number = self.class.get_source_location(reference)
 
     if file_path
@@ -36,6 +43,18 @@ class Tidewave::Tools::GetSourceLocation < Tidewave::Tools::Base
     end
   end
 
+  def get_package_location(package)
+    raise "dep: prefix only works with projects using Bundler" unless defined?(Bundler)
+    specs = Bundler.load.specs
+
+    spec = specs.find { |s| s.name == package }
+    if spec
+      spec.full_gem_path
+    else
+      raise "Package #{package} not found. Check your Gemfile for available packages."
+    end
+  end
+
   def self.get_source_location(reference)
     constant_path, selector, method_name = reference.rpartition(/\.|#/)
 

data/lib/tidewave/tools/project_eval.rb

@@ -20,7 +20,7 @@ class Tidewave::Tools::ProjectEval < Tidewave::Tools::Base
     required(:code).filled(:string).description("The Ruby code to evaluate")
     optional(:arguments).value(:array).description("The arguments to pass to evaluation. They are available inside the evaluated code as `arguments`.")
     optional(:timeout).filled(:integer).description("The timeout in milliseconds. If the evaluation takes longer than this, it will be terminated. Defaults to 30000 (30 seconds).")
-    optional(:json).filled(:bool).description("Whether to return the result as JSON with structured output containing result, success, stdout, and stderr fields. Defaults to false.")
+    optional(:json).hidden().filled(:bool).description("Whether to return the result as JSON with structured output containing result, success, stdout, and stderr fields. Defaults to false.")
   end
 
   def call(code:, arguments: [], timeout: 30_000, json: false)

data/lib/tidewave/version.rb

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

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: tidewave
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Yorick Jacquin
+- José Valim
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-12 00:00:00.000000000 Z
+date: 2025-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -68,22 +69,16 @@ files:
 - lib/tidewave/database_adapters/active_record.rb
 - lib/tidewave/database_adapters/sequel.rb
 - lib/tidewave/exceptions_middleware.rb
-- lib/tidewave/file_tracker.rb
 - lib/tidewave/middleware.rb
+- lib/tidewave/quiet_requests_middleware.rb
 - lib/tidewave/railtie.rb
 - lib/tidewave/tools/base.rb
-- lib/tidewave/tools/edit_project_file.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_package_location.rb
 - lib/tidewave/tools/get_source_location.rb
-- lib/tidewave/tools/list_project_files.rb
 - lib/tidewave/tools/project_eval.rb
-- lib/tidewave/tools/read_project_file.rb
-- lib/tidewave/tools/shell_eval.rb
-- lib/tidewave/tools/write_project_file.rb
 - lib/tidewave/version.rb
 homepage: https://tidewave.ai/
 licenses:

data/lib/tidewave/file_tracker.rb

@@ -1,102 +0,0 @@
-# frozen_string_literal: true
-
-module Tidewave
-  module FileTracker
-    extend self
-
-    def project_files(glob_pattern: nil, include_ignored: false)
-      args = [ "ls-files", "--cached", "--others" ]
-      args << "--exclude-standard" unless include_ignored
-      args << glob_pattern if glob_pattern
-      `git #{args.join(" ")}`.split("\n")
-    end
-
-    def read_file(path, line_offset: 0, count: nil)
-      full_path = file_full_path(path)
-      # Explicitly read the mtime first to avoid race conditions
-      mtime = File.mtime(full_path).to_i
-      content = File.read(full_path)
-
-      if line_offset > 0 || count
-        lines = content.lines
-        start_idx = [ line_offset, 0 ].max
-        count = (count || lines.length)
-        selected_lines = lines[start_idx, count]
-        content = selected_lines ? selected_lines.join : ""
-      end
-
-      [ mtime, content ]
-    end
-
-    def write_file(path, content)
-      validate_ruby_syntax!(content) if ruby_file?(path)
-      full_path = file_full_path(path)
-
-      # Create the directory if it doesn't exist
-      dirname = File.dirname(full_path)
-      FileUtils.mkdir_p(dirname)
-
-      # Write and return the file contents
-      File.write(full_path, content)
-      content
-    end
-
-    def file_full_path(path)
-      File.expand_path(path, Rails.root)
-    end
-
-    def validate_path_access!(path, validate_existence: true)
-      raise ArgumentError, "File path must not contain '..'" if path.include?("..")
-
-      # Ensure the path is within the project
-      full_path = file_full_path(path)
-
-      # Verify the file is within the project directory
-      unless full_path.start_with?(Rails.root.to_s + File::SEPARATOR)
-        raise ArgumentError, "File path must be within the project directory"
-      end
-
-      # Verify the file exists
-      if validate_existence && !File.exist?(full_path)
-        raise ArgumentError, "File not found: #{path}"
-      end
-
-      true
-    end
-
-    def validate_path_is_editable!(path, atime)
-      validate_path_access!(path)
-      validate_path_has_been_read_since_last_write!(path, atime)
-
-      true
-    end
-
-    def validate_path_is_writable!(path, atime)
-      validate_path_access!(path, validate_existence: false)
-      validate_path_has_been_read_since_last_write!(path, atime)
-
-      true
-    end
-
-    private
-
-    def ruby_file?(path)
-      [ ".rb", ".rake", ".gemspec" ].include?(File.extname(path)) ||
-        [ "Gemfile" ].include?(File.basename(path))
-    end
-
-    def validate_ruby_syntax!(content)
-      RubyVM::AbstractSyntaxTree.parse(content)
-    rescue SyntaxError => e
-      raise "Invalid Ruby syntax: #{e.message}"
-    end
-
-    def validate_path_has_been_read_since_last_write!(path, atime)
-      if atime && File.mtime(file_full_path(path)).to_i > atime
-        raise ArgumentError, "File has been modified since last read, please read the file again"
-      end
-
-      true
-    end
-  end
-end

data/lib/tidewave/tools/edit_project_file.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-require "tidewave/file_tracker"
-
-class Tidewave::Tools::EditProjectFile < Tidewave::Tools::Base
-  tags :file_system_tool
-
-  tool_name "edit_project_file"
-  description <<~DESCRIPTION
-    A tool for editing parts of a file. It can find and replace text inside a file.
-    For moving or deleting files, use the shell_eval tool with 'mv' or 'rm' instead.
-
-    For large edits, use the write_project_file tool instead and overwrite the entire file.
-
-    Before editing, ensure to read the source file using the read_project_file tool.
-
-    To use this tool, provide the path to the file, the old_string to search for, and the new_string to replace it with.
-    If the old_string is found multiple times, an error will be returned. To ensure uniqueness, include a couple of lines
-    before and after the edit. All whitespace must be preserved as in the original file.
-
-    This tool can only do a single edit at a time. If you need to make multiple edits, you can create a message with
-    multiple tool calls to this tool, ensuring that each one contains enough context to uniquely identify the edit.
-  DESCRIPTION
-
-  arguments do
-    required(:path).filled(:string).description("The path to the file to edit. It is relative to the project root.")
-    required(:old_string).filled(:string).description("The string to search for")
-    required(:new_string).filled(:string).description("The string to replace the old_string with")
-    optional(:atime).filled(:integer).hidden.description("The Unix timestamp this file was last accessed. Not to be used.")
-  end
-
-  def call(path:, old_string:, new_string:, atime: nil)
-    # Check if the file exists within the project root and has been read
-    Tidewave::FileTracker.validate_path_is_editable!(path, atime)
-
-    _mtime, old_content = Tidewave::FileTracker.read_file(path)
-
-    # Ensure old_string is unique within the file
-    scan_result = old_content.scan(old_string)
-    raise ArgumentError, "old_string is not found" if scan_result.empty?
-    raise ArgumentError, "old_string is not unique" if scan_result.size > 1
-
-    new_content = old_content.sub(old_string, new_string)
-    Tidewave::FileTracker.write_file(path, new_content)
-    "OK"
-  end
-end

data/lib/tidewave/tools/get_package_location.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-
-class Tidewave::Tools::GetPackageLocation < Tidewave::Tools::Base
-  tool_name "get_package_location"
-
-  description <<~DESCRIPTION
-    Returns the location of dependency packages.
-    You can use this tool to get the location of any project dependency. Optionally,
-    a specific dependency name can be provided to only return the location of that dependency.
-    Use the result in combination with shell tools like grep to look for specific
-    code inside dependencies.
-  DESCRIPTION
-
-  arguments do
-    optional(:package).maybe(:string).description(
-      "The name of the package to get the location of. If not provided, the location of all packages will be returned."
-    )
-  end
-
-  def call(package: nil)
-    raise "get_package_location only works with projects using Bundler" unless defined?(Bundler)
-    specs = Bundler.load.specs
-
-    if package
-      spec = specs.find { |s| s.name == package }
-      if spec
-        spec.full_gem_path
-      else
-        raise "Package #{package} not found. Check your Gemfile for available packages."
-      end
-    else
-      # For all packages, return a formatted string with package names and locations
-      specs.map do |spec|
-        relative_path = Pathname.new(spec.full_gem_path).relative_path_from(Pathname.new(Dir.pwd))
-        "#{spec.name}: #{relative_path}"
-      end.join("\n")
-    end
-  end
-end

data/lib/tidewave/tools/list_project_files.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require "tidewave/file_tracker"
-
-class Tidewave::Tools::ListProjectFiles < Tidewave::Tools::Base
-  tags :file_system_tool
-
-  tool_name "list_project_files"
-  description <<~DESC
-    Returns a list of files in the project.
-
-    By default, when no arguments are passed, it returns all files in the project that
-    are not ignored by .gitignore.
-
-    Optionally, a glob_pattern can be passed to filter this list.
-  DESC
-
-  arguments do
-    optional(:glob_pattern).maybe(:string).description("Optional: a glob pattern to filter the listed files")
-    optional(:include_ignored).maybe(:bool).description("Optional: whether to include files that are ignored by .gitignore. Defaults to false. WARNING: Use with targeted glob patterns to avoid listing excessive files from dependencies or build directories.")
-  end
-
-  def call(glob_pattern: nil, include_ignored: false)
-    Tidewave::FileTracker.project_files(glob_pattern: glob_pattern, include_ignored: include_ignored)
-  end
-end

data/lib/tidewave/tools/read_project_file.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require "tidewave/file_tracker"
-
-class Tidewave::Tools::ReadProjectFile < Tidewave::Tools::Base
-  tags :file_system_tool
-
-  tool_name "read_project_file"
-  description <<~DESCRIPTION
-    Returns the contents of the given file.
-    Supports an optional line_offset and count. To read the full file, only the path needs to be passed.
-  DESCRIPTION
-
-  arguments do
-    required(:path).filled(:string).description("The path to the file to read. It is relative to the project root.")
-    optional(:line_offset).filled(:integer).description("Optional: the starting line offset from which to read. Defaults to 0.")
-    optional(:count).filled(:integer).description("Optional: the number of lines to read. Defaults to all.")
-  end
-
-  def call(path:, **keywords)
-    Tidewave::FileTracker.validate_path_access!(path)
-    _meta[:mtime], contents = Tidewave::FileTracker.read_file(path, **keywords)
-    contents
-  end
-end

data/lib/tidewave/tools/shell_eval.rb

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-
-class Tidewave::Tools::ShellEval < Tidewave::Tools::Base
-  tags :file_system_tool
-  class CommandFailedError < StandardError; end
-
-  tool_name "shell_eval"
-  description <<~DESCRIPTION
-    Executes a shell command in the project root directory.
-
-    The operating system is of flavor #{RUBY_PLATFORM}.
-
-    Avoid using this tool for manipulating project files.
-    Instead rely on the tools with the name matching `*_project_files`.
-
-    Do not use this tool to evaluate Ruby code. Use `project_eval` instead.
-    Do not use this tool for commands that run indefinitely,
-    such as servers (like `bin/dev` or `npm run dev`),
-    REPLs (`bin/rails console`) or file watchers.
-
-    Only use this tool if other means are not available.
-  DESCRIPTION
-
-  arguments do
-    required(:command).filled(:string).description("The shell command to execute. Avoid using this for file operations; use dedicated file system tools instead.")
-  end
-
-  def call(command:)
-    stdout, status = Open3.capture2e(command)
-    raise CommandFailedError, "Command failed with status #{status.exitstatus}:\n\n#{stdout}" unless status.exitstatus.zero?
-
-    stdout.strip
-  end
-end

data/lib/tidewave/tools/write_project_file.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require "tidewave/file_tracker"
-
-class Tidewave::Tools::WriteProjectFile < Tidewave::Tools::Base
-  tags :file_system_tool
-
-  tool_name "write_project_file"
-  description <<~DESCRIPTION
-    Writes a file to the file system. If the file already exists, it will be overwritten.
-
-    Note that this tool will fail if the file wasn't previously read with the `read_project_file` tool.
-  DESCRIPTION
-
-  arguments do
-    required(:path).filled(:string).description("The path to the file to write. It is relative to the project root.")
-    required(:content).filled(:string).description("The content to write to the file")
-    optional(:atime).filled(:integer).hidden.description("The Unix timestamp this file was last accessed. Not to be used.")
-  end
-
-  def call(path:, content:, atime: nil)
-    Tidewave::FileTracker.validate_path_is_writable!(path, atime)
-    Tidewave::FileTracker.write_file(path, content)
-    _meta[:mtime] = Time.now.to_i
-
-    "OK"
-  end
-end