pi-cursor-sdk 0.1.36 → 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,9 +47,10 @@ import type {
 
 export const CURSOR_REPLAY_ACTIVITY_TOOL_NAME = "cursor" as const;
 
-export type CursorWebToolKind = "webSearch" | "webFetch";
+const EMPTY_REPLAY_DETAIL_FIELDS = (): Record<string, never> => ({});
+const COLLAPSED_REPLAY_DETAIL_FIELDS = (): { collapseDetailsByDefault: true } => ({ collapseDetailsByDefault: true });
 
-export type CursorReplaySideEffectCategory = "file_mutations" | "real_tool_work";
+export type CursorWebToolKind = "webSearch" | "webFetch";
 
 export type CursorToolLifecycleLabelKind =
 	| "task"
@@ -96,10 +89,6 @@ export interface CursorToolPresentationSpec {
 	normalizedName: CursorReplaySourceToolName;
 	/** Raw SDK/host names that resolve to this tool via {@link normalizeCursorToolName}. */
 	nameAliases?: readonly string[];
-	replayLegacyName?: string;
-	/** Human-readable SDK operation label for replay-only tool descriptions when it differs from {@link normalizedName}. */
-	replayOperationLabel?: string;
-	promptLabel: string;
 	displayLabel: string;
 	visibility: CursorToolVisibilityPolicy;
 	webKind?: CursorWebToolKind;
@@ -107,52 +96,43 @@ export interface CursorToolPresentationSpec {
 	webNamePatterns?: readonly RegExp[];
 	lifecycleLabelKind?: CursorToolLifecycleLabelKind;
 	replayCallSummary?: CursorReplayCallSummaryBuilder;
-	/** Short label for replay-only tool definitions (for example `edit` for `cursor_edit`). */
-	replayWrapperLabel?: string;
-	/** Whether replay-only wrappers describe file mutations or other recorded tool work. */
-	replaySideEffectCategory?: CursorReplaySideEffectCategory;
 	activityReplay?: CursorToolActivityReplaySpec;
 	generateImageReplay?: CursorToolGenerateImageReplaySpec;
 }
 
 const WEB_SEARCH_NAME_PATTERN =
-	/^(?:web[-_ ]?search|search[-_ ]?web|websearch|browser[-_ ]?search|cursor[-_ ]?web[-_ ]?search)$/i;
+	/^(?:web[-_ ]?search|search[-_ ]?web|websearch|browser[-_ ]?search)$/i;
 const WEB_FETCH_NAME_PATTERN =
-	/^(?:web[-_ ]?fetch|fetch[-_ ]?web|webfetch|browser[-_ ]?fetch|fetch[-_ ]?url|cursor[-_ ]?web[-_ ]?fetch)$/i;
+	/^(?:web[-_ ]?fetch|fetch[-_ ]?web|webfetch|browser[-_ ]?fetch|fetch[-_ ]?url)$/i;
 
 export const CURSOR_TOOL_PRESENTATION_SPECS = [
 	{
 		normalizedName: "read",
 		nameAliases: ["read_file"],
-		promptLabel: "read",
 		displayLabel: "read",
 		visibility: { incompleteTitle: "Cursor read", fastLocalDiscovery: true },
 	},
 	{
 		normalizedName: "grep",
 		nameAliases: ["grep_search", "search"],
-		promptLabel: "grep",
 		displayLabel: "grep",
 		visibility: { incompleteTitle: "Cursor grep", fastLocalDiscovery: true },
 	},
 	{
 		normalizedName: "glob",
 		nameAliases: ["file_search"],
-		promptLabel: "glob",
 		displayLabel: "glob",
 		visibility: { incompleteTitle: "Cursor find", fastLocalDiscovery: true },
 	},
 	{
 		normalizedName: "ls",
 		nameAliases: ["list_dir"],
-		promptLabel: "ls",
 		displayLabel: "ls",
 		visibility: { incompleteTitle: "Cursor ls", fastLocalDiscovery: true },
 	},
 	{
 		normalizedName: "shell",
 		nameAliases: ["run_terminal_cmd", "terminal", "bash"],
-		promptLabel: "shell",
 		displayLabel: "shell",
 		visibility: {
 			incompleteTitle: "Cursor shell",
@@ -174,29 +154,19 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 			"notebook_edit",
 			"notebookedit",
 		],
-		replayLegacyName: "cursor_edit",
-		promptLabel: "Cursor edit",
 		displayLabel: "Cursor edit",
 		visibility: {},
-		replayWrapperLabel: "edit",
-		replaySideEffectCategory: "file_mutations",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayPath),
 	},
 	{
 		normalizedName: "write",
 		nameAliases: ["write_file", "writefile"],
-		replayLegacyName: "cursor_write",
-		promptLabel: "Cursor write",
 		displayLabel: "Cursor write",
 		visibility: {},
-		replayWrapperLabel: "write",
-		replaySideEffectCategory: "file_mutations",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayPath),
 	},
 	{
 		normalizedName: "delete",
-		replayLegacyName: "cursor_delete",
-		promptLabel: "Cursor delete",
 		displayLabel: "Cursor delete",
 		visibility: {},
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayPath),
@@ -207,59 +177,49 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 	},
 	{
 		normalizedName: "readLints",
-		replayLegacyName: "cursor_read_lints",
-		promptLabel: "Cursor diagnostics",
 		displayLabel: "Cursor diagnostics",
 		visibility: {},
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayReadLints),
 		activityReplay: {
 			buildActivityArgs: buildReadLintsReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "updateTodos",
-		replayLegacyName: "cursor_update_todos",
-		promptLabel: "Cursor todos",
 		displayLabel: "Cursor todos",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "updateTodos",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayTodoCount),
 		activityReplay: {
 			buildActivityArgs: ({ args, result }) => buildTodoReplaySummaryArgs(args, result),
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "createPlan",
-		replayLegacyName: "cursor_create_plan",
-		promptLabel: "Cursor plan",
 		displayLabel: "Cursor plan",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "createPlan",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayPlan),
 		activityReplay: {
 			buildActivityArgs: buildCreatePlanReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "task",
-		replayLegacyName: "cursor_task",
-		promptLabel: "Cursor task",
 		displayLabel: "Cursor task",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "task",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayTask),
 		activityReplay: {
 			buildActivityArgs: buildTaskReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "generateImage",
-		replayLegacyName: "cursor_generate_image",
-		promptLabel: "Cursor image generation",
 		displayLabel: "Cursor image generation",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "generateImage",
@@ -273,50 +233,40 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 	},
 	{
 		normalizedName: "mcp",
-		replayLegacyName: "cursor_mcp",
-		replayOperationLabel: "MCP",
-		promptLabel: "Cursor MCP",
 		displayLabel: "Cursor MCP",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "mcp",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayMcp),
 		activityReplay: {
 			buildActivityArgs: buildMcpReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "semSearch",
-		replayLegacyName: "cursor_sem_search",
-		promptLabel: "Cursor semantic search",
 		displayLabel: "Cursor semantic search",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "semSearch",
 		replayCallSummary: withActivitySummaryFallback(formatReplaySemSearchQuery),
 		activityReplay: {
 			buildActivityArgs: buildSemSearchReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "recordScreen",
-		replayLegacyName: "cursor_record_screen",
-		promptLabel: "Cursor screen recording",
 		displayLabel: "Cursor screen recording",
 		visibility: { lifecycleEligible: true },
 		lifecycleLabelKind: "recordScreen",
 		replayCallSummary: withActivitySummaryFallback(summarizeReplayRecordScreen),
 		activityReplay: {
 			buildActivityArgs: buildRecordScreenReplaySummaryArgs,
-			buildDetails: buildEmptyReplayDetailFields,
+			buildDetails: EMPTY_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "webSearch",
 		nameAliases: ["websearch", "web_search", "web-search"],
-		replayLegacyName: "cursor_web_search",
-		replayOperationLabel: "web search",
-		promptLabel: "Cursor web search",
 		displayLabel: "Cursor web search",
 		visibility: { lifecycleEligible: true },
 		webKind: "webSearch",
@@ -327,15 +277,12 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		),
 		activityReplay: {
 			buildActivityArgs: buildWebSearchReplaySummaryArgs,
-			buildDetails: buildCollapsedReplayDetailFields,
+			buildDetails: COLLAPSED_REPLAY_DETAIL_FIELDS,
 		},
 	},
 	{
 		normalizedName: "webFetch",
 		nameAliases: ["webfetch", "web_fetch", "web-fetch"],
-		replayLegacyName: "cursor_web_fetch",
-		replayOperationLabel: "web fetch",
-		promptLabel: "Cursor web fetch",
 		displayLabel: "Cursor web fetch",
 		visibility: { lifecycleEligible: true },
 		webKind: "webFetch",
@@ -346,7 +293,7 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 		),
 		activityReplay: {
 			buildActivityArgs: buildWebFetchReplaySummaryArgs,
-			buildDetails: buildCollapsedReplayDetailFields,
+			buildDetails: COLLAPSED_REPLAY_DETAIL_FIELDS,
 		},
 	},
 ] as const satisfies readonly CursorToolPresentationSpec[];
@@ -354,56 +301,19 @@ export const CURSOR_TOOL_PRESENTATION_SPECS = [
 type CursorToolPresentationSpecEntry = (typeof CURSOR_TOOL_PRESENTATION_SPECS)[number];
 
 export type CursorNormalizedToolName = CursorReplaySourceToolName;
+export type CursorReplayToolName = typeof CURSOR_REPLAY_ACTIVITY_TOOL_NAME;
 
-export type CursorReplayLegacyToolName = Extract<
-	CursorToolPresentationSpecEntry,
-	{ readonly replayLegacyName: string }
->["replayLegacyName"];
-
-export type CursorReplayToolName = typeof CURSOR_REPLAY_ACTIVITY_TOOL_NAME | CursorReplayLegacyToolName;
-
-type CursorToolPresentationSpecWithReplayLegacy = Extract<
+type CursorToolPresentationSpecWithNeutralActivity = Extract<
 	CursorToolPresentationSpecEntry,
-	{ readonly replayLegacyName: string }
->;
+	{ readonly activityReplay: CursorToolActivityReplaySpec } | { readonly generateImageReplay: CursorToolGenerateImageReplaySpec }
+> | Extract<CursorToolPresentationSpecEntry, { readonly normalizedName: "edit" | "write" }>;
 
-const CURSOR_REPLAY_ACTIVITY_SIDE_EFFECT_CATEGORY: CursorReplaySideEffectCategory = "file_mutations";
+export type CursorReplayActivityToolName = CursorToolPresentationSpecWithNeutralActivity["normalizedName"];
 
-function hasReplayLegacyName(spec: CursorToolPresentationSpecEntry): spec is CursorToolPresentationSpecWithReplayLegacy {
-	return "replayLegacyName" in spec;
+function hasNeutralActivityTitle(spec: CursorToolPresentationSpec): boolean {
+	return Boolean(spec.activityReplay || spec.generateImageReplay || spec.normalizedName === "edit" || spec.normalizedName === "write");
 }
 
-type ReplayActivityLabelKeysFromSpecs<Specs extends readonly CursorToolPresentationSpecEntry[]> = {
-	[K in Extract<Specs[number], { readonly replayLegacyName: string }>["normalizedName"]]: Extract<
-		Specs[number],
-		{ readonly replayLegacyName: string; normalizedName: K }
-	>["replayLegacyName"];
-};
-
-function buildReplayActivityLabelKeysByToolName<const Specs extends readonly CursorToolPresentationSpecEntry[]>(
-	specs: Specs,
-): ReplayActivityLabelKeysFromSpecs<Specs> {
-	const labelKeys: Record<string, CursorReplayLegacyToolName> = {};
-	for (const spec of specs) {
-		if (!hasReplayLegacyName(spec)) continue;
-		labelKeys[spec.normalizedName] = spec.replayLegacyName;
-	}
-	return labelKeys as ReplayActivityLabelKeysFromSpecs<Specs>;
-}
-
-const CURSOR_REPLAY_SPECS = CURSOR_TOOL_PRESENTATION_SPECS.filter(hasReplayLegacyName);
-
-/** Stable registration order for native replay tool wrappers (registry declaration order). */
-export const CURSOR_REPLAY_LEGACY_TOOL_NAMES: readonly CursorReplayLegacyToolName[] = CURSOR_REPLAY_SPECS.map(
-	(spec) => spec.replayLegacyName,
-);
-
-export const CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME = buildReplayActivityLabelKeysByToolName(
-	CURSOR_TOOL_PRESENTATION_SPECS,
-);
-
-export type CursorReplayActivityToolName = keyof typeof CURSOR_REPLAY_ACTIVITY_LABEL_KEYS_BY_TOOL_NAME;
-
 const SPECS_BY_NORMALIZED_NAME = new Map<string, CursorToolPresentationSpec>(
 	CURSOR_TOOL_PRESENTATION_SPECS.map((spec) => [spec.normalizedName, spec]),
 );
@@ -412,10 +322,6 @@ const SPECS_BY_NORMALIZED_KEY = new Map<string, CursorToolPresentationSpec>(
 	CURSOR_TOOL_PRESENTATION_SPECS.map((spec) => [spec.normalizedName.toLowerCase(), spec]),
 );
 
-const SPECS_BY_REPLAY_LEGACY_NAME = new Map<CursorReplayLegacyToolName, CursorToolPresentationSpec>(
-	CURSOR_REPLAY_SPECS.map((spec) => [spec.replayLegacyName, spec]),
-);
-
 const ALIAS_TO_NORMALIZED_NAME = new Map<string, CursorNormalizedToolName>(
 	CURSOR_TOOL_PRESENTATION_SPECS.flatMap((spec) => {
 		const aliases = "nameAliases" in spec ? spec.nameAliases : undefined;
@@ -437,11 +343,7 @@ export function getCursorToolPresentationSpec(
 ): CursorToolPresentationSpec | undefined {
 	const trimmed = name.trim();
 	if (!trimmed) return undefined;
-	return (
-		SPECS_BY_NORMALIZED_NAME.get(trimmed) ??
-		SPECS_BY_NORMALIZED_KEY.get(trimmed.toLowerCase()) ??
-		(isCursorReplayLegacyToolName(trimmed) ? SPECS_BY_REPLAY_LEGACY_NAME.get(trimmed) : undefined)
-	);
+	return SPECS_BY_NORMALIZED_NAME.get(trimmed) ?? SPECS_BY_NORMALIZED_KEY.get(trimmed.toLowerCase());
 }
 
 export function normalizeCursorToolName(name: string): string {
@@ -464,65 +366,36 @@ export function classifyCursorWebToolKind(name: string | undefined): CursorWebTo
 	return spec?.webKind;
 }
 
-const CURSOR_REPLAY_LEGACY_TOOL_NAME_SET: ReadonlySet<string> = new Set(CURSOR_REPLAY_LEGACY_TOOL_NAMES);
-
-export function isCursorReplayLegacyToolName(toolName: string): toolName is CursorReplayLegacyToolName {
-	return CURSOR_REPLAY_LEGACY_TOOL_NAME_SET.has(toolName);
-}
-
 export function isCursorReplayToolName(toolName: string): toolName is CursorReplayToolName {
-	return toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME || isCursorReplayLegacyToolName(toolName);
+	return toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME;
 }
 
 export function isExcludedFromCursorBridgeExposure(toolName: string): boolean {
-	return toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME || isCursorReplayLegacyToolName(toolName);
-}
-
-export function getCursorReplayWrapperLabel(toolName: CursorReplayToolName): string {
-	if (toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME) return getCursorReplayDisplayLabel(toolName);
-	const spec = SPECS_BY_REPLAY_LEGACY_NAME.get(toolName);
-	return spec?.replayWrapperLabel ?? getCursorReplayDisplayLabel(toolName);
-}
-
-export function getCursorReplaySideEffectCategory(toolName: CursorReplayToolName): CursorReplaySideEffectCategory {
-	if (toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME) return CURSOR_REPLAY_ACTIVITY_SIDE_EFFECT_CATEGORY;
-	return SPECS_BY_REPLAY_LEGACY_NAME.get(toolName)?.replaySideEffectCategory ?? "real_tool_work";
-}
-
-export function getCursorReplaySideEffectDescription(toolName: CursorReplayToolName): string {
-	return getCursorReplaySideEffectCategory(toolName) === "file_mutations" ? "file mutations" : "real tool work";
-}
-
-export function getCursorReplayOperationLabel(toolName: CursorReplayLegacyToolName): string {
-	const spec = SPECS_BY_REPLAY_LEGACY_NAME.get(toolName);
-	return spec?.replayOperationLabel ?? spec?.normalizedName ?? toolName;
+	return toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME;
 }
 
 export function getCursorReplayPromptLabel(toolName: string): string {
-	if (toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME) return "Cursor activity";
-	if (isCursorReplayLegacyToolName(toolName)) {
-		const spec = SPECS_BY_REPLAY_LEGACY_NAME.get(toolName);
-		return spec?.promptLabel ?? toolName;
-	}
-	return toolName;
+	return toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME ? "Cursor activity" : toolName;
 }
 
-export function getCursorReplayDisplayLabel(toolName: CursorReplayToolName): string {
-	if (toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME) return "Cursor activity";
-	const spec = SPECS_BY_REPLAY_LEGACY_NAME.get(toolName);
-	return spec?.displayLabel ?? toolName;
+export function getCursorReplayActivityTitle(toolName: string): string | undefined {
+	const spec = getCursorToolPresentationSpec(toolName);
+	if (!spec || !hasNeutralActivityTitle(spec)) return undefined;
+	return spec.displayLabel;
 }
 
-export function getCursorReplayActivityLabelKey(toolName: string): CursorReplayLegacyToolName | undefined {
-	const spec = getCursorToolPresentationSpec(toolName);
-	if (!spec?.replayLegacyName || !isCursorReplayLegacyToolName(spec.replayLegacyName)) return undefined;
-	return spec.replayLegacyName;
+function buildCursorGenericActivityTitle(displayName: string): string {
+	if (!displayName || displayName === "unknown") return "Cursor tool";
+	return `Cursor ${truncateCursorDisplayLine(displayName, 120)}`;
 }
 
-export function getCursorReplayActivityTitle(toolName: string): string | undefined {
-	const spec = getCursorToolPresentationSpec(toolName);
-	if (!spec?.replayLegacyName) return undefined;
-	return spec.displayLabel;
+/** 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 {
@@ -546,11 +419,11 @@ export function getCursorToolGenerateImageReplaySpec(normalizedKey: string): Cur
 }
 
 export function getCursorReplayCallSummary(
-	toolName: CursorReplayToolName,
+	toolName: CursorReplayToolName | CursorReplaySourceToolName,
 	args: CursorReplaySummaryArgs | undefined,
 ): string | undefined {
 	if (toolName === CURSOR_REPLAY_ACTIVITY_TOOL_NAME) {
 		return readCursorReplaySummaryString(args, "activitySummary") ?? summarizeReplayGenericActivity(args);
 	}
-	return SPECS_BY_REPLAY_LEGACY_NAME.get(toolName)?.replayCallSummary?.(args);
+	return getCursorToolPresentationSpec(toolName)?.replayCallSummary?.(args);
 }

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 } : {}),
+	};
+}