tools

type Permissions struct {
	// AllowBash allows executing bash commands.
	AllowBash bool

	// AllowFileRead allows reading files.
	AllowFileRead bool

	// AllowFileWrite allows writing files.
	AllowFileWrite bool

	// AllowGit allows git operations.
	AllowGit bool

	// AllowGitHub allows GitHub API operations.
	AllowGitHub bool

	// AllowNetwork allows network operations.
	AllowNetwork bool
}

type Registry 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

	// InputSchema returns the JSON Schema for the tool's input parameters.
	InputSchema() map[string]any

	// Execute runs the tool with the given input and returns the result.
	Execute(ctx context.Context, toolCtx *ToolContext, input map[string]any) (ToolResult, error)
}

type ToolContext struct {
	// WorkDir is the working directory for tool execution.
	// File operations should be restricted to this directory.
	WorkDir string

	// Permissions defines what operations are allowed.
	Permissions Permissions

	// GitHubToken is the token for GitHub API operations.
	GitHubToken string

	// RepoOwner is the owner of the repository.
	RepoOwner string

	// RepoName is the name of the repository.
	RepoName string

	// Env contains environment variables available to tools.
	Env map[string]string

	// BashTimeout is the timeout for bash command execution in seconds.
	BashTimeout int
}

type ToolResult struct {
	// Content is the output of the tool execution.
	Content string

	// IsError indicates if the execution resulted in an error.
	IsError bool

	// Metadata contains additional information about the execution.
	Metadata map[string]any
}