pi-cursor-sdk 0.5.0 → 0.5.3

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

@@ -1,4 +1,4 @@
-// Generated with @cursor/sdk@1.0.32 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-fallback-warning.js

@@ -1,10 +1,11 @@
 import { isCursorModel } from "./cursor-model.js";
 import { registerCursorModelLifecycle } from "./cursor-model-lifecycle.js";
 import { cursorSessionScopeKeyForManager } from "./cursor-session-scope.js";
-export function registerCursorFallbackIssueWarning(pi, issue) {
+export function registerCursorFallbackIssueWarning(pi) {
+    let issue;
     const warnedSessionScopeKeys = new Set();
     registerCursorModelLifecycle(pi, (ctx) => {
-        if (!isCursorModel(ctx.model) || !ctx.hasUI)
+        if (!issue || !isCursorModel(ctx.model) || !ctx.hasUI)
             return;
         const scopeKey = cursorSessionScopeKeyForManager(ctx.sessionManager);
         if (warnedSessionScopeKeys.has(scopeKey))
@@ -12,4 +13,9 @@ export function registerCursorFallbackIssueWarning(pi, issue) {
         warnedSessionScopeKeys.add(scopeKey);
         ctx.ui.notify(issue.message, "warning");
     });
+    return (nextIssue) => {
+        if (nextIssue?.reason !== issue?.reason || nextIssue?.message !== issue?.message)
+            warnedSessionScopeKeys.clear();
+        issue = nextIssue;
+    };
 }

package/dist/cursor-live-run-coordinator.js

@@ -171,6 +171,11 @@ export function createCursorLiveRunCoordinator(deps) {
                 leased: false,
                 leaseQueue: [],
             });
+            const state = getPrivateState(run);
+            state.pendingCallUnsubscribers = [...new Set([run.bridgeRun, run.sessionBridgeRun])].flatMap((bridge) => bridge ? [bridge.onPendingToolCallsChanged(() => {
+                    if (state.idleDisposeRequested || state.idleDisposeTimer)
+                        coordinator.requestIdleDispose(run);
+                })] : []);
             pendingRuns.set(run.id, run);
             pendingRunIdsByScopeKey.set(sessionAgentScopeKey, run.id);
             return run;
@@ -343,10 +348,16 @@ export function createCursorLiveRunCoordinator(deps) {
             const state = getPrivateState(run);
             clearIdleDisposeTimer(run);
             state.idleDisposeRequested = true;
-            if (state.leased || state.leaseQueue.length > 0)
+            if (state.leased || state.leaseQueue.length > 0 ||
+                [run.bridgeRun, run.sessionBridgeRun].some((bridge) => bridge?.hasPendingToolCalls()))
                 return;
-            state.idleDisposeRequested = false;
             state.idleDisposeTimer = setTimeout(() => {
+                state.idleDisposeTimer = undefined;
+                if (state.leased || state.leaseQueue.length > 0 ||
+                    [run.bridgeRun, run.sessionBridgeRun].some((bridge) => bridge?.hasPendingToolCalls())) {
+                    coordinator.requestIdleDispose(run);
+                    return;
+                }
                 void coordinator.release(run).catch(() => {
                     // Idle dispose must not leave release failures as unhandled rejections.
                 });
@@ -362,6 +373,15 @@ export function createCursorLiveRunCoordinator(deps) {
                     return;
                 const abandoned = !isSuccessfulCursorLiveRun(run);
                 run.disposed = true;
+                for (const unsubscribe of state.pendingCallUnsubscribers ?? []) {
+                    try {
+                        unsubscribe();
+                    }
+                    catch {
+                        // Cleanup continues even if an observer cannot detach.
+                    }
+                }
+                state.pendingCallUnsubscribers = [];
                 unregister(run);
                 clearIdleDisposeTimer(run);
                 state.idleDisposeRequested = false;

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,9 @@ export function isCursorSdkMcpToolTimeoutStack(stack) {
 export function isCursorSdkMcpConnectTimeoutStack(stack) {
     if (!stack || !isCursorSdkMcpProtocolTimeoutStack(stack))
         return false;
-    return /\bClient\.(?:connect|listTools)\b|\bMcpSdkClient\.getTools\b/.test(stack);
+    // 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);
 }
 function isCursorSdkDefaultMcpTimeout(delay) {
     return typeof delay === "number" && delay === CURSOR_SDK_MCP_DEFAULT_TIMEOUT_MS;

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

@@ -20,6 +20,7 @@ export class CursorPiToolBridgeRunImpl {
     knownMcpToolNames;
     knownCursorMcpCallIds = new Set();
     queuedRequests = [];
+    pendingToolCallListeners = new Set();
     pendingByPiToolCallId = new Map();
     pendingByBridgeCallId = new Map();
     pendingByCursorMcpCallId = new Map();
@@ -129,6 +130,23 @@ export class CursorPiToolBridgeRunImpl {
     hasPendingPiToolCallId(piToolCallId) {
         return this.pendingByPiToolCallId.has(piToolCallId);
     }
+    hasPendingToolCalls() {
+        return this.pendingCount() > 0;
+    }
+    onPendingToolCallsChanged(listener) {
+        this.pendingToolCallListeners.add(listener);
+        return () => { this.pendingToolCallListeners.delete(listener); };
+    }
+    notifyPendingToolCallsChanged() {
+        for (const listener of this.pendingToolCallListeners) {
+            try {
+                listener();
+            }
+            catch {
+                // Observers must not prevent call registration or protocol settlement.
+            }
+        }
+    }
     cancelPendingPiToolCallId(piToolCallId, reason) {
         const pending = this.pendingByPiToolCallId.get(piToolCallId);
         if (!pending)
@@ -173,6 +191,7 @@ export class CursorPiToolBridgeRunImpl {
             return;
         this.disposed = true;
         this.cancel("Cursor pi tool bridge run disposed");
+        this.pendingToolCallListeners.clear();
         await waitForProtocolFlush();
         await Promise.allSettled([
             this.mcpTransport?.close(),
@@ -189,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);
         });
@@ -241,6 +267,7 @@ export class CursorPiToolBridgeRunImpl {
             this.pendingByBridgeCallId.set(request.bridgeCallId, pending);
             this.pendingByCursorMcpCallId.set(cursorMcpCallId, pending);
             this.knownCursorMcpCallIds.add(cursorMcpCallId);
+            this.notifyPendingToolCallsChanged();
             pending.timeout = setTimeout(() => {
                 const reason = `Cursor pi bridge CallTool timed out after ${this.callTimeoutMs} ms`;
                 this.rejectAndAbortPending(pending, new Error(reason));
@@ -352,5 +379,6 @@ export class CursorPiToolBridgeRunImpl {
         const queuedIndex = this.queuedRequests.findIndex((request) => request.bridgeCallId === pending.request.bridgeCallId);
         if (queuedIndex >= 0)
             this.queuedRequests.splice(queuedIndex, 1);
+        this.notifyPendingToolCallsChanged();
     }
 }

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

@@ -1,5 +1,6 @@
 import { createServer } from "node:http";
 import { asRecord } from "./cursor-record-utils.js";
+import { CursorPiToolBridgeRunImpl } from "./cursor-pi-tool-bridge-run.js";
 import { buildCursorPiToolBridgeSnapshot, buildCursorPiToolBridgeSurfaceSignature, createEmptySnapshot, resolveCursorPiToolBridgeBuiltinsEnabled, resolveCursorPiToolBridgeEnabled, } from "./cursor-pi-tool-bridge-snapshot.js";
 export const LOOPBACK_HOST = "127.0.0.1";
 const HTTP_SERVER_CLOSE_GRACE_MS = 250;
@@ -33,7 +34,6 @@ export class CursorPiToolBridgeRegistry {
                 exposeOverlappingBuiltins: resolveCursorPiToolBridgeBuiltinsEnabled(this.env),
             })
             : createEmptySnapshot();
-        const { CursorPiToolBridgeRunImpl } = await import("./cursor-pi-tool-bridge-run.js");
         const run = new CursorPiToolBridgeRunImpl(this, this.env, snapshot, bridgeEnabled && snapshot.tools.length > 0, options);
         this.runs.add(run);
         await run.start();