feat: Implement file interaction tracking and stats view\n\nImplementation Summary\nWe've successfully implemented a file interaction tracking system for the VS Code extension that:\n\nTracks File Operations:\n\nCaptures read, write, create, edit, and other file operations\nStores metadata like file path, operation type, timestamp, and success status\nWorks with both file tools in the code\n\nDisplays Statistics in a Dedicated View:\n\nBuilt a FileStatsView component that shows:\n\nTotal tool usage count\nLists of written files\nLists of read files\nOperation counts by type\n\n\nIntegration Points:\n\nAdded to the ChatView.tsx:\n\nFile interactions extraction from messages\nUI for toggling the stats view\n\n\nExtended TaskHeader.tsx with a stats button\nAdded message handlers in webviewMessageHandler.ts for:\n\nRequesting file interactions data\nUpdating file interaction history\nToggling the stats view\n\n\nStorage & Persistence:\n\nFile interactions are stored with tasks in JSON files\nInteractions are persisted along with task history\nInteractions can be loaded for both active and historical tasks\n\n\nUser Interface:\n\nClean, organized stats view with collapsible sections\nFiles can be clicked to open them directly\nVisual indicators for different operation types\n\n\nHow It Works\n\nWhen file tools are used (read/write/etc.), the operation is recorded with metadata\nThese operations are stored in memory during the task and saved to disk\nThe UI can extract file operations directly from messages or load them from storage\nThe Stats View provides detailed information about file interactions for the current task\n\nKey Components\n\nFileInteraction type in WebviewMessage.ts\nFileStatsView component for displaying statistics\nThe stats view toggle button in TaskHeader.tsx\nFile interaction extraction logic in ChatView.tsx\nFile interaction message handlers in webviewMessageHandler.ts\n\nHow Users Interact With It\nUsers can:\n\nClick the stats button (graph icon) in the task header to toggle the stats view\nSee real-time updates of file operations as they happen\nReview file operations after the task is completed\nClick on files to open them directly in the editor\n\nThis implementation lays the foundation for a more comprehensive statistics tracking system in the future, which could include additional metrics like token usage, function calls, and other performance data.

Author: dlab-anton

src/core/tools/listFilesTool.ts

@@ -6,6 +6,7 @@ import { formatResponse } from "../prompts/responses"
 import { listFiles } from "../../services/glob/list-files"
 import { getReadablePath } from "../../utils/path"
 import { ToolUse, AskApproval, HandleError, PushToolResult, RemoveClosingTag } from "../../shared/tools"
+import { isPathOutsideWorkspace } from "../../utils/pathUtils"
 
 /**
  * Implements the list_files tool.
@@ -34,9 +35,14 @@ export async function listFilesTool(
 	const recursiveRaw: string | undefined = block.params.recursive
 	const recursive = recursiveRaw?.toLowerCase() === "true"
 
+	// Determine if the path is outside the workspace
+	const fullPath = relDirPath ? path.resolve(cline.cwd, removeClosingTag("path", relDirPath)) : ""
+	const isOutsideWorkspace = isPathOutsideWorkspace(fullPath)
+
 	const sharedMessageProps: ClineSayTool = {
 		tool: !recursive ? "listFilesTopLevel" : "listFilesRecursive",
 		path: getReadablePath(cline.cwd, removeClosingTag("path", relDirPath)),
+		isOutsideWorkspace,
 	}
 
 	try {
@@ -66,7 +72,19 @@ export async function listFilesTool(
 				showRooIgnoredFiles,
 			)
 
-			const completeMessage = JSON.stringify({ ...sharedMessageProps, content: result } satisfies ClineSayTool)
+			const completeMessage = JSON.stringify({ 
+				...sharedMessageProps, 
+				content: result,
+				fileInteraction: {
+					path: relDirPath,
+					operation: 'list',
+					timestamp: Date.now(),
+					success: true,
+					isOutsideWorkspace,
+					taskId: cline.taskId
+				}
+			} satisfies ClineSayTool)
+			
 			const didApprove = await askApproval("tool", completeMessage)
 
 			if (!didApprove) {

src/core/tools/readFileTool.ts

@@ -45,7 +45,7 @@ export async function readFileTool(
 				cline.consecutiveMistakeCount++
 				cline.recordToolError("read_file")
 				const errorMsg = await cline.sayAndCreateMissingParamError("read_file", "path")
-				pushToolResult(`<file><path></path><error>${errorMsg}</error></file>`)
+				pushToolResult(`<file><path></path><e>${errorMsg}</e></file>`)
 				return
 			}
 
@@ -71,7 +71,7 @@ export async function readFileTool(
 					cline.consecutiveMistakeCount++
 					cline.recordToolError("read_file")
 					await cline.say("error", `Failed to parse start_line: ${startLineStr}`)
-					pushToolResult(`<file><path>${relPath}</path><error>Invalid start_line value</error></file>`)
+					pushToolResult(`<file><path>${relPath}</path><e>Invalid start_line value</e></file>`)
 					return
 				}
 
@@ -87,7 +87,7 @@ export async function readFileTool(
 					cline.consecutiveMistakeCount++
 					cline.recordToolError("read_file")
 					await cline.say("error", `Failed to parse end_line: ${endLineStr}`)
-					pushToolResult(`<file><path>${relPath}</path><error>Invalid end_line value</error></file>`)
+					pushToolResult(`<file><path>${relPath}</path><e>Invalid end_line value</e></file>`)
 					return
 				}
 
@@ -100,7 +100,7 @@ export async function readFileTool(
 			if (!accessAllowed) {
 				await cline.say("rooignore_error", relPath)
 				const errorMsg = formatResponse.rooIgnoreError(relPath)
-				pushToolResult(`<file><path>${relPath}</path><error>${errorMsg}</error></file>`)
+				pushToolResult(`<file><path>${relPath}</path><e>${errorMsg}</e></file>`)
 				return
 			}
 
@@ -124,11 +124,29 @@ export async function readFileTool(
 			cline.consecutiveMistakeCount = 0
 			const absolutePath = path.resolve(cline.cwd, relPath)
 
-			const completeMessage = JSON.stringify({
+			// Create the ClineSayTool object that conforms to the type
+			const completeMessageObj: ClineSayTool = {
 				...sharedMessageProps,
 				content: absolutePath,
-				reason: lineSnippet,
-			} satisfies ClineSayTool)
+				reason: lineSnippet
+			}
+			
+			// Convert to JSON string
+			const completeMessage = JSON.stringify(completeMessageObj)
+
+			// Track file interaction separately (not as part of the ClineSayTool)
+			// This will be handled by the message handler in the webview
+			cline.postMessage?.({
+				type: "trackFileInteraction",
+				fileInteraction: {
+					path: relPath,
+					operation: 'read',
+					timestamp: Date.now(),
+					success: true,
+					isOutsideWorkspace,
+					taskId: cline.taskId
+				}
+			})
 
 			const didApprove = await askApproval("tool", completeMessage)
 
@@ -240,7 +258,7 @@ export async function readFileTool(
 		}
 	} catch (error) {
 		const errorMsg = error instanceof Error ? error.message : String(error)
-		pushToolResult(`<file><path>${relPath || ""}</path><error>Error reading file: ${errorMsg}</error></file>`)
+		pushToolResult(`<file><path>${relPath || ""}</path><e>Error reading file: ${errorMsg}</e></file>`)
 		await handleError("reading file", error)
 	}
 }

src/core/tools/searchFilesTool.ts

@@ -5,6 +5,7 @@ import { ToolUse, AskApproval, HandleError, PushToolResult, RemoveClosingTag } f
 import { ClineSayTool } from "../../shared/ExtensionMessage"
 import { getReadablePath } from "../../utils/path"
 import { regexSearchFiles } from "../../services/ripgrep"
+import { isPathOutsideWorkspace } from "../../utils/pathUtils"
 
 export async function searchFilesTool(
 	cline: Cline,
@@ -18,11 +19,16 @@ export async function searchFilesTool(
 	const regex: string | undefined = block.params.regex
 	const filePattern: string | undefined = block.params.file_pattern
 
+	// Determine if the path is outside the workspace
+	const fullPath = relDirPath ? path.resolve(cline.cwd, removeClosingTag("path", relDirPath)) : ""
+	const isOutsideWorkspace = isPathOutsideWorkspace(fullPath)
+
 	const sharedMessageProps: ClineSayTool = {
 		tool: "searchFiles",
 		path: getReadablePath(cline.cwd, removeClosingTag("path", relDirPath)),
 		regex: removeClosingTag("regex", regex),
 		filePattern: removeClosingTag("file_pattern", filePattern),
+		isOutsideWorkspace,
 	}
 
 	try {
@@ -57,7 +63,19 @@ export async function searchFilesTool(
 				cline.rooIgnoreController,
 			)
 
-			const completeMessage = JSON.stringify({ ...sharedMessageProps, content: results } satisfies ClineSayTool)
+			const completeMessage = JSON.stringify({ 
+				...sharedMessageProps, 
+				content: results,
+				fileInteraction: {
+					path: relDirPath,
+					operation: 'search',
+					timestamp: Date.now(),
+					success: true,
+					isOutsideWorkspace,
+					taskId: cline.taskId
+				}
+			} satisfies ClineSayTool)
+			
 			const didApprove = await askApproval("tool", completeMessage)
 
 			if (!didApprove) {

src/core/tools/writeToFileTool.ts

@@ -198,6 +198,14 @@ export async function writeToFileTool(
 				diff: fileExists
 					? formatResponse.createPrettyPatch(relPath, cline.diffViewProvider.originalContent, newContent)
 					: undefined,
+				fileInteraction: {
+					path: relPath,
+					operation: fileExists ? 'edit' : 'create',
+					timestamp: Date.now(),
+					success: true,
+					isOutsideWorkspace,
+					taskId: cline.taskId
+				}
 			} satisfies ClineSayTool)
 
 			const didApprove = await askApproval("tool", completeMessage)

src/core/webview/webviewMessageHandler.ts

@@ -9,7 +9,7 @@ import { changeLanguage, t } from "../../i18n"
 import { ApiConfiguration } from "../../shared/api"
 import { supportPrompt } from "../../shared/support-prompt"
 
-import { checkoutDiffPayloadSchema, checkoutRestorePayloadSchema, WebviewMessage } from "../../shared/WebviewMessage"
+import { checkoutDiffPayloadSchema, checkoutRestorePayloadSchema, FileInteraction, WebviewMessage } from "../../shared/WebviewMessage"
 import { checkExistKey } from "../../shared/checkExistApiConfig"
 import { experimentDefault } from "../../shared/experiments"
 import { Terminal } from "../../integrations/terminal/Terminal"
@@ -38,6 +38,7 @@ import { buildApiHandler } from "../../api"
 import { GlobalState } from "../../schemas"
 import { MultiSearchReplaceDiffStrategy } from "../diff/strategies/multi-search-replace"
 import { getModels } from "../../api/providers/fetchers/cache"
+import { getTaskDirectoryPath } from "../../shared/storagePathManager"
 
 export const webviewMessageHandler = async (provider: ClineProvider, message: WebviewMessage) => {
 	// Utility functions provided for concise get/update of global state via contextProxy API.
@@ -1257,6 +1258,131 @@ export const webviewMessageHandler = async (provider: ClineProvider, message: We
 			await provider.postStateToWebview()
 			break
 		}
+        
+        // File interaction handling
+        case "requestFileInteractions": {
+            if (message.taskId) {
+                try {
+                    // Get the task directory path
+                    const globalStoragePath = provider.contextProxy.globalStorageUri.fsPath
+                    const taskDirPath = await getTaskDirectoryPath(globalStoragePath, message.taskId)
+                    const filePath = path.join(taskDirPath, 'fileInteractions.json')
+                    
+                    // Check if the file exists
+                    const exists = await fileExistsAtPath(filePath)
+                    
+                    if (exists) {
+                        // Read the file
+                        const fileContent = await fs.readFile(filePath, 'utf8')
+                        const interactions = JSON.parse(fileContent) as FileInteraction[]
+                        
+                        // Send the interactions to the webview
+                        await provider.postMessageToWebview({
+                            type: "fileInteractions",
+                            interactions,
+                            taskId: message.taskId
+                        })
+                    } else {
+                        // If file doesn't exist, send current file interactions from the Cline instance
+                        const currentCline = provider.getCurrentCline()
+                        if (currentCline && currentCline.taskId === message.taskId) {
+                            // Extract file interactions from messages
+                            const interactions: FileInteraction[] = []
+                            
+                            currentCline.clineMessages.forEach(message => {
+                                if (message.type === 'ask' && message.ask === 'tool' && message.text) {
+                                    try {
+                                        const payload = JSON.parse(message.text)
+                                        if (payload.fileInteraction) {
+                                            interactions.push({
+                                                ...payload.fileInteraction,
+                                                timestamp: message.ts,
+                                                taskId: currentCline.taskId
+                                            })
+                                        }
+                                    } catch (e) {
+                                        console.error("Failed to parse tool message payload:", e)
+                                    }
+                                }
+                            })
+                            
+                            // Save file interactions for future reference
+                            try {
+                                await fs.mkdir(taskDirPath, { recursive: true })
+                                await fs.writeFile(filePath, JSON.stringify(interactions, null, 2))
+                            } catch (e) {
+                                console.error("Failed to save file interactions:", e)
+                            }
+                            
+                            // Send interactions to webview
+                            await provider.postMessageToWebview({
+                                type: "fileInteractions",
+                                interactions,
+                                taskId: message.taskId
+                            })
+                        } else {
+                            // No file interactions found
+                            await provider.postMessageToWebview({
+                                type: "fileInteractions",
+                                interactions: [],
+                                taskId: message.taskId
+                            })
+                        }
+                    }
+                } catch (error) {
+                    console.error("Error processing file interactions:", error)
+                    await provider.postMessageToWebview({
+                        type: "fileInteractions",
+                        interactions: [],
+                        taskId: message.taskId
+                    })
+                }
+            }
+            break
+        }
+        
+        case "toggleStatsView": {
+            // This is handled directly in the ChatView component
+            // Just logging for now
+            console.log("Toggle stats view requested")
+            break
+        }
+        
+        case "updateFileInteractionHistory": {
+            if (message.taskId && message.interactions) {
+                try {
+                    // Get the task directory path
+                    const globalStoragePath = provider.contextProxy.globalStorageUri.fsPath
+                    const taskDirPath = await getTaskDirectoryPath(globalStoragePath, message.taskId)
+                    const filePath = path.join(taskDirPath, 'fileInteractions.json')
+                    
+                    // Ensure directory exists
+                    await fs.mkdir(taskDirPath, { recursive: true })
+                    
+                    // Save the interactions
+                    await fs.writeFile(filePath, JSON.stringify(message.interactions, null, 2))
+                    
+                    // Update state if needed
+                    const currentState = getGlobalState("fileInteractionHistory") as Record<string, FileInteraction[]> || {}
+                    const updatedHistory = {
+                        ...currentState,
+                        [message.taskId]: message.interactions
+                    }
+                    await updateGlobalState("fileInteractionHistory", updatedHistory)
+                    
+                    // Send back to webview if requested
+                    if (message.requestUpdate) {
+                        await provider.postMessageToWebview({
+                            type: "fileInteractionHistory",
+                            history: updatedHistory
+                        })
+                    }
+                } catch (error) {
+                    console.error("Error saving file interaction history:", error)
+                }
+            }
+            break
+        }
 	}
 }
 

src/shared/WebviewMessage.ts

@@ -9,6 +9,17 @@ export type PromptMode = Mode | "enhance"
 
 export type AudioType = "notification" | "celebration" | "progress_loop"
 
+export interface FileInteraction {
+  path: string;
+  operation: 'read' | 'write' | 'edit' | 'create' | 'delete' | 'insert' | 'search_replace' | 'list' | 'search';
+  timestamp: number;
+  success?: boolean;
+  isOutsideWorkspace?: boolean;
+  taskId?: string;
+  content?: string; // Optional for content logging
+  diff?: string;    // Optional for diff logging
+}
+
 export interface WebviewMessage {
 	type:
 		| "apiConfiguration"
@@ -127,6 +138,11 @@ export interface WebviewMessage {
 		| "searchFiles"
 		| "toggleApiConfigPin"
 		| "setHistoryPreviewCollapsed"
+        | "fileInteractions"
+        | "fileInteractionHistory"
+        | "updateFileInteractionHistory"
+        | "requestFileInteractions"
+        | "toggleStatsView"
 	text?: string
 	disabled?: boolean
 	askResponse?: ClineAskResponse
@@ -155,6 +171,10 @@ export interface WebviewMessage {
 	hasSystemPromptOverride?: boolean
 	terminalOperation?: "continue" | "abort"
 	historyPreviewCollapsed?: boolean
+    fileInteraction?: FileInteraction
+    interactions?: FileInteraction[]
+    taskId?: string
+    history?: Record<string, FileInteraction[]>
 }
 
 export const checkoutDiffPayloadSchema = z.object({