NousResearch/hermes-agent · error

Gateway returned no file data

Error message

Gateway returned no file data

What it means

Error "Gateway returned no file data" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/lib/media.ts:174

  return $connection.get()?.mode === 'remote'
}

// Fetch gateway-local media as a data URL via the authenticated desktop FS
// bridge. Remote Desktop artifacts can live anywhere the gateway can read
// (workspace, skills, ~/.hermes/cache, etc.); /api/media is intentionally
// narrower and rejects non-images plus images outside its media roots.
export async function gatewayMediaDataUrl(path: string): Promise<string> {
  return readDesktopFileDataUrl(filePathFromMediaPath(path))
}

// Remote-mode replacement for opening gateway-local file paths with file://.
// The file lives on the gateway, so fetch it over the authenticated fs bridge
// and hand the bytes to the local browser shell as a download.
export async function downloadGatewayMediaFile(path: string): Promise<void> {
  const dataUrl = await readDesktopFileDataUrl(filePathFromMediaPath(path))

  if (!dataUrl) {
    throw new Error('Gateway returned no file data')
  }

  const response = await fetch(dataUrl)
  const blobUrl = URL.createObjectURL(await response.blob())
  const anchor = document.createElement('a')
  anchor.href = blobUrl
  anchor.download = mediaName(path)
  anchor.rel = 'noopener noreferrer'
  document.body.appendChild(anchor)
  anchor.click()
  anchor.remove()
  window.setTimeout(() => URL.revokeObjectURL(blobUrl), 30_000)
}

export function mediaDisplayLabel(path: string): string {
  const escaped = mediaName(path).replace(/[[\]\\]/g, '\\$&')
  const kind = mediaKind(path)

View on GitHub (pinned to c896c09c42)

Solutions

1. Retry the download; the gateway returned an empty payload.
2. Verify the file still exists on the backend and the path is valid.
3. Check gateway connectivity and backend logs for the file read.

When it happens

Trigger: Thrown at apps/desktop/src/lib/media.ts:174 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/490279573b1a0886. Report an issue: GitHub.