using System.IO; using System.Text; using System.Text.Json; namespace AxCopilot.Services.Agent; /// /// 지정 경로의 파일 변경을 감지하고 변경 내역을 반환하는 도구. /// FileSystemInfo의 타임스탬프 기반으로 최근 변경 파일을 조회합니다. /// public class FileWatchTool : IAgentTool { public string Name => "file_watch"; public string Description => "Detect recent file changes in a folder. Returns a list of created, modified, and deleted files " + "since a given time. Useful for monitoring data folders, detecting log updates, " + "or tracking file system changes."; public ToolParameterSchema Parameters => new() { Properties = new() { ["path"] = new() { Type = "string", Description = "Folder path to watch. Relative to work folder." }, ["pattern"] = new() { Type = "string", Description = "File pattern filter (e.g. '*.csv', '*.log', '*.xlsx'). Default: '*' (all files)" }, ["since"] = new() { Type = "string", Description = "Time threshold: ISO 8601 datetime (e.g. '2026-03-30T09:00:00') " + "or relative duration ('1h', '6h', '24h', '7d', '30d'). Default: '24h'" }, ["recursive"] = new() { Type = "boolean", Description = "Search subdirectories recursively. Default: true" }, ["include_size"] = new() { Type = "boolean", Description = "Include file sizes in output. Default: true" }, ["top_n"] = new() { Type = "integer", Description = "Limit results to most recent N files. Default: 50" }, }, Required = ["path"] }; public Task ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct) { var path = args.GetProperty("path").SafeGetString() ?? ""; var pattern = args.SafeTryGetProperty("pattern", out var patEl) ? patEl.SafeGetString() ?? "*" : "*"; var sinceStr = args.SafeTryGetProperty("since", out var sinceEl) ? sinceEl.SafeGetString() ?? "24h" : "24h"; var recursive = !args.SafeTryGetProperty("recursive", out var recEl) || recEl.GetBoolean(); // default true var includeSize = !args.SafeTryGetProperty("include_size", out var sizeEl) || sizeEl.GetBoolean(); var topN = args.SafeTryGetProperty("top_n", out var topEl) && topEl.TryGetInt32(out var n) ? n : 50; var fullPath = FileReadTool.ResolvePath(path, context.WorkFolder); if (!context.IsPathAllowed(fullPath)) return Task.FromResult(ToolResult.Fail($"경로 접근 차단: {fullPath}")); if (!Directory.Exists(fullPath)) return Task.FromResult(ToolResult.Fail($"폴더 없음: {fullPath}")); try { var since = ParseSince(sinceStr); var searchOpt = recursive ? SearchOption.AllDirectories : SearchOption.TopDirectoryOnly; var files = Directory.GetFiles(fullPath, pattern, searchOpt) .Select(f => new FileInfo(f)) .Where(fi => fi.LastWriteTime >= since || fi.CreationTime >= since) .OrderByDescending(fi => fi.LastWriteTime) .Take(topN) .ToList(); if (files.Count == 0) return Task.FromResult(ToolResult.Ok( $"📂 {sinceStr} 이내 변경된 파일이 없습니다. (경로: {path}, 패턴: {pattern})")); var sb = new StringBuilder(); sb.AppendLine($"📂 파일 변경 감지: {files.Count}개 파일 ({sinceStr} 이내)"); sb.AppendLine($" 경로: {path} | 패턴: {pattern}"); sb.AppendLine(); // 생성/수정 분류 var created = files.Where(f => f.CreationTime >= since && f.CreationTime == f.LastWriteTime).ToList(); var modified = files.Where(f => f.LastWriteTime >= since && f.CreationTime < since).ToList(); var recentlyCreated = files.Where(f => f.CreationTime >= since && f.CreationTime != f.LastWriteTime).ToList(); if (created.Count > 0) { sb.AppendLine($"🆕 신규 생성 ({created.Count}개):"); foreach (var f in created) AppendFileInfo(sb, f, fullPath, includeSize); sb.AppendLine(); } if (modified.Count > 0) { sb.AppendLine($"✏️ 수정됨 ({modified.Count}개):"); foreach (var f in modified) AppendFileInfo(sb, f, fullPath, includeSize); sb.AppendLine(); } if (recentlyCreated.Count > 0) { sb.AppendLine($"📝 생성 후 수정됨 ({recentlyCreated.Count}개):"); foreach (var f in recentlyCreated) AppendFileInfo(sb, f, fullPath, includeSize); sb.AppendLine(); } // 요약 통계 var totalSize = files.Sum(f => f.Length); sb.AppendLine($"── 요약: 총 {files.Count}개 파일, {FormatSize(totalSize)}"); // 파일 유형별 분포 var byExt = files.GroupBy(f => f.Extension.ToLowerInvariant()) .OrderByDescending(g => g.Count()) .Take(10); sb.Append(" 유형: "); sb.AppendLine(string.Join(", ", byExt.Select(g => $"{g.Key}({g.Count()})"))); return Task.FromResult(ToolResult.Ok(sb.ToString())); } catch (Exception ex) { return Task.FromResult(ToolResult.Fail($"파일 감시 실패: {ex.Message}")); } } private static DateTime ParseSince(string since) { if (DateTime.TryParse(since, out var dt)) return dt; // 상대 시간: "1h", "24h", "7d", "30d" var match = System.Text.RegularExpressions.Regex.Match(since, @"^(\d+)(h|d|m)$"); if (match.Success) { var amount = int.Parse(match.Groups[1].Value); var unit = match.Groups[2].Value; return unit switch { "h" => DateTime.Now.AddHours(-amount), "d" => DateTime.Now.AddDays(-amount), "m" => DateTime.Now.AddMinutes(-amount), _ => DateTime.Now.AddHours(-24) }; } return DateTime.Now.AddHours(-24); // default: 24시간 } private static void AppendFileInfo(StringBuilder sb, FileInfo f, string basePath, bool includeSize) { var relPath = Path.GetRelativePath(basePath, f.FullName); var timeStr = f.LastWriteTime.ToString("MM-dd HH:mm"); if (includeSize) sb.AppendLine($" {relPath} ({FormatSize(f.Length)}, {timeStr})"); else sb.AppendLine($" {relPath} ({timeStr})"); } private static string FormatSize(long bytes) { if (bytes < 1024) return $"{bytes}B"; if (bytes < 1024 * 1024) return $"{bytes / 1024.0:F1}KB"; if (bytes < 1024 * 1024 * 1024) return $"{bytes / (1024.0 * 1024):F1}MB"; return $"{bytes / (1024.0 * 1024 * 1024):F2}GB"; } }