feat(provider): add file_read item type to distinguish read operations f

- Classify read operations (read, glob, grep, search, list, find, view, ls, cat) as file_read type
- Add titleForReadTool() for contextual titles based on tool name
- Update exploration card and timeline to recognize file_read type
- File operations now correctly distinguished in UI by operation type

Author: tyulyukov

apps/server/src/provider/Layers/ClaudeAdapter.test.ts

@@ -919,7 +919,7 @@ describe("ClaudeAdapterLive", () => {
       const toolStarted = runtimeEvents.find((event) => event.type === "item.started");
       assert.equal(toolStarted?.type, "item.started");
       if (toolStarted?.type === "item.started") {
-        assert.equal(toolStarted.payload.itemType, "dynamic_tool_call");
+        assert.equal(toolStarted.payload.itemType, "file_read");
       }
 
       const toolInputUpdated = runtimeEvents.find(

apps/server/src/provider/Layers/ClaudeAdapter.ts

@@ -418,14 +418,30 @@ function classifyToolItemType(toolName: string): CanonicalItemType {
   if (
     normalized.includes("edit") ||
     normalized.includes("write") ||
-    normalized.includes("file") ||
     normalized.includes("patch") ||
     normalized.includes("replace") ||
     normalized.includes("create") ||
-    normalized.includes("delete")
+    normalized.includes("delete") ||
+    normalized.includes("notebookedit")
   ) {
     return "file_change";
   }
+  if (
+    normalized === "read" ||
+    normalized.includes("glob") ||
+    normalized.includes("grep") ||
+    normalized.includes("search") ||
+    normalized.includes("list") ||
+    normalized.includes("find") ||
+    normalized.includes("view") ||
+    normalized.includes("ls") ||
+    normalized.includes("cat")
+  ) {
+    return "file_read";
+  }
+  if (normalized.includes("file")) {
+    return "file_change";
+  }
   if (normalized.includes("mcp")) {
     return "mcp_tool_call";
   }
@@ -476,12 +492,14 @@ function summarizeToolRequest(toolName: string, input: Record<string, unknown>):
   return `${toolName}: ${serialized.slice(0, 397)}...`;
 }
 
-function titleForTool(itemType: CanonicalItemType): string {
+function titleForTool(itemType: CanonicalItemType, toolName?: string): string {
   switch (itemType) {
     case "command_execution":
       return "Command run";
     case "file_change":
       return "File change";
+    case "file_read":
+      return titleForReadTool(toolName);
     case "mcp_tool_call":
       return "MCP tool call";
     case "collab_agent_tool_call":
@@ -497,6 +515,19 @@ function titleForTool(itemType: CanonicalItemType): string {
   }
 }
 
+function titleForReadTool(toolName?: string): string {
+  if (!toolName) return "Read";
+  const normalized = toolName.toLowerCase();
+  if (normalized === "read") return "Read file";
+  if (normalized.includes("glob")) return "Glob search";
+  if (normalized.includes("grep")) return "Grep search";
+  if (normalized.includes("search")) return "Search";
+  if (normalized.includes("list") || normalized.includes("ls")) return "List files";
+  if (normalized.includes("find")) return "Find files";
+  if (normalized.includes("view")) return "View file";
+  return "Read";
+}
+
 const SUPPORTED_CLAUDE_IMAGE_MIME_TYPES = new Set([
   "image/gif",
   "image/jpeg",
@@ -1652,7 +1683,7 @@ const makeClaudeAdapter = Effect.fn("makeClaudeAdapter")(function* (
         itemId,
         itemType,
         toolName,
-        title: titleForTool(itemType),
+        title: titleForTool(itemType, toolName),
         detail,
         input: toolInput,
         partialInputJson: "",

apps/web/src/components/chat/ExplorationCard.tsx

@@ -11,7 +11,11 @@ interface ExplorationCardProps {
 const READ_LABEL_RE = /^Read\b/i;
 
 function isReadEntry(entry: WorkLogEntry): boolean {
-  return entry.requestKind === "file-read" || READ_LABEL_RE.test(entry.toolTitle ?? entry.label);
+  return (
+    entry.requestKind === "file-read" ||
+    entry.itemType === "file_read" ||
+    READ_LABEL_RE.test(entry.toolTitle ?? entry.label)
+  );
 }
 
 function explorationEntryHeading(entry: WorkLogEntry): string {

apps/web/src/components/chat/MessagesTimeline.tsx

@@ -1020,6 +1020,7 @@ function isExplorationEntry(entry: TimelineWorkEntry): boolean {
   if (entry.agentGroup) return false;
 
   if (entry.requestKind === "file-read") return true;
+  if (entry.itemType === "file_read") return true;
   if (entry.itemType === "image_view") return true;
 
   const heading = (entry.toolTitle ?? entry.label).trim();
@@ -1057,6 +1058,7 @@ function workEntryIcon(workEntry: TimelineWorkEntry): LucideIcon {
   if (workEntry.itemType === "file_change" || (workEntry.changedFiles?.length ?? 0) > 0) {
     return SquarePenIcon;
   }
+  if (workEntry.itemType === "file_read") return EyeIcon;
   if (workEntry.itemType === "web_search") return GlobeIcon;
   if (workEntry.itemType === "image_view") return EyeIcon;
 

packages/contracts/src/providerRuntime.ts

@@ -100,6 +100,7 @@ export type RuntimeErrorClass = typeof RuntimeErrorClass.Type;
 export const TOOL_LIFECYCLE_ITEM_TYPES = [
   "command_execution",
   "file_change",
+  "file_read",
   "mcp_tool_call",
   "dynamic_tool_call",
   "collab_agent_tool_call",