import { z } from "zod";
import { type NoteManifest } from "./types.js";
export declare const DEFAULT_NOTES_CATALOG_URL = "https://www.memoire.cv/notes/catalog.v1.json";
export declare const DEFAULT_COMMUNITY_NOTES_CATALOG_URL = "https://www.memoire.cv/notes/community/catalog.v1.json";
export declare const NoteCatalogArchiveSchema: z.ZodObject<{
    url: z.ZodEffects<z.ZodString, string, string>;
    sha256: z.ZodString;
    size: z.ZodNumber;
}, "strip", z.ZodTypeAny, {
    url: string;
    sha256: string;
    size: number;
}, {
    url: string;
    sha256: string;
    size: number;
}>;
export declare const NoteCatalogEntrySchema: z.ZodObject<{
    id: z.ZodString;
    name: z.ZodString;
    title: z.ZodString;
    version: z.ZodString;
    description: z.ZodString;
    category: z.ZodEnum<["craft", "research", "connect", "generate"]>;
    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
    sourceUrls: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
    lastResearchedAt: z.ZodOptional<z.ZodString>;
    freshnessDays: z.ZodOptional<z.ZodNumber>;
    sourceKind: z.ZodOptional<z.ZodEnum<["official", "community"]>>;
    sourceRepo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
    sourcePath: z.ZodOptional<z.ZodString>;
    reviewStatus: z.ZodOptional<z.ZodEnum<["draft", "submitted", "approved", "rejected"]>>;
    contributionUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
    archive: z.ZodObject<{
        url: z.ZodEffects<z.ZodString, string, string>;
        sha256: z.ZodString;
        size: z.ZodNumber;
    }, "strip", z.ZodTypeAny, {
        url: string;
        sha256: string;
        size: number;
    }, {
        url: string;
        sha256: string;
        size: number;
    }>;
    manifest: z.ZodOptional<z.ZodObject<{
        name: z.ZodString;
        version: z.ZodString;
        description: z.ZodString;
        author: z.ZodOptional<z.ZodString>;
        category: z.ZodEnum<["craft", "research", "connect", "generate"]>;
        tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
        sourceUrls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
        lastResearchedAt: z.ZodOptional<z.ZodString>;
        freshnessDays: z.ZodOptional<z.ZodNumber>;
        skills: z.ZodArray<z.ZodObject<{
            file: z.ZodString;
            name: z.ZodString;
            activateOn: z.ZodString;
            freedomLevel: z.ZodDefault<z.ZodEnum<["maximum", "high", "read-only", "reference"]>>;
        }, "strip", z.ZodTypeAny, {
            name: string;
            file: string;
            activateOn: string;
            freedomLevel: "maximum" | "high" | "read-only" | "reference";
        }, {
            name: string;
            file: string;
            activateOn: string;
            freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
        }>, "many">;
        dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
        engines: z.ZodOptional<z.ZodObject<{
            memoire: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            memoire?: string | undefined;
        }, {
            memoire?: string | undefined;
        }>>;
        memoire: z.ZodOptional<z.ZodObject<{
            harnessExtensions: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
        }, "strip", z.ZodTypeAny, {
            harnessExtensions: unknown[];
        }, {
            harnessExtensions?: unknown[] | undefined;
        }>>;
        reviewStatus: z.ZodOptional<z.ZodEnum<["draft", "submitted", "approved", "rejected"]>>;
        forkOf: z.ZodOptional<z.ZodObject<{
            name: z.ZodString;
            version: z.ZodString;
            sourceRepo: z.ZodOptional<z.ZodString>;
            sourcePath: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            name: string;
            version: string;
            sourcePath?: string | undefined;
            sourceRepo?: string | undefined;
        }, {
            name: string;
            version: string;
            sourcePath?: string | undefined;
            sourceRepo?: string | undefined;
        }>>;
        createdAt: z.ZodDefault<z.ZodString>;
        updatedAt: z.ZodDefault<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        dependencies: string[];
        name: string;
        tags: string[];
        createdAt: string;
        updatedAt: string;
        version: string;
        description: string;
        category: "research" | "craft" | "connect" | "generate";
        sourceUrls: string[];
        skills: {
            name: string;
            file: string;
            activateOn: string;
            freedomLevel: "maximum" | "high" | "read-only" | "reference";
        }[];
        memoire?: {
            harnessExtensions: unknown[];
        } | undefined;
        author?: string | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        engines?: {
            memoire?: string | undefined;
        } | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        forkOf?: {
            name: string;
            version: string;
            sourcePath?: string | undefined;
            sourceRepo?: string | undefined;
        } | undefined;
    }, {
        name: string;
        version: string;
        description: string;
        category: "research" | "craft" | "connect" | "generate";
        skills: {
            name: string;
            file: string;
            activateOn: string;
            freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
        }[];
        dependencies?: string[] | undefined;
        tags?: string[] | undefined;
        createdAt?: string | undefined;
        updatedAt?: string | undefined;
        memoire?: {
            harnessExtensions?: unknown[] | undefined;
        } | undefined;
        author?: string | undefined;
        sourceUrls?: string[] | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        engines?: {
            memoire?: string | undefined;
        } | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        forkOf?: {
            name: string;
            version: string;
            sourcePath?: string | undefined;
            sourceRepo?: string | undefined;
        } | undefined;
    }>>;
}, "strip", z.ZodTypeAny, {
    name: string;
    tags: string[];
    version: string;
    title: string;
    description: string;
    id: string;
    category: "research" | "craft" | "connect" | "generate";
    sourceUrls: string[];
    archive: {
        url: string;
        sha256: string;
        size: number;
    };
    sourceKind?: "community" | "official" | undefined;
    sourcePath?: string | undefined;
    lastResearchedAt?: string | undefined;
    freshnessDays?: number | undefined;
    reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
    sourceRepo?: string | undefined;
    manifest?: {
        dependencies: string[];
        name: string;
        tags: string[];
        createdAt: string;
        updatedAt: string;
        version: string;
        description: string;
        category: "research" | "craft" | "connect" | "generate";
        sourceUrls: string[];
        skills: {
            name: string;
            file: string;
            activateOn: string;
            freedomLevel: "maximum" | "high" | "read-only" | "reference";
        }[];
        memoire?: {
            harnessExtensions: unknown[];
        } | undefined;
        author?: string | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        engines?: {
            memoire?: string | undefined;
        } | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        forkOf?: {
            name: string;
            version: string;
            sourcePath?: string | undefined;
            sourceRepo?: string | undefined;
        } | undefined;
    } | undefined;
    contributionUrl?: string | undefined;
}, {
    name: string;
    version: string;
    title: string;
    description: string;
    id: string;
    category: "research" | "craft" | "connect" | "generate";
    archive: {
        url: string;
        sha256: string;
        size: number;
    };
    tags?: string[] | undefined;
    sourceKind?: "community" | "official" | undefined;
    sourcePath?: string | undefined;
    sourceUrls?: string[] | undefined;
    lastResearchedAt?: string | undefined;
    freshnessDays?: number | undefined;
    reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
    sourceRepo?: string | undefined;
    manifest?: {
        name: string;
        version: string;
        description: string;
        category: "research" | "craft" | "connect" | "generate";
        skills: {
            name: string;
            file: string;
            activateOn: string;
            freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
        }[];
        dependencies?: string[] | undefined;
        tags?: string[] | undefined;
        createdAt?: string | undefined;
        updatedAt?: string | undefined;
        memoire?: {
            harnessExtensions?: unknown[] | undefined;
        } | undefined;
        author?: string | undefined;
        sourceUrls?: string[] | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        engines?: {
            memoire?: string | undefined;
        } | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        forkOf?: {
            name: string;
            version: string;
            sourcePath?: string | undefined;
            sourceRepo?: string | undefined;
        } | undefined;
    } | undefined;
    contributionUrl?: string | undefined;
}>;
export type NoteCatalogEntry = z.infer<typeof NoteCatalogEntrySchema>;
export declare const NoteCatalogSchema: z.ZodObject<{
    schemaVersion: z.ZodLiteral<1>;
    generatedAt: z.ZodString;
    baseUrl: z.ZodEffects<z.ZodString, string, string>;
    notes: z.ZodArray<z.ZodObject<{
        id: z.ZodString;
        name: z.ZodString;
        title: z.ZodString;
        version: z.ZodString;
        description: z.ZodString;
        category: z.ZodEnum<["craft", "research", "connect", "generate"]>;
        tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
        sourceUrls: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
        lastResearchedAt: z.ZodOptional<z.ZodString>;
        freshnessDays: z.ZodOptional<z.ZodNumber>;
        sourceKind: z.ZodOptional<z.ZodEnum<["official", "community"]>>;
        sourceRepo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
        sourcePath: z.ZodOptional<z.ZodString>;
        reviewStatus: z.ZodOptional<z.ZodEnum<["draft", "submitted", "approved", "rejected"]>>;
        contributionUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
        archive: z.ZodObject<{
            url: z.ZodEffects<z.ZodString, string, string>;
            sha256: z.ZodString;
            size: z.ZodNumber;
        }, "strip", z.ZodTypeAny, {
            url: string;
            sha256: string;
            size: number;
        }, {
            url: string;
            sha256: string;
            size: number;
        }>;
        manifest: z.ZodOptional<z.ZodObject<{
            name: z.ZodString;
            version: z.ZodString;
            description: z.ZodString;
            author: z.ZodOptional<z.ZodString>;
            category: z.ZodEnum<["craft", "research", "connect", "generate"]>;
            tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
            sourceUrls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
            lastResearchedAt: z.ZodOptional<z.ZodString>;
            freshnessDays: z.ZodOptional<z.ZodNumber>;
            skills: z.ZodArray<z.ZodObject<{
                file: z.ZodString;
                name: z.ZodString;
                activateOn: z.ZodString;
                freedomLevel: z.ZodDefault<z.ZodEnum<["maximum", "high", "read-only", "reference"]>>;
            }, "strip", z.ZodTypeAny, {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel: "maximum" | "high" | "read-only" | "reference";
            }, {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
            }>, "many">;
            dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
            engines: z.ZodOptional<z.ZodObject<{
                memoire: z.ZodOptional<z.ZodString>;
            }, "strip", z.ZodTypeAny, {
                memoire?: string | undefined;
            }, {
                memoire?: string | undefined;
            }>>;
            memoire: z.ZodOptional<z.ZodObject<{
                harnessExtensions: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
            }, "strip", z.ZodTypeAny, {
                harnessExtensions: unknown[];
            }, {
                harnessExtensions?: unknown[] | undefined;
            }>>;
            reviewStatus: z.ZodOptional<z.ZodEnum<["draft", "submitted", "approved", "rejected"]>>;
            forkOf: z.ZodOptional<z.ZodObject<{
                name: z.ZodString;
                version: z.ZodString;
                sourceRepo: z.ZodOptional<z.ZodString>;
                sourcePath: z.ZodOptional<z.ZodString>;
            }, "strip", z.ZodTypeAny, {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            }, {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            }>>;
            createdAt: z.ZodDefault<z.ZodString>;
            updatedAt: z.ZodDefault<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            dependencies: string[];
            name: string;
            tags: string[];
            createdAt: string;
            updatedAt: string;
            version: string;
            description: string;
            category: "research" | "craft" | "connect" | "generate";
            sourceUrls: string[];
            skills: {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel: "maximum" | "high" | "read-only" | "reference";
            }[];
            memoire?: {
                harnessExtensions: unknown[];
            } | undefined;
            author?: string | undefined;
            lastResearchedAt?: string | undefined;
            freshnessDays?: number | undefined;
            engines?: {
                memoire?: string | undefined;
            } | undefined;
            reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
            forkOf?: {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            } | undefined;
        }, {
            name: string;
            version: string;
            description: string;
            category: "research" | "craft" | "connect" | "generate";
            skills: {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
            }[];
            dependencies?: string[] | undefined;
            tags?: string[] | undefined;
            createdAt?: string | undefined;
            updatedAt?: string | undefined;
            memoire?: {
                harnessExtensions?: unknown[] | undefined;
            } | undefined;
            author?: string | undefined;
            sourceUrls?: string[] | undefined;
            lastResearchedAt?: string | undefined;
            freshnessDays?: number | undefined;
            engines?: {
                memoire?: string | undefined;
            } | undefined;
            reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
            forkOf?: {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            } | undefined;
        }>>;
    }, "strip", z.ZodTypeAny, {
        name: string;
        tags: string[];
        version: string;
        title: string;
        description: string;
        id: string;
        category: "research" | "craft" | "connect" | "generate";
        sourceUrls: string[];
        archive: {
            url: string;
            sha256: string;
            size: number;
        };
        sourceKind?: "community" | "official" | undefined;
        sourcePath?: string | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        sourceRepo?: string | undefined;
        manifest?: {
            dependencies: string[];
            name: string;
            tags: string[];
            createdAt: string;
            updatedAt: string;
            version: string;
            description: string;
            category: "research" | "craft" | "connect" | "generate";
            sourceUrls: string[];
            skills: {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel: "maximum" | "high" | "read-only" | "reference";
            }[];
            memoire?: {
                harnessExtensions: unknown[];
            } | undefined;
            author?: string | undefined;
            lastResearchedAt?: string | undefined;
            freshnessDays?: number | undefined;
            engines?: {
                memoire?: string | undefined;
            } | undefined;
            reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
            forkOf?: {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            } | undefined;
        } | undefined;
        contributionUrl?: string | undefined;
    }, {
        name: string;
        version: string;
        title: string;
        description: string;
        id: string;
        category: "research" | "craft" | "connect" | "generate";
        archive: {
            url: string;
            sha256: string;
            size: number;
        };
        tags?: string[] | undefined;
        sourceKind?: "community" | "official" | undefined;
        sourcePath?: string | undefined;
        sourceUrls?: string[] | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        sourceRepo?: string | undefined;
        manifest?: {
            name: string;
            version: string;
            description: string;
            category: "research" | "craft" | "connect" | "generate";
            skills: {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
            }[];
            dependencies?: string[] | undefined;
            tags?: string[] | undefined;
            createdAt?: string | undefined;
            updatedAt?: string | undefined;
            memoire?: {
                harnessExtensions?: unknown[] | undefined;
            } | undefined;
            author?: string | undefined;
            sourceUrls?: string[] | undefined;
            lastResearchedAt?: string | undefined;
            freshnessDays?: number | undefined;
            engines?: {
                memoire?: string | undefined;
            } | undefined;
            reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
            forkOf?: {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            } | undefined;
        } | undefined;
        contributionUrl?: string | undefined;
    }>, "many">;
}, "strip", z.ZodTypeAny, {
    notes: {
        name: string;
        tags: string[];
        version: string;
        title: string;
        description: string;
        id: string;
        category: "research" | "craft" | "connect" | "generate";
        sourceUrls: string[];
        archive: {
            url: string;
            sha256: string;
            size: number;
        };
        sourceKind?: "community" | "official" | undefined;
        sourcePath?: string | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        sourceRepo?: string | undefined;
        manifest?: {
            dependencies: string[];
            name: string;
            tags: string[];
            createdAt: string;
            updatedAt: string;
            version: string;
            description: string;
            category: "research" | "craft" | "connect" | "generate";
            sourceUrls: string[];
            skills: {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel: "maximum" | "high" | "read-only" | "reference";
            }[];
            memoire?: {
                harnessExtensions: unknown[];
            } | undefined;
            author?: string | undefined;
            lastResearchedAt?: string | undefined;
            freshnessDays?: number | undefined;
            engines?: {
                memoire?: string | undefined;
            } | undefined;
            reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
            forkOf?: {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            } | undefined;
        } | undefined;
        contributionUrl?: string | undefined;
    }[];
    generatedAt: string;
    schemaVersion: 1;
    baseUrl: string;
}, {
    notes: {
        name: string;
        version: string;
        title: string;
        description: string;
        id: string;
        category: "research" | "craft" | "connect" | "generate";
        archive: {
            url: string;
            sha256: string;
            size: number;
        };
        tags?: string[] | undefined;
        sourceKind?: "community" | "official" | undefined;
        sourcePath?: string | undefined;
        sourceUrls?: string[] | undefined;
        lastResearchedAt?: string | undefined;
        freshnessDays?: number | undefined;
        reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
        sourceRepo?: string | undefined;
        manifest?: {
            name: string;
            version: string;
            description: string;
            category: "research" | "craft" | "connect" | "generate";
            skills: {
                name: string;
                file: string;
                activateOn: string;
                freedomLevel?: "maximum" | "high" | "read-only" | "reference" | undefined;
            }[];
            dependencies?: string[] | undefined;
            tags?: string[] | undefined;
            createdAt?: string | undefined;
            updatedAt?: string | undefined;
            memoire?: {
                harnessExtensions?: unknown[] | undefined;
            } | undefined;
            author?: string | undefined;
            sourceUrls?: string[] | undefined;
            lastResearchedAt?: string | undefined;
            freshnessDays?: number | undefined;
            engines?: {
                memoire?: string | undefined;
            } | undefined;
            reviewStatus?: "rejected" | "draft" | "submitted" | "approved" | undefined;
            forkOf?: {
                name: string;
                version: string;
                sourcePath?: string | undefined;
                sourceRepo?: string | undefined;
            } | undefined;
        } | undefined;
        contributionUrl?: string | undefined;
    }[];
    generatedAt: string;
    schemaVersion: 1;
    baseUrl: string;
}>;
export type NoteCatalog = z.infer<typeof NoteCatalogSchema>;
export interface LoadNotesCatalogOptions {
    catalogUrl?: string | null;
    timeoutMs?: number;
}
export interface InstallCatalogNoteOptions extends LoadNotesCatalogOptions {
    onProgress?: (event: {
        type: "progress" | "completed";
        message: string;
        bytes?: number;
    }) => void;
}
export declare function loadNotesCatalog(options?: LoadNotesCatalogOptions): Promise<NoteCatalog>;
export declare function findCatalogNote(catalog: NoteCatalog, name: string, version?: string | null): NoteCatalogEntry | null;
export declare function isSafeNoteName(value: string): boolean;
export declare function assertSafeArchiveEntries(entries: string[]): void;
export declare function installCatalogNote(projectRoot: string, entry: NoteCatalogEntry, options?: InstallCatalogNoteOptions): Promise<NoteManifest>;
export declare function assertSafeExtractedTree(root: string): Promise<void>;
export declare function catalogEntryToManifest(entry: NoteCatalogEntry): NoteManifest;
export declare function noteArchiveName(entry: NoteCatalogEntry): string;
export declare function localArchiveUrl(path: string): string;
export declare function noteTitleFromName(name: string): string;