import type { SkillPackage, PluginPackage, DownloadResult } from '../types.js';
export declare function ensureDir(targetDir: string): Promise<string>;
export declare function withFileLock<T>(targetPath: string, operation: () => Promise<T>): Promise<T>;
export declare function stringifyStableJson(value: unknown): string;

export declare function sanitizeAgentId(agentId: string): string;

export declare function sanitizeArchiveFileName(fileName: string, fallback: string): string;
export declare function atomicWriteFile(targetPath: string, content: string): Promise<void>;

export declare function renameFileWithRetry(fromPath: string, toPath: string, attempts?: number): Promise<void>;

export declare function atomicWriteFileSync(targetPath: string, content: string): void;
export declare function atomicWriteJsonFile(targetPath: string, value: unknown): Promise<void>;
export declare function downloadSkillZip(skillPackage: SkillPackage, targetDir: string): Promise<DownloadResult | null>;
export declare function runCommand(command: string, args: string[]): Promise<void>;
export declare function escapePowerShellLiteral(text: string): string;

export declare function extractSkillZip(zipFilePath: string, extractRootDir: string): Promise<void>;
export declare function resolveSkillSourceDirFromExtractRoot(extractRootDir: string): Promise<string>;
export declare function downloadPluginZip(pluginPackage: PluginPackage, targetDir: string): Promise<DownloadResult | null>;