firecrawl-sdk 1.15.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c7e11ff05113a301d334412a0aea3f1d421aa93cd45756c0546193d1cc3839e
-  data.tar.gz: 46b8f0dc763344c1372212a1e612812292c67efc6042a3ff5a45c66a4e63dcee
+  metadata.gz: d4692141ed256c6cf62171578f7bfdbb852ddb915a60b48ba520a73ecc8885b1
+  data.tar.gz: ff206e069d080e13598824ff3faa7eaf86b89b2cacbc051cd53aa861b20d1977
 SHA512:
-  metadata.gz: 7f29c1250ccac6a0b7aece8951bc655dd3b55aee9f4d18dd66a987829514490c350dde4865527e0a48bf52fa1362c5d2d7bcd0ae168b319bbff51c824148d190
-  data.tar.gz: 1e907fd282ee7314cafe5223fc63571ada85ce45381de830f99baf2dcf41c7cb9b45d4a5ad45863cb1b1d0b812918a1bcda778e57886eea12811b421196932f9
+  metadata.gz: 83a86911be8bfd5b9736bbfbe610c40934b31a9e6da25de714972be4399c9374421955e2b0ef5e41b6a15c0829c3c3ff30dbc1004a75c9a6210182f0df620399
+  data.tar.gz: 9ca272944fc87bf14462b30e0f7f99239a1253ca11c88c1d7393469f52491362e0a72f7c5e354467e0f154c1e780aa08732e162fdc2345832ffe0d4779f98bc9

data/lib/firecrawl/client.rb

@@ -129,6 +129,10 @@ module Firecrawl
 
     # Search GitHub research content.
     #
+    # @deprecated Stops responding after 2026-11-03. Use the developer index at
+    #   GET or POST /v2/search/developer, which this SDK does not wrap yet, so
+    #   call it directly. It does not carry over the score breakdown or the
+    #   web fallback results.
     # @param query_text [String] GitHub query
     # @param options [Hash] optional query parameters
     # @return [Hash]
@@ -463,6 +467,20 @@ module Firecrawl
       Models::AgentStatusResponse.new(raw)
     end
 
+    # Lists agent tasks, most recent first.
+    #
+    # Pages are fixed at 20 runs. To fetch the next page, pass the before
+    # value from the previous page's next URL. This method does not
+    # auto-paginate.
+    #
+    # @param before [Integer, nil] only return agent runs created before this
+    #   unix millisecond timestamp
+    # @return [Models::AgentListResponse]
+    def list_agents(before: nil)
+      raw = @http.get("/v2/agent#{query(before: before)}")
+      Models::AgentListResponse.new(raw)
+    end
+
     # Runs an agent task and waits for completion (auto-polling).
     #
     # @param options [Models::AgentOptions] agent configuration

data/lib/firecrawl/models/agent_list_response.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # Response from listing agent tasks.
+    class AgentListResponse
+      attr_reader :success, :agents, :next, :error
+
+      def initialize(raw)
+        @success = raw["success"]
+        @agents = raw["agents"]
+        @next = raw["next"]
+        @error = raw["error"]
+      end
+
+      def to_s
+        "AgentListResponse{success=#{success}, agents=#{agents&.size}}"
+      end
+    end
+  end
+end

data/lib/firecrawl/models/search_options.rb

@@ -5,7 +5,7 @@ module Firecrawl
     # Options for a web search request.
     class SearchOptions
       FIELDS = %i[
-        sources categories include_domains exclude_domains limit tbs location
+        sources categories include_domains exclude_domains limit tbs location country
         ignore_invalid_urls timeout highlights scrape_options integration enterprise
       ].freeze
 
@@ -24,6 +24,7 @@ module Firecrawl
           "limit" => limit,
           "tbs" => tbs,
           "location" => location,
+          "country" => country,
           "ignoreInvalidURLs" => ignore_invalid_urls,
           "timeout" => timeout,
           "highlights" => highlights,

data/lib/firecrawl/version.rb

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

data/lib/firecrawl.rb

@@ -24,6 +24,7 @@ require_relative "firecrawl/models/parse_file"
 require_relative "firecrawl/models/parse_options"
 require_relative "firecrawl/models/agent_options"
 require_relative "firecrawl/models/agent_response"
+require_relative "firecrawl/models/agent_list_response"
 require_relative "firecrawl/models/agent_status_response"
 require_relative "firecrawl/models/agent_trace_response"
 require_relative "firecrawl/models/agent_snapshot_response"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: firecrawl-sdk
 version: !ruby/object:Gem::Version
-  version: 1.15.0
+  version: 1.17.0
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-26 00:00:00.000000000 Z
+date: 2026-09-08 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.
@@ -24,6 +24,7 @@ files:
 - lib/firecrawl/client.rb
 - lib/firecrawl/errors.rb
 - lib/firecrawl/http_client.rb
+- lib/firecrawl/models/agent_list_response.rb
 - lib/firecrawl/models/agent_options.rb
 - lib/firecrawl/models/agent_response.rb
 - lib/firecrawl/models/agent_snapshot_response.rb