Skip to content

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

style(php-sdk): trim docblocks to repo comment conventions

Kris Oeib295b875adb5
diff --git a/apps/php-sdk/src/Client/FirecrawlClient.php b/apps/php-sdk/src/Client/FirecrawlClient.php
index c33496656..c25c924c7 100644
--- a/apps/php-sdk/src/Client/FirecrawlClient.php
+++ b/apps/php-sdk/src/Client/FirecrawlClient.php
@@ -730,10 +730,9 @@ final class FirecrawlClient
}
/**
- * The API intentionally reports some failures (for example DNS resolution
- * errors) as HTTP 200 with a `success: false` body, so for those the flag,
- * not the status code, is the error signal. The Python and JS SDKs raise
- * on it the same way.
+ * The API reports some failures (e.g. DNS resolution errors) as HTTP 200
+ * with a `success: false` body; the flag, not the status code, is the
+ * error signal for those.
*
* @param array<string, mixed> $response
* @return array<string, mixed> the same response, if it does not signal failure
diff --git a/apps/php-sdk/src/Laravel/Tools/FirecrawlCrawl.php b/apps/php-sdk/src/Laravel/Tools/FirecrawlCrawl.php
index c5e9eaebe..d0bd7368e 100644
--- a/apps/php-sdk/src/Laravel/Tools/FirecrawlCrawl.php
+++ b/apps/php-sdk/src/Laravel/Tools/FirecrawlCrawl.php
@@ -14,10 +14,8 @@ use Laravel\Ai\Tools\Request;
class FirecrawlCrawl extends FirecrawlTool
{
/**
- * Extenders can override this to wait longer, but the default keeps the
- * crawl inside typical queue worker timeouts (e.g. Laravel's default of
- * 60 seconds) so the tool returns a readable timeout message instead of
- * dying with the job.
+ * Kept below typical queue worker timeouts (Laravel defaults to 60
+ * seconds); override to wait longer.
*/
protected int $timeoutSeconds = 55;
diff --git a/apps/php-sdk/src/Laravel/Tools/FirecrawlTool.php b/apps/php-sdk/src/Laravel/Tools/FirecrawlTool.php
index eadfe121f..c79d8abd6 100644
--- a/apps/php-sdk/src/Laravel/Tools/FirecrawlTool.php
+++ b/apps/php-sdk/src/Laravel/Tools/FirecrawlTool.php
@@ -32,10 +32,8 @@ abstract class FirecrawlTool implements Tool
}
/**
- * Run a Firecrawl call, returning failures as strings so the model can
- * see the error and recover instead of aborting the whole agent run.
- * Non-SDK failures (e.g. container resolution, JSON encoding) are also
- * converted to strings so `handle()` never throws.
+ * Convert any failure into a readable string so `handle()` never throws
+ * and aborts the agent run.
*
* @param callable(): string $callback
*/
@@ -76,8 +74,7 @@ abstract class FirecrawlTool implements Tool
}
/**
- * Trim tool output so a large page cannot overflow the model context
- * or the consumer's conversation storage.
+ * Trim tool output so large pages do not overflow the model context.
*/
protected function truncate(string $content, int $maxCharacters): string
{
diff --git a/apps/php-sdk/src/Laravel/Tools/FirecrawlTools.php b/apps/php-sdk/src/Laravel/Tools/FirecrawlTools.php
index 945d3d4f3..df0cbb574 100644
--- a/apps/php-sdk/src/Laravel/Tools/FirecrawlTools.php
+++ b/apps/php-sdk/src/Laravel/Tools/FirecrawlTools.php
@@ -11,8 +11,7 @@ final class FirecrawlTools
private function __construct() {}
/**
- * All core Firecrawl tools, ready to spread into an agent's tools() array:
- * `return [...FirecrawlTools::all()];`
+ * All core Firecrawl tools, ready to spread into an agent's tools() array.
*
* @return list<FirecrawlTool>
*/