tool

type CachedToolVersion struct {
	// LatestVersion is the most recent version string returned by the
	// remote version API (or left empty when no remote data is available).
	LatestVersion string `json:"latestVersion"`
}

type Checksum struct {
	// Algorithm is the hash algorithm (e.g. "sha256", "sha512").
	Algorithm string
	// Value is the hex-encoded checksum to compare against.
	Value string
}

type Detector interface {
	// DetectTool probes a single tool and returns its status.
	DetectTool(
		ctx context.Context,
		tool *ToolDefinition,
	) (*ToolStatus, error)

	// DetectAll probes every tool concurrently and returns a status
	// entry for each one. Individual detection failures are captured
	// in [ToolStatus.Error]; the returned error is non-nil only for
	// programming mistakes such as a nil tool pointer.
	DetectAll(
		ctx context.Context,
		tools []*ToolDefinition,
	) ([]*ToolStatus, error)
}

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

type InstallResult struct {
	// Tool is the definition that was installed or upgraded.
	Tool *ToolDefinition
	// Success indicates whether the operation completed successfully
	// and the tool is now available on the local machine.
	Success bool
	// InstalledVersion is the version detected after installation.
	InstalledVersion string
	// Strategy describes what was used to install the tool
	// (e.g. "winget", "brew", "manual").
	Strategy string
	// Duration is the wall-clock time the operation took.
	Duration time.Duration
	// Error holds any error encountered during the operation.
	Error error
}

type InstallStrategy struct {
	// PackageManager is the package manager name (e.g. "winget", "brew", "apt", "npm", "code").
	PackageManager string
	// PackageId is the identifier within the package manager (e.g. "Microsoft.AzureCLI").
	PackageId string
	// InstallCommand is the full shell command when a simple package-manager install
	// does not apply (e.g. "curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash").
	InstallCommand string
	// DirectDownloadUrl is a URL to a binary or archive that azd downloads
	// directly. When set, azd downloads the artifact, verifies its checksum
	// (if provided), and makes it available locally. This path is used
	// instead of PackageManager or InstallCommand.
	DirectDownloadUrl string
	// Checksum is the expected hash of the artifact referenced by
	// DirectDownloadUrl. When empty, checksum verification is skipped.
	Checksum Checksum
	// FallbackUrl points to manual installation instructions.
	FallbackUrl string
}

type Installer interface {
	// Install attempts to install the given tool using the best
	// strategy available for the current platform.
	Install(
		ctx context.Context,
		tool *ToolDefinition,
	) (*InstallResult, error)

	// Upgrade attempts to upgrade the given tool to its latest
	// version. When no upgrade-specific command exists the
	// operation falls back to a regular install.
	Upgrade(
		ctx context.Context,
		tool *ToolDefinition,
	) (*InstallResult, error)
}

type LatestVersionProvider interface {
	// GetLatestVersion returns the latest version string for the given
	// tool, or an error if the version cannot be determined.
	GetLatestVersion(
		ctx context.Context,
		tool *ToolDefinition,
	) (string, error)
}

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

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

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

type Platform struct {
	// OS is the operating system identifier returned by runtime.GOOS
	// (e.g. "windows", "darwin", "linux").
	OS string
	// AvailableManagers lists the package managers detected on the system
	// (e.g. ["winget", "npm"]).
	AvailableManagers []string
}

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

type ToolCategory string

type ToolDefinition struct {
	// Id is the unique, kebab-case identifier for the tool (e.g. "az-cli").
	Id string
	// Name is the human-readable display name.
	Name string
	// Description summarizes what the tool does in one sentence.
	Description string
	// Category classifies the tool (CLI, extension, server, or library).
	Category ToolCategory
	// Priority indicates whether the tool is recommended or optional.
	Priority ToolPriority
	// Website is the canonical documentation URL.
	Website string
	// DetectCommand is the binary name used to verify the tool is installed (e.g. "az").
	DetectCommand string
	// VersionArgs are the CLI arguments that print a version string (e.g. ["--version"]).
	VersionArgs []string
	// VersionRegex is a Go regular expression with a capture group for the semver portion
	// of the version output (e.g. `azure-cli\s+(\d+\.\d+\.\d+)`).
	VersionRegex string
	// InstallStrategies maps a GOOS value ("windows", "darwin", "linux") to the
	// platform-specific installation strategy.
	InstallStrategies map[string]InstallStrategy
	// Dependencies lists the IDs of tools that must be installed before this one.
	Dependencies []string
}

type ToolPriority string

type ToolStatus struct {
	// Tool is the definition that was probed.
	Tool *ToolDefinition
	// Installed is true when the tool was found on the local machine.
	Installed bool
	// InstalledVersion is the version string extracted from the tool's
	// output. It is empty when the tool is not installed or when
	// version parsing fails.
	InstalledVersion string
	// Error records any unexpected failure during detection (e.g. a
	// timeout). A tool that is simply not installed has Error == nil.
	Error error
}

type UpdateCheckCache struct {
	// CheckedAt is the time the cache was last populated.
	CheckedAt time.Time `json:"checkedAt"`
	// ExpiresAt is the earliest time the cache should be refreshed.
	ExpiresAt time.Time `json:"expiresAt"`
	// Tools maps tool IDs to their cached version information.
	Tools map[string]CachedToolVersion `json:"tools"`
}

type UpdateCheckResult struct {
	// Tool is the registry definition that was checked.
	Tool *ToolDefinition
	// CurrentVersion is the version currently installed on the local
	// machine (empty when the tool is not installed).
	CurrentVersion string
	// LatestVersion is the newest version known to the update checker.
	LatestVersion string
	// UpdateAvailable is true when LatestVersion is non-empty and
	// differs from CurrentVersion.
	UpdateAvailable bool
}

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