tools

type Category string

type ErrExecutionFailed struct {
	ToolName string
	Reason   string
	Cause    error
}

type ErrInvalidInput struct {
	ToolName string
	Field    string
	Reason   string
}

type ErrOutputTooLarge struct {
	ToolName   string
	OutputSize int64
	MaxSize    int64
}

type ErrPermissionDenied struct {
	ToolName  string
	Operation string
	Resource  string
	Reason    string
}

type ErrTimeout struct {
	ToolName string
	Duration string
}

type ErrToolConflict struct {
	ToolName string
}

type ErrToolNotFound struct {
	ToolName string
}

type ExecutionContext struct {
	Timeout          time.Duration
	WorkingDirectory string
	Environment      map[string]string
	AllowedPaths     []string // For sandboxing file operations
	MaxOutputSize    int64    // Maximum output size in bytes
	DryRun           bool     // If true, don't actually execute, just validate
}

type ExecutionOption func(*ExecutionContext)

type PropertyDef struct {
	Type        string      `json:"type"`
	Description string      `json:"description"`
	Enum        []string    `json:"enum,omitempty"`
	Default     interface{} `json:"default,omitempty"`
	MinLength   *int        `json:"minLength,omitempty"`
	MaxLength   *int        `json:"maxLength,omitempty"`
	Pattern     string      `json:"pattern,omitempty"`
}

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

type Result struct {
	Success  bool                   `json:"success"`
	Output   string                 `json:"output"`
	Error    error                  `json:"error,omitempty"`
	Metadata map[string]interface{} `json:"metadata,omitempty"`
}

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

	// Schema returns the JSON schema for the tool's input parameters.
	Schema() ToolSchema

	// Execute runs the tool with the provided input and returns the result.
	Execute(ctx context.Context, input map[string]interface{}) (*Result, error)

	// Category returns the category this tool belongs to.
	Category() Category

	// RequiresConfirmation returns true if this tool requires user confirmation before execution.
	RequiresConfirmation() bool
}

type ToolSchema struct {
	Type       string                 `json:"type"`
	Properties map[string]PropertyDef `json:"properties"`
	Required   []string               `json:"required,omitempty"`
}

type Validator struct{}