A circuit breaker
for AI agents

// npm i @proceedgate/node
import { createProceedGateClient, requireGateStepOk } from '@proceedgate/node';

const client = createProceedGateClient({
  apiKey: process.env.PG_KEY,
  actor:  { id: 'my-agent', project: 'my-workspace' },
});

// Before each agent action:
await requireGateStepOk(client, {
  policyId: 'retry_friction_v1',
  action:   'tool_call',
  context:  { attempt_in_window: 3, tool: 'web_scrape' },
});
// ✅ Throws ProceedGateFrictionError if blocked

// npm i @proceedgate/vercel-ai
import { generateText, wrapLanguageModel } from 'ai';
import { openai } from '@ai-sdk/openai';
import { proceedGateMiddleware } from '@proceedgate/vercel-ai';

const model = wrapLanguageModel({
  model:      openai('gpt-4o'),
  middleware: proceedGateMiddleware({
    apiKey:      process.env.PG_KEY,
    workspaceId: 'my-workspace',
    maxBudget:   5.00,   // $5 hard cap
    onFriction:  'block',
  }),
});

// Every call is now gated — zero other changes needed
const result = await generateText({ model, prompt: 'Analyze...' });

// npm i @proceedgate/langchain
import { ProceedGateCallbackHandler } from '@proceedgate/langchain';
import { ChatOpenAI } from '@langchain/openai';

const handler = new ProceedGateCallbackHandler({
  apiKey:      process.env.PG_KEY,
  workspaceId: 'my-workspace',
  onFriction:  'block',
});

// Attach to any LangChain model or chain
const model = new ChatOpenAI({ callbacks: [handler] });

// Tool wrapper also available:
// import { wrapToolWithGate } from '@proceedgate/langchain';

# pip install proceedgate-crewai
from proceedgate_crewai import BudgetAwareCrew, gated_tool
from crewai import Crew, Agent, Task

# Decorate any tool
@gated_tool(api_key="pg_ws_...", workspace_id="my-ws")
def search_web(query: str) -> str:
    return external_api(query)

# Or wrap the whole crew with a hard budget cap
crew = BudgetAwareCrew(
    crew=Crew(agents=[...], tasks=[...]),
    api_key="pg_ws_...", workspace_id="my-ws",
    max_budget=2.50,   # $2.50 hard stop
)
result = crew.kickoff(inputs={"topic": "BNB DeFi"})

# npm i -g @proceedgate/mcp-server

// claude_desktop_config.json — add ProceedGate as MCP server:
{
  "mcpServers": {
    "proceedgate": {
      "command": "proceedgate-mcp",
      "args": [
        "--api-key",      "pg_ws_...",
        "--workspace-id", "my-ws"
      ]
    }
  }
}

// Available MCP tools: gate_check · gate_redeem
//   get_balance · set_budget · get_usage_report