pi-cursor-sdk 0.5.2 → 0.5.3

package/dist/cursor-fallback-models.generated.js

@@ -1,4 +1,4 @@
-// Generated with @cursor/sdk@1.0.36 from 45 Cursor models.
+// Generated with @cursor/sdk@1.0.37 from 46 Cursor models.
 // Refresh with: npm run refresh:cursor-snapshots -- --write
 // Do not add secrets; this file stores public model metadata only.
 export const FALLBACK_MODEL_ITEMS = [
@@ -911,6 +911,407 @@ export const FALLBACK_MODEL_ITEMS = [
             }
         ]
     },
+    {
+        id: "claude-haiku-5-5",
+        displayName: "Claude Haiku 5.5",
+        parameters: [
+            {
+                id: "thinking",
+                displayName: "Thinking",
+                values: [
+                    {
+                        value: "false"
+                    },
+                    {
+                        value: "true"
+                    }
+                ]
+            },
+            {
+                id: "context",
+                displayName: "Context",
+                values: [
+                    {
+                        value: "300k",
+                        displayName: "300K"
+                    },
+                    {
+                        value: "1m",
+                        displayName: "1M"
+                    }
+                ]
+            },
+            {
+                id: "reasoning_effort",
+                displayName: "Effort",
+                values: [
+                    {
+                        value: "low",
+                        displayName: "Low"
+                    },
+                    {
+                        value: "medium",
+                        displayName: "Medium"
+                    },
+                    {
+                        value: "high",
+                        displayName: "High"
+                    },
+                    {
+                        value: "xhigh",
+                        displayName: "Extra High"
+                    },
+                    {
+                        value: "max",
+                        displayName: "Max"
+                    }
+                ]
+            }
+        ],
+        variants: [
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Low No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Medium No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  High No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "xhigh"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Extra High No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "max"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Max No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Low No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Medium No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M High No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "xhigh"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Extra High No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "false"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "max"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Max No Thinking"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Low"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Medium"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  High"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "xhigh"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Extra High"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "max"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5  Max"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Low"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Medium"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M High",
+                isDefault: true
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "xhigh"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Extra High"
+            },
+            {
+                params: [
+                    {
+                        id: "thinking",
+                        value: "true"
+                    },
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "max"
+                    }
+                ],
+                displayName: "Claude Haiku 5.5 1M Max"
+            }
+        ]
+    },
     {
         id: "claude-opus-4-5",
         displayName: "Claude Opus 4.5",

package/dist/cursor-local-agent-ownership.js

@@ -0,0 +1,17 @@
+// ponytail: process-local claims protect extension-owned handles and cleanup.
+// Cross-process SDK ownership requires an upstream store/agent lease contract.
+// Unproven disposal retains the exact handle claim until process exit.
+const claims = new Set();
+export function claimCursorLocalAgent(identity, agentId) {
+    const key = JSON.stringify([identity.stateRoot, agentId]);
+    if (claims.has(key))
+        return undefined;
+    claims.add(key);
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        claims.delete(key);
+    };
+}

package/dist/cursor-mcp-timeout-override.js

@@ -60,7 +60,7 @@ export function isCursorSdkMcpToolTimeoutStack(stack) {
 export function isCursorSdkMcpConnectTimeoutStack(stack) {
     if (!stack || !isCursorSdkMcpProtocolTimeoutStack(stack))
         return false;
-    // SDK 1.0.36 minifies the Client class name; the protocol method and SDK
+    // The SDK minifies the Client class name; the protocol method and SDK
     // frame, not that constructor's spelling, establish this timeout purpose.
     return /^\s*at (?:[\w$]+\.)?(?:connect|listTools|getTools)\s*\(.*(?:node_modules[/\\]@cursor[/\\]sdk|@cursor\/sdk\/dist)/m.test(stack);
 }

package/dist/cursor-pi-tool-bridge-diagnostics.js

@@ -15,6 +15,10 @@ function assertNeverDiagnosticEvent(_event) {
 }
 export function serializeCursorPiToolBridgeDiagnostic(event) {
     switch (event.event) {
+        case "mcp_initialized":
+            return { event: event.event, runId: event.runId };
+        case "mcp_tools_list":
+            return { event: event.event, runId: event.runId, toolCount: event.toolCount };
         case "run_created":
             return {
                 event: event.event,

package/dist/cursor-pi-tool-bridge-run.js

@@ -208,9 +208,16 @@ export class CursorPiToolBridgeRunImpl {
         const transport = new WebStandardStreamableHTTPServerTransport({
             sessionIdGenerator: randomUUID,
         });
-        server.setRequestHandler("tools/list", async () => ({
-            tools: this.snapshot.tools.map(snapshotToolToMcpTool),
-        }));
+        // ponytail: server-side receipts only, not SDK/model consumption or ongoing
+        // connection health; upgrade when Cursor exposes public MCP lifecycle callbacks.
+        server.oninitialized = () => {
+            this.emitDiagnostic({ event: "mcp_initialized", runId: this.id });
+        };
+        server.setRequestHandler("tools/list", async () => {
+            const tools = this.snapshot.tools.map(snapshotToolToMcpTool);
+            this.emitDiagnostic({ event: "mcp_tools_list", runId: this.id, toolCount: tools.length });
+            return { tools };
+        });
         server.setRequestHandler("tools/call", async (request, context) => {
             return this.enqueueToolRequest(request.params.name, request.params.arguments, String(context.mcpReq.id), context.mcpReq.signal);
         });

package/dist/cursor-provider-errors.js

@@ -140,7 +140,7 @@ function isCursorSdkStallAbortNetworkError(code, evidence, stackEvidence) {
         /\b(?:onStall|reportStall|StallDetected)\b/i.test(stackEvidence));
 }
 /**
- * @cursor/sdk@1.0.36 throws internal RetriableError (name/kind "RetriableError") with message
+ * @cursor/sdk@1.0.37 throws internal RetriableError (name/kind "RetriableError") with message
  * "Connection stalled" or "Connection stalled repeatedly" after fetchWithRetry exhausts stalls.
  * The ConnectError is only the cause; the top-level error is not a ConnectError.
  */
@@ -192,7 +192,7 @@ export function classifyCursorConnectError(error) {
     }
     const directAbort = (code === 1 || code === "canceled") &&
         (causeName === "AbortError" || /AbortError/.test(stack));
-    // The vendored 1.0.36 transport wraps a canceled ConnectError as Unknown.
+    // The vendored SDK transport can wrap a canceled ConnectError as Unknown.
     // Require the observed canceled -> AbortError cause chain, not generic text.
     const wrappedAbort = (code === 2 || code === "unknown") &&
         causeName === "ConnectError" &&

package/dist/cursor-provider-turn-summary.js

@@ -33,7 +33,7 @@ export async function prepareCursorSummaryProviderTurn(prepareParams, selection)
         configureCursorSdkHttp1(sdk, resolvedConfig.local.useHttp1ForAgent);
         restoreCursorSdkOutputFilter = installCursorSdkOutputFilter();
         sessionStore = (await openCursorSessionStoreForScope({
-            cwd, scopeKey: params.scope.scopeKey, persistent: false,
+            cwd, scopeKey: params.scope.persistentScopeKey ?? params.scope.scopeKey, persistent: false,
         })).sessionStore;
         throwIfAborted();
         agent = await suppressCursorSdkOutput(() => sdk.Agent.create({

package/dist/cursor-session-agent-cleanup.js

@@ -3,6 +3,7 @@ import { fsyncExistingRegularFile } from "./cursor-durable-fs.js";
 import { scrubSensitiveText } from "./cursor-sensitive-text.js";
 import { loadCursorSdk } from "./cursor-sdk-runtime.js";
 import { cursorSessionScopeKeyForManager } from "./cursor-session-scope.js";
+import { claimCursorLocalAgent } from "./cursor-local-agent-ownership.js";
 import { CURSOR_SESSION_AGENT_RESUME_ENTRY_TYPE, isCursorLocalAgentId, parseCursorSessionAgentResumeEntryData, readResumableCursorSessionAgentIds, resolveCursorSessionRepoRoot, } from "./cursor-session-agent-resume.js";
 import { withCursorSessionStoreIdentities, openCursorSessionStore, resolveCursorSessionStoreIdentity, } from "./cursor-session-store.js";
 export const CURSOR_SESSION_AGENT_CLEANUP_ENTRY_TYPE = "cursor-sdk-agent-cleanup";
@@ -260,7 +261,15 @@ export async function runCursorSessionAgentCleanupCommand(pi, args, ctx, storeRo
                         openedStore = await openCursorSessionStore(ctx.cwd, identity, identities.workspaceRoot, identities.storeRoot);
                         openedStores.set(identity.stateRoot, openedStore);
                     }
-                    await operations.delete(agentId, { cwd: ctx.cwd, store: openedStore.store });
+                    const release = claimCursorLocalAgent(identity, agentId);
+                    if (!release)
+                        throw new Error("Cursor local agent is still owned by an active runtime");
+                    try {
+                        await operations.delete(agentId, { cwd: ctx.cwd, store: openedStore.store });
+                    }
+                    finally {
+                        release();
+                    }
                     deletedAgentIds.push(agentId);
                 }
                 catch (error) {

package/dist/cursor-session-agent-lifecycle.js

@@ -1,9 +1,9 @@
 import { clearCursorSdkHttp1 } from "./cursor-http1.js";
-import { cursorSessionScopeKeyForManager, hasLiveCursorSessions, onCursorSessionScopeKeyChange } from "./cursor-session-scope.js";
+import { cursorRuntimeSessionScopeKeyForManager, hasLiveCursorSessions, onCursorSessionScopeKeyChange } from "./cursor-session-scope.js";
 import { disposeSessionCursorAgent, invalidateSessionAgent, resetSessionCursorAgent, } from "./cursor-session-agent.js";
 export function registerCursorSessionAgentLifecycle(pi) {
     let scopeKey;
-    pi.on("session_start", (_event, ctx) => { scopeKey = cursorSessionScopeKeyForManager(ctx.sessionManager); });
+    pi.on("session_start", (_event, ctx) => { scopeKey = cursorRuntimeSessionScopeKeyForManager(ctx.sessionManager); });
     onCursorSessionScopeKeyChange(pi, async (previousScopeKey) => {
         await disposeSessionCursorAgent(previousScopeKey);
     });

package/dist/cursor-session-agent-lineage.js

@@ -52,7 +52,7 @@ function readRecordedAgentIds(entries, sessionId) {
 export function recordCursorSessionAgentLineage(agentId, turnScopeKey) {
     const sessionState = turnScopeKey === undefined
         ? state
-        : statesByScope.get(turnScopeKey) ?? (state.scopeKey === turnScopeKey ? state : undefined);
+        : statesByScope.get(turnScopeKey) ?? ((state.runtimeScopeKey ?? state.scopeKey) === turnScopeKey ? state : undefined);
     if (!sessionState)
         return;
     const { appendEntry, sessionId, sessionFile, scopeKey, cwd } = sessionState;
@@ -83,24 +83,27 @@ export function registerCursorSessionAgentLineage(pi) {
     pi.on("session_start", (_event, ctx) => {
         state = sessionState;
         const record = sessionState;
-        if (record.scopeKey && statesByScope.get(record.scopeKey) === record)
-            statesByScope.delete(record.scopeKey);
+        if (record.runtimeScopeKey && statesByScope.get(record.runtimeScopeKey) === record)
+            statesByScope.delete(record.runtimeScopeKey);
         record.appendEntry = pi.appendEntry;
         record.sessionId = ctx.sessionManager.getSessionId();
         record.sessionFile = ctx.sessionManager.getSessionFile() ?? undefined;
-        record.scopeKey = getCursorSessionScopeSnapshot(pi).scopeKey;
-        statesByScope.set(record.scopeKey, record);
+        const scope = getCursorSessionScopeSnapshot(pi);
+        record.runtimeScopeKey = scope.scopeKey;
+        record.scopeKey = scope.persistentScopeKey ?? scope.scopeKey;
+        statesByScope.set(scope.scopeKey, record);
         record.cwd = ctx.cwd;
         record.recordedAgentIds = readRecordedAgentIds(ctx.sessionManager.getEntries(), record.sessionId);
     });
     pi.on("session_shutdown", () => {
         const state = sessionState;
-        if (state.scopeKey && statesByScope.get(state.scopeKey) === state)
-            statesByScope.delete(state.scopeKey);
+        if (state.runtimeScopeKey && statesByScope.get(state.runtimeScopeKey) === state)
+            statesByScope.delete(state.runtimeScopeKey);
         state.appendEntry = undefined;
         state.sessionId = undefined;
         state.sessionFile = undefined;
         state.scopeKey = undefined;
+        state.runtimeScopeKey = undefined;
         state.cwd = undefined;
         state.recordedAgentIds = new Set();
     });
@@ -111,6 +114,7 @@ function resetStateForTests() {
     state.sessionId = undefined;
     state.sessionFile = undefined;
     state.scopeKey = undefined;
+    state.runtimeScopeKey = undefined;
     state.cwd = undefined;
     state.recordedAgentIds = new Set();
 }

package/dist/cursor-session-agent-resume.js

@@ -266,7 +266,7 @@ function restoreFromBranch(branch, allEntries, state) {
 }
 export function getMatchingCursorSessionAgentResumeHandle(poolKey, scopeKey) {
     const state = getResumeState(scopeKey);
-    if (scopeKey !== undefined && state.scopeKey !== scopeKey)
+    if (scopeKey !== undefined && (state.runtimeScopeKey ?? state.scopeKey) !== scopeKey)
         return undefined;
     const handle = state.activeHandle;
     if (!handle || !isCursorLocalAgentId(handle.agentId))
@@ -292,7 +292,7 @@ export function getMatchingCursorSessionAgentResumeHandle(poolKey, scopeKey) {
 }
 export function persistCursorSessionAgentResumeHandle(input, scopeKey) {
     const state = getResumeState(scopeKey);
-    if (scopeKey !== undefined && state.scopeKey !== scopeKey)
+    if (scopeKey !== undefined && (state.runtimeScopeKey ?? state.scopeKey) !== scopeKey)
         return;
     if (!isCursorLocalAgentId(input.agentId))
         return;
@@ -343,8 +343,9 @@ function flushPendingCursorSessionAgentResumeHandle(branch, state) {
     }
 }
 export function registerCursorSessionAgentResume(pi) {
+    const scope = getCursorSessionScopeSnapshot(pi);
     const sessionState = {
-        appendEntry: pi.appendEntry, scopeKey: getCursorSessionScopeSnapshot(pi).scopeKey,
+        appendEntry: pi.appendEntry, scopeKey: scope.persistentScopeKey ?? scope.scopeKey,
         cwd: process.cwd(), branchPathHash: EMPTY_BRANCH_HASH,
         compactionGeneration: 0, unownedUserEntryIds: new Set(),
     };
@@ -355,10 +356,13 @@ export function registerCursorSessionAgentResume(pi) {
         restoreFromBranch(branch, entries.length > 0 ? entries : branch, state);
     };
     pi.on("session_start", (_event, ctx) => {
-        if (statesByScope.get(state.scopeKey) === state)
-            statesByScope.delete(state.scopeKey);
-        state.scopeKey = getCursorSessionScopeSnapshot(pi).scopeKey;
-        statesByScope.set(state.scopeKey, state);
+        const key = state.runtimeScopeKey ?? state.scopeKey;
+        if (statesByScope.get(key) === state)
+            statesByScope.delete(key);
+        const scope = getCursorSessionScopeSnapshot(pi);
+        state.runtimeScopeKey = scope.scopeKey;
+        state.scopeKey = scope.persistentScopeKey ?? scope.scopeKey;
+        statesByScope.set(scope.scopeKey, state);
         lastBoundState = state;
         state.sessionFile = ctx.sessionManager.getSessionFile?.() ?? undefined;
         state.sessionId = ctx.sessionManager.getSessionId?.() ?? undefined;
@@ -399,8 +403,9 @@ export function registerCursorSessionAgentResume(pi) {
         state.branchPathHash = hashBranchStep(state.branchPathHash, event.compactionEntry);
     });
     pi.on("session_shutdown", () => {
-        if (statesByScope.get(state.scopeKey) === state)
-            statesByScope.delete(state.scopeKey);
+        const key = state.runtimeScopeKey ?? state.scopeKey;
+        if (statesByScope.get(key) === state)
+            statesByScope.delete(key);
         state.appendEntry = undefined;
         state.pendingHandle = undefined;
     });
@@ -412,6 +417,7 @@ function resetStateForTests() {
     const state = lastBoundState;
     state.appendEntry = undefined;
     state.scopeKey = getCursorSessionScopeKey();
+    state.runtimeScopeKey = undefined;
     state.sessionFile = undefined;
     state.sessionId = undefined;
     state.cwd = process.cwd();