skill

type BaseSkill struct {
	SkillName        string
	SkillDescription string
	SkillTools       []Tool
}

type CommandResult struct {
	// Stdout contains the standard output.
	Stdout string `json:"stdout"`

	// Stderr contains the standard error.
	Stderr string `json:"stderr"`

	// ExitCode is the command's exit code.
	ExitCode int `json:"exit_code"`
}

type CommandTool struct {
	// ToolName is the tool identifier.
	ToolName string

	// ToolDescription describes what the tool does.
	ToolDescription string

	// Command is the executable name or path.
	Command string

	// Args are the command arguments. Use {{paramName}} for parameter substitution.
	Args []string

	// ToolParameters defines the tool's input parameters.
	ToolParameters map[string]Parameter

	// WorkingDir is the working directory for command execution.
	// If empty, uses the current directory.
	WorkingDir string

	// Timeout is the maximum execution time. Zero means no timeout.
	Timeout time.Duration

	// Env contains additional environment variables.
	Env []string
}

type FuncTool struct {
	ToolName        string
	ToolDescription string
	ToolParameters  map[string]Parameter
	Handler         ToolFunc
}

type Parameter struct {
	// Type is the JSON Schema type: "string", "number", "integer", "boolean", "object", "array".
	Type string `json:"type"`

	// Description explains what the parameter is for.
	Description string `json:"description,omitempty"`

	// Required indicates whether the parameter must be provided.
	Required bool `json:"required,omitempty"`

	// Enum lists the allowed values for this parameter.
	Enum []any `json:"enum,omitempty"`

	// Default is the default value if not provided.
	Default any `json:"default,omitempty"`

	// Items describes array element type (when Type is "array").
	Items *Parameter `json:"items,omitempty"`

	// Properties describes object properties (when Type is "object").
	Properties map[string]Parameter `json:"properties,omitempty"`
}

type Skill interface {
	// Name returns the skill identifier (e.g., "github", "weather").
	// Names should be lowercase, alphanumeric with underscores.
	Name() string

	// Description returns a human-readable description of what the skill does.
	Description() string

	// Tools returns the tools provided by this skill.
	// This may be called multiple times and should return consistent results
	// after Init() completes.
	Tools() []Tool

	// Init initializes the skill before use.
	// Called once when the skill is registered. Use this to establish
	// connections, load configuration, or perform other setup.
	Init(ctx context.Context) error

	// Close releases any resources held by the skill.
	// Called when the skill is unregistered or the application shuts down.
	Close() error
}

type Tool interface {
	// Name returns the tool identifier (e.g., "get_current_weather").
	// Names should be lowercase, alphanumeric with underscores.
	Name() string

	// Description returns a human-readable description of what the tool does.
	// This is used by AI models to understand when to use the tool.
	Description() string

	// Parameters returns the JSON Schema-like parameter definitions.
	// The map keys are parameter names.
	Parameters() map[string]Parameter

	// Call executes the tool with the given parameters.
	// Parameters have already been validated against the schema.
	// Returns the tool output or an error.
	Call(ctx context.Context, params map[string]any) (any, error)
}

type ToolFunc func(ctx context.Context, params map[string]any) (any, error)