macro-agent 0.0.11 → 0.0.12

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.
Files changed (408) hide show
  1. package/.macro-agent/teams/self-driving/prompts/grinder.md +27 -0
  2. package/.macro-agent/teams/self-driving/prompts/judge.md +27 -0
  3. package/.macro-agent/teams/self-driving/prompts/planner.md +33 -0
  4. package/.macro-agent/teams/self-driving/roles/grinder.yaml +17 -0
  5. package/.macro-agent/teams/self-driving/roles/judge.yaml +24 -0
  6. package/.macro-agent/teams/self-driving/roles/planner.yaml +18 -0
  7. package/.macro-agent/teams/self-driving/team.yaml +103 -0
  8. package/.macro-agent/teams/structured/prompts/developer.md +26 -0
  9. package/.macro-agent/teams/structured/prompts/lead.md +25 -0
  10. package/.macro-agent/teams/structured/prompts/reviewer.md +24 -0
  11. package/.macro-agent/teams/structured/roles/developer.yaml +12 -0
  12. package/.macro-agent/teams/structured/roles/lead.yaml +11 -0
  13. package/.macro-agent/teams/structured/roles/reviewer.yaml +19 -0
  14. package/.macro-agent/teams/structured/team.yaml +89 -0
  15. package/.sudocode/issues.jsonl +6 -0
  16. package/.sudocode/specs.jsonl +7 -0
  17. package/CLAUDE.md +110 -30
  18. package/README.md +60 -3
  19. package/dist/acp/macro-agent.d.ts +4 -0
  20. package/dist/acp/macro-agent.d.ts.map +1 -1
  21. package/dist/acp/macro-agent.js +50 -4
  22. package/dist/acp/macro-agent.js.map +1 -1
  23. package/dist/acp/session-mapper.d.ts +20 -1
  24. package/dist/acp/session-mapper.d.ts.map +1 -1
  25. package/dist/acp/session-mapper.js +90 -1
  26. package/dist/acp/session-mapper.js.map +1 -1
  27. package/dist/acp/types.d.ts +24 -1
  28. package/dist/acp/types.d.ts.map +1 -1
  29. package/dist/acp/types.js.map +1 -1
  30. package/dist/agent/agent-manager.d.ts +25 -1
  31. package/dist/agent/agent-manager.d.ts.map +1 -1
  32. package/dist/agent/agent-manager.js +93 -7
  33. package/dist/agent/agent-manager.js.map +1 -1
  34. package/dist/agent/types.d.ts +22 -0
  35. package/dist/agent/types.d.ts.map +1 -1
  36. package/dist/agent/types.js.map +1 -1
  37. package/dist/agent-detection/command-builder.d.ts +30 -0
  38. package/dist/agent-detection/command-builder.d.ts.map +1 -0
  39. package/dist/agent-detection/command-builder.js +71 -0
  40. package/dist/agent-detection/command-builder.js.map +1 -0
  41. package/dist/agent-detection/detector.d.ts +84 -0
  42. package/dist/agent-detection/detector.d.ts.map +1 -0
  43. package/dist/agent-detection/detector.js +240 -0
  44. package/dist/agent-detection/detector.js.map +1 -0
  45. package/dist/agent-detection/index.d.ts +12 -0
  46. package/dist/agent-detection/index.d.ts.map +1 -0
  47. package/dist/agent-detection/index.js +14 -0
  48. package/dist/agent-detection/index.js.map +1 -0
  49. package/dist/agent-detection/registry.d.ts +53 -0
  50. package/dist/agent-detection/registry.d.ts.map +1 -0
  51. package/dist/agent-detection/registry.js +177 -0
  52. package/dist/agent-detection/registry.js.map +1 -0
  53. package/dist/agent-detection/types.d.ts +121 -0
  54. package/dist/agent-detection/types.d.ts.map +1 -0
  55. package/dist/agent-detection/types.js +20 -0
  56. package/dist/agent-detection/types.js.map +1 -0
  57. package/dist/api/server.d.ts.map +1 -1
  58. package/dist/api/server.js +95 -0
  59. package/dist/api/server.js.map +1 -1
  60. package/dist/cli/index.js +29 -0
  61. package/dist/cli/index.js.map +1 -1
  62. package/dist/cli/mcp.js +38 -0
  63. package/dist/cli/mcp.js.map +1 -1
  64. package/dist/config/index.d.ts +2 -0
  65. package/dist/config/index.d.ts.map +1 -0
  66. package/dist/config/index.js +2 -0
  67. package/dist/config/index.js.map +1 -0
  68. package/dist/config/project-config.d.ts +46 -0
  69. package/dist/config/project-config.d.ts.map +1 -0
  70. package/dist/config/project-config.js +68 -0
  71. package/dist/config/project-config.js.map +1 -0
  72. package/dist/lifecycle/cascade.d.ts +1 -1
  73. package/dist/lifecycle/cascade.d.ts.map +1 -1
  74. package/dist/lifecycle/handlers/index.d.ts +4 -0
  75. package/dist/lifecycle/handlers/index.d.ts.map +1 -1
  76. package/dist/lifecycle/handlers/index.js +2 -0
  77. package/dist/lifecycle/handlers/index.js.map +1 -1
  78. package/dist/lifecycle/handlers/worker.d.ts +4 -0
  79. package/dist/lifecycle/handlers/worker.d.ts.map +1 -1
  80. package/dist/lifecycle/handlers/worker.js +35 -3
  81. package/dist/lifecycle/handlers/worker.js.map +1 -1
  82. package/dist/map/adapter/acp-over-map.d.ts.map +1 -1
  83. package/dist/map/adapter/acp-over-map.js +32 -2
  84. package/dist/map/adapter/acp-over-map.js.map +1 -1
  85. package/dist/map/adapter/event-translator.d.ts.map +1 -1
  86. package/dist/map/adapter/event-translator.js +1 -0
  87. package/dist/map/adapter/event-translator.js.map +1 -1
  88. package/dist/map/adapter/extensions/agent-detection.d.ts +49 -0
  89. package/dist/map/adapter/extensions/agent-detection.d.ts.map +1 -0
  90. package/dist/map/adapter/extensions/agent-detection.js +91 -0
  91. package/dist/map/adapter/extensions/agent-detection.js.map +1 -0
  92. package/dist/map/adapter/extensions/index.d.ts +10 -1
  93. package/dist/map/adapter/extensions/index.d.ts.map +1 -1
  94. package/dist/map/adapter/extensions/index.js +39 -0
  95. package/dist/map/adapter/extensions/index.js.map +1 -1
  96. package/dist/map/adapter/extensions/resume.d.ts +47 -0
  97. package/dist/map/adapter/extensions/resume.d.ts.map +1 -0
  98. package/dist/map/adapter/extensions/resume.js +59 -0
  99. package/dist/map/adapter/extensions/resume.js.map +1 -0
  100. package/dist/map/adapter/extensions/workspace-files.d.ts +42 -0
  101. package/dist/map/adapter/extensions/workspace-files.d.ts.map +1 -0
  102. package/dist/map/adapter/extensions/workspace-files.js +338 -0
  103. package/dist/map/adapter/extensions/workspace-files.js.map +1 -0
  104. package/dist/mcp/mcp-server.d.ts +6 -0
  105. package/dist/mcp/mcp-server.d.ts.map +1 -1
  106. package/dist/mcp/mcp-server.js +45 -0
  107. package/dist/mcp/mcp-server.js.map +1 -1
  108. package/dist/mcp/tools/claim_task.d.ts +35 -0
  109. package/dist/mcp/tools/claim_task.d.ts.map +1 -0
  110. package/dist/mcp/tools/claim_task.js +58 -0
  111. package/dist/mcp/tools/claim_task.js.map +1 -0
  112. package/dist/mcp/tools/done.d.ts +11 -2
  113. package/dist/mcp/tools/done.d.ts.map +1 -1
  114. package/dist/mcp/tools/done.js +15 -10
  115. package/dist/mcp/tools/done.js.map +1 -1
  116. package/dist/mcp/tools/list_claimable_tasks.d.ts +38 -0
  117. package/dist/mcp/tools/list_claimable_tasks.d.ts.map +1 -0
  118. package/dist/mcp/tools/list_claimable_tasks.js +63 -0
  119. package/dist/mcp/tools/list_claimable_tasks.js.map +1 -0
  120. package/dist/mcp/tools/unclaim_task.d.ts +31 -0
  121. package/dist/mcp/tools/unclaim_task.d.ts.map +1 -0
  122. package/dist/mcp/tools/unclaim_task.js +47 -0
  123. package/dist/mcp/tools/unclaim_task.js.map +1 -0
  124. package/dist/metrics/index.d.ts +2 -0
  125. package/dist/metrics/index.d.ts.map +1 -0
  126. package/dist/metrics/index.js +2 -0
  127. package/dist/metrics/index.js.map +1 -0
  128. package/dist/metrics/metrics.d.ts +79 -0
  129. package/dist/metrics/metrics.d.ts.map +1 -0
  130. package/dist/metrics/metrics.js +166 -0
  131. package/dist/metrics/metrics.js.map +1 -0
  132. package/dist/roles/capabilities.d.ts +1 -0
  133. package/dist/roles/capabilities.d.ts.map +1 -1
  134. package/dist/roles/capabilities.js +3 -0
  135. package/dist/roles/capabilities.js.map +1 -1
  136. package/dist/roles/types.d.ts +1 -1
  137. package/dist/roles/types.d.ts.map +1 -1
  138. package/dist/router/message-router.d.ts +41 -0
  139. package/dist/router/message-router.d.ts.map +1 -1
  140. package/dist/router/message-router.js +136 -5
  141. package/dist/router/message-router.js.map +1 -1
  142. package/dist/store/event-store.d.ts +8 -1
  143. package/dist/store/event-store.d.ts.map +1 -1
  144. package/dist/store/event-store.js +120 -4
  145. package/dist/store/event-store.js.map +1 -1
  146. package/dist/store/types/agents.d.ts +1 -1
  147. package/dist/store/types/agents.d.ts.map +1 -1
  148. package/dist/store/types/events.d.ts +1 -1
  149. package/dist/store/types/events.d.ts.map +1 -1
  150. package/dist/store/types/events.js.map +1 -1
  151. package/dist/store/types/index.d.ts +1 -0
  152. package/dist/store/types/index.d.ts.map +1 -1
  153. package/dist/store/types/index.js +1 -0
  154. package/dist/store/types/index.js.map +1 -1
  155. package/dist/store/types/sessions.d.ts +44 -0
  156. package/dist/store/types/sessions.d.ts.map +1 -0
  157. package/dist/store/types/sessions.js +9 -0
  158. package/dist/store/types/sessions.js.map +1 -0
  159. package/dist/store/types/tasks.d.ts +2 -0
  160. package/dist/store/types/tasks.d.ts.map +1 -1
  161. package/dist/task/backend/memory.d.ts +4 -1
  162. package/dist/task/backend/memory.d.ts.map +1 -1
  163. package/dist/task/backend/memory.js +81 -0
  164. package/dist/task/backend/memory.js.map +1 -1
  165. package/dist/task/backend/types.d.ts +30 -0
  166. package/dist/task/backend/types.d.ts.map +1 -1
  167. package/dist/task/backend/types.js.map +1 -1
  168. package/dist/teams/index.d.ts +4 -0
  169. package/dist/teams/index.d.ts.map +1 -0
  170. package/dist/teams/index.js +4 -0
  171. package/dist/teams/index.js.map +1 -0
  172. package/dist/teams/team-loader.d.ts +20 -0
  173. package/dist/teams/team-loader.d.ts.map +1 -0
  174. package/dist/teams/team-loader.js +293 -0
  175. package/dist/teams/team-loader.js.map +1 -0
  176. package/dist/teams/team-runtime.d.ts +139 -0
  177. package/dist/teams/team-runtime.d.ts.map +1 -0
  178. package/dist/teams/team-runtime.js +613 -0
  179. package/dist/teams/team-runtime.js.map +1 -0
  180. package/dist/teams/types.d.ts +266 -0
  181. package/dist/teams/types.d.ts.map +1 -0
  182. package/dist/teams/types.js +20 -0
  183. package/dist/teams/types.js.map +1 -0
  184. package/dist/workspace/dataplane-adapter.d.ts +1 -1
  185. package/dist/workspace/dataplane-adapter.d.ts.map +1 -1
  186. package/dist/workspace/dataplane-adapter.js +1 -1
  187. package/dist/workspace/dataplane-adapter.js.map +1 -1
  188. package/dist/workspace/index.d.ts +1 -1
  189. package/dist/workspace/index.d.ts.map +1 -1
  190. package/dist/workspace/strategies/index.d.ts +6 -0
  191. package/dist/workspace/strategies/index.d.ts.map +1 -0
  192. package/dist/workspace/strategies/index.js +5 -0
  193. package/dist/workspace/strategies/index.js.map +1 -0
  194. package/dist/workspace/strategies/optimistic.d.ts +26 -0
  195. package/dist/workspace/strategies/optimistic.d.ts.map +1 -0
  196. package/dist/workspace/strategies/optimistic.js +121 -0
  197. package/dist/workspace/strategies/optimistic.js.map +1 -0
  198. package/dist/workspace/strategies/queue.d.ts +26 -0
  199. package/dist/workspace/strategies/queue.d.ts.map +1 -0
  200. package/dist/workspace/strategies/queue.js +67 -0
  201. package/dist/workspace/strategies/queue.js.map +1 -0
  202. package/dist/workspace/strategies/registry.d.ts +37 -0
  203. package/dist/workspace/strategies/registry.d.ts.map +1 -0
  204. package/dist/workspace/strategies/registry.js +63 -0
  205. package/dist/workspace/strategies/registry.js.map +1 -0
  206. package/dist/workspace/strategies/trunk.d.ts +20 -0
  207. package/dist/workspace/strategies/trunk.d.ts.map +1 -0
  208. package/dist/workspace/strategies/trunk.js +108 -0
  209. package/dist/workspace/strategies/trunk.js.map +1 -0
  210. package/dist/workspace/strategies/types.d.ts +104 -0
  211. package/dist/workspace/strategies/types.d.ts.map +1 -0
  212. package/dist/workspace/strategies/types.js +11 -0
  213. package/dist/workspace/strategies/types.js.map +1 -0
  214. package/dist/workspace/types.d.ts +1 -1
  215. package/dist/workspace/types.d.ts.map +1 -1
  216. package/dist/workspace/workspace-manager.d.ts +1 -1
  217. package/dist/workspace/workspace-manager.d.ts.map +1 -1
  218. package/docs/implementation-details.md +1127 -0
  219. package/docs/implementation-summary.md +448 -0
  220. package/docs/plan-self-driving-support.md +433 -0
  221. package/docs/spec-self-driving-support.md +462 -0
  222. package/docs/team-templates.md +860 -0
  223. package/docs/teams.md +233 -0
  224. package/package.json +4 -2
  225. package/src/acp/__tests__/integration.test.ts +161 -1
  226. package/src/acp/__tests__/macro-agent.test.ts +95 -0
  227. package/src/acp/__tests__/session-persistence.test.ts +276 -0
  228. package/src/acp/macro-agent.ts +79 -7
  229. package/src/acp/session-mapper.ts +108 -1
  230. package/src/acp/types.ts +33 -1
  231. package/src/agent/agent-manager.ts +158 -6
  232. package/src/agent/types.ts +27 -0
  233. package/src/agent-detection/__tests__/command-builder.test.ts +336 -0
  234. package/src/agent-detection/__tests__/detector.test.ts +768 -0
  235. package/src/agent-detection/__tests__/registry.test.ts +254 -0
  236. package/src/agent-detection/command-builder.ts +90 -0
  237. package/src/agent-detection/detector.ts +307 -0
  238. package/src/agent-detection/index.ts +36 -0
  239. package/src/agent-detection/registry.ts +200 -0
  240. package/src/agent-detection/types.ts +184 -0
  241. package/src/api/server.ts +110 -0
  242. package/src/cli/index.ts +44 -0
  243. package/src/cli/mcp.ts +47 -0
  244. package/src/config/index.ts +9 -0
  245. package/src/config/project-config.ts +107 -0
  246. package/src/lifecycle/cascade.ts +1 -1
  247. package/src/lifecycle/handlers/index.ts +8 -0
  248. package/src/lifecycle/handlers/worker.ts +48 -3
  249. package/src/map/adapter/__tests__/extensions.test.ts +359 -0
  250. package/src/map/adapter/__tests__/workspace-files.test.ts +673 -0
  251. package/src/map/adapter/acp-over-map.ts +45 -2
  252. package/src/map/adapter/event-translator.ts +1 -0
  253. package/src/map/adapter/extensions/agent-detection.ts +201 -0
  254. package/src/map/adapter/extensions/index.ts +63 -0
  255. package/src/map/adapter/extensions/resume.ts +114 -0
  256. package/src/map/adapter/extensions/workspace-files.ts +449 -0
  257. package/src/mcp/mcp-server.ts +67 -0
  258. package/src/mcp/tools/claim_task.ts +86 -0
  259. package/src/mcp/tools/done.ts +24 -10
  260. package/src/mcp/tools/list_claimable_tasks.ts +93 -0
  261. package/src/mcp/tools/unclaim_task.ts +71 -0
  262. package/src/metrics/index.ts +9 -0
  263. package/src/metrics/metrics.ts +280 -0
  264. package/src/roles/capabilities.ts +3 -0
  265. package/src/roles/types.ts +2 -1
  266. package/src/router/__tests__/message-router.test.ts +561 -0
  267. package/src/router/message-router.ts +223 -6
  268. package/src/store/event-store.ts +151 -3
  269. package/src/store/types/agents.ts +1 -1
  270. package/src/store/types/events.ts +2 -1
  271. package/src/store/types/index.ts +1 -0
  272. package/src/store/types/sessions.ts +53 -0
  273. package/src/store/types/tasks.ts +3 -0
  274. package/src/task/backend/memory.ts +116 -0
  275. package/src/task/backend/types.ts +43 -0
  276. package/src/teams/__tests__/cross-subsystem.integration.test.ts +983 -0
  277. package/src/teams/__tests__/e2e/team-runtime.e2e.test.ts +553 -0
  278. package/src/teams/__tests__/team-system.test.ts +1280 -0
  279. package/src/teams/index.ts +13 -0
  280. package/src/teams/team-loader.ts +434 -0
  281. package/src/teams/team-runtime.ts +727 -0
  282. package/src/teams/types.ts +377 -0
  283. package/src/workspace/dataplane-adapter.ts +1 -1
  284. package/src/workspace/index.ts +1 -1
  285. package/src/workspace/strategies/index.ts +18 -0
  286. package/src/workspace/strategies/optimistic.ts +136 -0
  287. package/src/workspace/strategies/queue.ts +81 -0
  288. package/src/workspace/strategies/registry.ts +89 -0
  289. package/src/workspace/strategies/trunk.ts +123 -0
  290. package/src/workspace/strategies/types.ts +145 -0
  291. package/src/workspace/types.ts +1 -1
  292. package/src/workspace/workspace-manager.ts +1 -1
  293. package/.claude/settings.local.json +0 -59
  294. package/dist/map/utils/address-translation.d.ts +0 -99
  295. package/dist/map/utils/address-translation.d.ts.map +0 -1
  296. package/dist/map/utils/address-translation.js +0 -285
  297. package/dist/map/utils/address-translation.js.map +0 -1
  298. package/dist/map/utils/index.d.ts +0 -7
  299. package/dist/map/utils/index.d.ts.map +0 -1
  300. package/dist/map/utils/index.js +0 -7
  301. package/dist/map/utils/index.js.map +0 -1
  302. package/references/acp-factory-ref/CHANGELOG.md +0 -33
  303. package/references/acp-factory-ref/LICENSE +0 -21
  304. package/references/acp-factory-ref/README.md +0 -341
  305. package/references/acp-factory-ref/package-lock.json +0 -3102
  306. package/references/acp-factory-ref/package.json +0 -96
  307. package/references/acp-factory-ref/python/CHANGELOG.md +0 -33
  308. package/references/acp-factory-ref/python/LICENSE +0 -21
  309. package/references/acp-factory-ref/python/Makefile +0 -57
  310. package/references/acp-factory-ref/python/README.md +0 -253
  311. package/references/acp-factory-ref/python/pyproject.toml +0 -73
  312. package/references/acp-factory-ref/python/tests/__init__.py +0 -0
  313. package/references/acp-factory-ref/python/tests/e2e/__init__.py +0 -1
  314. package/references/acp-factory-ref/python/tests/e2e/test_codex_e2e.py +0 -349
  315. package/references/acp-factory-ref/python/tests/e2e/test_gemini_e2e.py +0 -165
  316. package/references/acp-factory-ref/python/tests/e2e/test_opencode_e2e.py +0 -296
  317. package/references/acp-factory-ref/python/tests/test_client_handler.py +0 -543
  318. package/references/acp-factory-ref/python/tests/test_pushable.py +0 -199
  319. package/references/claude-code-acp/.github/workflows/ci.yml +0 -45
  320. package/references/claude-code-acp/.github/workflows/publish.yml +0 -34
  321. package/references/claude-code-acp/.prettierrc.json +0 -4
  322. package/references/claude-code-acp/CHANGELOG.md +0 -249
  323. package/references/claude-code-acp/LICENSE +0 -222
  324. package/references/claude-code-acp/README.md +0 -53
  325. package/references/claude-code-acp/docs/RELEASES.md +0 -24
  326. package/references/claude-code-acp/eslint.config.js +0 -48
  327. package/references/claude-code-acp/package-lock.json +0 -4570
  328. package/references/claude-code-acp/package.json +0 -88
  329. package/references/claude-code-acp/scripts/release.sh +0 -119
  330. package/references/claude-code-acp/src/acp-agent.ts +0 -2065
  331. package/references/claude-code-acp/src/index.ts +0 -26
  332. package/references/claude-code-acp/src/lib.ts +0 -38
  333. package/references/claude-code-acp/src/mcp-server.ts +0 -911
  334. package/references/claude-code-acp/src/settings.ts +0 -522
  335. package/references/claude-code-acp/src/tests/.claude/commands/quick-math.md +0 -5
  336. package/references/claude-code-acp/src/tests/.claude/commands/say-hello.md +0 -6
  337. package/references/claude-code-acp/src/tests/acp-agent-fork.test.ts +0 -479
  338. package/references/claude-code-acp/src/tests/acp-agent.test.ts +0 -1502
  339. package/references/claude-code-acp/src/tests/extract-lines.test.ts +0 -103
  340. package/references/claude-code-acp/src/tests/fork-session.test.ts +0 -335
  341. package/references/claude-code-acp/src/tests/replace-and-calculate-location.test.ts +0 -334
  342. package/references/claude-code-acp/src/tests/settings.test.ts +0 -617
  343. package/references/claude-code-acp/src/tests/skills-options.test.ts +0 -187
  344. package/references/claude-code-acp/src/tests/tools.test.ts +0 -318
  345. package/references/claude-code-acp/src/tests/typescript-declarations.test.ts +0 -558
  346. package/references/claude-code-acp/src/tools.ts +0 -819
  347. package/references/claude-code-acp/src/utils.ts +0 -171
  348. package/references/claude-code-acp/tsconfig.json +0 -18
  349. package/references/claude-code-acp/vitest.config.ts +0 -19
  350. package/references/multi-agent-protocol/.sudocode/issues.jsonl +0 -111
  351. package/references/multi-agent-protocol/.sudocode/specs.jsonl +0 -13
  352. package/references/multi-agent-protocol/LICENSE +0 -21
  353. package/references/multi-agent-protocol/README.md +0 -113
  354. package/references/multi-agent-protocol/docs/00-design-specification.md +0 -496
  355. package/references/multi-agent-protocol/docs/01-open-questions.md +0 -1050
  356. package/references/multi-agent-protocol/docs/02-wire-protocol.md +0 -296
  357. package/references/multi-agent-protocol/docs/03-streaming-semantics.md +0 -252
  358. package/references/multi-agent-protocol/docs/04-error-handling.md +0 -231
  359. package/references/multi-agent-protocol/docs/05-connection-model.md +0 -244
  360. package/references/multi-agent-protocol/docs/06-visibility-permissions.md +0 -243
  361. package/references/multi-agent-protocol/docs/07-federation.md +0 -259
  362. package/references/multi-agent-protocol/docs/08-macro-agent-migration.md +0 -253
  363. package/references/multi-agent-protocol/docs/09-authentication.md +0 -680
  364. package/references/multi-agent-protocol/docs/10-mail-protocol.md +0 -553
  365. package/references/multi-agent-protocol/docs/agent-iam-integration.md +0 -877
  366. package/references/multi-agent-protocol/docs/agentic-mesh-integration-draft.md +0 -459
  367. package/references/multi-agent-protocol/docs/git-transport-draft.md +0 -251
  368. package/references/multi-agent-protocol/docs-site/Gemfile +0 -22
  369. package/references/multi-agent-protocol/docs-site/README.md +0 -82
  370. package/references/multi-agent-protocol/docs-site/_config.yml +0 -91
  371. package/references/multi-agent-protocol/docs-site/_includes/head_custom.html +0 -20
  372. package/references/multi-agent-protocol/docs-site/_sass/color_schemes/map.scss +0 -42
  373. package/references/multi-agent-protocol/docs-site/_sass/custom/custom.scss +0 -34
  374. package/references/multi-agent-protocol/docs-site/examples/full-integration.md +0 -510
  375. package/references/multi-agent-protocol/docs-site/examples/index.md +0 -138
  376. package/references/multi-agent-protocol/docs-site/examples/simple-chat.md +0 -282
  377. package/references/multi-agent-protocol/docs-site/examples/task-queue.md +0 -399
  378. package/references/multi-agent-protocol/docs-site/getting-started/index.md +0 -98
  379. package/references/multi-agent-protocol/docs-site/getting-started/installation.md +0 -219
  380. package/references/multi-agent-protocol/docs-site/getting-started/overview.md +0 -172
  381. package/references/multi-agent-protocol/docs-site/getting-started/quickstart.md +0 -237
  382. package/references/multi-agent-protocol/docs-site/index.md +0 -136
  383. package/references/multi-agent-protocol/docs-site/protocol/authentication.md +0 -391
  384. package/references/multi-agent-protocol/docs-site/protocol/connection-model.md +0 -376
  385. package/references/multi-agent-protocol/docs-site/protocol/design.md +0 -284
  386. package/references/multi-agent-protocol/docs-site/protocol/error-handling.md +0 -312
  387. package/references/multi-agent-protocol/docs-site/protocol/federation.md +0 -449
  388. package/references/multi-agent-protocol/docs-site/protocol/index.md +0 -129
  389. package/references/multi-agent-protocol/docs-site/protocol/permissions.md +0 -398
  390. package/references/multi-agent-protocol/docs-site/protocol/streaming.md +0 -353
  391. package/references/multi-agent-protocol/docs-site/protocol/wire-protocol.md +0 -369
  392. package/references/multi-agent-protocol/docs-site/sdk/api/agent.md +0 -357
  393. package/references/multi-agent-protocol/docs-site/sdk/api/client.md +0 -380
  394. package/references/multi-agent-protocol/docs-site/sdk/api/index.md +0 -62
  395. package/references/multi-agent-protocol/docs-site/sdk/api/server.md +0 -453
  396. package/references/multi-agent-protocol/docs-site/sdk/api/types.md +0 -468
  397. package/references/multi-agent-protocol/docs-site/sdk/guides/agent.md +0 -375
  398. package/references/multi-agent-protocol/docs-site/sdk/guides/authentication.md +0 -405
  399. package/references/multi-agent-protocol/docs-site/sdk/guides/client.md +0 -352
  400. package/references/multi-agent-protocol/docs-site/sdk/guides/index.md +0 -89
  401. package/references/multi-agent-protocol/docs-site/sdk/guides/server.md +0 -360
  402. package/references/multi-agent-protocol/docs-site/sdk/guides/testing.md +0 -446
  403. package/references/multi-agent-protocol/docs-site/sdk/guides/transports.md +0 -363
  404. package/references/multi-agent-protocol/docs-site/sdk/index.md +0 -206
  405. package/references/multi-agent-protocol/package-lock.json +0 -3886
  406. package/references/multi-agent-protocol/package.json +0 -56
  407. package/references/multi-agent-protocol/schema/meta.json +0 -467
  408. package/references/multi-agent-protocol/schema/schema.json +0 -2558
@@ -1,56 +0,0 @@
1
- {
2
- "name": "multi-agent-protocol",
3
- "version": "0.0.4",
4
- "description": "Multi-Agent Protocol (MAP) - A protocol for observing, coordinating, and routing messages within multi-agent AI systems",
5
- "type": "module",
6
- "main": "./schema/schema.json",
7
- "exports": {
8
- ".": "./schema/schema.json",
9
- "./schema": "./schema/schema.json",
10
- "./meta": "./schema/meta.json"
11
- },
12
- "files": [
13
- "schema",
14
- "docs",
15
- "README.md"
16
- ],
17
- "workspaces": [
18
- "ts-sdk"
19
- ],
20
- "scripts": {
21
- "build": "npm run build --workspace=ts-sdk",
22
- "test": "npm run test --workspace=ts-sdk",
23
- "typecheck": "npm run typecheck --workspace=ts-sdk",
24
- "publish:npm": "npm publish --access public",
25
- "prepublishOnly": "npm run build",
26
- "version:patch": "npm version patch && git push && git push --tags",
27
- "version:minor": "npm version minor && git push && git push --tags",
28
- "version:major": "npm version major && git push && git push --tags"
29
- },
30
- "keywords": [
31
- "multi-agent",
32
- "agent",
33
- "protocol",
34
- "map",
35
- "swarm",
36
- "messaging",
37
- "json-schema",
38
- "specification"
39
- ],
40
- "author": "Alex Ngai",
41
- "license": "MIT",
42
- "repository": {
43
- "type": "git",
44
- "url": "git+https://github.com/multi-agent-protocol/multi-agent-protocol.git"
45
- },
46
- "bugs": {
47
- "url": "https://github.com/multi-agent-protocol/multi-agent-protocol/issues"
48
- },
49
- "homepage": "https://github.com/multi-agent-protocol/multi-agent-protocol#readme",
50
- "engines": {
51
- "node": ">=18.0.0"
52
- },
53
- "publishConfig": {
54
- "access": "public"
55
- }
56
- }
@@ -1,467 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "title": "Multi-Agent Protocol Method Metadata",
4
- "description": "Metadata for MAP protocol methods including tier, implementer, and capability requirements",
5
- "protocolVersion": 1,
6
- "methods": {
7
- "map/connect": {
8
- "tier": "core",
9
- "implementedBy": "system",
10
- "callableBy": ["client", "agent", "gateway"],
11
- "capabilities": [],
12
- "description": "Connect to the MAP system and negotiate capabilities",
13
- "requestType": "ConnectRequest",
14
- "responseType": "ConnectResponse"
15
- },
16
- "map/disconnect": {
17
- "tier": "core",
18
- "implementedBy": "system",
19
- "callableBy": ["client", "agent", "gateway"],
20
- "capabilities": [],
21
- "description": "Gracefully disconnect from the MAP system",
22
- "requestType": "DisconnectRequest",
23
- "responseType": "DisconnectResponse"
24
- },
25
- "map/session/list": {
26
- "tier": "core",
27
- "implementedBy": "system",
28
- "callableBy": ["client", "agent"],
29
- "capabilities": [],
30
- "description": "List participant's sessions",
31
- "requestType": "SessionListRequest",
32
- "responseType": "SessionListResponse"
33
- },
34
- "map/session/load": {
35
- "tier": "core",
36
- "implementedBy": "system",
37
- "callableBy": ["client", "agent"],
38
- "capabilities": [],
39
- "description": "Load/reconnect to an existing session",
40
- "requestType": "SessionLoadRequest",
41
- "responseType": "SessionLoadResponse"
42
- },
43
- "map/session/close": {
44
- "tier": "core",
45
- "implementedBy": "system",
46
- "callableBy": ["client", "agent"],
47
- "capabilities": [],
48
- "description": "Explicitly end a session",
49
- "requestType": "SessionCloseRequest",
50
- "responseType": "SessionCloseResponse"
51
- },
52
- "map/agents/list": {
53
- "tier": "core",
54
- "implementedBy": "system",
55
- "callableBy": ["client", "agent", "gateway"],
56
- "capabilities": ["observation.canQuery"],
57
- "description": "List agents with optional filters (server-filtered by visibility)",
58
- "requestType": "AgentsListRequest",
59
- "responseType": "AgentsListResponse"
60
- },
61
- "map/agents/get": {
62
- "tier": "core",
63
- "implementedBy": "system",
64
- "callableBy": ["client", "agent", "gateway"],
65
- "capabilities": ["observation.canQuery"],
66
- "description": "Get details for a single agent",
67
- "requestType": "AgentsGetRequest",
68
- "responseType": "AgentsGetResponse"
69
- },
70
- "map/send": {
71
- "tier": "core",
72
- "implementedBy": "system",
73
- "callableBy": ["client", "agent"],
74
- "capabilities": ["messaging.canSend"],
75
- "description": "Send a message to an address",
76
- "requestType": "SendRequest",
77
- "responseType": "SendResponse"
78
- },
79
- "map/subscribe": {
80
- "tier": "core",
81
- "implementedBy": "system",
82
- "callableBy": ["client", "agent", "gateway"],
83
- "capabilities": ["observation.canObserve"],
84
- "description": "Subscribe to event streams",
85
- "requestType": "SubscribeRequest",
86
- "responseType": "SubscribeResponse"
87
- },
88
- "map/unsubscribe": {
89
- "tier": "core",
90
- "implementedBy": "system",
91
- "callableBy": ["client", "agent", "gateway"],
92
- "capabilities": ["observation.canObserve"],
93
- "description": "Unsubscribe from event streams",
94
- "requestType": "UnsubscribeRequest",
95
- "responseType": "UnsubscribeResponse"
96
- },
97
- "map/auth/refresh": {
98
- "tier": "core",
99
- "implementedBy": "system",
100
- "callableBy": ["client", "agent", "gateway"],
101
- "capabilities": [],
102
- "description": "Refresh authentication token in-band",
103
- "requestType": "AuthRefreshRequest",
104
- "responseType": "AuthRefreshResponse"
105
- },
106
- "map/agents/register": {
107
- "tier": "structure",
108
- "implementedBy": "system",
109
- "callableBy": ["agent", "system"],
110
- "capabilities": ["lifecycle.canRegister"],
111
- "description": "Register a new agent in the system",
112
- "requestType": "AgentsRegisterRequest",
113
- "responseType": "AgentsRegisterResponse"
114
- },
115
- "map/agents/spawn": {
116
- "tier": "structure",
117
- "implementedBy": "system",
118
- "callableBy": ["agent", "system"],
119
- "capabilities": ["lifecycle.canSpawn"],
120
- "description": "Register agent and assign initial task atomically",
121
- "requestType": "AgentsSpawnRequest",
122
- "responseType": "AgentsSpawnResponse"
123
- },
124
- "map/agents/unregister": {
125
- "tier": "structure",
126
- "implementedBy": "system",
127
- "callableBy": ["agent", "system"],
128
- "capabilities": ["lifecycle.canUnregister"],
129
- "description": "Remove an agent from the system",
130
- "requestType": "AgentsUnregisterRequest",
131
- "responseType": "AgentsUnregisterResponse"
132
- },
133
- "map/agents/update": {
134
- "tier": "structure",
135
- "implementedBy": "system",
136
- "callableBy": ["agent", "system"],
137
- "capabilities": [],
138
- "description": "Update agent state or metadata (agents can update themselves)",
139
- "requestType": "AgentsUpdateRequest",
140
- "responseType": "AgentsUpdateResponse"
141
- },
142
- "map/agents/stop": {
143
- "tier": "structure",
144
- "implementedBy": "system",
145
- "callableBy": ["client", "agent", "system"],
146
- "capabilities": ["lifecycle.canStop"],
147
- "description": "Request graceful agent stop",
148
- "requestType": "AgentsStopRequest",
149
- "responseType": "AgentsStopResponse"
150
- },
151
- "map/agents/suspend": {
152
- "tier": "structure",
153
- "implementedBy": "system",
154
- "callableBy": ["client", "agent", "system"],
155
- "capabilities": ["lifecycle.canStop"],
156
- "description": "Pause an agent",
157
- "requestType": "AgentsSuspendRequest",
158
- "responseType": "AgentsSuspendResponse"
159
- },
160
- "map/agents/resume": {
161
- "tier": "structure",
162
- "implementedBy": "system",
163
- "callableBy": ["client", "agent", "system"],
164
- "capabilities": ["lifecycle.canStop"],
165
- "description": "Resume a suspended agent",
166
- "requestType": "AgentsResumeRequest",
167
- "responseType": "AgentsResumeResponse"
168
- },
169
- "map/structure/graph": {
170
- "tier": "structure",
171
- "implementedBy": "system",
172
- "callableBy": ["client", "agent"],
173
- "capabilities": ["observation.canQuery"],
174
- "description": "Get the agent relationship graph",
175
- "requestType": "StructureGraphRequest",
176
- "responseType": "StructureGraphResponse"
177
- },
178
- "map/scopes/list": {
179
- "tier": "structure",
180
- "implementedBy": "system",
181
- "callableBy": ["client", "agent"],
182
- "capabilities": ["observation.canQuery"],
183
- "description": "List all scopes",
184
- "requestType": "ScopesListRequest",
185
- "responseType": "ScopesListResponse"
186
- },
187
- "map/scopes/get": {
188
- "tier": "structure",
189
- "implementedBy": "system",
190
- "callableBy": ["client", "agent"],
191
- "capabilities": ["observation.canQuery"],
192
- "description": "Get details for a single scope",
193
- "requestType": "ScopesGetRequest",
194
- "responseType": "ScopesGetResponse"
195
- },
196
- "map/scopes/create": {
197
- "tier": "structure",
198
- "implementedBy": "system",
199
- "callableBy": ["agent", "system"],
200
- "capabilities": ["scopes.canCreateScopes"],
201
- "description": "Create a new scope",
202
- "requestType": "ScopesCreateRequest",
203
- "responseType": "ScopesCreateResponse"
204
- },
205
- "map/scopes/delete": {
206
- "tier": "structure",
207
- "implementedBy": "system",
208
- "callableBy": ["agent", "system"],
209
- "capabilities": ["scopes.canManageScopes"],
210
- "description": "Delete a scope",
211
- "requestType": "ScopesDeleteRequest",
212
- "responseType": "ScopesDeleteResponse"
213
- },
214
- "map/scopes/join": {
215
- "tier": "structure",
216
- "implementedBy": "system",
217
- "callableBy": ["agent", "system"],
218
- "capabilities": [],
219
- "description": "Add an agent to a scope",
220
- "requestType": "ScopesJoinRequest",
221
- "responseType": "ScopesJoinResponse"
222
- },
223
- "map/scopes/leave": {
224
- "tier": "structure",
225
- "implementedBy": "system",
226
- "callableBy": ["agent", "system"],
227
- "capabilities": [],
228
- "description": "Remove an agent from a scope",
229
- "requestType": "ScopesLeaveRequest",
230
- "responseType": "ScopesLeaveResponse"
231
- },
232
- "map/scopes/members": {
233
- "tier": "structure",
234
- "implementedBy": "system",
235
- "callableBy": ["client", "agent"],
236
- "capabilities": ["observation.canQuery"],
237
- "description": "List members of a scope",
238
- "requestType": "ScopesMembersRequest",
239
- "responseType": "ScopesMembersResponse"
240
- },
241
- "map/inject": {
242
- "tier": "extension",
243
- "implementedBy": "system",
244
- "callableBy": ["client", "agent"],
245
- "capabilities": ["lifecycle.canSteer"],
246
- "description": "Inject context into a running agent (steering)",
247
- "requestType": "InjectRequest",
248
- "responseType": "InjectResponse"
249
- },
250
- "map/federation/connect": {
251
- "tier": "extension",
252
- "implementedBy": "system",
253
- "callableBy": ["system"],
254
- "capabilities": [],
255
- "description": "Connect to a peer MAP system",
256
- "requestType": "FederationConnectRequest",
257
- "responseType": "FederationConnectResponse"
258
- },
259
- "map/federation/route": {
260
- "tier": "extension",
261
- "implementedBy": "system",
262
- "callableBy": ["agent", "system"],
263
- "capabilities": ["messaging.canSend"],
264
- "description": "Route a message to a federated system",
265
- "requestType": "FederationRouteRequest",
266
- "responseType": "FederationRouteResponse"
267
- },
268
- "mail/create": {
269
- "tier": "extension",
270
- "implementedBy": "system",
271
- "callableBy": ["client", "agent"],
272
- "capabilities": ["mail.canCreate"],
273
- "description": "Create a new conversation with optional initial participants and turn",
274
- "requestType": "MailCreateRequest",
275
- "responseType": "MailCreateResponse"
276
- },
277
- "mail/get": {
278
- "tier": "extension",
279
- "implementedBy": "system",
280
- "callableBy": ["client", "agent"],
281
- "capabilities": ["mail.canViewHistory"],
282
- "description": "Get conversation details with optional includes (participants, threads, recent turns, stats)",
283
- "requestType": "MailGetRequest",
284
- "responseType": "MailGetResponse"
285
- },
286
- "mail/list": {
287
- "tier": "extension",
288
- "implementedBy": "system",
289
- "callableBy": ["client", "agent"],
290
- "capabilities": ["mail.canViewHistory"],
291
- "description": "List conversations with filtering by type, status, participant, and time range",
292
- "requestType": "MailListRequest",
293
- "responseType": "MailListResponse"
294
- },
295
- "mail/close": {
296
- "tier": "extension",
297
- "implementedBy": "system",
298
- "callableBy": ["client", "agent"],
299
- "capabilities": [],
300
- "description": "Close a conversation (must be a participant)",
301
- "requestType": "MailCloseRequest",
302
- "responseType": "MailCloseResponse"
303
- },
304
- "mail/join": {
305
- "tier": "extension",
306
- "implementedBy": "system",
307
- "callableBy": ["client", "agent"],
308
- "capabilities": ["mail.canJoin"],
309
- "description": "Join a conversation with optional catch-up history",
310
- "requestType": "MailJoinRequest",
311
- "responseType": "MailJoinResponse"
312
- },
313
- "mail/leave": {
314
- "tier": "extension",
315
- "implementedBy": "system",
316
- "callableBy": ["client", "agent"],
317
- "capabilities": [],
318
- "description": "Leave a conversation (must be a participant)",
319
- "requestType": "MailLeaveRequest",
320
- "responseType": "MailLeaveResponse"
321
- },
322
- "mail/invite": {
323
- "tier": "extension",
324
- "implementedBy": "system",
325
- "callableBy": ["client", "agent"],
326
- "capabilities": ["mail.canInvite"],
327
- "description": "Invite a participant to a conversation",
328
- "requestType": "MailInviteRequest",
329
- "responseType": "MailInviteResponse"
330
- },
331
- "mail/turn": {
332
- "tier": "extension",
333
- "implementedBy": "system",
334
- "callableBy": ["client", "agent"],
335
- "capabilities": [],
336
- "description": "Record a turn in a conversation (must be a participant)",
337
- "requestType": "MailTurnRequest",
338
- "responseType": "MailTurnResponse"
339
- },
340
- "mail/turns/list": {
341
- "tier": "extension",
342
- "implementedBy": "system",
343
- "callableBy": ["client", "agent"],
344
- "capabilities": ["mail.canViewHistory"],
345
- "description": "List turns in a conversation with filtering and pagination",
346
- "requestType": "MailTurnsListRequest",
347
- "responseType": "MailTurnsListResponse"
348
- },
349
- "mail/thread/create": {
350
- "tier": "extension",
351
- "implementedBy": "system",
352
- "callableBy": ["client", "agent"],
353
- "capabilities": ["mail.canCreateThreads"],
354
- "description": "Create a thread rooted at a specific turn",
355
- "requestType": "MailThreadCreateRequest",
356
- "responseType": "MailThreadCreateResponse"
357
- },
358
- "mail/thread/list": {
359
- "tier": "extension",
360
- "implementedBy": "system",
361
- "callableBy": ["client", "agent"],
362
- "capabilities": ["mail.canViewHistory"],
363
- "description": "List threads in a conversation",
364
- "requestType": "MailThreadListRequest",
365
- "responseType": "MailThreadListResponse"
366
- },
367
- "mail/summary": {
368
- "tier": "extension",
369
- "implementedBy": "system",
370
- "callableBy": ["client", "agent"],
371
- "capabilities": ["mail.canViewHistory"],
372
- "description": "Get or generate a summary for a conversation",
373
- "requestType": "MailSummaryRequest",
374
- "responseType": "MailSummaryResponse"
375
- },
376
- "mail/replay": {
377
- "tier": "extension",
378
- "implementedBy": "system",
379
- "callableBy": ["client", "agent"],
380
- "capabilities": ["mail.canViewHistory"],
381
- "description": "Replay conversation turns from a specific point",
382
- "requestType": "MailReplayRequest",
383
- "responseType": "MailReplayResponse"
384
- }
385
- },
386
- "notifications": {
387
- "map/event": {
388
- "tier": "core",
389
- "direction": "system-to-participant",
390
- "description": "System event notification (sent to subscribers)",
391
- "paramsType": "EventNotification"
392
- },
393
- "map/message": {
394
- "tier": "core",
395
- "direction": "system-to-participant",
396
- "description": "Message delivery notification",
397
- "paramsType": "MessageNotification"
398
- }
399
- },
400
- "errorCodes": {
401
- "protocol": {
402
- "-32700": "Parse error",
403
- "-32600": "Invalid request",
404
- "-32601": "Method not found",
405
- "-32602": "Invalid params",
406
- "-32603": "Internal error"
407
- },
408
- "auth": {
409
- "1000": "Authentication required",
410
- "1001": "Authentication failed",
411
- "1002": "Token expired",
412
- "1003": "Insufficient permissions"
413
- },
414
- "routing": {
415
- "2000": "Address not found",
416
- "2001": "Agent not found",
417
- "2002": "Scope not found",
418
- "2003": "Delivery failed",
419
- "2004": "Address ambiguous"
420
- },
421
- "agent": {
422
- "3000": "Agent already exists",
423
- "3001": "Agent state invalid",
424
- "3002": "Agent not responding",
425
- "3003": "Agent terminated",
426
- "3004": "Spawn failed"
427
- },
428
- "resource": {
429
- "4000": "Resource exhausted",
430
- "4001": "Rate limited",
431
- "4002": "Quota exceeded"
432
- },
433
- "federation": {
434
- "5000": "Federation unavailable",
435
- "5001": "System not found",
436
- "5002": "Federation auth failed",
437
- "5003": "Route rejected"
438
- },
439
- "mail": {
440
- "10000": "Conversation not found",
441
- "10001": "Conversation closed",
442
- "10002": "Not a participant",
443
- "10003": "Mail permission denied",
444
- "10004": "Participant already joined",
445
- "10005": "Participant not found",
446
- "10006": "Turn not found",
447
- "10007": "Thread not found",
448
- "10008": "Invalid content type",
449
- "10009": "Thread nesting limit exceeded",
450
- "10010": "Mail not enabled"
451
- }
452
- },
453
- "tiers": {
454
- "core": {
455
- "description": "Required methods for basic MAP functionality",
456
- "required": true
457
- },
458
- "structure": {
459
- "description": "Methods for agent lifecycle and system structure management",
460
- "required": false
461
- },
462
- "extension": {
463
- "description": "Optional extension methods for advanced features",
464
- "required": false
465
- }
466
- }
467
- }