Maintainer overview of the provider registry, transformation pipeline, cache, and async path.
Flow
Transform path
Providers
Provider_Registry holds implementations of interface-provider.php:
| Class | Slug | Spec notes |
|---|---|---|
Plain_Text_Provider | plain-text | includes/format-specs/plain-text.md |
Apple_News_Provider | apple-news | includes/format-specs/apple-news.md |
Email_Provider | email | includes/format-specs/email-html.md |
Each provider exposes name, slug, output type, and availability checks.
Pipeline and cache
Transformation_Pipeline::transform( $post_id, $provider_slug, $force ) builds prompts, calls AI, and returns a Transformation_Result. Transformation_Cache stores results and status for later GET /status and GET /result.
Pass force to bypass cache. Async REST requests use Action_Scheduler_Handler when Action Scheduler is available.
AI experiment ability
includes/ai-experiment/ registers the Abilities API tool and optional experiment wiring. The ability runs the same pipeline synchronously and supports multisite site_id via platform AI utils.
Key files
| Path | Role |
|---|---|
includes/class-bootstrap.php | Loads providers, pipeline, REST, CLI, ability |
includes/pipeline/ | Pipeline, prompt builder, result |
includes/api/class-rest-controller.php | REST routes |
includes/cache/class-transformation-cache.php | Status and result cache |
includes/async/class-action-scheduler-handler.php | Queued transforms |
includes/cli/class-cli-command.php | wp prc content-transformer |