Method loadImageAttachment

cli/cli_file_processing.go:298–339

loadImageAttachment reports whether path is a single image file and, if so, reads it into an ImageContent. Directories, oversized files, unreadable paths, and non-image content all return ok=false so the caller falls back to the normal text-scanning flow.

(path string)

// paths, and non-image content all return ok=false so the caller falls back
// to the normal text-scanning flow.
func (cli *ChatCLI) loadImageAttachment(path string) (models.ImageContent, bool) {
	expanded, err := utils.ExpandPath(path)
	if err != nil {
		expanded = path
	}

	info, err := os.Stat(expanded)
	if err != nil || info.IsDir() {
		return models.ImageContent{}, false
	}

	// Fast reject by extension only when it is clearly non-image AND large;
	// otherwise we still sniff, so an extensionless image is detected.
	ext := strings.ToLower(filepath.Ext(expanded))
	if info.Size() > maxImageAttachmentBytes {
		if imageFileExtensions[ext] {
			cli.logger.Warn("imagem excede o limite de anexo, ignorando",
				zap.String("path", expanded), zap.Int64("size", info.Size()))
		}
		return models.ImageContent{}, false
	}

	data, err := os.ReadFile(expanded) //#nosec G304 -- user-specified @file path to attach as a vision image
	if err != nil {
		return models.ImageContent{}, false
	}

	mime, ok := models.DetectImageMediaType(data)
	if !ok {
		// Not a recognized image; let the text path handle it.
		return models.ImageContent{}, false
	}

	cli.logger.Debug("imagem anexada via @file",
		zap.String("path", expanded), zap.String("mime", mime), zap.Int("bytes", len(data)))

	return models.ImageContent{
		MediaType: mime,
		Data:      data,
		FileName:  filepath.Base(expanded),
	}, true
}

// extractFileCommandOptions extrai caminhos e opções do comando @file
func extractFileCommandOptions(input string) ([]string, map[string]string, error) {