capell-app / ai-orchestrator
A shared AI capability registry and execution contract for Capell packages, designed for governed prompts, approvals, and package-owned AI workflows
Requires
- php: ^8.4
- capell-app/admin: ^0.0.4 || 0.0.x-dev
- capell-app/core: ^0.0.4 || 0.0.x-dev
- capell-app/layout-builder: ^0.0.4 || 0.0.x-dev
- lorisleiva/laravel-actions: ^2.8
- prism-php/prism: ^0.100
- spatie/laravel-data: ^4.5
- spatie/laravel-package-tools: ^1.14.1
This package is auto-updated.
Last update: 2026-07-11 19:58:40 UTC
README
What This Extension Adds
AI Orchestrator is an Available, No schema impact Capell package in the Capell Commercial product group. It ships as capell-app/ai-orchestrator and extends these surfaces: admin.
A shared AI capability registry and execution contract for Capell packages, designed for governed prompts, approvals, and package-owned AI workflows.
After install, admins get package-owned management or reporting surfaces inside Capell.
Status details:
- Status: Available
- Tier: premium
- Bundle: commercial
- Composer package:
capell-app/ai-orchestrator - Namespace:
Capell\AIOrchestrator - Theme key: not applicable
Why It Matters
For developers: The package gives developers package-owned service providers, Actions, Data objects, Filament classes, and Blade views instead of pushing this behaviour into core or application code.
For teams: A shared AI capability registry and execution contract for Capell packages, designed for governed prompts, approvals, and package-owned AI workflows.
Screens And Workflow
Screenshot contract: docs/screenshots.json.
- Capability list or prompt surface where provided by a consuming package (admin, optional).
- LayoutBuilder layout preview workflow if LayoutBuilder integration is enabled (admin, optional).
- Approval state where a capability requires review (admin, optional).
Technical Shape
- Service providers:
Capell\AIOrchestrator\Providers\AIOrchestratorServiceProvider. - Filament classes:
AIOrchestratorCapabilityCatalogPage. - Events:
AIOrchestratorCapabilityRunRecorded. - Actions:
ListAIOrchestratorCapabilitiesAction,RegisterAIOrchestratorModuleAction,RunAIOrchestratorCapabilityAction. - Data objects:
AIOrchestratorCapabilityData,AIOrchestratorRunData. - Manifest contributions:
admin-page: Capell\AIOrchestrator\Manifest\AiOrchestratorAdminPageContribution. - Health checks:
Capell\AIOrchestrator\Health\AiOrchestratorHealthCheck. - Blade views:
packages/ai-orchestrator/resources/views/filament/pages/capability-catalog.blade.php.
Data Model
This package has no schema impact. It does not declare package-owned migrations or required tables.
Docs gap: document extension points here if the package delegates persistence to a host package.
Install Impact
- Admin navigation: adds package-owned Filament classes when registered.
- Permissions: none declared in
capell.json. - Public routes: none detected in package route files.
- Database changes: no package migrations declared.
- Settings: no package settings declared.
- Queues or schedules: none detected in standard package paths.
- Cache tags: none declared.
- Commands: none declared.
Common Pitfalls
- Verify the package is installed before expecting its provider, views, or extension contributions to run.
- Keep
composer.json,composer.local.json,capell.json, docs, screenshots, and tests aligned when the package surface changes.
Troubleshooting
| Symptom | Likely cause | Check | Fix |
|---|---|---|---|
| Package surface is missing after install | Provider or manifest is not loaded | Confirm capell.json, package composer.json, and provider registration |
Reinstall the package, refresh Composer autoload, and clear host caches |
Quick Start
- Install the package:
composer require capell-app/ai-orchestrator. - Run the required setup: no package migrations are declared; clear cached config and routes if the host app uses caches.
- Open the related Capell admin surface and verify AI Orchestrator appears.
Next Steps
- Package docs
- Overview
- Screenshot contract
- Marketplace assets
- Capell content language plan
- Capell documentation design system
- Capell and package ERD notes
- Related packages: Layout Builder, Content Sections, Media Ai, Seo Suite, Translation Manager.
- Focused tests:
vendor/bin/pest packages/ai-orchestrator/tests --configuration=phpunit.xml.