Problem/Motivation
Drupal entities — especially Layout Builder pages with nested paragraphs, inline blocks, and opaque third-party settings — are too complex for AI agents to manipulate through Drupal's internal APIs directly. There is no standard, clean JSON interface for reading and writing Drupal entities that an AI (or any external system) can use reliably.
Without this, AI agents must either:
- Navigate Drupal's deeply nested entity/field/plugin APIs, which require framework expertise an LLM does not have.
- Use REST/JSON:API, which serialize entities faithfully but do not provide a simplified, writable format or structured validation feedback suitable for AI round-trips.
- Attempt direct entity manipulation, risking silent data loss in Layout Builder's opaque settings (third_party_settings, additional, configuration) that the AI doesn't understand.
Proposed resolution
Create the Entity Blueprint module (entity_blueprint) — a standalone Drupal module providing bidirectional JSON entity serialization. The module introduces a "blueprint" JSON format that any fieldable entity can be serialized to and deserialized from.
Comments
Comment #3
tim bozeman commentedComment #7
tim bozeman commented