/**
 * Binary Scanner
 *
 * Scans system directories, PATH, npm/yarn globals, agent bins, and workspace
 * bins to discover all executables, classifying them by source, execution
 * context, and protection status.
 */
import type { BinarySourceKind, ExecutionContext, ProtectionKind, DiscoveredBinary, BinaryDirectory, DiscoveryOptions } from '@agenshield/ipc';
/**
 * Detect the npm global bin directory
 */
export declare function detectNpmGlobalBin(): string | null;
/**
 * Detect the yarn global bin directory
 */
export declare function detectYarnGlobalBin(): string | null;
/**
 * Classify a directory into a BinarySourceKind
 */
export declare function classifyDirectory(dirPath: string, npmGlobalBin: string | null, yarnGlobalBin: string | null, options: DiscoveryOptions): BinarySourceKind;
/**
 * Determine execution contexts for a directory
 */
export declare function getContextsForDir(dirPath: string, sourceKind: BinarySourceKind, _options: DiscoveryOptions): ExecutionContext[];
/**
 * Determine the protection status of a binary by name
 */
export declare function getProtection(name: string): ProtectionKind;
/**
 * Check if a file is a symlink pointing to shield-exec
 */
export declare function isShieldExecLink(filePath: string): boolean;
/**
 * Categorize a binary by name
 */
export declare function categorize(name: string): DiscoveredBinary['category'];
/**
 * Scan all binary directories and return discovered binaries and directory metadata
 */
export declare function scanBinaries(options: DiscoveryOptions): {
    binaries: DiscoveredBinary[];
    directories: BinaryDirectory[];
};
//# sourceMappingURL=binary-scanner.d.ts.map