pi-cursor-sdk 0.1.18 → 0.1.20

package/src/cursor-transcript-tool-specs.ts

@@ -1,4 +1,10 @@
-import { CURSOR_REPLAY_ACTIVITY_TOOL_NAME, getCursorReplayDisplayLabel, type CursorReplayLegacyToolName } from "./cursor-tool-names.js";
+import {
+	CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME,
+	CURSOR_REPLAY_ACTIVITY_TOOL_NAME,
+	getCursorReplayActivityTitle,
+	getCursorReplayDisplayLabel,
+	type CursorReplayLegacyToolName,
+} from "./cursor-tool-names.js";
 import { resolveCursorEditDiff } from "./cursor-edit-diff.js";
 import {
 	asRecord,
@@ -33,7 +39,11 @@ import {
 	formatGrep,
 	formatLs,
 	formatMcp,
+	formatWebFetch,
+	formatWebSearch,
 	formatPlan,
+	formatRecordScreen,
+	formatSemSearch,
 	formatRead,
 	formatReadLints,
 	formatShell,
@@ -55,9 +65,14 @@ import {
 	getTodoTotalCount,
 	inferImageMimeType,
 	summarizePlan,
+	summarizeMcp,
+	summarizeRecordScreen,
+	summarizeSemSearch,
 	summarizeTask,
 	summarizeTodos,
+	usesLocalReadPreview,
 } from "./cursor-transcript-tool-formatters.js";
+import { extractWebFetchTarget, extractWebSearchQuery } from "./cursor-web-tool-activity.js";
 
 export interface ToolDisplayContext {
 	rawName: string;
@@ -105,19 +120,23 @@ function buildReplaySummaryDisplay(
 	details: Record<string, unknown>,
 ): CursorPiToolDisplay {
 	const isError = result.status === "error";
-	const summary = isError ? formatError(result.error) : firstNonEmptyLine(contentText);
+	const summary = isError ? details.summary : (details.summary ?? firstNonEmptyLine(contentText));
 	return {
 		toolName,
 		args,
 		result: textToolResult(contentText, {
 			...details,
-			summary: details.summary ?? summary,
+			summary,
 			expandedText: details.expandedText ?? contentText,
 		}),
 		isError,
 	};
 }
 
+function getCursorToolActivityTitle(toolName: string): string {
+	return getCursorReplayActivityTitle(toolName) ?? buildGenericUnknownToolActivityTitle(toolName);
+}
+
 function buildActivityReplayDisplay(cursorToolName: string, spec: ToolDisplaySpec, context: ToolDisplayContext): CursorPiToolDisplay {
 	const activity = spec.activityReplay;
 	if (!activity) throw new Error(`Missing activity replay spec for ${cursorToolName}`);
@@ -144,15 +163,34 @@ function buildActivityReplayDisplay(cursorToolName: string, spec: ToolDisplaySpe
 	);
 }
 
+function buildGenericUnknownToolActivityTitle(displayName: string): string {
+	if (displayName === "unknown") return "Cursor tool";
+	return `Cursor ${truncateArg(displayName)}`;
+}
+
 function buildGenericPiToolDisplay(context: ToolDisplayContext): CursorPiToolDisplay {
-	const { name, args, result, options } = context;
-	const isError = result.status === "error";
-	return {
-		toolName: name,
-		args,
-		result: textToolResult(isError ? formatError(result.error) : limitText(stringifyUnknown(result.value), options)),
-		isError,
-	};
+	const { rawName, name, args, result, options } = context;
+	const displayName = rawName.trim() || name;
+	const activityTitle = buildGenericUnknownToolActivityTitle(displayName);
+	const contentText = formatFallback(name, args, result, options);
+	const fallbackBody = contentText.includes("\n\n") ? contentText.slice(contentText.indexOf("\n\n") + 2) : "";
+	const activitySummary =
+		result.status === "error" ? undefined : firstNonEmptyLine(fallbackBody);
+	const activityArgs = buildCursorActivityDisplayArgs(
+		{ cursorToolName: displayName === "unknown" ? "tool" : displayName },
+		activityTitle,
+		activitySummary,
+	);
+	const summary =
+		result.status === "error"
+			? undefined
+			: activitySummary ?? truncateArg(displayName === "unknown" ? "tool" : displayName);
+	return buildReplaySummaryDisplay(CURSOR_REPLAY_ACTIVITY_TOOL_NAME, activityArgs, result, contentText, {
+		cursorToolName: name,
+		title: activityTitle,
+		summary,
+		expandedText: contentText,
+	});
 }
 
 function buildEditPiToolDisplay(context: ToolDisplayContext): CursorPiToolDisplay {
@@ -163,7 +201,7 @@ function buildEditPiToolDisplay(context: ToolDisplayContext): CursorPiToolDispla
 	const nativeEditArgs = buildNativeEditDisplayArgs(rawName, args, options);
 	const baseActivityArgs = buildCursorEditActivityDisplayArgs(args, options);
 	const displayPath = typeof baseActivityArgs.path === "string" ? baseActivityArgs.path : undefined;
-	const activityTitle = getCursorReplayDisplayLabel("cursor_edit");
+	const activityTitle = getCursorToolActivityTitle("edit");
 	const activityArgs = buildCursorActivityDisplayArgs(baseActivityArgs, activityTitle, displayPath);
 	const contentText = formatEdit(activityArgs, result, options);
 	const details = {
@@ -212,7 +250,7 @@ function buildWritePiToolDisplay(context: ToolDisplayContext): CursorPiToolDispl
 		expandedText: contentText,
 	};
 	if (content === undefined) {
-		const activityTitle = getCursorReplayDisplayLabel("cursor_write");
+		const activityTitle = getCursorToolActivityTitle("write");
 		return buildReplaySummaryDisplay(
 			CURSOR_REPLAY_ACTIVITY_TOOL_NAME,
 			buildCursorActivityDisplayArgs(displayArgs, activityTitle, displayPath ?? "file"),
@@ -238,10 +276,14 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatRead(args, result, options),
 		buildPiToolDisplay: ({ args, result, options }) => {
 			const isError = result.status === "error";
+			const usesLocalPreview = !isError && usesLocalReadPreview(args, result, options);
 			return {
 				toolName: "read",
-				args: buildReadDisplayArgs(args, options),
-				result: textToolResult(isError ? formatError(result.error) : formatNativeReadDisplayContent(args, result, options)),
+				args: buildReadDisplayArgs(args, options, result),
+				result: textToolResult(
+					isError ? formatError(result.error) : formatNativeReadDisplayContent(args, result, options),
+					usesLocalPreview ? { localReadPreview: true } : undefined,
+				),
 				isError,
 			};
 		},
@@ -304,7 +346,7 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatDelete(args, result, options),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("delete", TOOL_DISPLAY_SPECS.delete, context),
 		activityReplay: {
-			labelKey: "cursor_delete",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.delete,
 			buildActivityArgs: ({ args, options }) => {
 				const displayPath = typeof args.path === "string" ? formatDisplayPath(args.path, options.cwd) : undefined;
 				return displayPath ? { path: displayPath } : {};
@@ -328,7 +370,7 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatReadLints(args, result, options),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("readLints", TOOL_DISPLAY_SPECS.readLints, context),
 		activityReplay: {
-			labelKey: "cursor_read_lints",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.readLints,
 			buildActivityArgs: ({ args, result, options }) => {
 				const paths = getReadLintPaths(args, result, options);
 				const diagnosticCount = getReadLintDiagnostics(result, options).length;
@@ -346,7 +388,7 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatTodos(args, result, options, "updateTodos"),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("updateTodos", TOOL_DISPLAY_SPECS.updateTodos, context),
 		activityReplay: {
-			labelKey: "cursor_update_todos",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.updateTodos,
 			buildActivityArgs: ({ args, result }) => {
 				const todos = getTodoItems(args, result);
 				return { totalCount: getTodoTotalCount(args, result, todos) };
@@ -359,7 +401,7 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatPlan(args, result, options),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("createPlan", TOOL_DISPLAY_SPECS.createPlan, context),
 		activityReplay: {
-			labelKey: "cursor_create_plan",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.createPlan,
 			buildActivityArgs: ({ args, result }) => {
 				const todos = getTodoItems(args, result);
 				return { totalCount: getTodoTotalCount(args, result, todos) };
@@ -372,7 +414,7 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatTask(args, result, options),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("task", TOOL_DISPLAY_SPECS.task, context),
 		activityReplay: {
-			labelKey: "cursor_task",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.task,
 			buildActivityArgs: ({ args, result }) => {
 				const description = getTaskDescription(args, result);
 				return { description: truncateArg(description) };
@@ -388,7 +430,7 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatGenerateImage(args, result, options),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("generateImage", TOOL_DISPLAY_SPECS.generateImage, context),
 		activityReplay: {
-			labelKey: "cursor_generate_image",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.generateImage,
 			buildActivityArgs: ({ args }) => {
 				const prompt = getString(args, "prompt") ?? getString(args, "description") ?? "image";
 				return { prompt: truncateArg(prompt) };
@@ -415,14 +457,83 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 		formatTranscript: ({ args, result, options }) => formatMcp(args, result, options),
 		buildPiToolDisplay: (context) => buildActivityReplayDisplay("mcp", TOOL_DISPLAY_SPECS.mcp, context),
 		activityReplay: {
-			labelKey: "cursor_mcp",
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.mcp,
 			buildActivityArgs: ({ args }) => {
 				const toolName = getString(args, "toolName") ?? "mcp";
 				return { toolName: truncateArg(toolName) };
 			},
-			buildActivitySummary: ({ args }) => truncateArg(getString(args, "toolName") ?? "mcp"),
+			buildActivitySummary: ({ args, result }) => summarizeMcp(args, result),
+			buildDetails: ({ args, result }) => ({
+				summary: result.status === "error" ? undefined : summarizeMcp(args, result),
+			}),
+		},
+	},
+	semSearch: {
+		formatTranscript: ({ args, result, options }) => formatSemSearch(args, result, options),
+		buildPiToolDisplay: (context) => buildActivityReplayDisplay("semSearch", TOOL_DISPLAY_SPECS.semSearch, context),
+		activityReplay: {
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.semSearch,
+			buildActivityArgs: ({ args }) => {
+				const query = getString(args, "query") ?? "semantic search";
+				return { query: truncateArg(query) };
+			},
+			buildActivitySummary: ({ args }) => summarizeSemSearch(args),
+			buildDetails: ({ result }, contentText) => ({
+				summary: result.status === "error" ? undefined : firstNonEmptyLine(contentText) ?? "semantic search results captured",
+			}),
+		},
+	},
+	recordScreen: {
+		formatTranscript: ({ args, result, options }) => formatRecordScreen(args, result, options),
+		buildPiToolDisplay: (context) => buildActivityReplayDisplay("recordScreen", TOOL_DISPLAY_SPECS.recordScreen, context),
+		activityReplay: {
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.recordScreen,
+			buildActivityArgs: ({ args, result, options }) => {
+				const mode = getString(args, "mode");
+				const path = getString(asRecord(result.value), "path");
+				return {
+					...(mode ? { mode } : {}),
+					...(path ? { path: formatDisplayPath(path, options.cwd) } : {}),
+				};
+			},
+			buildActivitySummary: ({ args, result, options }) => summarizeRecordScreen(args, result, options),
+			buildDetails: ({ args, result, options }, contentText) => ({
+				summary:
+					result.status === "error"
+						? undefined
+						: summarizeRecordScreen(args, result, options) ?? firstNonEmptyLine(contentText) ?? "screen recording updated",
+			}),
+		},
+	},
+	webSearch: {
+		formatTranscript: ({ args, result, options }) => formatWebSearch(args, result, options),
+		buildPiToolDisplay: (context) => buildActivityReplayDisplay("webSearch", TOOL_DISPLAY_SPECS.webSearch, context),
+		activityReplay: {
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.webSearch,
+			buildActivityArgs: ({ args }) => {
+				const query = extractWebSearchQuery(args);
+				return query ? { query: truncateArg(query) } : {};
+			},
+			buildActivitySummary: ({ args }) => truncateArg(extractWebSearchQuery(args) ?? "web search"),
+			buildDetails: ({ result }, contentText) => ({
+				summary: result.status === "error" ? undefined : firstNonEmptyLine(contentText) ?? "web search result captured",
+				collapseDetailsByDefault: true,
+			}),
+		},
+	},
+	webFetch: {
+		formatTranscript: ({ args, result, options }) => formatWebFetch(args, result, options),
+		buildPiToolDisplay: (context) => buildActivityReplayDisplay("webFetch", TOOL_DISPLAY_SPECS.webFetch, context),
+		activityReplay: {
+			labelKey: CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME.webFetch,
+			buildActivityArgs: ({ args }) => {
+				const target = extractWebFetchTarget(args);
+				return target ? { url: truncateArg(target) } : {};
+			},
+			buildActivitySummary: ({ args }) => truncateArg(extractWebFetchTarget(args) ?? "web fetch"),
 			buildDetails: ({ result }, contentText) => ({
-				summary: result.status === "error" ? undefined : firstNonEmptyLine(contentText) ?? "MCP result captured",
+				summary: result.status === "error" ? undefined : firstNonEmptyLine(contentText) ?? "web fetch result captured",
+				collapseDetailsByDefault: true,
 			}),
 		},
 	},

package/src/cursor-transcript-utils.ts

@@ -43,6 +43,10 @@ export const DEFAULT_NATIVE_READ_DISPLAY_LINES = 20;
 export const LOCAL_READ_PREVIEW_NOTICE =
 	"[local file preview at transcript time; Cursor read result content was unavailable]";
 
+export function isLocalReadPreviewContent(text: string): boolean {
+	return text.startsWith(LOCAL_READ_PREVIEW_NOTICE);
+}
+
 export function getString(record: Record<string, unknown> | undefined, key: string): string | undefined {
 	const value = record?.[key];
 	return typeof value === "string" ? value : undefined;
@@ -113,6 +117,14 @@ export function normalizeToolName(name: string): string {
 		case "notebook_edit":
 		case "notebookedit":
 			return "edit";
+		case "websearch":
+		case "web_search":
+		case "web-search":
+			return "webSearch";
+		case "webfetch":
+		case "web_fetch":
+		case "web-fetch":
+			return "webFetch";
 		default:
 			return normalized || "unknown";
 	}

package/src/cursor-web-tool-activity.ts

@@ -0,0 +1,84 @@
+import { normalizeToolName } from "./cursor-transcript-utils.js";
+
+export type CursorWebToolKind = "webSearch" | "webFetch";
+
+const WEB_SEARCH_NAME_PATTERN =
+	/^(?:web[-_ ]?search|search[-_ ]?web|websearch|browser[-_ ]?search|cursor[-_ ]?web[-_ ]?search)$/i;
+const WEB_FETCH_NAME_PATTERN =
+	/^(?:web[-_ ]?fetch|fetch[-_ ]?web|webfetch|browser[-_ ]?fetch|fetch[-_ ]?url|cursor[-_ ]?web[-_ ]?fetch)$/i;
+
+function normalizeWebToolLookupName(name: string): string {
+	return name.replace(/\s+/g, " ").trim().toLowerCase();
+}
+
+export function classifyCursorWebToolKind(name: string | undefined): CursorWebToolKind | undefined {
+	if (!name) return undefined;
+	const normalized = normalizeWebToolLookupName(name);
+	if (WEB_SEARCH_NAME_PATTERN.test(normalized) || normalized === "websearch" || normalized === "web_search") {
+		return "webSearch";
+	}
+	if (WEB_FETCH_NAME_PATTERN.test(normalized) || normalized === "webfetch" || normalized === "web_fetch") {
+		return "webFetch";
+	}
+	return undefined;
+}
+
+function getNestedMcpArgs(args: Record<string, unknown>): Record<string, unknown> {
+	const nested = args.args;
+	return nested && typeof nested === "object" && !Array.isArray(nested) ? (nested as Record<string, unknown>) : {};
+}
+
+function getMcpToolName(args: Record<string, unknown>): string | undefined {
+	const toolName = typeof args.toolName === "string" ? args.toolName : typeof args.tool_name === "string" ? args.tool_name : undefined;
+	const trimmed = toolName?.trim();
+	return trimmed || undefined;
+}
+
+function firstNonEmptyString(...values: Array<string | undefined>): string | undefined {
+	for (const value of values) {
+		const trimmed = value?.trim();
+		if (trimmed) return trimmed;
+	}
+	return undefined;
+}
+
+export function extractWebSearchQuery(args: Record<string, unknown>): string | undefined {
+	const nested = getNestedMcpArgs(args);
+	return firstNonEmptyString(
+		typeof args.search_term === "string" ? args.search_term : undefined,
+		typeof args.searchTerm === "string" ? args.searchTerm : undefined,
+		typeof args.query === "string" ? args.query : undefined,
+		typeof args.q === "string" ? args.q : undefined,
+		typeof nested.search_term === "string" ? nested.search_term : undefined,
+		typeof nested.searchTerm === "string" ? nested.searchTerm : undefined,
+		typeof nested.query === "string" ? nested.query : undefined,
+		typeof nested.q === "string" ? nested.q : undefined,
+	);
+}
+
+export function extractWebFetchTarget(args: Record<string, unknown>): string | undefined {
+	const nested = getNestedMcpArgs(args);
+	return firstNonEmptyString(
+		typeof args.url === "string" ? args.url : undefined,
+		typeof args.uri === "string" ? args.uri : undefined,
+		typeof args.href === "string" ? args.href : undefined,
+		typeof nested.url === "string" ? nested.url : undefined,
+		typeof nested.uri === "string" ? nested.uri : undefined,
+		typeof nested.href === "string" ? nested.href : undefined,
+	);
+}
+
+/**
+ * Maps SDK/host/MCP tool names to transcript display keys.
+ * Web search/fetch often arrives as MCP `toolName` values, not dedicated SDK ToolTypes.
+ */
+export function resolveTranscriptToolName(rawName: string, args: Record<string, unknown>): string {
+	const normalized = normalizeToolName(rawName);
+	const directWebKind = classifyCursorWebToolKind(rawName) ?? classifyCursorWebToolKind(normalized);
+	if (directWebKind) return directWebKind;
+	if (normalized === "mcp") {
+		const mcpWebKind = classifyCursorWebToolKind(getMcpToolName(args));
+		if (mcpWebKind) return mcpWebKind;
+	}
+	return normalized;
+}

package/src/index.ts

@@ -5,6 +5,7 @@ import { registerCursorNativeToolDisplay } from "./cursor-native-tool-display.js
 import { registerCursorPiToolBridge } from "./cursor-pi-tool-bridge.js";
 import { registerCursorQuestionTool } from "./cursor-question-tool.js";
 import { registerCursorSessionCwd } from "./cursor-session-cwd.js";
+import { registerCursorAgentsContextDedup } from "./cursor-agents-context.js";
 import { registerCursorSessionAgent } from "./cursor-session-agent.js";
 import { streamCursor } from "./cursor-provider.js";
 
@@ -21,7 +22,8 @@ type CursorExtensionApi =
 	& Parameters<typeof registerCursorFastControls>[0]
 	& Parameters<typeof registerCursorNativeToolDisplay>[0]
 	& Parameters<typeof registerCursorQuestionTool>[0]
-	& Parameters<typeof registerCursorPiToolBridge>[0];
+	& Parameters<typeof registerCursorPiToolBridge>[0]
+	& Parameters<typeof registerCursorAgentsContextDedup>[0];
 
 function createCursorProviderConfig(models: ProviderModelConfig[]): ProviderConfig {
 	return {
@@ -46,6 +48,7 @@ export default async function (pi: CursorExtensionApi) {
 	registerCursorNativeToolDisplay(pi);
 	registerCursorQuestionTool(pi);
 	registerCursorPiToolBridge(pi);
+	registerCursorAgentsContextDedup(pi);
 	let fallbackIssue: CursorModelFallbackIssue | undefined;
 	const models = await discoverModels({
 		onFallback: (issue) => {