pi-cursor-sdk 0.1.49 → 0.1.50

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.1.50 - 2026-06-24
+
+### Added
+
+- Normalize Cursor context-overflow failures into pi's `context_length_exceeded` form via a `message_end` handler so pi's auto-compact-retry recovery fires when a Cursor run fails on a too-large prompt. Scoped to the Cursor provider, limited to `stopReason === "error"`, never matches throttling/rate-limit signals, and idempotent. See pi `docs/custom-provider.md` "Context Overflow Errors".
+
+### Changed
+
+- Bump the local pi validation baseline (`@earendil-works/pi-ai`, `@earendil-works/pi-coding-agent`, `@earendil-works/pi-tui`) from `0.80.1` to `0.80.2` after reviewing current installed Pi 0.80.2 docs and types. Published pi core peer dependencies remain `"*"`.
+- Reconcile the README recommended/validated pi baseline wording (previously `0.80.1` recommended vs `0.79.10` validated) to the current `0.80.2` baseline.
+
+### Validation
+
+- `npm run typecheck`, `npm test` (790 tests), and `npm pack --dry-run` pass against the `0.80.2` pi core local validation baseline.
+- `npm run smoke:platform:all` passes on macOS, Ubuntu, and Windows native (native-replay visual matrix, bridge visual matrix, abort cleanup; packed installs, PTY/ConPTY capture, JSONL assertions, redaction scans) with Cursor auth.
+
 ## 0.1.49 - 2026-06-23
 
 ### Changed
@@ -11,7 +27,7 @@
 
 ### Validation
 
-- Pending in this release train.
+- `npm test`, `npm run typecheck`, and `npm pack --dry-run` pass against the `0.80.1` pi core local validation baseline.
 
 ## 0.1.48 - 2026-06-22
 

package/README.md

@@ -51,10 +51,10 @@ If pi started without a key, run `/cursor-refresh-models` after `/login` to refr
 ## Requirements
 
 - Node.js 22.19+
-- pi 0.80.1 or newer recommended; pi core peer metadata is intentionally unpinned so newer pi releases are not blocked
+- pi 0.80.2 or newer recommended; pi core peer metadata is intentionally unpinned so newer pi releases are not blocked
 - a Cursor SDK API key saved through `/login`, available as `CURSOR_API_KEY`, or passed with pi's `--api-key`
 
-No global `@cursor/sdk` install is required. This package depends on exact `@cursor/sdk@1.0.19`, so normal package installation brings in the SDK version this extension was built and tested against. It also declares and bundles `@connectrpc/connect-node@1.7.0` with `undici@7.28.0` because Cursor SDK 1.0.19 still dynamically loads the Node ConnectRPC transport during local-agent runs, and npm dependency consumers do not inherit this package's root-only `overrides`. Cursor SDK 1.0.19 removes the older `sqlite3 -> node-gyp@8` dependency chain, so deprecated install warnings for `inflight`, `rimraf`, `glob@7`, `npmlog`, `gauge`, `are-we-there-yet`, and `tar@6` from that chain are no longer expected. This package follows pi package guidance by declaring pi core package peers with `"*"` ranges, so users who update pi before this extension is republished are not blocked by peer metadata. The current recommended and validated pi baseline is 0.79.10 plus Cursor SDK 1.0.19; older pi compatibility paths are best-effort and older Cursor SDK compatibility paths are not maintained.
+No global `@cursor/sdk` install is required. This package depends on exact `@cursor/sdk@1.0.19`, so normal package installation brings in the SDK version this extension was built and tested against. It also declares and bundles `@connectrpc/connect-node@1.7.0` with `undici@7.28.0` because Cursor SDK 1.0.19 still dynamically loads the Node ConnectRPC transport during local-agent runs, and npm dependency consumers do not inherit this package's root-only `overrides`. Cursor SDK 1.0.19 removes the older `sqlite3 -> node-gyp@8` dependency chain, so deprecated install warnings for `inflight`, `rimraf`, `glob@7`, `npmlog`, `gauge`, `are-we-there-yet`, and `tar@6` from that chain are no longer expected. This package follows pi package guidance by declaring pi core package peers with `"*"` ranges, so users who update pi before this extension is republished are not blocked by peer metadata. The current recommended and validated pi baseline is 0.80.2 plus Cursor SDK 1.0.19; older pi compatibility paths are best-effort and older Cursor SDK compatibility paths are not maintained.
 
 ## Install
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cursor-sdk",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "description": "pi provider extension backed by @cursor/sdk local agents",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",
   "license": "MIT",
@@ -125,9 +125,9 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "0.80.1",
-    "@earendil-works/pi-coding-agent": "0.80.1",
-    "@earendil-works/pi-tui": "0.80.1",
+    "@earendil-works/pi-ai": "0.80.2",
+    "@earendil-works/pi-coding-agent": "0.80.2",
+    "@earendil-works/pi-tui": "0.80.2",
     "@xterm/xterm": "^6.0.0",
     "node-pty": "^1.1.0",
     "playwright": "^1.60.0",

package/src/cursor-provider-overflow.ts

@@ -0,0 +1,96 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AssistantMessage } from "@earendil-works/pi-ai/compat";
+import { CURSOR_PROVIDER } from "./cursor-model.js";
+
+/**
+ * Pi recognizes `context_length_exceeded` (its `OVERFLOW_PATTERNS` includes
+ * `/context[_ ]length[_ ]exceeded/i`) as a context-overflow signal and, on
+ * detecting it, drops the failed assistant message, compacts, and retries once.
+ *
+ * The Cursor provider sanitizes SDK failures into auth/network/generic messages
+ * that pi does NOT treat as overflow, so a genuine Cursor context-overflow
+ * failure would otherwise surface as a plain provider error and bypass pi's
+ * auto-compact-retry recovery. This handler rewrites only Cursor context-window
+ * failures into the `context_length_exceeded` form pi recognizes.
+ *
+ * See pi `docs/custom-provider.md` -> "Context Overflow Errors".
+ */
+export const CURSOR_OVERFLOW_MARKER = "context_length_exceeded";
+
+/**
+ * Context-overflow phrases. These overlap pi's own `OVERFLOW_PATTERNS` so the
+ * false-positive surface matches pi's built-in detection for other providers.
+ *
+ * ponytail: intentionally narrow and textual. We do NOT match bare gRPC
+ * `resource_exhausted` (code 8) or `too many tokens` because pi documents those
+ * can false-match throttling/quota errors and trigger an unwanted compaction.
+ * If a live Cursor probe reveals a distinct overflow phrase, add it here; this
+ * pattern set is the single place to extend without touching the handler.
+ */
+const CURSOR_OVERFLOW_PATTERNS = [
+	/context[_ ]?length/i,
+	/context[_ ]?window/i,
+	/maximum context/i,
+	/prompt is too long/i,
+	/too large for model/i,
+	/exceed(?:s|ed).{0,30}context/i,
+] as const;
+
+/** Never treat rate-limit/throttle signals as overflow (pi retries those separately). */
+const CURSOR_THROTTLE_PATTERN = /too many requests|rate.?limit|throttl|retry.?after/i;
+
+/**
+ * Map a finalized Cursor assistant `errorMessage` to pi's overflow form.
+ * Returns `undefined` when the message is not a Cursor context-overflow failure.
+ *
+ * Pure and idempotent so it is safe to call repeatedly and unit-test in isolation.
+ */
+export function normalizeCursorOverflowErrorMessage(errorMessage: string | undefined): string | undefined {
+	const message = errorMessage?.trim();
+	if (!message) return undefined;
+	// Idempotent: never double-prefix an already-normalized message.
+	if (message.includes(CURSOR_OVERFLOW_MARKER)) return undefined;
+	if (CURSOR_THROTTLE_PATTERN.test(message)) return undefined;
+	if (CURSOR_OVERFLOW_PATTERNS.some((pattern) => pattern.test(message))) {
+		return `${CURSOR_OVERFLOW_MARKER}: ${message}`;
+	}
+	return undefined;
+}
+
+/**
+ * Rewrite a finalized assistant message into pi's overflow form when it is a
+ * Cursor context-overflow failure. Returns the replacement message (for the
+ * `message_end` result) or `undefined` to leave it unchanged.
+ *
+ * `isCursorProvider` carries the provider scoping decision out of the handler so
+ * the full logic is unit-testable without a pi event harness.
+ */
+export function rewriteCursorOverflowAssistantMessage(
+	message: AssistantMessage,
+	isCursorProvider: boolean,
+): AssistantMessage | undefined {
+	if (!isCursorProvider || message.stopReason !== "error") return undefined;
+	const rewritten = normalizeCursorOverflowErrorMessage(message.errorMessage);
+	if (!rewritten) return undefined;
+	return { ...message, errorMessage: rewritten };
+}
+
+export type CursorOverflowExtensionApi = Pick<ExtensionAPI, "on">;
+
+/**
+ * Register a `message_end` handler that rewrites Cursor context-overflow
+ * failures into the `context_length_exceeded` form pi auto-compacts on.
+ *
+ * Guarded exactly as pi's provider docs require: scoped to the Cursor provider,
+ * only for `stopReason === "error"`, never for throttling, and idempotent.
+ */
+export function registerCursorOverflowNormalization(pi: CursorOverflowExtensionApi): void {
+	pi.on("message_end", (event, ctx) => {
+		const message = event.message;
+		if (message.role !== "assistant") return undefined;
+		const isCursorProvider = message.provider === CURSOR_PROVIDER || ctx.model?.provider === CURSOR_PROVIDER;
+		const rewritten = rewriteCursorOverflowAssistantMessage(message, isCursorProvider);
+		if (!rewritten) return undefined;
+		return { message: rewritten };
+	});
+}

package/src/index.ts

@@ -11,6 +11,7 @@ import { streamCursorLazy } from "./cursor-provider-lazy.js";
 import { CURSOR_API_KEY_CONFIG_VALUE } from "./cursor-api-key.js";
 import { registerCursorFallbackIssueWarning } from "./cursor-fallback-warning.js";
 import { registerCursorAgentsContextDedup } from "./cursor-agents-context-registration.js";
+import { registerCursorOverflowNormalization } from "./cursor-provider-overflow.js";
 
 type CursorExtensionApi =
 	& Pick<ExtensionAPI, "registerProvider" | "registerCommand" | "on">
@@ -22,7 +23,8 @@ type CursorExtensionApi =
 	& Parameters<typeof registerCursorSkillTool>[0]
 	& Parameters<typeof registerCursorPiToolBridge>[0]
 	& Parameters<typeof registerCursorFallbackIssueWarning>[0]
-	& Parameters<typeof registerCursorAgentsContextDedup>[0];
+	& Parameters<typeof registerCursorAgentsContextDedup>[0]
+	& Parameters<typeof registerCursorOverflowNormalization>[0];
 
 function createCursorProviderConfig(models: ProviderModelConfig[]): ProviderConfig {
 	return {
@@ -53,6 +55,7 @@ export default async function (pi: CursorExtensionApi) {
 	registerCursorSkillTool(pi);
 	registerCursorPiToolBridge(pi);
 	registerCursorAgentsContextDedup(pi);
+	registerCursorOverflowNormalization(pi);
 	let fallbackIssue: CursorModelFallbackIssue | undefined;
 	const models = await discoverModels({
 		onFallback: (issue) => {