pip install sealvera

import openai, sealvera

sealvera.init(endpoint="https://app.sealvera.com", api_key="YOUR_KEY")

# Pass your configured client — SDK is detected automatically
openai_client = openai.OpenAI(api_key=os.environ["OPENAI_API_KEY"])
agent = sealvera.create_client(openai_client, agent="my-agent-name")

# Use exactly like the original — every call is now logged
response = agent.chat.completions.create(model="gpt-4o", messages=[...])

# Works for Anthropic too — SDK detected, thinking blocks extracted natively
import anthropic
uw_agent = sealvera.create_client(
    anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"]),
    agent="underwriter"
)

go get github.com/sealvera/sealvera-go

import sealvera "github.com/sealvera/sealvera-go"

sealvera.Init(sealvera.Config{
    Endpoint: "https://app.sealvera.com",
    APIKey:   "YOUR_KEY",
})

// One Agent per logical agent — equivalent to createClient() in JS/Python
fraudAgent := sealvera.NewAgent("fraud-screener")
uwAgent    := sealvera.NewAgent("loan-underwriter")

// Wrap your LLM call — provider declared per call
result, err := fraudAgent.WrapOpenAI(ctx, "screen_application", input,
    func() (any, error) {
        return openaiClient.Chat.Completions.New(ctx, params)
    },
)

// Include session_id in input — decisions link into traces automatically
input := map[string]any{"applicant_id": "APP-001", "session_id": caseID}

# Include session_id in inputs — SealVera links decisions
# from different agents into traces automatically

curl -X POST https://app.sealvera.com/api/ingest \
  -H "Content-Type: application/json" \
  -H "X-SealVera-Key: YOUR_KEY" \
  -d '{
    "agent": "loan-underwriter",
    "action": "evaluate_application",
    "decision": "APPROVED",
    "input": {
      "applicant_id": "A-4421",
      "amount": 25000,
      "session_id": "req_abc123"
    },
    "output": { "decision": "APPROVED", "confidence": 0.92 }
  }'

npm install sealvera @anthropic-ai/sdk

const SealVera = require('sealvera');
const Anthropic = require('@anthropic-ai/sdk');

SealVera.init({ endpoint: 'https://app.sealvera.com', apiKey: 'YOUR_KEY' });

// Pass your configured Anthropic client — SDK detected automatically
const anthropic = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
const agent = SealVera.createClient(anthropic, { agent: 'my-claude-agent' });

// Extended thinking chains are captured as native evidence automatically
const result = await agent.messages.create({
  model: 'claude-3-7-sonnet-20250219',
  max_tokens: 16000,
  thinking: { type: 'enabled', budget_tokens: 10000 },
  messages: [{ role: 'user', content: '...' }]
});

npm install sealvera

const SealVera = require('sealvera');
const { OpenAI } = require('openai');

SealVera.init({ endpoint: 'https://app.sealvera.com', apiKey: 'YOUR_KEY' });

// OpenRouter baseURL is detected automatically — no extra config
const openrouter = new OpenAI({
  baseURL: 'https://openrouter.ai/api/v1',
  apiKey: process.env.OPENROUTER_API_KEY,
});
const agent = SealVera.createClient(openrouter, { agent: 'my-agent' });

// Any model — GPT-4o, Claude, Llama — all logged, model name tracked per entry
const result = await agent.chat.completions.create({
  model: 'anthropic/claude-3-7-sonnet',
  messages: [...]
});

const SealVeraOpenClaw = require('./skills/sealvera/sealvera-openclaw');

const sealvera = new SealVeraOpenClaw({
  endpoint: 'https://app.sealvera.com',
  apiKey: 'YOUR_KEY',
  agent: 'my-openclaw-agent'
});

// Log every agent turn
await sealvera.captureAgentTurn({
  action: 'respond_to_user',
  decision: 'RESPONDED',
  input: { message: userMessage },
  output: { response: agentResponse },
  reasoning: 'User asked for status update. Queried DB and summarized.'
});

// Log tool calls
await sealvera.captureToolCall({
  toolName: 'web_search',
  params: { query: 'EU AI Act requirements' },
  result: { results: [...] }
});

// All turns are auto-linked into one trace per session

# ── OpenTelemetry Integration ──────────────────────────────
# No SDK needed — works with any language that supports OTel.
# Point your OTel exporter at SealVera:

OTEL_EXPORTER_OTLP_ENDPOINT=https://app.sealvera.com/api/otel
OTEL_EXPORTER_OTLP_HEADERS="X-SealVera-Key=YOUR_KEY"

# Required span attributes (add to your AI decision spans):
#   ai.agent    = "my-agent-name"          (agent identifier)
#   ai.action   = "evaluate_transaction"   (what the agent did)
#   ai.decision = "APPROVED"               (the decision made)
#   ai.input    = '{"amount": 1000}'       (JSON string — input data)
#   ai.output   = '{"decision":"APPROVED", "confidence": 0.94}'

# Optional span attributes:
#   ai.model     = "gpt-4o"               (model used)
#   ai.reasoning = "High score, low risk"  (reasoning text)
#   ai.reasoning_steps = '[{...}]'         (structured evidence, JSON)
#   ai.evidence_source = "native"          (evidence origin)

# Or send directly with curl:
curl -X POST https://app.sealvera.com/api/otel/v1/spans \
  -H "Content-Type: application/json" \
  -H "X-SealVera-Key: YOUR_KEY" \
  -d '{
    "resourceSpans": [{
      "resource": {"attributes": [
        {"key":"service.name","value":{"stringValue":"my-service"}}
      ]},
      "scopeSpans": [{"spans": [{
        "name": "ai.decision",
        "traceId": "optional-trace-id",
        "startTimeUnixNano": "1772000000000000000",
        "attributes": [
          {"key":"ai.agent","value":{"stringValue":"fraud-detector"}},
          {"key":"ai.action","value":{"stringValue":"evaluate"}},
          {"key":"ai.decision","value":{"stringValue":"FLAGGED"}},
          {"key":"ai.input","value":{"stringValue":"{\"amount\":50000}"}},
          {"key":"ai.output","value":{"stringValue":"{\"decision\":\"FLAGGED\",\"confidence\":0.91}"}}
        ]
      }]}]
    }]
  }'