Packages
PersistentAI is a pnpm monorepo. Each package is documented by its own README below; the full source for every package lives on GitHub. For day-to-day integration, the surfaces most developers touch are the executor client SDK and the types foundation.
| Package | What it is | |
|---|---|---|
| fireflow-types | Foundation — port system, decorators, base node classes, the flow & execution model | Docs |
| fireflow-nodes | The node library — 350+ typed, streaming-capable nodes across 30+ categories | Docs |
| fireflow-executor | The execution engine and the public client SDK for running flows and streaming events | Docs |
| fireflow-trpc | tRPC API layer — flow editing, execution, real-time subscriptions, database schema | Docs |
| fireflow-vfs | Virtual File System — lakeFS-backed versioned storage and the ff:// URI scheme | Docs |
| fireflow-agui | AG-UI protocol server — turns a flow execution into a streaming chat agent over SSE/WebSocket | Docs |
| fireflow-agui-react | React integration for AG-UI — provider, hooks, stores, optional CopilotKit bridge | Docs |
| fireflow-sandbox | Sandbox integration — isolated container execution of agent code as durable workflows | Docs |
| fireflow-search | Schema-aware search over the node registry, plus a generic list ranker | Docs |
For the complete generated type reference of the client SDK, see the Executor client reference.