feat(tools): add interactive tool and call explorer

[hamidi-dev]

Explore tool usage in the TUI and live web report.

• Drill into tools and MCP servers for cost, token, and model breakdowns.
• Browse individual calls and jump to their owning turns.
• Fix TUI scrolling and web tabs stuck loading.
• Preserve privacy boundaries and clearly label attributed usage.

Tested: 1,884 tests passed, lint/format checks passed, and desktop/mobile browser verification completed.

Summary by CodeRabbit

• New Features

  • Added a drillable Tools explorer to session views in the terminal and web interfaces.
  • View tool and namespace rankings, contribution totals, token composition, model attribution, and chronological calls.
  • Navigate from individual calls to their owning turns and prompts, with keyboard and mouse controls.
  • Tool treemap items are now clickable, with navigation history and preserved focus when changing cost modes.
  • Added tool-call data to session details and supported CSV exports.

• Documentation

  • Documented Tools explorer controls, navigation, data coverage, and limitations.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 1d331ff4-cf89-4e3c-86bf-7d7d6319deb9

📥 Commits

Reviewing files that changed from the base of the PR and between 25b73c1 and 4a119a1.

📒 Files selected for processing (13)

• docs/architecture.md
• docs/keys.md
• docs/tui.md
• docs/web.md
• src/opentab/tools.py
• src/opentab/tui/app.py
• src/opentab/tui/keymap.py
• src/opentab/tui/renderer.py
• src/opentab/web.py
• src/opentab/webpage.py
• tests/test_tools.py
• tests/test_tui_detail.py
• tests/test_web.py

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

Changes

Tools explorer

Layer / File(s)	Summary
Tool-call projection and session payload src/opentab/tools.py, src/opentab/web.py, tests/test_tools.py, tests/test_web.py	Adds ordered per-call projections with proportional usage fields. Web session extras now include allowlisted tool rows and call records.
TUI projections, rendering, and navigation src/opentab/tui/app.py, src/opentab/tui/renderer.py, src/opentab/tui/keymap.py, tests/test_tui_detail.py, docs/architecture.md, docs/keys.md, docs/tui.md	Adds cached tool rankings, drill-down views, call ledgers, pricing updates, cursor handling, and navigation to owning turns.
Web explorer and history navigation src/opentab/webpage.py, tests/test_web.py, docs/web.md	Adds clickable tool rankings, per-tool details, call navigation, history restoration, stale-request handling, and responsive styling.

Priority: ➖ Normal

Estimated code review effort: 4 (Complex) | ~60 minutes

Change: Feature

Merge Risk: ⚪ Minimal · up to 4a119

No merge-blocking behavior or operational risk is currently established.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 2.02% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 99 functions across 9 files. (4 skipped: 4…	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the main change: adding an interactive tool and call explorer to the TUI and live web report.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 2.02% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 99 functions across 9 files. (4 skipped: 4 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/tools-explorer

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}