Package catalog

Every @agentback/* package and create-agentback, grouped by layer. Each package also ships its own README.md under packages/.

DI foundation

Package	Role
`@agentback/common`	Shared logging, env, ID, redaction, and async helper utilities
`@agentback/metadata`	Decorator metadata utilities (port of `@loopback/metadata`)
`@agentback/context`	DI container: `Context`, `Binding`, `@inject`, providers, interceptors (port of `@loopback/context`)
`@agentback/core`	`Application` (a `Context`), `Component`, `Server`, life-cycle (port of `@loopback/core`)

REST, MCP, and clients

Package	Role
`@agentback/http-server`	HTTP server with graceful stop (port of `@loopback/http-server`)
`@agentback/middleware`	Runtime-neutral middleware-chain machinery (Express-free; shared by `rest` + the Express host)
`@agentback/express`	Optional Express host (`ExpressService`, the LB middleware chain over `express`/`cors`)
`@agentback/openapi`	Zod-first decorators + OpenAPI 3.1.1 emission
`@agentback/rest`	REST server (Zod validation); `RestApplication`/`ExpressRestApplication` (Express) + `EdgeRestApplication` (fetch/Workers, no `express` install)
`@agentback/rest-explorer`	Mounts Swagger UI 5.x at `/explorer`
`@agentback/context-explorer`	Mounts a context/binding explorer UI
`@agentback/schema-explorer`	Mounts a schema/entity provenance explorer UI (REST + MCP + Drizzle); exports the graph as an OKF knowledge bundle (`buildOkfBundle`, Knowledge tab)
`@agentback/introspection`	Read-only MCP server exposing the live app (bindings/schema/routes/tools + OKF) to any agent via a selector surface (`inventory`/`get`/`get_okf_bundle`)
`@agentback/mcp`	Decorator-driven MCP server (`@mcpServer`, `@tool` w/ Zod input/output)
`@agentback/mcp-inspector`	Mounts an MCP inspector UI at `/mcp-inspector`
`@agentback/mcp-http`	Exposes the MCP server over Streamable HTTP at `/mcp` (+ OAuth, scopes)
`@agentback/mcp-client`	Connect to remote MCP servers over HTTP (OAuth-aware)
`@agentback/mcp-host`	Aggregate upstream MCP servers into one gateway
`@agentback/mcp-connect`	Persistent outbound MCP connections for browser/admin UIs
`@agentback/client`	Schema-shared typed HTTP client with no codegen

Platform components

Package	Role
`@agentback/config`	Zod-validated config loader with env overlays and DI bindings
`@agentback/security`	User, subject, and principal primitives
`@agentback/authentication`	Authentication decorator and strategy pipeline
`@agentback/authentication-jwt`	JWT bearer strategy
`@agentback/authentication-oauth2`	OAuth2 introspection and JWKS bearer-token strategies
`@agentback/authorization`	`@authorize` decorator and voter pipeline
`@agentback/extension-health`	Health/readiness probes
`@agentback/extension-metrics`	Prometheus `/metrics` endpoint and HTTP timing
`@agentback/extension-otel`	OpenTelemetry spans across REST, MCP, and jobs
`@agentback/extension-rate-limit`	In-memory or Redis-backed rate limiting
`@agentback/metering`	Per-principal REST/MCP usage events, audit sinks, and quota
`@agentback/payments`	x402/MPP/Stripe payment authorization and billing seams
`@agentback/messaging`	Zod-typed JobQueue/EventBus/Scheduler ports with in-memory adapter
`@agentback/messaging-bullmq`	BullMQ + Redis Streams durable adapter for messaging ports
`@agentback/actors`	Zod-typed actor runtime port — `@actor`/`@actorCommand`, per-identity serialized turns, idempotent replay, in-memory adapter
`@agentback/actors-redis`	Redis-backed actor runtime adapter — per-identity leases + atomic state/dedup commit
`@agentback/drizzle`	Drizzle ORM binding and drizzle-zod recipe
`@agentback/files`	`FileStore` port for uploads/downloads + in-memory adapter (the disk `FsFileStore` is the Node-only `@agentback/files/fs` subpath)
`@agentback/files-s3`	S3 `FileStore` adapter (streaming via AWS SDK v3)
`@agentback/files-sdk`	`FileStore` adapter over files-sdk — one port, 40+ storage backends (S3, R2, GCS, Azure, fs, …)
`@agentback/plugin`	Plugin discovery, gating, and component mounting
`@agentback/testing`	Test harness with typed REST client, supertest, and in-memory MCP
`@agentback/testlab`	Lower-level test helpers used by the package test suites
`create-agentback`	`npm create` scaffold for REST, MCP, and hybrid services
`@agentback/cli`	`agentback`/`abc` CLI — `deploy` to Vercel and Cloudflare Workers (bundle doctor + wrangler)
`@agentback/console`	Combined context, schema, REST/OpenAPI, and MCP admin console
`@agentback/console-theme`	Shared styling for console and explorer UIs
`@agentback/console-chat`	ACP agent dock for the console: see the live app + evolve source via a grounded coding-agent session (Node-host-only; off by default)