@breadai/core

Core SDK for bread — a file-system-convention framework for building AI agents ("Next.js for agents"). Everything runtime lives here: the agent runner, tools, tasks, skills, loops, supervisors, pipelines, sessions, HITL checkpoints, permissions, hooks, and the BreadStore / BreadPlugin contracts. No HTTP, no CLI — bring your own ingress or use @breadai/server.

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

import { createBread, defineAgent } from '@breadai/core'
import { store } from '@breadai/store-memory'
import { z } from 'zod'

const echo = defineAgent({
  model: { provider: 'anthropic', model: 'claude-opus-4-8' },
  inputSchema: z.string(),
  outputSchema: z.string(),
  output: { format: 'text' },
})

const bread = createBread(
  { entrypoints: ['echo'], store: store() },
  new Map([['echo', echo]]),
)
await bread.start()

for await (const crumb of bread.run('echo', 'hello', { mode: 'stream' })) {
  if (crumb.type === 'text:delta') process.stdout.write(crumb.delta)
}

Key exports: defineAgent · defineTool · defineHumanTool · defineTask · defineConfig · createBread · runPipeline · runEvals · envProvider/vaultProvider (credentials) · BreadError · the BreadStore/BreadPlugin/BreadCrumb types.

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

License

MIT © Matteo Zambon