Agents Plugin

Governed agent runtime for Craft CMS and Craft Commerce.

Agents gives teams a stable, scoped API surface for agent integrations, plus sync-state/webhook reliability and clear CP operations for governed automation.

Current plugin version: 0.10.2

What This Plugin Provides

• Read + sync API surfaces:
  • /agents/v1/health
  • /agents/v1/readiness
  • /agents/v1/auth/whoami
  • /agents/v1/adoption/metrics
  • /agents/v1/metrics
  • /agents/v1/lifecycle
  • /agents/v1/diagnostics/bundle
  • /agents/v1/products
  • /agents/v1/variants, /agents/v1/variants/show
  • /agents/v1/subscriptions, /agents/v1/subscriptions/show
  • /agents/v1/transfers, /agents/v1/transfers/show
  • /agents/v1/donations, /agents/v1/donations/show
  • /agents/v1/orders, /agents/v1/orders/show
  • /agents/v1/entries, /agents/v1/entries/show
  • /agents/v1/assets, /agents/v1/assets/show
  • /agents/v1/categories, /agents/v1/categories/show
  • /agents/v1/tags, /agents/v1/tags/show
  • /agents/v1/global-sets, /agents/v1/global-sets/show
  • /agents/v1/addresses, /agents/v1/addresses/show (flag-gated)
  • /agents/v1/content-blocks, /agents/v1/content-blocks/show
  • /agents/v1/users, /agents/v1/users/show (flag-gated)
  • /agents/v1/changes
  • /agents/v1/sections
  • /agents/v1/sync-state/lag
  • /agents/v1/sync-state/checkpoint
  • /agents/v1/templates
  • /agents/v1/starter-packs
  • /agents/v1/schema
• Discovery docs:
  • /llms.txt
  • /llms-full.txt
  • /commerce.txt
  • Vendor agent handbook (Markdown): https://marcusscheller.com/docs/agents/agent-handbook.md
• API contract discovery:
  • /agents/v1/capabilities
  • /agents/v1/openapi.json
  • aliases: /capabilities, /openapi.json
• Webhook reliability surfaces:
  • signed webhook delivery with retries
  • per-key resource/action subscriptions
  • dead-letter queue visibility + replay (/agents/v1/webhooks/dlq*)
• Governed control-plane flows (feature-flagged):
  • policies
  • approvals (including two-person + SLA flows)
  • dry-run policy simulation
  • idempotent action execution
  • immutable audit trail
• Craft CP operations:
  • Dashboard tabs (Overview, Readiness, Discovery Docs, Security)
  • Settings (including editable llms.txt and commerce.txt custom bodies)
  • Agents (scopes, webhook subscriptions, TTL/reminder, IP allowlists, pause/resume)

Execution Model

• Production runtime actions are API-governed and policy-controlled, not shell-executed by agents.
• craft agents/* commands are for operator/developer workflows.
• Discovery docs (llms.txt, llms-full.txt, commerce.txt) are optional and public when enabled.
• Experimental control-plane execution surfaces remain behind PLUGIN_AGENTS_WRITES_EXPERIMENTAL.

See Execution Model for explicit trust-boundary and stability details.

Start Here

1. Installation & Setup
2. Configuration
3. Dashboard & Control Panel
4. API Overview
5. Agent Bootstrap
6. Starter Packs
7. Security