NousResearch/hermes-agent · error · Error

Could not attach ${label}

Error message

Could not attach ${label}

What it means

Error "Could not attach ${label}" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/app/session/hooks/use-prompt-actions/index.ts:170

      throw new Error(`Could not read ${label}`)
    }
  }

  const stageForSession = async (liveSessionId: string): Promise<ComposerAttachment> => {
    if (attachment.kind === 'image') {
      const result = imagePayload
        ? await requestGateway<ImageAttachResponse>('image.attach_bytes', {
            session_id: liveSessionId,
            content_base64: imagePayload.contentBase64,
            filename: imagePayload.filename
          })
        : await requestGateway<ImageAttachResponse>('image.attach', {
            path,
            session_id: liveSessionId
          })

      if (!result.attached) {
        throw new Error(result.message || `Could not attach ${label}`)
      }

      const attachedPath = result.path || path

      return {
        ...attachment,
        attachedSessionId: liveSessionId,
        label: attachedPath ? pathLabel(attachedPath) : attachment.label,
        path: attachedPath,
        uploadState: undefined
      }
    }

    const result = await requestGateway<FileAttachResponse>('file.attach', {
      name: label,
      path,
      session_id: liveSessionId,
      ...(fileDataUrl ? { data_url: fileDataUrl } : {})

View on GitHub (pinned to c896c09c42)

Solutions

1. Retry the attachment; the upload to the gateway failed.
2. Use a smaller file or a supported file type.
3. Confirm the gateway is connected and the upload endpoint is reachable.

When it happens

Trigger: Thrown at apps/desktop/src/app/session/hooks/use-prompt-actions/index.ts:170 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/ca8c47d18dd17e9b. Report an issue: GitHub.