vibezcheckv0.3.0
llms.txt
Documentation/Core Concepts/Agent Circuit Breakers

Agent Circuit Breakers

Autonomous budget guardrails to protect against runaway recursive loops.

Agent Circuit Breakers

When building autonomous agents (loops, multi-step tool calls, subagents), unexpected infinite loops can drain hundreds of dollars in minutes.

`vibezcheck` includes built-in **Agent Circuit Breakers** that enforce hard financial ceilings at the inference layer.

---

Configuration Options

typescript
import { generateText } from 'ai';
import { vibezcheck } from 'vibezcheck';

const result = await generateText({
  model: vibezcheck('openai/gpt-4o', {
    customer: 'agent_runner_1',

    // 🛡️ Circuit Breaker 1: Hard cost ceiling per call
    maxCostPerCallUSD: 0.50,

    // 🛡️ Circuit Breaker 2: Token limit ceiling
    maxTokensPerCall: 15_000,

    // 🛡️ Circuit Breaker 3: Custom Trip Handler
    onBudgetExceeded: (event) => {
      console.warn(`⚠️ Circuit Breaker Tripped: ${event.message}`);
    },

    // 🛡️ Optional: Throw VibezCircuitBreakerError
    throwOnBudgetExceeded: true,
  }),
  prompt: 'Execute deep search over 500 documents...',
});

---

How It Works

1. During stream generation, `vibezcheck` calculates accumulating token counts and real-time USD costs. 2. If the threshold is crossed, `vibezcheck` halts execution immediately, preventing further provider token spend and alerting your backend.