feat(perplexity): deprecate chat completions clients

[andrewmadson-pplx]

Why

The Node Perplexity integration still presents Sonar Chat Completions as the primary path even though the plugin already includes an Agent API Responses client. Its Responses README example also passes the Chat Completions model name sonar-pro, while both legacy TypeScript entry points offer no actionable migration warning and the OpenAI compatibility helper defaults to a retired model.

What changed

• Make responses.LLM with perplexity/sonar the primary Perplexity README example.
• Document migration from the legacy plugin client and openai.LLM.withPerplexity().
• Add runtime warnings and TypeScript deprecation annotations to both legacy entry points.
• Restore withPerplexity() to the supported sonar-pro compatibility default and replace retired Perplexity model literals with current Sonar model IDs.
• Add regression coverage and update generated API reports and release metadata.

Behavior and scope

This is a soft deprecation. Explicit Sonar Chat Completions configurations continue to construct and now emit an actionable warning. The dedicated responses.LLM remains unchanged: it defaults to perplexity/sonar, uses https://api.perplexity.ai/v1, disables WebSocket transport, reads PERPLEXITY_API_KEY, and sends the LiveKit attribution header.

Coordinated Python change: livekit/agents#7069.

Coordinated Perplexity guide: ppl-ai/api-docs#807.

Tracking: Sonar to Agent migration, API-3590, and API-3389.

[changeset-bot]

🦋 Changeset detected

Latest commit: 1759a0a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 39 packages

Name	Type
@livekit/agents-plugin-openai	Patch
@livekit/agents-plugin-perplexity	Patch
@livekit/agents-plugin-anam	Patch
@livekit/agents-plugin-cartesia	Patch
@livekit/agents-plugin-cerebras	Patch
@livekit/agents-plugin-elevenlabs	Patch
@livekit/agents-plugin-fishaudio	Patch
@livekit/agents-plugin-google	Patch
@livekit/agents-plugin-hume	Patch
@livekit/agents-plugin-inworld	Patch
@livekit/agents-plugin-krisp	Patch
@livekit/agents-plugin-neuphonic	Patch
@livekit/agents-plugin-rime	Patch
@livekit/agents-plugin-sarvam	Patch
@livekit/agents-plugin-xai	Patch
@livekit/agents	Patch
@livekit/agents-plugin-anthropic	Patch
@livekit/agents-plugin-assemblyai	Patch
@livekit/agents-plugin-azure	Patch
@livekit/agents-plugin-baseten	Patch
@livekit/agents-plugin-bey	Patch
@livekit/agents-plugin-deepgram	Patch
@livekit/agents-plugin-did	Patch
@livekit/agents-plugin-hedra	Patch
@livekit/agents-plugin-lemonslice	Patch
@livekit/agents-plugin-liveavatar	Patch
@livekit/agents-plugin-livekit	Patch
@livekit/agents-plugin-minimax	Patch
@livekit/agents-plugin-mistral	Patch
@livekit/agents-plugin-mistralai	Patch
@livekit/agents-plugin-phonic	Patch
@livekit/agents-plugin-protoface	Patch
@livekit/agents-plugin-resemble	Patch
@livekit/agents-plugin-runway	Patch
@livekit/agents-plugin-silero	Patch
@livekit/agents-plugin-soniox	Patch
@livekit/agents-plugin-tavus	Patch
@livekit/agents-plugin-trugen	Patch
@livekit/agents-plugins-test	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}