@contextcompany/ai-sdk

The Context Company observability integration for Vercel AI SDK 7.

pnpm add @contextcompany/ai-sdk ai @opentelemetry/api

For Next.js, register the integration from instrumentation.ts:

export async function register() {
  if (process.env.NEXT_RUNTIME === "nodejs") {
    const { registerTCC } = await import("@contextcompany/ai-sdk/nextjs");
    registerTCC();
  }
}

Add TCC metadata to each AI SDK call:

import { tccTelemetry } from "@contextcompany/ai-sdk";
import { streamText } from "ai";

const runId = crypto.randomUUID();
const result = streamText({
  model,
  prompt: "Hello",
  ...tccTelemetry({
    metadata: {
      "tcc.runId": runId,
      "tcc.agent": "support-agent",
      environment: "production",
    },
  }),
});

TCC-specific metadata always uses the tcc.* namespace inside metadata. Custom application metadata remains unprefixed.

Set TCC_API_KEY before starting your application. See the full guide at https://docs.thecontextcompany.com/frameworks/vercel-ai-sdk.