fix: preserve image attachment file paths

[0xWerz]

Issue for this PR

Closes #23801
Closes #17488

Type of change

• Bug fix

What does this PR do?

When you paste or drag an image into the prompt, the agent only gets raw pixel data. It doesn't know where the original file is, so asking it to copy or reference the image fails. The agent's thinking shows "I don't have a direct file path" and it tries to decode base64 instead.

This preserves the file path through the attachment flow and exposes it to the model as text, so the agent can actually use it.

How did you verify your code works?

• Ran bun typecheck in packages/opencode and packages/app — both pass
• Ran bun test for the affected app test files — all pass
• Ran bun run dev locally, pasted an image, and confirmed the agent now sees the path

Screenshots / recordings

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

Based on my search, I found the following potentially related PRs that address similar image/file path handling issues:

1. PR feat(tui): improve drag-drop image path handling for tool access #17489 - "feat(tui): improve drag-drop image path handling for tool access"

   • Related because it addresses drag-drop image path handling, which is directly related to the current PR's focus on preserving image attachment file paths

2. PR fix(opencode): handle shell-escaped parentheses in drag-drop file paths #17082 - "fix(opencode): handle shell-escaped parentheses in drag-drop file paths"

   • Related because it handles file paths in drag-drop scenarios, addressing a similar use case of making file paths available to tools/agents

3. PR feat(tui): improve clipboard paste and drag-and-drop file handling on Linux #14552 - "feat(tui): improve clipboard paste and drag-and-drop file handling on Linux"

   • Related because it addresses clipboard paste and drag-and-drop file handling, which overlaps with the current PR's concern about pasted/dragged images

These PRs appear to be addressing the same general problem space of making file paths available when users paste or drag images. The current PR (23802) may build on or supersede these earlier attempts.

[github-actions]

Thanks for updating your PR! It now meets our contributing guidelines. 👍

[github-actions]

Automated PR Cleanup

Thank you for contributing to opencode.

Due to the high volume of PRs from users and AI agents, we periodically close older PRs using automated criteria so maintainers can focus review time on the most active and community-supported contributions.

This PR was closed because it matched the following cleanup criteria:

• The PR was created more than 1 month ago
• The PR had fewer than 2 positive reactions
• Positive reactions are counted as thumbs-up, heart, celebration, or rocket reactions on the PR

PRs created within the last month are not affected by this cleanup.

If you believe this PR was closed incorrectly, or if you are still actively working on it, please leave a comment explaining why it should be reopened. A maintainer can review and reopen it if appropriate.

Thanks again for taking the time to contribute.