Method handleGetAttachment

internal/httpapi/attachments.go:172–208

(ctx context.Context, in *attachmentParam)

}

func (s *Server) handleGetAttachment(ctx context.Context, in *attachmentParam) (*attachmentOutput, error) {
	ag, err := s.resolveOwnedAgent(ctx, in.Address)
	if err != nil {
		return nil, err
	}
	if s.deps.GetMessage == nil || s.deps.AttachmentStore == nil {
		return nil, NewError(http.StatusInternalServerError, "internal_error", "attachment retrieval unavailable")
	}
	msg, err := s.deps.GetMessage(ctx, in.MessageID, ag.ID)
	if err != nil || msg == nil {
		return nil, NewError(http.StatusNotFound, "not_found", "message not found")
	}
	att, ok := mailparse.AttachmentAt(msg.RawMessage, in.Index)
	if !ok {
		return nil, NewError(http.StatusNotFound, "attachment_not_found", "no attachment at that index")
	}
	dl, exp, err := s.deps.AttachmentStore.DownloadURL(in.Address, in.MessageID, in.Index, attachmentDownloadTTL)
	if err != nil {
		return nil, NewError(http.StatusInternalServerError, "internal_error", "failed to mint download url")
	}
	view := AttachmentView{
		Index:       in.Index,
		Filename:    att.Filename,
		ContentType: att.ContentType,
		SizeBytes:   len(att.Data),
		DownloadURL: dl,
		ExpiresAt:   exp.UTC().Format(time.RFC3339),
	}
	if in.Inline {
		if len(att.Data) > attachmentInlineMaxBytes {
			return nil, NewError(http.StatusRequestEntityTooLarge, "attachment_too_large",
				fmt.Sprintf("attachment is %d bytes; inline is capped at %d — use download_url instead", len(att.Data), attachmentInlineMaxBytes))
		}
		view.Data = base64.StdEncoding.EncodeToString(att.Data)
	}
	return &attachmentOutput{Body: view}, nil
}

// handleAttachmentDownload streams one attachment's bytes. It is a RAW chi route
// (not Huma, not bearer): the capability TOKEN authorizes the download, so the