traceshield-prela 0.2.0

Fire-and-forget trace ingestion SDK for TraceShield AI Agent Security

Prela SDK

Fire-and-forget trace ingestion SDK for TraceShield.

Installation

pip install prela

Quick Start

from prela import Prela

prela = Prela(
    api_key="ts_ingest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    endpoint="https://api.traceshield.example.com",
)

# Manual trace
prela.trace(
    input="What is my account balance?",
    output="I don't have access to account information.",
)

# OpenAI integration
from prela.integrations.openai import PrelaOpenAI
from openai import OpenAI

client = PrelaOpenAI(OpenAI(), prela)
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
)

# Before process exit
prela.shutdown()

Design

• Fire-and-forget: Never blocks the agent's response path
• Zero dependencies: Only requires httpx
• Batching: Buffers traces and sends every 500ms or 50 traces
• Resilient: Drops traces on failure, logs warnings, never raises

License

Private. All rights reserved.