firecrawl-sdk 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c7e11ff05113a301d334412a0aea3f1d421aa93cd45756c0546193d1cc3839e
-  data.tar.gz: 46b8f0dc763344c1372212a1e612812292c67efc6042a3ff5a45c66a4e63dcee
+  metadata.gz: 6f3695aabd644bab09a7baa7c340d72fe38f376cba6d2f2cc1635d9df2f3d66e
+  data.tar.gz: 445c52d6c75a8a3ba54b751a00b6ccf3d09745693bbee5462f6253eba3f7eb8d
 SHA512:
-  metadata.gz: 7f29c1250ccac6a0b7aece8951bc655dd3b55aee9f4d18dd66a987829514490c350dde4865527e0a48bf52fa1362c5d2d7bcd0ae168b319bbff51c824148d190
-  data.tar.gz: 1e907fd282ee7314cafe5223fc63571ada85ce45381de830f99baf2dcf41c7cb9b45d4a5ad45863cb1b1d0b812918a1bcda778e57886eea12811b421196932f9
+  metadata.gz: daaf47ae8bc4b2ae5a549b873c5978fa01e1abf2cd9a4dfd5829da5a0797b2109892885c991830a4aecd6c69b469ac09ecd52a545f278238d57ecb13a779be42
+  data.tar.gz: 73433fb46a58926b598d1fee36aadf7551dbfdaf636d484860d81bf65fd7c13ce014272e5b32508db76ecfd6db728ba64e5232d764f6207f2b70b1e6867032ac

data/lib/firecrawl/client.rb

@@ -463,6 +463,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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Firecrawl
-  VERSION = "1.15.0"
+  VERSION = "1.16.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.16.0
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-26 00:00:00.000000000 Z
+date: 2026-08-31 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