decodelabs/prophet

Stateless AI response orchestration

v0.6.2 2026-04-29 17:57 UTC

Requires

• php: ^8.4
• decodelabs/dictum: ^0.7
• decodelabs/exceptional: ^0.6.1
• decodelabs/kingdom: ^0.2
• decodelabs/slingshot: ^0.3

Requires (Dev)

• decodelabs/chorus: >0
• decodelabs/phpstan-decodelabs: ^0.7
• phpunit/phpunit: ^11.5

MIT

• Tom Wright

README

Stateless AI response orchestration

Prophet provides a small contract for blueprint-driven AI generation. A blueprint defines instructions, medium, default model, and subject input. A platform executes one request and returns the result immediately.

Installation

This package requires PHP 8.4 or higher.

Install via Composer:

composer require decodelabs/prophet

Usage

Core surfaces:

• DecodeLabs\Prophet for generator dispatch and direct response calls
• DecodeLabs\Prophet\Blueprint for instructions and subject input shaping
• DecodeLabs\Prophet\Platform for stateless provider adapters
• DecodeLabs\Prophet\GenerationOptions for runtime platform/model overrides
• DecodeLabs\Prophet\GenerationResult for normalized outputs
• DecodeLabs\Prophet\ModelCatalog for grouped provider/model option lists

OpenRouter support is available in the core package through DecodeLabs\Prophet\Platform\OpenRouter.

ModelCatalog can be used to build grouped select options and filter them down to whichever platforms are configured in the host app:

use DecodeLabs\Prophet\ModelCatalog;

$catalog = ModelCatalog::common()
    ->filterByPlatforms(['OpenAi', 'OpenRouter']);

$options = $catalog->toGroupedOptions();

Package-local docs and specs live under docs/.

Licensing

Prophet is licensed under the MIT License. See LICENSE for the full license text.