import { GenericToolSpec, ToolExecutionContext, ToolArguments } from '../core/handlers/base-handler.js';
import {
validateFilename,
formatLogMessage,
} from '../core/handlers/validation-helpers.js';
import { LogToolName, getLimit } from '../utils/log-tool-constants.js';
import { SFCCLogClient } from '../clients/log-client.js';
import { LogLevel } from '../clients/logs/log-types.js';
/**
* Factory function to create get_latest_* tool specifications
* Eliminates repetition across error/warn/info/debug tools
*/
function createLatestLogTool(
level: LogLevel,
): GenericToolSpec<ToolArguments, unknown> {
return {
defaults: (args: ToolArguments) => ({
limit: getLimit(args.limit as number, 'latest'),
}),
exec: async (args: ToolArguments, context: ToolExecutionContext) => {
const client = context.logClient as SFCCLogClient;
return client.getLatestLogs(level, args.limit as number, args.date as string);
},
logMessage: (args: ToolArguments) =>
formatLogMessage(`Fetching latest ${level} logs`, { limit: args.limit as number, date: args.date as string ?? 'today' }),
};
}
/**
* Configuration for standard log tools
* Maps each tool to its validation, execution, and messaging logic
*/
export const LOG_TOOL_CONFIG: Record<LogToolName, GenericToolSpec<ToolArguments, unknown>> = {
get_latest_error: createLatestLogTool('error'),
get_latest_warn: createLatestLogTool('warn'),
get_latest_info: createLatestLogTool('info'),
get_latest_debug: createLatestLogTool('debug'),
summarize_logs: {
exec: async (args: ToolArguments, context: ToolExecutionContext) => {
const client = context.logClient as SFCCLogClient;
return client.summarizeLogs(args.date as string);
},
logMessage: (args: ToolArguments) => formatLogMessage('Summarizing logs for date', { date: args.date as string ?? 'today' }),
},
search_logs: {
defaults: (args: ToolArguments) => ({
limit: getLimit(args.limit as number, 'search'),
}),
exec: async (args: ToolArguments, context: ToolExecutionContext) => {
const client = context.logClient as SFCCLogClient;
return client.searchLogs(
args.pattern as string,
args.logLevel as LogLevel | undefined,
args.limit as number,
args.date as string,
);
},
logMessage: (args: ToolArguments) => formatLogMessage('Searching logs', {
pattern: args.pattern as string,
level: args.logLevel as string ?? 'all',
limit: args.limit as number ?? 20,
}),
},
list_log_files: {
exec: async (args: ToolArguments, context: ToolExecutionContext) => {
const client = context.logClient as SFCCLogClient;
return client.listLogFiles();
},
logMessage: () => 'Listing log files',
},
get_log_file_contents: {
validate: (args: ToolArguments, toolName: string) => {
validateFilename(args.filename as string, toolName);
},
exec: async (args: ToolArguments, context: ToolExecutionContext) => {
const client = context.logClient as SFCCLogClient;
return client.getLogFileContents(
args.filename as string,
args.maxBytes as number,
args.tailOnly as boolean,
);
},
logMessage: (args: ToolArguments) => formatLogMessage('Reading log file contents:', {
filename: args.filename as string,
maxBytes: args.maxBytes as number,
tailOnly: args.tailOnly as boolean,
}),
},
};
