compiled

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

	// Description explains the parameter. Shown to the LLM.
	Description string `json:"description,omitempty"`

	// Required indicates if this parameter must be provided.
	Required bool `json:"-"`

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

	// Enum restricts values to a specific set.
	Enum []any `json:"enum,omitempty"`

	// Items defines the schema for array elements (when Type is "array").
	Items *Parameter `json:"items,omitempty"`

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

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

type Skill interface {
	// Name returns the skill identifier (e.g., "invest", "weather").
	Name() string

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

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

	// Init initializes the skill. Called once when the agent starts.
	Init(ctx context.Context) error

	// Close releases resources. Called when the agent shuts down.
	Close() error
}

type SkillInfo struct {
	Name        string
	Description string
	ToolCount   int
	Tools       []ToolInfo
}

type Storage interface {
	Get(ctx context.Context, key string) ([]byte, error)
	Set(ctx context.Context, key string, value []byte, ttl time.Duration) error
	Delete(ctx context.Context, key string) error
}

type StorageAware interface {
	SetStorage(s Storage)
}

type Tool struct {
	// Name is the tool identifier (e.g., "analyze_stock").
	Name string

	// Description explains what the tool does. This is shown to the LLM.
	Description string

	// Parameters defines the tool's input parameters using JSON Schema.
	Parameters map[string]Parameter

	// Handler is the function that executes the tool.
	Handler ToolHandler
}

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

type ToolInfo struct {
	Name        string
	Description string
}