// @lifecycle canonical - Prompt data loading helper using shared context.
/**
* Loads and converts prompts with path normalization and registration.
* Reuses existing PromptAssetManager behavior without duplicating transport/config logic.
*/
import { access, stat } from 'node:fs/promises';
import * as path from 'node:path';
import type { RuntimeLaunchOptions } from './options.js';
import type { PathResolver } from './paths.js';
import type { ConfigManager } from '../config/index.js';
import type { Logger } from '../logging/index.js';
import type { PromptAssetManager } from '../prompts/index.js';
import type { Category, ConvertedPrompt, PromptData } from '../types/index.js';
export interface PromptDataLoadParams {
logger: Logger;
configManager: ConfigManager;
promptManager: PromptAssetManager;
runtimeOptions: RuntimeLaunchOptions;
serverRoot?: string;
/** Optional PathResolver for centralized path resolution */
pathResolver?: PathResolver;
mcpToolsManager?: {
updateData: (
prompts: PromptData[],
convertedPrompts: ConvertedPrompt[],
categories: Category[]
) => void;
};
apiManager?: {
updateData: (
prompts: PromptData[],
categories: Category[],
convertedPrompts: ConvertedPrompt[]
) => void;
};
}
export interface PromptDataLoadResult {
promptsData: PromptData[];
categories: Category[];
convertedPrompts: ConvertedPrompt[];
promptsFilePath: string;
}
export async function loadPromptData(params: PromptDataLoadParams): Promise<PromptDataLoadResult> {
const { logger, configManager, promptManager, runtimeOptions, serverRoot, pathResolver } = params;
const isVerbose = runtimeOptions.verbose;
const isQuiet = runtimeOptions.quiet;
// Resolve prompts path (directory or file)
// Priority: PathResolver > ConfigManager.getPromptsDirectory()
const config = configManager.getConfig();
let promptsPath = pathResolver
? pathResolver.getPromptsPath()
: configManager.getPromptsDirectory();
if (!isQuiet) {
logger.info('Starting prompt loading pipeline...');
logger.info(`Config prompts.directory setting: "${config.prompts.directory}"`);
}
// Log environment overrides
if (process.env['MCP_PROMPTS_PATH']) {
logger.info(`🎯 MCP_PROMPTS_PATH override: "${process.env['MCP_PROMPTS_PATH']}"`);
}
// Normalize to absolute path if needed
if (!path.isAbsolute(promptsPath)) {
const baseRoot = serverRoot ?? configManager.getServerRoot?.() ?? process.cwd();
promptsPath = path.resolve(baseRoot, promptsPath);
if (isVerbose) {
logger.info(`🔧 Converting prompts path to absolute: ${promptsPath}`);
}
}
// Verify path exists (can be directory or file for backward compatibility)
await access(promptsPath).catch((error) => {
logger.error(`✗ Prompts path NOT FOUND: ${promptsPath}`);
if (isVerbose) {
logger.error(`File access error:`, error);
logger.error(`Is path absolute? ${path.isAbsolute(promptsPath)}`);
logger.error(`Normalized path: ${path.normalize(promptsPath)}`);
}
throw new Error(`Prompts path not found: ${promptsPath}`);
});
// Determine if path is directory or file
const pathStats = await stat(promptsPath);
const isDirectory = pathStats.isDirectory();
if (isVerbose) {
const pathType = isDirectory ? 'directory' : 'file';
logger.info(`✓ Prompts ${pathType} exists: ${promptsPath}`);
}
// Load prompts - loadAndConvertPrompts handles both directory and file paths
const result = await promptManager.loadAndConvertPrompts(
promptsPath,
isDirectory ? promptsPath : path.dirname(promptsPath)
);
const promptsData = result.promptsData;
const categories = result.categories;
const convertedPrompts = result.convertedPrompts;
if (!isQuiet) {
logger.info('=== PROMPT LOADING RESULTS ===');
logger.info(`✓ Loaded ${promptsData.length} prompts from ${categories.length} categories`);
logger.info(`✓ Converted ${convertedPrompts.length} prompts to MCP format`);
}
// Update downstream managers if available
params.mcpToolsManager?.updateData(promptsData, convertedPrompts, categories);
params.apiManager?.updateData(promptsData, categories, convertedPrompts);
// Register prompts with MCP server
await promptManager.registerAllPrompts(convertedPrompts);
if (!isQuiet) {
logger.info('🔄 Prompts registered with MCP server');
}
return {
promptsData,
categories,
convertedPrompts,
promptsFilePath: promptsPath,
};
}
