AI Creator

Package docs status

This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.

Field	Value
Composer package	`capell-app/ai-creator`
Package slug	`ai-creator`
Product group	Capell AI
Tier	premium
Bundle	`ai`
Runtime contexts	`admin`
Capell version	`^1.0`
Catalogue role	extension
Release channel	Beta
Source repository	`capell-app/packages`
Source path	`packages/ai-creator`
Docs source	`packages/ai-creator/docs`
Manifest	`capell.json`

What This Plugin Adds

AI Creator is an Available, Schema-owning Capell package in the Capell AI product group. It ships as capell-app/ai-creator and extends these surfaces: admin.

AI Creator adds reviewed creation sessions that turn a structured plain-language brief into a proposed Capell site, theme, and page plan.

Authorised administrators start a session in the AI Creator admin page, generate and inspect a private site preview, then complete a one-use confirmation before the reviewed site and pages are created.

Status details:

Status: Available
Tier: premium
Bundle: ai
Composer package: capell-app/ai-creator
Namespace: Capell\AiCreator
Theme key: not applicable

Why It Matters

For developers: Session planning, preview, package recommendation, and application are separate Actions, and Agent Bridge capabilities expose the same reviewed boundary to trusted clients.

For teams: Teams can review the private site plan and advisory package recommendations before an authorised administrator confirms creation.

Screens And Workflow

Screenshot contract: docs/screenshots.json.

AI Creator session preview (frontend, required evidence).
AI Creator Agent Bridge confirmation (frontend, required evidence).
AI Creator reviewed session detail (frontend, supplementary evidence).
AI Creator application result (frontend, supplementary evidence).
AI Creator validation failure (frontend, supplementary evidence).

Technical Shape

Service providers

Capell\AiCreator\Providers\AiCreatorServiceProvider

Migrations

packages/ai-creator/database/migrations/2026_06_22_000001_create_capell_ai_creator_sessions_table.php
packages/ai-creator/database/migrations/2026_07_15_000002_add_generation_state_to_capell_ai_creator_sessions_table.php
packages/ai-creator/database/migrations/2026_07_20_000003_create_capell_ai_creator_draft_operations_table.php
packages/ai-creator/database/migrations/2026_10_04_000001_remove_implicit_timestamp_updates_from_ai_creator.php

Models

AiCreatorDraftOperation
AiCreatorSession

Filament classes

AiCreatorPage

Route files

packages/ai-creator/routes/web.php

Listeners

BuildSiteFromInstalledSpecListener

Actions

AdaptManagedWebsiteGenerationForAppAction
ApplyAiCreatorSessionAction
BuildAiCreatorSessionPreviewAction
BuildAiCreatorSessionPreviewUrlAction
BuildAiCreatorSitePreviewAction
BuildAiCreatorSiteSpecPromptAction
BuildCapellSiteFromSpecAction
BuildManagedWebsiteGenerationRequestAction
BuildSiteFromSpecFileAction
BuildWebsiteGenerationArtifactAction
GetInterviewAction
ListLayoutsAction
ListPageTypesAction
ListSectionTypesAction
ListThemesAction
ValidateSiteSpecAction
ExportSiteAction
GenerateAiCreatorSiteSpecAction
GenerateDraftBlockContentAction
GenerateDraftPageFromPromptAction
GenerateDraftSeoMetadataAction
GenerateManagedWebsiteDraftAction
PreviewAiCreatorSessionAction
QueueAiCreatorSiteSpecGenerationAction
RecommendAiCreatorPackagesAction
SanitizeAiCreatorSectionHtmlAction
StartAiCreatorSessionAction

Data objects

AiCreatorPackageRecommendationData
AiCreatorPreviewData
AiCreatorStartSessionData
AppManagedSiteSpecGenerationData
DraftAuthoringResultData
GenerateDraftBlockContentData
GenerateDraftPageFromPromptData
GenerateDraftSeoMetadataData
GeneratedAiCreatorSiteSpecData
GeneratedWebsiteArtifactsData
ManagedWebsiteGenerationRequestData
ManagedWebsiteGenerationResultData
CapellSiteSpecColorsData
CapellSiteSpecData
CapellSiteSpecLanguageData
CapellSiteSpecPageData
CapellSiteSpecSectionData
CapellSiteSpecSiteData
CapellSiteSpecThemeData

Jobs

GenerateAiCreatorSiteSpecJob

Manifest contributions

admin-page: Capell\AiCreator\Manifest\AiCreatorAdminPageContribution
agent-capability: Capell\AiCreator\Manifest\AiCreatorAgentBridgeCapabilitiesContribution
health-check: Capell\AiCreator\Health\AiCreatorHealthCheck
migration: Capell\AiCreator\Manifest\AiCreatorMigrationsContribution
model: Capell\AiCreator\Manifest\AiCreatorModelsContribution
route: Capell\AiCreator\Manifest\AiCreatorPreviewRouteContribution

Health checks

Capell\AiCreator\Health\AiCreatorHealthCheck

Blade views

packages/ai-creator/resources/views/filament/pages/ai-creator.blade.php
packages/ai-creator/resources/views/session-preview.blade.php

Data Model

Required tables: capell_ai_creator_sessions, capell_ai_creator_draft_operations.
Models: AiCreatorDraftOperation, AiCreatorSession.
Core record references in migrations: sites via site_id, pages via page_id, users via user_id.
Migration files: 2026_06_22_000001_create_capell_ai_creator_sessions_table.php, 2026_07_15_000002_add_generation_state_to_capell_ai_creator_sessions_table.php, 2026_07_20_000003_create_capell_ai_creator_draft_operations_table.php, 2026_10_04_000001_remove_implicit_timestamp_updates_from_ai_creator.php.
Migration impact: run host migrations through the package install flow before opening package surfaces.
Deletion/retention behaviour: Docs gap: migrations and manifest contributions do not prove a cascade, pruning command, or timed retention policy.

Install Impact

Required packages: capell-app/admin, capell-app/agent-bridge, capell-app/ai-orchestrator, capell-app/core, capell-app/layout-builder, capell-app/theme-foundation.
Admin navigation: declares admin-page: AiCreatorAdminPageContribution; each Filament page or resource controls its own navigation visibility.
Admin/editor extensions: none declared.
Permissions: View:AiCreatorPage, Manage:AiCreatorPage.
Public routes: loads routes/web.php; registers AiCreatorPreviewRouteContribution.
Database changes: package migrations are declared.
Config: no package config files.
Settings: no package settings declared.
Queues or schedules: queue jobs GenerateAiCreatorSiteSpecJob.
Cache tags: none declared.
Commands: none declared.

Common Pitfalls

Keep required Capell packages on compatible v4 releases: capell-app/admin, capell-app/agent-bridge, capell-app/ai-orchestrator, capell-app/core, capell-app/layout-builder, capell-app/theme-foundation.
Run migrations before opening package resources or public routes.
Review middleware, throttling, signatures, and public-output safety in routes/web.php before exposing routes.

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
Admin screen or command fails on missing table	Package migrations have not run	Check the tables listed in `Data Model`	Run host migrations and rerun the focused package test
Route returns unexpected output	Route cache, middleware, or signed URL setup does not match the package route file	Check the route files listed in `Technical Shape`	Clear route cache and verify middleware before exposing public routes
Background work does not run	Queue worker or declared schedule is not active	Check the jobs and scheduled commands listed in `Technical Shape`	Start the queue worker or host scheduler, then run the focused command or package test

Quick Start

Install the package: composer require capell-app/ai-creator.
Open the package admin page or resource and verify AI Creator is available.