exa-upgrade-migration

# Exa Upgrade & Migration ## Current State !`npm list exa-js 2>/dev/null | grep exa-js || echo 'exa-js not installed'` !`npm view exa-js version 2>/dev/null || echo 'cannot check latest'` ## Overview Guide for upgrading the `exa-js` SDK. The SDK import is `import Exa from "exa-js"` and the client is instantiated with `new Exa(apiKey)`. This skill covers checking for updates, handling breaking changes, and validating after upgrade. ## Instructions ### Step 1: Check Current vs Latest Version ```bash set -euo pipefail echo "Current version:" npm list exa-js 2>/dev/null || echo "Not installed" echo "" echo "Latest available:" npm view exa-js version echo "" echo "Changelog:" npm view exa-js repository.url ``` ### Step 2: Create Upgrade Branch ```bash set -euo pipefail git checkout -b upgrade/exa-js-latest npm install exa-js@latest npm test ``` ### Step 3: Verify API Compatibility ```typescript import Exa from "exa-js"; async function verifyUpgrade() { const exa = new Exa(process.env.EXA_API_KEY); const checks = []; // Check 1: Basic search try { const r = await exa.search("upgrade test", { numResults: 1 }); checks.push({ method: "search", status: "OK", results: r.results.length }); } catch (err: any) { checks.push({ method: "search", status: "FAIL", error: err.message }); } // Check 2: searchAndContents try { const r = await exa.searchAndContents("upgrade test", { numResults: 1, text: { maxCharacters: 100 }, highlights:...