Release channels
Match documentation to public npm packages, this repository, or a separately operated product.
Lucid packages use independent versions. “Version 3” of core does not imply that every extension or adapter is version 3, and a version in this repository does not prove that npm contains it.
Status contract
| Badge | Contract |
|---|---|
| Stable | Publicly installable npm surface verified from a clean external project. |
| Next | Current repository surface. It may be ahead of npm or not published. |
| Experimental | Implemented, but the API or support contract may change. |
| Deprecated | Historical migration context; do not use it for new projects. |
| Hosted product | Separately operated service with its own availability, authentication, and support. |
The badge belongs to a page, not a package name. A Stable tutorial names and tests exact public versions. A package reference marked Next describes the source and manifest in this checkout.
Package release table
Registry versions were read from npm on 22 July 2026.
| Package | Public npm | This repository | How to read its docs |
|---|---|---|---|
@lucid-agents/a2a | 1.0.1 | 1.0.1 | Protocol coverage remains version-scoped. |
@lucid-agents/analytics | 1.0.1 | 1.0.1 | Bound analytics over payment tracking. |
@lucid-agents/ap2 | 0.4.5 | 0.4.5 | AP2 extension; check its role and protocol boundaries. |
@lucid-agents/api-sdk | 4.1.0 | 4.1.0 | Client for the separately operated Hosted Lucid Platform. |
@lucid-agents/catalog | 1.0.1 | 1.0.1 | YAML/CSV catalog-driven entrypoints. |
@lucid-agents/cli | 4.1.0 | 4.1.0 | Current public scaffolder; older tutorials may remain deliberately pinned. |
@lucid-agents/core | 4.1.0 | 4.1.0 | Typed extension kernel and entrypoint registry. |
@lucid-agents/deploy | 0.1.0 | 0.1.0 | Guarded provider deployment tooling, not a runtime extension. |
@lucid-agents/express | 1.0.1 | 1.0.1 | Express adapter for the canonical route plan. |
@lucid-agents/hono | 1.0.1 | 1.0.1 | Hono adapter for the canonical route plan. |
@lucid-agents/http | 3.0.0 | 3.0.0 | HTTP handlers, authorization, discovery, streaming, and service UI. |
@lucid-agents/identity | 4.1.0 | 4.1.0 | ERC-8004 identity and trust. |
@lucid-agents/mpp | 2.0.0 | 2.0.0 | MPP challenge and credential verification runtime. |
@lucid-agents/payments | 4.1.0 | 4.1.0 | x402, SIWX, policy, settlement, and payment storage. |
@lucid-agents/scheduler | 0.3.1 | 0.3.1 | Leased, idempotent scheduled A2A calls. |
@lucid-agents/tanstack | 1.0.1 | 1.0.1 | TanStack Start runtime and handler adapter. |
@lucid-agents/types | 2.1.0 | 2.1.0 | Canonical shared protocol contracts. |
@lucid-agents/wallet | 0.6.5 | 0.6.5 | Wallet connectors and runtime. |
The installable Stable seller loop is narrower than the full table. It pins CLI, core, HTTP, payments, Hono, and direct x402 buyer dependencies in Install Lucid, then runs the paid transaction in a clean temporary project.
Do not assemble a channel package by package
Avoid this pattern:
latest core + repository payments + an older adapter + copied Next exampleExtension types and runtime contracts move together. Use one generated Stable set with a lockfile, or clone this repository and use its workspace and lockfile as the Next set. When a package must be upgraded independently, run its type checks plus the cross-package examples and HTTP/payment smoke tests before shipping.
Verify before copying an example
Check a public version:
npm view @lucid-agents/core version
npm view @lucid-agents/payments versionCheck the current repository set:
bun install --frozen-lockfile
bun run build:packages
bun run type-check
bun run test:docsIf a page's badge and the package you installed disagree, stop and select one channel. Do not silence the resulting type error with a cast.