@runbit/core

The shared contract every Runbit package depends on. Almost never changes.

npm install @runbit/core

import { RunbitError, createState, consoleLogger } from "@runbit/core";
import type { Runnable, Context, Tool, RunbitEvent } from "@runbit/core";

Exports

• Runnable<In, Out> — the one interface everything shares: run(ctx, input).
• Context — what a run receives: runId, signal, emit, tools, state, log.
• RunbitEvent / Listener — the event shape (type, at, runId, data).
• Tool / ToolRegistry — tool interfaces (implementations live in @runbit/tool).
• RunbitError — one error type; messages explain exactly what happened.
• createState() — scoped key/value state for a run.
• consoleLogger() / silentLogger — minimal Loggers.

You usually get these re-exported from @runbit/runtime.

Part of Runbit — the AI Runtime. Everything executes through one small, event-driven runtime; agents, workflows, RAG, and observability are packages on top.

• Umbrella: @runbit/runtime
• License: MIT