Agent Delivery
Package docs status
Section titled “Package docs status”This page is generated from public package documentation in capell-4/packages and the package manifest checked into the source repository.
| Field | Value |
|---|---|
| Composer package | capell-app/agent-delivery |
| Package slug | agent-delivery |
| Product group | Capell Publishing Pro |
| Tier | premium |
| Bundle | publishing-pro |
| Runtime contexts | frontend |
| Capell version | ^4.0 |
| Source repository | capell-app/packages |
| Source path | packages/agent-delivery |
| Docs source | packages/agent-delivery/docs |
| Manifest | capell.json |
What This Plugin Adds
Section titled “What This Plugin Adds”Agent Delivery is an Available, No schema impact Capell package in the Capell Publishing Pro product group. It ships as capell-app/agent-delivery and extends these surfaces: frontend.
Serve your published Capell pages to AI agents and answer engines as clean, public-safe JSON manifests and RAG-ready semantic chunks - no scraping, no admin leakage.
After install, the package affects public rendering, public routes, or frontend runtime behaviour.
Status details:
- Status: Available
- Tier: premium
- Bundle: publishing-pro
- Composer package:
capell-app/agent-delivery - Namespace:
Capell\AgentDelivery - Theme key: not applicable
Why It Matters
Section titled “Why It Matters”For developers: The package gives developers package-owned service providers, Actions, Data objects, and Laravel routes instead of pushing this behaviour into core or application code.
For teams: Serve your published Capell pages to AI agents and answer engines as clean, public-safe JSON manifests and RAG-ready semantic chunks - no scraping, no admin leakage.
Screens And Workflow
Section titled “Screens And Workflow”Screenshot contract: docs/screenshots.json.
- Public page manifest JSON response (frontend, required).
- Public page chunks JSON response (frontend, required).
Technical Shape
Section titled “Technical Shape”- Service providers:
Capell\AgentDelivery\Providers\AgentDeliveryServiceProvider. - Config files:
packages/agent-delivery/config/capell-agent-delivery.php. - Route files:
packages/agent-delivery/routes/agent-delivery.php. - Actions:
AnalyzeAgentDeliveryChunkBudgetAction,BuildAgentDeliveryChunksAction,BuildAgentDeliveryPageAction,BuildAgentDeliveryPageIndexAction,ResolveAgentDeliveryPageAction. - Data objects:
AgentDeliveryChunkBudgetData,AgentDeliveryChunkData,AgentDeliveryPageData,AgentDeliveryPageIndexEntryData,ResolvedAgentDeliveryPageData. - Manifest contributions:
agent-capability: Capell\AgentDelivery\Manifest\AgentDeliveryContractsContribution,health-check: Capell\AgentDelivery\Health\AgentDeliveryHealthCheck,route: Capell\AgentDelivery\Manifest\AgentDeliveryRoutesContribution. - Health checks:
Capell\AgentDelivery\Health\AgentDeliveryHealthCheck. - Cache tags:
agent-delivery.
Data Model
Section titled “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
Section titled “Install Impact”- Admin navigation: no admin surface declared.
- Permissions: none declared in
capell.json. - Public routes: route files exist and must be reviewed before public enablement.
- Database changes: no package migrations declared.
- Settings: no package settings declared.
- Queues or schedules: none detected in standard package paths.
- Cache tags:
agent-delivery. - Commands: none declared.
Common Pitfalls
Section titled “Common Pitfalls”- Review route middleware, throttling, signed URLs, and public-output safety before exposing routes.
- Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
- Keep
composer.json,composer.local.json,capell.json, docs, screenshots, and tests aligned when the package surface changes.
Troubleshooting
Section titled “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 |
| 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 |
| Public output leaks unexpected state | Render data, cache variation, or authoring boundary has regressed | Check public Blade, cache tags, and public-output safety tests | Move data loading out of Blade and rerun the package public-output tests |
Quick Start
Section titled “Quick Start”- Install the package:
composer require capell-app/agent-delivery. - Run the required setup: no package migrations are declared; clear cached config and routes if the host app uses caches.
- Verify the package provider is registered and the related frontend, command, or extension point is active.
Next Steps
Section titled “Next Steps”- Package docs
- Overview
- Screenshot contract
- Marketplace assets
- Capell content language plan
- Capell documentation design system
- Capell and package ERD notes
- Related packages: Site Discovery.
- Focused tests:
vendor/bin/pest packages/agent-delivery/tests --configuration=phpunit.xml.