Wizard

cd your-app
npx -y @voightxyz/sdk init

$ cd ~/projects/customer-support-saas
$ npx -y @voightxyz/sdk init

  Voight · init → /Users/jane/projects/customer-support-saas

  ✓ Detected providers: openai (^4.79.2) + @anthropic-ai/sdk (^0.96.0)
  ✓ Detected package manager: pnpm
  ✓ Detected framework: Next.js

  Privacy level for this project?

    1) Minimal · metadata only (tokens, latency, cost)
    2) Standard ★ Required for customer-facing apps — PII scrubbing on
    3) Full · raw, no scrubbing (debugging only)

  > 2

  ✓ Privacy: standard

  Now we need your Voight API key:
    1. Open  → https://voight.xyz/dashboard
    2. Sign in (Google / X / wallet)
    3. Settings → Generate key → copy the vk_… secret

  Paste it here: vk_aBcD…

  ✓ Validating key with api.voight.xyz…
  ✓ Key valid

  Agent name (defaults to "customer-support-saas")? production-chat-api

  ✓ Agent: production-chat-api

  ✓ Wrote src/lib/voight.ts
  ✓ Created .env.local with VOIGHT_KEY

  Use it in your handlers:

    // app/api/chat/route.ts
    import { openai, withTrace } from '@/lib/voight'

    export async function POST(req: Request) {
      return withTrace(
        async () => {
          const r = await openai.chat.completions.create({ ... })
          return Response.json({ reply: r.choices[0].message })
        },
        {
          routeTag: 'POST /api/chat',
          tags: { userId: 'user_123', plan: 'pro' },
        },
      )
    }

  One more step — install the wrappers:
    pnpm add @voightxyz/openai @voightxyz/anthropic

  Then open https://voight.xyz/dashboard/ai-apps

$ cd ~/projects/ai-chatbot
$ npx -y @voightxyz/sdk init

  Voight · init → /Users/jane/projects/ai-chatbot

  ✓ Detected providers: ai (^6.0.0) + openai (^4.79.2)
    (using the Vercel AI SDK path — covers both)
  ✓ Detected package manager: pnpm
  ✓ Detected framework: Next.js

  ✓ Privacy: standard
  ✓ Key valid
  ✓ Agent: production-chat-api

  ✓ Wrote instrumentation.ts
  ✓ Created .env.local with VOIGHT_KEY

  Activate telemetry on your existing calls:

    // app/api/chat/route.ts
    import { openai } from '@ai-sdk/openai'
    import { streamText } from 'ai'

    export async function POST(req: Request) {
      const result = streamText({
        model: openai('gpt-4o-mini'),
        prompt: (await req.json()).prompt,
        experimental_telemetry: {
          isEnabled: true,
          metadata: { userId: 'user_123', plan: 'pro' },
        },
      })
      return result.toAIStreamResponse()
    }

  Per-user attribution: anything you put in `metadata` shows up
  under `metadata.tags.*` in Voight — `userId` powers the Users sub-tab.

  One more step — install the Voight exporter:
    pnpm add @voightxyz/vercel-ai @vercel/otel

  Then open https://voight.xyz/dashboard/ai-apps

// ──────────────────────────────────────────────────────────────────
// Voight observability — generated by `npx @voightxyz/sdk init`
//
// Both wrapped clients use the standard `new OpenAI()` /
// `new Anthropic()` constructors, which read OPENAI_API_KEY and
// ANTHROPIC_API_KEY from process.env. This is the convention for
// most apps (the values typically live in .env / .env.local).
//
// If your provider keys come from elsewhere (AWS Secrets Manager,
// HashiCorp Vault, Doppler, a database, etc.), adjust the
// constructor calls below to pass the key explicitly, e.g.:
//
//   const openai = wrapOpenAI(
//     new OpenAI({ apiKey: await loadFromVault('openai') }),
//     { agent: 'production-chat-api', privacy: 'standard' }
//   )
//
// The Voight wrapper never sees the provider key — it wraps
// whatever client you construct.
// ──────────────────────────────────────────────────────────────────

import OpenAI from 'openai'
import Anthropic from '@anthropic-ai/sdk'
import { wrapOpenAI } from '@voightxyz/openai'
import { wrapAnthropic } from '@voightxyz/anthropic'

export const openai = wrapOpenAI(new OpenAI(), {
  agent: 'production-chat-api',
  privacy: 'standard',
})

export const anthropic = wrapAnthropic(new Anthropic(), {
  agent: 'production-chat-api',
  privacy: 'standard',
})

// Re-exports — import everything from one place.
export { withTrace, log } from '@voightxyz/openai'

// ──────────────────────────────────────────────────────────────────
// Voight observability — generated by `npx @voightxyz/sdk init`
//
// Registers the Voight OpenTelemetry exporter for every Vercel
// AI SDK call (streamText / generateText / streamObject /
// generateObject). To opt a call into observability, flip
// `experimental_telemetry: { isEnabled: true }` on it.
//
// For per-user attribution, pass a metadata bag:
//
//   experimental_telemetry: {
//     isEnabled: true,
//     metadata: { userId: session.user.id, plan: session.user.plan },
//   }
//
// The Voight exporter lifts `ai.telemetry.metadata.*` attributes
// onto `metadata.tags.*` so the dashboard Users sub-tab + per-tag
// filter pills populate automatically.
// ──────────────────────────────────────────────────────────────────

import { registerOTel } from '@vercel/otel'
import { VoightExporter } from '@voightxyz/vercel-ai'

export function register() {
  registerOTel({
    serviceName: 'production-chat-api',
    traceExporter: new VoightExporter({
      agent: 'production-chat-api',
      privacy: 'standard',
    }),
  })
}

npx -y @voightxyz/sdk init \
  --privacy=standard \
  --key=vk_aBcD... \
  --agent=production-chat-api