codex-flows/docs/pages/reference/packages.md

44 lines
1.4 KiB
Markdown

---
title: Packages
description: Public and workspace packages in the codex-flow stack.
---
# Packages
## `@peezy.tech/codex-flows`
Low-level Codex app-server client package. It exports:
- app-server JSON-RPC client and stdio/WebSocket transports
- browser-safe workspace backend client and protocol server primitives
- browser-safe WebSocket transport
- framework-agnostic app-server flow helpers
- auth helpers for account login/status/usage
- workbench reducers and request descriptors
- generated Codex app-server protocol types
## `@peezy.tech/flow-runtime`
Runtime package for:
- loading `flow.toml`
- discovering `.codex/flows/*` before `flows/*`
- matching events with trigger type and JSON Schema
- running Bun and gated Code Mode steps
- local and HTTP flow clients
- backend response normalization
## `@peezy.tech/flow-backend-convex`
Convex component for generic flow control-plane state: manifests, events, runs,
attempts, leases, output chunks, and final result payloads.
## Workspace apps
- `codex-flow-runner`: local CLI for listing, firing, and running steps.
- `codex-workspace-backend-local`: local workspace backend process with browser
control WebSocket and optional flow HTTP routes.
- [`codex-discord-bridge`](discord-bridge): Discord-to-Codex bridge with
workspace delegation and flow inspection tools.
- `web`: browser UI for Codex threads through the local workspace backend.
- `codex-app-cli`: JSON-RPC CLI for app-server actions.