package app

import "strings"

// 模型能力校验（model_capability_validate.go）拒绝的生成参数属于「模型填错了参数」，
// 不是模型、权限或预算问题。此前它们和其它准入失败一样被包成不可重试的
// media_admission_failed：工具结果只有一句「工具执行失败」，整轮直接终止，
// 模型既不知道错在哪个参数，也没有机会改正；用户要求重试时它只能原样再错一次。
//
// 这里把这类错误改报为字段级参数错误：结果里带着具体原因和取值来源，
// 走已有的 fix_arguments 纠正通道（次数仍受 cloudAgentToolAttemptLimit 限制），
// 没有任何任务被提交，也不会产生费用。
var cloudAgentMediaCapabilityArgumentHints = []struct {
	marker string
	field  string
	hint   string
}{
	{"图片尺寸不在当前模型支持范围内", "size", "size 必须取 model_list 返回的该模型 options.image.size.values 中的一个值（通常是像素尺寸，例如 1536x2752），不要写 9:16 这样的比例"},
	{"当前分辨率不支持所选图片宽高比", "size", "所选 quality 档位下没有这个宽高比；按 model_list 返回的该模型 options.image.size.presets 选一组匹配的比例与分辨率"},
	{"图片质量不在当前模型支持范围内", "quality", "quality 必须取 model_list 返回的该模型 options.image.quality.values 中的一个值，或省略"},
	{"视频时长不在当前模型支持范围内", "durationSeconds", "durationSeconds 必须落在 model_list 返回的该模型 options.video.duration 给出的范围或固定值内"},
	{"画面比例不在当前模型支持范围内", "size", "视频的 size 必须取 model_list 返回的该模型 options.video.ratios 中的一个比例"},
	{"输出分辨率不在当前模型支持范围内", "quality", "视频的 quality 必须取 model_list 返回的该模型 options.video.resolutions 中的一个值，大小写保持一致"},
}

// cloudAgentMediaCapabilityArgumentError 识别能力校验错误并转成可纠正的参数错误；
// 其它错误返回 nil，由调用方按原口径处理。
func cloudAgentMediaCapabilityArgumentError(err error) error {
	if err == nil {
		return nil
	}
	message := err.Error()
	for _, item := range cloudAgentMediaCapabilityArgumentHints {
		if strings.Contains(message, item.marker) {
			return cloudAgentFieldError(item.field, "unsupported_value", item.marker+"；"+item.hint+"。未提交生成任务，改正后可直接重新调用")
		}
	}
	return nil
}