retold-remote 0.0.5 → 0.0.7

package/source/Pict-Application-RetoldRemote.js

@@ -8,6 +8,10 @@ const libProviderGalleryNavigation = require('./providers/Pict-Provider-GalleryN
 const libProviderGalleryFilterSort = require('./providers/Pict-Provider-GalleryFilterSort.js');
 const libProviderRetoldRemoteIcons = require('./providers/Pict-Provider-RetoldRemoteIcons.js');
 const libProviderRetoldRemoteTheme = require('./providers/Pict-Provider-RetoldRemoteTheme.js');
+const libProviderFormattingUtilities = require('./providers/Pict-Provider-FormattingUtilities.js');
+const libProviderToastNotification = require('./providers/Pict-Provider-ToastNotification.js');
+const libProviderCollectionManager = require('./providers/Pict-Provider-CollectionManager.js');
+const libProviderAISortManager = require('./providers/Pict-Provider-AISortManager.js');
 
 // Views (replace parent views)
 const libViewLayout = require('./views/PictView-Remote-Layout.js');
@@ -21,6 +25,7 @@ const libViewImageViewer = require('./views/PictView-Remote-ImageViewer.js');
 const libViewVideoExplorer = require('./views/PictView-Remote-VideoExplorer.js');
 const libViewAudioExplorer = require('./views/PictView-Remote-AudioExplorer.js');
 const libViewVLCSetup = require('./views/PictView-Remote-VLCSetup.js');
+const libViewCollectionsPanel = require('./views/PictView-Remote-CollectionsPanel.js');
 
 // Application configuration
 const _DefaultConfiguration = require('./Pict-Application-RetoldRemote-Configuration.json');
@@ -53,6 +58,7 @@ class RetoldRemoteApplication extends libContentEditorApplication
 		this.pict.addView('RetoldRemote-VideoExplorer', libViewVideoExplorer.default_configuration, libViewVideoExplorer);
 		this.pict.addView('RetoldRemote-AudioExplorer', libViewAudioExplorer.default_configuration, libViewAudioExplorer);
 		this.pict.addView('RetoldRemote-VLCSetup', libViewVLCSetup.default_configuration, libViewVLCSetup);
+		this.pict.addView('RetoldRemote-CollectionsPanel', libViewCollectionsPanel.default_configuration, libViewCollectionsPanel);
 
 		// Add new providers
 		this.pict.addProvider('RetoldRemote-Provider', libProviderRetoldRemote.default_configuration, libProviderRetoldRemote);
@@ -60,6 +66,10 @@ class RetoldRemoteApplication extends libContentEditorApplication
 		this.pict.addProvider('RetoldRemote-GalleryFilterSort', libProviderGalleryFilterSort.default_configuration, libProviderGalleryFilterSort);
 		this.pict.addProvider('RetoldRemote-Icons', libProviderRetoldRemoteIcons.default_configuration, libProviderRetoldRemoteIcons);
 		this.pict.addProvider('RetoldRemote-Theme', libProviderRetoldRemoteTheme.default_configuration, libProviderRetoldRemoteTheme);
+		this.pict.addProvider('RetoldRemote-FormattingUtilities', libProviderFormattingUtilities.default_configuration, libProviderFormattingUtilities);
+		this.pict.addProvider('RetoldRemote-ToastNotification', libProviderToastNotification.default_configuration, libProviderToastNotification);
+		this.pict.addProvider('RetoldRemote-CollectionManager', libProviderCollectionManager.default_configuration, libProviderCollectionManager);
+		this.pict.addProvider('RetoldRemote-AISortManager', libProviderAISortManager.default_configuration, libProviderAISortManager);
 	}
 
 	onAfterInitializeAsync(fCallback)
@@ -98,6 +108,11 @@ class RetoldRemoteApplication extends libContentEditorApplication
 			AutoplayVideo: false,
 			AutoplayAudio: false,
 
+			// List column visibility
+			ListShowExtension: true,
+			ListShowSize: true,
+			ListShowDate: true,
+
 			// Filter state
 			FilterState:
 			{
@@ -120,7 +135,28 @@ class RetoldRemoteApplication extends libContentEditorApplication
 			FilterPanelOpen: false,
 
 			// Saved filter presets
-			FilterPresets: []               // [{ Name, FilterState, SortField, SortDirection }]
+			FilterPresets: [],              // [{ Name, FilterState, SortField, SortDirection }]
+
+			// Collections state
+			Collections: [],                // Array of collection summaries
+			CollectionsPanelOpen: false,
+			CollectionsPanelWidth: 300,
+			CollectionsPanelMode: 'list',   // 'list' | 'detail' | 'edit'
+			ActiveCollectionGUID: null,
+			ActiveCollection: null,
+			CollectionSearchQuery: '',
+			LastUsedCollectionGUID: null,
+			BrowsingCollection: false,		// true when viewer is navigating collection items
+			BrowsingCollectionIndex: -1,	// index into ActiveCollection.Items
+
+			// AI Sort settings
+			AISortSettings:
+			{
+				AIEndpoint: 'http://localhost:11434',
+				AIModel: 'llama3.1',
+				AIProvider: 'ollama',
+				NamingTemplate: '{artist}/{album}/{track} - {title}'
+			}
 		};
 
 		// Load persisted settings
@@ -167,6 +203,23 @@ class RetoldRemoteApplication extends libContentEditorApplication
 		// Render the topbar
 		this.pict.views['ContentEditor-TopBar'].render();
 
+		// Render the collections panel (starts collapsed)
+		this.pict.views['RetoldRemote-CollectionsPanel'].render();
+
+		// Fetch collections list
+		let tmpCollManager = this.pict.providers['RetoldRemote-CollectionManager'];
+		if (tmpCollManager)
+		{
+			tmpCollManager.fetchCollections();
+		}
+
+		// Update the collections button icon
+		let tmpTopBarView = this.pict.views['ContentEditor-TopBar'];
+		if (tmpTopBarView && typeof tmpTopBarView.updateCollectionsIcon === 'function')
+		{
+			tmpTopBarView.updateCollectionsIcon();
+		}
+
 		let tmpSelf = this;
 
 		// Wire up file selection from the file browser sidebar
@@ -473,6 +526,9 @@ class RetoldRemoteApplication extends libContentEditorApplication
 					tmpListDetailView.render();
 				}
 
+				// Inject the add-folder button at the bottom of the sidebar file list
+				tmpSelf._injectSidebarAddFolderButton();
+
 				// Populate raw file list and run filter pipeline
 				let tmpRemote = tmpSelf.pict.AppData.RetoldRemote;
 				tmpRemote.RawFileList = pFileList || [];
@@ -619,6 +675,18 @@ class RetoldRemoteApplication extends libContentEditorApplication
 				tmpAEX.showExplorer(tmpFilePath);
 			}
 		}
+		else if (tmpParts[0] === 'collection' && tmpParts.length >= 2)
+		{
+			let tmpCollectionGUID = tmpParts[1];
+			let tmpCollManager = this.pict.providers['RetoldRemote-CollectionManager'];
+			if (tmpCollManager)
+			{
+				let tmpRemote = this.pict.AppData.RetoldRemote;
+				tmpRemote.CollectionsPanelMode = 'detail';
+				tmpCollManager.openPanel();
+				tmpCollManager.fetchCollection(tmpCollectionGUID);
+			}
+		}
 		else if (tmpParts[0] === 'edit' && tmpParts.length >= 2)
 		{
 			let tmpRawPath = tmpParts.slice(1).join('/');
@@ -627,6 +695,38 @@ class RetoldRemoteApplication extends libContentEditorApplication
 		}
 	}
 
+	/**
+	 * Inject a subtle "Add Folder" button at the bottom of the sidebar file list.
+	 * Replaces the bright white "+" button from the breadcrumb bar.
+	 */
+	_injectSidebarAddFolderButton()
+	{
+		let tmpDetailRows = document.getElementById('Pict-FileBrowser-DetailRows');
+		if (!tmpDetailRows)
+		{
+			return;
+		}
+
+		// Remove any existing injected button so we don't duplicate
+		let tmpExisting = tmpDetailRows.parentElement.querySelector('.retold-remote-sidebar-addfolder');
+		if (tmpExisting)
+		{
+			tmpExisting.parentElement.removeChild(tmpExisting);
+		}
+
+		let tmpBtn = document.createElement('button');
+		tmpBtn.className = 'retold-remote-sidebar-addfolder';
+		tmpBtn.textContent = '+ New Folder';
+		tmpBtn.title = 'Create a new folder here';
+		tmpBtn.onclick = function()
+		{
+			pict.PictApplication.promptNewFolder();
+		};
+
+		// Insert after the detail rows container
+		tmpDetailRows.parentElement.appendChild(tmpBtn);
+	}
+
 	/**
 	 * Save RetoldRemote settings to localStorage.
 	 */
@@ -651,7 +751,14 @@ class RetoldRemoteApplication extends libContentEditorApplication
 				FilterPresets: tmpRemote.FilterPresets,
 				FilterPanelOpen: tmpRemote.FilterPanelOpen,
 				AutoplayVideo: tmpRemote.AutoplayVideo,
-				AutoplayAudio: tmpRemote.AutoplayAudio
+				AutoplayAudio: tmpRemote.AutoplayAudio,
+				ListShowExtension: tmpRemote.ListShowExtension,
+				ListShowSize: tmpRemote.ListShowSize,
+				ListShowDate: tmpRemote.ListShowDate,
+				CollectionsPanelOpen: tmpRemote.CollectionsPanelOpen,
+				CollectionsPanelWidth: tmpRemote.CollectionsPanelWidth,
+				LastUsedCollectionGUID: tmpRemote.LastUsedCollectionGUID,
+				AISortSettings: tmpRemote.AISortSettings
 			};
 			localStorage.setItem('retold-remote-settings', JSON.stringify(tmpSettings));
 		}
@@ -693,6 +800,19 @@ class RetoldRemoteApplication extends libContentEditorApplication
 				if (typeof (tmpSettings.FilterPanelOpen) === 'boolean') tmpRemote.FilterPanelOpen = tmpSettings.FilterPanelOpen;
 				if (typeof (tmpSettings.AutoplayVideo) === 'boolean') tmpRemote.AutoplayVideo = tmpSettings.AutoplayVideo;
 				if (typeof (tmpSettings.AutoplayAudio) === 'boolean') tmpRemote.AutoplayAudio = tmpSettings.AutoplayAudio;
+				if (typeof (tmpSettings.ListShowExtension) === 'boolean') tmpRemote.ListShowExtension = tmpSettings.ListShowExtension;
+				if (typeof (tmpSettings.ListShowSize) === 'boolean') tmpRemote.ListShowSize = tmpSettings.ListShowSize;
+				if (typeof (tmpSettings.ListShowDate) === 'boolean') tmpRemote.ListShowDate = tmpSettings.ListShowDate;
+				if (typeof (tmpSettings.CollectionsPanelOpen) === 'boolean') tmpRemote.CollectionsPanelOpen = tmpSettings.CollectionsPanelOpen;
+				if (tmpSettings.CollectionsPanelWidth) tmpRemote.CollectionsPanelWidth = tmpSettings.CollectionsPanelWidth;
+				if (tmpSettings.LastUsedCollectionGUID) tmpRemote.LastUsedCollectionGUID = tmpSettings.LastUsedCollectionGUID;
+				if (tmpSettings.AISortSettings && typeof tmpSettings.AISortSettings === 'object')
+				{
+					if (tmpSettings.AISortSettings.AIEndpoint) tmpRemote.AISortSettings.AIEndpoint = tmpSettings.AISortSettings.AIEndpoint;
+					if (tmpSettings.AISortSettings.AIModel) tmpRemote.AISortSettings.AIModel = tmpSettings.AISortSettings.AIModel;
+					if (tmpSettings.AISortSettings.AIProvider) tmpRemote.AISortSettings.AIProvider = tmpSettings.AISortSettings.AIProvider;
+					if (tmpSettings.AISortSettings.NamingTemplate) tmpRemote.AISortSettings.NamingTemplate = tmpSettings.AISortSettings.NamingTemplate;
+				}
 			}
 		}
 		catch (pError)

package/source/RetoldRemote-ExtensionMaps.js

@@ -0,0 +1,33 @@
+/**
+ * Shared extension category maps for retold-remote.
+ *
+ * Used by both client-side providers (GalleryFilterSort) and server-side
+ * services (MediaService) to classify files by extension.
+ */
+
+const ImageExtensions = { 'png': true, 'jpg': true, 'jpeg': true, 'gif': true, 'webp': true, 'svg': true, 'bmp': true, 'ico': true, 'avif': true, 'tiff': true, 'tif': true, 'heic': true, 'heif': true };
+const VideoExtensions = { 'mp4': true, 'webm': true, 'mov': true, 'mkv': true, 'avi': true, 'wmv': true, 'flv': true, 'm4v': true, 'ogv': true, 'mpg': true, 'mpeg': true, 'mpe': true, 'mpv': true, 'm2v': true, 'ts': true, 'mts': true, 'm2ts': true, 'vob': true, '3gp': true, '3g2': true, 'f4v': true, 'rm': true, 'rmvb': true, 'divx': true, 'asf': true, 'mxf': true, 'dv': true, 'nsv': true, 'nuv': true, 'y4m': true, 'wtv': true, 'swf': true, 'dat': true };
+const AudioExtensions = { 'mp3': true, 'wav': true, 'ogg': true, 'flac': true, 'aac': true, 'm4a': true, 'wma': true, 'oga': true };
+const DocumentExtensions = { 'pdf': true, 'epub': true, 'mobi': true, 'doc': true, 'docx': true };
+
+/**
+ * Get the media category for a file extension.
+ *
+ * @param {string} pExtension - Extension with or without leading dot (e.g. '.png' or 'png')
+ * @returns {string} 'image', 'video', 'audio', 'document', or 'other'
+ */
+function getCategory(pExtension)
+{
+	let tmpExt = (pExtension || '').replace(/^\./, '').toLowerCase();
+	if (ImageExtensions[tmpExt]) return 'image';
+	if (VideoExtensions[tmpExt]) return 'video';
+	if (AudioExtensions[tmpExt]) return 'audio';
+	if (DocumentExtensions[tmpExt]) return 'document';
+	return 'other';
+}
+
+module.exports.ImageExtensions = ImageExtensions;
+module.exports.VideoExtensions = VideoExtensions;
+module.exports.AudioExtensions = AudioExtensions;
+module.exports.DocumentExtensions = DocumentExtensions;
+module.exports.getCategory = getCategory;

package/source/cli/RetoldRemote-Server-Setup.js

@@ -11,16 +11,16 @@
  * server setup) so that we control all routes and avoid conflicts with editor-
  * specific endpoints (save, upload) that aren't needed here.
  *
+ * Cache storage is managed by Parime's BinaryStorage with configurable
+ * hash-based subfolder sharding to avoid huge flat directories.
+ *
  * @param {object}   pOptions
  * @param {string}   pOptions.ContentPath          - Absolute path to the media folder to browse
  * @param {string}   pOptions.DistPath             - Absolute path to the built web-application folder
  * @param {number}   pOptions.Port                 - HTTP port
  * @param {boolean}  [pOptions.HashedFilenames]      - Enable hashed filenames mode
  * @param {string}   [pOptions.CacheRoot]            - Root cache directory (default: ./dist/retold-cache/)
- * @param {string}   [pOptions.CacheThumbnails]      - Override thumbnails cache directory
- * @param {string}   [pOptions.CacheArchives]        - Override archives cache directory
- * @param {string}   [pOptions.CacheVideoFrames]     - Override video-frames cache directory
- * @param {string}   [pOptions.CacheAudioWaveforms]  - Override audio-waveforms cache directory
+ * @param {string}   [pOptions.CacheServer]          - URL to a remote parime cache server
  * @param {Function} fCallback                     - Callback(pError, { Fable, Orator, Port })
  */
 
@@ -33,12 +33,19 @@ const libOrator = require('orator');
 const libOratorServiceServerRestify = require('orator-serviceserver-restify');
 const libFileBrowserService = require('pict-section-filebrowser').FileBrowserService;
 
+const libParimeStorage = require('parime/storage');
+const libRetoldRemoteParimeCache = require('../server/RetoldRemote-ParimeCache.js');
+
 const libRetoldRemoteMediaService = require('../server/RetoldRemote-MediaService.js');
 const libRetoldRemotePathRegistry = require('../server/RetoldRemote-PathRegistry.js');
 const libRetoldRemoteArchiveService = require('../server/RetoldRemote-ArchiveService.js');
 const libRetoldRemoteVideoFrameService = require('../server/RetoldRemote-VideoFrameService.js');
 const libRetoldRemoteAudioWaveformService = require('../server/RetoldRemote-AudioWaveformService.js');
 const libRetoldRemoteEbookService = require('../server/RetoldRemote-EbookService.js');
+const libRetoldRemoteCollectionService = require('../server/RetoldRemote-CollectionService.js');
+const libRetoldRemoteMetadataCache = require('../server/RetoldRemote-MetadataCache.js');
+const libRetoldRemoteFileOperationService = require('../server/RetoldRemote-FileOperationService.js');
+const libRetoldRemoteAISortService = require('../server/RetoldRemote-AISortService.js');
 const libUrl = require('url');
 
 function setupRetoldRemoteServer(pOptions, fCallback)
@@ -46,16 +53,33 @@ function setupRetoldRemoteServer(pOptions, fCallback)
 	let tmpContentPath = pOptions.ContentPath;
 	let tmpDistFolder = pOptions.DistPath;
 	let tmpPort = pOptions.Port;
-	let tmpHashedFilenames = !!(pOptions.HashedFilenames || process.env.RETOLD_HASHED_FILENAMES === 'true');
+	let tmpHashedFilenames = (pOptions.HashedFilenames !== false) && (process.env.RETOLD_HASHED_FILENAMES !== 'false');
+
+	// --- Resolve cache root ---
+	let tmpCacheRoot = pOptions.CacheRoot
+		|| libPath.resolve(process.cwd(), 'dist', 'retold-cache');
 
 	let tmpSettings =
 	{
 		Product: 'Retold-Remote',
 		ProductVersion: require('../../package.json').version,
 		APIServerPort: tmpPort,
-		ContentPath: tmpContentPath
+		ContentPath: tmpContentPath,
+		ParimeBinaryStorageRoot: tmpCacheRoot,
+		ParimeBinarySharding:
+		{
+			Enabled: true,
+			SegmentSize: 2,
+			Depth: 4
+		}
 	};
 
+	// If a remote cache server is specified, route cache operations over HTTP
+	if (pOptions.CacheServer)
+	{
+		tmpSettings.ParimeCacheServer = pOptions.CacheServer;
+	}
+
 	let tmpFable = new libFable(tmpSettings);
 
 	// Ensure the content directory exists
@@ -89,68 +113,79 @@ function setupRetoldRemoteServer(pOptions, fCallback)
 		tmpFable.log.info('Hashed filenames mode: ENABLED');
 	}
 
-	// --- Resolve cache paths ---
-	// Default root: ./dist/retold-cache/ relative to process cwd.
-	// Individual overrides take precedence over root.
-	let tmpCacheRoot = pOptions.CacheRoot
-		|| libPath.resolve(process.cwd(), 'dist', 'retold-cache');
+	// --- Initialize Parime storage ---
+	tmpFable.serviceManager.addServiceType('ParimeStorage', libParimeStorage);
+	let tmpParimeStorage = tmpFable.serviceManager.instantiateServiceProvider('ParimeStorage');
 
-	let tmpCacheThumbnails = pOptions.CacheThumbnails
-		|| libPath.join(tmpCacheRoot, 'thumbnails');
-	let tmpCacheArchives = pOptions.CacheArchives
-		|| libPath.join(tmpCacheRoot, 'archives');
-	let tmpCacheVideoFrames = pOptions.CacheVideoFrames
-		|| libPath.join(tmpCacheRoot, 'video-frames');
-	let tmpCacheAudioWaveforms = pOptions.CacheAudioWaveforms
-		|| libPath.join(tmpCacheRoot, 'audio-waveforms');
-	let tmpCacheEbooks = pOptions.CacheEbooks
-		|| libPath.join(tmpCacheRoot, 'ebook-conversions');
-
-	tmpFable.log.info(`Cache root: ${tmpCacheRoot}`);
-	tmpFable.log.info(`  Thumbnails:       ${tmpCacheThumbnails}`);
-	tmpFable.log.info(`  Archives:         ${tmpCacheArchives}`);
-	tmpFable.log.info(`  Video frames:     ${tmpCacheVideoFrames}`);
-	tmpFable.log.info(`  Audio waveforms:  ${tmpCacheAudioWaveforms}`);
-	tmpFable.log.info(`  Ebook conversions: ${tmpCacheEbooks}`);
-
-	// Set up the archive service
-	let tmpArchiveService = new libRetoldRemoteArchiveService(tmpFable,
-	{
-		ContentPath: tmpContentPath,
-		CachePath: tmpCacheArchives
-	});
+	tmpFable.serviceManager.addServiceType('RetoldRemoteParimeCache', libRetoldRemoteParimeCache);
+	let tmpParimeCache = tmpFable.serviceManager.instantiateServiceProvider('RetoldRemoteParimeCache');
 
-	// Set up the video frame service
-	let tmpVideoFrameService = new libRetoldRemoteVideoFrameService(tmpFable,
-	{
-		ContentPath: tmpContentPath,
-		CachePath: tmpCacheVideoFrames
-	});
+	tmpParimeStorage.initialize(
+		(pStorageError) =>
+		{
+			if (pStorageError)
+			{
+				return fCallback(pStorageError);
+			}
 
-	// Set up the audio waveform service
-	let tmpAudioWaveformService = new libRetoldRemoteAudioWaveformService(tmpFable,
-	{
-		ContentPath: tmpContentPath,
-		CachePath: tmpCacheAudioWaveforms
-	});
+			tmpFable.log.info(`Cache storage: ${tmpParimeCache.isRemote ? 'REMOTE (' + pOptions.CacheServer + ')' : tmpCacheRoot}`);
 
-	// Set up the ebook conversion service
-	let tmpEbookService = new libRetoldRemoteEbookService(tmpFable,
-	{
-		ContentPath: tmpContentPath,
-		CachePath: tmpCacheEbooks
-	});
+			// Set up the archive service
+			let tmpArchiveService = new libRetoldRemoteArchiveService(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
 
-	// Set up the media service
-	let tmpMediaService = new libRetoldRemoteMediaService(tmpFable,
-	{
-		ContentPath: tmpContentPath,
-		ThumbnailCachePath: tmpCacheThumbnails,
-		APIRoutePrefix: '/api/media',
-		PathRegistry: tmpPathRegistry
-	});
+			// Set up the video frame service
+			let tmpVideoFrameService = new libRetoldRemoteVideoFrameService(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
+
+			// Set up the audio waveform service
+			let tmpAudioWaveformService = new libRetoldRemoteAudioWaveformService(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
+
+			// Set up the ebook conversion service
+			let tmpEbookService = new libRetoldRemoteEbookService(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
+
+			// Set up the metadata cache service
+			let tmpMetadataCache = new libRetoldRemoteMetadataCache(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
+
+			// Set up the file operation service
+			let tmpFileOperationService = new libRetoldRemoteFileOperationService(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
+
+			// Set up the AI sort service
+			let tmpAISortService = new libRetoldRemoteAISortService(tmpFable,
+			{
+				ContentPath: tmpContentPath
+			});
+			tmpAISortService.setMetadataCache(tmpMetadataCache);
+
+			// Set up the collection service
+			let tmpCollectionService = new libRetoldRemoteCollectionService(tmpFable, {});
+			tmpCollectionService.setFileOperationService(tmpFileOperationService);
 
-	tmpOrator.initialize(
+			// Set up the media service
+			let tmpMediaService = new libRetoldRemoteMediaService(tmpFable,
+			{
+				ContentPath: tmpContentPath,
+				APIRoutePrefix: '/api/media',
+				PathRegistry: tmpPathRegistry
+			});
+
+			tmpOrator.initialize(
 		function ()
 		{
 			let tmpServiceServer = tmpOrator.serviceServer;
@@ -196,13 +231,11 @@ function setupRetoldRemoteServer(pOptions, fCallback)
 					{
 						Success: true,
 						HashedFilenames: tmpHashedFilenames,
-						CachePaths:
+						CacheStorage:
 						{
 							Root: tmpCacheRoot,
-							Thumbnails: tmpCacheThumbnails,
-							Archives: tmpCacheArchives,
-							VideoFrames: tmpCacheVideoFrames,
-							AudioWaveforms: tmpCacheAudioWaveforms
+							Remote: tmpParimeCache.isRemote,
+							Sharding: true
 						},
 						ArchiveSupport:
 						{
@@ -323,6 +356,113 @@ function setupRetoldRemoteServer(pOptions, fCallback)
 			// Connect media service API routes
 			tmpMediaService.connectRoutes(tmpServiceServer);
 
+			// Connect file operation service API routes
+			tmpFileOperationService.connectRoutes(tmpServiceServer);
+
+			// Connect collection service API routes
+			tmpCollectionService.connectRoutes(tmpServiceServer);
+
+			// Connect AI sort service API routes
+			tmpAISortService.connectRoutes(tmpServiceServer);
+
+			// --- GET /api/media/metadata ---
+			// Get cached metadata (with ID3/format tags) for a single file.
+			tmpServiceServer.get('/api/media/metadata',
+				(pRequest, pResponse, fNext) =>
+				{
+					try
+					{
+						let tmpParsedUrl = libUrl.parse(pRequest.url, true);
+						let tmpQuery = tmpParsedUrl.query;
+						let tmpRelPath = tmpQuery.path;
+
+						if (!tmpRelPath || typeof (tmpRelPath) !== 'string')
+						{
+							pResponse.send(400, { Success: false, Error: 'Missing path parameter.' });
+							return fNext();
+						}
+
+						tmpRelPath = decodeURIComponent(tmpRelPath).replace(/^\/+/, '');
+						if (tmpRelPath.includes('..') || libPath.isAbsolute(tmpRelPath))
+						{
+							pResponse.send(400, { Success: false, Error: 'Invalid path.' });
+							return fNext();
+						}
+
+						tmpMetadataCache.getMetadata(tmpRelPath,
+							(pError, pMetadata) =>
+							{
+								if (pError)
+								{
+									pResponse.send(404, { Success: false, Error: pError.message });
+									return fNext();
+								}
+								pResponse.send(pMetadata);
+								return fNext();
+							});
+					}
+					catch (pError)
+					{
+						pResponse.send(500, { Success: false, Error: pError.message });
+						return fNext();
+					}
+				});
+
+			// --- POST /api/media/metadata-batch ---
+			// Get cached metadata for multiple files at once.
+			tmpServiceServer.post('/api/media/metadata-batch',
+				(pRequest, pResponse, fNext) =>
+				{
+					try
+					{
+						let tmpPaths = pRequest.body && pRequest.body.Paths;
+
+						if (!Array.isArray(tmpPaths) || tmpPaths.length === 0)
+						{
+							pResponse.send(400, { Success: false, Error: 'Missing Paths array.' });
+							return fNext();
+						}
+
+						// Sanitize all paths
+						let tmpSanitized = [];
+						for (let i = 0; i < tmpPaths.length; i++)
+						{
+							let tmpRelPath = (typeof (tmpPaths[i]) === 'string')
+								? decodeURIComponent(tmpPaths[i]).replace(/^\/+/, '')
+								: null;
+
+							if (!tmpRelPath || tmpRelPath.includes('..') || libPath.isAbsolute(tmpRelPath))
+							{
+								continue;
+							}
+							tmpSanitized.push(tmpRelPath);
+						}
+
+						if (tmpSanitized.length === 0)
+						{
+							pResponse.send(400, { Success: false, Error: 'No valid paths.' });
+							return fNext();
+						}
+
+						tmpMetadataCache.getMetadataBatch(tmpSanitized,
+							(pError, pResults) =>
+							{
+								if (pError)
+								{
+									pResponse.send(500, { Success: false, Error: pError.message });
+									return fNext();
+								}
+								pResponse.send({ Success: true, Files: pResults });
+								return fNext();
+							});
+					}
+					catch (pError)
+					{
+						pResponse.send(500, { Success: false, Error: pError.message });
+						return fNext();
+					}
+				});
+
 			// --- GET /api/media/video-frames ---
 			// Extract evenly-spaced frames from a video for the Video Explorer.
 			tmpServiceServer.get('/api/media/video-frames',
@@ -1030,10 +1170,14 @@ function setupRetoldRemoteServer(pOptions, fCallback)
 						VideoFrameService: tmpVideoFrameService,
 						AudioWaveformService: tmpAudioWaveformService,
 						PathRegistry: tmpPathRegistry,
+						ParimeCache: tmpParimeCache,
+						MetadataCache: tmpMetadataCache,
+						FileOperationService: tmpFileOperationService,
 						Port: tmpPort
 					});
 				});
 		});
+	});
 }
 
 module.exports = setupRetoldRemoteServer;

package/source/cli/commands/RetoldRemote-Command-Serve.js

@@ -19,18 +19,12 @@ class RetoldRemoteCommandServe extends libCommandLineCommand
 			{ Name: '-p, --port [port]', Description: 'Port to serve on (defaults to random 7000-7999).', Default: '0' });
 
 		this.options.CommandOptions.push(
-			{ Name: '-H, --hashed-filenames', Description: 'Enable hashed filenames mode (short hashes instead of full paths in URLs).', Default: false });
+			{ Name: '--no-hash', Description: 'Disable hashed filenames mode (use plain paths in URLs instead of short hashes).', Default: false });
 
 		this.options.CommandOptions.push(
 			{ Name: '-c, --cache-path [path]', Description: 'Root cache directory (defaults to ./dist/retold-cache/).', Default: '' });
 		this.options.CommandOptions.push(
-			{ Name: '--cache-thumbnails [path]', Description: 'Override thumbnails cache directory.', Default: '' });
-		this.options.CommandOptions.push(
-			{ Name: '--cache-archives [path]', Description: 'Override archives cache directory.', Default: '' });
-		this.options.CommandOptions.push(
-			{ Name: '--cache-video-frames [path]', Description: 'Override video-frames cache directory.', Default: '' });
-		this.options.CommandOptions.push(
-			{ Name: '--cache-audio-waveforms [path]', Description: 'Override audio-waveforms cache directory.', Default: '' });
+			{ Name: '--cache-server [url]', Description: 'URL of a remote parime cache server (e.g. http://host:9999).', Default: '' });
 
 		this.addCommand();
 	}
@@ -60,24 +54,12 @@ class RetoldRemoteCommandServe extends libCommandLineCommand
 		let tmpSelf = this;
 		let tmpSetupServer = require('../RetoldRemote-Server-Setup.js');
 
-		let tmpHashedFilenames = !!(this.CommandOptions.hashedFilenames);
+		let tmpHashedFilenames = !(this.CommandOptions.noHash);
 
-		// Resolve cache paths: individual overrides > root override > default
 		let tmpCacheRoot = this.CommandOptions.cachePath
 			? libPath.resolve(this.CommandOptions.cachePath)
 			: null;
-		let tmpCacheThumbnails = this.CommandOptions.cacheThumbnails
-			? libPath.resolve(this.CommandOptions.cacheThumbnails)
-			: null;
-		let tmpCacheArchives = this.CommandOptions.cacheArchives
-			? libPath.resolve(this.CommandOptions.cacheArchives)
-			: null;
-		let tmpCacheVideoFrames = this.CommandOptions.cacheVideoFrames
-			? libPath.resolve(this.CommandOptions.cacheVideoFrames)
-			: null;
-		let tmpCacheAudioWaveforms = this.CommandOptions.cacheAudioWaveforms
-			? libPath.resolve(this.CommandOptions.cacheAudioWaveforms)
-			: null;
+		let tmpCacheServer = this.CommandOptions.cacheServer || null;
 
 		tmpSetupServer(
 			{
@@ -86,10 +68,7 @@ class RetoldRemoteCommandServe extends libCommandLineCommand
 				Port: tmpPort,
 				HashedFilenames: tmpHashedFilenames,
 				CacheRoot: tmpCacheRoot,
-				CacheThumbnails: tmpCacheThumbnails,
-				CacheArchives: tmpCacheArchives,
-				CacheVideoFrames: tmpCacheVideoFrames,
-				CacheAudioWaveforms: tmpCacheAudioWaveforms
+				CacheServer: tmpCacheServer
 			},
 			function (pError, pServerInfo)
 			{