dot-agent is a language and runtime for building deterministic, composable AI agents. Every agent is defined by two plain-text files — a manifest (agent.description) declaring identity, capabilities, and data contracts, and a behavior (agent.behavior) describing a finite-state machine that orchestrates LLM calls, tool invocations, and conversation flow. No hidden prompt sprawl, no implicit control flow: an agent's entire behavior is readable, versionable, and portable across runtimes.
This is the project's first public release. Every package below ships for real, for the first time, under npm's latest tag, on crates.io, and on the VS Code Marketplace — not a rehearsal, not a pre-release.
What v0.10.0 means
dot-agent tracks two independent version axes (see DA00-02): a DSL version, which is the language capability tier agent authors cite (v0.1, v0.2, … v1.0), and per-package versions, which move independently. At every public milestone the package tens digit mirrors the DSL version — 0.10.x is the packages' first public alignment with DSL v0.1: Conversational, the current milestone. v0.1 is a pure conversational state machine: structured dialogue, state routing, no side effects, no typed I/O yet. Typed data contracts and side-effecting execution (run) land in v0.2. The grammar stays in preview until v1.0, when it becomes a stability commitment.
Get started
npm install -g @dot-agent/cli
dot-agent init --name my-agent
dot-agent packOr install the VS Code extension for syntax highlighting, hover docs, and full language server support while you write .behavior/.description files.
Packages published in this release
| Package | Registry | Version |
|---|---|---|
@dot-agent/tree-sitter |
npm + crates.io | 0.10.0 |
@dot-agent/parser-dsl |
npm | 0.10.0 |
@dot-agent/kernel-dsl |
npm | 0.10.0 |
@dot-agent/compiler |
npm | 0.10.0 |
@dot-agent/sdk |
npm | 0.10.0 |
@dot-agent/language-server |
npm | 0.10.0 |
@dot-agent/cli |
npm | 0.10.0 |
vscode-dot-agent |
VS Code Marketplace + Open VSX | 0.10.0 |
Documentation
- Language reference — syntax and semantics of
.descriptionand.behavior - Architecture overview
- Roadmap — current milestone and what's next
- Canonical examples
License
Apache 2.0.