0agent 1.0.0

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 (443) hide show
  1. package/README.md +164 -0
  2. package/bin/0agent.js +614 -0
  3. package/package.json +59 -0
  4. package/packages/core/dist/bootstrap/BootstrapProtocol.d.ts +37 -0
  5. package/packages/core/dist/bootstrap/BootstrapProtocol.d.ts.map +1 -0
  6. package/packages/core/dist/bootstrap/BootstrapProtocol.js +82 -0
  7. package/packages/core/dist/bootstrap/BootstrapProtocol.js.map +1 -0
  8. package/packages/core/dist/bootstrap/GraphConstructor.d.ts +44 -0
  9. package/packages/core/dist/bootstrap/GraphConstructor.d.ts.map +1 -0
  10. package/packages/core/dist/bootstrap/GraphConstructor.js +160 -0
  11. package/packages/core/dist/bootstrap/GraphConstructor.js.map +1 -0
  12. package/packages/core/dist/bootstrap/HypothesisManager.d.ts +50 -0
  13. package/packages/core/dist/bootstrap/HypothesisManager.d.ts.map +1 -0
  14. package/packages/core/dist/bootstrap/HypothesisManager.js +108 -0
  15. package/packages/core/dist/bootstrap/HypothesisManager.js.map +1 -0
  16. package/packages/core/dist/bootstrap/StagedMutations.d.ts +50 -0
  17. package/packages/core/dist/bootstrap/StagedMutations.d.ts.map +1 -0
  18. package/packages/core/dist/bootstrap/StagedMutations.js +80 -0
  19. package/packages/core/dist/bootstrap/StagedMutations.js.map +1 -0
  20. package/packages/core/dist/concurrency/EdgeWeightUpdater.d.ts +16 -0
  21. package/packages/core/dist/concurrency/EdgeWeightUpdater.d.ts.map +1 -0
  22. package/packages/core/dist/concurrency/EdgeWeightUpdater.js +57 -0
  23. package/packages/core/dist/concurrency/EdgeWeightUpdater.js.map +1 -0
  24. package/packages/core/dist/concurrency/SessionSnapshot.d.ts +63 -0
  25. package/packages/core/dist/concurrency/SessionSnapshot.d.ts.map +1 -0
  26. package/packages/core/dist/concurrency/SessionSnapshot.js +124 -0
  27. package/packages/core/dist/concurrency/SessionSnapshot.js.map +1 -0
  28. package/packages/core/dist/embedding/HNSWIndex.d.ts +37 -0
  29. package/packages/core/dist/embedding/HNSWIndex.d.ts.map +1 -0
  30. package/packages/core/dist/embedding/HNSWIndex.js +86 -0
  31. package/packages/core/dist/embedding/HNSWIndex.js.map +1 -0
  32. package/packages/core/dist/embedding/MultimodalEmbedder.d.ts +24 -0
  33. package/packages/core/dist/embedding/MultimodalEmbedder.d.ts.map +1 -0
  34. package/packages/core/dist/embedding/MultimodalEmbedder.js +75 -0
  35. package/packages/core/dist/embedding/MultimodalEmbedder.js.map +1 -0
  36. package/packages/core/dist/embedding/adapters/NomicAdapter.d.ts +7 -0
  37. package/packages/core/dist/embedding/adapters/NomicAdapter.d.ts.map +1 -0
  38. package/packages/core/dist/embedding/adapters/NomicAdapter.js +11 -0
  39. package/packages/core/dist/embedding/adapters/NomicAdapter.js.map +1 -0
  40. package/packages/core/dist/embedding/adapters/OllamaAdapter.d.ts +19 -0
  41. package/packages/core/dist/embedding/adapters/OllamaAdapter.d.ts.map +1 -0
  42. package/packages/core/dist/embedding/adapters/OllamaAdapter.js +27 -0
  43. package/packages/core/dist/embedding/adapters/OllamaAdapter.js.map +1 -0
  44. package/packages/core/dist/embedding/adapters/OpenAIAdapter.d.ts +14 -0
  45. package/packages/core/dist/embedding/adapters/OpenAIAdapter.d.ts.map +1 -0
  46. package/packages/core/dist/embedding/adapters/OpenAIAdapter.js +48 -0
  47. package/packages/core/dist/embedding/adapters/OpenAIAdapter.js.map +1 -0
  48. package/packages/core/dist/engine/CreditAttribution.d.ts +47 -0
  49. package/packages/core/dist/engine/CreditAttribution.d.ts.map +1 -0
  50. package/packages/core/dist/engine/CreditAttribution.js +196 -0
  51. package/packages/core/dist/engine/CreditAttribution.js.map +1 -0
  52. package/packages/core/dist/engine/DecayScheduler.d.ts +45 -0
  53. package/packages/core/dist/engine/DecayScheduler.d.ts.map +1 -0
  54. package/packages/core/dist/engine/DecayScheduler.js +115 -0
  55. package/packages/core/dist/engine/DecayScheduler.js.map +1 -0
  56. package/packages/core/dist/engine/InferenceEngine.d.ts +95 -0
  57. package/packages/core/dist/engine/InferenceEngine.d.ts.map +1 -0
  58. package/packages/core/dist/engine/InferenceEngine.js +242 -0
  59. package/packages/core/dist/engine/InferenceEngine.js.map +1 -0
  60. package/packages/core/dist/engine/SelectionPolicy.d.ts +29 -0
  61. package/packages/core/dist/engine/SelectionPolicy.d.ts.map +1 -0
  62. package/packages/core/dist/engine/SelectionPolicy.js +58 -0
  63. package/packages/core/dist/engine/SelectionPolicy.js.map +1 -0
  64. package/packages/core/dist/engine/SelfImprovementEngine.d.ts +58 -0
  65. package/packages/core/dist/engine/SelfImprovementEngine.d.ts.map +1 -0
  66. package/packages/core/dist/engine/SelfImprovementEngine.js +265 -0
  67. package/packages/core/dist/engine/SelfImprovementEngine.js.map +1 -0
  68. package/packages/core/dist/engine/SelfImprovementPrompt.d.ts +10 -0
  69. package/packages/core/dist/engine/SelfImprovementPrompt.d.ts.map +1 -0
  70. package/packages/core/dist/engine/SelfImprovementPrompt.js +193 -0
  71. package/packages/core/dist/engine/SelfImprovementPrompt.js.map +1 -0
  72. package/packages/core/dist/engine/WeightPropagation.d.ts +77 -0
  73. package/packages/core/dist/engine/WeightPropagation.d.ts.map +1 -0
  74. package/packages/core/dist/engine/WeightPropagation.js +101 -0
  75. package/packages/core/dist/engine/WeightPropagation.js.map +1 -0
  76. package/packages/core/dist/engine/WorkflowSuggestionEngine.d.ts +26 -0
  77. package/packages/core/dist/engine/WorkflowSuggestionEngine.d.ts.map +1 -0
  78. package/packages/core/dist/engine/WorkflowSuggestionEngine.js +54 -0
  79. package/packages/core/dist/engine/WorkflowSuggestionEngine.js.map +1 -0
  80. package/packages/core/dist/entity/AliasIndex.d.ts +39 -0
  81. package/packages/core/dist/entity/AliasIndex.d.ts.map +1 -0
  82. package/packages/core/dist/entity/AliasIndex.js +81 -0
  83. package/packages/core/dist/entity/AliasIndex.js.map +1 -0
  84. package/packages/core/dist/entity/ContextActivator.d.ts +53 -0
  85. package/packages/core/dist/entity/ContextActivator.d.ts.map +1 -0
  86. package/packages/core/dist/entity/ContextActivator.js +163 -0
  87. package/packages/core/dist/entity/ContextActivator.js.map +1 -0
  88. package/packages/core/dist/entity/EntityHierarchy.d.ts +48 -0
  89. package/packages/core/dist/entity/EntityHierarchy.d.ts.map +1 -0
  90. package/packages/core/dist/entity/EntityHierarchy.js +134 -0
  91. package/packages/core/dist/entity/EntityHierarchy.js.map +1 -0
  92. package/packages/core/dist/entity/EntityResolutionPipeline.d.ts +48 -0
  93. package/packages/core/dist/entity/EntityResolutionPipeline.d.ts.map +1 -0
  94. package/packages/core/dist/entity/EntityResolutionPipeline.js +221 -0
  95. package/packages/core/dist/entity/EntityResolutionPipeline.js.map +1 -0
  96. package/packages/core/dist/entity/MCPEnrichedResolver.d.ts +17 -0
  97. package/packages/core/dist/entity/MCPEnrichedResolver.d.ts.map +1 -0
  98. package/packages/core/dist/entity/MCPEnrichedResolver.js +19 -0
  99. package/packages/core/dist/entity/MCPEnrichedResolver.js.map +1 -0
  100. package/packages/core/dist/entity/NodeResolutionService.d.ts +46 -0
  101. package/packages/core/dist/entity/NodeResolutionService.d.ts.map +1 -0
  102. package/packages/core/dist/entity/NodeResolutionService.js +150 -0
  103. package/packages/core/dist/entity/NodeResolutionService.js.map +1 -0
  104. package/packages/core/dist/entity/PersonalityAccumulator.d.ts +41 -0
  105. package/packages/core/dist/entity/PersonalityAccumulator.d.ts.map +1 -0
  106. package/packages/core/dist/entity/PersonalityAccumulator.js +126 -0
  107. package/packages/core/dist/entity/PersonalityAccumulator.js.map +1 -0
  108. package/packages/core/dist/entity/PersonalityProfile.d.ts +31 -0
  109. package/packages/core/dist/entity/PersonalityProfile.d.ts.map +1 -0
  110. package/packages/core/dist/entity/PersonalityProfile.js +94 -0
  111. package/packages/core/dist/entity/PersonalityProfile.js.map +1 -0
  112. package/packages/core/dist/entity/index.d.ts +4 -0
  113. package/packages/core/dist/entity/index.d.ts.map +1 -0
  114. package/packages/core/dist/entity/index.js +4 -0
  115. package/packages/core/dist/entity/index.js.map +1 -0
  116. package/packages/core/dist/graph/GraphEdge.d.ts +37 -0
  117. package/packages/core/dist/graph/GraphEdge.d.ts.map +1 -0
  118. package/packages/core/dist/graph/GraphEdge.js +29 -0
  119. package/packages/core/dist/graph/GraphEdge.js.map +1 -0
  120. package/packages/core/dist/graph/GraphNode.d.ts +52 -0
  121. package/packages/core/dist/graph/GraphNode.d.ts.map +1 -0
  122. package/packages/core/dist/graph/GraphNode.js +41 -0
  123. package/packages/core/dist/graph/GraphNode.js.map +1 -0
  124. package/packages/core/dist/graph/GraphQuery.d.ts +46 -0
  125. package/packages/core/dist/graph/GraphQuery.d.ts.map +1 -0
  126. package/packages/core/dist/graph/GraphQuery.js +47 -0
  127. package/packages/core/dist/graph/GraphQuery.js.map +1 -0
  128. package/packages/core/dist/graph/KnowledgeGraph.d.ts +38 -0
  129. package/packages/core/dist/graph/KnowledgeGraph.d.ts.map +1 -0
  130. package/packages/core/dist/graph/KnowledgeGraph.js +345 -0
  131. package/packages/core/dist/graph/KnowledgeGraph.js.map +1 -0
  132. package/packages/core/dist/graph/SubGraph.d.ts +36 -0
  133. package/packages/core/dist/graph/SubGraph.d.ts.map +1 -0
  134. package/packages/core/dist/graph/SubGraph.js +86 -0
  135. package/packages/core/dist/graph/SubGraph.js.map +1 -0
  136. package/packages/core/dist/index.d.ts +54 -0
  137. package/packages/core/dist/index.d.ts.map +1 -0
  138. package/packages/core/dist/index.js +62 -0
  139. package/packages/core/dist/index.js.map +1 -0
  140. package/packages/core/dist/maintenance/CompactionOrchestrator.d.ts +22 -0
  141. package/packages/core/dist/maintenance/CompactionOrchestrator.d.ts.map +1 -0
  142. package/packages/core/dist/maintenance/CompactionOrchestrator.js +62 -0
  143. package/packages/core/dist/maintenance/CompactionOrchestrator.js.map +1 -0
  144. package/packages/core/dist/maintenance/EdgePruner.d.ts +20 -0
  145. package/packages/core/dist/maintenance/EdgePruner.d.ts.map +1 -0
  146. package/packages/core/dist/maintenance/EdgePruner.js +65 -0
  147. package/packages/core/dist/maintenance/EdgePruner.js.map +1 -0
  148. package/packages/core/dist/maintenance/GraphCheckpoint.d.ts +51 -0
  149. package/packages/core/dist/maintenance/GraphCheckpoint.d.ts.map +1 -0
  150. package/packages/core/dist/maintenance/GraphCheckpoint.js +81 -0
  151. package/packages/core/dist/maintenance/GraphCheckpoint.js.map +1 -0
  152. package/packages/core/dist/maintenance/GraphRollback.d.ts +36 -0
  153. package/packages/core/dist/maintenance/GraphRollback.d.ts.map +1 -0
  154. package/packages/core/dist/maintenance/GraphRollback.js +154 -0
  155. package/packages/core/dist/maintenance/GraphRollback.js.map +1 -0
  156. package/packages/core/dist/maintenance/NodeDeduplicator.d.ts +26 -0
  157. package/packages/core/dist/maintenance/NodeDeduplicator.d.ts.map +1 -0
  158. package/packages/core/dist/maintenance/NodeDeduplicator.js +171 -0
  159. package/packages/core/dist/maintenance/NodeDeduplicator.js.map +1 -0
  160. package/packages/core/dist/maintenance/SubgraphArchiver.d.ts +18 -0
  161. package/packages/core/dist/maintenance/SubgraphArchiver.d.ts.map +1 -0
  162. package/packages/core/dist/maintenance/SubgraphArchiver.js +180 -0
  163. package/packages/core/dist/maintenance/SubgraphArchiver.js.map +1 -0
  164. package/packages/core/dist/memory/ArchivalMemory.d.ts +28 -0
  165. package/packages/core/dist/memory/ArchivalMemory.d.ts.map +1 -0
  166. package/packages/core/dist/memory/ArchivalMemory.js +26 -0
  167. package/packages/core/dist/memory/ArchivalMemory.js.map +1 -0
  168. package/packages/core/dist/memory/BlinkingMemory.d.ts +34 -0
  169. package/packages/core/dist/memory/BlinkingMemory.d.ts.map +1 -0
  170. package/packages/core/dist/memory/BlinkingMemory.js +44 -0
  171. package/packages/core/dist/memory/BlinkingMemory.js.map +1 -0
  172. package/packages/core/dist/memory/WorkingMemory.d.ts +38 -0
  173. package/packages/core/dist/memory/WorkingMemory.d.ts.map +1 -0
  174. package/packages/core/dist/memory/WorkingMemory.js +70 -0
  175. package/packages/core/dist/memory/WorkingMemory.js.map +1 -0
  176. package/packages/core/dist/storage/ObjectStore.d.ts +24 -0
  177. package/packages/core/dist/storage/ObjectStore.d.ts.map +1 -0
  178. package/packages/core/dist/storage/ObjectStore.js +50 -0
  179. package/packages/core/dist/storage/ObjectStore.js.map +1 -0
  180. package/packages/core/dist/storage/TraceStore.d.ts +16 -0
  181. package/packages/core/dist/storage/TraceStore.d.ts.map +1 -0
  182. package/packages/core/dist/storage/TraceStore.js +19 -0
  183. package/packages/core/dist/storage/TraceStore.js.map +1 -0
  184. package/packages/core/dist/storage/WeightEventLog.d.ts +11 -0
  185. package/packages/core/dist/storage/WeightEventLog.d.ts.map +1 -0
  186. package/packages/core/dist/storage/WeightEventLog.js +16 -0
  187. package/packages/core/dist/storage/WeightEventLog.js.map +1 -0
  188. package/packages/core/dist/storage/adapters/SQLiteAdapter.d.ts +86 -0
  189. package/packages/core/dist/storage/adapters/SQLiteAdapter.d.ts.map +1 -0
  190. package/packages/core/dist/storage/adapters/SQLiteAdapter.js +514 -0
  191. package/packages/core/dist/storage/adapters/SQLiteAdapter.js.map +1 -0
  192. package/packages/core/dist/trace/DeferredTrace.d.ts +43 -0
  193. package/packages/core/dist/trace/DeferredTrace.d.ts.map +1 -0
  194. package/packages/core/dist/trace/DeferredTrace.js +44 -0
  195. package/packages/core/dist/trace/DeferredTrace.js.map +1 -0
  196. package/packages/core/dist/trace/OutcomeTrace.d.ts +38 -0
  197. package/packages/core/dist/trace/OutcomeTrace.d.ts.map +1 -0
  198. package/packages/core/dist/trace/OutcomeTrace.js +9 -0
  199. package/packages/core/dist/trace/OutcomeTrace.js.map +1 -0
  200. package/packages/core/dist/trace/SkillTraceDecorator.d.ts +25 -0
  201. package/packages/core/dist/trace/SkillTraceDecorator.d.ts.map +1 -0
  202. package/packages/core/dist/trace/SkillTraceDecorator.js +41 -0
  203. package/packages/core/dist/trace/SkillTraceDecorator.js.map +1 -0
  204. package/packages/core/dist/trace/TraceReplay.d.ts +25 -0
  205. package/packages/core/dist/trace/TraceReplay.d.ts.map +1 -0
  206. package/packages/core/dist/trace/TraceReplay.js +40 -0
  207. package/packages/core/dist/trace/TraceReplay.js.map +1 -0
  208. package/packages/core/dist/trace/TraversalLedger.d.ts +33 -0
  209. package/packages/core/dist/trace/TraversalLedger.d.ts.map +1 -0
  210. package/packages/core/dist/trace/TraversalLedger.js +61 -0
  211. package/packages/core/dist/trace/TraversalLedger.js.map +1 -0
  212. package/packages/core/dist/types/SelfImprovement.d.ts +174 -0
  213. package/packages/core/dist/types/SelfImprovement.d.ts.map +1 -0
  214. package/packages/core/dist/types/SelfImprovement.js +23 -0
  215. package/packages/core/dist/types/SelfImprovement.js.map +1 -0
  216. package/packages/core/dist/types/SkillDefinition.d.ts +68 -0
  217. package/packages/core/dist/types/SkillDefinition.d.ts.map +1 -0
  218. package/packages/core/dist/types/SkillDefinition.js +12 -0
  219. package/packages/core/dist/types/SkillDefinition.js.map +1 -0
  220. package/packages/daemon/dist/BackgroundWorkers.d.ts +55 -0
  221. package/packages/daemon/dist/BackgroundWorkers.d.ts.map +1 -0
  222. package/packages/daemon/dist/BackgroundWorkers.js +121 -0
  223. package/packages/daemon/dist/BackgroundWorkers.js.map +1 -0
  224. package/packages/daemon/dist/EntityScopedContext.d.ts +22 -0
  225. package/packages/daemon/dist/EntityScopedContext.d.ts.map +1 -0
  226. package/packages/daemon/dist/EntityScopedContext.js +85 -0
  227. package/packages/daemon/dist/EntityScopedContext.js.map +1 -0
  228. package/packages/daemon/dist/HTTPServer.d.ts +27 -0
  229. package/packages/daemon/dist/HTTPServer.d.ts.map +1 -0
  230. package/packages/daemon/dist/HTTPServer.js +62 -0
  231. package/packages/daemon/dist/HTTPServer.js.map +1 -0
  232. package/packages/daemon/dist/SessionManager.d.ts +95 -0
  233. package/packages/daemon/dist/SessionManager.d.ts.map +1 -0
  234. package/packages/daemon/dist/SessionManager.js +205 -0
  235. package/packages/daemon/dist/SessionManager.js.map +1 -0
  236. package/packages/daemon/dist/SkillRegistry.d.ts +34 -0
  237. package/packages/daemon/dist/SkillRegistry.d.ts.map +1 -0
  238. package/packages/daemon/dist/SkillRegistry.js +90 -0
  239. package/packages/daemon/dist/SkillRegistry.js.map +1 -0
  240. package/packages/daemon/dist/SkillVariableResolver.d.ts +24 -0
  241. package/packages/daemon/dist/SkillVariableResolver.d.ts.map +1 -0
  242. package/packages/daemon/dist/SkillVariableResolver.js +85 -0
  243. package/packages/daemon/dist/SkillVariableResolver.js.map +1 -0
  244. package/packages/daemon/dist/WebSocketEvents.d.ts +107 -0
  245. package/packages/daemon/dist/WebSocketEvents.d.ts.map +1 -0
  246. package/packages/daemon/dist/WebSocketEvents.js +111 -0
  247. package/packages/daemon/dist/WebSocketEvents.js.map +1 -0
  248. package/packages/daemon/dist/ZeroAgentDaemon.d.ts +39 -0
  249. package/packages/daemon/dist/ZeroAgentDaemon.d.ts.map +1 -0
  250. package/packages/daemon/dist/ZeroAgentDaemon.js +161 -0
  251. package/packages/daemon/dist/ZeroAgentDaemon.js.map +1 -0
  252. package/packages/daemon/dist/config/ConfigSchema.d.ts +631 -0
  253. package/packages/daemon/dist/config/ConfigSchema.d.ts.map +1 -0
  254. package/packages/daemon/dist/config/ConfigSchema.js +107 -0
  255. package/packages/daemon/dist/config/ConfigSchema.js.map +1 -0
  256. package/packages/daemon/dist/config/DaemonConfig.d.ts +10 -0
  257. package/packages/daemon/dist/config/DaemonConfig.d.ts.map +1 -0
  258. package/packages/daemon/dist/config/DaemonConfig.js +34 -0
  259. package/packages/daemon/dist/config/DaemonConfig.js.map +1 -0
  260. package/packages/daemon/dist/index.d.ts +10 -0
  261. package/packages/daemon/dist/index.d.ts.map +1 -0
  262. package/packages/daemon/dist/index.js +8 -0
  263. package/packages/daemon/dist/index.js.map +1 -0
  264. package/packages/daemon/dist/routes/entities.d.ts +6 -0
  265. package/packages/daemon/dist/routes/entities.d.ts.map +1 -0
  266. package/packages/daemon/dist/routes/entities.js +54 -0
  267. package/packages/daemon/dist/routes/entities.js.map +1 -0
  268. package/packages/daemon/dist/routes/graph.d.ts +6 -0
  269. package/packages/daemon/dist/routes/graph.d.ts.map +1 -0
  270. package/packages/daemon/dist/routes/graph.js +61 -0
  271. package/packages/daemon/dist/routes/graph.js.map +1 -0
  272. package/packages/daemon/dist/routes/health.d.ts +15 -0
  273. package/packages/daemon/dist/routes/health.d.ts.map +1 -0
  274. package/packages/daemon/dist/routes/health.js +11 -0
  275. package/packages/daemon/dist/routes/health.js.map +1 -0
  276. package/packages/daemon/dist/routes/sessions.d.ts +6 -0
  277. package/packages/daemon/dist/routes/sessions.d.ts.map +1 -0
  278. package/packages/daemon/dist/routes/sessions.js +43 -0
  279. package/packages/daemon/dist/routes/sessions.js.map +1 -0
  280. package/packages/daemon/dist/routes/skills.d.ts +6 -0
  281. package/packages/daemon/dist/routes/skills.d.ts.map +1 -0
  282. package/packages/daemon/dist/routes/skills.js +62 -0
  283. package/packages/daemon/dist/routes/skills.js.map +1 -0
  284. package/packages/daemon/dist/routes/subagents.d.ts +3 -0
  285. package/packages/daemon/dist/routes/subagents.d.ts.map +1 -0
  286. package/packages/daemon/dist/routes/subagents.js +14 -0
  287. package/packages/daemon/dist/routes/subagents.js.map +1 -0
  288. package/packages/daemon/dist/routes/traces.d.ts +6 -0
  289. package/packages/daemon/dist/routes/traces.d.ts.map +1 -0
  290. package/packages/daemon/dist/routes/traces.js +31 -0
  291. package/packages/daemon/dist/routes/traces.js.map +1 -0
  292. package/packages/daemon/dist/start.d.ts +7 -0
  293. package/packages/daemon/dist/start.d.ts.map +1 -0
  294. package/packages/daemon/dist/start.js +24 -0
  295. package/packages/daemon/dist/start.js.map +1 -0
  296. package/packages/mcp-hub/dist/FilteredProxy.d.ts +20 -0
  297. package/packages/mcp-hub/dist/FilteredProxy.d.ts.map +1 -0
  298. package/packages/mcp-hub/dist/FilteredProxy.js +43 -0
  299. package/packages/mcp-hub/dist/FilteredProxy.js.map +1 -0
  300. package/packages/mcp-hub/dist/MCPDiscovery.d.ts +18 -0
  301. package/packages/mcp-hub/dist/MCPDiscovery.d.ts.map +1 -0
  302. package/packages/mcp-hub/dist/MCPDiscovery.js +86 -0
  303. package/packages/mcp-hub/dist/MCPDiscovery.js.map +1 -0
  304. package/packages/mcp-hub/dist/MCPHub.d.ts +48 -0
  305. package/packages/mcp-hub/dist/MCPHub.d.ts.map +1 -0
  306. package/packages/mcp-hub/dist/MCPHub.js +100 -0
  307. package/packages/mcp-hub/dist/MCPHub.js.map +1 -0
  308. package/packages/mcp-hub/dist/builtin/BrowserMCP.d.ts +6 -0
  309. package/packages/mcp-hub/dist/builtin/BrowserMCP.d.ts.map +1 -0
  310. package/packages/mcp-hub/dist/builtin/BrowserMCP.js +69 -0
  311. package/packages/mcp-hub/dist/builtin/BrowserMCP.js.map +1 -0
  312. package/packages/mcp-hub/dist/builtin/FilesystemMCP.d.ts +11 -0
  313. package/packages/mcp-hub/dist/builtin/FilesystemMCP.d.ts.map +1 -0
  314. package/packages/mcp-hub/dist/builtin/FilesystemMCP.js +104 -0
  315. package/packages/mcp-hub/dist/builtin/FilesystemMCP.js.map +1 -0
  316. package/packages/mcp-hub/dist/builtin/MemoryMCP.d.ts +9 -0
  317. package/packages/mcp-hub/dist/builtin/MemoryMCP.d.ts.map +1 -0
  318. package/packages/mcp-hub/dist/builtin/MemoryMCP.js +185 -0
  319. package/packages/mcp-hub/dist/builtin/MemoryMCP.js.map +1 -0
  320. package/packages/mcp-hub/dist/builtin/ShellMCP.d.ts +8 -0
  321. package/packages/mcp-hub/dist/builtin/ShellMCP.d.ts.map +1 -0
  322. package/packages/mcp-hub/dist/builtin/ShellMCP.js +74 -0
  323. package/packages/mcp-hub/dist/builtin/ShellMCP.js.map +1 -0
  324. package/packages/mcp-hub/dist/index.d.ts +9 -0
  325. package/packages/mcp-hub/dist/index.d.ts.map +1 -0
  326. package/packages/mcp-hub/dist/index.js +8 -0
  327. package/packages/mcp-hub/dist/index.js.map +1 -0
  328. package/packages/mcp-hub/dist/types.d.ts +30 -0
  329. package/packages/mcp-hub/dist/types.d.ts.map +1 -0
  330. package/packages/mcp-hub/dist/types.js +2 -0
  331. package/packages/mcp-hub/dist/types.js.map +1 -0
  332. package/packages/subagent/dist/CapabilityToken.d.ts +66 -0
  333. package/packages/subagent/dist/CapabilityToken.d.ts.map +1 -0
  334. package/packages/subagent/dist/CapabilityToken.js +120 -0
  335. package/packages/subagent/dist/CapabilityToken.js.map +1 -0
  336. package/packages/subagent/dist/ResourceDefaults.d.ts +16 -0
  337. package/packages/subagent/dist/ResourceDefaults.d.ts.map +1 -0
  338. package/packages/subagent/dist/ResourceDefaults.js +68 -0
  339. package/packages/subagent/dist/ResourceDefaults.js.map +1 -0
  340. package/packages/subagent/dist/SkillInputResolver.d.ts +30 -0
  341. package/packages/subagent/dist/SkillInputResolver.d.ts.map +1 -0
  342. package/packages/subagent/dist/SkillInputResolver.js +59 -0
  343. package/packages/subagent/dist/SkillInputResolver.js.map +1 -0
  344. package/packages/subagent/dist/SkillInvoker.d.ts +33 -0
  345. package/packages/subagent/dist/SkillInvoker.d.ts.map +1 -0
  346. package/packages/subagent/dist/SkillInvoker.js +69 -0
  347. package/packages/subagent/dist/SkillInvoker.js.map +1 -0
  348. package/packages/subagent/dist/SubagentOrchestrator.d.ts +52 -0
  349. package/packages/subagent/dist/SubagentOrchestrator.d.ts.map +1 -0
  350. package/packages/subagent/dist/SubagentOrchestrator.js +198 -0
  351. package/packages/subagent/dist/SubagentOrchestrator.js.map +1 -0
  352. package/packages/subagent/dist/SubagentResult.d.ts +34 -0
  353. package/packages/subagent/dist/SubagentResult.d.ts.map +1 -0
  354. package/packages/subagent/dist/SubagentResult.js +21 -0
  355. package/packages/subagent/dist/SubagentResult.js.map +1 -0
  356. package/packages/subagent/dist/Watchdog.d.ts +23 -0
  357. package/packages/subagent/dist/Watchdog.d.ts.map +1 -0
  358. package/packages/subagent/dist/Watchdog.js +44 -0
  359. package/packages/subagent/dist/Watchdog.js.map +1 -0
  360. package/packages/subagent/dist/index.d.ts +15 -0
  361. package/packages/subagent/dist/index.d.ts.map +1 -0
  362. package/packages/subagent/dist/index.js +23 -0
  363. package/packages/subagent/dist/index.js.map +1 -0
  364. package/packages/subagent/dist/sandbox/BwrapBackend.d.ts +14 -0
  365. package/packages/subagent/dist/sandbox/BwrapBackend.d.ts.map +1 -0
  366. package/packages/subagent/dist/sandbox/BwrapBackend.js +171 -0
  367. package/packages/subagent/dist/sandbox/BwrapBackend.js.map +1 -0
  368. package/packages/subagent/dist/sandbox/CloudBackend.d.ts +28 -0
  369. package/packages/subagent/dist/sandbox/CloudBackend.d.ts.map +1 -0
  370. package/packages/subagent/dist/sandbox/CloudBackend.js +52 -0
  371. package/packages/subagent/dist/sandbox/CloudBackend.js.map +1 -0
  372. package/packages/subagent/dist/sandbox/DockerBackend.d.ts +14 -0
  373. package/packages/subagent/dist/sandbox/DockerBackend.d.ts.map +1 -0
  374. package/packages/subagent/dist/sandbox/DockerBackend.js +149 -0
  375. package/packages/subagent/dist/sandbox/DockerBackend.js.map +1 -0
  376. package/packages/subagent/dist/sandbox/FirecrackerBackend.d.ts +17 -0
  377. package/packages/subagent/dist/sandbox/FirecrackerBackend.d.ts.map +1 -0
  378. package/packages/subagent/dist/sandbox/FirecrackerBackend.js +54 -0
  379. package/packages/subagent/dist/sandbox/FirecrackerBackend.js.map +1 -0
  380. package/packages/subagent/dist/sandbox/PodmanBackend.d.ts +13 -0
  381. package/packages/subagent/dist/sandbox/PodmanBackend.d.ts.map +1 -0
  382. package/packages/subagent/dist/sandbox/PodmanBackend.js +144 -0
  383. package/packages/subagent/dist/sandbox/PodmanBackend.js.map +1 -0
  384. package/packages/subagent/dist/sandbox/ProcessBackend.d.ts +16 -0
  385. package/packages/subagent/dist/sandbox/ProcessBackend.d.ts.map +1 -0
  386. package/packages/subagent/dist/sandbox/ProcessBackend.js +152 -0
  387. package/packages/subagent/dist/sandbox/ProcessBackend.js.map +1 -0
  388. package/packages/subagent/dist/sandbox/SandboxManager.d.ts +17 -0
  389. package/packages/subagent/dist/sandbox/SandboxManager.d.ts.map +1 -0
  390. package/packages/subagent/dist/sandbox/SandboxManager.js +45 -0
  391. package/packages/subagent/dist/sandbox/SandboxManager.js.map +1 -0
  392. package/packages/subagent/dist/sandbox/types.d.ts +35 -0
  393. package/packages/subagent/dist/sandbox/types.d.ts.map +1 -0
  394. package/packages/subagent/dist/sandbox/types.js +5 -0
  395. package/packages/subagent/dist/sandbox/types.js.map +1 -0
  396. package/packages/subagent-runtime/dist/AgentLoop.d.ts +46 -0
  397. package/packages/subagent-runtime/dist/AgentLoop.d.ts.map +1 -0
  398. package/packages/subagent-runtime/dist/AgentLoop.js +85 -0
  399. package/packages/subagent-runtime/dist/AgentLoop.js.map +1 -0
  400. package/packages/subagent-runtime/dist/MCPProxy.d.ts +24 -0
  401. package/packages/subagent-runtime/dist/MCPProxy.d.ts.map +1 -0
  402. package/packages/subagent-runtime/dist/MCPProxy.js +31 -0
  403. package/packages/subagent-runtime/dist/MCPProxy.js.map +1 -0
  404. package/packages/subagent-runtime/dist/OutputChannel.d.ts +10 -0
  405. package/packages/subagent-runtime/dist/OutputChannel.d.ts.map +1 -0
  406. package/packages/subagent-runtime/dist/OutputChannel.js +14 -0
  407. package/packages/subagent-runtime/dist/OutputChannel.js.map +1 -0
  408. package/packages/subagent-runtime/dist/ResourceTracker.d.ts +29 -0
  409. package/packages/subagent-runtime/dist/ResourceTracker.d.ts.map +1 -0
  410. package/packages/subagent-runtime/dist/ResourceTracker.js +46 -0
  411. package/packages/subagent-runtime/dist/ResourceTracker.js.map +1 -0
  412. package/packages/subagent-runtime/dist/TokenValidator.d.ts +17 -0
  413. package/packages/subagent-runtime/dist/TokenValidator.d.ts.map +1 -0
  414. package/packages/subagent-runtime/dist/TokenValidator.js +29 -0
  415. package/packages/subagent-runtime/dist/TokenValidator.js.map +1 -0
  416. package/packages/subagent-runtime/dist/index.d.ts +6 -0
  417. package/packages/subagent-runtime/dist/index.d.ts.map +1 -0
  418. package/packages/subagent-runtime/dist/index.js +11 -0
  419. package/packages/subagent-runtime/dist/index.js.map +1 -0
  420. package/packages/subagent-runtime/dist/main.d.ts +2 -0
  421. package/packages/subagent-runtime/dist/main.d.ts.map +1 -0
  422. package/packages/subagent-runtime/dist/main.js +102 -0
  423. package/packages/subagent-runtime/dist/main.js.map +1 -0
  424. package/seeds/b2b-outbound/package.json +6 -0
  425. package/seeds/research/package.json +6 -0
  426. package/seeds/software-engineering/install.ts +78 -0
  427. package/seeds/software-engineering/package.json +6 -0
  428. package/seeds/software-engineering/sprint-workflow.json +102 -0
  429. package/skills/build.yaml +97 -0
  430. package/skills/debug.yaml +117 -0
  431. package/skills/design-review.yaml +119 -0
  432. package/skills/doc.yaml +107 -0
  433. package/skills/office-hours.yaml +76 -0
  434. package/skills/plan-ceo-review.yaml +84 -0
  435. package/skills/plan-eng-review.yaml +96 -0
  436. package/skills/qa.yaml +116 -0
  437. package/skills/refactor.yaml +125 -0
  438. package/skills/research.yaml +108 -0
  439. package/skills/retro.yaml +106 -0
  440. package/skills/review.yaml +101 -0
  441. package/skills/security-audit.yaml +114 -0
  442. package/skills/ship.yaml +108 -0
  443. package/skills/test-writer.yaml +131 -0
@@ -0,0 +1,185 @@
1
+ import { NodeType, ContentType, createNode, } from "@0agent/core";
2
+ export class MemoryMCP {
3
+ graph;
4
+ constructor(graph) {
5
+ this.graph = graph;
6
+ }
7
+ get tools() {
8
+ return [
9
+ {
10
+ name: "query_graph",
11
+ description: "Run a structural query against the knowledge graph",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ node_type: { type: "string", description: "Filter by node type" },
16
+ graph_id: { type: "string", description: "Filter by graph ID" },
17
+ limit: { type: "number", description: "Max results to return" },
18
+ },
19
+ },
20
+ server_name: "memory",
21
+ },
22
+ {
23
+ name: "get_entity",
24
+ description: "Get a node and its surrounding subgraph",
25
+ inputSchema: {
26
+ type: "object",
27
+ properties: {
28
+ id: { type: "string", description: "Node ID" },
29
+ depth: {
30
+ type: "number",
31
+ description: "Subgraph traversal depth (default 2)",
32
+ },
33
+ },
34
+ required: ["id"],
35
+ },
36
+ server_name: "memory",
37
+ },
38
+ {
39
+ name: "search_nodes",
40
+ description: "Semantic search across graph nodes",
41
+ inputSchema: {
42
+ type: "object",
43
+ properties: {
44
+ query: {
45
+ type: "string",
46
+ description: "Natural language search query",
47
+ },
48
+ limit: { type: "number", description: "Max results" },
49
+ },
50
+ required: ["query"],
51
+ },
52
+ server_name: "memory",
53
+ },
54
+ {
55
+ name: "add_observation",
56
+ description: "Add a new observation node to the graph",
57
+ inputSchema: {
58
+ type: "object",
59
+ properties: {
60
+ label: { type: "string", description: "Node label" },
61
+ content: {
62
+ type: "string",
63
+ description: "Text content / observation body",
64
+ },
65
+ graph_id: { type: "string", description: "Graph ID to add to" },
66
+ },
67
+ required: ["label", "content"],
68
+ },
69
+ server_name: "memory",
70
+ },
71
+ ];
72
+ }
73
+ async call(toolName, args) {
74
+ try {
75
+ switch (toolName) {
76
+ case "query_graph": {
77
+ const results = this.graph.queryStructural({
78
+ node_type: args.node_type,
79
+ graph_id: args.graph_id,
80
+ limit: args.limit ?? 20,
81
+ });
82
+ const simplified = results.map((r) => ({
83
+ id: r.node.id,
84
+ label: r.node.label,
85
+ type: r.node.type,
86
+ score: r.score,
87
+ }));
88
+ return {
89
+ content: [
90
+ { type: "text", text: JSON.stringify(simplified, null, 2) },
91
+ ],
92
+ };
93
+ }
94
+ case "get_entity": {
95
+ const id = args.id;
96
+ const depth = args.depth ?? 2;
97
+ const node = this.graph.getNode(id);
98
+ if (!node) {
99
+ return {
100
+ content: [{ type: "text", text: `Node '${id}' not found` }],
101
+ isError: true,
102
+ };
103
+ }
104
+ const subgraph = this.graph.getSubGraph(id, depth);
105
+ const snapshot = subgraph.toSnapshot();
106
+ return {
107
+ content: [
108
+ {
109
+ type: "text",
110
+ text: JSON.stringify({
111
+ node: {
112
+ id: node.id,
113
+ label: node.label,
114
+ type: node.type,
115
+ },
116
+ subgraph: {
117
+ nodeCount: snapshot.nodes.length,
118
+ edgeCount: snapshot.edges.length,
119
+ },
120
+ }, null, 2),
121
+ },
122
+ ],
123
+ };
124
+ }
125
+ case "search_nodes": {
126
+ // Semantic search requires an embedding — stub returns empty
127
+ // Full implementation requires MultimodalEmbedder (Phase 4)
128
+ return {
129
+ content: [
130
+ {
131
+ type: "text",
132
+ text: "Semantic search requires embedding model — configure in settings",
133
+ },
134
+ ],
135
+ isError: true,
136
+ };
137
+ }
138
+ case "add_observation": {
139
+ const label = args.label;
140
+ const content = args.content;
141
+ const graphId = args.graph_id ?? "root";
142
+ const node = createNode({
143
+ id: crypto.randomUUID(),
144
+ graph_id: graphId,
145
+ label,
146
+ type: NodeType.SIGNAL,
147
+ content: [
148
+ {
149
+ id: crypto.randomUUID(),
150
+ node_id: "",
151
+ type: ContentType.TEXT,
152
+ data: content,
153
+ metadata: {},
154
+ },
155
+ ],
156
+ });
157
+ node.content[0].node_id = node.id;
158
+ this.graph.addNode(node);
159
+ return {
160
+ content: [
161
+ { type: "text", text: `Added observation: ${node.id}` },
162
+ ],
163
+ };
164
+ }
165
+ default:
166
+ return {
167
+ content: [{ type: "text", text: `Unknown tool: ${toolName}` }],
168
+ isError: true,
169
+ };
170
+ }
171
+ }
172
+ catch (err) {
173
+ return {
174
+ content: [
175
+ {
176
+ type: "text",
177
+ text: `Error: ${err instanceof Error ? err.message : String(err)}`,
178
+ },
179
+ ],
180
+ isError: true,
181
+ };
182
+ }
183
+ }
184
+ }
185
+ //# sourceMappingURL=MemoryMCP.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MemoryMCP.js","sourceRoot":"","sources":["../../src/builtin/MemoryMCP.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { MCPTool, MCPCallResult } from '../types.js';
2
+ export declare class ShellMCP {
3
+ private scopePath;
4
+ constructor(scope: string);
5
+ get tools(): MCPTool[];
6
+ call(toolName: string, args: Record<string, unknown>): Promise<MCPCallResult>;
7
+ }
8
+ //# sourceMappingURL=ShellMCP.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ShellMCP.d.ts","sourceRoot":"","sources":["../../src/builtin/ShellMCP.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc1D,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAS;gBAEd,KAAK,EAAE,MAAM;IAIzB,IAAI,KAAK,IAAI,OAAO,EAAE,CAgBrB;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CAwCpF"}
@@ -0,0 +1,74 @@
1
+ import { execSync } from 'node:child_process';
2
+ import { resolve } from 'node:path';
3
+ const DANGEROUS_PATTERNS = [
4
+ /rm\s+(-\w+\s+)*-rf\s+\//,
5
+ /rm\s+(-\w+\s+)*\/\s/,
6
+ /mkfs\./,
7
+ /dd\s+if=/,
8
+ /:\(\)\s*\{\s*:\|:\s*&\s*\}/, // fork bomb
9
+ />\s*\/dev\/sd/,
10
+ /chmod\s+(-\w+\s+)*777\s+\//,
11
+ /curl\s+.*\|\s*(ba)?sh/,
12
+ /wget\s+.*\|\s*(ba)?sh/,
13
+ ];
14
+ export class ShellMCP {
15
+ scopePath;
16
+ constructor(scope) {
17
+ this.scopePath = resolve(scope);
18
+ }
19
+ get tools() {
20
+ return [
21
+ {
22
+ name: 'execute_command',
23
+ description: 'Execute a shell command within the scoped directory',
24
+ inputSchema: {
25
+ type: 'object',
26
+ properties: {
27
+ command: { type: 'string', description: 'The shell command to execute' },
28
+ timeout: { type: 'number', description: 'Timeout in milliseconds (default 30000)' },
29
+ },
30
+ required: ['command'],
31
+ },
32
+ server_name: 'shell',
33
+ },
34
+ ];
35
+ }
36
+ async call(toolName, args) {
37
+ if (toolName !== 'execute_command') {
38
+ return { content: [{ type: 'text', text: `Unknown tool: ${toolName}` }], isError: true };
39
+ }
40
+ const command = args.command;
41
+ if (!command || typeof command !== 'string') {
42
+ return { content: [{ type: 'text', text: 'Missing or invalid command' }], isError: true };
43
+ }
44
+ // Reject dangerous commands
45
+ for (const pattern of DANGEROUS_PATTERNS) {
46
+ if (pattern.test(command)) {
47
+ return {
48
+ content: [{ type: 'text', text: `Command rejected: matches dangerous pattern` }],
49
+ isError: true,
50
+ };
51
+ }
52
+ }
53
+ const timeout = typeof args.timeout === 'number' ? args.timeout : 30_000;
54
+ try {
55
+ const stdout = execSync(command, {
56
+ cwd: this.scopePath,
57
+ timeout,
58
+ maxBuffer: 1024 * 1024, // 1 MB
59
+ encoding: 'utf8',
60
+ stdio: ['pipe', 'pipe', 'pipe'],
61
+ });
62
+ return { content: [{ type: 'text', text: stdout }] };
63
+ }
64
+ catch (err) {
65
+ const error = err;
66
+ const stderr = error.stderr ?? error.message ?? 'Command failed';
67
+ return {
68
+ content: [{ type: 'text', text: `Exit code ${error.status ?? 1}\n${stderr}` }],
69
+ isError: true,
70
+ };
71
+ }
72
+ }
73
+ }
74
+ //# sourceMappingURL=ShellMCP.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ShellMCP.js","sourceRoot":"","sources":["../../src/builtin/ShellMCP.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ export { MCPHub } from './MCPHub.js';
2
+ export { MCPDiscovery, type DiscoveryResult } from './MCPDiscovery.js';
3
+ export { FilteredProxy } from './FilteredProxy.js';
4
+ export { FilesystemMCP } from './builtin/FilesystemMCP.js';
5
+ export { ShellMCP } from './builtin/ShellMCP.js';
6
+ export { MemoryMCP } from './builtin/MemoryMCP.js';
7
+ export { BrowserMCP } from './builtin/BrowserMCP.js';
8
+ export type { MCPServerConfig, MCPTool, MCPCallResult, MCPConnection } from './types.js';
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,8 @@
1
+ export { MCPHub } from './MCPHub.js';
2
+ export { MCPDiscovery } from './MCPDiscovery.js';
3
+ export { FilteredProxy } from './FilteredProxy.js';
4
+ export { FilesystemMCP } from './builtin/FilesystemMCP.js';
5
+ export { ShellMCP } from './builtin/ShellMCP.js';
6
+ export { MemoryMCP } from './builtin/MemoryMCP.js';
7
+ export { BrowserMCP } from './builtin/BrowserMCP.js';
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC"}
@@ -0,0 +1,30 @@
1
+ export interface MCPServerConfig {
2
+ name: string;
3
+ command?: string;
4
+ args?: string[];
5
+ url?: string;
6
+ env?: Record<string, string>;
7
+ enabled: boolean;
8
+ }
9
+ export interface MCPTool {
10
+ name: string;
11
+ description: string;
12
+ inputSchema: Record<string, unknown>;
13
+ server_name: string;
14
+ }
15
+ export interface MCPCallResult {
16
+ content: Array<{
17
+ type: 'text' | 'image';
18
+ text?: string;
19
+ data?: string;
20
+ mimeType?: string;
21
+ }>;
22
+ isError?: boolean;
23
+ }
24
+ export interface MCPConnection {
25
+ config: MCPServerConfig;
26
+ tools: MCPTool[];
27
+ connected: boolean;
28
+ error?: string;
29
+ }
30
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,66 @@
1
+ export interface GraphReadScope {
2
+ mode: 'none' | 'entities' | 'context' | 'full_readonly';
3
+ entity_ids: string[];
4
+ context_types: string[];
5
+ max_depth: number;
6
+ }
7
+ export interface SandboxConfig {
8
+ type: 'firecracker' | 'docker' | 'podman' | 'bwrap' | 'cloud' | 'process';
9
+ network_access: 'none' | 'allowlist' | 'full';
10
+ network_allowlist?: string[];
11
+ filesystem_access: 'none' | 'readonly' | 'scoped';
12
+ filesystem_scope?: string;
13
+ has_browser: boolean;
14
+ has_display: boolean;
15
+ }
16
+ export interface CapabilityToken {
17
+ id: string;
18
+ subagent_id: string;
19
+ parent_session_id: string;
20
+ issued_at: number;
21
+ expires_at: number;
22
+ trust_level: 1 | 2;
23
+ allowed_tools: string[];
24
+ blocked_tools: string[];
25
+ graph_read: GraphReadScope;
26
+ graph_write: false;
27
+ allowed_credentials: string[];
28
+ max_duration_ms: number;
29
+ max_llm_calls: number;
30
+ max_llm_tokens: number;
31
+ max_tool_calls: number;
32
+ sandbox: SandboxConfig;
33
+ signature: string;
34
+ }
35
+ export type TaskType = 'web_research' | 'code_execution' | 'browser_task' | 'file_editing' | 'send_message';
36
+ export interface TokenIssueRequest {
37
+ subagent_id: string;
38
+ parent_session_id: string;
39
+ task_type: TaskType;
40
+ graph_read_scope?: Partial<GraphReadScope>;
41
+ extra_tools?: string[];
42
+ override_duration_ms?: number;
43
+ sandbox_overrides?: Partial<SandboxConfig>;
44
+ }
45
+ export interface ValidationResult {
46
+ valid: boolean;
47
+ reason?: string;
48
+ }
49
+ /**
50
+ * Sign a token by computing HMAC-SHA256 over the canonical JSON.
51
+ * Returns the hex-encoded signature string.
52
+ */
53
+ export declare function signToken(token: CapabilityToken, secret: string): string;
54
+ /**
55
+ * Validate a capability token:
56
+ * 1. Check expiry
57
+ * 2. Verify HMAC signature with timing-safe comparison
58
+ * 3. Assert graph_write === false
59
+ */
60
+ export declare function validateToken(token: CapabilityToken, secret: string): ValidationResult;
61
+ /**
62
+ * Build a capability token from a TokenIssueRequest, applying resource defaults
63
+ * for the given task type, then sign it.
64
+ */
65
+ export declare function issueToken(req: TokenIssueRequest, secret: string): CapabilityToken;
66
+ //# sourceMappingURL=CapabilityToken.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CapabilityToken.d.ts","sourceRoot":"","sources":["../src/CapabilityToken.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,CAAC;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1E,cAAc,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC9C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,KAAK,CAAC;IACnB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5G,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqCD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAqBtF;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAqDlF"}
@@ -0,0 +1,120 @@
1
+ import { createHmac, randomUUID, timingSafeEqual } from 'node:crypto';
2
+ import { RESOURCE_DEFAULTS } from './ResourceDefaults.js';
3
+ // ─── Fixed-order canonical field keys ──────────────────
4
+ const CANONICAL_FIELDS = [
5
+ 'id',
6
+ 'subagent_id',
7
+ 'parent_session_id',
8
+ 'issued_at',
9
+ 'expires_at',
10
+ 'trust_level',
11
+ 'allowed_tools',
12
+ 'blocked_tools',
13
+ 'graph_read',
14
+ 'graph_write',
15
+ 'allowed_credentials',
16
+ 'max_duration_ms',
17
+ 'max_llm_calls',
18
+ 'max_llm_tokens',
19
+ 'max_tool_calls',
20
+ 'sandbox',
21
+ ];
22
+ // ─── Signing helpers ───────────────────────────────────
23
+ /**
24
+ * Produce a deterministic JSON serialization of all token fields except `signature`,
25
+ * in the fixed order defined by CANONICAL_FIELDS.
26
+ */
27
+ function canonicalize(token) {
28
+ const ordered = {};
29
+ for (const key of CANONICAL_FIELDS) {
30
+ ordered[key] = token[key];
31
+ }
32
+ return JSON.stringify(ordered);
33
+ }
34
+ /**
35
+ * Sign a token by computing HMAC-SHA256 over the canonical JSON.
36
+ * Returns the hex-encoded signature string.
37
+ */
38
+ export function signToken(token, secret) {
39
+ const canonical = canonicalize(token);
40
+ return createHmac('sha256', secret).update(canonical).digest('hex');
41
+ }
42
+ /**
43
+ * Validate a capability token:
44
+ * 1. Check expiry
45
+ * 2. Verify HMAC signature with timing-safe comparison
46
+ * 3. Assert graph_write === false
47
+ */
48
+ export function validateToken(token, secret) {
49
+ // 1. Expiry check
50
+ if (Date.now() > token.expires_at) {
51
+ return { valid: false, reason: 'Token has expired' };
52
+ }
53
+ // 2. HMAC verification (timing-safe)
54
+ const expected = signToken(token, secret);
55
+ const expectedBuf = Buffer.from(expected, 'hex');
56
+ const actualBuf = Buffer.from(token.signature, 'hex');
57
+ if (expectedBuf.length !== actualBuf.length || !timingSafeEqual(expectedBuf, actualBuf)) {
58
+ return { valid: false, reason: 'Invalid signature' };
59
+ }
60
+ // 3. graph_write must be false
61
+ if (token.graph_write !== false) {
62
+ return { valid: false, reason: 'graph_write must be false' };
63
+ }
64
+ return { valid: true };
65
+ }
66
+ // ─── Token issuance ────────────────────────────────────
67
+ /**
68
+ * Build a capability token from a TokenIssueRequest, applying resource defaults
69
+ * for the given task type, then sign it.
70
+ */
71
+ export function issueToken(req, secret) {
72
+ const defaults = RESOURCE_DEFAULTS[req.task_type];
73
+ const now = Date.now();
74
+ const durationMs = req.override_duration_ms ?? defaults.max_duration_ms;
75
+ const graphRead = {
76
+ mode: req.graph_read_scope?.mode ?? 'none',
77
+ entity_ids: req.graph_read_scope?.entity_ids ?? [],
78
+ context_types: req.graph_read_scope?.context_types ?? [],
79
+ max_depth: req.graph_read_scope?.max_depth ?? 1,
80
+ };
81
+ const sandbox = {
82
+ type: req.sandbox_overrides?.type ?? 'docker',
83
+ network_access: req.sandbox_overrides?.network_access ?? defaults.network_access,
84
+ filesystem_access: req.sandbox_overrides?.filesystem_access ?? defaults.filesystem_access,
85
+ has_browser: req.sandbox_overrides?.has_browser ?? (defaults.has_browser ?? false),
86
+ has_display: req.sandbox_overrides?.has_display ?? (defaults.has_display ?? false),
87
+ ...(req.sandbox_overrides?.network_allowlist != null
88
+ ? { network_allowlist: req.sandbox_overrides.network_allowlist }
89
+ : {}),
90
+ ...(req.sandbox_overrides?.filesystem_scope != null
91
+ ? { filesystem_scope: req.sandbox_overrides.filesystem_scope }
92
+ : {}),
93
+ };
94
+ const allowedTools = [
95
+ ...defaults.allowed_tools,
96
+ ...(req.extra_tools ?? []),
97
+ ];
98
+ const token = {
99
+ id: randomUUID(),
100
+ subagent_id: req.subagent_id,
101
+ parent_session_id: req.parent_session_id,
102
+ issued_at: now,
103
+ expires_at: now + durationMs,
104
+ trust_level: 1,
105
+ allowed_tools: allowedTools,
106
+ blocked_tools: [],
107
+ graph_read: graphRead,
108
+ graph_write: false,
109
+ allowed_credentials: [],
110
+ max_duration_ms: durationMs,
111
+ max_llm_calls: defaults.max_llm_calls,
112
+ max_llm_tokens: defaults.max_llm_tokens,
113
+ max_tool_calls: defaults.max_tool_calls,
114
+ sandbox,
115
+ signature: '',
116
+ };
117
+ token.signature = signToken(token, secret);
118
+ return token;
119
+ }
120
+ //# sourceMappingURL=CapabilityToken.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CapabilityToken.js","sourceRoot":"","sources":["../src/CapabilityToken.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { TaskType } from './CapabilityToken.js';
2
+ export interface ResourceConfig {
3
+ max_duration_ms: number;
4
+ max_llm_calls: number;
5
+ max_llm_tokens: number;
6
+ max_tool_calls: number;
7
+ allowed_tools: string[];
8
+ network_access: 'none' | 'allowlist' | 'full';
9
+ filesystem_access: 'none' | 'readonly' | 'scoped';
10
+ has_browser?: boolean;
11
+ has_display?: boolean;
12
+ memory_mb: number;
13
+ cpus: number;
14
+ }
15
+ export declare const RESOURCE_DEFAULTS: Record<TaskType, ResourceConfig>;
16
+ //# sourceMappingURL=ResourceDefaults.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ResourceDefaults.d.ts","sourceRoot":"","sources":["../src/ResourceDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC9C,iBAAiB,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAkE9D,CAAC"}
@@ -0,0 +1,68 @@
1
+ export const RESOURCE_DEFAULTS = {
2
+ web_research: {
3
+ max_duration_ms: 5 * 60 * 1000,
4
+ max_llm_calls: 20,
5
+ max_llm_tokens: 50_000,
6
+ max_tool_calls: 50,
7
+ allowed_tools: ['web_search', 'web_fetch', 'read_url', 'summarize'],
8
+ network_access: 'full',
9
+ filesystem_access: 'none',
10
+ has_browser: false,
11
+ has_display: false,
12
+ memory_mb: 512,
13
+ cpus: 1,
14
+ },
15
+ code_execution: {
16
+ max_duration_ms: 2 * 60 * 1000,
17
+ max_llm_calls: 10,
18
+ max_llm_tokens: 20_000,
19
+ max_tool_calls: 20,
20
+ allowed_tools: ['run_code', 'read_file', 'write_file', 'list_files'],
21
+ network_access: 'none',
22
+ filesystem_access: 'scoped',
23
+ has_browser: false,
24
+ has_display: false,
25
+ memory_mb: 512,
26
+ cpus: 1,
27
+ },
28
+ browser_task: {
29
+ max_duration_ms: 10 * 60 * 1000,
30
+ max_llm_calls: 30,
31
+ max_llm_tokens: 80_000,
32
+ max_tool_calls: 100,
33
+ allowed_tools: ['browser_navigate', 'browser_click', 'browser_type', 'browser_screenshot', 'browser_eval'],
34
+ network_access: 'full',
35
+ filesystem_access: 'none',
36
+ has_browser: true,
37
+ has_display: true,
38
+ memory_mb: 1024,
39
+ cpus: 2,
40
+ },
41
+ file_editing: {
42
+ max_duration_ms: 3 * 60 * 1000,
43
+ max_llm_calls: 15,
44
+ max_llm_tokens: 30_000,
45
+ max_tool_calls: 40,
46
+ allowed_tools: ['read_file', 'write_file', 'edit_file', 'list_files', 'search_files'],
47
+ network_access: 'none',
48
+ filesystem_access: 'scoped',
49
+ has_browser: false,
50
+ has_display: false,
51
+ memory_mb: 256,
52
+ cpus: 1,
53
+ },
54
+ send_message: {
55
+ max_duration_ms: 1 * 60 * 1000,
56
+ max_llm_calls: 5,
57
+ max_llm_tokens: 5_000,
58
+ max_tool_calls: 5,
59
+ allowed_tools: ['send_email', 'send_slack', 'send_sms'],
60
+ network_access: 'allowlist',
61
+ filesystem_access: 'none',
62
+ has_browser: false,
63
+ has_display: false,
64
+ memory_mb: 128,
65
+ cpus: 1,
66
+ },
67
+ };
68
+ //# sourceMappingURL=ResourceDefaults.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ResourceDefaults.js","sourceRoot":"","sources":["../src/ResourceDefaults.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,YAAY,EAAE;QACZ,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QAC9B,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,MAAM;QACtB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC;QACnE,cAAc,EAAE,MAAM;QACtB,iBAAiB,EAAE,MAAM;QACzB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,CAAC;KACR;IACD,cAAc,EAAE;QACd,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QAC9B,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,MAAM;QACtB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC;QACpE,cAAc,EAAE,MAAM;QACtB,iBAAiB,EAAE,QAAQ;QAC3B,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,CAAC;KACR;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QAC/B,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,MAAM;QACtB,cAAc,EAAE,GAAG;QACnB,aAAa,EAAE,CAAC,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,CAAC;QAC1G,cAAc,EAAE,MAAM;QACtB,iBAAiB,EAAE,MAAM;QACzB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,CAAC;KACR;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QAC9B,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,MAAM;QACtB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC;QACrF,cAAc,EAAE,MAAM;QACtB,iBAAiB,EAAE,QAAQ;QAC3B,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,CAAC;KACR;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QAC9B,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC;QACvD,cAAc,EAAE,WAAW;QAC3B,iBAAiB,EAAE,MAAM;QACzB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,CAAC;KACR;CACF,CAAC"}