feature #946 [Agent][Firecrawl] Add symfony/ai-firecrawl-tool (OskarStark)

This PR was squashed before being merged into the main branch.

Discussion
----------

[Agent][Firecrawl] Add `symfony/ai-firecrawl-tool`

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| Docs?         | yes
| Issues        | Follows #944
| License       | MIT

### Needs
- [ ] A new repo `symfony/ai-firecrawl-tool`
- [ ] Add Packagist configuration
- [ ] Create a new label `Firecrawl`
- [x] Create a recipe in `symfony/recipes`
- [ ] Merge the recipe symfony/recipes#1486

Commits
-------

02b2398e [Agent][Firecrawl] Add `symfony/ai-firecrawl-tool`

Author: OskarStark

src/Bridge/Firecrawl/.gitattributes

@@ -0,0 +1,3 @@
+/Tests export-ignore
+/phpunit.xml.dist export-ignore
+/.git* export-ignore

src/Bridge/Firecrawl/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+Please do not submit any Pull Requests here. They will be closed.
+---
+
+Please submit your PR here instead:
+https://github.com/symfony/ai
+
+This repository is what we call a "subtree split": a read-only subset of that main repository.
+We're looking forward to your PR there!

src/Bridge/Firecrawl/.github/close-pull-request.yml

@@ -0,0 +1,20 @@
+name: Close Pull Request
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: superbrothers/close-pull-request@v3
+      with:
+        comment: |
+          Thanks for your Pull Request! We love contributions.
+
+          However, you should instead open your PR on the main repository:
+          https://github.com/symfony/ai
+
+          This repository is what we call a "subtree split": a read-only subset of that main repository.
+          We're looking forward to your PR there!

src/Bridge/Firecrawl/.gitignore

@@ -0,0 +1,4 @@
+vendor/
+composer.lock
+phpunit.xml
+.phpunit.result.cache

src/Bridge/Firecrawl/CHANGELOG.md

@@ -0,0 +1,7 @@
+CHANGELOG
+=========
+
+0.1
+---
+
+ * Add the bridge

src/Toolbox/Tool/Firecrawl.php renamed to src/Bridge/Firecrawl/Firecrawl.php

@@ -9,7 +9,7 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Agent\Toolbox\Tool;
+namespace Symfony\AI\Agent\Bridge\Firecrawl;
 
 use Symfony\AI\Agent\Toolbox\Attribute\AsTool;
 use Symfony\Contracts\HttpClient\HttpClientInterface;

src/Bridge/Firecrawl/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025-present Fabien Potencier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

tests/Toolbox/Tool/FirecrawlTest.php renamed to src/Bridge/Firecrawl/Tests/FirecrawlTest.php

@@ -9,10 +9,10 @@
  * file that was distributed with this source code.
  */
 
-namespace Symfony\AI\Agent\Tests\Toolbox\Tool;
+namespace Symfony\AI\Agent\Bridge\Firecrawl\Tests;
 
 use PHPUnit\Framework\TestCase;
-use Symfony\AI\Agent\Toolbox\Tool\Firecrawl;
+use Symfony\AI\Agent\Bridge\Firecrawl\Firecrawl;
 use Symfony\Component\HttpClient\MockHttpClient;
 use Symfony\Component\HttpClient\Response\JsonMockResponse;
 
@@ -21,7 +21,7 @@ final class FirecrawlTest extends TestCase
     public function testScrape()
     {
         $httpClient = new MockHttpClient([
-            JsonMockResponse::fromFile(__DIR__.'/../../fixtures/Tool/firecrawl-scrape.json'),
+            JsonMockResponse::fromFile(__DIR__.'/fixtures/scrape.json'),
         ]);
 
         $firecrawl = new Firecrawl($httpClient, 'test', 'https://127.0.0.1:3002');
@@ -37,10 +37,10 @@ public function testScrape()
     public function testCrawl()
     {
         $httpClient = new MockHttpClient([
-            JsonMockResponse::fromFile(__DIR__.'/../../fixtures/Tool/firecrawl-crawl-wait.json'),
-            JsonMockResponse::fromFile(__DIR__.'/../../fixtures/Tool/firecrawl-crawl-status.json'),
-            JsonMockResponse::fromFile(__DIR__.'/../../fixtures/Tool/firecrawl-crawl-status-done.json'),
-            JsonMockResponse::fromFile(__DIR__.'/../../fixtures/Tool/firecrawl-crawl.json'),
+            JsonMockResponse::fromFile(__DIR__.'/fixtures/crawl-wait.json'),
+            JsonMockResponse::fromFile(__DIR__.'/fixtures/crawl-status.json'),
+            JsonMockResponse::fromFile(__DIR__.'/fixtures/crawl-status-done.json'),
+            JsonMockResponse::fromFile(__DIR__.'/fixtures/crawl.json'),
         ]);
 
         $firecrawl = new Firecrawl($httpClient, 'test', 'https://127.0.0.1:3002');
@@ -60,7 +60,7 @@ public function testCrawl()
     public function testMap()
     {
         $httpClient = new MockHttpClient([
-            JsonMockResponse::fromFile(__DIR__.'/../../fixtures/Tool/firecrawl-map.json'),
+            JsonMockResponse::fromFile(__DIR__.'/fixtures/map.json'),
         ]);
 
         $firecrawl = new Firecrawl($httpClient, 'test', 'https://127.0.0.1:3002');