| | | 1 | | // Copyright (c) NexusLabs. All rights reserved. |
| | | 2 | | // Licensed under the MIT License. |
| | | 3 | | |
| | | 4 | | using System.Collections.Generic; |
| | | 5 | | using System.Linq; |
| | | 6 | | using System.Text; |
| | | 7 | | |
| | | 8 | | namespace NexusLabs.Needlr.AgentFramework.Generators; |
| | | 9 | | |
| | | 10 | | internal static class TopologyGraphCodeGenerator |
| | | 11 | | { |
| | | 12 | | public static string GenerateTopologyGraphSource( |
| | | 13 | | string diagram, |
| | | 14 | | string safeAssemblyName) |
| | | 15 | | { |
| | 6 | 16 | | var escaped = diagram.Replace("\"", "\"\""); |
| | | 17 | | |
| | 6 | 18 | | var sb = new StringBuilder(); |
| | 6 | 19 | | sb.AppendLine("// <auto-generated/>"); |
| | 6 | 20 | | sb.AppendLine("#nullable enable"); |
| | 6 | 21 | | sb.AppendLine(); |
| | 6 | 22 | | sb.AppendLine($"namespace {safeAssemblyName}.Generated;"); |
| | 6 | 23 | | sb.AppendLine(); |
| | 6 | 24 | | sb.AppendLine("internal static class AgentTopologyGraphDiagnostics"); |
| | 6 | 25 | | sb.AppendLine("{"); |
| | 6 | 26 | | sb.AppendLine($" public const string AgentTopologyGraph = @\"{escaped}\";"); |
| | 6 | 27 | | sb.AppendLine("}"); |
| | 6 | 28 | | return sb.ToString(); |
| | | 29 | | } |
| | | 30 | | |
| | | 31 | | public static string GenerateMermaidDiagram( |
| | | 32 | | Dictionary<(string InitialAgentTypeName, string InitialAgentClassName), List<(string TargetAgentTypeName, string |
| | | 33 | | Dictionary<string, List<string>> groupChatByGroupName, |
| | | 34 | | Dictionary<string, List<string>> sequenceByPipelineName, |
| | | 35 | | Dictionary<string, GraphData>? graphDataByName = null) |
| | | 36 | | { |
| | 6 | 37 | | var sb = new StringBuilder(); |
| | 6 | 38 | | sb.AppendLine("graph TD"); |
| | | 39 | | |
| | 12 | 40 | | foreach (var kvp in handoffByInitialAgent.OrderBy(k => k.Key.InitialAgentClassName)) |
| | | 41 | | { |
| | 0 | 42 | | var sourceClass = kvp.Key.InitialAgentClassName; |
| | 0 | 43 | | foreach (var (targetFqn, reason) in kvp.Value) |
| | | 44 | | { |
| | 0 | 45 | | var targetClass = AgentDiscoveryHelper.GetShortName(targetFqn); |
| | 0 | 46 | | if (string.IsNullOrWhiteSpace(reason)) |
| | 0 | 47 | | sb.AppendLine($" {sourceClass} --> {targetClass}"); |
| | | 48 | | else |
| | 0 | 49 | | sb.AppendLine($" {sourceClass} -->|\"{EscapeMermaidLabel(reason!)}\"| {targetClass}"); |
| | | 50 | | } |
| | | 51 | | } |
| | | 52 | | |
| | 12 | 53 | | foreach (var kvp in groupChatByGroupName.OrderBy(k => k.Key)) |
| | | 54 | | { |
| | 0 | 55 | | sb.AppendLine($" subgraph GroupChat_{SanitizeMermaidId(kvp.Key)}"); |
| | 0 | 56 | | foreach (var memberFqn in kvp.Value) |
| | 0 | 57 | | sb.AppendLine($" {AgentDiscoveryHelper.GetShortName(memberFqn)}"); |
| | 0 | 58 | | sb.AppendLine(" end"); |
| | | 59 | | } |
| | | 60 | | |
| | 12 | 61 | | foreach (var kvp in sequenceByPipelineName.OrderBy(k => k.Key)) |
| | | 62 | | { |
| | 0 | 63 | | sb.AppendLine($" subgraph Sequential_{SanitizeMermaidId(kvp.Key)}"); |
| | 0 | 64 | | var agents = kvp.Value; |
| | 0 | 65 | | if (agents.Count == 1) |
| | | 66 | | { |
| | 0 | 67 | | sb.AppendLine($" {AgentDiscoveryHelper.GetShortName(agents[0])}"); |
| | | 68 | | } |
| | | 69 | | else |
| | | 70 | | { |
| | 0 | 71 | | for (int i = 0; i < agents.Count - 1; i++) |
| | | 72 | | { |
| | 0 | 73 | | var cur = AgentDiscoveryHelper.GetShortName(agents[i]); |
| | 0 | 74 | | var next = AgentDiscoveryHelper.GetShortName(agents[i + 1]); |
| | 0 | 75 | | sb.AppendLine($" {cur} -->|\"{i + 1}\"| {next}"); |
| | | 76 | | } |
| | | 77 | | } |
| | 0 | 78 | | sb.AppendLine(" end"); |
| | | 79 | | } |
| | | 80 | | |
| | 6 | 81 | | if (graphDataByName != null) |
| | | 82 | | { |
| | 30 | 83 | | foreach (var kvp in graphDataByName.OrderBy(k => k.Key)) |
| | | 84 | | { |
| | 6 | 85 | | var graphName = kvp.Key; |
| | 6 | 86 | | var graphData = kvp.Value; |
| | 6 | 87 | | sb.AppendLine($" subgraph Graph_{SanitizeMermaidId(graphName)}"); |
| | | 88 | | |
| | | 89 | | // Collect entry point class names for stadium shape rendering |
| | 6 | 90 | | var entryPointClassNames = new HashSet<string>(); |
| | 24 | 91 | | foreach (var ep in graphData.EntryPoints) |
| | 6 | 92 | | entryPointClassNames.Add(ep.AgentClassName); |
| | | 93 | | |
| | | 94 | | // Collect reducer class names for hexagon shape rendering |
| | 6 | 95 | | var reducerClassNames = new HashSet<string>(); |
| | 14 | 96 | | foreach (var r in graphData.Reducers) |
| | 1 | 97 | | reducerClassNames.Add(r.AgentClassName); |
| | | 98 | | |
| | | 99 | | // Collect node join modes for labeling |
| | 6 | 100 | | var joinModeByClassName = new Dictionary<string, int>(); |
| | 14 | 101 | | foreach (var node in graphData.Nodes) |
| | | 102 | | { |
| | 1 | 103 | | if (node.JoinMode != 0) |
| | 1 | 104 | | joinModeByClassName[node.AgentClassName] = node.JoinMode; |
| | | 105 | | } |
| | | 106 | | |
| | | 107 | | // Emit entry point node declarations with stadium shape |
| | 24 | 108 | | foreach (var epClassName in entryPointClassNames) |
| | 6 | 109 | | sb.AppendLine($" {epClassName}([{epClassName}])"); |
| | | 110 | | |
| | | 111 | | // Emit reducer node declarations with hexagon shape |
| | 14 | 112 | | foreach (var reducerClassName in reducerClassNames) |
| | | 113 | | { |
| | 1 | 114 | | if (!entryPointClassNames.Contains(reducerClassName)) |
| | 1 | 115 | | sb.AppendLine($" {reducerClassName}{{{{{reducerClassName}}}}}"); |
| | | 116 | | } |
| | | 117 | | |
| | 26 | 118 | | foreach (var edge in graphData.Edges) |
| | | 119 | | { |
| | 7 | 120 | | var source = edge.SourceAgentClassName; |
| | 7 | 121 | | var target = AgentDiscoveryHelper.GetShortName(edge.TargetAgentTypeName); |
| | | 122 | | |
| | 7 | 123 | | var arrow = edge.IsRequired ? "-->" : "-.->"; |
| | | 124 | | |
| | | 125 | | // Build label parts |
| | 7 | 126 | | string? label = null; |
| | 7 | 127 | | if (!string.IsNullOrWhiteSpace(edge.Condition)) |
| | 2 | 128 | | label = EscapeMermaidLabel(edge.Condition!); |
| | | 129 | | |
| | | 130 | | // Add JoinMode annotation on edges targeting nodes with non-default join mode |
| | 7 | 131 | | if (joinModeByClassName.TryGetValue(target, out var joinMode)) |
| | | 132 | | { |
| | 1 | 133 | | var joinLabel = joinMode == 1 ? "WaitAny" : $"JoinMode{joinMode}"; |
| | 1 | 134 | | label = label != null ? $"{label}, {joinLabel}" : joinLabel; |
| | | 135 | | } |
| | | 136 | | |
| | 7 | 137 | | if (label != null) |
| | 3 | 138 | | sb.AppendLine($" {source} {arrow}|\"{label}\"| {target}"); |
| | | 139 | | else |
| | 4 | 140 | | sb.AppendLine($" {source} {arrow} {target}"); |
| | | 141 | | } |
| | | 142 | | |
| | 6 | 143 | | sb.AppendLine(" end"); |
| | | 144 | | } |
| | | 145 | | } |
| | | 146 | | |
| | 6 | 147 | | return sb.ToString(); |
| | | 148 | | } |
| | | 149 | | |
| | | 150 | | private static string SanitizeMermaidId(string name) |
| | | 151 | | { |
| | 6 | 152 | | var sb = new StringBuilder(); |
| | 68 | 153 | | foreach (var c in name) |
| | 28 | 154 | | sb.Append(char.IsLetterOrDigit(c) ? c : '_'); |
| | 6 | 155 | | return sb.ToString(); |
| | | 156 | | } |
| | | 157 | | |
| | | 158 | | private static string EscapeMermaidLabel(string label) => |
| | 2 | 159 | | label.Replace("\"", """); |
| | | 160 | | } |