Method gateImagesForModel

cli/cli_file_processing.go:209–233

gateImagesForModel decides what to do with attached images given the active model (hybrid B+A strategy). It resolves a vision mode (see resolveVisionMode) and then: - native → pass the images through to the provider (path B); - describe → fold a textual description from a vision model into the pro

(ctx context.Context, images []models.ImageContent)

// dropped with a user-facing warning, so a non-vision provider never receives
// an image it cannot decode.
func (cli *ChatCLI) gateImagesForModel(ctx context.Context, images []models.ImageContent) ([]models.ImageContent, string) {
	if len(images) == 0 {
		return nil, ""
	}

	switch cli.resolveVisionMode() {
	case visionNative:
		return cli.compressImagesForVision(images), ""
	case visionOff:
		cli.logger.Info("vision: input disabled by CHATCLI_VISION_INPUT=off",
			zap.String("provider", cli.Provider), zap.String("model", cli.Model))
		return nil, ""
	default: // visionDescribe
		if desc, ok := cli.describeImagesFallback(ctx, images); ok {
			cli.logger.Info("vision: native vision unavailable, using describe-fallback",
				zap.String("provider", cli.Provider), zap.String("model", cli.Model),
				zap.Int("images", len(images)))
			return nil, desc
		}
		fmt.Println(i18n.T("vision.warn.model_no_vision", cli.Model))
		cli.logger.Warn("vision: image attached but model has no vision and no fallback is available",
			zap.String("provider", cli.Provider), zap.String("model", cli.Model))
		return nil, ""
	}
}

// compressImagesForVision downscales/re-encodes inline image bytes before they
// reach a vision model — cutting upload bytes, latency and (above the edge cap)