YADL Docs
YADL Docs
YADL documentation
Create your first visual
Use the YADL editorAdd icons, illustrations, logos, people, and backgroundsStart with templatesReuse visual components
Use the timelineAnimate a visual storyWork with audioPrepare a video frameExport an imageExport video
Manage your YADL accountPlans and billingNotifications
YADL source languageYADL syntax and capability referenceAI-safe YADL profileREST APIAPI keys and scopesAgent APIConnect YADL with MCP
Help and troubleshooting
Develop with YADL

AI-safe YADL profile

Use the constrained, certified YADL subset for dependable machine-authored explanatory visuals.

AI-safe YADL profile

ai-safe-yadl-v1 is a deliberately narrow profile for machine-authored YADL. It is not a replacement for the full syntax and capability reference: it selects the source forms that have canonical templates, deterministic validation, checked renderer frames, and explicit browser/export qualification commands.

Use this profile when

  • An integration needs predictable, editable explanatory visuals.
  • The source must be self-contained and safe to validate without resolving external dependencies.
  • A square 1080 × 1080, 30fps, ten-second MP4 is appropriate.

Start from one of the five canonical families: architecture, comparison, process flow, step-by-step, or timeline. They are stored as source-backed recipes, not public templates.

Allowed surface

  • One scene with one nested diagram and one timeline.
  • Text and element-card nodes, smooth-step edges, authored light branding, and fadeIn reveal actions.
  • At most 64 KB of source.
  • Explicit 1080 × 1080 export video configuration, 30fps MP4, and exactly ten seconds of story time.

Dependency boundary

The profile rejects imports, catalog dependencies, remote assets, and fonts other than the local recipe declaration of Arial. It also rejects charts, media, icons, reusable components, raw SVG, custom GSAP, narration, and presenter cues. Those may be valid full-language YADL, but are outside this certification.

Validate and certify

Validate a candidate source with:

pnpm agents:baseline:validate path/to/document.yadl

Run the deterministic profile gate with:

pnpm agents:ai-safe:check

That gate verifies the canonical source checksums, dependency boundary, semantic validation, headless renderer checkpoints, pinned runtime identity, and the generated browser language worker. Browser Pixi preview and real MP4 export remain explicit topology qualifications:

pnpm --filter @yadl/e2e test -- agent-baseline.spec.ts
node scripts/verify-agent-baseline-videos.mjs

The profile manifest and canonical recipe metadata are source-controlled in this repository. Use the Agent API for integration workflows and structured diagnostics.

YADL syntax and capability reference

Versioned reference for YADL grammar constructs and their editor, validation, preview, and export behavior.

REST API

Use the YADL REST API safely with owner-scoped authentication and the live OpenAPI reference.

On this page

AI-safe YADL profileUse this profile whenAllowed surfaceDependency boundaryValidate and certify