Packages
Reference documentation for all Lucid Agents packages.
Lucid Agents is organized as a monorepo with packages across several categories:
Platform Client
Interact with the Lucid Agents Runtime API:
Foundation
@lucid-agents/types
Shared TypeScript type definitions
@lucid-agents/core
Protocol-agnostic agent runtime with extension system
Extensions
Optional capabilities you can add to your agent:
@lucid-agents/http
HTTP request/response handling and SSE streaming
@lucid-agents/payments
x402 payment protocol for monetizing agents
@lucid-agents/mpp
Machine Payments Protocol — multi-method payments via HTTP 402
@lucid-agents/catalog
YAML/CSV catalog-driven route generation for large product catalogs
@lucid-agents/identity
ERC-8004 on-chain identity and reputation
@lucid-agents/a2a
Agent-to-Agent protocol for discovery and communication
@lucid-agents/wallet
Wallet connectors for agent operations
@lucid-agents/ap2
Agent Payments Protocol extension
Framework Adapters
Integrate agents with your preferred web framework:
@lucid-agents/hono
Hono framework adapter
@lucid-agents/tanstack
TanStack Start adapter
@lucid-agents/express
Express framework adapter
Developer Tools
Architecture
┌─────────────────────────────────────────────────────────┐
│ Platform Client │
│ @lucid-agents/api-sdk │
│ (TypeScript client for Runtime API) │
└─────────────────────────────────────────────────────────┘
│
interacts with
│
▼
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
│ Lucid Runtime (hosted) │
│ ┌─────────────────────────────────────┐ │
│ │ Deployed Agents │ │
│ │ (built with packages below) │ │
│ └─────────────────────────────────────┘ │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
▲
deployed to
│
┌─────────────────────────────────────────────────────────┐
│ Developer Tools │
│ @lucid-agents/cli │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────┐
│ Framework Adapters │
│ hono │ tanstack │ express │ next │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────┐
│ Extensions │
│ http │ payments │ mpp │ catalog │ identity │ a2a │ wallet │ ap2 │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────┐
│ Core │
│ @lucid-agents/core │
└─────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────┐
│ Types │
│ @lucid-agents/types │
└─────────────────────────────────────────────────────────┘The api-sdk is a client for the hosted Lucid Runtime. The packages below are for building agents that get deployed to the runtime. Dependencies flow downward; HTTP is provided as an extension.