import type { PluginPackage, PluginSource } from "./types.js";
import type { PluginReadySkillPackage } from "./pluginSkillPackageListReady.js";
import type { PluginUiAssetSummary } from "./pluginUiAssetGet.js";
export interface PreparedPluginPackage {
    plugin: PluginPackage;
    cleanup(): Promise<void>;
}
export interface InstalledPluginUpdatePackage {
    created: boolean;
    imageStorageKey: string;
    packageDirectory: string;
}
/** Persists one exact package snapshot per system plugin so catalog changes cannot mutate installed metadata or files. */
export declare class PluginPackageStore {
    private readonly root;
    constructor(root: string);
    install(plugin: PluginPackage, pluginId: string): Promise<{
        packageDirectory: string;
        imageStorageKey: string;
    }>;
    installUpdate(plugin: PluginPackage, pluginId: string): Promise<InstalledPluginUpdatePackage>;
    prepareArchive(archive: Buffer, source: PluginSource): Promise<PreparedPluginPackage>;
    stageRequest(plugin: PluginPackage, requestId: string): Promise<string>;
    loadRequest(requestId: string, recordedDirectory: string, source: PluginSource, packageDigest: string): Promise<PluginPackage>;
    loadInstalled(pluginId: string, recordedDirectory: string, shortName: string, packageDigest: string, source: PluginSource): Promise<PluginPackage>;
    readRequestImage(requestId: string, recordedDirectory: string, source: PluginSource, packageDigest: string): Promise<Buffer>;
    removeRequest(requestId: string): Promise<void>;
    syncSkills(installed: readonly PluginReadySkillPackage[], agentHome: string): Promise<void>;
    remove(pluginId: string): Promise<void>;
    removeUpdate(pluginId: string, packageDirectory: string): Promise<void>;
    cleanupTemporary(): Promise<void>;
    createDownloadDirectory(): Promise<string>;
    removeDownloadDirectory(directory: string): Promise<void>;
    prepare(plugin: PluginPackage, preparationId: string): Promise<PluginPackage>;
    removePreparation(preparationId: string): Promise<void>;
    workspaceDirectory(pluginId: string, installationId: string): Promise<string>;
    createBuildContext(pluginId: string, recordedDirectory: string, shortName: string, packageDigest: string): Promise<string>;
    removeBuildContext(directory: string): Promise<void>;
    verify(pluginId: string, recordedDirectory: string, shortName: string, packageDigest: string): Promise<void>;
    readSkill(pluginId: string, recordedDirectory: string, shortName: string, packageDigest: string, skillName: string, skillDirectory: string, signal?: AbortSignal): Promise<{
        description: string;
        source: string;
    }>;
    readImage(pluginId: string, recordedDirectory: string, imageStorageKey: string, shortName: string, packageDigest: string): Promise<Buffer>;
    readUiAsset(asset: PluginUiAssetSummary): Promise<Buffer>;
    private path;
    private load;
    private updatePath;
    private requestPath;
}
//# sourceMappingURL=packageStore.d.ts.map