v0.1.0

The initial release. Everything documented in the rest of this site is what landed here.

What's in

Three primitives. step, branch, loop. Typed I/O, tool support on step and loop, hard iteration cap on loop.

Two decorators. @agent for typed, traceable units with model and budget context. @tool for typed Python functions the model calls.

Seven wrappers. cache, retry, timeout, with_model, fallback, mock, log. Each takes a Call and returns a Call. Compose freely.

The trace. Nine event kinds, observers, JSON Lines and tree views. Every primitive emits structured events. See traces.

Cache backends. MemoryCache and FileCache. Pluggable via the CacheBackend protocol.

Anthropic adapter. bridle.models.anthropic.install() registers it. Driven by the ModelClient protocol so other adapters can land later.

Mock model client. bridle.models.mock.MockModelClient for tests — scripted responses or a callable factory.

Errors. A single hierarchy under BridleError: SchemaSatisfactionError, ToolExecutionError, ModelError, LoopExhaustedError, TimeoutError, ConfigurationError, TokenBudgetExceededError.

Token budgets. Soft per-agent cap via @agent(token_budget=...). Usage accumulates across model_response events.

What's not in

These are intentional v0.1 omissions, on the v0.2.0 roadmap:

• Async-first execution. v0.1 is sync. The Anthropic adapter does not stream.
• parallel primitive. Concurrent fan-out lands native to async.
• Multi-agent coordination. v0.1 is single-agent.
• Streaming primitives. Token-level streaming arrives with async.
• Redis cache backend. The class exists in bridle.cache.redis but raises on construction. Ships in v0.2.
• Sealed inner traces (seal=True on @agent).
• Model adapters beyond Anthropic. The ModelClient protocol is provider-neutral; only Anthropic ships in v0.1.
• Durable execution for long-running agents.

Install

pip install bridle-ai

Compatibility

• Python 3.11 or newer.
• Anthropic SDK is a required runtime dependency and installs alongside bridle-ai.

Migration

There's nothing to migrate from. v0.1.0 is the first public release.

Next