tools

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

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

type Parameters struct {
	// Args contains positional arguments
	Args []string

	// Kwargs contains keyword arguments
	Kwargs map[string]interface{}

	// Config provides access to configuration
	Config *configuration.Config

	// Logger for tool execution logging
	Logger *utils.Logger

	// Timeout for tool execution
	Timeout time.Duration
}

type PermissionChecker interface {
	// HasPermission checks if the given permissions are granted
	HasPermission(permissions []string) bool

	// CheckToolExecution checks if a tool can be executed
	CheckToolExecution(tool Tool, params Parameters) bool
}

type Registry interface {
	// RegisterTool registers a new tool
	RegisterTool(tool Tool) error

	// GetTool retrieves a tool by name
	GetTool(name string) (Tool, bool)

	// UnregisterTool removes a tool from the registry
	UnregisterTool(name string) error

	// ListTools returns all registered tools
	ListTools() []Tool

	// ListToolsByCategory returns tools in a specific category
	ListToolsByCategory(category string) []Tool
}

type Result struct {
	Success       bool                   `json:"success"`
	Output        interface{}            `json:"output"`
	Errors        []string               `json:"errors"`
	Metadata      map[string]interface{} `json:"metadata"`
	ExecutionTime time.Duration          `json:"execution_time"`
}

type SessionData struct {
	SessionID    string
	ToolCalls    map[string]*ToolCallInfo
	CreatedAt    time.Time
	LastActivity time.Time
}

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

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

type Tool interface {
	// Name returns the unique name of the tool
	Name() string

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

	// Category returns the category this tool belongs to (e.g., "workspace", "search", "edit")
	Category() string

	// Execute runs the tool with the given context and parameters
	Execute(ctx context.Context, params Parameters) (*Result, error)

	// CanExecute checks if the tool can be executed with the current context
	CanExecute(ctx context.Context, params Parameters) bool

	// RequiredPermissions returns the permissions needed to execute this tool
	RequiredPermissions() []string

	// EstimatedDuration returns an estimate of how long the tool will take to execute
	EstimatedDuration() time.Duration

	// IsAvailable checks if the tool is available in the current environment
	IsAvailable() bool
}

type ToolCallInfo struct {
	ToolName  string
	Arguments map[string]interface{}
	CallCount int
	FirstCall time.Time
	LastCall  time.Time
	Responses []string // Keep track of responses for cache purposes
}