pi-cursor-sdk 0.1.23 → 0.1.25

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.1.25 - 2026-05-28
+
+### Fixed
+
+- Keep fallback Cursor models visible before `/login` on pi 0.77 by using a non-secret provider API-key sentinel while still resolving real keys from pi auth, `--api-key`, and `CURSOR_API_KEY`.
+
+## 0.1.24 - 2026-05-28
+
+### Changed
+
+- Refresh the bundled Cursor fallback model catalog from `@cursor/sdk@1.0.15`, including Claude Opus 4.8 context variants and the updated `opus-latest` alias target.
+
 ## 0.1.23 - 2026-05-28
 
 ### Changed

package/README.md

@@ -129,7 +129,7 @@ Choose Cursor models interactively with `/model`, or pass a model on the command
 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
+pi --model cursor/claude-opus-4-8@300k
 ```
 
 How to read model IDs:

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

@@ -165,8 +165,8 @@ Recommended context-variant ID format:
 ```text
 cursor/gpt-5.5@1m
 cursor/gpt-5.5@272k
-cursor/claude-opus-4-7@1m
-cursor/claude-opus-4-7@300k
+cursor/claude-opus-4-8@1m
+cursor/claude-opus-4-8@300k
 cursor/composer-2.5
 ```
 
@@ -183,7 +183,7 @@ Avoid this old parameter encoding:
 
 ```text
 cursor/gpt-5.5:context=1m;fast=false;reasoning=medium
-cursor/claude-opus-4-7:context=1m;effort=xhigh;thinking=true
+cursor/claude-opus-4-8:context=1m;effort=xhigh;thinking=true
 ```
 
 Reason:
@@ -333,8 +333,8 @@ Examples:
 cursor/gpt-5.5@272k
 cursor/gpt-5.5@1m
 
-cursor/claude-opus-4-7@300k
-cursor/claude-opus-4-7@1m
+cursor/claude-opus-4-8@300k
+cursor/claude-opus-4-8@1m
 
 cursor/grok-4.3@200k
 cursor/grok-4.3@1m
@@ -630,12 +630,12 @@ Cursor params: reasoning=low; fast=true
 
 No context variant.
 
-### `claude-opus-4-7`
+### `claude-opus-4-8`
 
 Initial Cursor default:
 
 ```text
-pi model: cursor/claude-opus-4-7@1m
+pi model: cursor/claude-opus-4-8@1m
 Cursor params: thinking=true; context=1m; effort=xhigh
 pi thinking: xhigh
 ```
@@ -643,7 +643,7 @@ pi thinking: xhigh
 After selecting the 300k variant:
 
 ```text
-pi model: cursor/claude-opus-4-7@300k
+pi model: cursor/claude-opus-4-8@300k
 Cursor params: thinking=true; context=300k; effort=xhigh
 pi contextWindow: 300000
 ```

package/package.json

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

package/src/cursor-api-key.ts

@@ -1,10 +1,16 @@
 export const CURSOR_API_KEY_ENV_VAR = "CURSOR_API_KEY";
-export const CURSOR_API_KEY_CONFIG_VALUE = `$${CURSOR_API_KEY_ENV_VAR}`;
+
+// Non-secret literal sentinel for pi's provider registry. Pi 0.77 treats `$ENV_VAR`
+// values as unconfigured when the env var is absent, which hides fallback models
+// before `/login`. Keep the provider available and resolve the real key in the
+// Cursor provider turn path from pi auth, --api-key, or CURSOR_API_KEY.
+export const CURSOR_API_KEY_CONFIG_VALUE = "pi-cursor-sdk-cursor-api-key-placeholder";
 
 const CURSOR_API_KEY_PLACEHOLDERS = new Set([
 	CURSOR_API_KEY_ENV_VAR,
-	CURSOR_API_KEY_CONFIG_VALUE,
+	`$${CURSOR_API_KEY_ENV_VAR}`,
 	`\${${CURSOR_API_KEY_ENV_VAR}}`,
+	CURSOR_API_KEY_CONFIG_VALUE,
 ]);
 
 export function resolveCursorApiKey(apiKey?: string): string | undefined {