claude-mpm 5.0.9__py3-none-any.whl → 5.6.23__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 (614) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/__init__.py +4 -0
  3. claude_mpm/agents/BASE_AGENT.md +164 -0
  4. claude_mpm/agents/CLAUDE_MPM_OUTPUT_STYLE.md +115 -0
  5. claude_mpm/agents/CLAUDE_MPM_RESEARCH_OUTPUT_STYLE.md +413 -0
  6. claude_mpm/agents/CLAUDE_MPM_TEACHER_OUTPUT_STYLE.md +186 -0
  7. claude_mpm/agents/MEMORY.md +1 -1
  8. claude_mpm/agents/PM_INSTRUCTIONS.md +479 -616
  9. claude_mpm/agents/WORKFLOW.md +6 -253
  10. claude_mpm/agents/agent_loader.py +13 -44
  11. claude_mpm/agents/base_agent.json +1 -1
  12. claude_mpm/agents/frontmatter_validator.py +70 -2
  13. claude_mpm/agents/templates/circuit-breakers.md +457 -62
  14. claude_mpm/cli/__init__.py +5 -2
  15. claude_mpm/cli/__main__.py +4 -0
  16. claude_mpm/cli/chrome_devtools_installer.py +175 -0
  17. claude_mpm/cli/commands/agent_state_manager.py +18 -27
  18. claude_mpm/cli/commands/agents.py +177 -41
  19. claude_mpm/cli/commands/agents_reconcile.py +197 -0
  20. claude_mpm/cli/commands/auto_configure.py +723 -236
  21. claude_mpm/cli/commands/autotodos.py +566 -0
  22. claude_mpm/cli/commands/commander.py +216 -0
  23. claude_mpm/cli/commands/config.py +88 -2
  24. claude_mpm/cli/commands/configure.py +1874 -170
  25. claude_mpm/cli/commands/configure_agent_display.py +27 -6
  26. claude_mpm/cli/commands/hook_errors.py +60 -60
  27. claude_mpm/cli/commands/monitor.py +2 -2
  28. claude_mpm/cli/commands/mpm_init/core.py +232 -46
  29. claude_mpm/cli/commands/mpm_init/knowledge_extractor.py +481 -0
  30. claude_mpm/cli/commands/mpm_init/prompts.py +280 -0
  31. claude_mpm/cli/commands/postmortem.py +1 -1
  32. claude_mpm/cli/commands/profile.py +276 -0
  33. claude_mpm/cli/commands/run.py +35 -3
  34. claude_mpm/cli/commands/skill_source.py +51 -2
  35. claude_mpm/cli/commands/skills.py +379 -204
  36. claude_mpm/cli/commands/summarize.py +413 -0
  37. claude_mpm/cli/executor.py +141 -19
  38. claude_mpm/cli/interactive/__init__.py +10 -0
  39. claude_mpm/cli/interactive/agent_wizard.py +115 -60
  40. claude_mpm/cli/interactive/questionary_styles.py +65 -0
  41. claude_mpm/cli/interactive/skill_selector.py +481 -0
  42. claude_mpm/cli/parsers/agents_parser.py +54 -9
  43. claude_mpm/cli/parsers/auto_configure_parser.py +13 -138
  44. claude_mpm/cli/parsers/base_parser.py +88 -1
  45. claude_mpm/cli/parsers/commander_parser.py +116 -0
  46. claude_mpm/cli/parsers/config_parser.py +153 -83
  47. claude_mpm/cli/parsers/profile_parser.py +147 -0
  48. claude_mpm/cli/parsers/run_parser.py +10 -0
  49. claude_mpm/cli/parsers/skill_source_parser.py +4 -0
  50. claude_mpm/cli/parsers/skills_parser.py +1 -1
  51. claude_mpm/cli/startup.py +1017 -266
  52. claude_mpm/cli/startup_display.py +74 -6
  53. claude_mpm/cli/startup_logging.py +2 -2
  54. claude_mpm/cli/utils.py +7 -3
  55. claude_mpm/commander/__init__.py +78 -0
  56. claude_mpm/commander/adapters/__init__.py +60 -0
  57. claude_mpm/commander/adapters/auggie.py +260 -0
  58. claude_mpm/commander/adapters/base.py +288 -0
  59. claude_mpm/commander/adapters/claude_code.py +392 -0
  60. claude_mpm/commander/adapters/codex.py +237 -0
  61. claude_mpm/commander/adapters/communication.py +366 -0
  62. claude_mpm/commander/adapters/example_usage.py +310 -0
  63. claude_mpm/commander/adapters/mpm.py +389 -0
  64. claude_mpm/commander/adapters/registry.py +204 -0
  65. claude_mpm/commander/api/__init__.py +16 -0
  66. claude_mpm/commander/api/app.py +121 -0
  67. claude_mpm/commander/api/errors.py +133 -0
  68. claude_mpm/commander/api/routes/__init__.py +8 -0
  69. claude_mpm/commander/api/routes/events.py +184 -0
  70. claude_mpm/commander/api/routes/inbox.py +171 -0
  71. claude_mpm/commander/api/routes/messages.py +148 -0
  72. claude_mpm/commander/api/routes/projects.py +271 -0
  73. claude_mpm/commander/api/routes/sessions.py +226 -0
  74. claude_mpm/commander/api/routes/work.py +296 -0
  75. claude_mpm/commander/api/schemas.py +186 -0
  76. claude_mpm/commander/chat/__init__.py +7 -0
  77. claude_mpm/commander/chat/cli.py +146 -0
  78. claude_mpm/commander/chat/commands.py +96 -0
  79. claude_mpm/commander/chat/repl.py +310 -0
  80. claude_mpm/commander/config.py +51 -0
  81. claude_mpm/commander/config_loader.py +115 -0
  82. claude_mpm/commander/core/__init__.py +10 -0
  83. claude_mpm/commander/core/block_manager.py +325 -0
  84. claude_mpm/commander/core/response_manager.py +323 -0
  85. claude_mpm/commander/daemon.py +603 -0
  86. claude_mpm/commander/env_loader.py +59 -0
  87. claude_mpm/commander/events/__init__.py +26 -0
  88. claude_mpm/commander/events/manager.py +332 -0
  89. claude_mpm/commander/frameworks/__init__.py +12 -0
  90. claude_mpm/commander/frameworks/base.py +146 -0
  91. claude_mpm/commander/frameworks/claude_code.py +58 -0
  92. claude_mpm/commander/frameworks/mpm.py +62 -0
  93. claude_mpm/commander/inbox/__init__.py +16 -0
  94. claude_mpm/commander/inbox/dedup.py +128 -0
  95. claude_mpm/commander/inbox/inbox.py +224 -0
  96. claude_mpm/commander/inbox/models.py +70 -0
  97. claude_mpm/commander/instance_manager.py +450 -0
  98. claude_mpm/commander/llm/__init__.py +6 -0
  99. claude_mpm/commander/llm/openrouter_client.py +167 -0
  100. claude_mpm/commander/llm/summarizer.py +70 -0
  101. claude_mpm/commander/memory/__init__.py +45 -0
  102. claude_mpm/commander/memory/compression.py +347 -0
  103. claude_mpm/commander/memory/embeddings.py +230 -0
  104. claude_mpm/commander/memory/entities.py +310 -0
  105. claude_mpm/commander/memory/example_usage.py +290 -0
  106. claude_mpm/commander/memory/integration.py +325 -0
  107. claude_mpm/commander/memory/search.py +381 -0
  108. claude_mpm/commander/memory/store.py +657 -0
  109. claude_mpm/commander/models/__init__.py +18 -0
  110. claude_mpm/commander/models/events.py +121 -0
  111. claude_mpm/commander/models/project.py +162 -0
  112. claude_mpm/commander/models/work.py +214 -0
  113. claude_mpm/commander/parsing/__init__.py +20 -0
  114. claude_mpm/commander/parsing/extractor.py +132 -0
  115. claude_mpm/commander/parsing/output_parser.py +270 -0
  116. claude_mpm/commander/parsing/patterns.py +100 -0
  117. claude_mpm/commander/persistence/__init__.py +11 -0
  118. claude_mpm/commander/persistence/event_store.py +274 -0
  119. claude_mpm/commander/persistence/state_store.py +309 -0
  120. claude_mpm/commander/persistence/work_store.py +164 -0
  121. claude_mpm/commander/polling/__init__.py +13 -0
  122. claude_mpm/commander/polling/event_detector.py +104 -0
  123. claude_mpm/commander/polling/output_buffer.py +49 -0
  124. claude_mpm/commander/polling/output_poller.py +153 -0
  125. claude_mpm/commander/project_session.py +268 -0
  126. claude_mpm/commander/proxy/__init__.py +12 -0
  127. claude_mpm/commander/proxy/formatter.py +89 -0
  128. claude_mpm/commander/proxy/output_handler.py +191 -0
  129. claude_mpm/commander/proxy/relay.py +155 -0
  130. claude_mpm/commander/registry.py +410 -0
  131. claude_mpm/commander/runtime/__init__.py +10 -0
  132. claude_mpm/commander/runtime/executor.py +191 -0
  133. claude_mpm/commander/runtime/monitor.py +346 -0
  134. claude_mpm/commander/session/__init__.py +6 -0
  135. claude_mpm/commander/session/context.py +81 -0
  136. claude_mpm/commander/session/manager.py +59 -0
  137. claude_mpm/commander/tmux_orchestrator.py +361 -0
  138. claude_mpm/commander/web/__init__.py +1 -0
  139. claude_mpm/commander/work/__init__.py +30 -0
  140. claude_mpm/commander/work/executor.py +207 -0
  141. claude_mpm/commander/work/queue.py +405 -0
  142. claude_mpm/commander/workflow/__init__.py +27 -0
  143. claude_mpm/commander/workflow/event_handler.py +241 -0
  144. claude_mpm/commander/workflow/notifier.py +146 -0
  145. claude_mpm/commands/mpm-config.md +36 -0
  146. claude_mpm/commands/mpm-doctor.md +16 -21
  147. claude_mpm/commands/mpm-help.md +12 -286
  148. claude_mpm/commands/mpm-init.md +88 -506
  149. claude_mpm/commands/mpm-monitor.md +22 -401
  150. claude_mpm/commands/mpm-organize.md +128 -0
  151. claude_mpm/commands/mpm-postmortem.md +13 -107
  152. claude_mpm/commands/mpm-session-resume.md +20 -363
  153. claude_mpm/commands/mpm-status.md +13 -69
  154. claude_mpm/commands/mpm-ticket-view.md +60 -495
  155. claude_mpm/commands/mpm-version.md +13 -107
  156. claude_mpm/commands/mpm.md +8 -0
  157. claude_mpm/config/agent_presets.py +8 -7
  158. claude_mpm/config/agent_sources.py +27 -0
  159. claude_mpm/config/skill_sources.py +16 -0
  160. claude_mpm/constants.py +1 -0
  161. claude_mpm/core/claude_runner.py +154 -2
  162. claude_mpm/core/config.py +37 -26
  163. claude_mpm/core/config_constants.py +74 -9
  164. claude_mpm/core/constants.py +56 -12
  165. claude_mpm/core/framework/formatters/content_formatter.py +3 -13
  166. claude_mpm/core/framework/loaders/agent_loader.py +8 -5
  167. claude_mpm/core/framework/loaders/instruction_loader.py +52 -11
  168. claude_mpm/core/framework_loader.py +4 -2
  169. claude_mpm/core/hook_manager.py +51 -3
  170. claude_mpm/core/interactive_session.py +12 -11
  171. claude_mpm/core/logger.py +39 -9
  172. claude_mpm/core/logging_utils.py +35 -11
  173. claude_mpm/core/network_config.py +148 -0
  174. claude_mpm/core/oneshot_session.py +7 -6
  175. claude_mpm/core/optimized_startup.py +61 -0
  176. claude_mpm/core/output_style_manager.py +219 -44
  177. claude_mpm/core/shared/config_loader.py +3 -1
  178. claude_mpm/core/socketio_pool.py +16 -8
  179. claude_mpm/core/unified_agent_registry.py +134 -16
  180. claude_mpm/core/unified_config.py +76 -8
  181. claude_mpm/core/unified_paths.py +95 -90
  182. claude_mpm/dashboard/static/svelte-build/_app/env.js +1 -0
  183. claude_mpm/dashboard/static/svelte-build/_app/immutable/assets/0.C33zOoyM.css +1 -0
  184. claude_mpm/dashboard/static/svelte-build/_app/immutable/assets/2.CW1J-YuA.css +1 -0
  185. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/1WZnGYqX.js +24 -0
  186. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/67pF3qNn.js +1 -0
  187. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/6RxdMKe4.js +1 -0
  188. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/8cZrfX0h.js +60 -0
  189. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/9a6T2nm-.js +7 -0
  190. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/B443AUzu.js +1 -0
  191. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/B8AwtY2H.js +1 -0
  192. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BF15LAsF.js +1 -0
  193. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BQaXIfA_.js +331 -0
  194. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BRcwIQNr.js +4 -0
  195. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BSNlmTZj.js +1 -0
  196. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BV6nKitt.js +43 -0
  197. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BViJ8lZt.js +128 -0
  198. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BcQ-Q0FE.js +1 -0
  199. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/Bpyvgze_.js +30 -0
  200. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BzTRqg-z.js +1 -0
  201. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/C0Fr8dve.js +1 -0
  202. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/C3rbW_a-.js +1 -0
  203. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/C8WYN38h.js +1 -0
  204. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/C9I8FlXH.js +61 -0
  205. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CIQcWgO2.js +36 -0
  206. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CIctN7YN.js +7 -0
  207. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CKrS_JZW.js +145 -0
  208. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CR6P9C4A.js +89 -0
  209. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CRRR9MD_.js +2 -0
  210. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CRcR2DqT.js +334 -0
  211. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CSXtMOf0.js +1 -0
  212. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CT-sbxSk.js +1 -0
  213. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CWm6DJsp.js +1 -0
  214. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CmKTTxBW.js +1 -0
  215. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CpqQ1Kzn.js +1 -0
  216. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/Cu_Erd72.js +261 -0
  217. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/D2nGpDRe.js +1 -0
  218. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/D9iCMida.js +267 -0
  219. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/D9ykgMoY.js +10 -0
  220. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DL2Ldur1.js +1 -0
  221. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DPfltzjH.js +165 -0
  222. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DR8nis88.js +2 -0
  223. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DUliQN2b.js +1 -0
  224. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DVp1hx9R.js +1 -0
  225. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DXlhR01x.js +122 -0
  226. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/D_lyTybS.js +1 -0
  227. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DngoTTgh.js +1 -0
  228. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DqkmHtDC.js +220 -0
  229. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DsDh8EYs.js +1 -0
  230. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DypDmXgd.js +139 -0
  231. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/Gi6I4Gst.js +1 -0
  232. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/IPYC-LnN.js +162 -0
  233. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/JTLiF7dt.js +24 -0
  234. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/JpevfAFt.js +68 -0
  235. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/NqQ1dWOy.js +1 -0
  236. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/R8CEIRAd.js +2 -0
  237. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/Zxy7qc-l.js +64 -0
  238. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/q9Hm6zAU.js +1 -0
  239. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/qtd3IeO4.js +15 -0
  240. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/ulBFON_C.js +65 -0
  241. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/wQVh1CoA.js +10 -0
  242. claude_mpm/dashboard/static/svelte-build/_app/immutable/entry/app.Dr7t0z2J.js +2 -0
  243. claude_mpm/dashboard/static/svelte-build/_app/immutable/entry/start.BGhZHUS3.js +1 -0
  244. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/0.RgBboRvH.js +1 -0
  245. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/1.DG-KkbDf.js +1 -0
  246. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/2.D_jnf-x6.js +1 -0
  247. claude_mpm/dashboard/static/svelte-build/_app/version.json +1 -0
  248. claude_mpm/dashboard/static/svelte-build/favicon.svg +7 -0
  249. claude_mpm/dashboard/static/svelte-build/index.html +36 -0
  250. claude_mpm/dashboard-svelte/node_modules/katex/src/fonts/generate_fonts.py +58 -0
  251. claude_mpm/dashboard-svelte/node_modules/katex/src/metrics/extract_tfms.py +114 -0
  252. claude_mpm/dashboard-svelte/node_modules/katex/src/metrics/extract_ttfs.py +122 -0
  253. claude_mpm/dashboard-svelte/node_modules/katex/src/metrics/format_json.py +28 -0
  254. claude_mpm/dashboard-svelte/node_modules/katex/src/metrics/parse_tfm.py +211 -0
  255. claude_mpm/experimental/cli_enhancements.py +2 -1
  256. claude_mpm/hooks/claude_hooks/INTEGRATION_EXAMPLE.md +243 -0
  257. claude_mpm/hooks/claude_hooks/README_AUTO_PAUSE.md +403 -0
  258. claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-311.pyc +0 -0
  259. claude_mpm/hooks/claude_hooks/__pycache__/auto_pause_handler.cpython-311.pyc +0 -0
  260. claude_mpm/hooks/claude_hooks/__pycache__/correlation_manager.cpython-311.pyc +0 -0
  261. claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-311.pyc +0 -0
  262. claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-311.pyc +0 -0
  263. claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-311.pyc +0 -0
  264. claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-311.pyc +0 -0
  265. claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-311.pyc +0 -0
  266. claude_mpm/hooks/claude_hooks/auto_pause_handler.py +485 -0
  267. claude_mpm/hooks/claude_hooks/correlation_manager.py +60 -0
  268. claude_mpm/hooks/claude_hooks/event_handlers.py +479 -128
  269. claude_mpm/hooks/claude_hooks/hook_handler.py +254 -83
  270. claude_mpm/hooks/claude_hooks/hook_wrapper.sh +6 -11
  271. claude_mpm/hooks/claude_hooks/installer.py +149 -18
  272. claude_mpm/hooks/claude_hooks/memory_integration.py +67 -19
  273. claude_mpm/hooks/claude_hooks/response_tracking.py +44 -62
  274. claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-311.pyc +0 -0
  275. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-311.pyc +0 -0
  276. claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-311.pyc +0 -0
  277. claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-311.pyc +0 -0
  278. claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-311.pyc +0 -0
  279. claude_mpm/hooks/claude_hooks/services/connection_manager.py +69 -30
  280. claude_mpm/hooks/claude_hooks/services/connection_manager_http.py +36 -103
  281. claude_mpm/hooks/claude_hooks/services/state_manager.py +23 -36
  282. claude_mpm/hooks/claude_hooks/services/subagent_processor.py +73 -75
  283. claude_mpm/hooks/kuzu_memory_hook.py +5 -5
  284. claude_mpm/hooks/memory_integration_hook.py +46 -1
  285. claude_mpm/hooks/session_resume_hook.py +89 -1
  286. claude_mpm/hooks/templates/pre_tool_use_template.py +10 -2
  287. claude_mpm/init.py +276 -19
  288. claude_mpm/models/agent_definition.py +7 -0
  289. claude_mpm/models/git_repository.py +3 -3
  290. claude_mpm/scripts/claude-hook-handler.sh +87 -20
  291. claude_mpm/scripts/launch_monitor.py +93 -13
  292. claude_mpm/scripts/start_activity_logging.py +0 -0
  293. claude_mpm/services/agents/agent_builder.py +3 -3
  294. claude_mpm/services/agents/agent_recommendation_service.py +278 -0
  295. claude_mpm/services/agents/agent_review_service.py +280 -0
  296. claude_mpm/services/agents/agent_selection_service.py +2 -2
  297. claude_mpm/services/agents/cache_git_manager.py +7 -7
  298. claude_mpm/services/agents/deployment/agent_deployment.py +29 -7
  299. claude_mpm/services/agents/deployment/agent_discovery_service.py +6 -5
  300. claude_mpm/services/agents/deployment/agent_format_converter.py +25 -13
  301. claude_mpm/services/agents/deployment/agent_template_builder.py +42 -20
  302. claude_mpm/services/agents/deployment/agents_directory_resolver.py +2 -2
  303. claude_mpm/services/agents/deployment/async_agent_deployment.py +31 -27
  304. claude_mpm/services/agents/deployment/deployment_reconciler.py +577 -0
  305. claude_mpm/services/agents/deployment/local_template_deployment.py +3 -1
  306. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +348 -29
  307. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +570 -68
  308. claude_mpm/services/agents/deployment/startup_reconciliation.py +138 -0
  309. claude_mpm/services/agents/git_source_manager.py +57 -4
  310. claude_mpm/services/agents/loading/base_agent_manager.py +1 -13
  311. claude_mpm/services/agents/loading/framework_agent_loader.py +75 -2
  312. claude_mpm/services/agents/recommender.py +5 -3
  313. claude_mpm/services/agents/single_tier_deployment_service.py +6 -6
  314. claude_mpm/services/agents/sources/git_source_sync_service.py +129 -11
  315. claude_mpm/services/agents/startup_sync.py +27 -4
  316. claude_mpm/services/agents/toolchain_detector.py +10 -6
  317. claude_mpm/services/analysis/__init__.py +11 -1
  318. claude_mpm/services/analysis/clone_detector.py +1030 -0
  319. claude_mpm/services/cli/__init__.py +3 -0
  320. claude_mpm/services/cli/incremental_pause_manager.py +561 -0
  321. claude_mpm/services/cli/session_resume_helper.py +10 -2
  322. claude_mpm/services/command_deployment_service.py +81 -10
  323. claude_mpm/services/delegation_detector.py +175 -0
  324. claude_mpm/services/diagnostics/checks/agent_check.py +2 -2
  325. claude_mpm/services/diagnostics/checks/agent_sources_check.py +31 -1
  326. claude_mpm/services/diagnostics/checks/configuration_check.py +24 -0
  327. claude_mpm/services/diagnostics/checks/installation_check.py +22 -0
  328. claude_mpm/services/diagnostics/checks/mcp_services_check.py +23 -0
  329. claude_mpm/services/diagnostics/doctor_reporter.py +31 -1
  330. claude_mpm/services/diagnostics/models.py +14 -1
  331. claude_mpm/services/event_bus/config.py +3 -1
  332. claude_mpm/services/event_log.py +325 -0
  333. claude_mpm/services/git/git_operations_service.py +101 -16
  334. claude_mpm/services/infrastructure/__init__.py +4 -0
  335. claude_mpm/services/infrastructure/context_usage_tracker.py +291 -0
  336. claude_mpm/services/infrastructure/resume_log_generator.py +24 -5
  337. claude_mpm/services/monitor/daemon.py +9 -2
  338. claude_mpm/services/monitor/daemon_manager.py +54 -7
  339. claude_mpm/services/monitor/management/lifecycle.py +15 -3
  340. claude_mpm/services/monitor/server.py +796 -30
  341. claude_mpm/services/pm_skills_deployer.py +884 -0
  342. claude_mpm/services/profile_manager.py +337 -0
  343. claude_mpm/services/project/project_organizer.py +4 -0
  344. claude_mpm/services/self_upgrade_service.py +120 -12
  345. claude_mpm/services/skills/__init__.py +3 -0
  346. claude_mpm/services/skills/git_skill_source_manager.py +303 -12
  347. claude_mpm/services/skills/selective_skill_deployer.py +869 -0
  348. claude_mpm/services/skills/skill_discovery_service.py +74 -4
  349. claude_mpm/services/skills/skill_to_agent_mapper.py +406 -0
  350. claude_mpm/services/skills_deployer.py +294 -55
  351. claude_mpm/services/socketio/dashboard_server.py +1 -0
  352. claude_mpm/services/socketio/event_normalizer.py +51 -6
  353. claude_mpm/services/socketio/handlers/hook.py +14 -7
  354. claude_mpm/services/socketio/server/core.py +386 -108
  355. claude_mpm/services/socketio/server/main.py +12 -4
  356. claude_mpm/services/version_control/git_operations.py +103 -0
  357. claude_mpm/skills/__init__.py +2 -1
  358. claude_mpm/skills/bundled/collaboration/brainstorming/SKILL.md +79 -0
  359. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/SKILL.md +178 -0
  360. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/agent-prompts.md +577 -0
  361. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/coordination-patterns.md +467 -0
  362. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/examples.md +537 -0
  363. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/troubleshooting.md +730 -0
  364. claude_mpm/skills/bundled/collaboration/git-worktrees.md +317 -0
  365. claude_mpm/skills/bundled/collaboration/requesting-code-review/SKILL.md +112 -0
  366. claude_mpm/skills/bundled/collaboration/requesting-code-review/references/code-reviewer-template.md +146 -0
  367. claude_mpm/skills/bundled/collaboration/requesting-code-review/references/review-examples.md +412 -0
  368. claude_mpm/skills/bundled/collaboration/stacked-prs.md +251 -0
  369. claude_mpm/skills/bundled/collaboration/writing-plans/SKILL.md +81 -0
  370. claude_mpm/skills/bundled/collaboration/writing-plans/references/best-practices.md +362 -0
  371. claude_mpm/skills/bundled/collaboration/writing-plans/references/plan-structure-templates.md +312 -0
  372. claude_mpm/skills/bundled/debugging/root-cause-tracing/SKILL.md +152 -0
  373. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/advanced-techniques.md +668 -0
  374. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/examples.md +587 -0
  375. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/integration.md +438 -0
  376. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/tracing-techniques.md +391 -0
  377. claude_mpm/skills/bundled/debugging/systematic-debugging/CREATION-LOG.md +119 -0
  378. claude_mpm/skills/bundled/debugging/systematic-debugging/SKILL.md +148 -0
  379. claude_mpm/skills/bundled/debugging/systematic-debugging/references/anti-patterns.md +483 -0
  380. claude_mpm/skills/bundled/debugging/systematic-debugging/references/examples.md +452 -0
  381. claude_mpm/skills/bundled/debugging/systematic-debugging/references/troubleshooting.md +449 -0
  382. claude_mpm/skills/bundled/debugging/systematic-debugging/references/workflow.md +411 -0
  383. claude_mpm/skills/bundled/debugging/systematic-debugging/test-academic.md +14 -0
  384. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-1.md +58 -0
  385. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-2.md +68 -0
  386. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-3.md +69 -0
  387. claude_mpm/skills/bundled/debugging/verification-before-completion/SKILL.md +131 -0
  388. claude_mpm/skills/bundled/debugging/verification-before-completion/references/gate-function.md +325 -0
  389. claude_mpm/skills/bundled/debugging/verification-before-completion/references/integration-and-workflows.md +490 -0
  390. claude_mpm/skills/bundled/debugging/verification-before-completion/references/red-flags-and-failures.md +425 -0
  391. claude_mpm/skills/bundled/debugging/verification-before-completion/references/verification-patterns.md +499 -0
  392. claude_mpm/skills/bundled/infrastructure/env-manager/INTEGRATION.md +611 -0
  393. claude_mpm/skills/bundled/infrastructure/env-manager/README.md +596 -0
  394. claude_mpm/skills/bundled/infrastructure/env-manager/SKILL.md +260 -0
  395. claude_mpm/skills/bundled/infrastructure/env-manager/examples/nextjs-env-structure.md +315 -0
  396. claude_mpm/skills/bundled/infrastructure/env-manager/references/frameworks.md +436 -0
  397. claude_mpm/skills/bundled/infrastructure/env-manager/references/security.md +433 -0
  398. claude_mpm/skills/bundled/infrastructure/env-manager/references/synchronization.md +452 -0
  399. claude_mpm/skills/bundled/infrastructure/env-manager/references/troubleshooting.md +404 -0
  400. claude_mpm/skills/bundled/infrastructure/env-manager/references/validation.md +420 -0
  401. claude_mpm/skills/bundled/main/artifacts-builder/SKILL.md +86 -0
  402. claude_mpm/skills/bundled/main/internal-comms/SKILL.md +43 -0
  403. claude_mpm/skills/bundled/main/internal-comms/examples/3p-updates.md +47 -0
  404. claude_mpm/skills/bundled/main/internal-comms/examples/company-newsletter.md +65 -0
  405. claude_mpm/skills/bundled/main/internal-comms/examples/faq-answers.md +30 -0
  406. claude_mpm/skills/bundled/main/internal-comms/examples/general-comms.md +16 -0
  407. claude_mpm/skills/bundled/main/mcp-builder/SKILL.md +160 -0
  408. claude_mpm/skills/bundled/main/mcp-builder/reference/design_principles.md +412 -0
  409. claude_mpm/skills/bundled/main/mcp-builder/reference/evaluation.md +602 -0
  410. claude_mpm/skills/bundled/main/mcp-builder/reference/mcp_best_practices.md +915 -0
  411. claude_mpm/skills/bundled/main/mcp-builder/reference/node_mcp_server.md +916 -0
  412. claude_mpm/skills/bundled/main/mcp-builder/reference/python_mcp_server.md +752 -0
  413. claude_mpm/skills/bundled/main/mcp-builder/reference/workflow.md +1237 -0
  414. claude_mpm/skills/bundled/main/skill-creator/SKILL.md +189 -0
  415. claude_mpm/skills/bundled/main/skill-creator/references/best-practices.md +500 -0
  416. claude_mpm/skills/bundled/main/skill-creator/references/creation-workflow.md +464 -0
  417. claude_mpm/skills/bundled/main/skill-creator/references/examples.md +619 -0
  418. claude_mpm/skills/bundled/main/skill-creator/references/progressive-disclosure.md +437 -0
  419. claude_mpm/skills/bundled/main/skill-creator/references/skill-structure.md +231 -0
  420. claude_mpm/skills/bundled/php/espocrm-development/SKILL.md +170 -0
  421. claude_mpm/skills/bundled/php/espocrm-development/references/architecture.md +602 -0
  422. claude_mpm/skills/bundled/php/espocrm-development/references/common-tasks.md +821 -0
  423. claude_mpm/skills/bundled/php/espocrm-development/references/development-workflow.md +742 -0
  424. claude_mpm/skills/bundled/php/espocrm-development/references/frontend-customization.md +726 -0
  425. claude_mpm/skills/bundled/php/espocrm-development/references/hooks-and-services.md +764 -0
  426. claude_mpm/skills/bundled/php/espocrm-development/references/testing-debugging.md +831 -0
  427. claude_mpm/skills/bundled/pm/mpm/SKILL.md +38 -0
  428. claude_mpm/skills/bundled/pm/mpm-agent-update-workflow/SKILL.md +75 -0
  429. claude_mpm/skills/bundled/pm/mpm-bug-reporting/SKILL.md +248 -0
  430. claude_mpm/skills/bundled/pm/mpm-circuit-breaker-enforcement/SKILL.md +476 -0
  431. claude_mpm/skills/bundled/pm/mpm-config/SKILL.md +29 -0
  432. claude_mpm/skills/bundled/pm/mpm-delegation-patterns/SKILL.md +167 -0
  433. claude_mpm/skills/bundled/pm/mpm-doctor/SKILL.md +53 -0
  434. claude_mpm/skills/bundled/pm/mpm-git-file-tracking/SKILL.md +113 -0
  435. claude_mpm/skills/bundled/pm/mpm-help/SKILL.md +35 -0
  436. claude_mpm/skills/bundled/pm/mpm-init/SKILL.md +125 -0
  437. claude_mpm/skills/bundled/pm/mpm-monitor/SKILL.md +32 -0
  438. claude_mpm/skills/bundled/pm/mpm-organize/SKILL.md +121 -0
  439. claude_mpm/skills/bundled/pm/mpm-postmortem/SKILL.md +22 -0
  440. claude_mpm/skills/bundled/pm/mpm-pr-workflow/SKILL.md +124 -0
  441. claude_mpm/skills/bundled/pm/mpm-session-management/SKILL.md +312 -0
  442. claude_mpm/skills/bundled/pm/mpm-session-pause/SKILL.md +170 -0
  443. claude_mpm/skills/bundled/pm/mpm-session-resume/SKILL.md +31 -0
  444. claude_mpm/skills/bundled/pm/mpm-status/SKILL.md +37 -0
  445. claude_mpm/skills/bundled/pm/mpm-teaching-mode/SKILL.md +657 -0
  446. claude_mpm/skills/bundled/pm/mpm-ticket-view/SKILL.md +110 -0
  447. claude_mpm/skills/bundled/pm/mpm-ticketing-integration/SKILL.md +154 -0
  448. claude_mpm/skills/bundled/pm/mpm-tool-usage-guide/SKILL.md +386 -0
  449. claude_mpm/skills/bundled/pm/mpm-verification-protocols/SKILL.md +198 -0
  450. claude_mpm/skills/bundled/pm/mpm-version/SKILL.md +21 -0
  451. claude_mpm/skills/bundled/react/flexlayout-react.md +742 -0
  452. claude_mpm/skills/bundled/rust/desktop-applications/SKILL.md +226 -0
  453. claude_mpm/skills/bundled/rust/desktop-applications/references/architecture-patterns.md +901 -0
  454. claude_mpm/skills/bundled/rust/desktop-applications/references/native-gui-frameworks.md +901 -0
  455. claude_mpm/skills/bundled/rust/desktop-applications/references/platform-integration.md +775 -0
  456. claude_mpm/skills/bundled/rust/desktop-applications/references/state-management.md +937 -0
  457. claude_mpm/skills/bundled/rust/desktop-applications/references/tauri-framework.md +770 -0
  458. claude_mpm/skills/bundled/rust/desktop-applications/references/testing-deployment.md +961 -0
  459. claude_mpm/skills/bundled/security-scanning.md +112 -0
  460. claude_mpm/skills/bundled/tauri/tauri-async-patterns.md +495 -0
  461. claude_mpm/skills/bundled/tauri/tauri-build-deploy.md +599 -0
  462. claude_mpm/skills/bundled/tauri/tauri-command-patterns.md +535 -0
  463. claude_mpm/skills/bundled/tauri/tauri-error-handling.md +613 -0
  464. claude_mpm/skills/bundled/tauri/tauri-event-system.md +648 -0
  465. claude_mpm/skills/bundled/tauri/tauri-file-system.md +673 -0
  466. claude_mpm/skills/bundled/tauri/tauri-frontend-integration.md +767 -0
  467. claude_mpm/skills/bundled/tauri/tauri-performance.md +669 -0
  468. claude_mpm/skills/bundled/tauri/tauri-state-management.md +573 -0
  469. claude_mpm/skills/bundled/tauri/tauri-testing.md +384 -0
  470. claude_mpm/skills/bundled/tauri/tauri-window-management.md +628 -0
  471. claude_mpm/skills/bundled/testing/condition-based-waiting/SKILL.md +119 -0
  472. claude_mpm/skills/bundled/testing/condition-based-waiting/references/patterns-and-implementation.md +253 -0
  473. claude_mpm/skills/bundled/testing/test-driven-development/SKILL.md +145 -0
  474. claude_mpm/skills/bundled/testing/test-driven-development/references/anti-patterns.md +543 -0
  475. claude_mpm/skills/bundled/testing/test-driven-development/references/examples.md +741 -0
  476. claude_mpm/skills/bundled/testing/test-driven-development/references/integration.md +470 -0
  477. claude_mpm/skills/bundled/testing/test-driven-development/references/philosophy.md +458 -0
  478. claude_mpm/skills/bundled/testing/test-driven-development/references/workflow.md +639 -0
  479. claude_mpm/skills/bundled/testing/test-quality-inspector/SKILL.md +458 -0
  480. claude_mpm/skills/bundled/testing/test-quality-inspector/examples/example-inspection-report.md +411 -0
  481. claude_mpm/skills/bundled/testing/test-quality-inspector/references/assertion-quality.md +317 -0
  482. claude_mpm/skills/bundled/testing/test-quality-inspector/references/inspection-checklist.md +270 -0
  483. claude_mpm/skills/bundled/testing/test-quality-inspector/references/red-flags.md +436 -0
  484. claude_mpm/skills/bundled/testing/testing-anti-patterns/SKILL.md +140 -0
  485. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/completeness-anti-patterns.md +572 -0
  486. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/core-anti-patterns.md +411 -0
  487. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/detection-guide.md +569 -0
  488. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/tdd-connection.md +695 -0
  489. claude_mpm/skills/bundled/testing/webapp-testing/SKILL.md +184 -0
  490. claude_mpm/skills/bundled/testing/webapp-testing/decision-tree.md +459 -0
  491. claude_mpm/skills/bundled/testing/webapp-testing/playwright-patterns.md +479 -0
  492. claude_mpm/skills/bundled/testing/webapp-testing/reconnaissance-pattern.md +687 -0
  493. claude_mpm/skills/bundled/testing/webapp-testing/server-management.md +758 -0
  494. claude_mpm/skills/bundled/testing/webapp-testing/troubleshooting.md +868 -0
  495. claude_mpm/skills/registry.py +295 -90
  496. claude_mpm/skills/skill_manager.py +98 -3
  497. claude_mpm/templates/.pre-commit-config.yaml +112 -0
  498. claude_mpm/utils/agent_dependency_loader.py +115 -4
  499. claude_mpm/utils/agent_filters.py +17 -44
  500. claude_mpm/utils/gitignore.py +3 -0
  501. claude_mpm/utils/migration.py +4 -4
  502. claude_mpm/utils/robust_installer.py +86 -21
  503. claude_mpm-5.6.23.dist-info/METADATA +393 -0
  504. {claude_mpm-5.0.9.dist-info → claude_mpm-5.6.23.dist-info}/RECORD +508 -261
  505. claude_mpm-5.6.23.dist-info/entry_points.txt +5 -0
  506. claude_mpm-5.6.23.dist-info/licenses/LICENSE +94 -0
  507. claude_mpm-5.6.23.dist-info/licenses/LICENSE-FAQ.md +153 -0
  508. claude_mpm/agents/BASE_AGENT_TEMPLATE.md +0 -292
  509. claude_mpm/agents/BASE_DOCUMENTATION.md +0 -53
  510. claude_mpm/agents/BASE_OPS.md +0 -219
  511. claude_mpm/agents/BASE_PM.md +0 -480
  512. claude_mpm/agents/BASE_PROMPT_ENGINEER.md +0 -787
  513. claude_mpm/agents/BASE_QA.md +0 -167
  514. claude_mpm/agents/BASE_RESEARCH.md +0 -53
  515. claude_mpm/agents/OUTPUT_STYLE.md +0 -290
  516. claude_mpm/agents/PM_INSTRUCTIONS_TEACH.md +0 -1322
  517. claude_mpm/agents/base_agent_loader.py +0 -601
  518. claude_mpm/cli/commands/agents_detect.py +0 -380
  519. claude_mpm/cli/commands/agents_recommend.py +0 -309
  520. claude_mpm/cli/ticket_cli.py +0 -35
  521. claude_mpm/commands/mpm-agents-auto-configure.md +0 -278
  522. claude_mpm/commands/mpm-agents-detect.md +0 -177
  523. claude_mpm/commands/mpm-agents-list.md +0 -131
  524. claude_mpm/commands/mpm-agents-recommend.md +0 -223
  525. claude_mpm/commands/mpm-config-view.md +0 -150
  526. claude_mpm/commands/mpm-ticket-organize.md +0 -304
  527. claude_mpm/dashboard/analysis_runner.py +0 -455
  528. claude_mpm/dashboard/index.html +0 -13
  529. claude_mpm/dashboard/open_dashboard.py +0 -66
  530. claude_mpm/dashboard/static/css/activity.css +0 -1958
  531. claude_mpm/dashboard/static/css/connection-status.css +0 -370
  532. claude_mpm/dashboard/static/css/dashboard.css +0 -4701
  533. claude_mpm/dashboard/static/js/components/activity-tree.js +0 -1871
  534. claude_mpm/dashboard/static/js/components/agent-hierarchy.js +0 -777
  535. claude_mpm/dashboard/static/js/components/agent-inference.js +0 -956
  536. claude_mpm/dashboard/static/js/components/build-tracker.js +0 -333
  537. claude_mpm/dashboard/static/js/components/code-simple.js +0 -857
  538. claude_mpm/dashboard/static/js/components/connection-debug.js +0 -654
  539. claude_mpm/dashboard/static/js/components/diff-viewer.js +0 -891
  540. claude_mpm/dashboard/static/js/components/event-processor.js +0 -542
  541. claude_mpm/dashboard/static/js/components/event-viewer.js +0 -1155
  542. claude_mpm/dashboard/static/js/components/export-manager.js +0 -368
  543. claude_mpm/dashboard/static/js/components/file-change-tracker.js +0 -443
  544. claude_mpm/dashboard/static/js/components/file-change-viewer.js +0 -690
  545. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +0 -724
  546. claude_mpm/dashboard/static/js/components/file-viewer.js +0 -580
  547. claude_mpm/dashboard/static/js/components/hud-library-loader.js +0 -211
  548. claude_mpm/dashboard/static/js/components/hud-manager.js +0 -671
  549. claude_mpm/dashboard/static/js/components/hud-visualizer.js +0 -1718
  550. claude_mpm/dashboard/static/js/components/module-viewer.js +0 -2764
  551. claude_mpm/dashboard/static/js/components/session-manager.js +0 -579
  552. claude_mpm/dashboard/static/js/components/socket-manager.js +0 -368
  553. claude_mpm/dashboard/static/js/components/ui-state-manager.js +0 -749
  554. claude_mpm/dashboard/static/js/components/unified-data-viewer.js +0 -1824
  555. claude_mpm/dashboard/static/js/components/working-directory.js +0 -920
  556. claude_mpm/dashboard/static/js/connection-manager.js +0 -536
  557. claude_mpm/dashboard/static/js/dashboard.js +0 -1914
  558. claude_mpm/dashboard/static/js/extension-error-handler.js +0 -164
  559. claude_mpm/dashboard/static/js/socket-client.js +0 -1474
  560. claude_mpm/dashboard/static/js/tab-isolation-fix.js +0 -185
  561. claude_mpm/dashboard/static/socket.io.min.js +0 -7
  562. claude_mpm/dashboard/static/socket.io.v4.8.1.backup.js +0 -7
  563. claude_mpm/dashboard/templates/code_simple.html +0 -153
  564. claude_mpm/dashboard/templates/index.html +0 -606
  565. claude_mpm/dashboard/test_dashboard.html +0 -372
  566. claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-313.pyc +0 -0
  567. claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-313.pyc +0 -0
  568. claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-313.pyc +0 -0
  569. claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-313.pyc +0 -0
  570. claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-313.pyc +0 -0
  571. claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-313.pyc +0 -0
  572. claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-313.pyc +0 -0
  573. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-313.pyc +0 -0
  574. claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-313.pyc +0 -0
  575. claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-313.pyc +0 -0
  576. claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-313.pyc +0 -0
  577. claude_mpm/scripts/mcp_server.py +0 -75
  578. claude_mpm/scripts/mcp_wrapper.py +0 -39
  579. claude_mpm/services/mcp_gateway/__init__.py +0 -159
  580. claude_mpm/services/mcp_gateway/auto_configure.py +0 -369
  581. claude_mpm/services/mcp_gateway/config/__init__.py +0 -17
  582. claude_mpm/services/mcp_gateway/config/config_loader.py +0 -296
  583. claude_mpm/services/mcp_gateway/config/config_schema.py +0 -243
  584. claude_mpm/services/mcp_gateway/config/configuration.py +0 -429
  585. claude_mpm/services/mcp_gateway/core/__init__.py +0 -43
  586. claude_mpm/services/mcp_gateway/core/base.py +0 -312
  587. claude_mpm/services/mcp_gateway/core/exceptions.py +0 -253
  588. claude_mpm/services/mcp_gateway/core/interfaces.py +0 -443
  589. claude_mpm/services/mcp_gateway/core/process_pool.py +0 -977
  590. claude_mpm/services/mcp_gateway/core/singleton_manager.py +0 -315
  591. claude_mpm/services/mcp_gateway/core/startup_verification.py +0 -316
  592. claude_mpm/services/mcp_gateway/main.py +0 -589
  593. claude_mpm/services/mcp_gateway/registry/__init__.py +0 -12
  594. claude_mpm/services/mcp_gateway/registry/service_registry.py +0 -412
  595. claude_mpm/services/mcp_gateway/registry/tool_registry.py +0 -489
  596. claude_mpm/services/mcp_gateway/server/__init__.py +0 -15
  597. claude_mpm/services/mcp_gateway/server/mcp_gateway.py +0 -414
  598. claude_mpm/services/mcp_gateway/server/stdio_handler.py +0 -372
  599. claude_mpm/services/mcp_gateway/server/stdio_server.py +0 -712
  600. claude_mpm/services/mcp_gateway/tools/__init__.py +0 -36
  601. claude_mpm/services/mcp_gateway/tools/base_adapter.py +0 -485
  602. claude_mpm/services/mcp_gateway/tools/document_summarizer.py +0 -789
  603. claude_mpm/services/mcp_gateway/tools/external_mcp_services.py +0 -654
  604. claude_mpm/services/mcp_gateway/tools/health_check_tool.py +0 -456
  605. claude_mpm/services/mcp_gateway/tools/hello_world.py +0 -551
  606. claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py +0 -555
  607. claude_mpm/services/mcp_gateway/utils/__init__.py +0 -14
  608. claude_mpm/services/mcp_gateway/utils/package_version_checker.py +0 -160
  609. claude_mpm/services/mcp_gateway/utils/update_preferences.py +0 -170
  610. claude_mpm-5.0.9.dist-info/METADATA +0 -1028
  611. claude_mpm-5.0.9.dist-info/entry_points.txt +0 -10
  612. claude_mpm-5.0.9.dist-info/licenses/LICENSE +0 -21
  613. {claude_mpm-5.0.9.dist-info → claude_mpm-5.6.23.dist-info}/WHEEL +0 -0
  614. {claude_mpm-5.0.9.dist-info → claude_mpm-5.6.23.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;