feat(photon): wire outbound media via spectrum-ts attachment()

[teknium1]

Summary

The Photon iMessage plugin can now send outbound media — images, voice notes, video, and documents — closing the one capability gap from #32348. Photon shipped attachment send (Ray Sun, photon-nousresearch), so this wires space.send(attachment(...)) / space.send(voice(...)) through the sidecar and brings Photon to full BlueBubbles parity.

Changes

• sidecar (index.mjs): new /send-attachment endpoint wrapping space.send(attachment(path, {...})) / space.send(voice(path, {...})). spectrum-ts infers name + MIME from the extension; overrides are passed only when supplied. Caption is delivered as a trailing text bubble (iMessage renders it separately).
• adapter (adapter.py): override send_image / send_image_file / send_voice / send_video / send_document / send_animation. URL helpers cache to a local path first (cache_image_from_url), file helpers pass the path through — same model as BlueBubbles. Defense-in-depth: re-validate the path (validate_media_delivery_path) before it reaches the Node sidecar.
• cron (_standalone_send): send the text body first, then each media_file as a /send-attachment call (is_voice → voice builder).
• docs/README: flip the "outbound attachments not wired yet" note.

Validation

	Result
tests/plugins/platforms/photon/	42/42 pass (34 existing + 8 new)
E2E: real Node sidecar + fake spectrum-ts, driven through the real adapter over loopback HTTP	✓

E2E recorded the exact builder calls reaching the SDK:

• send_image_file → attachment("…/cat.jpg", {mimeType:"image/jpeg"}) + text("hi cat")
• send_voice → voice("…/note.m4a", {mimeType:"audio/mp4"})
• send_document → attachment("…/doc.pdf", {name:"Q3.pdf", mimeType:"application/pdf"})
• send (text) → text("plain text") — no regression

Inbound attachments remain metadata-only (separate Photon API limitation, unchanged).

Infographic

[github-actions]

🔎 Lint report: hermes/hermes-d35aa786 vs origin/main

ruff

Total: 0 on HEAD, 0 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 0 pre-existing issues carried over.

ty (type checker)

Total: 10527 on HEAD, 10525 on base (🆕 +2)

🆕 New issues (2):

Rule	Count
invalid-assignment	1
unresolved-import	1

First entries

tests/plugins/platforms/photon/test_outbound_media.py:37: [invalid-assignment] invalid-assignment: Object of type `def _fake_call(path: str, body: dict[str, Any]) -> CoroutineType[Any, Any, dict[str, Any]]` is not assignable to attribute `_sidecar_call` of type `def _sidecar_call(self, path: str, body: dict[str, Any]) -> CoroutineType[Any, Any, dict[str, Any]]`
tests/plugins/platforms/photon/test_outbound_media.py:14: [unresolved-import] unresolved-import: Cannot resolve imported module `pytest`

✅ Fixed issues: none

Unchanged: 5529 pre-existing issues carried over.

Diagnostics are surfaced as warnings — this check never fails the build.