firecrawl-sdk 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 925d1d1e2e21f65f6ff043a07d8689f5e29b41d72b1b8791334af47d76153819
-  data.tar.gz: 8e70053a8eabd4d2ff100386c4bb7c4fd2bea7ec119dedf2151d21c404e41e31
+  metadata.gz: d02f8409836cbb0811734f56c0eeebf590ad09596f86edb863fa8ca4532833b1
+  data.tar.gz: 37fb91eaebc98e5cb3feea6b4e0fb8b7543acc1c75b23f0c4c64f6f815501fbc
 SHA512:
-  metadata.gz: ce98788dd3a379d575f97962b597224115463b28adf19870b0820c2a6e60c4fa44ce4b58d039843022e38d0027254e8808f3704552bc401994497c040f752233
-  data.tar.gz: 7349d8f5d5a63d54364b7b1c1afef54b0d16930d6b107b97bb3ba933fc404ec45559ec8ab4a0e0551f142c108fb70e24ea30bfecf2562d01e0b182163e0e9eea
+  metadata.gz: ed4a232b9c66bc1b525f33fe358bb1a0e1b2bf197c3e51a971f11b016958f0f1e0af5b729a8e738a4e56a99bf97824aa335d763924d26c5a8eaa5102ee68ccd5
+  data.tar.gz: cecb039f3026016df71f208f5e2989f8c86e9edc7d7e25fdb390e855962ecdba115411e8b2f4b97e3fcbca8cb8517e3d31c9f6b7daafdcfd05004b69365e0971

data/lib/firecrawl/models/parse_options.rb

@@ -26,7 +26,7 @@ module Firecrawl
 
       def to_h
         {
-          "formats" => formats,
+          "formats" => formats&.map { |fmt| format_value(fmt) },
           "headers" => headers,
           "includeTags" => include_tags,
           "excludeTags" => exclude_tags,
@@ -69,6 +69,10 @@ module Firecrawl
           fmt.respond_to?(:type) ? fmt.type : nil
         end
       end
+
+      def format_value(fmt)
+        fmt.respond_to?(:to_h) ? fmt.to_h : fmt
+      end
     end
   end
 end

data/lib/firecrawl/models/query_format.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # Query format for asking a question about page content.
+    class QueryFormat
+      MODE_FREEFORM = "freeform"
+      MODE_DIRECT_QUOTE = "directQuote"
+
+      attr_reader :prompt, :mode
+
+      def initialize(prompt:, mode: nil)
+        unless mode.nil? || [MODE_FREEFORM, MODE_DIRECT_QUOTE].include?(mode)
+          raise ArgumentError, "query mode must be 'freeform' or 'directQuote'"
+        end
+
+        @prompt = prompt
+        @mode = mode
+      end
+
+      def to_h
+        {
+          "type" => "query",
+          "prompt" => prompt,
+          "mode" => mode,
+        }.compact
+      end
+
+      def type
+        "query"
+      end
+    end
+  end
+end

data/lib/firecrawl/models/scrape_options.rb

@@ -20,7 +20,7 @@ module Firecrawl
 
       def to_h
         {
-          "formats" => formats,
+          "formats" => formats&.map { |fmt| format_value(fmt) },
           "headers" => headers,
           "includeTags" => include_tags,
           "excludeTags" => exclude_tags,
@@ -41,6 +41,12 @@ module Firecrawl
           "integration" => integration,
         }.compact
       end
+
+      private
+
+      def format_value(fmt)
+        fmt.respond_to?(:to_h) ? fmt.to_h : fmt
+      end
     end
   end
 end

data/lib/firecrawl/models/search_options.rb

@@ -5,8 +5,8 @@ module Firecrawl
     # Options for a web search request.
     class SearchOptions
       FIELDS = %i[
-        sources categories limit tbs location ignore_invalid_urls
-        timeout scrape_options integration
+        sources categories include_domains exclude_domains limit tbs location
+        ignore_invalid_urls timeout scrape_options integration
       ].freeze
 
       attr_reader(*FIELDS)
@@ -19,6 +19,8 @@ module Firecrawl
         {
           "sources" => sources,
           "categories" => categories,
+          "includeDomains" => include_domains,
+          "excludeDomains" => exclude_domains,
           "limit" => limit,
           "tbs" => tbs,
           "location" => location,

data/lib/firecrawl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Firecrawl
-  VERSION = "1.3.0"
+  VERSION = "1.3.1"
 end

data/lib/firecrawl.rb

@@ -3,6 +3,7 @@
 require_relative "firecrawl/version"
 require_relative "firecrawl/errors"
 require_relative "firecrawl/http_client"
+require_relative "firecrawl/models/query_format"
 require_relative "firecrawl/models/document"
 require_relative "firecrawl/models/scrape_options"
 require_relative "firecrawl/models/crawl_options"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: firecrawl-sdk
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-30 00:00:00.000000000 Z
+date: 2026-05-05 00:00:00.000000000 Z
 dependencies: []
 description: A type-safe Ruby client for the Firecrawl v2 API. Supports scraping,
   crawling, batch scraping, URL mapping, web search, and AI agent operations.
@@ -40,6 +40,7 @@ files:
 - lib/firecrawl/models/map_options.rb
 - lib/firecrawl/models/parse_file.rb
 - lib/firecrawl/models/parse_options.rb
+- lib/firecrawl/models/query_format.rb
 - lib/firecrawl/models/scrape_options.rb
 - lib/firecrawl/models/search_data.rb
 - lib/firecrawl/models/search_options.rb