Browse the documentation

AEL 1.0.0

JSON Schemas

These JSON Schemas describe the files that AEL, the Agent Engineering Language, works with: projects and lock files, package manifests, agent inputs and outputs, build and deployment descriptions, diagnostics and execution reports.

Every schema's address, its $id, is stable: a published address keeps working, so tools can refer to it safely. Each schema's version is part of its name. A schema marked draft may be replaced by a new schema at a new address; its own address keeps working.

AEL 1.0.0 projects use the files main.ael, pack.ael, metadata.ael and pack.lock, described in Project layout and the Manifest reference; pack.lock follows the package lock file schema. The two schemas marked superseded describe an earlier project format that those files replace; their addresses keep working, like every published schema's.

Agent input and output schemas are listed separately under Agent inputs and outputs.

SchemaAddress ($id) https://docs.ael.openeng.ai/schemas/
Agent descriptor Drafthttps://docs.ael.openeng.ai/schemas/agent-descriptor-v1-candidate.schema.json
Agent port value Drafthttps://docs.ael.openeng.ai/schemas/agent-port-value-v1-candidate.schema.json
Build receipthttps://docs.ael.openeng.ai/schemas/build-receipt-v0.schema.json
Build service messages Drafthttps://docs.ael.openeng.ai/schemas/engine-v0.schema.json
Build target descriptionhttps://docs.ael.openeng.ai/schemas/target-v0.schema.json
Component descriptorhttps://docs.ael.openeng.ai/schemas/component-v1.schema.json
Container manifest Drafthttps://docs.ael.openeng.ai/schemas/container-manifest-v1.schema.json
Container startup measurements Drafthttps://docs.ael.openeng.ai/schemas/container-startup-v1.schema.json
Execution environment capabilities Drafthttps://docs.ael.openeng.ai/schemas/execution-capability-v1.schema.json
Execution permissions Drafthttps://docs.ael.openeng.ai/schemas/execution-authority-v1.schema.json
Execution receipt Drafthttps://docs.ael.openeng.ai/schemas/execution-receipt-v1.schema.json
Execution report Drafthttps://docs.ael.openeng.ai/schemas/execution-report-v1.schema.json
Execution report channel Drafthttps://docs.ael.openeng.ai/schemas/execution-channel-v1.schema.json
Execution reporting permissions Drafthttps://docs.ael.openeng.ai/schemas/execution-reporting-authority-v1.schema.json
Execution reporting settings Drafthttps://docs.ael.openeng.ai/schemas/execution-reporting-v1.schema.json
Execution reporting shared types Drafthttps://docs.ael.openeng.ai/schemas/execution-reporting-types-v1.schema.json
Execution request Drafthttps://docs.ael.openeng.ai/schemas/execution-request-v1.schema.json
Execution result Drafthttps://docs.ael.openeng.ai/schemas/execution-result-v1.schema.json
Execution timing Drafthttps://docs.ael.openeng.ai/schemas/execution-timing-v1.schema.json
Execution usage accounting permissions Drafthttps://docs.ael.openeng.ai/schemas/execution-accounting-authority-v1.schema.json
Execution usage ledger Drafthttps://docs.ael.openeng.ai/schemas/execution-ledger-v1.schema.json
Execution worker report Drafthttps://docs.ael.openeng.ai/schemas/execution-worker-v1.schema.json
Host call messageshttps://docs.ael.openeng.ai/schemas/host-ipc-v0.schema.json
Microcontroller board descriptionhttps://docs.ael.openeng.ai/schemas/bsp-v0.schema.json
New project plan Drafthttps://docs.ael.openeng.ai/schemas/project-init-plan-candidate-v1.schema.json
Package lock file Drafthttps://docs.ael.openeng.ai/schemas/pack-lock-v1.schema.json
Package manifest Drafthttps://docs.ael.openeng.ai/schemas/pack-manifest-v1.schema.json
Package public interface Drafthttps://docs.ael.openeng.ai/schemas/package-role-interface-v1-candidate.schema.json
Package role catalog Drafthttps://docs.ael.openeng.ai/schemas/package-role-catalog-v1-candidate.schema.json
Package role catalog change Drafthttps://docs.ael.openeng.ai/schemas/package-role-transition-v1-candidate.schema.json
Package role catalog input Drafthttps://docs.ael.openeng.ai/schemas/package-role-catalog-input-v1-candidate.schema.json
Package role descriptor Drafthttps://docs.ael.openeng.ai/schemas/package-role-descriptor-v1-candidate.schema.json
Package role use Drafthttps://docs.ael.openeng.ai/schemas/package-role-use-v1-candidate.schema.json
Package trust policy Drafthttps://docs.ael.openeng.ai/schemas/pack-admission-v1.schema.json
Program graph layout Drafthttps://docs.ael.openeng.ai/schemas/graph-v1.schema.json
Project file (superseded)https://docs.ael.openeng.ai/schemas/project-v0.schema.json
Project lock file (superseded)https://docs.ael.openeng.ai/schemas/project-lock-v0.schema.json
Project metadata Drafthttps://docs.ael.openeng.ai/schemas/project-metadata-candidate-v1.schema.json
Project scenario Drafthttps://docs.ael.openeng.ai/schemas/source-scenario-v1.schema.json
Release measurement record Drafthttps://docs.ael.openeng.ai/schemas/release-evidence-v1.schema.json
Source diagnostichttps://docs.ael.openeng.ai/schemas/diagnostic-v1.schema.json
Source file interface Drafthttps://docs.ael.openeng.ai/schemas/source-owner-v1.schema.json
Source role declaration Drafthttps://docs.ael.openeng.ai/schemas/source-role-v1.schema.json
Toolchain versionshttps://docs.ael.openeng.ai/schemas/toolchain-v1.schema.json