skill

type Parameter struct {
	// Type is the JSON Schema type (string, number, boolean, array, object).
	Type string

	// Description explains the parameter's purpose.
	Description string

	// Required indicates whether the parameter must be provided.
	Required bool

	// Default is the default value if not provided.
	Default any

	// Enum lists allowed values for enum types.
	Enum []any
}

type Parameters map[string]Parameter

type Skill interface {
	// Name returns the skill identifier.
	Name() string

	// Description returns a human-readable description.
	Description() string

	// Init performs any initialization needed by the skill.
	Init(ctx context.Context) error

	// Close cleans up any resources.
	Close() error

	// Tools returns all tools provided by this skill.
	Tools() []Tool
}

type Tool interface {
	// Name returns the tool identifier.
	Name() string

	// Description returns a human-readable description.
	Description() string

	// Parameters returns the parameter schema for this tool.
	Parameters() Parameters

	// Execute runs the tool with the given parameters.
	Execute(ctx context.Context, params map[string]any) (any, error)
}