Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

fix(python-sdk): expose get_agent_thread on Firecrawl and AsyncFirecrawl (#4983)

Gergő Móricz4b00a298c7fd
diff --git a/apps/python-sdk/firecrawl/__init__.py b/apps/python-sdk/firecrawl/__init__.py
index 637e3f748..2f84e0dab 100644
--- a/apps/python-sdk/firecrawl/__init__.py
+++ b/apps/python-sdk/firecrawl/__init__.py
@@ -41,7 +41,7 @@ from .v1 import (
V1ChangeTrackingOptions,
)
-__version__ = "4.49.0"
+__version__ = "4.49.1"
# Define the logger for the Firecrawl project
logger: logging.Logger = logging.getLogger("firecrawl")
diff --git a/apps/python-sdk/firecrawl/__tests__/unit/v2/methods/test_agent_thread.py b/apps/python-sdk/firecrawl/__tests__/unit/v2/methods/test_agent_thread.py
index bd4c616fe..33e4f725a 100644
--- a/apps/python-sdk/firecrawl/__tests__/unit/v2/methods/test_agent_thread.py
+++ b/apps/python-sdk/firecrawl/__tests__/unit/v2/methods/test_agent_thread.py
@@ -3,8 +3,10 @@ Unit tests for agent threads: request serialization, status parsing and the
thread read method.
"""
-from unittest.mock import Mock
+import asyncio
+from unittest.mock import AsyncMock, Mock
+from firecrawl import AsyncFirecrawl, Firecrawl
from firecrawl.v2.methods.agent import (
_prepare_agent_request,
get_agent_thread,
@@ -335,3 +337,33 @@ class TestGetAgentThread:
client.get.assert_called_once_with(
"/v2/agent/threads/thread-1?includeData=true"
)
+
+
+class TestTopLevelClientsExposeGetAgentThread:
+ """Firecrawl and AsyncFirecrawl reach the thread read like every other agent method."""
+
+ def test_sync_client(self):
+ firecrawl = Firecrawl(api_key="fc-test-key")
+ firecrawl._v2_client.http_client = TestGetAgentThread()._client()
+
+ result = firecrawl.get_agent_thread("thread-1", include_data=True)
+
+ firecrawl._v2_client.http_client.get.assert_called_once_with(
+ "/v2/agent/threads/thread-1?includeData=true"
+ )
+ assert result.thread.id == "thread-1"
+
+ def test_async_client(self):
+ firecrawl = AsyncFirecrawl(api_key="fc-test-key")
+ sync_client = TestGetAgentThread()._client()
+ response = Mock()
+ response.ok = True
+ response.json.return_value = sync_client.get.return_value.json.return_value
+ firecrawl._v2_client.async_http_client.get = AsyncMock(return_value=response)
+
+ result = asyncio.run(firecrawl.get_agent_thread("thread-1", include_data=True))
+
+ firecrawl._v2_client.async_http_client.get.assert_awaited_once_with(
+ "/v2/agent/threads/thread-1?includeData=true"
+ )
+ assert result.thread.id == "thread-1"
diff --git a/apps/python-sdk/firecrawl/client.py b/apps/python-sdk/firecrawl/client.py
index d066011f4..0d019df02 100644
--- a/apps/python-sdk/firecrawl/client.py
+++ b/apps/python-sdk/firecrawl/client.py
@@ -333,6 +333,7 @@ class Firecrawl:
self.list_agents = self._v2_client.list_agents
self.get_agent_trace = self._v2_client.get_agent_trace
self.get_agent_snapshot = self._v2_client.get_agent_snapshot
+ self.get_agent_thread = self._v2_client.get_agent_thread
self.agent = self._v2_client.agent
self.get_concurrency = self._v2_client.get_concurrency
@@ -478,6 +479,7 @@ class AsyncFirecrawl:
self.list_agents = self._v2_client.list_agents
self.get_agent_trace = self._v2_client.get_agent_trace
self.get_agent_snapshot = self._v2_client.get_agent_snapshot
+ self.get_agent_thread = self._v2_client.get_agent_thread
self.agent = self._v2_client.agent
self.get_concurrency = self._v2_client.get_concurrency