import { type NoteCatalog } from "../notes/catalog.js";
import type { StudioMarketplaceNote, StudioMarketplaceNotesPayload } from "./types.js";
export interface MarketplaceNotesOptions {
    refresh?: boolean;
    catalogUrl?: string | null;
    includeRemote?: boolean;
}
declare class StudioCatalogCache {
    private catalog;
    private checkedAt;
    private error;
    private catalogUrl;
    private readonly ttlMs;
    get ageMs(): number;
    get status(): {
        status: "disabled";
        catalogUrl: string | null;
        checkedAt: null;
        cacheAgeMs: number;
        error: null;
        entries: number;
    } | {
        status: "error" | "ready";
        catalogUrl: string | null;
        checkedAt: string | null;
        cacheAgeMs: number;
        error: string | null;
        entries: number;
    };
    load(options?: MarketplaceNotesOptions): Promise<NoteCatalog | null>;
}
export declare const studioCatalogCache: StudioCatalogCache;
export declare const studioCommunityCatalogCache: StudioCatalogCache;
export declare function listMarketplaceNotes(projectRoot: string, options?: MarketplaceNotesOptions): Promise<StudioMarketplaceNotesPayload>;
export declare function getMarketplaceNote(projectRoot: string, id: string, options?: MarketplaceNotesOptions): Promise<StudioMarketplaceNote | null>;
export declare function installMarketplaceNote(projectRoot: string, input: {
    noteId?: string;
    source?: string;
}): Promise<StudioMarketplaceNotesPayload>;
export declare function removeMarketplaceNote(projectRoot: string, input: {
    name?: string;
}): Promise<StudioMarketplaceNotesPayload>;
export {};