structured

type JSONParser struct{}

type JSONSchema struct {
	Type        string                 `json:"type,omitempty"`
	Description string                 `json:"description,omitempty"`
	Properties  map[string]*JSONSchema `json:"properties,omitempty"`
	Items       *JSONSchema            `json:"items,omitempty"`
	Required    []string               `json:"required,omitempty"`
	Enum        []any                  `json:"enum,omitempty"`
	Minimum     *float64               `json:"minimum,omitempty"`
	Maximum     *float64               `json:"maximum,omitempty"`
	Pattern     string                 `json:"pattern,omitempty"`
	Format      string                 `json:"format,omitempty"`
	Default     any                    `json:"default,omitempty"`
}

type OutputSpec struct {
	Enabled         bool           // 是否启用结构化解析
	Schema          map[string]any // 可选的 JSON Schema 信息（当前仅透传）
	RequiredFields  []string       // 期望在顶层出现的字段
	AllowTextBackup bool           // 解析失败时是否允许保留原始文本
}

type ParseResult struct {
	RawText       string   // 模型原始输出
	RawJSON       string   // 提取出的 JSON 文本
	Data          any      // JSON 解析结果
	MissingFields []string // 缺失的必填字段
}

type Parser interface {
	Parse(ctx context.Context, text string, spec OutputSpec) (*ParseResult, error)
}

type SchemaGenerator struct{}

type SchemaValidator struct {
	// contains filtered or unexported fields
}

type TypedOutputSpec struct {
	StructType       any             // Go struct 类型（用于反射）
	Schema           *JSONSchema     // JSON Schema 验证
	RequiredFields   []string        // 必填字段
	Strict           bool            // 严格模式（验证失败则报错）
	AllowTextBackup  bool            // 解析失败时是否允许保留原始文本
	CustomValidation func(any) error // 自定义验证函数
}

type TypedParseResult struct {
	RawText          string   // 原始文本
	RawJSON          string   // 提取的 JSON
	Data             any      // 解析后的数据（绑定到 struct）
	MissingFields    []string // 缺失的必填字段
	ValidationErrors []string // 验证错误
	Success          bool     // 是否成功
}

type TypedParser struct {
	// contains filtered or unexported fields
}