pi-cursor-sdk 0.1.13 → 0.1.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.14 - 2026-05-18
+
+### Changed
+- Refreshed the Cursor fallback model snapshot and bundled default/non-Max context-window cache from the current `@cursor/sdk` 1.0.13 catalog, including Composer 2.5 (`composer-2.5` and `composer-2-5`) with default fast-mode support.
+- Updated README, demo, and maintainer model UX docs to use Composer 2.5 as the primary Composer example.
+
 ## 0.1.13 - 2026-05-18
 
 ### Fixed

package/README.md

@@ -21,7 +21,7 @@ pi install https://github.com/fitchmultz/pi-cursor-sdk
 2. Start pi with a Cursor model:
 
 ```bash
-pi --model cursor/composer-2
+pi --model cursor/composer-2.5
 ```
 
 3. In pi, run `/login`, choose `Use an API key`, choose `Cursor`, and paste your Cursor API key.
@@ -30,7 +30,7 @@ If pi started without a key, run `/cursor-refresh-models` after `/login` to refr
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 22.19+
 - pi
 - a Cursor API key saved through `/login`, available as `CURSOR_API_KEY`, or passed with pi's `--api-key`
 
@@ -64,7 +64,7 @@ For development from this repository:
 
 ```bash
 npm install
-pi -e . --model cursor/composer-2
+pi -e . --model cursor/composer-2.5
 ```
 
 ## Configure your Cursor API key
@@ -72,7 +72,7 @@ pi -e . --model cursor/composer-2
 Preferred setup:
 
 ```bash
-pi --model cursor/composer-2
+pi --model cursor/composer-2.5
 ```
 
 Then, inside pi:
@@ -89,13 +89,13 @@ Environment setup:
 
 ```bash
 export CURSOR_API_KEY="your-key"
-pi --model cursor/composer-2
+pi --model cursor/composer-2.5
 ```
 
 One-shot setup:
 
 ```bash
-pi --api-key "your-key" --model cursor/composer-2 --cursor-no-fast -p "Say ok only."
+pi --api-key "your-key" --model cursor/composer-2.5 --cursor-no-fast -p "Say ok only."
 ```
 
 Discovery uses pi's native resolution order for this extension: `--api-key`, the stored `cursor` key in `~/.pi/agent/auth.json`, then `CURSOR_API_KEY`.
@@ -118,7 +118,7 @@ Expected behavior:
 Smoke test:
 
 ```bash
-pi --model cursor/composer-2 --cursor-no-fast -p "Reply with: ok"
+pi --model cursor/composer-2.5 --cursor-no-fast -p "Reply with: ok"
 ```
 
 ## Choosing a model
@@ -126,7 +126,7 @@ pi --model cursor/composer-2 --cursor-no-fast -p "Reply with: ok"
 Choose Cursor models interactively with `/model`, or pass a model on the command line:
 
 ```bash
-pi --model cursor/composer-2
+pi --model cursor/composer-2.5
 pi --model cursor/gpt-5.5@1m
 pi --model cursor/gpt-5.5@272k
 pi --model cursor/claude-opus-4-7@300k
@@ -180,10 +180,10 @@ For one run, force fast on or off without changing saved defaults:
 
 ```bash
 pi --model cursor/gpt-5.5@1m --cursor-fast -p "Say ok only"
-pi --model cursor/composer-2 --cursor-no-fast -p "Say ok only"
+pi --model cursor/composer-2.5 --cursor-no-fast -p "Say ok only"
 ```
 
-`composer-2` can default to fast. Use `--cursor-no-fast` for a one-shot no-fast `composer-2` run. In print mode (`-p`), `--cursor-no-fast` is silent and does not write `~/.pi/agent/cursor-sdk.json`.
+Composer 2 and Composer 2.5 can default to fast. Use `--cursor-no-fast` for a one-shot no-fast Composer run. In print mode (`-p`), `--cursor-no-fast` is silent and does not write `~/.pi/agent/cursor-sdk.json`.
 
 In interactive mode, the footer only shows fast mode when fast is enabled:
 
@@ -199,14 +199,11 @@ Images from the latest user message are forwarded to Cursor. Historical images a
 
 ## Fallback models
 
-If no key is available from `/login`, `CURSOR_API_KEY`, or `--api-key`, model discovery fails, or discovery returns no models, the extension registers conservative fallback Cursor models and notifies interactive users when possible:
+If no key is available from `/login`, `CURSOR_API_KEY`, or `--api-key`, model discovery fails, or discovery returns no models, the extension registers a bundled fallback snapshot of the latest reviewed Cursor SDK model catalog and notifies interactive users when possible.
 
-- `composer-2`
-- `gpt-5.5@1m`, `gpt-5.5@272k`
-- `claude-sonnet-4-6@1m`, `claude-sonnet-4-6@200k`
-- `claude-opus-4-7@1m`, `claude-opus-4-7@300k`
+The fallback snapshot includes Composer 2.5 (`composer-2.5` and `composer-2-5`), Composer 2, GPT, Claude, Gemini, Grok, Kimi, and other model IDs exposed by the reviewed `Cursor.models.list()` output. The exact checked-in snapshot lives in `src/cursor-fallback-models.generated.ts`.
 
-Fallback models are a conservative startup model list. Actual Cursor runs still need a key from `/login`, `CURSOR_API_KEY`, or `--api-key`. If you add auth after startup, run `/cursor-refresh-models` to refresh the full live Cursor model catalog without restarting pi.
+Actual Cursor runs still need a key from `/login`, `CURSOR_API_KEY`, or `--api-key`. If you add auth after startup, run `/cursor-refresh-models` to refresh the full live Cursor model catalog without restarting pi.
 
 ## Limits
 
@@ -229,13 +226,13 @@ You can also restart pi with a key in the same shell or launcher that starts pi:
 
 ```bash
 export CURSOR_API_KEY="your-key"
-pi --model cursor/composer-2
+pi --model cursor/composer-2.5
 ```
 
 Or run a one-shot command:
 
 ```bash
-pi --api-key "your-key" --model cursor/composer-2 -p "Say ok only"
+pi --api-key "your-key" --model cursor/composer-2.5 -p "Say ok only"
 ```
 
 ### `pi --list-models cursor` shows no Cursor models
@@ -273,7 +270,7 @@ Cursor SDK local agents load MCP servers from Cursor setting sources and inline
 Cursor native replay is a UI enhancement for interactive TTY sessions. If another extension already owns `read`, `bash`, `ls`, `cursor_edit`, or `cursor_write`, this extension skips only the conflicting native replay wrapper and uses the scrubbed Cursor activity transcript for that tool instead. To disable Cursor native replay registration entirely, start pi with:
 
 ```bash
-PI_CURSOR_NATIVE_TOOL_DISPLAY=0 pi --model cursor/composer-2
+PI_CURSOR_NATIVE_TOOL_DISPLAY=0 pi --model cursor/composer-2.5
 ```
 
 `PI_CURSOR_REGISTER_NATIVE_TOOLS=0` is also accepted as a registration-only opt-out.
@@ -306,7 +303,7 @@ Local development run:
 
 ```bash
 npm install
-CURSOR_API_KEY="your-key" pi -e . --model cursor/composer-2
+CURSOR_API_KEY="your-key" pi -e . --model cursor/composer-2.5
 ```
 
 Maintainer design notes live in [`docs/cursor-model-ux-spec.md`](docs/cursor-model-ux-spec.md).

package/docs/cursor-model-ux-spec.md

@@ -149,7 +149,7 @@ cursor/gpt-5.5@1m
 cursor/gpt-5.5@272k
 cursor/claude-opus-4-7@1m
 cursor/claude-opus-4-7@300k
-cursor/composer-2
+cursor/composer-2.5
 ```
 
 Avoid colon-based context IDs in the first implementation unless this spec is intentionally changed:
@@ -428,7 +428,7 @@ Use Cursor default variants:
 
 ```text
 gpt-5.5 -> cursor/gpt-5.5@1m, thinking medium, fast=false
-composer-2 -> cursor/composer-2, fast=true
+composer-2.5 -> cursor/composer-2.5, fast=true
 ```
 
 ### Resume Session
@@ -492,7 +492,7 @@ These examples document the capability shapes the extension handles, not an exha
 | Example model shape | Cursor controls | Pi representation |
 |---|---|---|
 | plain model, such as `default` or models with no exposed controls | none | plain model |
-| `composer-2`-style model | fast | plain model + fast extension state |
+| Composer-style model such as `composer-2.5` or `composer-2` | fast | plain model + fast extension state |
 | GPT-style reasoning model with context variants | context, reasoning, fast when exposed | context variants + native thinking + optional fast state |
 | Claude-style thinking model with context variants | thinking, context, effort when exposed | context variants + native thinking + optional fast state |
 | Claude-style thinking model without context variants | thinking and/or effort | plain model + native thinking |
@@ -504,12 +504,12 @@ If Cursor later adds `fast`, `context`, `reasoning`, `effort`, or aliases to a m
 
 ## Detailed Examples
 
-### `composer-2`
+### Composer 2 / 2.5
 
-Initial Cursor default:
+Initial Cursor default for Composer 2.5:
 
 ```text
-pi model: cursor/composer-2
+pi model: cursor/composer-2.5
 Cursor params: fast=true
 pi thinking: off
 Cursor status: cursor fast

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cursor-sdk",
-	"version": "0.1.13",
+	"version": "0.1.14",
 	"description": "pi provider extension backed by @cursor/sdk local agents",
 	"author": "Mitch Fultz (https://github.com/fitchmultz)",
 	"license": "MIT",

package/src/bundled-context-windows.ts

@@ -1,14 +1,16 @@
-// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on 2026-05-04.
+// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on 2026-05-18.
+// Refresh with: npm run refresh:cursor-snapshots -- --write --context-windows ~/.pi/agent/cursor-sdk-context-windows.json
 // These are default/non-Max-mode SDK context windows for Cursor models that do not
 // expose a catalog `context` parameter. Do not replace them with Max Mode values
 // unless the Cursor SDK exposes an exact Max Mode model selection and the extension
 // uses that selection for matching pi model IDs.
 export const BUNDLED_CONTEXT_WINDOWS = {
+	"default": 200000,
 	"claude-haiku-4-5": 200000,
 	"claude-opus-4-5": 200000,
 	"composer-1.5": 200000,
 	"composer-2": 200000,
-	default: 200000,
+	"composer-2.5": 200000,
 	"gemini-2.5-flash": 200000,
 	"gemini-3-flash": 200000,
 	"gemini-3.1-pro": 200000,
@@ -22,6 +24,7 @@ export const BUNDLED_CONTEXT_WINDOWS = {
 	"gpt-5.3-codex-spark": 128000,
 	"gpt-5.4-mini": 272000,
 	"gpt-5.4-nano": 272000,
+	"gpt-5.5@272k": 272000,
 	"grok-4-20": 200000,
 	"kimi-k2.5": 262000,
 } as const satisfies Record<string, number>;