cognesy / instructor-laravel

v2.10.0 2026-09-13 07:12 UTC

Requires

• php: ^8.3
• cognesy/agent-ctrl: ^2.8
• cognesy/agents: ^2.10
• cognesy/instructor-config: ^2.10
• cognesy/instructor-contracts: ^2.10
• cognesy/instructor-events: ^2.10
• cognesy/instructor-http-client: ^2.10
• cognesy/instructor-http-pool: ^2.10
• cognesy/instructor-messages: ^2.10
• cognesy/instructor-polyglot: ^2.10
• cognesy/instructor-struct: ^2.10
• cognesy/instructor-telemetry: ^2.10
• cognesy/instructor-utils: ^2.10
• cognesy/logging: ^2.3
• illuminate/console: ^10.0|^11.0|^12.0
• illuminate/contracts: ^10.0|^11.0|^12.0
• illuminate/database: ^10.0|^11.0|^12.0
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• mockery/mockery: ^1.6
• orchestra/testbench: ^8.0|^9.0|^10.0
• pestphp/pest: ^2.0|^3.0
• phpstan/phpstan: ^1.10

MIT

• Dariusz Debowczyk

• laravel
• ai
• machine-learning
• openai
• gpt
• llm
• claude
• anthropic
• structured-output
• instructor

Published on Packagist.org on 2026-09-13 07:16 UTC

README

Laravel integration for InstructorPHP.

It provides:

• Laravel service provider and config
• Facades for StructuredOutput, Inference, Embeddings, and AgentCtrl
• Laravel-specific HTTP client and HTTP pool drivers
• a Laravel-bound CanSendHttpRequests transport implementation
• native Cognesy\Agents container bindings, registry loading, and session runtime
• database-backed native agent sessions, broadcasting helpers, telemetry wiring, and logging presets
• testing fakes for facade-based tests and Laravel-native helper utilities for native agents
• Artisan commands for install, smoke-test, and response-model scaffolding

The package now treats native Cognesy\\Agents runtime configuration and AgentCtrl code-agent execution as separate Laravel surfaces:

• agents is reserved for native agent runtime integration
• agent_ctrl configures CLI code agents exposed through the AgentCtrl facade
• telemetry is the first-class config namespace for Laravel telemetry wiring

Example

<?php

use App\ResponseModels\PersonData;
use Cognesy\Instructor\Laravel\Facades\StructuredOutput;

$person = StructuredOutput::with(
    messages: 'John Smith is 30 years old',
    responseModel: PersonData::class,
)->get();

Documentation

• packages/laravel/docs/index.md
• packages/laravel/CHEATSHEET.md