fix: auto-resolve relative media paths before sending (ROOT CAUSE)

The LLM often uses bare filenames in MEDIA: tags like 'report.md' instead of
absolute paths like '/tmp/report.md'. The gateway's extract_media() captures
the bare name, but send_document() fails with 'File not found' because it
can't resolve relative paths.

New patch_resolve_media_paths.py:
- After extract_media(), scans each media path
- If relative, searches /tmp/, /data/hermes/uploads/, cwd, HERMES_HOME
- Replaces with resolved absolute path if found
- Logs resolution for debugging

This fixes the actual root cause visible in gateway logs:
WARNING: Failed to send media (.md): File not found: 广东天气预报.md

Dockerfile

@@ -18,7 +18,6 @@ RUN pip install --quiet --upgrade pip && \
     pip install --quiet -e "/app/hermes-agent[feishu,mcp,cron,pty]" 2>&1 | tail -10
 
 # Patch: add document file extensions to auto-detection for native delivery
-# This enables Hermes to send .md, .pdf, .docx, .xlsx etc. as native attachments
 COPY scripts/patch_file_delivery.py /tmp/patch_file_delivery.py
 RUN python3 /tmp/patch_file_delivery.py; rm -f /tmp/patch_file_delivery.py
 
@@ -27,11 +26,15 @@ COPY patches/hermes-agent/agent/prompt_builder.py /app/hermes-agent/agent/prompt
 COPY patches/hermes-agent/tools/send_message_tool.py /app/hermes-agent/tools/send_message_tool.py
 
 # Patch: Auto-inject MEDIA: tags from write_file tool calls
-# Ensures files created by write_file are delivered as native attachments
-# even when the LLM forgets to include MEDIA: tags in its response
 COPY scripts/patch_auto_media.py /tmp/patch_auto_media.py
 RUN python3 /tmp/patch_auto_media.py; rm -f /tmp/patch_auto_media.py
 
+# Patch: Auto-resolve relative media paths to absolute paths
+# ROOT CAUSE FIX: LLM often uses bare filenames in MEDIA: tags (e.g. "report.md")
+# which causes send_document() to fail with "File not found"
+COPY scripts/patch_resolve_media_paths.py /tmp/patch_resolve_media_paths.py
+RUN python3 /tmp/patch_resolve_media_paths.py; rm -f /tmp/patch_resolve_media_paths.py
+
 # Install Node.js 23
 RUN ARCH=$(dpkg --print-architecture) \
     && if [ "$ARCH" = "amd64" ]; then NODE_ARCH="x64"; else NODE_ARCH="$ARCH"; fi \

scripts/patch_resolve_media_paths.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""Patch hermes-agent gateway to auto-resolve relative media paths.
+
+ROOT CAUSE: When the LLM uses write_file, it often saves files with relative
+paths like "广东天气预报.md" or "/tmp/广东天气预报.md", then puts
+"MEDIA:广东天气预报.md" in the response.  The gateway's extract_media()
+parses this bare filename, but the subsequent send_document() call fails
+because the path is relative and os.path.isfile() returns False.
+
+FIX: After extract_media() returns the media_files list, scan each path:
+  1. If already absolute and exists → keep as-is
+  2. If relative → search well-known directories (/tmp/, /data/hermes/uploads/,
+     current working directory, HERMES_HOME) for a file with that name
+  3. Replace the path with the resolved absolute path
+  4. If still not found → keep the original (will fail with clear error)
+
+This is a surgical patch to the _deliver_response() method in base.py,
+inserted right after the "media_files, response = self.extract_media(response)"
+line.
+"""
+
+import re
+import sys
+import os
+import glob
+
+
+def patch_file(filepath: str):
+    with open(filepath, 'r') as f:
+        content = f.read()
+
+    # Find the insertion point: right after extract_media() call
+    old = """\
+                # Extract MEDIA:<path> tags (from TTS tool) before other processing
+                media_files, response = self.extract_media(response)"""
+
+    new = """\
+                # Extract MEDIA:<path> tags (from TTS tool) before other processing
+                media_files, response = self.extract_media(response)
+
+                # Auto-resolve relative media paths to absolute paths.
+                # The LLM often uses bare filenames in MEDIA: tags (e.g. "report.md")
+                # which fail because send_document() can't find them.
+                _media_search_dirs = ['/tmp', '/data/hermes/uploads', os.getcwd()]
+                _hermes_home = os.path.expanduser('~/.hermes')
+                if _hermes_home not in _media_search_dirs:
+                    _media_search_dirs.append(_hermes_home)
+                _resolved_media = []
+                for _mpath, _mvoice in media_files:
+                    if os.path.isabs(_mpath) and os.path.isfile(_mpath):
+                        _resolved_media.append((_mpath, _mvoice))
+                        continue
+                    # Try to find the file in well-known directories
+                    _basename = os.path.basename(_mpath)
+                    _found = None
+                    for _search_dir in _media_search_dirs:
+                        _candidate = os.path.join(_search_dir, _basename)
+                        if os.path.isfile(_candidate):
+                            _found = _candidate
+                            break
+                    if _found:
+                        logger.info("[%s] Resolved relative media path '%s' -> '%s'", self.name, _mpath, _found)
+                        _resolved_media.append((_found, _mvoice))
+                    else:
+                        # Keep original — will fail with a clear error message
+                        _resolved_media.append((_mpath, _mvoice))
+                        logger.warning("[%s] Could not resolve media path '%s' — searched %s", self.name, _mpath, _media_search_dirs)
+                media_files = _resolved_media"""
+
+    if old not in content:
+        print(f"WARNING: Could not find insertion point in {filepath}", file=sys.stderr)
+        print("The upstream code may have changed. Skipping this patch.", file=sys.stderr)
+        sys.exit(0)
+
+    content = content.replace(old, new, 1)
+
+    with open(filepath, 'w') as f:
+        f.write(content)
+
+    print(f"Patched {filepath}: auto-resolve relative media paths before sending")
+
+
+if __name__ == "__main__":
+    candidates = [
+        "/app/hermes-agent/gateway/platforms/base.py",
+    ]
+    candidates.extend(glob.glob("/app/venv/lib/**/gateway/platforms/base.py", recursive=True))
+
+    filepath = None
+    for c in candidates:
+        if os.path.isfile(c):
+            filepath = c
+            break
+
+    if not filepath:
+        print("WARNING: base.py not found in any candidate location", file=sys.stderr)
+        print(f"Checked: {candidates}", file=sys.stderr)
+        print("Skipping patch_resolve_media_paths.", file=sys.stderr)
+        sys.exit(0)
+
+    patch_file(filepath)