pi-cursor-sdk 0.1.37 → 0.1.38

package/src/cursor-tool-presentation-registry.ts

@@ -18,23 +18,15 @@ import {
 	withActivitySummaryFallback,
 	type CursorReplayActivitySummaryOverride,
 	type CursorReplayGenerateImageSummaryArgs,
-	type CursorReplayPathSummaryArgs,
-	type CursorReplayPlanSummaryArgs,
-	type CursorReplayReadLintsSummaryArgs,
-	type CursorReplayRecordScreenSummaryArgs,
-	type CursorReplaySemSearchSummaryArgs,
 	type CursorReplaySummaryArgs,
-	type CursorReplayTaskSummaryArgs,
-	type CursorReplayTodoSummaryArgs,
 	type CursorReplayWebFetchSummaryArgs,
 	type CursorReplayWebSearchSummaryArgs,
 } from "./cursor-replay-summary-args.js";
+import { truncateCursorDisplayLine } from "./cursor-display-text.js";
 import {
-	buildCollapsedReplayDetailFields,
 	buildCreatePlanReplaySummaryArgs,
 	buildDeleteReplayDetailFields,
 	buildDeleteReplaySummaryArgs,
-	buildEmptyReplayDetailFields,
 	buildGenerateImageReplayDetailFields,
 	buildGenerateImageReplaySummaryArgs,
 	buildMcpReplaySummaryArgs,
@@ -55,6 +47,9 @@ import type {
 
 export const CURSOR_REPLAY_ACTIVITY_TOOL_NAME = "cursor" as const;
 
+const EMPTY_REPLAY_DETAIL_FIELDS = (): Record<string, never> => ({});
+const COLLAPSED_REPLAY_DETAIL_FIELDS = (): { collapseDetailsByDefault: true } => ({ collapseDetailsByDefault: true });
+
 export type CursorWebToolKind = "webSearch" | "webFetch";
 
 export type CursorToolLifecycleLabelKind =
@@ -187,7 +182,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayReadLints),
 		activityReplay: {
 			buildActivityArgs: buildReadLintsReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -198,7 +193,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayTodoCount),
 		activityReplay: {
 			buildActivityArgs: ({ args, result }) => buildTodoReplaySummaryArgs(args, result),
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -209,7 +204,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayPlan),
 		activityReplay: {
 			buildActivityArgs: buildCreatePlanReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -220,7 +215,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayTask),
 		activityReplay: {
 			buildActivityArgs: buildTaskReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -244,7 +239,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayMcp),
 		activityReplay: {
 			buildActivityArgs: buildMcpReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -255,7 +250,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(formatReplaySemSearchQuery),
 		activityReplay: {
 			buildActivityArgs: buildSemSearchReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -266,7 +261,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayRecordScreen),
 		activityReplay: {
 			buildActivityArgs: buildRecordScreenReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -282,7 +277,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		),
 		activityReplay: {
 			buildActivityArgs: buildWebSearchReplaySummaryArgs,
-			buildDetails: buildCollapsedReplayDetailFields,
+			buildDetails: COLLAPSED_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
@@ -298,7 +293,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		),
 		activityReplay: {
 			buildActivityArgs: buildWebFetchReplaySummaryArgs,
-			buildDetails: buildCollapsedReplayDetailFields,
+			buildDetails: COLLAPSED_REPLAY_DETAIL_FIELDS,
 		},
 	},
 ] as const satisfies readonly CursorToolPresentationSpec[];
@@ -389,6 +384,20 @@ export function getCursorReplayActivityTitle(toolName: string): string | undefin
 	return spec.displayLabel;
 }
 
+function buildCursorGenericActivityTitle(displayName: string): string {
+	if (!displayName || displayName === "unknown") return "Cursor tool";
+	return `Cursor ${truncateCursorDisplayLine(displayName, 120)}`;
+}
+
+/** Canonical activity title: registry label when known, otherwise neutral fallback. */
+export function getCursorToolActivityTitle(toolName: string): string {
+	const normalized = normalizeCursorToolName(toolName);
+	const known = getCursorReplayActivityTitle(normalized);
+	if (known) return known;
+	const label = toolName.trim() || normalized;
+	return buildCursorGenericActivityTitle(label);
+}
+
 function getCursorToolPresentationSpecByNormalizedKey(normalizedKey: string): CursorToolPresentationSpec | undefined {
 	return SPECS_BY_NORMALIZED_KEY.get(normalizedKey.toLowerCase());
 }

package/src/cursor-tool-result-display-readers.ts

@@ -0,0 +1,185 @@
+import { asRecord, getArray, getNumber, getRecord, getString, stringifyUnknown } from "./cursor-record-utils.js";
+import { scrubSensitiveText } from "./cursor-sensitive-text.js";
+import { firstNonEmptyLine, formatDisplayPath, truncateArg } from "./cursor-transcript-utils.js";
+
+export interface CursorToolResultLike {
+	status: string | undefined;
+	value: unknown;
+}
+
+export interface CursorToolResultReaderOptions {
+	cwd?: string;
+}
+
+export interface CursorTodoItem {
+	content: string;
+	status?: string;
+}
+
+export function getReadLintPaths(
+	args: Record<string, unknown>,
+	result: CursorToolResultLike,
+	options: CursorToolResultReaderOptions,
+): string[] {
+	const explicitPaths = Array.isArray(args.paths)
+		? args.paths.filter((entry): entry is string => typeof entry === "string")
+		: typeof args.path === "string"
+			? [args.path]
+			: [];
+	const resultPaths = (getArray(asRecord(result.value), "fileDiagnostics") ?? [])
+		.map((file) => getString(asRecord(file), "path"))
+		.filter((entry): entry is string => Boolean(entry));
+	return [...new Set([...explicitPaths, ...resultPaths].map((entry) => formatDisplayPath(entry, options.cwd)))];
+}
+
+export function getReadLintDiagnostics(result: CursorToolResultLike, options: CursorToolResultReaderOptions): string[] {
+	const value = asRecord(result.value);
+	const files = getArray(value, "fileDiagnostics") ?? [];
+	const lines: string[] = [];
+	for (const file of files) {
+		const fileRecord = asRecord(file);
+		const pathValue = getString(fileRecord, "path");
+		const path = pathValue ? formatDisplayPath(pathValue, options.cwd) : "unknown";
+		const diagnostics = getArray(fileRecord, "diagnostics") ?? [];
+		for (const diagnostic of diagnostics) {
+			const diagnosticRecord = asRecord(diagnostic);
+			const severity = getString(diagnosticRecord, "severity") ?? "diagnostic";
+			const message = getString(diagnosticRecord, "message") ?? "";
+			const source = getString(diagnosticRecord, "source");
+			lines.push(`${path}: ${severity}${source ? ` ${source}` : ""}: ${message}`);
+		}
+	}
+	return lines;
+}
+
+export function getTodoItems(args: Record<string, unknown>, result: CursorToolResultLike): CursorTodoItem[] {
+	const value = asRecord(result.value);
+	const rawTodos = getArray(value, "todos") ?? getArray(args, "todos") ?? [];
+	const todos: CursorTodoItem[] = [];
+	for (const todo of rawTodos) {
+		const record = asRecord(todo);
+		const content = getString(record, "content");
+		if (!content) continue;
+		const status = getString(record, "status");
+		todos.push(status ? { content, status } : { content });
+	}
+	return todos;
+}
+
+export function getTodoTotalCount(args: Record<string, unknown>, result: CursorToolResultLike, todos: CursorTodoItem[]): number {
+	return getNumber(asRecord(result.value), "totalCount") ?? getNumber(args, "totalCount") ?? todos.length;
+}
+
+export function getTaskDescription(args: Record<string, unknown>, result: CursorToolResultLike): string {
+	return getString(args, "description") ?? getString(asRecord(result.value), "description") ?? "task";
+}
+
+function getNestedRecord(record: Record<string, unknown> | undefined, ...keys: string[]): Record<string, unknown> | undefined {
+	let current = record;
+	for (const key of keys) {
+		current = getRecord(current, key);
+		if (!current) return undefined;
+	}
+	return current;
+}
+
+export function collectTaskText(result: CursorToolResultLike): string {
+	const value = asRecord(result.value);
+	const success = getNestedRecord(value, "result", "success");
+	const command = getString(success, "command");
+	const stdout = getString(success, "stdout");
+	const interleavedOutput = getString(success, "interleavedOutput");
+	const assistantMessages = (getArray(value, "conversationSteps") ?? [])
+		.map((step) => getString(getRecord(asRecord(step), "assistantMessage"), "text"))
+		.filter((entry): entry is string => Boolean(entry));
+	const parts = [command ? `$ ${command}` : undefined, stdout || interleavedOutput, ...assistantMessages].filter((part): part is string => Boolean(part));
+	return parts.join("\n");
+}
+
+export function getGenerateImagePath(args: Record<string, unknown>, result: CursorToolResultLike): string | undefined {
+	const value = asRecord(result.value);
+	return getString(value, "filePath") ?? getString(args, "filePath") ?? getString(args, "path");
+}
+
+export function getGenerateImageDisplayPath(
+	args: Record<string, unknown>,
+	result: CursorToolResultLike,
+	options: CursorToolResultReaderOptions,
+): string | undefined {
+	const path = getGenerateImagePath(args, result);
+	return path ? formatDisplayPath(path, options.cwd) : undefined;
+}
+
+export function inferImageMimeType(path: string | undefined): string | undefined {
+	const lower = path?.toLowerCase();
+	if (!lower) return undefined;
+	if (lower.endsWith(".png")) return "image/png";
+	if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return "image/jpeg";
+	if (lower.endsWith(".gif")) return "image/gif";
+	if (lower.endsWith(".webp")) return "image/webp";
+	return undefined;
+}
+
+function getMcpContentText(entry: unknown): string | undefined {
+	const record = asRecord(entry);
+	const directText = getString(record, "text");
+	if (directText) return directText;
+	const nestedText = getRecord(record, "text");
+	return getString(nestedText, "text");
+}
+
+function describeNonTextMcpContent(entry: unknown): string {
+	const record = asRecord(entry);
+	const type = getString(record, "type") ?? "content";
+	if (type === "image") {
+		const mimeType = getString(record, "mimeType") ?? getString(record, "mime") ?? getString(record, "mediaType");
+		return `[image${mimeType ? ` ${mimeType}` : ""} omitted]`;
+	}
+	if (type === "audio") return "[audio omitted]";
+	if (type === "resource") return "[resource omitted]";
+	return `[${type} omitted]`;
+}
+
+export interface McpDisplayResult {
+	isToolError: boolean;
+	text: string;
+	nonTextSummary: string;
+	body: string;
+	preview?: string;
+}
+
+export function readMcpDisplayResult(result: CursorToolResultLike): McpDisplayResult {
+	if (result.status === "error") {
+		return { isToolError: false, text: "", nonTextSummary: "", body: "" };
+	}
+
+	const value = asRecord(result.value);
+	const isToolError = value?.isError === true;
+	const content = getArray(value, "content") ?? [];
+	const textParts: string[] = [];
+	const nonTextParts: string[] = [];
+	let preview: string | undefined;
+
+	for (const entry of content) {
+		const text = getMcpContentText(entry);
+		if (text) {
+			textParts.push(text);
+			const line = firstNonEmptyLine(text);
+			if (!preview && line) preview = truncateArg(scrubSensitiveText(line), 120);
+			continue;
+		}
+		nonTextParts.push(describeNonTextMcpContent(entry));
+	}
+
+	if (!preview) preview = nonTextParts[0];
+	const text = textParts.join("\n");
+	const nonTextSummary = nonTextParts.join("\n");
+	const body = text || nonTextSummary || scrubSensitiveText(stringifyUnknown(result.value), undefined);
+	return {
+		isToolError,
+		text,
+		nonTextSummary,
+		body: `${isToolError ? "[tool error]\n" : ""}${body}`.trim(),
+		...(preview ? { preview } : {}),
+	};
+}

package/src/cursor-tool-transcript.ts

@@ -1,6 +1,11 @@
+import { asRecord, getString } from "./cursor-record-utils.js";
+import { normalizeCursorToolName } from "./cursor-tool-presentation-registry.js";
+import {
+	buildCursorPiToolDisplayFromSpec,
+	formatCursorToolTranscriptFromSpec,
+	type ToolDisplayContext,
+} from "./cursor-transcript-tool-specs.js";
 import {
-	asRecord,
-	getString,
 	getToolArgs,
 	getToolName,
 	getToolResult,
@@ -8,27 +13,12 @@ import {
 	type CursorPiToolDisplay,
 	type TranscriptOptions,
 } from "./cursor-transcript-utils.js";
-import { normalizeCursorToolName as normalizeToolName } from "./cursor-tool-presentation-registry.js";
-import {
-	buildCursorPiToolDisplayFromSpec,
-	formatCursorToolTranscriptFromSpec,
-	type ToolDisplayContext,
-} from "./cursor-transcript-tool-specs.js";
 import { resolveTranscriptToolName } from "./cursor-web-tool-activity.js";
 
 export type { CursorPiToolDisplay } from "./cursor-transcript-utils.js";
+export type { ToolDisplayContext } from "./cursor-transcript-tool-specs.js";
 
-export function getCursorCreatePlanText(toolCall: unknown): string | undefined {
-	const name = normalizeToolName(getToolName(toolCall));
-	if (name !== "createPlan") return undefined;
-	const args = getToolArgs(toolCall);
-	const result = normalizeResult(getToolResult(toolCall));
-	const plan = getString(args, "plan") ?? getString(asRecord(result.value), "plan");
-	const trimmed = plan?.trim();
-	return trimmed || undefined;
-}
-
-function buildToolDisplayContext(toolCall: unknown, options: TranscriptOptions): ToolDisplayContext {
+function buildToolDisplayContext(toolCall: unknown, options: TranscriptOptions = {}): ToolDisplayContext {
 	const rawName = getToolName(toolCall);
 	const args = getToolArgs(toolCall);
 	return {
@@ -48,18 +38,12 @@ export function buildCursorPiToolDisplay(toolCall: unknown, options: TranscriptO
 	return buildCursorPiToolDisplayFromSpec(buildToolDisplayContext(toolCall, options));
 }
 
-export function mergeCursorToolCalls(startedToolCall: unknown, completedToolCall: unknown): unknown {
-	const started = asRecord(startedToolCall);
-	const completed = asRecord(completedToolCall);
-	if (!started) return completedToolCall;
-	if (!completed) return startedToolCall;
-	return {
-		...started,
-		...completed,
-		name: completed.name ?? started.name,
-		type: completed.type ?? started.type,
-		args: completed.args ?? started.args,
-		input: completed.input ?? started.input,
-		result: completed.result ?? started.result,
-	};
+export function getCursorCreatePlanText(toolCall: unknown): string | undefined {
+	const name = normalizeCursorToolName(getToolName(toolCall));
+	if (name !== "createPlan") return undefined;
+	const args = getToolArgs(toolCall);
+	const result = normalizeResult(getToolResult(toolCall));
+	const plan = getString(args, "plan") ?? getString(asRecord(result.value), "plan");
+	const trimmed = plan?.trim();
+	return trimmed || undefined;
 }

package/src/cursor-tool-visibility.ts

@@ -1,4 +1,8 @@
-import { getCursorReplayActivityTitle, getCursorToolVisibilityPolicy, normalizeCursorToolName as normalizeToolName } from "./cursor-tool-presentation-registry.js";
+import {
+	getCursorReplayActivityTitle,
+	getCursorToolVisibilityPolicy,
+	normalizeCursorToolName as normalizeToolName,
+} from "./cursor-tool-presentation-registry.js";
 import { getToolArgs, getToolName } from "./cursor-transcript-utils.js";
 import { resolveTranscriptToolName } from "./cursor-web-tool-activity.js";
 
@@ -14,6 +18,10 @@ export interface CursorToolVisibility {
 	fastLocalDiscovery: boolean;
 }
 
+export function getNormalizedCursorToolName(toolCall: unknown): string {
+	return classifyCursorToolVisibility(toolCall).normalizedName;
+}
+
 export function classifyCursorToolVisibility(toolCall: unknown): CursorToolVisibility {
 	const args = getToolArgs(toolCall);
 	const displayName = resolveTranscriptToolName(getToolName(toolCall), args);