import type { CatalogItemScope } from "@x12i/catalox-contracts/items.js";
/** Decode legacy `cx~` storage document ids (migration only). */
export declare function decodeNativeItemStorageDocId(docId: string): {
    logicalItemId: string;
    legacyScope: unknown;
} | null;
/**
 * Convert legacy stored scope + metadata tags to flexible scope (migration / allowLegacy reads).
 */
export declare function convertLegacyScopeToFlexible(scope: unknown, metadata?: Record<string, unknown>): CatalogItemScope;
export type ScopeMappingFile = Record<string, {
    domains?: string[];
    agents?: string[];
}>;
export declare function applyAgentScopeMapping(scope: CatalogItemScope, accountId: string, agentId: string, mapping?: ScopeMappingFile): CatalogItemScope;
/** Stable fingerprint for migration payload equivalence checks. */
export declare function payloadFingerprint(data: Record<string, unknown>): string;
export declare function unionFlexibleScopes(scopes: CatalogItemScope[]): CatalogItemScope;
//# sourceMappingURL=scope-legacy-convert.d.ts.map