package flyto

import "encoding/json"

// tool.go - 工具定义(传递给 ModelProvider 的工具规格).
//
// 升华改进(ELEVATED): 与 internal/api.ToolDef 分离--
// internal/api.ToolDef 带有 provider 专属的 CacheControl 字段,
// flyto.Tool 只保留所有 provider 通用的字段(名称,描述,输入 Schema).
// provider 在内部将 flyto.Tool 转换为其 API 格式,
// 如 provider 会根据配置自动添加 cache_control.

// Tool 是工具定义(JSON Schema 格式的输入规格).
type Tool struct {
	Name        string          // 工具名称,如 "Bash"
	Description string          // 工具描述(给模型看的自然语言说明)
	InputSchema json.RawMessage // 输入参数的 JSON Schema(object 类型)
}