# Changelog

Human-readable release histories for the AML SDK, CLI, and Agent Sandbox image.
Canonical: https://agent-markup-language.com/docs/reference/changelog/
Documentation index: https://agent-markup-language.com/docs/
Complete documentation: https://agent-markup-language.com/docs/llms.txt

The changelog explains what changed and why. GitHub Releases remains the exhaustive release artifact and source-commit record; these pages turn that history into a shorter guide with links back into the documentation.

AML publishes the SDK, CLI, and Agent Sandbox image independently, so each artifact keeps its own version history.

- [SDK changelog](https://agent-markup-language.com/docs/reference/changelog/sdk/) — Runtime, primitives, providers, Sandboxes, and Workspaces.

- [CLI changelog](https://agent-markup-language.com/docs/reference/changelog/cli/) — Direct TypeScript and TSX workflow execution through the aml command.

- [Sandbox changelog](https://agent-markup-language.com/docs/reference/changelog/sandbox/) — The Debian runtime, installed Agents and tools, image contract, and release metadata.

## How entries are maintained

AML authors its own changelog with two repository-aware [`<Agent />`](https://agent-markup-language.com/docs/reference/primitives/agent/) trees. The first runs the authoritative commit collector, investigates the changes, and returns a typed draft. The second publishes that draft, then uses a [`<FollowUp />`](https://agent-markup-language.com/docs/reference/primitives/follow-up/) to review, correct, and format the entry.

The Docker image page is rendered directly from the image package's `CHANGELOG.md`, so an image release updates one
history rather than copying entries into the website.

[See the complete auto-authored changelog workflow →](https://agent-markup-language.com/docs/cookbook/changelog-maintainer/)