Migrate to AI SDK 7

​

Compatibility

​

Migration steps

1. Upgrade Node.js to version 22 or newer.
2. Upgrade ai, provider packages, and React bindings to their AI SDK 7-compatible major versions.
3. Replace @contextcompany/otel with @contextcompany/ai-sdk in the application.
4. Replace registerOTelTCC with registerTCC.
5. Move experimental_telemetry.metadata into tccTelemetry, preserving every reserved tcc.* key.
6. Run a multi-step tool call and confirm its run, model steps, tool calls, usage, and metadata in The Context Company.

​

Registration

const { registerOTelTCC } = await import("@contextcompany/otel/nextjs");
registerOTelTCC();

const { registerTCC } = await import("@contextcompany/ai-sdk/nextjs");
registerTCC();

​

Per-call metadata

streamText({
  model,
  prompt,
  experimental_telemetry: {
    isEnabled: true,
    metadata: {
      "tcc.runId": runId,
      "tcc.sessionId": sessionId,
      environment: "production",
    },
  },
});

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

streamText({
  model,
  prompt,
  ...tccTelemetry({
    metadata: {
      "tcc.runId": runId,
      "tcc.sessionId": sessionId,
      environment: "production",
    },
  }),
});

​

Common AI SDK 7 API changes

• Use instructions instead of system when following the current text-generation API.
• Use isStepCount instead of stepCountIs.
• Use stable telemetry instead of experimental_telemetry.
• Put application tracking data in the tccTelemetry metadata object.
• Keep the tcc.* prefix on every TCC-specific metadata key.

​

Rollback