Summary

After PR #7451 fixed parameter validation, verbose tool summaries no longer show filenames when tools are called with the parameter (Claude Code convention) instead of .

Reproduction

1. Enable verbose mode:
2. Trigger a tool call that uses (e.g., Claude Sonnet models often use this)
3. Observe verbose output shows only emoji + label, no filename

Expected: 📖 Read: src/agents/tool-display.ts
Actual: 📖 Read

Root Cause

src/agents/tool-display.ts functions resolveReadDetail() and resolveWriteDetail() only check for record.path and don't handle record.file_path:

function resolveReadDetail(args: unknown): string | undefined {
  if (!args || typeof args !== "object") {
    return undefined;
  }
  const record = args as Record<string, unknown>;
  const path = typeof record.path === "string" ? record.path : undefined;  // ❌ Missing file_path check
  if (!path) {
    return undefined;
  }
  // ...
}

Timeline

• Jan 14, 2026: file_path support added in pi-tools.read.ts for Claude Code compatibility
• Jan 14 - Feb 3: file_path validation was broken, so models used path → verbose worked
• Feb 3, 2026: PR fix(tools): ensure file_path alias passes validation in read/write tools #7451 fixed validation → models started using file_path → verbose broke

Proposed Fix

Update resolveReadDetail() and resolveWriteDetail() to check both parameter names:

const path =
  typeof record.path === "string"
    ? record.path
    : typeof record.file_path === "string"
      ? record.file_path
      : undefined;

This matches the parameter normalization logic already present in pi-tools.read.ts.

Impact

• Affects all verbose tool summaries when Claude Code-style parameters are used
• Reduces debugging visibility for read/write/edit operations