aitool

type AITool struct {
	ID         string      `json:"id"`
	SourceID   string      `json:"source_id"`
	Name       string      `json:"name"`
	Type       AIToolType  `json:"type"`
	Scope      AIToolScope `json:"scope"`
	App        string      `json:"app"`
	AppDisplay string      `json:"-"`
	ConfigPath string      `json:"config_path"`

	MCPServer *MCPServerConfig `json:"mcp_server,omitempty"`
	Agent     *AgentConfig     `json:"agent,omitempty"`
	Enabled   *bool            `json:"enabled,omitempty"`
	Metadata  map[string]any   `json:"metadata,omitempty"`
}

type AIToolDiscovererFactory func(config DiscoveryConfig) (AIToolReader, error)

type AIToolHandlerFn func(*AITool) error

type AIToolInventory struct {
	Tools []*AITool `json:"tools"`
}

type AIToolReader interface {
	// Name returns a human-readable name for this discoverer
	Name() string

	// App returns the AI application identifier (e.g. "claude_code", "cursor")
	App() string

	// EnumTools discovers AI tools and calls handler for each one found.
	// Enumeration stops on first handler error.
	EnumTools(ctx context.Context, handler AIToolHandlerFn) error
}

type AIToolScope string

type AIToolType string

type AgentConfig struct {
	Version          string   `json:"version,omitempty"`
	PermissionMode   string   `json:"permission_mode,omitempty"`
	InstructionFiles []string `json:"instruction_files,omitempty"`
	Model            string   `json:"model,omitempty"`
	APIKeyEnvName    string   `json:"api_key_env_name,omitempty"`
}

type CLIToolVerifier interface {
	// BinaryNames returns candidate binary names to search in PATH.
	BinaryNames() []string

	// VerifyArgs returns the arguments to execute for identity verification.
	VerifyArgs() []string

	// VerifyOutput checks the command output and confirms this is the expected tool.
	// Returns (version string, true) if verified, ("", false) if not the right tool.
	VerifyOutput(stdout, stderr string) (version string, verified bool)

	// DisplayName returns the human-readable name for reporting.
	DisplayName() string

	// App returns the application identifier.
	App() string
}

type DiscoveryConfig struct {
	// HomeDir overrides the user home directory (for testing)
	HomeDir string

	// ProjectDir is the project root for project-level discovery.
	// Empty string means skip project-level discovery.
	ProjectDir string

	// Scope controls which scopes are active during discovery.
	// Nil means all scopes are enabled.
	Scope *DiscoveryScope
}

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

type MCPServerConfig struct {
	Transport        MCPTransport `json:"transport"`
	Command          string       `json:"command,omitempty"`
	Args             []string     `json:"args,omitempty"`
	URL              string       `json:"url,omitempty"`
	EnvVarNames      []string     `json:"env_var_names,omitempty"`
	HeaderNames      []string     `json:"header_names,omitempty"`
	AllowedTools     []string     `json:"allowed_tools,omitempty"`
	AllowedResources []string     `json:"allowed_resources,omitempty"`
}

type MCPTransport string

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

type ScopeMetadata struct {
	RequiresHomeDir    bool
	RequiresProjectDir bool
}