Carrying the torch: 48 community PRs merged + fork fixes (v0.101.0-v0.109.0)

.gitattributes

@@ -10,3 +10,5 @@
 /Taskfile.yml       export-ignore
 /testbench.yaml     export-ignore
 /whisky.json        export-ignore
+/dev                export-ignore
+/composer-require-checker.json export-ignore

.github/pull_request_template.md

@@ -1,4 +1,4 @@
-<!-- Please review our contributing guidelines https://github.com/prism-php/prism/blob/main/.github/CONTRIBUTING.md -->
+<!-- Please review our contributing guidelines https://github.com/Particle-Academy/prism/blob/main/.github/CONTRIBUTING.md -->
 ## Description
 
 ## Breaking Changes

.github/workflows/formatting.yml

@@ -7,6 +7,9 @@ on:
       - "*.x"
   pull_request:
 
+permissions:
+  contents: read
+
 env:
   phpv: 8.2
 

.github/workflows/phpstan.yml

@@ -7,6 +7,9 @@ on:
       - "*.x"
   pull_request:
 
+permissions:
+  contents: read
+
 env:
   phpv: 8.2
 

.github/workflows/require-checker.yml

@@ -0,0 +1,35 @@
+name: Require Checker
+
+on:
+  push:
+    branches:
+      - main
+      - "*.x"
+  pull_request:
+
+permissions:
+  contents: read
+
+env:
+  phpv: 8.2
+
+jobs:
+  require-checker:
+    name: composer-require-checker
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ env.phpv }}
+          coverage: none
+          tools: composer-require-checker
+
+      - name: Install composer dependencies
+        uses: ramsey/composer-install@v3
+
+      - name: Check declared dependencies match used symbols
+        run: composer-require-checker check --config-file=composer-require-checker.json composer.json

.github/workflows/tests.yml

@@ -7,6 +7,9 @@ on:
       - "*.x"
   pull_request:
 
+permissions:
+  contents: read
+
 jobs:
   test:
     runs-on: ${{ matrix.os }}
@@ -16,12 +19,9 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         php: [8.2, 8.3, 8.4]
-        laravel: [11.*, 12.*, 13.*]
+        laravel: [12.*, 13.*]
         stability: [prefer-lowest, prefer-stable]
         include:
-          - laravel: 11.*
-            testbench: 9.*
-            carbon: ^2.63
           - laravel: 12.*
             testbench: 10.*
             carbon: ^3.8.4

.gitignore

@@ -12,5 +12,6 @@ phpunit.xml
 ray.php
 CLAUDE.md
 .phpunit.result.cache
+AGENTS.md
 .ddev/
 .claude/

README.md

@@ -3,19 +3,30 @@
 </p>
 
 <p align="center">
-    <a href="https://packagist.org/packages/prism-php/prism">
-        <img src="https://poser.pugx.org/prism-php/prism/d/total.svg" alt="Total Downloads">
+    <a href="https://packagist.org/packages/particle-academy/prism">
+        <img src="https://poser.pugx.org/particle-academy/prism/d/total.svg" alt="Total Downloads">
     </a>
-    <a href="https://packagist.org/packages/prism-php/prism">
-        <img src="https://poser.pugx.org/prism-php/prism/v/stable.svg" alt="Latest Stable Version">
+    <a href="https://packagist.org/packages/particle-academy/prism">
+        <img src="https://poser.pugx.org/particle-academy/prism/v/stable.svg" alt="Latest Stable Version">
     </a>
-    <a href="https://packagist.org/packages/prism-php/prism">
-        <img src="https://poser.pugx.org/prism-php/prism/license.svg" alt="License">
+    <a href="https://packagist.org/packages/particle-academy/prism">
+        <img src="https://poser.pugx.org/particle-academy/prism/license.svg" alt="License">
     </a>
 </p>
 
 # Prism
 
+> [!IMPORTANT]
+> **This is the actively maintained [Particle Academy](https://github.com/Particle-Academy) fork of [`prism-php/prism`](https://github.com/prism-php/prism).**
+> Upstream has been unmaintained since March 2026; this fork continues development,
+> absorbing the community's outstanding fixes and features. The package is published
+> as **`particle-academy/prism`** (the `Prism\Prism` namespace is unchanged, so it is
+> a drop-in replacement):
+>
+> ```
+> composer require particle-academy/prism
+> ```
+
 Prism is a powerful Laravel package for integrating Large Language Models (LLMs) into your applications. It provides a fluent interface for generating text, handling multi-step conversations, and utilizing tools with various AI providers. This way, you can focus on developing outstanding AI applications for your users without getting lost in the technical intricacies.
 
 ## Official Documentation
@@ -28,7 +39,7 @@ While we aren't affiliated with Laravel, we follow the Laravel [Code of Conduct]
 
 ## Authors
 
-This library is created by [TJ Miller](https://tjmiller.me) with contributions from the [Open Source Community](https://github.com/prism-php/prism/graphs/contributors).
+This library is created by [TJ Miller](https://tjmiller.me) with contributions from the [Open Source Community](https://github.com/Particle-Academy/prism/graphs/contributors).
 
 ## License
 

composer-require-checker.json

@@ -0,0 +1,10 @@
+{
+    "symbol-whitelist": [
+        "Laravel\\Mcp\\Request",
+        "Laravel\\Mcp\\Response",
+        "Laravel\\Mcp\\ResponseFactory",
+        "Laravel\\Mcp\\Server\\Tool",
+        "Laravel\\Mcp\\Support\\ValidationMessages",
+        "PHPUnit\\Framework\\Assert"
+    ]
+}

composer.json

@@ -1,6 +1,6 @@
 {
-  "name": "prism-php/prism",
-  "description": "A powerful Laravel package for integrating Large Language Models (LLMs) into your applications.",
+  "name": "particle-academy/prism",
+  "description": "A powerful Laravel package for integrating Large Language Models (LLMs) into your applications. Actively maintained fork of prism-php/prism.",
   "type": "library",
   "license": "MIT",
   "autoload": {
@@ -20,7 +20,14 @@
   "require": {
     "php": "^8.2",
     "ext-fileinfo": "*",
-    "laravel/framework": "^11.0|^12.0|^13.0"
+    "ext-mbstring": "*",
+    "ext-openssl": "*",
+    "laravel/framework": "^12.61.1|^13.12.0",
+    "psr/http-message": "^1.1|^2.0",
+    "symfony/http-foundation": "^7.2|^8.0"
+  },
+  "suggest": {
+    "laravel/mcp": "Required to expose Prism tools through a Laravel MCP server (LaravelMcpTool)."
   },
   "config": {
     "allow-plugins": {
@@ -40,7 +47,7 @@
     "phpstan/phpstan-deprecation-rules": "^2.0",
     "rector/rector": "2.3.3",
     "projektgopher/whisky": "^0.7.0",
-    "orchestra/testbench": "^9|^10|^11",
+    "orchestra/testbench": "^10|^11",
     "mockery/mockery": "^1.6",
     "symplify/rule-doc-generator-contracts": "^11.2",
     "phpstan/phpdoc-parser": "^2.0",
@@ -49,6 +56,7 @@
   },
   "autoload-dev": {
     "psr-4": {
+      "Prism\\Dev\\": "dev/",
       "Tests\\": "tests/",
       "Workbench\\App\\": "workbench/app/",
       "Workbench\\Database\\Factories\\": "workbench/database/factories/",

config/prism.php

@@ -13,6 +13,7 @@
             'api_key' => env('OPENAI_API_KEY', ''),
             'organization' => env('OPENAI_ORGANIZATION', null),
             'project' => env('OPENAI_PROJECT', null),
+            'api_format' => env('OPENAI_API_FORMAT', 'responses'),
         ],
         'anthropic' => [
             'api_key' => env('ANTHROPIC_API_KEY', ''),
@@ -61,10 +62,44 @@
                 'x_title' => env('OPENROUTER_SITE_X_TITLE', null),
             ],
         ],
+        'replicate' => [
+            'api_key' => env('REPLICATE_API_KEY', ''),
+            'url' => env('REPLICATE_URL', 'https://api.replicate.com/v1'),
+            'webhook_url' => env('REPLICATE_WEBHOOK_URL', null),
+            'use_sync_mode' => env('REPLICATE_USE_SYNC_MODE', true), // Use Prefer: wait header
+            'polling_interval' => env('REPLICATE_POLLING_INTERVAL', 1000),
+            'max_wait_time' => env('REPLICATE_MAX_WAIT_TIME', 60),
+            // Hosts generated images may be auto-downloaded from (https only).
+            'download_hosts' => ['replicate.delivery'],
+        ],
+        'qwen' => [
+            'api_key' => env('QWEN_API_KEY', ''),
+            'url' => env('QWEN_URL', 'https://dashscope-intl.aliyuncs.com/api/v1'),
+        ],
+        'azure' => [
+            'url' => env('AZURE_AI_URL', ''),
+            'api_key' => env('AZURE_AI_API_KEY', ''),
+            'api_version' => env('AZURE_AI_API_VERSION', '2024-10-21'),
+            'deployment_name' => env('AZURE_AI_DEPLOYMENT', ''),
+        ],
+        'requesty' => [
+            'api_key' => env('REQUESTY_API_KEY', ''),
+            'url' => env('REQUESTY_URL', 'https://router.requesty.ai/v1'),
+            'site' => [
+                'http_referer' => env('REQUESTY_SITE_HTTP_REFERER', null),
+                'x_title' => env('REQUESTY_SITE_X_TITLE', null),
+            ],
+        ],
         'perplexity' => [
             'api_key' => env('PERPLEXITY_API_KEY', ''),
             'url' => env('PERPLEXITY_URL', 'https://api.perplexity.ai'),
         ],
+        'vertex' => [
+            'project_id' => env('VERTEX_PROJECT_ID', ''),
+            'region' => env('VERTEX_REGION', 'us-central1'),
+            'access_token' => env('VERTEX_ACCESS_TOKEN', null),
+            'credentials_path' => env('VERTEX_CREDENTIALS_PATH', null),
+        ],
         'z' => [
             'url' => env('Z_URL', 'https://api.z.ai/api/paas/v4'),
             'api_key' => env('Z_API_KEY', ''),

src/Rectors/ReorderMethodsRector.php → dev/Rectors/ReorderMethodsRector.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Prism\Prism\Rectors;
+namespace Prism\Dev\Rectors;
 
 use PhpParser\Node;
 use PhpParser\Node\Stmt;

docs/.vitepress/config.mts

@@ -113,6 +113,10 @@ export default defineConfig({
                 text: "Tool & Function Calling",
                 link: "/core-concepts/tools-function-calling",
               },
+              {
+                text: "Human-in-the-Loop",
+                link: "/core-concepts/human-in-the-loop",
+              },
               {
                 text: "Structured Output",
                 link: "/core-concepts/structured-output",
@@ -133,6 +137,14 @@ export default defineConfig({
                 text: "Audio",
                 link: "/core-concepts/audio",
               },
+              {
+                text: "Batch Processing",
+                link: "/core-concepts/batch",
+              },
+              {
+                text: "Files",
+                link: "/core-concepts/files",
+              },
               {
                 text: "Schemas",
                 link: "/core-concepts/schemas",
@@ -211,6 +223,14 @@ export default defineConfig({
                 text: "OpenRouter",
                 link: "/providers/openrouter",
               },
+              {
+                text: "Replicate",
+                link: "/providers/replicate",
+                text: "Qwen",
+                link: "/providers/qwen",
+                text: "Requesty",
+                link: "/providers/requesty",
+              },
               {
                 text: "Voyage AI",
                 link: "/providers/voyageai",

docs/components/ProviderSupport.vue

@@ -328,6 +328,19 @@ export default {
           documents: Supported,
           moderation: Unsupported,
         },
+        {
+          name: "Requesty",
+          text: Supported,
+          streaming: Supported,
+          structured: Supported,
+          embeddings: Unsupported,
+          image: Supported,
+          "speech-to-text": Unsupported,
+          "text-to-speech": Unsupported,
+          tools: Supported,
+          documents: Supported,
+          moderation: Unsupported,
+        },
         {
           name: "OpenAI",
           text: Supported,
@@ -341,6 +354,31 @@ export default {
           documents: Supported,
           moderation: Supported,
         },
+        {
+          name: "Qwen",
+          text: Supported,
+          streaming: Supported,
+          structured: Supported,
+          embeddings: Supported,
+          image: Supported,
+          "speech-to-text": Unsupported,
+          "text-to-speech": Unsupported,
+          tools: Supported,
+          documents: Unsupported,
+          moderation: Unsupported,
+        },
+        {
+          name: "Replicate",
+          text: Supported,
+          streaming: Supported,
+          structured: Supported,
+          embeddings: Supported,
+          image: Supported,
+          "speech-to-text": Supported,
+          "text-to-speech": Supported,
+          tools: Unsupported,
+          documents: Unsupported,
+        },
         {
           name: "VoyageAI",
           text: Unsupported,