pi-cursor-sdk 0.1.36 → 0.1.38

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);

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

@@ -1,19 +1,29 @@
 import { resolveCursorEditDiff } from "./cursor-edit-diff.js";
-import { scrubSensitiveText } from "./cursor-sensitive-text.js";
-import { extractWebFetchTarget, extractWebSearchQuery } from "./cursor-web-tool-activity.js";
-import { getFirstStringByKeys } from "./cursor-record-utils.js";
+import { extractWebFetchTarget, extractWebSearchQuery } from "./cursor-web-tool-args.js";
 import {
 	asRecord,
-	formatDisplayPath,
-	formatDiffHeaderLine,
-	formatDiffString,
-	formatError,
-	formatPathArg,
 	getArray,
 	getBoolean,
+	getFirstStringByKeys,
 	getNumber,
 	getRecord,
 	getString,
+} from "./cursor-record-utils.js";
+import {
+	collectTaskText,
+	getGenerateImageDisplayPath,
+	readMcpDisplayResult,
+	getReadLintDiagnostics,
+	getReadLintPaths,
+	getTaskDescription,
+	getTodoItems,
+} from "./cursor-tool-result-display-readers.js";
+
+import {
+	formatDisplayPath,
+	formatDiffString,
+	formatError,
+	formatPathArg,
 	joinSections,
 	limitItems,
 	limitText,
@@ -23,7 +33,6 @@ import {
 	DEFAULT_NATIVE_READ_DISPLAY_LINES,
 	readFilePreview,
 	stringifyUnknown,
-	firstNonEmptyLine,
 	truncateArg,
 	type NormalizedResult,
 	type TranscriptOptions,
@@ -445,38 +454,6 @@ export function formatDelete(args: Record<string, unknown>, result: NormalizedRe
 	return joinSections(`delete ${path}`, fileSize !== undefined ? `Deleted ${fileSize} bytes` : stringifyUnknown(result.value));
 }
 
-export function getReadLintPaths(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): 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: NormalizedResult, options: TranscriptOptions): 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 formatReadLints(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const paths = getReadLintPaths(args, result, options);
 	const header = `readLints${paths.length > 0 ? ` ${paths.join(" ")}` : ""}`;
@@ -487,24 +464,6 @@ export function formatReadLints(args: Record<string, unknown>, result: Normalize
 	return joinSections(header, limitText(lines.join("\n") || stringifyUnknown(result.value), options));
 }
 
-export function getTodoItems(args: Record<string, unknown>, result: NormalizedResult): Array<{ content: string; status?: string }> {
-	const value = asRecord(result.value);
-	const rawTodos = getArray(value, "todos") ?? getArray(args, "todos") ?? [];
-	const todos: Array<{ content: string; status?: string }> = [];
-	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: NormalizedResult, todos: Array<{ content: string; status?: string }>): number {
-	return getNumber(asRecord(result.value), "totalCount") ?? getNumber(args, "totalCount") ?? todos.length;
-}
-
 function formatTodoStatus(status: string | undefined): string {
 	if (status === "completed") return "✓";
 	if (status === "inProgress") return "…";
@@ -527,32 +486,6 @@ export function formatPlan(args: Record<string, unknown>, result: NormalizedResu
 	return formatTodos(args, result, options, "createPlan");
 }
 
-export function getTaskDescription(args: Record<string, unknown>, result: NormalizedResult): 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: NormalizedResult): 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 formatTask(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const description = getTaskDescription(args, result);
 	if (result.status === "error") return joinSections(`task ${description}`, formatError(result.error));
@@ -560,34 +493,10 @@ export function formatTask(args: Record<string, unknown>, result: NormalizedResu
 	return joinSections(`task ${description}`, limitText(taskText || stringifyUnknown(result.value), options));
 }
 
-function getGenerateImageValue(result: NormalizedResult): Record<string, unknown> | undefined {
-	return asRecord(result.value);
-}
-
-export function getGenerateImagePath(args: Record<string, unknown>, result: NormalizedResult): string | undefined {
-	const value = getGenerateImageValue(result);
-	return getString(value, "filePath") ?? getString(args, "filePath") ?? getString(args, "path");
-}
-
-export function getGenerateImageDisplayPath(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): 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;
-}
-
 export function formatGenerateImage(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const prompt = getString(args, "prompt") ?? getString(args, "description") ?? "image";
 	if (result.status === "error") return joinSections(`generateImage ${prompt}`, formatError(result.error));
-	const value = getGenerateImageValue(result);
+	const value = asRecord(result.value);
 	const displayPath = getGenerateImageDisplayPath(args, result, options);
 	const hasImageData = typeof value?.imageData === "string" && value.imageData.length > 0;
 	const lines = [displayPath ? `Saved image: ${displayPath}` : undefined, hasImageData ? "Image data returned by Cursor SDK." : undefined].filter(
@@ -597,26 +506,6 @@ export function formatGenerateImage(args: Record<string, unknown>, result: Norma
 	return joinSections(`generateImage ${prompt}`, limitText(stringifyUnknown(result.value), options));
 }
 
-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 function formatSemSearch(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const query = getString(args, "query") ?? "semantic search";
 	const header = `semSearch ${truncateArg(query)}`;
@@ -681,69 +570,31 @@ export function formatRecordScreen(args: Record<string, unknown>, result: Normal
 	return joinSections(header, lines.join("\n"));
 }
 
-export function getMcpResultPreview(result: NormalizedResult): string | undefined {
-	if (result.status === "error") return undefined;
-	const value = asRecord(result.value);
-	const content = getArray(value, "content") ?? [];
-	for (const entry of content) {
-		const text = getMcpContentText(entry);
-		if (text) {
-			const line = firstNonEmptyLine(text);
-			if (line) return truncateArg(scrubSensitiveText(line), 120);
-		}
-		const summary = describeNonTextMcpContent(entry);
-		if (summary) return summary;
-	}
-	return undefined;
-}
-
 function formatWebToolBody(
 	toolLabel: string,
-	args: Record<string, unknown>,
 	result: NormalizedResult,
 	options: TranscriptOptions,
-	summaryArg: string | undefined,
 ): string {
 	if (result.status === "error") return joinSections(toolLabel, formatError(result.error));
-	const summary = summaryArg ? `${summaryArg}\n\n` : "";
-	const value = asRecord(result.value);
-	const isError = getBoolean(value, "isError");
-	const content = getArray(value, "content") ?? [];
-	const text = content
-		.map((entry) => getMcpContentText(entry))
-		.filter((entry): entry is string => Boolean(entry))
-		.join("\n");
-	const contentSummary = content.length > 0 ? content.map(describeNonTextMcpContent).join("\n") : stringifyUnknown(result.value);
-	const body = `${isError ? "[tool error]\n" : ""}${text || contentSummary}`;
-	return joinSections(toolLabel, limitText(`${summary}${body}`.trim(), options));
+	return joinSections(toolLabel, limitText(readMcpDisplayResult(result).body, options));
 }
 
 export function formatWebSearch(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const query = extractWebSearchQuery(args);
 	const header = query ? `web search ${query}` : "web search";
-	return formatWebToolBody(header, args, result, options, undefined);
+	return formatWebToolBody(header, result, options);
 }
 
 export function formatWebFetch(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const target = extractWebFetchTarget(args);
 	const header = target ? `web fetch ${target}` : "web fetch";
-	return formatWebToolBody(header, args, result, options, undefined);
+	return formatWebToolBody(header, result, options);
 }
 
 export function formatMcp(args: Record<string, unknown>, result: NormalizedResult, options: TranscriptOptions): string {
 	const toolName = typeof args.toolName === "string" ? args.toolName : "mcp";
 	if (result.status === "error") return joinSections(toolName, formatError(result.error));
-
-	const value = asRecord(result.value);
-	const isError = getBoolean(value, "isError");
-	const content = getArray(value, "content") ?? [];
-	const text = content
-		.map((entry) => getMcpContentText(entry))
-		.filter((entry): entry is string => Boolean(entry))
-		.join("\n");
-	const contentSummary = content.length > 0 ? content.map(describeNonTextMcpContent).join("\n") : stringifyUnknown(result.value);
-	const body = `${isError ? "[tool error]\n" : ""}${text || contentSummary}`;
-	return joinSections(toolName, limitText(body, options));
+	return joinSections(toolName, limitText(readMcpDisplayResult(result).body, options));
 }
 
 const UNKNOWN_TOOL_FALLBACK_MAX_ARGS = 8;

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

@@ -1,35 +1,27 @@
 import {
 	CURSOR_KNOWN_NORMALIZED_TOOL_NAMES,
 	CURSOR_REPLAY_ACTIVITY_TOOL_NAME,
-	getCursorReplayActivityLabelKey,
-	getCursorReplayActivityTitle,
 	getCursorReplayCallSummary,
-	getCursorReplayDisplayLabel,
+	getCursorToolActivityTitle,
 	getCursorToolActivityReplaySpec,
 	getCursorToolGenerateImageReplaySpec,
 	type CursorNormalizedToolName,
 	type CursorReplayActivityToolName,
-	type CursorReplayLegacyToolName,
 } from "./cursor-tool-presentation-registry.js";
 import { resolveCursorEditDiff } from "./cursor-edit-diff.js";
 import {
 	assembleCursorReplayActivityDetails,
 	assembleCursorReplayGenerateImageDetails,
-	buildCursorReplayNativeEditDetails,
-	buildCursorReplayNativeWriteDetails,
 	CURSOR_REPLAY_UNREGISTERED_ACTIVITY_TOOL_NAME,
 	type CursorReplayToolDetails,
 } from "./cursor-replay-tool-details.js";
+import { asRecord, getNumber, getString } from "./cursor-record-utils.js";
 import {
-	asRecord,
 	firstNonEmptyLine,
 	formatDisplayPath,
 	formatDiffString,
 	formatError,
-	getNumber,
-	getString,
 	limitText,
-	stringifyUnknown,
 	truncateArg,
 	type CursorPiToolDisplay,
 	type NormalizedResult,
@@ -71,8 +63,6 @@ import {
 	getShellOutput,
 	usesLocalReadPreview,
 } from "./cursor-transcript-tool-formatters.js";
-import type { CursorReplaySummaryArgs } from "./cursor-replay-summary-args.js";
-
 export interface ToolDisplayContext {
 	rawName: string;
 	name: string;
@@ -88,12 +78,6 @@ interface ToolDisplaySpec {
 	buildPiToolDisplay: (context: ToolDisplayContext) => CursorPiToolDisplay;
 }
 
-function requireReplayActivityLabelKey(normalizedName: CursorReplayActivityToolName): CursorReplayLegacyToolName {
-	const labelKey = getCursorReplayActivityLabelKey(normalizedName);
-	if (!labelKey) throw new Error(`Missing replay activity label for ${normalizedName}`);
-	return labelKey;
-}
-
 function textToolResult(text: string, details?: unknown): PiToolDisplayResult {
 	return { content: [{ type: "text", text }], details };
 }
@@ -111,13 +95,6 @@ function buildCursorActivityDisplayArgs(
 	};
 }
 
-function buildRegistryReplaySummary(
-	labelKey: CursorReplayLegacyToolName,
-	args: CursorReplaySummaryArgs,
-): string | undefined {
-	return getCursorReplayCallSummary(labelKey, args);
-}
-
 function buildReplaySummaryDisplay(
 	toolName: string,
 	args: Record<string, unknown>,
@@ -140,21 +117,16 @@ function buildReplaySummaryDisplay(
 	};
 }
 
-function getCursorToolActivityTitle(toolName: string): string {
-	return getCursorReplayActivityTitle(toolName) ?? buildGenericUnknownToolActivityTitle(toolName);
-}
-
 function buildActivityReplayDisplay(
 	sourceToolName: NeutralActivityReplayToolName,
 	context: ToolDisplayContext,
 ): CursorPiToolDisplay {
-	const spec = TOOL_DISPLAY_SPECS[sourceToolName];
+	const spec = TOOL_DISPLAY_IMPLEMENTATIONS[sourceToolName];
 	const activity = getCursorToolActivityReplaySpec(sourceToolName);
 	if (!activity) throw new Error(`Missing activity replay spec for ${sourceToolName}`);
-	const labelKey = requireReplayActivityLabelKey(sourceToolName);
-	const activityTitle = getCursorReplayDisplayLabel(labelKey);
+	const activityTitle = getCursorToolActivityTitle(sourceToolName);
 	const replayArgs = activity.buildActivityArgs(context);
-	const activitySummary = buildRegistryReplaySummary(labelKey, replayArgs);
+	const activitySummary = getCursorReplayCallSummary(sourceToolName, replayArgs);
 	const activityArgs = buildCursorActivityDisplayArgs({ ...replayArgs }, activityTitle, activitySummary);
 	const contentText = spec.formatTranscript(context).trimEnd();
 	const activityFields = activity.buildDetails(context, contentText);
@@ -170,13 +142,12 @@ function buildActivityReplayDisplay(
 }
 
 function buildGenerateImageReplayDisplay(context: ToolDisplayContext): CursorPiToolDisplay {
-	const spec = TOOL_DISPLAY_SPECS.generateImage;
+	const spec = TOOL_DISPLAY_IMPLEMENTATIONS.generateImage;
 	const replay = getCursorToolGenerateImageReplaySpec("generateImage");
 	if (!replay) throw new Error("Missing generate image replay spec");
-	const labelKey = requireReplayActivityLabelKey("generateImage");
-	const activityTitle = getCursorReplayDisplayLabel(labelKey);
+	const activityTitle = getCursorToolActivityTitle("generateImage");
 	const replayArgs = replay.buildActivityArgs(context);
-	const activitySummary = buildRegistryReplaySummary(labelKey, replayArgs);
+	const activitySummary = getCursorReplayCallSummary("generateImage", replayArgs);
 	const activityArgs = buildCursorActivityDisplayArgs({ ...replayArgs }, activityTitle, activitySummary);
 	const contentText = spec.formatTranscript(context).trimEnd();
 	const details = assembleCursorReplayGenerateImageDetails(
@@ -188,24 +159,15 @@ function buildGenerateImageReplayDisplay(context: ToolDisplayContext): CursorPiT
 	return buildReplaySummaryDisplay(CURSOR_REPLAY_ACTIVITY_TOOL_NAME, activityArgs, context.result, contentText, details);
 }
 
-function buildGenericUnknownToolActivityTitle(displayName: string): string {
-	if (displayName === "unknown") return "Cursor tool";
-	return `Cursor ${truncateArg(displayName)}`;
-}
-
 function buildGenericPiToolDisplay(context: ToolDisplayContext): CursorPiToolDisplay {
 	const { rawName, name, args, result, options } = context;
 	const displayName = rawName.trim() || name;
-	const activityTitle = buildGenericUnknownToolActivityTitle(displayName);
+	const activityTitle = getCursorToolActivityTitle(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 activityArgs = buildCursorActivityDisplayArgs({}, activityTitle, activitySummary);
 	const summary =
 		result.status === "error"
 			? undefined
@@ -252,14 +214,15 @@ function buildEditPiToolDisplay(context: ToolDisplayContext): CursorPiToolDispla
 	const activityTitle = getCursorToolActivityTitle("edit");
 	const activityArgs = buildCursorActivityDisplayArgs(baseActivityArgs, activityTitle, displayPath);
 	const contentText = formatEdit(activityArgs, result, options);
-	const details = buildCursorReplayNativeEditDetails({
+	const details: CursorReplayToolDetails = {
+		variant: "nativeEdit",
 		path: displayPath,
 		linesAdded: getNumber(value, "linesAdded"),
 		linesRemoved: getNumber(value, "linesRemoved"),
 		diffString: normalizedDiff,
 		diff: normalizedDiff,
 		firstChangedLine: getNumber(value, "firstChangedLine"),
-	});
+	};
 	if (nativeEditArgs) {
 		return {
 			toolName: "edit",
@@ -299,13 +262,14 @@ function buildWritePiToolDisplay(context: ToolDisplayContext): CursorPiToolDispl
 	const displayArgs = buildWriteDisplayArgs(args, options);
 	const displayPath = typeof args.path === "string" ? formatDisplayPath(args.path, options.cwd) : undefined;
 	const contentText = formatWrite(args, result, options).trimEnd();
-	const details = buildCursorReplayNativeWriteDetails({
+	const details: CursorReplayToolDetails = {
+		variant: "nativeWrite",
 		path: displayPath,
 		linesCreated: getNumber(value, "linesCreated"),
 		fileSize: getNumber(value, "fileSize"),
 		fileContentAfterWrite: getString(value, "fileContentAfterWrite"),
 		expandedText: contentText,
-	});
+	};
 	if (content === undefined) {
 		const activityTitle = getCursorToolActivityTitle("write");
 		return buildReplaySummaryDisplay(
@@ -455,12 +419,8 @@ const TOOL_DISPLAY_IMPLEMENTATIONS: Record<CursorNormalizedToolName, ToolDisplay
 
 export const CURSOR_TOOL_DISPLAY_SPEC_KEYS = CURSOR_KNOWN_NORMALIZED_TOOL_NAMES;
 
-const TOOL_DISPLAY_SPECS = Object.fromEntries(
-	CURSOR_KNOWN_NORMALIZED_TOOL_NAMES.map((name) => [name, TOOL_DISPLAY_IMPLEMENTATIONS[name]]),
-) as Record<CursorNormalizedToolName, ToolDisplaySpec>;
-
 function getToolDisplaySpec(name: string): ToolDisplaySpec | undefined {
-	if (Object.hasOwn(TOOL_DISPLAY_SPECS, name)) return TOOL_DISPLAY_SPECS[name as CursorNormalizedToolName];
+	if (Object.hasOwn(TOOL_DISPLAY_IMPLEMENTATIONS, name)) return TOOL_DISPLAY_IMPLEMENTATIONS[name as CursorNormalizedToolName];
 	return undefined;
 }
 

package/src/cursor-transcript-utils.ts

@@ -1,8 +1,6 @@
 import { closeSync, openSync, readSync, realpathSync, statSync } from "node:fs";
 import { isAbsolute, relative, resolve } from "node:path";
-import { asRecord, getFirstStringByKeys } from "./cursor-record-utils.js";
-
-export { asRecord, getFirstStringByKeys } from "./cursor-record-utils.js";
+import { asRecord, getArray, getRecord, getString, stringifyUnknown as stringifyUnknownValue } from "./cursor-record-utils.js";
 
 export interface TranscriptOptions {
 	maxChars?: number;
@@ -47,30 +45,6 @@ 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;
-}
-
-export function getNumber(record: Record<string, unknown> | undefined, key: string): number | undefined {
-	const value = record?.[key];
-	return typeof value === "number" && Number.isFinite(value) ? value : undefined;
-}
-
-export function getBoolean(record: Record<string, unknown> | undefined, key: string): boolean | undefined {
-	const value = record?.[key];
-	return typeof value === "boolean" ? value : undefined;
-}
-
-export function getRecord(record: Record<string, unknown> | undefined, key: string): Record<string, unknown> | undefined {
-	return asRecord(record?.[key]);
-}
-
-export function getArray(record: Record<string, unknown> | undefined, key: string): unknown[] | undefined {
-	const value = record?.[key];
-	return Array.isArray(value) ? value : undefined;
-}
-
 export function getToolName(toolCall: unknown): string {
 	const record = asRecord(toolCall);
 	return getString(record, "name") ?? getString(record, "type") ?? getString(record, "toolName") ?? "unknown";
@@ -96,13 +70,7 @@ export function normalizeResult(result: unknown): NormalizedResult {
 }
 
 export function stringifyUnknown(value: unknown): string {
-	if (value === undefined) return "";
-	if (typeof value === "string") return value;
-	try {
-		return JSON.stringify(value, null, 2) ?? String(value);
-	} catch {
-		return String(value);
-	}
+	return stringifyUnknownValue(value, { pretty: true });
 }
 
 export function limitText(text: string, options: TranscriptOptions = {}, knownTotalLines?: number): string {

package/src/cursor-usage-accounting.ts

@@ -3,9 +3,7 @@ import {
 	CURSOR_APPROX_CHARS_PER_TOKEN,
 	CURSOR_IMAGE_TOKEN_ESTIMATE,
 	estimateCursorContextTokens,
-	estimateCursorPromptTokens,
 	estimateCursorTextTokens,
-	type CursorPrompt,
 	type CursorPromptOptions,
 } from "./context.js";
 
@@ -28,10 +26,6 @@ export function getCursorPromptOptions(model: Model<Api>): CursorUsagePromptOpti
 	};
 }
 
-export function estimateCursorPromptInputTokens(prompt: CursorPrompt, options: Pick<CursorPromptOptions, "charsPerToken" | "imageTokenEstimate">): number {
-	return estimateCursorPromptTokens(prompt, options);
-}
-
 function stringifyUsageValue(value: unknown): string {
 	try {
 		return JSON.stringify(value) ?? "";

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

@@ -1,23 +1,15 @@
+import { getFirstStringByKeys } from "./cursor-record-utils.js";
 import {
-	classifyCursorWebToolKind as classifyCursorWebToolKindFromRegistry,
-	type CursorWebToolKind,
+	classifyCursorWebToolKind,
+	normalizeCursorToolName as normalizeToolName,
 } from "./cursor-tool-presentation-registry.js";
-import { normalizeCursorToolName as normalizeToolName } from "./cursor-tool-presentation-registry.js";
-import { extractWebFetchTarget, extractWebSearchQuery } from "./cursor-web-tool-args.js";
-
-export type { CursorWebToolKind } from "./cursor-tool-presentation-registry.js";
-export { extractWebFetchTarget, extractWebSearchQuery } from "./cursor-web-tool-args.js";
 
 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 toolName = getFirstStringByKeys(args, ["toolName", "tool_name"]);
 	const trimmed = toolName?.trim();
 	return trimmed || undefined;
 }
 
-export function classifyCursorWebToolKind(name: string | undefined): CursorWebToolKind | undefined {
-	return classifyCursorWebToolKindFromRegistry(name);
-}
-
 /**
  * Maps SDK/host/MCP tool names to transcript display keys.
  * Web search/fetch often arrives as MCP `toolName` values, not dedicated SDK ToolTypes.