@breadai/server

The reference HTTP ingress for bread: a Hono app serving agents, pipelines, sessions, loops, task runs, and HITL resume as SSE/JSON routes, plus the file-system loader (agents/<id>/agent.ts, prompt.md, tools/, skills/, tasks/) the CLI is built on. Importable as a library — you don't need the CLI to embed it.

bun add @breadai/server   # or: npm i @breadai/server

import { createServer, loadAgents, loadConfig, loadTasks } from '@breadai/server'

const config = await loadConfig(process.cwd())
const agents = await loadAgents(process.cwd(), config.entrypoints)
const { bread, app } = createServer(config, agents, await loadTasks(process.cwd()))
await bread.start()
// `app` is a Hono app — mount it yourself, or bind with startServer(config, agents).

startServer binds via Bun.serve. Bread applies no default auth posture — add one yourself via authPlugin(...) in config.plugins (see auth) if you want it. Errors reach clients as { code, message } only.

Part of bread — an explicit-by-design framework for AI agents. Docs: HTTP API · auth · all docs.

License

MIT © Matteo Zambon