@aui-x/prism weekly downloads statistics

@auix/prism

LLM tracing SDK for auix — collect LLM traces with zero friction.

Supports Vercel AI SDK, OpenAI, Anthropic, and manual tracing.

Install

Peer dependencies (install only what you use):

• ai (>=6.0.0) + @ai-sdk/provider (>=2.0.0) — for AI SDK integration • openai (>=4.0.0) — for OpenAI integration • @anthropic-ai/sdk (>=0.30.0) — for Anthropic integration

Quick Start

AI SDK (recommended)

prismAISDK wraps any AI SDK model and automatically captures traces, token usage, latency, and tool calls. It creates a root trace internally and returns { model, end }:

Multi-step tool use is handled correctly — each LLM call becomes a child span under the root trace, and token usage is automatically aggregated:

OpenAI

prismOpenAI returns a proxied client that traces chat.completions.create calls:

Anthropic

prismAnthropic returns a proxied client that traces messages.create calls:

Manual Tracing

For full control over trace structure:

API

new AuixPrism(config)

| Option | Type | Default | Description |

| apiKey | string | required | Your auix API key | | baseUrl | string | "https://api.auix.dev" | API endpoint | | sessionId | string | — | Group traces under a session | | transport | (events) => Promise | — | Custom transport (bypasses HTTP) | | onFlushError | (error) => void | — | Called when flush fails after retry |

prismAISDK(tracer, model, options?)

Returns { model, end }. The model is a wrapped AI SDK model. Call end(opts?) after the generation completes to finalize the root trace.

| Option | Type | Description |

| name | string | Trace name (defaults to model ID) | | tags | string[] | Tags for filtering | | metadata | Record | Arbitrary metadata | | endUserId | string | End user identifier |

prismOpenAI(tracer, client, options?)

Returns a proxied OpenAI client. Same options as prismAISDK plus parentTraceId for nesting under an existing trace.

prismAnthropic(tracer, client, options?)

Returns a proxied Anthropic client. Same options as prismOpenAI.

tracer.startTrace(options)

Returns a TraceHandle for manual tracing.

trace.startSpan(options)

Creates a child span. type can be "llm", "tool", "retrieval", or "custom".

tracer.destroy()

Flushes pending events and stops the background timer. Call this when done tracing.

License

Proprietary — see LICENSE.