pi-cursor-sdk 0.1.62 → 0.2.0

package/scripts/platform-smoke/live-suite-runner.mjs

@@ -19,7 +19,6 @@ import { getScenario, renderPrompt } from "./scenarios.mjs";
 
 const DEFAULT_MODEL = "cursor/composer-2-5";
 const DEFAULT_WAIT_MS = 240_000;
-const READY_WAIT_MS = 45_000;
 const SESSION_JSONL_WAIT_MS = 60_000;
 const COLS = 150;
 const ROWS = 45;
@@ -242,25 +241,10 @@ function stripANSI(text) {
 	return text.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b\][^\x07]*(?:\x07|\x1b\\)/g, "");
 }
 
-function psQuote(value) {
-	return `'${String(value).replace(/'/g, "''")}'`;
-}
-
-function shellQuote(value) {
-	return `'${String(value).replace(/'/g, `'\\''`)}'`;
-}
-
-function ptySpawnCommand(piCli, args) {
-	if (process.platform !== "win32") {
-		return {
-			file: "/bin/bash",
-			args: ["-lc", ["exec", shellQuote(piCli), ...args.map(shellQuote)].join(" ")],
-		};
-	}
-	return {
-		file: "powershell.exe",
-		args: ["-NoLogo", "-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", ["&", psQuote(piCli), ...args.map(psQuote)].join(" ")],
-	};
+function ptySpawnCommand(args) {
+	const cliEntry = resolve(process.cwd(), "node_modules", "@earendil-works", "pi-coding-agent", "dist", "cli.js");
+	if (!existsSync(cliEntry)) throw new Error(`Pi CLI entry not found: ${cliEntry}`);
+	return { file: process.execPath, args: [cliEntry, ...args] };
 }
 
 async function waitForSessionJsonl(sessionDir, finalMarker, startedAt, events) {
@@ -285,7 +269,7 @@ async function waitForSessionJsonl(sessionDir, finalMarker, startedAt, events) {
 	return files;
 }
 
-async function runPtyPi({ artifactDir, piCli, piArgs, env, cwd, sessionDir, prompt, finalMarker, waitMs, abortMode, scenario }) {
+async function runPtyPi({ artifactDir, ptyCommand, env, cwd, sessionDir, finalMarker, waitMs, abortMode, scenario }) {
 	let pty;
 	try {
 		pty = await import("node-pty");
@@ -297,8 +281,7 @@ async function runPtyPi({ artifactDir, piCli, piArgs, env, cwd, sessionDir, prom
 	let plain = "";
 	const events = [];
 	const startedAt = Date.now();
-	const { file, args } = ptySpawnCommand(piCli, piArgs);
-	writeFileSync(join(artifactDir, "pty-spawn-command.json"), JSON.stringify({ file, args, cwd, fileExists: existsSync(file), cwdExists: existsSync(cwd) }, null, 2));
+	const { file, args } = ptyCommand;
 	let child;
 	try {
 		child = pty.spawn(file, args, {
@@ -322,15 +305,7 @@ async function runPtyPi({ artifactDir, piCli, piArgs, env, cwd, sessionDir, prom
 		events.push({ type: "exit", elapsedMs: Date.now() - startedAt, code: event.exitCode, signal: event.signal });
 	});
 
-	const readyStartedAt = Date.now();
-	while (!/(?:composer-2-5|escape interrupt|ctrl\+c\/ctrl\+d)/i.test(plain) && Date.now() - readyStartedAt < READY_WAIT_MS) {
-		await delay(500);
-	}
-	events.push({ type: "ready_wait_finished", elapsedMs: Date.now() - startedAt, ready: /(?:composer-2-5|escape interrupt|ctrl\+c\/ctrl\+d)/i.test(plain) });
-	child.write(`\x1b[200~${prompt}\x1b[201~\r`);
-	events.push({ type: "prompt_sent", elapsedMs: Date.now() - startedAt, bytes: prompt.length });
-	await delay(1_000);
-	const responseStartOffset = plain.length;
+	const responseStartOffset = 0;
 	events.push({ type: "response_watch_started", elapsedMs: Date.now() - startedAt, offset: responseStartOffset });
 
 	let observed = false;
@@ -572,6 +547,7 @@ async function main() {
 		const suiteEnv = {
 			...process.env,
 			...scenario.env,
+			PI_OFFLINE: "1",
 			...(args.suite === "cursor-abort-cleanup" ? { PLATFORM_ABORT_MARKER: "SHOULD_NOT_PRINT" } : {}),
 			PI_CODING_AGENT_DIR: agentDir,
 			PI_CURSOR_SDK_EVENT_DEBUG_DIR: debugDir,
@@ -581,21 +557,21 @@ async function main() {
 		if (args.suite === "cursor-abort-cleanup") writeProcessSnapshot(logDir, "process-before", platform);
 		const prompt = renderPrompt(scenario, platform);
 		writeFileSync(join(artifactDir, "prompt.txt"), prompt);
-		const piArgs = ["--approve", "--cursor-no-fast", "--cursor-mode", "agent", "--model", args.model, "--session-dir", sessionDir, "--session-id", `platform-${args.suite}-${Date.now()}`];
+		const piArgs = ["--approve", "--cursor-no-fast", "--cursor-mode", "agent", "--model", args.model, "--session-dir", sessionDir, "--session-id", `platform-${args.suite}-${Date.now()}`, prompt];
+		const ptyCommand = ptySpawnCommand(piArgs);
 		writeFileSync(join(artifactDir, "pi-command.json"), JSON.stringify({
-			piCli,
-			args: piArgs,
+			...ptyCommand,
 			cwd: workspaceDir,
-			env: Object.fromEntries(Object.entries(suiteEnv).filter(([key]) => key.startsWith("PI_CURSOR_") || key === "PI_CODING_AGENT_DIR" || key === "TERM")),
+			fileExists: existsSync(ptyCommand.file),
+			cwdExists: existsSync(workspaceDir),
+			env: Object.fromEntries(Object.entries(suiteEnv).filter(([key]) => key.startsWith("PI_CURSOR_") || key === "PI_CODING_AGENT_DIR" || key === "PI_OFFLINE" || key === "TERM")),
 		}, null, 2));
 		const ptyResult = await runPtyPi({
 			artifactDir,
-			piCli,
-			piArgs,
+			ptyCommand,
 			env: suiteEnv,
 			cwd: workspaceDir,
 			sessionDir,
-			prompt,
 			finalMarker: scenario.finalMarker,
 			waitMs: args.waitMs,
 			abortMode: args.suite === "cursor-abort-cleanup",

package/scripts/platform-smoke/platform-build-windows.ps1

@@ -62,7 +62,7 @@ Write-SectionFile "NPM_CI_STDOUT" $NpmCiOut
 Write-SectionFile "NPM_CI_STDERR" $NpmCiErr
 
 Write-Output "=== check:platform-smoke ==="
-& npm.cmd run check:platform-smoke 1> $CheckPlatformSmokeOut 2> $CheckPlatformSmokeErr
+& npm.cmd run check:platform-smoke -- --testTimeout=15000 1> $CheckPlatformSmokeOut 2> $CheckPlatformSmokeErr
 $CHECK_PLATFORM_SMOKE_EXIT = Exit-CodeFromLastCommand
 Write-Output "PLATFORM_CHECK_PLATFORM_SMOKE_EXIT=$CHECK_PLATFORM_SMOKE_EXIT"
 Write-SectionFile "CHECK_PLATFORM_SMOKE_STDOUT" $CheckPlatformSmokeOut

package/scripts/platform-smoke/scenarios.mjs

@@ -108,7 +108,7 @@ NATIVE_MATRIX_OK package=<name> grep=<yes/no> find=<yes/no> list=<yes/no> shell=
 			PI_CURSOR_EXPOSE_BUILTIN_TOOLS: "0",
 			PI_CURSOR_SDK_EVENT_DEBUG: "1",
 		},
-		promptTemplate: "Reply exactly HTTP1_LIVE_OK.",
+		promptTemplate: "Join HTTP1, LIVE, and OK with underscores and reply with only the result.",
 		finalMarker: "HTTP1_LIVE_OK",
 		requiredCards: ["http1-status"],
 	},

package/scripts/platform-smoke.mjs

@@ -28,7 +28,7 @@ function printHelp() {
 
 Commands:
   doctor                     Run all preflight checks (no Cursor tokens)
-  run --target <names>       Run one or more comma-separated targets concurrently
+  run --target <names>       Run one or more comma-separated targets sequentially
   run --suite <name>         Run one suite on all or specified targets
   run --target <n> --suite <n>
 
@@ -242,14 +242,14 @@ async function main() {
 		}
 
 		const startedAt = new Date().toISOString();
-		const targetRuns = targets.map(async (targetName) => {
+		const results = [];
+		for (const targetName of targets) {
 			console.log(`\n=== Target: ${targetName} ===`);
 			const result = args.suite
 				? await runSuite(targetName, suites[0])
 				: await runTarget(targetName, suites);
-			return { targetName, result };
-		});
-		const results = await Promise.all(targetRuns);
+			results.push({ targetName, result });
+		}
 		const finishedAt = new Date().toISOString();
 		const latest = writeLatestPlatformSmokeIndex(config, results, {
 			startedAt,

package/scripts/refresh-cursor-model-snapshots.mjs

@@ -4,6 +4,7 @@ import { Cursor } from "@cursor/sdk";
 import { defaultApiKeyFromEnv, parseArgv } from "./lib/cursor-cli-args.mjs";
 import { scrubSensitiveText } from "../shared/cursor-sensitive-text.mjs";
 import { createScriptFail } from "./lib/cursor-script-fail.mjs";
+import { normalizeCursorContextWindowEntries } from "../shared/cursor-model-selection-identities.mjs";
 
 const FALLBACK_MODELS_PATH = "src/cursor-fallback-models.generated.ts";
 const CONTEXT_WINDOWS_PATH = "src/bundled-context-windows.ts";
@@ -40,7 +41,9 @@ Notes:
   - This script prints model IDs/counts only; it never prints API keys.
   - Cursor.models.list() is the source of truth for fallback catalog metadata.
   - Checkpoint-derived context windows are optional input because collecting them
-    requires successful local SDK runs; this script does not start agents.`);
+    requires successful local SDK runs; this script does not start agents.
+  - Context-window keys are limited to current selectable model IDs. Redundant
+    :fast/:slow aliases that send the default parameters collapse to one key.`);
 }
 
 const fail = createScriptFail("refresh-cursor-snapshots");
@@ -156,9 +159,10 @@ function hasContextParameter(model) {
 }
 
 function formatContextWindows(models, checkpointWindows, fallbackContextWindow) {
-	const existing = parseExistingContextWindows();
-	const merged = new Map(existing);
-	for (const [modelId, contextWindow] of checkpointWindows) merged.set(modelId, contextWindow);
+	const merged = normalizeCursorContextWindowEntries(models, parseExistingContextWindows(), "existing bundled context windows");
+	for (const [modelId, contextWindow] of normalizeCursorContextWindowEntries(models, checkpointWindows, "checkpoint context windows")) {
+		merged.set(modelId, contextWindow);
+	}
 	for (const model of models) {
 		if (!hasContextParameter(model) && !merged.has(model.id)) merged.set(model.id, fallbackContextWindow);
 	}
@@ -167,7 +171,7 @@ function formatContextWindows(models, checkpointWindows, fallbackContextWindow)
 	const date = new Date().toISOString().slice(0, 10);
 	const sorted = [...merged.entries()].sort(([a], [b]) => (a === "default" ? -1 : b === "default" ? 1 : a.localeCompare(b)));
 	const lines = sorted.map(([modelId, contextWindow]) => `\t${JSON.stringify(modelId)}: ${contextWindow},`);
-	return `// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on ${date}.\n// Refresh with: npm run refresh:cursor-snapshots -- --write --context-windows ~/.pi/agent/cursor-sdk-context-windows.json\n// These are default/non-Max-mode SDK context windows for Cursor models that do not\n// expose a catalog \`context\` parameter. Do not replace them with Max Mode values\n// unless the Cursor SDK exposes an exact Max Mode model selection and the extension\n// uses that selection for matching pi model IDs.\nexport const BUNDLED_CONTEXT_WINDOWS = {\n${lines.join("\n")}\n} as const satisfies Record<string, number>;\n`;
+	return `// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on ${date}.\n// Refresh with: npm run refresh:cursor-snapshots -- --write --context-windows ~/.pi/agent/cursor-sdk-context-windows.json\n// Keys are current selectable model IDs. Equivalent default :fast/:slow selections\n// collapse to one key; stale and ambiguous aliases are omitted. Values are observed\n// or conservative default/non-Max-mode limits and may override a catalog context\n// label when the completed SDK checkpoint reports a different effective limit.\nexport const BUNDLED_CONTEXT_WINDOWS = {\n${lines.join("\n")}\n} as const satisfies Record<string, number>;\n`;
 }
 
 const args = parseRefreshArgs(process.argv.slice(2));
@@ -184,11 +188,16 @@ if (!Array.isArray(rawModels) || rawModels.length === 0) fail("Cursor.models.lis
 const models = rawModels.map(sanitizeModelItem).sort((a, b) => a.id.localeCompare(b.id));
 const checkpointWindows = parseContextWindowsFile(args.contextWindowsPath);
 const fallbackSource = formatFallbackModels(models, sdkVersion);
-const contextWindowSource = args.contextWindowsPath ? formatContextWindows(models, checkpointWindows, args.fallbackContextWindow) : undefined;
+let contextWindowSource;
+try {
+	contextWindowSource = args.contextWindowsPath ? formatContextWindows(models, checkpointWindows, args.fallbackContextWindow) : undefined;
+} catch (error) {
+	fail(error instanceof Error ? error.message : String(error));
+}
 const existingContextWindowCount = parseExistingContextWindows().size;
 
 console.log(`Fetched ${models.length} Cursor models with @cursor/sdk@${sdkVersion}.`);
-console.log(`Context windows: ${checkpointWindows.size} checkpoint override(s), ${existingContextWindowCount} existing bundled entr${existingContextWindowCount === 1 ? "y" : "ies"}.`);
+console.log(`Context windows: ${checkpointWindows.size} checkpoint input(s), ${existingContextWindowCount} existing bundled entr${existingContextWindowCount === 1 ? "y" : "ies"}.`);
 console.log(`First models: ${models.slice(0, 8).map((model) => model.id).join(", ")}${models.length > 8 ? ", ..." : ""}`);
 
 if (args.check) {

package/shared/cursor-model-selection-identities.d.mts

@@ -0,0 +1,21 @@
+import type { ModelListItem } from "@cursor/sdk";
+
+export interface CursorModelSelectionIdentity {
+	model: ModelListItem;
+	selectionModelId: string;
+	context?: string;
+	fastOverride?: boolean;
+	piModelId: string;
+	contextWindowKey: string;
+	baseContextWindowKey: string;
+}
+
+export declare function getCursorModelSelectionIdentities(
+	models: readonly ModelListItem[],
+): CursorModelSelectionIdentity[];
+
+export declare function normalizeCursorContextWindowEntries(
+	models: readonly ModelListItem[],
+	entries: ReadonlyMap<string, number>,
+	source?: string,
+): Map<string, number>;

package/shared/cursor-model-selection-identities.mjs

@@ -0,0 +1,95 @@
+function getParameter(model, id) {
+	return (model.parameters ?? []).find((parameter) => parameter.id === id);
+}
+
+function getDefaultParam(model, id) {
+	const variant = (model.variants ?? []).find((candidate) => candidate.isDefault) ?? model.variants?.[0];
+	return variant?.params?.find((param) => param.id === id)?.value.toLowerCase();
+}
+
+function getAmbiguousAliases(models) {
+	const ownersByAlias = new Map();
+	for (const model of models) {
+		for (const rawAlias of model.aliases ?? []) {
+			const alias = rawAlias.trim();
+			if (!alias || alias === model.id) continue;
+			const owners = ownersByAlias.get(alias) ?? new Set();
+			owners.add(model.id);
+			ownersByAlias.set(alias, owners);
+		}
+	}
+	return new Set([...ownersByAlias].filter(([, owners]) => owners.size > 1).map(([alias]) => alias));
+}
+
+function getSelectableIds(model, reservedIds, ambiguousAliases) {
+	const ids = [model.id];
+	for (const rawAlias of model.aliases ?? []) {
+		const alias = rawAlias.trim();
+		if (!alias || alias === model.id || ids.includes(alias) || reservedIds.has(alias) || ambiguousAliases.has(alias)) continue;
+		ids.push(alias);
+	}
+	return ids;
+}
+
+function encodePiModelId(modelId, context, fastOverride) {
+	const contextQualified = context ? `${modelId}@${context}` : modelId;
+	if (fastOverride === true) return `${contextQualified}:fast`;
+	if (fastOverride === false) return `${contextQualified}:slow`;
+	return contextQualified;
+}
+
+export function getCursorModelSelectionIdentities(models) {
+	const sortedModels = [...models].sort((a, b) => a.id.localeCompare(b.id));
+	const reservedIds = new Set(models.map((model) => model.id));
+	const ambiguousAliases = getAmbiguousAliases(models);
+	const usedPiModelIds = new Set();
+	const identities = [];
+
+	for (const model of sortedModels) {
+		const contextValues = getParameter(model, "context")?.values?.map(({ value }) => value) ?? [];
+		const contexts = contextValues.length > 0 ? contextValues : [undefined];
+		const hasFast = getParameter(model, "fast") !== undefined;
+		const fastOverrides = hasFast ? [undefined, true, false] : [undefined];
+		const defaultFast = getDefaultParam(model, "fast");
+
+		for (const selectionModelId of getSelectableIds(model, reservedIds, ambiguousAliases)) {
+			for (const context of contexts) {
+				for (const fastOverride of fastOverrides) {
+					const piModelId = encodePiModelId(selectionModelId, context, fastOverride);
+					if (usedPiModelIds.has(piModelId)) continue;
+					usedPiModelIds.add(piModelId);
+					const defaultEquivalent =
+						(fastOverride === true && defaultFast === "true") || (fastOverride === false && defaultFast === "false");
+					identities.push({
+						model,
+						selectionModelId,
+						...(context ? { context } : {}),
+						...(fastOverride !== undefined ? { fastOverride } : {}),
+						piModelId,
+						contextWindowKey: defaultEquivalent ? encodePiModelId(selectionModelId, context) : piModelId,
+						baseContextWindowKey: encodePiModelId(model.id, context, defaultEquivalent ? undefined : fastOverride),
+					});
+				}
+			}
+		}
+	}
+
+	return identities;
+}
+
+export function normalizeCursorContextWindowEntries(models, entries, source = "context windows") {
+	const canonicalBySelectableId = new Map(
+		getCursorModelSelectionIdentities(models).map(({ piModelId, contextWindowKey }) => [piModelId, contextWindowKey]),
+	);
+	const normalized = new Map();
+	for (const [modelId, contextWindow] of entries) {
+		const canonicalId = modelId === "default" ? modelId : canonicalBySelectableId.get(modelId);
+		if (!canonicalId) continue;
+		const existing = normalized.get(canonicalId);
+		if (existing !== undefined && existing !== contextWindow) {
+			throw new Error(`${source} assigns conflicting windows to equivalent selection ${canonicalId}: ${existing} and ${contextWindow}`);
+		}
+		normalized.set(canonicalId, contextWindow);
+	}
+	return normalized;
+}

package/src/bundled-context-windows.ts

@@ -1,30 +1,36 @@
-// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on 2026-05-18.
+// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on 2026-08-02.
 // 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.
+// Keys are current selectable model IDs. Equivalent default :fast/:slow selections
+// collapse to one key; stale and ambiguous aliases are omitted. Values are observed
+// or conservative default/non-Max-mode limits and may override a catalog context
+// label when the completed SDK checkpoint reports a different effective limit.
 export const BUNDLED_CONTEXT_WINDOWS = {
 	"default": 200000,
+	"claude-fable-5@300k": 300000,
 	"claude-haiku-4-5": 200000,
 	"claude-opus-4-5": 200000,
-	"composer-1.5": 200000,
+	"claude-opus-4-8@1m": 300000,
 	"composer-2": 200000,
 	"composer-2.5": 200000,
 	"gemini-2.5-flash": 200000,
 	"gemini-3-flash": 200000,
 	"gemini-3.1-pro": 200000,
+	"gemini-3.5-flash": 200000,
+	"gemini-3.6-flash": 200000,
+	"glm-5.2": 200000,
+	"gpt-5-5@272k": 272000,
 	"gpt-5-mini": 272000,
 	"gpt-5.1": 272000,
-	"gpt-5.1-codex-max": 272000,
-	"gpt-5.1-codex-mini": 272000,
 	"gpt-5.2": 272000,
-	"gpt-5.2-codex": 272000,
 	"gpt-5.3-codex": 272000,
-	"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,
+	"gpt-5.6@1m": 272000,
+	"grok-4.5": 256000,
+	"grok-4.5:slow": 256000,
+	"kimi-k2.7-code": 200000,
+	"kimi-k3": 200000,
+	"opus-4.8@1m": 300000,
+	"opus-4.8@300k": 300000,
 } as const satisfies Record<string, number>;

package/src/context.ts

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import type { Context, Message, ToolCall } from "@earendil-works/pi-ai/compat";
+import type { Context, Message, ToolCall } from "@earendil-works/pi-ai";
 import { convertToLlm } from "@earendil-works/pi-coding-agent";
 import type { AgentModeOption, SDKImage } from "@cursor/sdk";
 import { CURSOR_PI_BRIDGE_PREFERENCE_TEXT } from "./cursor-bridge-contract.js";

package/src/cursor-context-tools.ts

@@ -1,4 +1,4 @@
-import type { Context } from "@earendil-works/pi-ai/compat";
+import type { Context } from "@earendil-works/pi-ai";
 
 /** Tool names from the provider context snapshot at stream start (not live pi.getActiveTools()). */
 export function getActiveContextToolNames(context: Context): ReadonlySet<string> | undefined {

package/src/cursor-display-only-trace.ts

@@ -1,4 +1,4 @@
-import type { AssistantMessage, AssistantMessageEventStream } from "@earendil-works/pi-ai/compat";
+import type { AssistantMessage, AssistantMessageEventStream } from "@earendil-works/pi-ai";
 
 function withDisplayOnlyThinking(partial: AssistantMessage, thinking: string): AssistantMessage {
 	return { ...partial, content: [...partial.content, { type: "thinking", thinking }] };