pi-cursor-sdk 0.1.22 → 0.1.24

package/src/cursor-pi-tool-bridge-mcp.ts

@@ -64,6 +64,7 @@ export function snapshotToolToMcpTool(tool: CursorPiBridgeToolDefinition): Tool
 			piToolName: tool.piToolName,
 			mcpToolName: tool.mcpToolName,
 			piToolDescription: tool.description,
+			piToolPromptGuidelines: tool.promptGuidelines,
 		}),
 		inputSchema: tool.inputSchema,
 		_meta: { piToolName: tool.piToolName },

package/src/cursor-pi-tool-bridge-snapshot.ts

@@ -42,6 +42,7 @@ export function buildCursorPiToolBridgeSurfaceSignature(snapshot: CursorPiToolBr
 				piToolName: tool.piToolName,
 				mcpToolName: tool.mcpToolName,
 				description: tool.description,
+				promptGuidelines: tool.promptGuidelines,
 				inputSchema: tool.inputSchema,
 				source: tool.sourceInfo?.source,
 				path: tool.sourceInfo?.path,
@@ -79,6 +80,7 @@ export function buildCursorPiToolBridgeSnapshot(
 			piToolName: tool.name,
 			mcpToolName,
 			description,
+			promptGuidelines: tool.promptGuidelines,
 			inputSchema: normalizeMcpInputSchema(tool.parameters),
 			sourceInfo: tool.sourceInfo,
 		});

package/src/cursor-pi-tool-bridge-types.ts

@@ -30,6 +30,7 @@ export interface CursorPiBridgeToolDefinition {
 	piToolName: string;
 	mcpToolName: string;
 	description: string;
+	promptGuidelines?: ToolInfo["promptGuidelines"];
 	inputSchema: CursorPiMcpInputSchema;
 	sourceInfo: ToolInfo["sourceInfo"];
 }

package/src/cursor-provider-turn-api-key.ts

@@ -1,8 +1 @@
-const CURSOR_API_KEY_ENV_VAR = "CURSOR_API_KEY";
-
-export function resolveCursorApiKey(apiKey?: string): string | undefined {
-	const trimmed = apiKey?.trim();
-	if (!trimmed) return undefined;
-	if (trimmed === CURSOR_API_KEY_ENV_VAR) return process.env.CURSOR_API_KEY?.trim();
-	return trimmed;
-}
+export { resolveCursorApiKey } from "./cursor-api-key.js";

package/src/cursor-tool-manifest.ts

@@ -4,7 +4,7 @@ import type { CursorPiToolBridgeSnapshot } from "./cursor-pi-tool-bridge-types.j
 export const CURSOR_TOOL_MANIFEST_ENV = "PI_CURSOR_TOOL_MANIFEST";
 
 /**
- * Representative @cursor/sdk@1.0.14 local-agent ToolType values; actual exposure can vary by run.
+ * Representative @cursor/sdk@1.0.15 local-agent ToolType values; actual exposure can vary by run.
  * See docs/cursor-native-tool-replay.md#sdk-tooltype-replay-matrix.
  */
 export const CURSOR_HOST_TOOL_MANIFEST_SUMMARY =

package/src/index.ts

@@ -9,6 +9,7 @@ import { registerCursorAgentsContextDedup } from "./cursor-agents-context.js";
 import { registerCursorSessionAgent } from "./cursor-session-agent.js";
 import { prepareCursorSessionForCompaction } from "./cursor-session-compaction-prep.js";
 import { streamCursor } from "./cursor-provider.js";
+import { CURSOR_API_KEY_CONFIG_VALUE } from "./cursor-api-key.js";
 
 type CursorExtensionApi =
 	& Pick<ExtensionAPI, "registerProvider" | "registerCommand" | "on">
@@ -24,7 +25,7 @@ function createCursorProviderConfig(models: ProviderModelConfig[]): ProviderConf
 	return {
 		name: "Cursor",
 		baseUrl: "https://cursor.com",
-		apiKey: "CURSOR_API_KEY",
+		apiKey: CURSOR_API_KEY_CONFIG_VALUE,
 		api: "cursor-sdk",
 		models,
 		streamSimple: streamCursor,

package/src/model-discovery.ts

@@ -8,10 +8,10 @@ import type {
 import { AuthStorage, type ProviderModelConfig } from "@earendil-works/pi-coding-agent";
 import type { ModelThinkingLevel, ThinkingLevelMap } from "@earendil-works/pi-ai";
 import { loadContextWindowCache } from "./context-window-cache.js";
+import { CURSOR_API_KEY_ENV_VAR, resolveCursorApiKey } from "./cursor-api-key.js";
 import { FALLBACK_MODEL_ITEMS } from "./cursor-fallback-models.generated.js";
 
 const CURSOR_PROVIDER_ID = "cursor";
-const CURSOR_API_KEY_ENV_VAR = "CURSOR_API_KEY";
 const FALLBACK_CONTEXT_WINDOW = 128000;
 const FALLBACK_MAX_TOKENS = 16384;
 const ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
@@ -50,29 +50,22 @@ function getCliApiKeyFromArgv(argv: string[] = process.argv): string | undefined
 	return undefined;
 }
 
-function normalizeApiKey(value: string | undefined): string | undefined {
-	const trimmed = value?.trim();
-	if (!trimmed) return undefined;
-	if (trimmed === CURSOR_API_KEY_ENV_VAR) return process.env.CURSOR_API_KEY?.trim() || undefined;
-	return trimmed;
-}
-
 async function getStoredCursorApiKey(): Promise<string | undefined> {
 	try {
-		return normalizeApiKey(await AuthStorage.create().getApiKey(CURSOR_PROVIDER_ID, { includeFallback: false }));
+		return resolveCursorApiKey(await AuthStorage.create().getApiKey(CURSOR_PROVIDER_ID, { includeFallback: false }));
 	} catch {
 		return undefined;
 	}
 }
 
 async function getDiscoveryApiKey(): Promise<string | undefined> {
-	const cliApiKey = normalizeApiKey(getCliApiKeyFromArgv());
+	const cliApiKey = resolveCursorApiKey(getCliApiKeyFromArgv());
 	if (cliApiKey) return cliApiKey;
 
 	const storedApiKey = await getStoredCursorApiKey();
 	if (storedApiKey) return storedApiKey;
 
-	return normalizeApiKey(process.env.CURSOR_API_KEY);
+	return resolveCursorApiKey(process.env.CURSOR_API_KEY);
 }
 
 export interface CursorModelMetadata {
@@ -472,5 +465,5 @@ export const __testUtils = {
 	parseContextWindow,
 	registerModelItems,
 	getCliApiKeyFromArgv,
-	normalizeApiKey,
+	normalizeApiKey: resolveCursorApiKey,
 };