pi-cursor-sdk 0.5.3 → 0.5.4

package/dist/context.js

@@ -11,7 +11,9 @@ export function getCursorPlanModeToolGuidanceText(agentMode, options = {}) {
         return undefined;
     return [
         "Cursor SDK mode is plan for this run. In pi-cursor-sdk, plan mode may still use available Cursor SDK/MCP tools for inspection when needed.",
-        "Safe/read-only shell commands that inspect or print information are allowed when Cursor chooses to call Shell; do not say Shell is blocked by plan mode and then call it anyway.",
+        options.nativeToolsEnabled === false
+            ? "Only MCP tools exposed in this run are callable; native Shell and task/subagents are disabled."
+            : "Safe/read-only shell commands that inspect or print information are allowed when Cursor chooses to call Shell; do not say Shell is blocked by plan mode and then call it anyway.",
         options.includePiBridgeGuidance === false
             ? undefined
             : "Exposed pi__* bridge tools are also callable in plan mode when the user asks for them or they are needed to answer.",
@@ -19,14 +21,16 @@ export function getCursorPlanModeToolGuidanceText(agentMode, options = {}) {
 }
 export function getCursorToolTailGuardText(options = {}) {
     return [
-        "Shell: use explicit `cd` to repo path for project commands; session cwd may differ from tool args.",
+        options.nativeToolsEnabled === false ? undefined : "Shell: use explicit `cd` to repo path for project commands; session cwd may differ from tool args.",
         options.includePlanModeGuidance === false
             ? undefined
-            : getCursorPlanModeToolGuidanceText(options.agentMode, { includePiBridgeGuidance: options.includePiBridgeGuidance }),
+            : getCursorPlanModeToolGuidanceText(options.agentMode, { includePiBridgeGuidance: options.includePiBridgeGuidance, nativeToolsEnabled: options.nativeToolsEnabled }),
         "Exact-output requests: output exactly the requested text; no preamble or checks unless asked.",
         "Tools: call available Cursor SDK/MCP tools; never print tool cards as assistant text.",
         "Do not comment on GitHub issues or PRs unless the user asked.",
-        options.includePiBridgeGuidance === false ? undefined : CURSOR_PI_BRIDGE_PREFERENCE_TEXT,
+        options.includePiBridgeGuidance === false ? undefined : options.nativeToolsEnabled === false
+            ? "Use only exposed pi__* MCP names for Pi work; native task/subagents are disabled."
+            : CURSOR_PI_BRIDGE_PREFERENCE_TEXT,
     ].filter((line) => line !== undefined).join("\n");
 }
 function getCursorToolBoundaryText(options = {}) {
@@ -35,12 +39,13 @@ function getCursorToolBoundaryText(options = {}) {
     const lines = [
         "Cursor SDK tool boundary:",
         "Call only Cursor SDK/MCP tools exposed in this run; pi history names, replay labels, and transcript names are not callable.",
+        options.nativeToolsEnabled === false ? "Cursor native tools (including task/subagents): disabled. Only exposed MCP tools are callable." : undefined,
         includePiBridgeGuidance
             ? "For exposed pi bridge tools, call pi__* MCP names, not pi card/history names."
             : undefined,
         "Do not claim pi-side or WebSearch/WebFetch tools unless Cursor ran an equivalent tool.",
         includePiAskQuestionGuidance ? "Use pi__cursor_ask_question only if the user asked to be prompted." : undefined,
-        getCursorPlanModeToolGuidanceText(options.agentMode, { includePiBridgeGuidance }),
+        getCursorPlanModeToolGuidanceText(options.agentMode, { includePiBridgeGuidance, nativeToolsEnabled: options.nativeToolsEnabled }),
         "Images: only latest user images are sent; ask to reattach prior images.",
     ].filter((line) => line !== undefined);
     if (options.hasToolManifest) {
@@ -354,6 +359,7 @@ export function buildCursorPrompt(context, options = {}) {
             agentMode: options.agentMode,
             hasToolManifest: Boolean(options.toolManifest),
             includePiBridgeGuidance: options.includePiBridgeGuidance,
+            nativeToolsEnabled: options.nativeToolsEnabled,
             includePiAskQuestionGuidance: options.includePiAskQuestionGuidance,
         })];
     if (options.toolManifest) {

package/dist/cursor-agents-context.js

@@ -17,7 +17,7 @@ function normalizeDirPath(dirPath) {
 }
 /** Pi context filenames that can overlap Cursor project/user ambient rules. */
 const CURSOR_OVERLAPPING_CONTEXT_BASE_NAMES = new Set(["agents.md", "claude.md"]);
-export function getAgentsContextFileBaseName(filePath) {
+function getAgentsContextFileBaseName(filePath) {
     const normalized = normalizeContextPath(filePath);
     return normalized.slice(normalized.lastIndexOf("/") + 1).toLowerCase();
 }
@@ -27,11 +27,11 @@ function isPiAgentDirContextFilePath(filePath, fileName, agentDir = getAgentDir(
     return normalized.toLowerCase() === expectedPath.toLowerCase();
 }
 /** Actual pi agent dir `AGENTS.md` — overlaps Cursor `user` setting source (global agent instructions). */
-export function isPiAgentDirAgentsMdPath(filePath, agentDir = getAgentDir()) {
+function isPiAgentDirAgentsMdPath(filePath, agentDir = getAgentDir()) {
     return isPiAgentDirContextFilePath(filePath, "agents.md", agentDir);
 }
 /** Actual pi agent dir `CLAUDE.md` — kept because Cursor user rules use `~/.claude/CLAUDE.md`. */
-export function isPiAgentDirClaudeMdPath(filePath, agentDir = getAgentDir()) {
+function isPiAgentDirClaudeMdPath(filePath, agentDir = getAgentDir()) {
     return isPiAgentDirContextFilePath(filePath, "claude.md", agentDir);
 }
 /**
@@ -40,7 +40,7 @@ export function isPiAgentDirClaudeMdPath(filePath, agentDir = getAgentDir()) {
  * Only the actual pi agent dir `AGENTS.md` overlaps Cursor `user`; agent-dir `CLAUDE.md` is kept
  * because Cursor user rules use `~/.claude/CLAUDE.md`, not pi's agent dir path.
  */
-export function classifyContextFileOverlap(filePath, agentDir = getAgentDir()) {
+function classifyContextFileOverlap(filePath, agentDir = getAgentDir()) {
     const base = getAgentsContextFileBaseName(filePath);
     if (!CURSOR_OVERLAPPING_CONTEXT_BASE_NAMES.has(base))
         return "none";
@@ -50,7 +50,7 @@ export function classifyContextFileOverlap(filePath, agentDir = getAgentDir()) {
         return "none";
     return "cursor-project-rules";
 }
-export function shouldRemovePiAgentsContextFile(file, settingSources, agentDir) {
+function shouldRemovePiAgentsContextFile(file, settingSources, agentDir) {
     switch (classifyContextFileOverlap(file.path, agentDir)) {
         case "cursor-user-agents":
             return cursorSettingSourcesIncludes(settingSources, "user");
@@ -60,7 +60,7 @@ export function shouldRemovePiAgentsContextFile(file, settingSources, agentDir)
             return false;
     }
 }
-export function shouldSuppressPiAgentsContext(model, contextFiles, settingSources, agentDir) {
+function shouldSuppressPiAgentsContext(model, contextFiles, settingSources, agentDir) {
     if (!isCursorModel(model))
         return false;
     if (parseEnvBoolean(process.env[CURSOR_PRESERVE_PI_AGENTS_MD_ENV], false))

package/dist/cursor-api-key.js

@@ -2,7 +2,7 @@ import { envApiKeyAuth } from "@earendil-works/pi-ai";
 import { parseEnvBoolean } from "./cursor-env-boolean.js";
 export const CURSOR_API_KEY_ENV_VAR = "CURSOR_API_KEY";
 // Legacy no-auth availability policy only; never a configured models.json key.
-export const CURSOR_API_KEY_CONFIG_VALUE = "pi-cursor-sdk-cursor-api-key-placeholder";
+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_ENV_VAR}`,

package/dist/cursor-bridge-contract.js

@@ -1,17 +1,5 @@
 export const CURSOR_PI_BRIDGE_MCP_TOOL_PREFIX = "pi__";
-export const CURSOR_PI_BRIDGE_PREFERENCE_TEXT = "When exposed, prefer pi__mcp for MCP work and pi__subagent for delegation; use Cursor-configured MCP or Cursor-native subagents only when the matching pi__ tool is not exposed or unavailable.";
-const CURSOR_PI_BRIDGE_CONTRACT_LINES = [
-    "Pi bridge contract:",
-    `${CURSOR_PI_BRIDGE_MCP_TOOL_PREFIX}* names are live Cursor MCP bridge tool names only when exposed in the current run.`,
-    `Call the ${CURSOR_PI_BRIDGE_MCP_TOOL_PREFIX}* MCP tool name, not the real pi tool name shown in pi history or transcripts.`,
-    CURSOR_PI_BRIDGE_PREFERENCE_TEXT,
-    "Bridged calls execute through normal pi tool flow, so pi shows the real pi tool name and returns a normal pi tool result.",
-    "Replay IDs, replay labels, and transcript tool names are display-only/context-only, not callable tools.",
-    "Cursor-native host tools, settings, plugins, and configured MCP servers are separate from the pi bridge.",
-];
-export function getCursorPiBridgeContractText() {
-    return CURSOR_PI_BRIDGE_CONTRACT_LINES.join("\n");
-}
+export const CURSOR_PI_BRIDGE_PREFERENCE_TEXT = "For MCP work and delegation, prefer matching exposed pi__* tools using their listed names, schemas, and prompt guidelines; use Cursor-configured MCP or Cursor-native subagents only when the matching pi tool is not exposed or unavailable.";
 function formatPromptGuidelines(promptGuidelines) {
     const guidelines = promptGuidelines?.map((guideline) => guideline.trim()).filter(Boolean) ?? [];
     if (guidelines.length === 0)

package/dist/cursor-cloud-local-state.js

@@ -457,4 +457,3 @@ export function inspectCursorCloudLocalState(cwd, target = {}, runGit = runCurso
     }
     return { insideGitRepo: true, dirty: dirty, comparison: aheadCount > 0 ? "unpushed" : "contains_head" };
 }
-export const __testUtils = { sourceForDestination };

package/dist/cursor-config.js

@@ -231,7 +231,7 @@ function readCursorSdkConfigFile(path) {
         return {};
     }
 }
-export function loadCursorSdkConfigForUpdate(path) {
+function loadCursorSdkConfigForUpdate(path) {
     if (!existsSync(path))
         return {};
     let source;
@@ -342,16 +342,6 @@ export function updateCursorSdkConfig(path, update, options = {}) {
         return updated;
     });
 }
-export function saveCursorSdkUserConfig(config, path = getCursorSdkUserConfigPath()) {
-    updateCursorSdkConfig(path, () => ({ ...config }), { newFileMode: 0o600 });
-}
-export function saveCursorSdkProjectConfig(cwd, config, configDirName = CONFIG_DIR_NAME) {
-    const path = getCursorSdkProjectConfigPath(cwd, configDirName);
-    updateCursorSdkConfig(path, () => ({ ...config }));
-}
-export function mergeCursorSdkConfig(base, patch) {
-    return mergeCursorSdkConfigForUpdate({ ...base }, patch);
-}
 export function mergeCursorSdkConfigForUpdate(base, patch) {
     const baseCloud = asRecord(base.cloud);
     const baseLocal = asRecord(base.local);
@@ -378,12 +368,6 @@ export function mergeCursorSdkConfigForUpdate(base, patch) {
 export function cursorFastDefaultsFromConfig(config) {
     return new Map(Object.entries(config?.fastDefaults ?? {}));
 }
-export function withCursorFastDefaults(config, fastDefaults) {
-    return {
-        ...config,
-        fastDefaults: Object.fromEntries([...fastDefaults.entries()].sort(([a], [b]) => a.localeCompare(b))),
-    };
-}
 function resolved(source, value, cappedBy) {
     return { value, source, trustLevel: TRUST_LEVELS[source], ...(cappedBy ? { cappedBy } : {}) };
 }

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

@@ -1,4 +1,4 @@
-// Generated with @cursor/sdk@1.0.37 from 46 Cursor models.
+// Generated with @cursor/sdk@1.0.37 from 48 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 = [
@@ -6516,6 +6516,60 @@ export const FALLBACK_MODEL_ITEMS = [
             }
         ]
     },
+    {
+        id: "gemini-4-argon",
+        displayName: "Gemini 4 Argon",
+        parameters: [
+            {
+                id: "reasoning_effort",
+                displayName: "Effort",
+                values: [
+                    {
+                        value: "low",
+                        displayName: "Low"
+                    },
+                    {
+                        value: "medium",
+                        displayName: "Medium"
+                    },
+                    {
+                        value: "high",
+                        displayName: "High"
+                    }
+                ]
+            }
+        ],
+        variants: [
+            {
+                params: [
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Gemini 4 Argon Low"
+            },
+            {
+                params: [
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Gemini 4 Argon Medium",
+                isDefault: true
+            },
+            {
+                params: [
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Gemini 4 Argon High"
+            }
+        ]
+    },
     {
         id: "glm-5.2",
         displayName: "GLM 5.2",
@@ -10155,5 +10209,214 @@ export const FALLBACK_MODEL_ITEMS = [
                 displayName: "Muse Spark 1.3"
             }
         ]
+    },
+    {
+        id: "muse-wonder-1.0",
+        displayName: "Muse Wonder",
+        parameters: [
+            {
+                id: "context",
+                displayName: "Context",
+                values: [
+                    {
+                        value: "300k",
+                        displayName: "300K"
+                    },
+                    {
+                        value: "1m",
+                        displayName: "1M"
+                    }
+                ]
+            },
+            {
+                id: "reasoning_effort",
+                displayName: "Reasoning",
+                values: [
+                    {
+                        value: "minimal",
+                        displayName: "Minimal"
+                    },
+                    {
+                        value: "low",
+                        displayName: "Low"
+                    },
+                    {
+                        value: "medium",
+                        displayName: "Medium"
+                    },
+                    {
+                        value: "high",
+                        displayName: "High"
+                    },
+                    {
+                        value: "xhigh",
+                        displayName: "Extra High"
+                    },
+                    {
+                        value: "max",
+                        displayName: "Max"
+                    }
+                ]
+            }
+        ],
+        variants: [
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "minimal"
+                    }
+                ],
+                displayName: "Muse Wonder  Minimal"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Muse Wonder  Low"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Muse Wonder  Medium"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Muse Wonder  High"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "xhigh"
+                    }
+                ],
+                displayName: "Muse Wonder  Extra High"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "300k"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "max"
+                    }
+                ],
+                displayName: "Muse Wonder  Max"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "minimal"
+                    }
+                ],
+                displayName: "Muse Wonder 1M Minimal"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "low"
+                    }
+                ],
+                displayName: "Muse Wonder 1M Low"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "medium"
+                    }
+                ],
+                displayName: "Muse Wonder 1M Medium"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "high"
+                    }
+                ],
+                displayName: "Muse Wonder 1M High"
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "xhigh"
+                    }
+                ],
+                displayName: "Muse Wonder 1M Extra High",
+                isDefault: true
+            },
+            {
+                params: [
+                    {
+                        id: "context",
+                        value: "1m"
+                    },
+                    {
+                        id: "reasoning_effort",
+                        value: "max"
+                    }
+                ],
+                displayName: "Muse Wonder 1M Max"
+            }
+        ]
     }
 ];

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

@@ -150,6 +150,7 @@ export function createCursorLiveRunCoordinator(deps) {
             const run = {
                 id: params.id,
                 agent: params.agent,
+                nativeToolsEnabled: params.nativeToolsEnabled !== false,
                 bridgeRun: params.bridgeRun,
                 sessionBridgeRun: params.sessionBridgeRun,
                 sessionAgentScopeKey,

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

@@ -36,7 +36,7 @@ function normalizeConnectTimeoutMs(timeoutMs) {
         return DEFAULT_CURSOR_MCP_CONNECT_TIMEOUT_MS;
     return Math.min(Math.max(Math.trunc(timeoutMs), MIN_CURSOR_MCP_CONNECT_TIMEOUT_MS), CURSOR_SDK_MCP_DEFAULT_TIMEOUT_MS);
 }
-export function resolveCursorMcpConnectTimeoutMs(env = process.env) {
+function resolveCursorMcpConnectTimeoutMs(env = process.env) {
     const explicitMs = parsePositiveNumber(env[CURSOR_MCP_CONNECT_TIMEOUT_MS_ENV]);
     if (explicitMs !== undefined)
         return normalizeConnectTimeoutMs(explicitMs);
@@ -51,13 +51,13 @@ function isCursorSdkMcpProtocolTimeoutStack(stack) {
     return (/(?:node_modules[/\\]@cursor[/\\]sdk|node_modules\/\@cursor\/sdk|@cursor\/sdk\/dist)/.test(stack) &&
         /\b_setupTimeout\b|\bProtocol\._setupTimeout\b/.test(stack));
 }
-export function isCursorSdkMcpToolTimeoutStack(stack) {
+function isCursorSdkMcpToolTimeoutStack(stack) {
     if (!stack)
         return false;
     return (isCursorSdkMcpProtocolTimeoutStack(stack) &&
         /\bcallTool\b|\bClient\.callTool\b|\bMcpSdkClient\.callTool\b/.test(stack));
 }
-export function isCursorSdkMcpConnectTimeoutStack(stack) {
+function isCursorSdkMcpConnectTimeoutStack(stack) {
     if (!stack || !isCursorSdkMcpProtocolTimeoutStack(stack))
         return false;
     // The SDK minifies the Client class name; the protocol method and SDK
@@ -83,9 +83,9 @@ function patchedSetTimeout(handler, delay, ...args) {
     }
     return Reflect.apply(delegate, globalThis, [handler, nextDelay, ...args]);
 }
-export function installCursorMcpToolTimeoutOverride(options = {}) {
-    installedToolTimeoutMs = normalizeOverrideTimeoutMs(options.timeoutMs ?? resolveCursorMcpToolTimeoutMs(options.env));
-    installedConnectTimeoutMs = normalizeConnectTimeoutMs(options.connectTimeoutMs ?? resolveCursorMcpConnectTimeoutMs(options.env));
+export function installCursorMcpToolTimeoutOverride() {
+    installedToolTimeoutMs = resolveCursorMcpToolTimeoutMs();
+    installedConnectTimeoutMs = resolveCursorMcpConnectTimeoutMs();
     if (!originalSetTimeout) {
         originalSetTimeout = globalThis.setTimeout;
         globalThis.setTimeout = patchedSetTimeout;
@@ -105,14 +105,3 @@ export function restoreCursorMcpToolTimeoutOverride() {
     installedToolTimeoutMs = DEFAULT_CURSOR_MCP_TOOL_TIMEOUT_MS;
     installedConnectTimeoutMs = DEFAULT_CURSOR_MCP_CONNECT_TIMEOUT_MS;
 }
-export const cursorMcpToolTimeoutOverrideDefaults = {
-    cursorSdkDefaultTimeoutMs: CURSOR_SDK_MCP_DEFAULT_TIMEOUT_MS,
-    defaultOverrideTimeoutMs: DEFAULT_CURSOR_MCP_TOOL_TIMEOUT_MS,
-    defaultConnectTimeoutMs: DEFAULT_CURSOR_MCP_CONNECT_TIMEOUT_MS,
-    minConnectTimeoutMs: MIN_CURSOR_MCP_CONNECT_TIMEOUT_MS,
-    maxNodeTimerDelayMs: MAX_NODE_TIMER_DELAY_MS,
-    timeoutMsEnv: CURSOR_MCP_TOOL_TIMEOUT_MS_ENV,
-    timeoutSecondsEnv: CURSOR_MCP_TOOL_TIMEOUT_SECONDS_ENV,
-    connectTimeoutMsEnv: CURSOR_MCP_CONNECT_TIMEOUT_MS_ENV,
-    connectTimeoutSecondsEnv: CURSOR_MCP_CONNECT_TIMEOUT_SECONDS_ENV,
-};

package/dist/cursor-native-tool-display-replay.js

@@ -8,9 +8,9 @@ import { inferImageMimeType } from "./cursor-tool-result-display-readers.js";
 import { LOCAL_READ_PREVIEW_NOTICE, isLocalReadPreviewContent } from "./cursor-transcript-utils.js";
 import { CURSOR_REPLAY_ACTIVITY_TOOL_NAME, getCursorReplayCallSummary, shouldShowCursorReplayCollapsedExpandHint, } from "./cursor-tool-presentation-registry.js";
 import { CURSOR_REPLAY_GENERATE_IMAGE_RESULT_TITLE, isCursorReplayGenerateImageDetails, isCursorReplayActivityDetails, parseCursorReplayToolDetails, } from "./cursor-replay-tool-details.js";
-export { isCursorReplayNativeEditDetails, isCursorReplayGenerateImageDetails, isCursorReplayActivityDetails, isCursorReplayNativeWriteDetails, parseCursorReplayToolDetails, } from "./cursor-replay-tool-details.js";
+export { isCursorReplayNativeEditDetails, isCursorReplayNativeWriteDetails, parseCursorReplayToolDetails, } from "./cursor-replay-tool-details.js";
 export const CURSOR_REPLAY_COLLAPSED_PREVIEW_LINES = 8;
-export const CURSOR_REPLAY_PREVIEW_MAX_CHARS = 4000;
+const CURSOR_REPLAY_PREVIEW_MAX_CHARS = 4000;
 export const CURSOR_REPLAY_PREVIEW_MAX_LINE_CHARS = 240;
 const CURSOR_REPLAY_HIGHLIGHT_MAX_CHARS = 12000;
 export const cursorReplayToolSchema = Type.Object({}, { additionalProperties: true });
@@ -40,7 +40,7 @@ function buildImageReplayComponent(text, imageData, mimeType, filename, theme) {
         },
     };
 }
-export function getCursorReplayPath(args, details) {
+function getCursorReplayPath(args, details) {
     const argPath = args?.path;
     return details?.path ?? (typeof argPath === "string" && argPath.trim() ? argPath : "unknown");
 }
@@ -202,7 +202,7 @@ function formatCursorReplayActivityPreview(details, text, theme, maxLines, strip
     }
     return stripHeader ? formatCursorReplayPreview(text, theme, maxLines, true) : formatMutedBlock(text, theme);
 }
-export function formatCursorReplayPreview(text, theme, maxLines = CURSOR_REPLAY_COLLAPSED_PREVIEW_LINES, stripHeader = true) {
+function formatCursorReplayPreview(text, theme, maxLines = CURSOR_REPLAY_COLLAPSED_PREVIEW_LINES, stripHeader = true) {
     const body = (stripHeader ? stripCursorReplayHeader(text) : text).trimEnd();
     if (!body)
         return undefined;
@@ -240,7 +240,7 @@ function getCursorReplayCardTitle(toolName, args) {
     }
     return "Cursor activity";
 }
-export function renderCursorReplayCall(toolName, args, theme, isPartial) {
+function renderCursorReplayCall(toolName, args, theme, isPartial) {
     if (!isPartial)
         return new Text("", 0, 0);
     let text = theme.fg("toolTitle", theme.bold(`${getCursorReplayCardTitle(toolName, args)} `));

package/dist/cursor-native-tools.js

@@ -0,0 +1,11 @@
+import { parseEnvBoolean } from "./cursor-env-boolean.js";
+export const CURSOR_NATIVE_TOOLS_ENV = "PI_CURSOR_NATIVE_TOOLS";
+/** Default preserves the SDK toolset; false selects the public MCP-only main loop. */
+export function resolveCursorNativeToolsEnabled(env = process.env) {
+    return parseEnvBoolean(env[CURSOR_NATIVE_TOOLS_ENV], true);
+}
+export function assertCursorNativeToolsRuntime(runtime, nativeToolsEnabled) {
+    if (runtime === "cloud" && !nativeToolsEnabled) {
+        throw new Error("PI_CURSOR_NATIVE_TOOLS=0 requires local runtime; Cursor Cloud does not support the SDK tools restriction. Select local runtime or remove the opt-out.");
+    }
+}

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

@@ -1,8 +1,8 @@
 import { parseEnvBoolean } from "./cursor-env-boolean.js";
 import { resolveCursorMcpToolTimeoutMs } from "./cursor-mcp-timeout-override.js";
 export const CURSOR_PI_TOOL_BRIDGE_ENV = "PI_CURSOR_PI_TOOL_BRIDGE";
-export const CURSOR_PI_TOOL_BRIDGE_BUILTINS_ENV = "PI_CURSOR_EXPOSE_BUILTIN_TOOLS";
-export const CURSOR_PI_TOOL_BRIDGE_CALL_TIMEOUT_MS_ENV = "PI_CURSOR_PI_BRIDGE_CALL_TIMEOUT_MS";
+const CURSOR_PI_TOOL_BRIDGE_BUILTINS_ENV = "PI_CURSOR_EXPOSE_BUILTIN_TOOLS";
+const CURSOR_PI_TOOL_BRIDGE_CALL_TIMEOUT_MS_ENV = "PI_CURSOR_PI_BRIDGE_CALL_TIMEOUT_MS";
 export function resolveCursorPiToolBridgeEnabled(env = process.env) {
     return parseEnvBoolean(env[CURSOR_PI_TOOL_BRIDGE_ENV], true);
 }
@@ -16,3 +16,26 @@ export function resolveCursorPiToolBridgeCallTimeoutMs(env = process.env) {
         return mcpToolTimeoutMs;
     return Math.min(Math.max(Math.trunc(parsed), 1), mcpToolTimeoutMs);
 }
+const CURSOR_PI_TOOL_BRIDGE_HOST_ENV = "PI_CURSOR_PI_TOOL_BRIDGE_HOST";
+const CURSOR_PI_TOOL_BRIDGE_PORT_ENV = "PI_CURSOR_PI_TOOL_BRIDGE_PORT";
+const DEFAULT_URL_HOST = "127.0.0.1";
+const PORT_PATTERN = /^\d{1,5}$/;
+export function resolveCursorPiToolBridgeUrlHost(env = process.env) {
+    return env[CURSOR_PI_TOOL_BRIDGE_HOST_ENV]?.trim().toLowerCase() === "localhost" ? "localhost" : DEFAULT_URL_HOST;
+}
+function parsePort(text) {
+    if (!PORT_PATTERN.test(text))
+        return undefined;
+    const port = Number(text);
+    return port >= 1 && port <= 65535 ? port : undefined;
+}
+export function resolveCursorPiToolBridgePortRange(env = process.env) {
+    const parts = env[CURSOR_PI_TOOL_BRIDGE_PORT_ENV]?.trim().split("-");
+    if (!parts || parts.length > 2)
+        return undefined;
+    const first = parsePort(parts[0]);
+    const last = parts.length === 2 ? parsePort(parts[1]) : first;
+    if (first === undefined || last === undefined || first > last)
+        return undefined;
+    return { first, last };
+}