perplexity-upgrade-migration

# Perplexity Upgrade & Migration ## Current State !`npm list openai 2>/dev/null | grep openai || echo 'openai not installed'` !`pip show openai 2>/dev/null | grep Version || echo 'N/A'` ## Overview Guide for migrating between Perplexity model generations and API changes. Perplexity has evolved from pplx-api with third-party models to the Sonar family with built-in web search. ## Model Evolution | Era | Models | Status | |-----|--------|--------| | Legacy (pre-2025) | `pplx-7b-online`, `pplx-70b-online`, `llama-3.1-sonar-*` | Deprecated | | Current (2025) | `sonar`, `sonar-pro` | Active | | Extended (2025+) | `sonar-reasoning-pro`, `sonar-deep-research` | Active | ## Instructions ### Step 1: Identify Legacy Patterns to Update ```bash set -euo pipefail # Find deprecated model names in your codebase grep -rn "pplx-7b\|pplx-70b\|llama.*sonar\|sonar-small\|sonar-medium\|sonar-huge" \ --include="*.ts" --include="*.py" --include="*.js" --include="*.json" \ . 2>/dev/null || echo "No legacy models found" # Find old base URLs grep -rn "api.perplexity.com\|pplx.readme.io" \ --include="*.ts" --include="*.py" --include="*.js" \ . 2>/dev/null || echo "No legacy URLs found" ``` ### Step 2: Model Name Migration Map ```typescript // Migration map: old model name -> new model name const MODEL_MIGRATION: Record<string, string> = { // Legacy pplx-api models (fully deprecated) "pplx-7b-online": "sonar", "pplx-70b-online": "sonar-pro", "pplx-7b-chat": "sonar", "pplx-70b...