claude-mpm 5.1.9__py3-none-any.whl → 5.4.22__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of claude-mpm might be problematic. Click here for more details.

Files changed (176) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/__init__.py +4 -0
  3. claude_mpm/agents/CLAUDE_MPM_TEACHER_OUTPUT_STYLE.md +1 -1
  4. claude_mpm/agents/PM_INSTRUCTIONS.md +290 -34
  5. claude_mpm/agents/agent_loader.py +13 -44
  6. claude_mpm/agents/templates/circuit-breakers.md +138 -1
  7. claude_mpm/cli/__main__.py +4 -0
  8. claude_mpm/cli/chrome_devtools_installer.py +175 -0
  9. claude_mpm/cli/commands/agent_state_manager.py +8 -17
  10. claude_mpm/cli/commands/agents.py +0 -31
  11. claude_mpm/cli/commands/auto_configure.py +210 -25
  12. claude_mpm/cli/commands/config.py +88 -2
  13. claude_mpm/cli/commands/configure.py +1097 -158
  14. claude_mpm/cli/commands/configure_agent_display.py +15 -6
  15. claude_mpm/cli/commands/mpm_init/core.py +160 -46
  16. claude_mpm/cli/commands/mpm_init/knowledge_extractor.py +481 -0
  17. claude_mpm/cli/commands/mpm_init/prompts.py +280 -0
  18. claude_mpm/cli/commands/skills.py +214 -189
  19. claude_mpm/cli/commands/summarize.py +413 -0
  20. claude_mpm/cli/executor.py +11 -3
  21. claude_mpm/cli/parsers/agents_parser.py +0 -9
  22. claude_mpm/cli/parsers/auto_configure_parser.py +0 -138
  23. claude_mpm/cli/parsers/base_parser.py +5 -0
  24. claude_mpm/cli/parsers/config_parser.py +153 -83
  25. claude_mpm/cli/parsers/skills_parser.py +3 -2
  26. claude_mpm/cli/startup.py +550 -94
  27. claude_mpm/commands/mpm-config.md +265 -0
  28. claude_mpm/commands/mpm-help.md +14 -95
  29. claude_mpm/commands/mpm-organize.md +500 -0
  30. claude_mpm/config/agent_sources.py +27 -0
  31. claude_mpm/core/framework/formatters/content_formatter.py +3 -13
  32. claude_mpm/core/framework/loaders/agent_loader.py +8 -5
  33. claude_mpm/core/framework_loader.py +4 -2
  34. claude_mpm/core/logger.py +13 -0
  35. claude_mpm/core/socketio_pool.py +3 -3
  36. claude_mpm/core/unified_agent_registry.py +5 -15
  37. claude_mpm/hooks/claude_hooks/correlation_manager.py +60 -0
  38. claude_mpm/hooks/claude_hooks/event_handlers.py +211 -78
  39. claude_mpm/hooks/claude_hooks/hook_handler.py +6 -0
  40. claude_mpm/hooks/claude_hooks/installer.py +33 -10
  41. claude_mpm/hooks/claude_hooks/memory_integration.py +26 -9
  42. claude_mpm/hooks/claude_hooks/response_tracking.py +2 -3
  43. claude_mpm/hooks/claude_hooks/services/connection_manager.py +4 -0
  44. claude_mpm/hooks/memory_integration_hook.py +46 -1
  45. claude_mpm/init.py +0 -19
  46. claude_mpm/scripts/claude-hook-handler.sh +58 -18
  47. claude_mpm/scripts/launch_monitor.py +93 -13
  48. claude_mpm/scripts/start_activity_logging.py +0 -0
  49. claude_mpm/services/agents/agent_recommendation_service.py +278 -0
  50. claude_mpm/services/agents/agent_review_service.py +280 -0
  51. claude_mpm/services/agents/deployment/agent_discovery_service.py +2 -3
  52. claude_mpm/services/agents/deployment/agent_template_builder.py +4 -2
  53. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +78 -9
  54. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +335 -53
  55. claude_mpm/services/agents/git_source_manager.py +34 -0
  56. claude_mpm/services/agents/loading/base_agent_manager.py +1 -13
  57. claude_mpm/services/agents/sources/git_source_sync_service.py +8 -1
  58. claude_mpm/services/agents/toolchain_detector.py +10 -6
  59. claude_mpm/services/analysis/__init__.py +11 -1
  60. claude_mpm/services/analysis/clone_detector.py +1030 -0
  61. claude_mpm/services/command_deployment_service.py +81 -10
  62. claude_mpm/services/event_bus/config.py +3 -1
  63. claude_mpm/services/git/git_operations_service.py +93 -8
  64. claude_mpm/services/monitor/daemon.py +9 -2
  65. claude_mpm/services/monitor/daemon_manager.py +39 -3
  66. claude_mpm/services/monitor/server.py +225 -19
  67. claude_mpm/services/self_upgrade_service.py +120 -12
  68. claude_mpm/services/skills/__init__.py +3 -0
  69. claude_mpm/services/skills/git_skill_source_manager.py +32 -2
  70. claude_mpm/services/skills/selective_skill_deployer.py +704 -0
  71. claude_mpm/services/skills/skill_to_agent_mapper.py +406 -0
  72. claude_mpm/services/skills_deployer.py +126 -9
  73. claude_mpm/services/socketio/event_normalizer.py +15 -1
  74. claude_mpm/services/socketio/server/core.py +160 -21
  75. claude_mpm/services/version_control/git_operations.py +103 -0
  76. claude_mpm/utils/agent_filters.py +17 -44
  77. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.22.dist-info}/METADATA +47 -84
  78. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.22.dist-info}/RECORD +82 -161
  79. claude_mpm-5.4.22.dist-info/entry_points.txt +5 -0
  80. claude_mpm-5.4.22.dist-info/licenses/LICENSE +94 -0
  81. claude_mpm-5.4.22.dist-info/licenses/LICENSE-FAQ.md +153 -0
  82. claude_mpm/agents/BASE_AGENT_TEMPLATE.md +0 -292
  83. claude_mpm/agents/BASE_DOCUMENTATION.md +0 -53
  84. claude_mpm/agents/BASE_ENGINEER.md +0 -658
  85. claude_mpm/agents/BASE_OPS.md +0 -219
  86. claude_mpm/agents/BASE_PM.md +0 -480
  87. claude_mpm/agents/BASE_PROMPT_ENGINEER.md +0 -787
  88. claude_mpm/agents/BASE_QA.md +0 -167
  89. claude_mpm/agents/BASE_RESEARCH.md +0 -53
  90. claude_mpm/agents/base_agent.json +0 -31
  91. claude_mpm/agents/base_agent_loader.py +0 -601
  92. claude_mpm/cli/commands/agents_detect.py +0 -380
  93. claude_mpm/cli/commands/agents_recommend.py +0 -309
  94. claude_mpm/cli/ticket_cli.py +0 -35
  95. claude_mpm/commands/mpm-agents-auto-configure.md +0 -278
  96. claude_mpm/commands/mpm-agents-detect.md +0 -177
  97. claude_mpm/commands/mpm-agents-list.md +0 -131
  98. claude_mpm/commands/mpm-agents-recommend.md +0 -223
  99. claude_mpm/commands/mpm-config-view.md +0 -150
  100. claude_mpm/commands/mpm-ticket-organize.md +0 -304
  101. claude_mpm/dashboard/analysis_runner.py +0 -455
  102. claude_mpm/dashboard/index.html +0 -13
  103. claude_mpm/dashboard/open_dashboard.py +0 -66
  104. claude_mpm/dashboard/static/css/activity.css +0 -1958
  105. claude_mpm/dashboard/static/css/connection-status.css +0 -370
  106. claude_mpm/dashboard/static/css/dashboard.css +0 -4701
  107. claude_mpm/dashboard/static/js/components/activity-tree.js +0 -1871
  108. claude_mpm/dashboard/static/js/components/agent-hierarchy.js +0 -777
  109. claude_mpm/dashboard/static/js/components/agent-inference.js +0 -956
  110. claude_mpm/dashboard/static/js/components/build-tracker.js +0 -333
  111. claude_mpm/dashboard/static/js/components/code-simple.js +0 -857
  112. claude_mpm/dashboard/static/js/components/connection-debug.js +0 -654
  113. claude_mpm/dashboard/static/js/components/diff-viewer.js +0 -891
  114. claude_mpm/dashboard/static/js/components/event-processor.js +0 -542
  115. claude_mpm/dashboard/static/js/components/event-viewer.js +0 -1155
  116. claude_mpm/dashboard/static/js/components/export-manager.js +0 -368
  117. claude_mpm/dashboard/static/js/components/file-change-tracker.js +0 -443
  118. claude_mpm/dashboard/static/js/components/file-change-viewer.js +0 -690
  119. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +0 -724
  120. claude_mpm/dashboard/static/js/components/file-viewer.js +0 -580
  121. claude_mpm/dashboard/static/js/components/hud-library-loader.js +0 -211
  122. claude_mpm/dashboard/static/js/components/hud-manager.js +0 -671
  123. claude_mpm/dashboard/static/js/components/hud-visualizer.js +0 -1718
  124. claude_mpm/dashboard/static/js/components/module-viewer.js +0 -2764
  125. claude_mpm/dashboard/static/js/components/session-manager.js +0 -579
  126. claude_mpm/dashboard/static/js/components/socket-manager.js +0 -368
  127. claude_mpm/dashboard/static/js/components/ui-state-manager.js +0 -749
  128. claude_mpm/dashboard/static/js/components/unified-data-viewer.js +0 -1824
  129. claude_mpm/dashboard/static/js/components/working-directory.js +0 -920
  130. claude_mpm/dashboard/static/js/connection-manager.js +0 -536
  131. claude_mpm/dashboard/static/js/dashboard.js +0 -1914
  132. claude_mpm/dashboard/static/js/extension-error-handler.js +0 -164
  133. claude_mpm/dashboard/static/js/socket-client.js +0 -1474
  134. claude_mpm/dashboard/static/js/tab-isolation-fix.js +0 -185
  135. claude_mpm/dashboard/static/socket.io.min.js +0 -7
  136. claude_mpm/dashboard/static/socket.io.v4.8.1.backup.js +0 -7
  137. claude_mpm/dashboard/templates/code_simple.html +0 -153
  138. claude_mpm/dashboard/templates/index.html +0 -606
  139. claude_mpm/dashboard/test_dashboard.html +0 -372
  140. claude_mpm/scripts/mcp_server.py +0 -75
  141. claude_mpm/scripts/mcp_wrapper.py +0 -39
  142. claude_mpm/services/mcp_gateway/__init__.py +0 -159
  143. claude_mpm/services/mcp_gateway/auto_configure.py +0 -369
  144. claude_mpm/services/mcp_gateway/config/__init__.py +0 -17
  145. claude_mpm/services/mcp_gateway/config/config_loader.py +0 -296
  146. claude_mpm/services/mcp_gateway/config/config_schema.py +0 -243
  147. claude_mpm/services/mcp_gateway/config/configuration.py +0 -429
  148. claude_mpm/services/mcp_gateway/core/__init__.py +0 -43
  149. claude_mpm/services/mcp_gateway/core/base.py +0 -312
  150. claude_mpm/services/mcp_gateway/core/exceptions.py +0 -253
  151. claude_mpm/services/mcp_gateway/core/interfaces.py +0 -443
  152. claude_mpm/services/mcp_gateway/core/process_pool.py +0 -977
  153. claude_mpm/services/mcp_gateway/core/singleton_manager.py +0 -315
  154. claude_mpm/services/mcp_gateway/core/startup_verification.py +0 -316
  155. claude_mpm/services/mcp_gateway/main.py +0 -589
  156. claude_mpm/services/mcp_gateway/registry/__init__.py +0 -12
  157. claude_mpm/services/mcp_gateway/registry/service_registry.py +0 -412
  158. claude_mpm/services/mcp_gateway/registry/tool_registry.py +0 -489
  159. claude_mpm/services/mcp_gateway/server/__init__.py +0 -15
  160. claude_mpm/services/mcp_gateway/server/mcp_gateway.py +0 -414
  161. claude_mpm/services/mcp_gateway/server/stdio_handler.py +0 -372
  162. claude_mpm/services/mcp_gateway/server/stdio_server.py +0 -712
  163. claude_mpm/services/mcp_gateway/tools/__init__.py +0 -36
  164. claude_mpm/services/mcp_gateway/tools/base_adapter.py +0 -485
  165. claude_mpm/services/mcp_gateway/tools/document_summarizer.py +0 -789
  166. claude_mpm/services/mcp_gateway/tools/external_mcp_services.py +0 -654
  167. claude_mpm/services/mcp_gateway/tools/health_check_tool.py +0 -456
  168. claude_mpm/services/mcp_gateway/tools/hello_world.py +0 -551
  169. claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py +0 -555
  170. claude_mpm/services/mcp_gateway/utils/__init__.py +0 -14
  171. claude_mpm/services/mcp_gateway/utils/package_version_checker.py +0 -160
  172. claude_mpm/services/mcp_gateway/utils/update_preferences.py +0 -170
  173. claude_mpm-5.1.9.dist-info/entry_points.txt +0 -10
  174. claude_mpm-5.1.9.dist-info/licenses/LICENSE +0 -21
  175. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.22.dist-info}/WHEEL +0 -0
  176. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.22.dist-info}/top_level.txt +0 -0
@@ -1,956 +0,0 @@
1
- /**
2
- * Agent Inference Module
3
- *
4
- * Handles agent inference and processing logic for determining whether events
5
- * originate from the main agent or subagents based on event patterns and context.
6
- *
7
- * WHY: Separated from main dashboard to isolate complex agent inference logic
8
- * that analyzes event patterns to determine agent context. This provides better
9
- * maintainability and testability for a critical feature.
10
- *
11
- * DESIGN DECISION: This module maintains its own state for inference tracking
12
- * but relies on the event viewer for source data, keeping clear separation of
13
- * concerns while enabling delegation context tracking across events.
14
- */
15
- class AgentInference {
16
- constructor(eventViewer) {
17
- this.eventViewer = eventViewer;
18
-
19
- // Agent inference state tracking
20
- this.state = {
21
- // Track current subagent delegation context
22
- currentDelegation: null,
23
- // Map of session_id -> agent context
24
- sessionAgents: new Map(),
25
- // Map of event indices -> inferred agent
26
- eventAgentMap: new Map(),
27
- // PM delegation tracking for unique instance views
28
- pmDelegations: new Map(), // delegation_id -> delegation context
29
- // Map of agent events to their PM delegation
30
- agentToDelegation: new Map(), // agent_name -> delegation_id
31
- // Track orphan subagent events (SubagentStart without PM Task)
32
- orphanSubagents: new Map(), // event_index -> orphan context
33
- // Track SubagentStart events for orphan detection
34
- subagentStartEvents: new Map() // agent_name -> array of start events
35
- };
36
-
37
- console.log('Agent inference system initialized');
38
- }
39
-
40
- /**
41
- * Initialize the agent inference system
42
- * Called when the dashboard initializes
43
- */
44
- initialize() {
45
- this.state = {
46
- currentDelegation: null,
47
- sessionAgents: new Map(),
48
- eventAgentMap: new Map(),
49
- pmDelegations: new Map(),
50
- agentToDelegation: new Map(),
51
- orphanSubagents: new Map(),
52
- subagentStartEvents: new Map()
53
- };
54
- }
55
-
56
- /**
57
- * Infer agent context from event payload
58
- * Based on production-ready detection from design document
59
- * @param {Object} event - Event payload
60
- * @returns {Object} - {type: 'main_agent'|'subagent', confidence: 'definitive'|'high'|'medium'|'default', agentName: string}
61
- */
62
- inferAgentFromEvent(event) {
63
- // Handle both direct properties and nested data properties
64
- const data = event.data || {};
65
- const sessionId = event.session_id || data.session_id || 'unknown';
66
- const eventType = event.hook_event_name || data.hook_event_name || event.type || '';
67
- const subtype = event.subtype || data.subtype || '';
68
- const toolName = event.tool_name || data.tool_name || '';
69
-
70
- // Debug logging for first few events to understand structure
71
- if (Math.random() < 0.1) {
72
- console.log('Agent inference debug:', {
73
- eventType,
74
- toolName,
75
- hasData: !!event.data,
76
- dataKeys: Object.keys(data),
77
- eventKeys: Object.keys(event),
78
- agentType: event.agent_type || data.agent_type,
79
- subagentType: event.subagent_type || data.subagent_type
80
- });
81
- }
82
-
83
- // Direct event detection (highest confidence) - from design doc
84
- if (eventType === 'SubagentStop' || subtype === 'subagent_stop') {
85
- const agentName = this.extractAgentNameFromEvent(event);
86
- // Log SubagentStop events for debugging
87
- console.log('SubagentStop event detected:', {
88
- agentName: agentName,
89
- sessionId: sessionId,
90
- eventType: eventType,
91
- subtype: subtype,
92
- rawAgentType: event.agent_type || data.agent_type
93
- });
94
- return {
95
- type: 'subagent',
96
- confidence: 'definitive',
97
- agentName: agentName,
98
- reason: 'SubagentStop event'
99
- };
100
- }
101
-
102
- if (eventType === 'Stop' || subtype === 'stop') {
103
- return {
104
- type: 'main_agent',
105
- confidence: 'definitive',
106
- agentName: 'PM',
107
- reason: 'Stop event'
108
- };
109
- }
110
-
111
- // Tool-based detection (high confidence) - from design doc
112
- if (toolName === 'Task') {
113
- const agentName = this.extractSubagentTypeFromTask(event);
114
- if (agentName) {
115
- // Log Task delegations for debugging
116
- console.log('Task delegation detected:', {
117
- agentName: agentName,
118
- sessionId: sessionId,
119
- eventType: eventType
120
- });
121
- return {
122
- type: 'subagent',
123
- confidence: 'high',
124
- agentName: agentName,
125
- reason: 'Task tool with subagent_type'
126
- };
127
- }
128
- }
129
-
130
- // Hook event pattern analysis (high confidence)
131
- if (eventType === 'PreToolUse' && toolName === 'Task') {
132
- const agentName = this.extractSubagentTypeFromTask(event);
133
- if (agentName) {
134
- return {
135
- type: 'subagent',
136
- confidence: 'high',
137
- agentName: agentName,
138
- reason: 'PreToolUse Task delegation'
139
- };
140
- }
141
- }
142
-
143
- // Session pattern analysis (medium confidence) - from design doc
144
- if (sessionId) {
145
- const sessionLower = sessionId.toLowerCase();
146
- if (['subagent', 'task', 'agent-'].some(pattern => sessionLower.includes(pattern))) {
147
- return {
148
- type: 'subagent',
149
- confidence: 'medium',
150
- agentName: 'Subagent',
151
- reason: 'Session ID pattern'
152
- };
153
- }
154
- }
155
-
156
- // Agent type field analysis - check multiple possible locations
157
- const agentType = event.agent_type || data.agent_type || event.agent_id || data.agent_id;
158
- const subagentType = event.subagent_type || data.subagent_type;
159
-
160
- if (subagentType && subagentType !== 'unknown') {
161
- return {
162
- type: 'subagent',
163
- confidence: 'high',
164
- agentName: this.normalizeAgentName(subagentType),
165
- reason: 'subagent_type field'
166
- };
167
- }
168
-
169
- if (agentType && agentType !== 'unknown' && agentType !== 'main') {
170
- return {
171
- type: 'subagent',
172
- confidence: 'medium',
173
- agentName: this.normalizeAgentName(agentType),
174
- reason: 'agent_type field'
175
- };
176
- }
177
-
178
- // Check for delegation_details from hook handler
179
- if (data.delegation_details?.agent_type) {
180
- return {
181
- type: 'subagent',
182
- confidence: 'high',
183
- agentName: this.normalizeAgentName(data.delegation_details.agent_type),
184
- reason: 'delegation_details'
185
- };
186
- }
187
-
188
- // Check if this looks like a Hook event from Socket.IO
189
- if (event.type && event.type.startsWith('hook.')) {
190
- // Extract the hook type
191
- const hookType = event.type.replace('hook.', '');
192
-
193
- // Handle SubagentStart events
194
- if (hookType === 'subagent_start' || (data.hook_event_name === 'SubagentStart')) {
195
- const rawAgentName = data.agent_type || data.agent_id || 'Subagent';
196
- console.log('SubagentStart event from Socket.IO:', {
197
- agentName: rawAgentName,
198
- sessionId: sessionId,
199
- hookType: hookType
200
- });
201
- return {
202
- type: 'subagent',
203
- confidence: 'definitive',
204
- agentName: this.normalizeAgentName(rawAgentName),
205
- reason: 'Socket.IO hook SubagentStart'
206
- };
207
- }
208
-
209
- // Handle SubagentStop events
210
- if (hookType === 'subagent_stop' || (data.hook_event_name === 'SubagentStop')) {
211
- const rawAgentName = data.agent_type || data.agent_id || 'Subagent';
212
- return {
213
- type: 'subagent',
214
- confidence: 'high',
215
- agentName: this.normalizeAgentName(rawAgentName),
216
- reason: 'Socket.IO hook SubagentStop'
217
- };
218
- }
219
- }
220
-
221
- // Default to main agent (from design doc)
222
- return {
223
- type: 'main_agent',
224
- confidence: 'default',
225
- agentName: 'PM',
226
- reason: 'default classification'
227
- };
228
- }
229
-
230
- /**
231
- * Normalize agent name from lowercase/underscore format to display format
232
- * @param {string} agentName - Raw agent name (e.g., 'engineer', 'test_integration')
233
- * @returns {string} - Normalized display name (e.g., 'Engineer Agent', 'Test Integration Agent')
234
- */
235
- normalizeAgentName(agentName) {
236
- if (!agentName) return 'Unknown';
237
-
238
- // Agent name mapping from raw format to display format
239
- const agentNameMap = {
240
- 'engineer': 'Engineer Agent',
241
- 'research': 'Research Agent',
242
- 'qa': 'QA Agent',
243
- 'documentation': 'Documentation Agent',
244
- 'security': 'Security Agent',
245
- 'ops': 'Ops Agent',
246
- 'version_control': 'Version Control Agent',
247
- 'data_engineer': 'Data Engineer Agent',
248
- 'test_integration': 'Test Integration Agent',
249
- 'pm': 'PM Agent'
250
- };
251
-
252
- // Check if we have a direct mapping
253
- const normalized = agentNameMap[agentName.toLowerCase()];
254
- if (normalized) {
255
- return normalized;
256
- }
257
-
258
- // If no direct mapping, apply basic formatting:
259
- // Convert underscore to space, capitalize words, and add "Agent" if not present
260
- let formatted = agentName
261
- .replace(/_/g, ' ')
262
- .split(' ')
263
- .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
264
- .join(' ');
265
-
266
- // Add "Agent" suffix if not already present
267
- if (!formatted.toLowerCase().includes('agent')) {
268
- formatted += ' Agent';
269
- }
270
-
271
- return formatted;
272
- }
273
-
274
- /**
275
- * Extract subagent type from Task tool parameters
276
- * @param {Object} event - Event with Task tool
277
- * @returns {string|null} - Subagent type or null
278
- */
279
- extractSubagentTypeFromTask(event) {
280
- let rawAgentName = null;
281
-
282
- // Check tool_parameters directly
283
- if (event.tool_parameters?.subagent_type) {
284
- rawAgentName = event.tool_parameters.subagent_type;
285
- }
286
- // Check nested in data.tool_parameters (hook events)
287
- else if (event.data?.tool_parameters?.subagent_type) {
288
- rawAgentName = event.data.tool_parameters.subagent_type;
289
- }
290
- // Check delegation_details (new structure)
291
- else if (event.data?.delegation_details?.agent_type) {
292
- rawAgentName = event.data.delegation_details.agent_type;
293
- }
294
- // Check tool_input fallback
295
- else if (event.tool_input?.subagent_type) {
296
- rawAgentName = event.tool_input.subagent_type;
297
- }
298
-
299
- // Normalize the agent name before returning
300
- return rawAgentName ? this.normalizeAgentName(rawAgentName) : null;
301
- }
302
-
303
- /**
304
- * Extract agent name from any event
305
- * @param {Object} event - Event payload
306
- * @returns {string} - Agent name
307
- */
308
- extractAgentNameFromEvent(event) {
309
- // Priority order based on reliability from design doc
310
- const data = event.data || {};
311
-
312
- // 1. Task tool subagent_type (highest priority)
313
- if (event.tool_name === 'Task' || data.tool_name === 'Task') {
314
- const taskAgent = this.extractSubagentTypeFromTask(event);
315
- if (taskAgent) return taskAgent;
316
- }
317
-
318
- // 2. Direct subagent_type field
319
- if (event.subagent_type && event.subagent_type !== 'unknown') {
320
- return this.normalizeAgentName(event.subagent_type);
321
- }
322
- if (data.subagent_type && data.subagent_type !== 'unknown') {
323
- return this.normalizeAgentName(data.subagent_type);
324
- }
325
-
326
- // 2.5. Check delegation_details
327
- if (data.delegation_details?.agent_type && data.delegation_details.agent_type !== 'unknown') {
328
- return this.normalizeAgentName(data.delegation_details.agent_type);
329
- }
330
-
331
- // 3. Agent type fields (but not 'main' or 'unknown')
332
- if (event.agent_type && !['main', 'unknown'].includes(event.agent_type)) {
333
- return this.normalizeAgentName(event.agent_type);
334
- }
335
- if (data.agent_type && !['main', 'unknown'].includes(data.agent_type)) {
336
- return this.normalizeAgentName(data.agent_type);
337
- }
338
-
339
- // 4. Agent ID field as fallback
340
- if (event.agent_id && !['main', 'unknown'].includes(event.agent_id)) {
341
- return this.normalizeAgentName(event.agent_id);
342
- }
343
- if (data.agent_id && !['main', 'unknown'].includes(data.agent_id)) {
344
- return this.normalizeAgentName(data.agent_id);
345
- }
346
-
347
- // 5. Other fallbacks
348
- if (event.agent && event.agent !== 'unknown') {
349
- return this.normalizeAgentName(event.agent);
350
- }
351
-
352
- if (event.name && event.name !== 'unknown') {
353
- return this.normalizeAgentName(event.name);
354
- }
355
-
356
- // Default fallback
357
- return 'Unknown';
358
- }
359
-
360
- /**
361
- * Process all events and build agent inference context
362
- * This tracks delegation boundaries and agent context throughout the session
363
- */
364
- processAgentInference() {
365
- const events = this.eventViewer.events;
366
-
367
- // Reset inference state
368
- this.state.currentDelegation = null;
369
- this.state.sessionAgents.clear();
370
- this.state.eventAgentMap.clear();
371
- this.state.pmDelegations.clear();
372
- this.state.agentToDelegation.clear();
373
- this.state.orphanSubagents.clear();
374
- this.state.subagentStartEvents.clear();
375
-
376
- console.log('Processing agent inference for', events.length, 'events');
377
-
378
- // Early return if no events
379
- if (!events || events.length === 0) {
380
- console.log('No events to process for agent inference');
381
- return;
382
- }
383
-
384
- // Process events chronologically to track delegation context
385
- events.forEach((event, index) => {
386
- let finalAgent; // Declare outside try-catch to ensure scope availability
387
-
388
- try {
389
- const inference = this.inferAgentFromEvent(event);
390
- const sessionId = event.session_id || event.data?.session_id || 'default';
391
-
392
- // Determine agent for this event based on context
393
- finalAgent = inference;
394
-
395
- // If we're in a delegation context and this event doesn't have high confidence agent info,
396
- // inherit from delegation context
397
- if (this.state.currentDelegation &&
398
- inference.confidence === 'default' &&
399
- sessionId === this.state.currentDelegation.sessionId) {
400
- finalAgent = {
401
- type: 'subagent',
402
- confidence: 'inherited',
403
- agentName: this.state.currentDelegation.agentName,
404
- reason: 'inherited from delegation context'
405
- };
406
- }
407
-
408
- // Track SubagentStart events for orphan detection
409
- const hookEventName = event.hook_event_name || event.data?.hook_event_name || '';
410
- const isSubagentStart = hookEventName === 'SubagentStart' ||
411
- event.type === 'hook.subagent_start' ||
412
- event.subtype === 'subagent_start';
413
-
414
- if (isSubagentStart && inference.type === 'subagent') {
415
- // Track this SubagentStart event
416
- if (!this.state.subagentStartEvents.has(inference.agentName)) {
417
- this.state.subagentStartEvents.set(inference.agentName, []);
418
- }
419
- this.state.subagentStartEvents.get(inference.agentName).push({
420
- eventIndex: index,
421
- event: event,
422
- timestamp: event.timestamp,
423
- sessionId: sessionId
424
- });
425
- }
426
-
427
- // Track delegation boundaries and PM delegations
428
- if (event.tool_name === 'Task' && inference.type === 'subagent') {
429
- // Start of subagent delegation - create PM delegation entry
430
- const delegationId = `pm_${sessionId}_${index}_${inference.agentName}`;
431
- const pmDelegation = {
432
- id: delegationId,
433
- agentName: inference.agentName,
434
- sessionId: sessionId,
435
- startIndex: index,
436
- endIndex: null,
437
- pmCall: event, // Store the PM call event
438
- timestamp: event.timestamp,
439
- agentEvents: [] // Collect all events from this agent
440
- };
441
-
442
- this.state.pmDelegations.set(delegationId, pmDelegation);
443
- this.state.agentToDelegation.set(inference.agentName, delegationId);
444
-
445
- this.state.currentDelegation = {
446
- agentName: inference.agentName,
447
- sessionId: sessionId,
448
- startIndex: index,
449
- endIndex: null,
450
- delegationId: delegationId
451
- };
452
- console.log('Delegation started:', this.state.currentDelegation);
453
- } else if (inference.confidence === 'definitive' && inference.reason === 'SubagentStop event') {
454
- // End of subagent delegation
455
- if (this.state.currentDelegation) {
456
- this.state.currentDelegation.endIndex = index;
457
-
458
- // Update PM delegation end point
459
- const pmDelegation = this.state.pmDelegations.get(this.state.currentDelegation.delegationId);
460
- if (pmDelegation) {
461
- pmDelegation.endIndex = index;
462
- }
463
-
464
- console.log('Delegation ended:', this.state.currentDelegation);
465
- this.state.currentDelegation = null;
466
- }
467
- }
468
-
469
- // Track events within PM delegation context
470
- if (this.state.currentDelegation && finalAgent.type === 'subagent') {
471
- const pmDelegation = this.state.pmDelegations.get(this.state.currentDelegation.delegationId);
472
- if (pmDelegation) {
473
- pmDelegation.agentEvents.push({
474
- eventIndex: index,
475
- event: event,
476
- inference: finalAgent
477
- });
478
- }
479
- }
480
-
481
- // Store the inference result
482
- this.state.eventAgentMap.set(index, finalAgent);
483
-
484
- // Update session agent tracking
485
- this.state.sessionAgents.set(sessionId, finalAgent);
486
-
487
- // Debug first few inferences
488
- if (index < 5) {
489
- console.log(`Event ${index} agent inference:`, {
490
- event_type: event.type || event.hook_event_name,
491
- subtype: event.subtype,
492
- tool_name: event.tool_name,
493
- inference: finalAgent,
494
- hasData: !!event.data,
495
- agentType: event.agent_type || event.data?.agent_type
496
- });
497
- }
498
- } catch (error) {
499
- console.error(`Error processing event ${index} for agent inference:`, error);
500
-
501
- // Set a default finalAgent if not already set due to error
502
- if (!finalAgent) {
503
- finalAgent = {
504
- type: 'main_agent',
505
- confidence: 'error',
506
- agentName: 'PM',
507
- reason: 'error during processing'
508
- };
509
- }
510
-
511
- // Store the default inference for this event
512
- this.state.eventAgentMap.set(index, finalAgent);
513
- }
514
- });
515
-
516
- // Identify orphan subagents after all events are processed
517
- this.identifyOrphanSubagents(events);
518
-
519
- console.log('Agent inference processing complete. Results:', {
520
- total_events: events.length,
521
- inferred_agents: this.state.eventAgentMap.size,
522
- unique_sessions: this.state.sessionAgents.size,
523
- pm_delegations: this.state.pmDelegations.size,
524
- agent_to_delegation_mappings: this.state.agentToDelegation.size,
525
- orphan_subagents: this.state.orphanSubagents.size
526
- });
527
- }
528
-
529
- /**
530
- * Get inferred agent for a specific event
531
- * @param {number} eventIndex - Index of event in events array
532
- * @returns {Object|null} - Agent inference result or null
533
- */
534
- getInferredAgent(eventIndex) {
535
- return this.state.eventAgentMap.get(eventIndex) || null;
536
- }
537
-
538
- /**
539
- * Get inferred agent for an event object
540
- * @param {Object} event - Event object
541
- * @returns {Object|null} - Agent inference result or null
542
- */
543
- getInferredAgentForEvent(event) {
544
- const events = this.eventViewer.events;
545
-
546
- // Try to find by exact reference first
547
- let eventIndex = events.indexOf(event);
548
-
549
- // If exact match fails, try to find by timestamp or session_id + timestamp
550
- if (eventIndex === -1 && event.timestamp) {
551
- eventIndex = events.findIndex(e =>
552
- e.timestamp === event.timestamp &&
553
- e.session_id === event.session_id
554
- );
555
- }
556
-
557
- // If we still can't find it, perform inline inference
558
- if (eventIndex === -1) {
559
- console.log('Agent inference: Could not find event in events array, performing inline inference');
560
- return this.inferAgentFromEvent(event);
561
- }
562
-
563
- // Get cached inference or perform new inference
564
- let inference = this.getInferredAgent(eventIndex);
565
- if (!inference) {
566
- inference = this.inferAgentFromEvent(event);
567
- // Cache the result
568
- this.state.eventAgentMap.set(eventIndex, inference);
569
- }
570
-
571
- return inference;
572
- }
573
-
574
- /**
575
- * Get current delegation context
576
- * @returns {Object|null} - Current delegation or null
577
- */
578
- getCurrentDelegation() {
579
- return this.state.currentDelegation;
580
- }
581
-
582
- /**
583
- * Get session agents map
584
- * @returns {Map} - Map of session IDs to agent contexts
585
- */
586
- getSessionAgents() {
587
- return this.state.sessionAgents;
588
- }
589
-
590
- /**
591
- * Get event agent map
592
- * @returns {Map} - Map of event indices to agent contexts
593
- */
594
- getEventAgentMap() {
595
- return this.state.eventAgentMap;
596
- }
597
-
598
- /**
599
- * Get PM delegations for unique instance views
600
- * @returns {Map} - Map of delegation IDs to PM delegation contexts
601
- */
602
- getPMDelegations() {
603
- return this.state.pmDelegations;
604
- }
605
-
606
- /**
607
- * Get agent to delegation mapping
608
- * @returns {Map} - Map of agent names to delegation IDs
609
- */
610
- getAgentToDelegationMap() {
611
- return this.state.agentToDelegation;
612
- }
613
-
614
- /**
615
- * Build hierarchical delegation tree structure
616
- * @returns {Object} Tree structure with PM nodes and subagent children
617
- */
618
- buildDelegationHierarchy() {
619
- // Get all PM delegations
620
- const pmDelegations = this.getPMDelegations();
621
- const events = this.eventViewer.events;
622
-
623
- // Build hierarchy tree
624
- const hierarchy = {
625
- mainPM: {
626
- type: 'pm',
627
- name: 'PM',
628
- delegations: [],
629
- ownEvents: [],
630
- totalEvents: 0
631
- },
632
- impliedPM: {
633
- type: 'pm_implied',
634
- name: 'Implied PM',
635
- delegations: [],
636
- ownEvents: [],
637
- totalEvents: 0
638
- }
639
- };
640
-
641
- // Process explicit PM delegations
642
- for (const [delegationId, delegation] of pmDelegations) {
643
- hierarchy.mainPM.delegations.push({
644
- id: delegationId,
645
- agentName: delegation.agentName,
646
- taskContext: this.extractTaskContext(delegation.pmCall),
647
- events: delegation.agentEvents,
648
- startTime: delegation.timestamp,
649
- endTime: delegation.endIndex ? events[delegation.endIndex]?.timestamp : null,
650
- status: delegation.endIndex ? 'completed' : 'active'
651
- });
652
- hierarchy.mainPM.totalEvents += delegation.agentEvents.length;
653
- }
654
-
655
- // Find PM's own events
656
- events.forEach((event, index) => {
657
- const inference = this.getInferredAgent(index);
658
- if (inference && inference.type === 'main_agent') {
659
- hierarchy.mainPM.ownEvents.push({
660
- eventIndex: index,
661
- event: event
662
- });
663
- hierarchy.mainPM.totalEvents++;
664
- }
665
- });
666
-
667
- // Find orphan subagent events
668
- const orphanEvents = new Map();
669
- events.forEach((event, index) => {
670
- const inference = this.getInferredAgent(index);
671
- if (inference && inference.type === 'subagent') {
672
- // Check if this is part of any PM delegation
673
- let isOrphan = true;
674
- for (const [_, delegation] of pmDelegations) {
675
- if (delegation.agentEvents.some(e => e.eventIndex === index)) {
676
- isOrphan = false;
677
- break;
678
- }
679
- }
680
-
681
- if (isOrphan) {
682
- const agentName = inference.agentName;
683
- if (!orphanEvents.has(agentName)) {
684
- orphanEvents.set(agentName, []);
685
- }
686
- orphanEvents.get(agentName).push({
687
- eventIndex: index,
688
- event: event,
689
- inference: inference
690
- });
691
- }
692
- }
693
- });
694
-
695
- // Add orphan agents as implied PM delegations
696
- for (const [agentName, agentEvents] of orphanEvents) {
697
- hierarchy.impliedPM.delegations.push({
698
- id: `implied_${agentName}`,
699
- agentName: agentName,
700
- taskContext: 'No explicit PM delegation',
701
- events: agentEvents,
702
- startTime: agentEvents[0].event.timestamp,
703
- endTime: agentEvents[agentEvents.length - 1].event.timestamp,
704
- status: 'completed'
705
- });
706
- hierarchy.impliedPM.totalEvents += agentEvents.length;
707
- }
708
-
709
- return hierarchy;
710
- }
711
-
712
- /**
713
- * Extract task context from PM call
714
- * @param {Object} pmCall - PM's Task tool call
715
- * @returns {string} Task description
716
- */
717
- extractTaskContext(pmCall) {
718
- if (!pmCall) return 'Unknown task';
719
-
720
- const params = pmCall.tool_parameters || pmCall.data?.tool_parameters || {};
721
- return params.task || params.request || params.description || 'Task delegation';
722
- }
723
-
724
- /**
725
- * Identify orphan subagents (SubagentStart without PM Task delegation)
726
- * @param {Array} events - All events to analyze
727
- */
728
- identifyOrphanSubagents(events) {
729
- const ORPHAN_TIME_WINDOW = 5000; // 5 seconds to group orphans together
730
-
731
- // Check each SubagentStart event
732
- for (const [agentName, startEvents] of this.state.subagentStartEvents) {
733
- for (const startEvent of startEvents) {
734
- const eventIndex = startEvent.eventIndex;
735
- const timestamp = new Date(startEvent.timestamp).getTime();
736
-
737
- // Check if this SubagentStart has a corresponding PM Task delegation
738
- let hasTaskDelegation = false;
739
-
740
- // Look for a Task tool call within a reasonable time window before this SubagentStart
741
- for (let i = Math.max(0, eventIndex - 20); i < eventIndex; i++) {
742
- const prevEvent = events[i];
743
- if (!prevEvent) continue;
744
-
745
- const prevTimestamp = new Date(prevEvent.timestamp).getTime();
746
- const timeDiff = timestamp - prevTimestamp;
747
-
748
- // Check if this is a Task tool call within 10 seconds
749
- if (prevEvent.tool_name === 'Task' && timeDiff >= 0 && timeDiff < 10000) {
750
- const inference = this.state.eventAgentMap.get(i);
751
- if (inference && inference.agentName === agentName) {
752
- hasTaskDelegation = true;
753
- break;
754
- }
755
- }
756
- }
757
-
758
- // If no Task delegation found, mark as orphan
759
- if (!hasTaskDelegation) {
760
- this.state.orphanSubagents.set(eventIndex, {
761
- agentName: agentName,
762
- timestamp: startEvent.timestamp,
763
- sessionId: startEvent.sessionId,
764
- event: startEvent.event,
765
- groupingKey: null // Will be set by grouping logic
766
- });
767
- }
768
- }
769
- }
770
-
771
- // Group orphan subagents by time proximity or session
772
- this.groupOrphanSubagents(ORPHAN_TIME_WINDOW);
773
- }
774
-
775
- /**
776
- * Group orphan subagents that occur close together in time or same session
777
- * @param {number} timeWindow - Time window in milliseconds for grouping
778
- */
779
- groupOrphanSubagents(timeWindow) {
780
- const orphansList = Array.from(this.state.orphanSubagents.values())
781
- .sort((a, b) => new Date(a.timestamp) - new Date(b.timestamp));
782
-
783
- let currentGroup = null;
784
- let lastTimestamp = null;
785
-
786
- for (const orphan of orphansList) {
787
- const timestamp = new Date(orphan.timestamp).getTime();
788
-
789
- // Check if this orphan should be in the same group
790
- if (!currentGroup ||
791
- (lastTimestamp && timestamp - lastTimestamp > timeWindow)) {
792
- // Start a new group
793
- currentGroup = `implied_pm_${orphan.sessionId}_${timestamp}`;
794
- }
795
-
796
- orphan.groupingKey = currentGroup;
797
- lastTimestamp = timestamp;
798
- }
799
- }
800
-
801
- /**
802
- * Check if a subagent event is an orphan (no PM Task delegation)
803
- * @param {number} eventIndex - Index of the event
804
- * @returns {boolean} True if the event is from an orphan subagent
805
- */
806
- isOrphanSubagent(eventIndex) {
807
- return this.state.orphanSubagents.has(eventIndex);
808
- }
809
-
810
- /**
811
- * Get orphan subagent context for an event
812
- * @param {number} eventIndex - Index of the event
813
- * @returns {Object|null} Orphan context or null
814
- */
815
- getOrphanContext(eventIndex) {
816
- return this.state.orphanSubagents.get(eventIndex) || null;
817
- }
818
-
819
- /**
820
- * Get all orphan subagent groups
821
- * @returns {Map} Map of groupingKey -> array of orphan contexts
822
- */
823
- getOrphanGroups() {
824
- const groups = new Map();
825
-
826
- for (const orphan of this.state.orphanSubagents.values()) {
827
- const key = orphan.groupingKey;
828
- if (!groups.has(key)) {
829
- groups.set(key, []);
830
- }
831
- groups.get(key).push(orphan);
832
- }
833
-
834
- return groups;
835
- }
836
-
837
- /**
838
- * Get unique agent instances (one per agent type, consolidating multiple delegations)
839
- * This is used for the unique instance view in the agents tab
840
- * @returns {Array} - Array of unique agent instances
841
- */
842
- getUniqueAgentInstances() {
843
- const agentMap = new Map(); // agentName -> consolidated data
844
-
845
- // Consolidate all PM delegations by agent name
846
- for (const [delegationId, delegation] of this.state.pmDelegations) {
847
- const agentName = delegation.agentName;
848
-
849
- if (!agentMap.has(agentName)) {
850
- // First delegation for this agent type
851
- agentMap.set(agentName, {
852
- id: `consolidated_${agentName}`,
853
- type: 'consolidated_agent',
854
- agentName: agentName,
855
- delegations: [], // Array of all delegations
856
- pmCalls: [], // Array of all PM calls
857
- allEvents: [], // Combined events from all delegations
858
- firstTimestamp: delegation.timestamp,
859
- lastTimestamp: delegation.timestamp,
860
- totalEventCount: delegation.agentEvents.length,
861
- delegationCount: 1
862
- });
863
- }
864
-
865
- // Add this delegation to the consolidated agent
866
- const agent = agentMap.get(agentName);
867
- agent.delegations.push({
868
- id: delegationId,
869
- pmCall: delegation.pmCall,
870
- timestamp: delegation.timestamp,
871
- eventCount: delegation.agentEvents.length,
872
- startIndex: delegation.startIndex,
873
- endIndex: delegation.endIndex,
874
- events: delegation.agentEvents
875
- });
876
-
877
- if (delegation.pmCall) {
878
- agent.pmCalls.push(delegation.pmCall);
879
- }
880
-
881
- // Merge events from all delegations
882
- agent.allEvents = agent.allEvents.concat(delegation.agentEvents);
883
-
884
- // Update consolidated metadata
885
- if (new Date(delegation.timestamp) < new Date(agent.firstTimestamp)) {
886
- agent.firstTimestamp = delegation.timestamp;
887
- }
888
- if (new Date(delegation.timestamp) > new Date(agent.lastTimestamp)) {
889
- agent.lastTimestamp = delegation.timestamp;
890
- }
891
-
892
- agent.totalEventCount += delegation.agentEvents.length;
893
- agent.delegationCount++;
894
- }
895
-
896
- // Handle agents that appear without explicit PM delegation (implied PM)
897
- const events = this.eventViewer.events;
898
- for (let index = 0; index < events.length; index++) {
899
- const inference = this.getInferredAgent(index);
900
- if (inference && inference.type === 'subagent' && !agentMap.has(inference.agentName)) {
901
- // Create consolidated agent for implied delegation
902
- agentMap.set(inference.agentName, {
903
- id: `consolidated_${inference.agentName}`,
904
- type: 'consolidated_agent',
905
- agentName: inference.agentName,
906
- delegations: [{
907
- id: `implied_pm_${inference.agentName}_${index}`,
908
- pmCall: null,
909
- timestamp: events[index].timestamp,
910
- eventCount: 1,
911
- startIndex: index,
912
- endIndex: null,
913
- events: [{
914
- eventIndex: index,
915
- event: events[index],
916
- inference: inference
917
- }]
918
- }],
919
- pmCalls: [],
920
- allEvents: [{
921
- eventIndex: index,
922
- event: events[index],
923
- inference: inference
924
- }],
925
- firstTimestamp: events[index].timestamp,
926
- lastTimestamp: events[index].timestamp,
927
- totalEventCount: 1,
928
- delegationCount: 1,
929
- isImplied: true
930
- });
931
- }
932
- }
933
-
934
- // Convert map to array and sort by first appearance (timestamp)
935
- const uniqueInstances = Array.from(agentMap.values())
936
- .sort((a, b) => new Date(a.firstTimestamp) - new Date(b.firstTimestamp));
937
-
938
- console.log('Consolidated unique agents:', {
939
- total_unique_agents: uniqueInstances.length,
940
- agents: uniqueInstances.map(agent => ({
941
- name: agent.agentName,
942
- delegations: agent.delegationCount,
943
- totalEvents: agent.totalEventCount
944
- }))
945
- });
946
-
947
- return uniqueInstances;
948
- }
949
- }
950
-
951
- // ES6 Module export
952
- export { AgentInference };
953
- export default AgentInference;
954
-
955
- // Make AgentInference globally available for dist/dashboard.js
956
- window.AgentInference = AgentInference;