PR #81415: fix(agents): attach read tool images to replies

• Repository: openclaw/openclaw
• Author: aqilaziz
• State: open | merged: False
• Link: https://github.com/openclaw/openclaw/pull/81415

Description (problem / solution / changelog)

Summary

• Persist trusted read tool image content into the inbound media store when the tool result has image blocks but no MEDIA: path or details.path.
• Queue the saved media://inbound/... reference for the next assistant reply so shared outbound delivery, including WhatsApp, receives media URLs instead of text-only replies.
• Add regression coverage for the read-tool image bridge.

Fixes #81322

Real behavior proof

• Behavior or issue addressed: A read tool image result is saved as inbound media and queued for outbound replies instead of being dropped as text-only output.
• Real environment tested: Local OpenClaw checkout on Windows, Node v24.15.0, with OPENCLAW_STATE_DIR pointed at a temporary state directory and the real handler/media-store modules loaded.
• Exact steps or command run after this patch: Ran pnpm exec tsx - with a script that imports handleToolExecutionEnd, feeds a read tool result containing a PNG image content block, then reads the saved inbound media back from the media store.
• Evidence after fix: Terminal output from the after-fix run:

{
  "pendingToolMediaUrls": [
    "media://inbound/836ee240-d174-41fc-9be0-28dc88ef4839.png"
  ],
  "pendingToolTrustedLocalMedia": true,
  "savedSize": 68,
  "savedFileExists": true
}

• Observed result after fix: The real handler persisted the image bytes, queued a media://inbound/...png URL, marked the media as trusted local media, and the saved file existed on disk.
• What was not tested: Live WhatsApp device delivery; the verified behavior is the OpenClaw bridge that supplies media URLs to outbound delivery.

Verification

• pnpm test src/agents/pi-embedded-subscribe.tools.media.test.ts src/agents/pi-embedded-subscribe.handlers.tools.media.test.ts src/agents/pi-embedded-subscribe.handlers.messages.test.ts extensions/whatsapp/src/outbound-payload.contract.test.ts extensions/whatsapp/src/outbound-adapter.sendpayload.test.ts extensions/whatsapp/src/auto-reply/deliver-reply.test.ts
• pnpm check:test-types
• pnpm check:changed

Changed files

• src/agents/pi-embedded-subscribe.handlers.tools.media.test.ts (modified, +43/-0)
• src/agents/pi-embedded-subscribe.handlers.tools.ts (modified, +12/-1)
• src/agents/pi-embedded-subscribe.tools.ts (modified, +66/-0)