laravel-prompt-renderer maintained by eloquage

PACKAGE
VERSIONS

Description

Configurable Blade prompt rendering for Laravel AI agents

Author

Miguel Enes

Last update

2026/10/23 16:47 (dev-main)

License

MIT

Links

Homepage - GitHub - Packagist

Downloads

Tags

laravel - eloquage - laravel-prompt-renderer

dev-main

Last update

2026/10/23 16:47

License

MIT

Require

php ^8.4
illuminate/contracts ^11.0||^12.0||^13.0
illuminate/database ^11.0||^12.0||^13.0
illuminate/support ^11.0||^12.0||^13.0
illuminate/view ^11.0||^12.0||^13.0
spatie/laravel-package-tools ^1.16

v1.0.3

Last update

2026/10/23 16:47

License

MIT

Require

php ^8.4
illuminate/contracts ^11.0||^12.0||^13.0
illuminate/database ^11.0||^12.0||^13.0
illuminate/support ^11.0||^12.0||^13.0
illuminate/view ^11.0||^12.0||^13.0
spatie/laravel-package-tools ^1.16

v1.0.2

Last update

2026/06/25 19:29

License

MIT

Require

php ^8.4
illuminate/contracts ^11.0||^12.0||^13.0
illuminate/database ^11.0||^12.0||^13.0
illuminate/support ^11.0||^12.0||^13.0
illuminate/view ^11.0||^12.0||^13.0
spatie/laravel-package-tools ^1.16

v1.0.1

Last update

2026/06/25 19:25

License

MIT

Require

php ^8.4
illuminate/contracts ^11.0||^12.0||^13.0
illuminate/database ^11.0||^12.0||^13.0
illuminate/support ^11.0||^12.0||^13.0
illuminate/view ^11.0||^12.0||^13.0
spatie/laravel-package-tools ^1.16

v1.0.0

Last update

2026/06/25 19:22

License

MIT

Require

php ^8.4
illuminate/contracts ^11.0||^12.0||^13.0
illuminate/database ^11.0||^12.0||^13.0
illuminate/support ^11.0||^12.0||^13.0
illuminate/view ^11.0||^12.0||^13.0
spatie/laravel-package-tools ^1.16

Comments

comments powered by Disqus

Laravel Prompt Renderer

Render Blade prompt templates through one API with Blade, database, cache, stack, or custom sources.

Requirements: PHP 8.4+ and Laravel 11, 12, or 13.

Installation

composer require eloquage/laravel-prompt-renderer

Publish config (optional):

php artisan vendor:publish --tag=prompt-renderer-config

Publish views (optional):

php artisan vendor:publish --tag=prompt-renderer-views

Publish migrations when using the database or cache drivers:

php artisan vendor:publish --tag=prompt-renderer-migrations
php artisan migrate

Usage

use Eloquage\LaravelPromptRenderer\PromptRenderer;

$prompt = app(PromptRenderer::class)->render('example', [
    'context' => 'document review',
]);

Templates are qualified with the configured namespace (prompts by default):

render('example') → prompts.example
render('evidence.ocr-vision') → prompts.evidence.ocr-vision

Prompt sources

Set the active source via PROMPT_RENDERER_SOURCE or config('prompt-renderer.default_source'):

Driver	Description
`blade`	Default. Resolves views from app paths, published overrides, then package stubs.
`database`	Loads Blade bodies from the `prompt_templates` table.
`cache`	Caches template contents from an underlying driver (default: `database`).
`stack`	Tries drivers in `config('prompt-renderer.stack')` order; first match wins.

Example stack configuration:

PROMPT_RENDERER_SOURCE=stack

'stack' => ['cache', 'database', 'blade'],

Laravel AI SDK

Use rendered prompts as agent instructions:

use Eloquage\LaravelPromptRenderer\PromptRenderer;
use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Promptable;

class ReviewAgent implements Agent
{
    use Promptable;

    public function __construct(private PromptRenderer $prompts) {}

    public function instructions(): string
    {
        return $this->prompts->render('example', [
            'context' => 'case review',
        ]);
    }
}

Custom drivers

use Eloquage\LaravelPromptRenderer\Contracts\PromptSource;
use Eloquage\LaravelPromptRenderer\Managers\PromptSourceManager;

PromptSourceManager::extend('redis', fn (): PromptSource => new RedisPromptSource());

Testing

composer test
composer analyse
composer format

License

MIT.