pi-cursor-sdk 0.1.18 → 0.1.19

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

@@ -33,7 +33,11 @@ import {
 	formatGrep,
 	formatLs,
 	formatMcp,
+	formatWebFetch,
+	formatWebSearch,
 	formatPlan,
+	formatRecordScreen,
+	formatSemSearch,
 	formatRead,
 	formatReadLints,
 	formatShell,
@@ -55,9 +59,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,13 +114,13 @@ 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,
@@ -144,15 +153,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 {
@@ -238,10 +266,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,
 			};
 		},
@@ -420,9 +452,76 @@ const TOOL_DISPLAY_SPECS: Record<string, ToolDisplaySpec> = {
 				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_sem_search",
+			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_record_screen",
+			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_web_search",
+			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",
+			}),
+		},
+	},
+	webFetch: {
+		formatTranscript: ({ args, result, options }) => formatWebFetch(args, result, options),
+		buildPiToolDisplay: (context) => buildActivityReplayDisplay("webFetch", TOOL_DISPLAY_SPECS.webFetch, context),
+		activityReplay: {
+			labelKey: "cursor_web_fetch",
+			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",
 			}),
 		},
 	},

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) => {