> For the complete documentation index, see [llms.txt](https://gotts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gotts.gitbook.io/docs/prd-shared/package-registry.md).

# Package Registry

> **Last Updated**: 2026-02-21 | **Referenced by**: monorepo/01-overview\.md, monorepo/11-primitive-packages.md, CLAUDE.md
>
> Single source of truth for every package in the Gotts monorepo. When package names, scopes, or ownership are referenced elsewhere, this document is authoritative.

***

## Published Packages

Distributed to npm under the `@gotts.ai` scope.

| Package                | Scope                   | Purpose                                                                                                              | PRD                                     |
| ---------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| `packages/cli`         | `@gotts.ai`             | Unified CLI — Commander subcommands for setup, safe, devenv, portal, testnet, install-mcp, config, doctor            | `prd/mcp-server/13-distribution.md`     |
| `packages/core`        | `@gotts.ai/core`        | Config I/O, error types, constants (zero deps)                                                                       | `prd/monorepo/11-primitive-packages.md` |
| `packages/wallet`      | `@gotts.ai/wallet`      | Wallet abstraction (Privy TEE + local key)                                                                           | `prd/monorepo/11-primitive-packages.md` |
| `packages/safe`        | `@gotts.ai/safe`        | Gotts Safe — unified MCP server for Uniswap (147 tools). Also used standalone in MCP client configs.                 | `prd/mcp-server/`                       |
| `packages/vault`       | `@gotts.ai/vault`       | Gotts Vaults — ERC-4626 vault SDK + Solidity contracts                                                               | `prd/vault/`                            |
| `packages/agent-proxy` | `@gotts.ai/agent-proxy` | Time-delay proxy SDK + contracts + monitoring bot                                                                    | `prd/vault/03-custody.md`               |
| `packages/testnet`     | `@gotts.ai/testnet`     | Generic EVM test toolkit (zero DeFi deps)                                                                            | `prd/devenv/06-testnet-package.md`      |
| `packages/gottsloop`   | `@gotts.ai/gottsloop`   | Cybernetic strategy daemon (Lane Queue, STRATEGY.md, three-tier model routing, plan→apply CLI, evolving PLAYBOOK.md) | `prd/agents/16-gottsloop.md`            |

## Internal Packages

Consumed only within the monorepo. No build step; TypeScript source imported directly via `exports`.

| Package                      | Scope                         | Purpose                                                     | PRD                                     |
| ---------------------------- | ----------------------------- | ----------------------------------------------------------- | --------------------------------------- |
| `packages/chain`             | `@gotts.ai/chain`             | ETH math, address utils, RPC client                         | `prd/monorepo/11-primitive-packages.md` |
| `packages/crypto`            | `@gotts.ai/crypto`            | P-256 key gen, signing, DER encoding                        | `prd/monorepo/11-primitive-packages.md` |
| `packages/policy`            | `@gotts.ai/policy`            | Privy policy builders + validators                          | `prd/monorepo/11-primitive-packages.md` |
| `packages/test-utils`        | `@gotts.ai/test-utils`        | Shared MSW handlers + test fixtures                         | `prd/monorepo/11-primitive-packages.md` |
| `packages/tui`               | `@gotts.ai/tui`               | Shared terminal UI primitives (spinner, box, logger, tasks) | `prd/shared/tui-package.md`             |
| `packages/devenv`            | `@gotts.ai/devenv`            | Local Uniswap testnet (Anvil + full protocol stack)         | `prd/devenv/`                           |
| `packages/portal`            | `@gotts.ai/portal`            | Agent management dashboard (wrapped by `gotts portal` CLI)  | `prd/website/portal/04-local-portal.md` |
| `packages/typescript-config` | `@gotts.ai/typescript-config` | Shared tsconfig bases (base, library, nextjs)               | `prd/monorepo/03-typescript.md`         |
| `packages/eslint-config`     | `@gotts.ai/eslint-config`     | Shared ESLint 10 flat config                                | `prd/monorepo/05-lint-format.md`        |
| `packages/ui`                | `@gotts.ai/ui`                | Shared React components + design tokens (design system)     | `prd/monorepo/07-frontend.md`           |

## Applications

| Package    | Purpose          | PRD                           |
| ---------- | ---------------- | ----------------------------- |
| `apps/web` | Next.js debug UI | `prd/monorepo/07-frontend.md` |

## Deprecated / Renamed Packages

| Old Name                       | New Name / Replacement       | Notes                                                                                          |
| ------------------------------ | ---------------------------- | ---------------------------------------------------------------------------------------------- |
| `packages/uniswap-mcp-server`  | `packages/safe`              | Renamed to reflect broader scope                                                               |
| `@gotts.ai/setup`              | `@gotts.ai/create`           | Renamed for npm `create-*` convention (itself now deprecated — see below)                      |
| `plugins/`                     | `packages/safe/skills/`      | Skills moved to owning package                                                                 |
| `@gotts.ai/create`             | `@gotts.ai` (`gotts setup`)  | Install wizard merged into unified CLI. `npx @gotts.ai setup` replaces `npx @gotts.ai/create`. |
| `@gotts.ai/portal` (published) | `@gotts.ai` (`gotts portal`) | Portal CLI access merged into unified CLI. Package stays internal at `packages/portal/`.       |

## Dependency Direction (Normative)

```
@gotts.ai/core         (zero workspace deps — config, errors, constants)
       │
       ├──────────────────────────┐
       ▼                          ▼
@gotts.ai/chain        @gotts.ai/crypto
(zero workspace deps)  (zero workspace deps)
       │                          │
       ▼                          │
@gotts.ai/policy       ──────────┘
(depends on chain)
       │
       ▼
@gotts.ai/wallet       (depends on core, chain, crypto, policy)
       │
       ├────────────────────┬────────────────────┐
       ▼                    ▼                    ▼
@gotts.ai/safe     @gotts.ai/vault     @gotts.ai/portal
       │                    │
       ▼                    ▼
@gotts.ai/testnet   @gotts.ai/agent-proxy
       │
       ▼
@gotts.ai/devenv   (adds Uniswap deployment on top of testnet)
       │
       ├────────────────────┐
       ▼                    ▼
@gotts.ai/vault    @gotts.ai/safe
       │
       └──────┬──────────────┘
              ▼
         @gotts.ai/ui  (shared components + design tokens)
              │
              ▼
          apps/web     (Next.js app)

@gotts.ai              (unified CLI — depends on core, tui; dynamic-imports safe, devenv, portal, testnet)
  ├── bundled:  @gotts.ai/core, @gotts.ai/tui
  └── dynamic:  @gotts.ai/safe, @gotts.ai/devenv, @gotts.ai/portal, @gotts.ai/testnet

@gotts.ai/tui          (depends on chain — terminal UI primitives)

@gotts.ai/gottsloop    (depends on @anthropic-ai/sdk, zod — leaf node, uses @gotts.ai/safe via MCP)

@gotts.ai/test-utils   (dev dependency only — not in production graph)
```

Circular dependencies are prohibited. The dependency graph MUST be a DAG.

> **Note on `@gotts.ai` dynamic imports**: The unified CLI uses `await import()` for heavy subcommand targets (safe, devenv, portal, testnet). These are listed as optional/peer dependencies in `package.json` and resolved at runtime. This keeps `gotts --help` and `gotts doctor` instant regardless of which packages are installed.

***

## AI Asset Ownership

Agents and skills are colocated with their owning package. No central directory, no symlinks, no setup script.

| Content                  | Location                 |
| ------------------------ | ------------------------ |
| Core agents (25)         | `packages/safe/agents/`  |
| Vault agents (7)         | `packages/vault/agents/` |
| Core skills (61)         | `packages/safe/skills/`  |
| Vault skills (7)         | `packages/vault/skills/` |
| Slash commands (68)      | `.claude/commands/`      |
| MCP config               | `.mcp.json` (repo root)  |
| Cross-cutting references | `prd/shared/`            |