Packages
Introduction
Section titled “Introduction”The kit is split into small packages so a host takes only the parts it needs. A hosted web app needs a server package and a few client packages. A mobile app needs only client packages. A desktop app adds a backend that runs on the user’s machine. Dependencies point one way: apps/* -> packages/* -> chat-protocol. See Packages and boundaries.
All packages
Section titled “All packages”| Package | Side | What it is for |
|---|---|---|
@pilotoo/server |
Server | The NestJS module: conversations, streaming, human-in-the-loop and persistence on PostgreSQL. |
@pilotoo/agent-runtime |
Server | Agent graph, tool and skill registries, and the ports for identity, knowledge, models and usage. |
@pilotoo/local-server |
Server | The same backend on SQLite, for a user’s own machine. |
@pilotoo/chat-protocol |
Both | The wire contract: commands, events and errors as Zod schemas. |
@pilotoo/chat-core |
Client | The environment-agnostic chat client: session, catalogs, stores, transport port. |
@pilotoo/ui |
Client | DOM React components and design tokens (Tailwind v4). |
@pilotoo/chat-ui |
Client | React Native chat components, also rendered on the web. |
@pilotoo/voice |
Client | Reading replies aloud and dictation, behind ports. |
@pilotoo/voice-native |
Client | Native speech engines for Tauri apps. |
Which ones do I need?
Section titled “Which ones do I need?”Hosted web app
Section titled “Hosted web app”A NestJS backend plus a React front end.
- Server:
@pilotoo/server(it brings@pilotoo/agent-runtimeand@pilotoo/chat-protocol). - Client:
@pilotoo/chat-coreand@pilotoo/ui.@pilotoo/uibrings@pilotoo/voice.
Mobile app
Section titled “Mobile app”An Expo / React Native app talking to a hosted backend.
- Client:
@pilotoo/chat-coreand@pilotoo/chat-ui. - Server: the hosted backend from the web setup. The mobile demo app depends on no other kit package.
Desktop app with a local backend
Section titled “Desktop app with a local backend”A Tauri shell that runs the backend on the user’s machine.
- Backend:
@pilotoo/local-server, started as a sidecar process. It brings@pilotoo/serverand@pilotoo/agent-runtime. - Front end: the same packages as the web app,
@pilotoo/chat-coreand@pilotoo/ui. - Optional:
@pilotoo/voice-nativefor on-device speech.
See Local backend.
Versioning
Section titled “Versioning”Changesets versions chat-protocol, chat-core, chat-ui, ui, agent-runtime, server and local-server as one fixed set: a release bumps them all to the same version. voice and voice-native are versioned on their own. No package is published to a registry yet; each page shows how to install from the repository.