AIRspec is a portable JSON format for AI-generated dashboards and reports. A model writes the document; your application validates and renders it with trusted code. Nothing the model produces is ever executed.
The left side is the entire artifact the AI produces — declarative JSON, validated against a published schema.
The right side is yours: trusted components, your data broker, your authorization. Charts use
AIRMark, the spec's built-in mark-and-encoding grammar.
An AIRspec document cannot call an API, reference a URL, embed a credential, run a formula, or inject HTML. Those capabilities are structurally absent from the format — not merely discouraged. Every document passes five validation layers before a single pixel renders.
Any model, any provider. Structured output against the AIRspec JSON Schema, guided by your Source Catalog.
Schema, semantic, authorization, and AIRMark checks. Machine-readable errors let the model self-correct.
Trusted components interpret the layout tree. One broken component never takes down the report.
A server-side data broker executes stored datasets with the viewer's authorization. Credentials never leave the server.
Every element is declarative, allowlisted, and independently validated.
metaTitle, description, and tags for the report as users see it.
parametersDate ranges, selects, and toggles users adjust at run time — validated server-side.
datasetsLogical data requests by source and field name. Never a URL, never a query string.
layoutA responsive 12-column grid of trusted components — including charts, described in AIRMark, the spec's own mark-and-encoding grammar.
themePalette, density, and locale preferences — advisory, and always subordinate to your app's accessibility overrides.
interactionsDrilldowns, navigation to registered routes, and exports — from a fixed action vocabulary.
Each class is a superset of the last, so a Class A host can grow into AVI without breaking a single stored document.
Layout, text, metrics, tables, filters, and datasets. A complete working reporting system with no charting at all.
The foundationEverything in Core plus the AIRMark chart grammar — bars, lines, areas, arcs, layers, facets, and tooltips.
Adds chartsEverything in Visualization plus cross-component interactions: chart-to-filter drilldowns, record navigation, exports.
Adds interactionsValidators reject any document containing executable or addressable surface. There is no flag to turn these on.