AI Agents Fail.
We Catch It.

import { FailSafe, Monitor, RecoveryStrategy } from '@failsafe/core';

// Initialize FailSafe with typed configuration
const fs = new FailSafe({
  monitors: [
    Monitor.HALLUCINATION,
    Monitor.SAFETY_VIOLATION,
    Monitor.CASCADE_FAILURE,
    Monitor.EXECUTION_TIMEOUT,
  ],
  recovery: RecoveryStrategy.AUTO,
  auditLog: './logs/failsafe.jsonl',
});

// Monitor any async function
const safeAgent = fs.wrap(async (query: string): Promise<string> => {
  const response = await llm.generate(query);
  return response.text;
});

// Custom recovery for specific failure types
fs.onFailure('hallucination', async (event) => {
  return await llm.generate(event.originalQuery, {
    temperature: 0.1,
    grounding: true,
  });
});

// Run with full protection
const result = await safeAgent('Analyze Q4 revenue trends');
console.log(result);

# Submit an agent action for analysis
$ curl -X POST https://api.failsafe.dev/v1/analyze \
  -H "Authorization: Bearer fs_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "support-agent-v2",
    "action": "generate_response",
    "input": "What is your return policy?",
    "output": "Our return policy allows...",
    "monitors": ["hallucination", "safety_violation"]
  }'

# Response
{
  "status": "pass",
  "failures_detected": 0,
  "monitors": {
    "hallucination": { "score": 0.02, "pass": true },
    "safety_violation": { "score": 0.00, "pass": true }
  },
  "latency_ms": 12
}

# Get failure analytics
$ curl https://api.failsafe.dev/v1/report?hours=24 \
  -H "Authorization: Bearer fs_live_..."