spec v1.0.0

The distributionstandard for agents

Describe, package, version, verify, and distribute AI agent artifactsas OCI artifacts. One canonical format for every runtime.

Read the docs
$npm i -g stax
terminal
$stax build
✓ artifact built — sha256:a3f8c1…e7d2
$stax push ghcr.io/acme/backend-engineer:3.1.0
↑ pushing 7 layers (12.4 KB)
$stax materialize ghcr.io/acme/backend-engineer:3.1.0
✓ materialized for claude-code — 9 files written
Think of it as

The packaging layer
agents never had

Containers became standard once there was a portable image format.Agents need the same thing. stax is that format.

OCI

Agent Artifacts

Immutable, content-addressed OCI artifacts containing an agent's full canonical brain.

NPM

Reusable Packages

Shared skill packs, MCP bundles, compliance rules, and knowledge packs.

HELM

Runtime Adapters

One artifact materializes into Claude Code, Codex, Cursor, Copilot, and more.

SIGSTORE

Trust & Policy

Signatures, attestations, approvals, and provenance via OCI referrers.

How it works

From source to runtime

Define your agent in TypeScript, build a deterministic artifact,push to any OCI registry, materialize into any runtime.

01
Define

TypeScript SDK — defineAgent(), definePackage(), definePersona()

02
Build

Deterministic OCI layers with typed media types and locked deps

03
Push

Publish to any OCI registry. Sign and attest with referrers.

04
Materialize

Translate to runtime-native files for any supported adapter.

Boundary principle

Carries what an agent is,
not how it runs

stax is intentionally not a runtime, orchestrator, or hosting platform.It is the distribution substrate those products build on.

stax carries

  • What an agent is and what bytes define it
  • What dependencies and packages it needs
  • What source context it expects
  • What secrets it declares
  • What runtime outputs it can materialize into
  • What trust and policy metadata is attached

Consumers own

  • Where the agent is scheduled
  • How many replicas it runs
  • What event starts it
  • How long it executes
  • What service mesh transports it
  • What cloud account hosts it
Documentation

Explore the standard

Everything you need to understand, adopt, and build with stax.