pi-cursor-sdk 0.2.0 → 0.3.7

package/dist/cursor-api-key.js

@@ -0,0 +1,34 @@
+import { readStoredCredential } from "@earendil-works/pi-coding-agent";
+export const CURSOR_API_KEY_ENV_VAR = "CURSOR_API_KEY";
+const CURSOR_PROVIDER_ID = "cursor";
+// Non-secret literal sentinel for pi's provider registry. Pi 0.77 treats `$ENV_VAR`
+// values as unconfigured when the env var is absent, which hides fallback models
+// before `/login`. Keep the provider available and resolve the real key in the
+// Cursor provider turn path from pi auth or CURSOR_API_KEY.
+export 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}`,
+    `\${${CURSOR_API_KEY_ENV_VAR}}`,
+    CURSOR_API_KEY_CONFIG_VALUE,
+]);
+export function resolveCursorApiKey(apiKey) {
+    const trimmed = apiKey?.trim();
+    if (!trimmed)
+        return undefined;
+    if (CURSOR_API_KEY_PLACEHOLDERS.has(trimmed))
+        return process.env.CURSOR_API_KEY?.trim() || undefined;
+    return trimmed;
+}
+function getStoredCursorApiKey() {
+    try {
+        const credential = readStoredCredential(CURSOR_PROVIDER_ID);
+        return resolveCursorApiKey(credential?.type === "api_key" ? credential.key : undefined);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolveCursorRuntimeApiKey() {
+    return Promise.resolve(getStoredCursorApiKey() ?? resolveCursorApiKey(process.env.CURSOR_API_KEY));
+}

package/dist/cursor-bridge-contract.js

@@ -0,0 +1,27 @@
+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");
+}
+function formatPromptGuidelines(promptGuidelines) {
+    const guidelines = promptGuidelines?.map((guideline) => guideline.trim()).filter(Boolean) ?? [];
+    if (guidelines.length === 0)
+        return undefined;
+    return ["Pi tool prompt guidelines:", ...guidelines.map((guideline) => `- ${guideline}`)].join("\n");
+}
+export function buildCursorPiBridgeMcpToolDescription(options) {
+    return [
+        options.piToolDescription,
+        formatPromptGuidelines(options.piToolPromptGuidelines),
+        `Call MCP name ${options.mcpToolName} (pi tool: ${options.piToolName}). Full tool-surface rules are in the session bootstrap prompt.`,
+    ].filter((line) => line !== undefined).join("\n");
+}