Skip to main content
Build agents and clients for Rebuno. The SDK is ESM-only, has no runtime dependencies, and needs Node 22 or later. See the Quickstart to install and run it.

​
What you write

You write one ordinary async function. Rebuno runs that handler for you. Route every non-deterministic effect through the kernel, which records the outcome. Three ways to do it:

defineTool

Records a tool_call step: actions the agent takes, such as a search, an email, or a database write.

rebunoFetch

Records an llm_call step: calls to an LLM provider.

step

Records a local step: local non-determinism such as the clock, a random choice, or a fresh id.
On a re-dispatch the handler runs again from the top. Any step with a recorded result replays it instead of running a second time.

​
Sections

Quickstart

Install, configure, and run a complete example.

Agents

The Agent host, input validation, serve vs fetch, and lifecycle.

Tools

defineTool, wrapTool, idempotency, blocking work, and MCP tools.

LLM calls

rebunoFetch and createRebunoFetch.

Steps

step() for durable local work.

Clients

Creating and inspecting executions, and approvals.

Errors

The error class hierarchy.

How it works

Step identity, replay, heartbeats, and the kernel protocol.