export type LogLevel = "info" | "warn" | "error";
export interface McpNodeLogEntry {
    level: LogLevel;
    message: string;
    timestamp: string;
}
export type McpNodeLogSink = (entry: McpNodeLogEntry) => void;

export declare function formatLogYearMonth(date: Date): string;

export declare function formatLogFileTimestamp(date: Date): string;
export declare function sanitizeLogFileNameSegment(segment: string): string;

export declare function buildStartupLogFilePath(options?: {
    homeDir?: string;
    logDir?: string;
    roleName?: string;
    instanceName?: string;
    startupTime?: Date;
}): string;
export declare function initializeStartupLogFile(): string | null;

export declare function updateStartupLogIdentity(roleName: string, instanceName: string): void;

export declare function appendStartupLogLine(level: LogLevel, message: string): void;

export declare function getStartupLogFilePath(): string | null;

export declare function setMcpNodeLogSink(sink: McpNodeLogSink | null): void;
export declare const logger: {
    
    debug: (..._args: unknown[]) => void;
    info: (...args: unknown[]) => void;
    warn: (...args: unknown[]) => void;
    error: (...args: unknown[]) => void;
};