feat(matrix-bridge): per-tool lifecycle status icons + Tools (M/N) header

[replicas-connector]

Summary

Mirrors the OpenACP UX Jaden screenshotted in the Slack thread — each tool line ticks live, the header shows a running M/N counter. References the research doc Detailed Deep-Dive §2 (ToolCard internals) and §5 (renderToolCard layout).

Before / After

Before:

🔧 Running · step 4 · 14s

🔧 ls -la src/
🔧 grep -r "foo" src/
↳ index.ts main.ts util.ts
🔧 git status
↳ On branch main

After:

🔧 Running · step 4 · 14s

📋 Tools (2/3)

✅ 🔧 ls -la src/
✅ 🔧 grep -r "foo" src/
↳ index.ts main.ts util.ts
🔄 🔧 git status

…then when git status finishes:

📋 Tools (3/3) ✅

✅ 🔧 ls -la src/
✅ 🔧 grep -r "foo" src/
↳ index.ts main.ts util.ts
✅ 🔧 git status
↳ On branch main

Implementation

Pairing tool_use → tool_result

ContentBlock gains id (the Anthropic-assigned toolu_…) and tool_use_id (the back-pointer Anthropic carries on tool_result blocks). The poller keeps a toolLineIndex: Record<string, number> in DO storage mapping tool_use.id → row index in lines. Persisted in the writes batch; wiped on /watch fresh-spawn so a new turn doesn't inherit stale mappings.

Status prefix mutation

• On tool_use projection: push line as 🔄 ${formatToolUseLine} and record the row index under block.id.
• On tool_result projection: look up the row by block.tool_use_id, mutate the leading 🔄 → ✅ (success) or ❌ (error). Then delete toolLineIndex[block.tool_use_id] — one-shot, so a malformed duplicate result can't keep flipping the row.

Tools (M/N) header

render.ts gains renderToolsHeader(lines: string[]): string. Stateless — scans for 🔄/✅/❌ prefixes, counts done and total. Returns 📋 Tools (M/N) with a trailing ✅ when M === N && N > 0 (matches OpenACP's allComplete header). Wired into both renderActive and renderTerminal above the rolling log.

Test plan

• bun run typecheck clean
• bun test src/render.test.ts — 48/48 pass (5 new for renderToolsHeader: empty input, mixed done/running, all-complete suffix, ignoring non-tool lines)
• Deployed to matrix bridge worker bee12be7
• Live test: send a multi-tool prompt; expect each tool line to start as 🔄 …, tick to ✅ … (or ❌ …) as it finishes, and the header counter to climb in real time
• Live test: trigger an error in one tool (e.g., ls /nonexistent); expect that row's prefix to become ❌

Not in this PR (deferred)

• Telegram bridge gets the same treatment in a follow-up. It still has the focus-window code from commit 8728c39 per docs/agent-handoff.md; that needs to be reverted first so the new prefixes and header slot in cleanly.

---

_{Created by Jaden (jadengarza@pm.me) with Replicas
Workspace  ·  Slack Thread}

---

[capy-ai]

Capy auto-review is paused for this organization because the monthly auto-review limit has been reached. Increase the limit or turn it off in billing settings to resume automatic reviews.

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 4 additional findings.

[replicas-connector]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 4 additional findings.

@devin-ai-integration[bot] This repository is not connected to a Replicas organization.

To enable Replicas on this repository:

1. Go to GitHub integration settings
2. Add this repository to your organization

Note: Each repository can only be connected to one Replicas organization.