pi-cursor-sdk 0.5.2 → 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) {
@@ -90,7 +95,7 @@ function formatContentBlocks(content) {
 }
 function formatToolCall(toolCall) {
     const args = JSON.stringify(toolCall.arguments) ?? "";
-    return `Tool call (${getCursorReplayPromptLabel(toolCall.name)}, call ${toolCall.id}): ${args}`;
+    return `Historical tool request (${getCursorReplayPromptLabel(toolCall.name)}, call ${toolCall.id}): ${args}`;
 }
 function sanitizeSystemPromptForCursor(systemPrompt) {
     let sanitized = systemPrompt;
@@ -126,7 +131,7 @@ function formatMessage(msg) {
         }
         case "toolResult": {
             const text = formatContentBlocks(msg.content);
-            const label = msg.isError ? "Tool error" : "Tool result";
+            const label = msg.isError ? "Historical tool error" : "Historical tool result";
             return `${label} (${getCursorReplayPromptLabel(msg.toolName)}, call ${msg.toolCallId}): ${text}`;
         }
     }
@@ -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-custom-subagent-definitions.js

@@ -10,5 +10,5 @@ export function buildCursorCustomSubagentDefinitions(config) {
             }),
         }]));
 }
-// ponytail: SDK 1.0.36 LOCAL conversion keeps only model ID/inherit; it drops params.
+// ponytail: SDK 1.0.37 LOCAL conversion keeps only model ID/inherit; it drops params.
 // Upgrade this claim only after the installed public converter preserves them.