@claude-flow/shared 3.0.0-alpha.1
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.
- package/.agentic-flow/intelligence.json +16 -0
- package/README.md +323 -0
- package/__tests__/coverage/base.css +224 -0
- package/__tests__/coverage/block-navigation.js +87 -0
- package/__tests__/coverage/coverage-final.json +50 -0
- package/__tests__/coverage/favicon.png +0 -0
- package/__tests__/coverage/index.html +326 -0
- package/__tests__/coverage/lcov-report/base.css +224 -0
- package/__tests__/coverage/lcov-report/block-navigation.js +87 -0
- package/__tests__/coverage/lcov-report/favicon.png +0 -0
- package/__tests__/coverage/lcov-report/index.html +326 -0
- package/__tests__/coverage/lcov-report/prettify.css +1 -0
- package/__tests__/coverage/lcov-report/prettify.js +2 -0
- package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
- package/__tests__/coverage/lcov-report/sorter.js +210 -0
- package/__tests__/coverage/lcov-report/src/core/config/defaults.ts.html +706 -0
- package/__tests__/coverage/lcov-report/src/core/config/index.html +161 -0
- package/__tests__/coverage/lcov-report/src/core/config/loader.ts.html +898 -0
- package/__tests__/coverage/lcov-report/src/core/config/schema.ts.html +649 -0
- package/__tests__/coverage/lcov-report/src/core/config/validator.ts.html +712 -0
- package/__tests__/coverage/lcov-report/src/core/event-bus.ts.html +793 -0
- package/__tests__/coverage/lcov-report/src/core/index.html +116 -0
- package/__tests__/coverage/lcov-report/src/core/interfaces/event.interface.ts.html +886 -0
- package/__tests__/coverage/lcov-report/src/core/interfaces/index.html +116 -0
- package/__tests__/coverage/lcov-report/src/core/orchestrator/event-coordinator.ts.html +451 -0
- package/__tests__/coverage/lcov-report/src/core/orchestrator/health-monitor.ts.html +727 -0
- package/__tests__/coverage/lcov-report/src/core/orchestrator/index.html +176 -0
- package/__tests__/coverage/lcov-report/src/core/orchestrator/lifecycle-manager.ts.html +874 -0
- package/__tests__/coverage/lcov-report/src/core/orchestrator/session-manager.ts.html +922 -0
- package/__tests__/coverage/lcov-report/src/core/orchestrator/task-manager.ts.html +1036 -0
- package/__tests__/coverage/lcov-report/src/events/domain-events.ts.html +1837 -0
- package/__tests__/coverage/lcov-report/src/events/event-store.ts.html +1849 -0
- package/__tests__/coverage/lcov-report/src/events/example-usage.ts.html +964 -0
- package/__tests__/coverage/lcov-report/src/events/index.html +176 -0
- package/__tests__/coverage/lcov-report/src/events/projections.ts.html +1768 -0
- package/__tests__/coverage/lcov-report/src/events/state-reconstructor.ts.html +1132 -0
- package/__tests__/coverage/lcov-report/src/events.ts.html +1186 -0
- package/__tests__/coverage/lcov-report/src/hooks/example-usage.ts.html +1582 -0
- package/__tests__/coverage/lcov-report/src/hooks/executor.ts.html +1222 -0
- package/__tests__/coverage/lcov-report/src/hooks/index.html +191 -0
- package/__tests__/coverage/lcov-report/src/hooks/registry.ts.html +1084 -0
- package/__tests__/coverage/lcov-report/src/hooks/safety/bash-safety.ts.html +1897 -0
- package/__tests__/coverage/lcov-report/src/hooks/safety/file-organization.ts.html +1504 -0
- package/__tests__/coverage/lcov-report/src/hooks/safety/git-commit.ts.html +1954 -0
- package/__tests__/coverage/lcov-report/src/hooks/safety/index.html +146 -0
- package/__tests__/coverage/lcov-report/src/hooks/session-hooks.ts.html +1762 -0
- package/__tests__/coverage/lcov-report/src/hooks/task-hooks.ts.html +1624 -0
- package/__tests__/coverage/lcov-report/src/hooks/types.ts.html +1156 -0
- package/__tests__/coverage/lcov-report/src/index.html +176 -0
- package/__tests__/coverage/lcov-report/src/mcp/connection-pool.ts.html +1399 -0
- package/__tests__/coverage/lcov-report/src/mcp/index.html +176 -0
- package/__tests__/coverage/lcov-report/src/mcp/server.ts.html +2407 -0
- package/__tests__/coverage/lcov-report/src/mcp/session-manager.ts.html +1369 -0
- package/__tests__/coverage/lcov-report/src/mcp/tool-registry.ts.html +1783 -0
- package/__tests__/coverage/lcov-report/src/mcp/transport/http.ts.html +1756 -0
- package/__tests__/coverage/lcov-report/src/mcp/transport/index.html +146 -0
- package/__tests__/coverage/lcov-report/src/mcp/transport/stdio.ts.html +1057 -0
- package/__tests__/coverage/lcov-report/src/mcp/transport/websocket.ts.html +1537 -0
- package/__tests__/coverage/lcov-report/src/mcp/types.ts.html +1780 -0
- package/__tests__/coverage/lcov-report/src/plugin-interface.ts.html +2074 -0
- package/__tests__/coverage/lcov-report/src/plugin-loader.ts.html +1999 -0
- package/__tests__/coverage/lcov-report/src/plugin-registry.ts.html +1897 -0
- package/__tests__/coverage/lcov-report/src/plugins/official/hive-mind-plugin.ts.html +1075 -0
- package/__tests__/coverage/lcov-report/src/plugins/official/index.html +131 -0
- package/__tests__/coverage/lcov-report/src/plugins/official/maestro-plugin.ts.html +1609 -0
- package/__tests__/coverage/lcov-report/src/resilience/bulkhead.ts.html +916 -0
- package/__tests__/coverage/lcov-report/src/resilience/circuit-breaker.ts.html +1063 -0
- package/__tests__/coverage/lcov-report/src/resilience/index.html +161 -0
- package/__tests__/coverage/lcov-report/src/resilience/rate-limiter.ts.html +1345 -0
- package/__tests__/coverage/lcov-report/src/resilience/retry.ts.html +757 -0
- package/__tests__/coverage/lcov-report/src/security/index.html +131 -0
- package/__tests__/coverage/lcov-report/src/security/input-validation.ts.html +880 -0
- package/__tests__/coverage/lcov-report/src/security/secure-random.ts.html +562 -0
- package/__tests__/coverage/lcov-report/src/types/index.html +131 -0
- package/__tests__/coverage/lcov-report/src/types/swarm.types.ts.html +850 -0
- package/__tests__/coverage/lcov-report/src/types/task.types.ts.html +700 -0
- package/__tests__/coverage/lcov-report/src/types.ts.html +1186 -0
- package/__tests__/coverage/lcov-report/src/utils/index.html +116 -0
- package/__tests__/coverage/lcov-report/src/utils/secure-logger.ts.html +856 -0
- package/__tests__/coverage/lcov.info +19877 -0
- package/__tests__/coverage/prettify.css +1 -0
- package/__tests__/coverage/prettify.js +2 -0
- package/__tests__/coverage/sort-arrow-sprite.png +0 -0
- package/__tests__/coverage/sorter.js +210 -0
- package/__tests__/coverage/src/core/config/defaults.ts.html +706 -0
- package/__tests__/coverage/src/core/config/index.html +161 -0
- package/__tests__/coverage/src/core/config/loader.ts.html +898 -0
- package/__tests__/coverage/src/core/config/schema.ts.html +649 -0
- package/__tests__/coverage/src/core/config/validator.ts.html +712 -0
- package/__tests__/coverage/src/core/event-bus.ts.html +793 -0
- package/__tests__/coverage/src/core/index.html +116 -0
- package/__tests__/coverage/src/core/interfaces/event.interface.ts.html +886 -0
- package/__tests__/coverage/src/core/interfaces/index.html +116 -0
- package/__tests__/coverage/src/core/orchestrator/event-coordinator.ts.html +451 -0
- package/__tests__/coverage/src/core/orchestrator/health-monitor.ts.html +727 -0
- package/__tests__/coverage/src/core/orchestrator/index.html +176 -0
- package/__tests__/coverage/src/core/orchestrator/lifecycle-manager.ts.html +874 -0
- package/__tests__/coverage/src/core/orchestrator/session-manager.ts.html +922 -0
- package/__tests__/coverage/src/core/orchestrator/task-manager.ts.html +1036 -0
- package/__tests__/coverage/src/events/domain-events.ts.html +1837 -0
- package/__tests__/coverage/src/events/event-store.ts.html +1849 -0
- package/__tests__/coverage/src/events/example-usage.ts.html +964 -0
- package/__tests__/coverage/src/events/index.html +176 -0
- package/__tests__/coverage/src/events/projections.ts.html +1768 -0
- package/__tests__/coverage/src/events/state-reconstructor.ts.html +1132 -0
- package/__tests__/coverage/src/events.ts.html +1186 -0
- package/__tests__/coverage/src/hooks/example-usage.ts.html +1582 -0
- package/__tests__/coverage/src/hooks/executor.ts.html +1222 -0
- package/__tests__/coverage/src/hooks/index.html +191 -0
- package/__tests__/coverage/src/hooks/registry.ts.html +1084 -0
- package/__tests__/coverage/src/hooks/safety/bash-safety.ts.html +1897 -0
- package/__tests__/coverage/src/hooks/safety/file-organization.ts.html +1504 -0
- package/__tests__/coverage/src/hooks/safety/git-commit.ts.html +1954 -0
- package/__tests__/coverage/src/hooks/safety/index.html +146 -0
- package/__tests__/coverage/src/hooks/session-hooks.ts.html +1762 -0
- package/__tests__/coverage/src/hooks/task-hooks.ts.html +1624 -0
- package/__tests__/coverage/src/hooks/types.ts.html +1156 -0
- package/__tests__/coverage/src/index.html +176 -0
- package/__tests__/coverage/src/mcp/connection-pool.ts.html +1399 -0
- package/__tests__/coverage/src/mcp/index.html +176 -0
- package/__tests__/coverage/src/mcp/server.ts.html +2407 -0
- package/__tests__/coverage/src/mcp/session-manager.ts.html +1369 -0
- package/__tests__/coverage/src/mcp/tool-registry.ts.html +1783 -0
- package/__tests__/coverage/src/mcp/transport/http.ts.html +1756 -0
- package/__tests__/coverage/src/mcp/transport/index.html +146 -0
- package/__tests__/coverage/src/mcp/transport/stdio.ts.html +1057 -0
- package/__tests__/coverage/src/mcp/transport/websocket.ts.html +1537 -0
- package/__tests__/coverage/src/mcp/types.ts.html +1780 -0
- package/__tests__/coverage/src/plugin-interface.ts.html +2074 -0
- package/__tests__/coverage/src/plugin-loader.ts.html +1999 -0
- package/__tests__/coverage/src/plugin-registry.ts.html +1897 -0
- package/__tests__/coverage/src/plugins/official/hive-mind-plugin.ts.html +1075 -0
- package/__tests__/coverage/src/plugins/official/index.html +131 -0
- package/__tests__/coverage/src/plugins/official/maestro-plugin.ts.html +1609 -0
- package/__tests__/coverage/src/resilience/bulkhead.ts.html +916 -0
- package/__tests__/coverage/src/resilience/circuit-breaker.ts.html +1063 -0
- package/__tests__/coverage/src/resilience/index.html +161 -0
- package/__tests__/coverage/src/resilience/rate-limiter.ts.html +1345 -0
- package/__tests__/coverage/src/resilience/retry.ts.html +757 -0
- package/__tests__/coverage/src/security/index.html +131 -0
- package/__tests__/coverage/src/security/input-validation.ts.html +880 -0
- package/__tests__/coverage/src/security/secure-random.ts.html +562 -0
- package/__tests__/coverage/src/types/index.html +131 -0
- package/__tests__/coverage/src/types/swarm.types.ts.html +850 -0
- package/__tests__/coverage/src/types/task.types.ts.html +700 -0
- package/__tests__/coverage/src/types.ts.html +1186 -0
- package/__tests__/coverage/src/utils/index.html +116 -0
- package/__tests__/coverage/src/utils/secure-logger.ts.html +856 -0
- package/__tests__/hooks/bash-safety.test.ts +289 -0
- package/__tests__/hooks/file-organization.test.ts +335 -0
- package/__tests__/hooks/git-commit.test.ts +336 -0
- package/__tests__/hooks/index.ts +23 -0
- package/__tests__/hooks/session-hooks.test.ts +357 -0
- package/__tests__/hooks/task-hooks.test.ts +193 -0
- package/dist/core/config/defaults.d.ts +41 -0
- package/dist/core/config/defaults.d.ts.map +1 -0
- package/dist/core/config/defaults.js +186 -0
- package/dist/core/config/defaults.js.map +1 -0
- package/dist/core/config/index.d.ts +8 -0
- package/dist/core/config/index.d.ts.map +1 -0
- package/dist/core/config/index.js +12 -0
- package/dist/core/config/index.js.map +1 -0
- package/dist/core/config/loader.d.ts +45 -0
- package/dist/core/config/loader.d.ts.map +1 -0
- package/dist/core/config/loader.js +222 -0
- package/dist/core/config/loader.js.map +1 -0
- package/dist/core/config/schema.d.ts +1134 -0
- package/dist/core/config/schema.d.ts.map +1 -0
- package/dist/core/config/schema.js +158 -0
- package/dist/core/config/schema.js.map +1 -0
- package/dist/core/config/validator.d.ts +92 -0
- package/dist/core/config/validator.d.ts.map +1 -0
- package/dist/core/config/validator.js +147 -0
- package/dist/core/config/validator.js.map +1 -0
- package/dist/core/event-bus.d.ts +31 -0
- package/dist/core/event-bus.d.ts.map +1 -0
- package/dist/core/event-bus.js +197 -0
- package/dist/core/event-bus.js.map +1 -0
- package/dist/core/index.d.ts +15 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +19 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/interfaces/agent.interface.d.ts +200 -0
- package/dist/core/interfaces/agent.interface.d.ts.map +1 -0
- package/dist/core/interfaces/agent.interface.js +6 -0
- package/dist/core/interfaces/agent.interface.js.map +1 -0
- package/dist/core/interfaces/coordinator.interface.d.ts +310 -0
- package/dist/core/interfaces/coordinator.interface.d.ts.map +1 -0
- package/dist/core/interfaces/coordinator.interface.js +7 -0
- package/dist/core/interfaces/coordinator.interface.js.map +1 -0
- package/dist/core/interfaces/event.interface.d.ts +224 -0
- package/dist/core/interfaces/event.interface.d.ts.map +1 -0
- package/dist/core/interfaces/event.interface.js +46 -0
- package/dist/core/interfaces/event.interface.js.map +1 -0
- package/dist/core/interfaces/index.d.ts +10 -0
- package/dist/core/interfaces/index.d.ts.map +1 -0
- package/dist/core/interfaces/index.js +15 -0
- package/dist/core/interfaces/index.js.map +1 -0
- package/dist/core/interfaces/memory.interface.d.ts +298 -0
- package/dist/core/interfaces/memory.interface.d.ts.map +1 -0
- package/dist/core/interfaces/memory.interface.js +7 -0
- package/dist/core/interfaces/memory.interface.js.map +1 -0
- package/dist/core/interfaces/task.interface.d.ts +185 -0
- package/dist/core/interfaces/task.interface.d.ts.map +1 -0
- package/dist/core/interfaces/task.interface.js +6 -0
- package/dist/core/interfaces/task.interface.js.map +1 -0
- package/dist/core/orchestrator/event-coordinator.d.ts +35 -0
- package/dist/core/orchestrator/event-coordinator.d.ts.map +1 -0
- package/dist/core/orchestrator/event-coordinator.js +101 -0
- package/dist/core/orchestrator/event-coordinator.js.map +1 -0
- package/dist/core/orchestrator/health-monitor.d.ts +60 -0
- package/dist/core/orchestrator/health-monitor.d.ts.map +1 -0
- package/dist/core/orchestrator/health-monitor.js +166 -0
- package/dist/core/orchestrator/health-monitor.js.map +1 -0
- package/dist/core/orchestrator/index.d.ts +46 -0
- package/dist/core/orchestrator/index.d.ts.map +1 -0
- package/dist/core/orchestrator/index.js +64 -0
- package/dist/core/orchestrator/index.js.map +1 -0
- package/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
- package/dist/core/orchestrator/lifecycle-manager.d.ts.map +1 -0
- package/dist/core/orchestrator/lifecycle-manager.js +195 -0
- package/dist/core/orchestrator/lifecycle-manager.js.map +1 -0
- package/dist/core/orchestrator/session-manager.d.ts +83 -0
- package/dist/core/orchestrator/session-manager.d.ts.map +1 -0
- package/dist/core/orchestrator/session-manager.js +193 -0
- package/dist/core/orchestrator/session-manager.js.map +1 -0
- package/dist/core/orchestrator/task-manager.d.ts +49 -0
- package/dist/core/orchestrator/task-manager.d.ts.map +1 -0
- package/dist/core/orchestrator/task-manager.js +253 -0
- package/dist/core/orchestrator/task-manager.js.map +1 -0
- package/dist/events/domain-events.d.ts +282 -0
- package/dist/events/domain-events.d.ts.map +1 -0
- package/dist/events/domain-events.js +165 -0
- package/dist/events/domain-events.js.map +1 -0
- package/dist/events/event-store.d.ts +126 -0
- package/dist/events/event-store.d.ts.map +1 -0
- package/dist/events/event-store.js +416 -0
- package/dist/events/event-store.js.map +1 -0
- package/dist/events/event-store.test.d.ts +8 -0
- package/dist/events/event-store.test.d.ts.map +1 -0
- package/dist/events/event-store.test.js +293 -0
- package/dist/events/event-store.test.js.map +1 -0
- package/dist/events/example-usage.d.ts +10 -0
- package/dist/events/example-usage.d.ts.map +1 -0
- package/dist/events/example-usage.js +193 -0
- package/dist/events/example-usage.js.map +1 -0
- package/dist/events/index.d.ts +19 -0
- package/dist/events/index.d.ts.map +1 -0
- package/dist/events/index.js +20 -0
- package/dist/events/index.js.map +1 -0
- package/dist/events/projections.d.ts +177 -0
- package/dist/events/projections.d.ts.map +1 -0
- package/dist/events/projections.js +421 -0
- package/dist/events/projections.js.map +1 -0
- package/dist/events/state-reconstructor.d.ts +101 -0
- package/dist/events/state-reconstructor.d.ts.map +1 -0
- package/dist/events/state-reconstructor.js +263 -0
- package/dist/events/state-reconstructor.js.map +1 -0
- package/dist/events.d.ts +80 -0
- package/dist/events.d.ts.map +1 -0
- package/dist/events.js +249 -0
- package/dist/events.js.map +1 -0
- package/dist/hooks/example-usage.d.ts +42 -0
- package/dist/hooks/example-usage.d.ts.map +1 -0
- package/dist/hooks/example-usage.js +351 -0
- package/dist/hooks/example-usage.js.map +1 -0
- package/dist/hooks/executor.d.ts +100 -0
- package/dist/hooks/executor.d.ts.map +1 -0
- package/dist/hooks/executor.js +264 -0
- package/dist/hooks/executor.js.map +1 -0
- package/dist/hooks/hooks.test.d.ts +9 -0
- package/dist/hooks/hooks.test.d.ts.map +1 -0
- package/dist/hooks/hooks.test.js +322 -0
- package/dist/hooks/hooks.test.js.map +1 -0
- package/dist/hooks/index.d.ts +52 -0
- package/dist/hooks/index.d.ts.map +1 -0
- package/dist/hooks/index.js +51 -0
- package/dist/hooks/index.js.map +1 -0
- package/dist/hooks/registry.d.ts +133 -0
- package/dist/hooks/registry.d.ts.map +1 -0
- package/dist/hooks/registry.js +277 -0
- package/dist/hooks/registry.js.map +1 -0
- package/dist/hooks/safety/bash-safety.d.ts +105 -0
- package/dist/hooks/safety/bash-safety.d.ts.map +1 -0
- package/dist/hooks/safety/bash-safety.js +481 -0
- package/dist/hooks/safety/bash-safety.js.map +1 -0
- package/dist/hooks/safety/file-organization.d.ts +144 -0
- package/dist/hooks/safety/file-organization.d.ts.map +1 -0
- package/dist/hooks/safety/file-organization.js +328 -0
- package/dist/hooks/safety/file-organization.js.map +1 -0
- package/dist/hooks/safety/git-commit.d.ts +158 -0
- package/dist/hooks/safety/git-commit.d.ts.map +1 -0
- package/dist/hooks/safety/git-commit.js +450 -0
- package/dist/hooks/safety/git-commit.js.map +1 -0
- package/dist/hooks/safety/index.d.ts +17 -0
- package/dist/hooks/safety/index.d.ts.map +1 -0
- package/dist/hooks/safety/index.js +17 -0
- package/dist/hooks/safety/index.js.map +1 -0
- package/dist/hooks/session-hooks.d.ts +234 -0
- package/dist/hooks/session-hooks.d.ts.map +1 -0
- package/dist/hooks/session-hooks.js +334 -0
- package/dist/hooks/session-hooks.js.map +1 -0
- package/dist/hooks/task-hooks.d.ts +163 -0
- package/dist/hooks/task-hooks.d.ts.map +1 -0
- package/dist/hooks/task-hooks.js +326 -0
- package/dist/hooks/task-hooks.js.map +1 -0
- package/dist/hooks/types.d.ts +267 -0
- package/dist/hooks/types.d.ts.map +1 -0
- package/dist/hooks/types.js +62 -0
- package/dist/hooks/types.js.map +1 -0
- package/dist/hooks/verify-exports.test.d.ts +9 -0
- package/dist/hooks/verify-exports.test.d.ts.map +1 -0
- package/dist/hooks/verify-exports.test.js +93 -0
- package/dist/hooks/verify-exports.test.js.map +1 -0
- package/dist/index.d.ts +19 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +46 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/connection-pool.d.ts +98 -0
- package/dist/mcp/connection-pool.d.ts.map +1 -0
- package/dist/mcp/connection-pool.js +364 -0
- package/dist/mcp/connection-pool.js.map +1 -0
- package/dist/mcp/index.d.ts +69 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +84 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/server.d.ts +166 -0
- package/dist/mcp/server.d.ts.map +1 -0
- package/dist/mcp/server.js +593 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/session-manager.d.ts +136 -0
- package/dist/mcp/session-manager.d.ts.map +1 -0
- package/dist/mcp/session-manager.js +335 -0
- package/dist/mcp/session-manager.js.map +1 -0
- package/dist/mcp/tool-registry.d.ts +178 -0
- package/dist/mcp/tool-registry.d.ts.map +1 -0
- package/dist/mcp/tool-registry.js +439 -0
- package/dist/mcp/tool-registry.js.map +1 -0
- package/dist/mcp/transport/http.d.ts +104 -0
- package/dist/mcp/transport/http.d.ts.map +1 -0
- package/dist/mcp/transport/http.js +476 -0
- package/dist/mcp/transport/http.js.map +1 -0
- package/dist/mcp/transport/index.d.ts +102 -0
- package/dist/mcp/transport/index.d.ts.map +1 -0
- package/dist/mcp/transport/index.js +238 -0
- package/dist/mcp/transport/index.js.map +1 -0
- package/dist/mcp/transport/stdio.d.ts +104 -0
- package/dist/mcp/transport/stdio.d.ts.map +1 -0
- package/dist/mcp/transport/stdio.js +263 -0
- package/dist/mcp/transport/stdio.js.map +1 -0
- package/dist/mcp/transport/websocket.d.ts +133 -0
- package/dist/mcp/transport/websocket.d.ts.map +1 -0
- package/dist/mcp/transport/websocket.js +396 -0
- package/dist/mcp/transport/websocket.js.map +1 -0
- package/dist/mcp/types.d.ts +438 -0
- package/dist/mcp/types.d.ts.map +1 -0
- package/dist/mcp/types.js +54 -0
- package/dist/mcp/types.js.map +1 -0
- package/dist/plugin-interface.d.ts +544 -0
- package/dist/plugin-interface.d.ts.map +1 -0
- package/dist/plugin-interface.js +23 -0
- package/dist/plugin-interface.js.map +1 -0
- package/dist/plugin-loader.d.ts +139 -0
- package/dist/plugin-loader.d.ts.map +1 -0
- package/dist/plugin-loader.js +434 -0
- package/dist/plugin-loader.js.map +1 -0
- package/dist/plugin-registry.d.ts +183 -0
- package/dist/plugin-registry.d.ts.map +1 -0
- package/dist/plugin-registry.js +457 -0
- package/dist/plugin-registry.js.map +1 -0
- package/dist/plugins/index.d.ts +10 -0
- package/dist/plugins/index.d.ts.map +1 -0
- package/dist/plugins/index.js +10 -0
- package/dist/plugins/index.js.map +1 -0
- package/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
- package/dist/plugins/official/hive-mind-plugin.d.ts.map +1 -0
- package/dist/plugins/official/hive-mind-plugin.js +241 -0
- package/dist/plugins/official/hive-mind-plugin.js.map +1 -0
- package/dist/plugins/official/index.d.ts +10 -0
- package/dist/plugins/official/index.d.ts.map +1 -0
- package/dist/plugins/official/index.js +10 -0
- package/dist/plugins/official/index.js.map +1 -0
- package/dist/plugins/official/maestro-plugin.d.ts +121 -0
- package/dist/plugins/official/maestro-plugin.d.ts.map +1 -0
- package/dist/plugins/official/maestro-plugin.js +355 -0
- package/dist/plugins/official/maestro-plugin.js.map +1 -0
- package/dist/plugins/types.d.ts +93 -0
- package/dist/plugins/types.d.ts.map +1 -0
- package/dist/plugins/types.js +9 -0
- package/dist/plugins/types.js.map +1 -0
- package/dist/resilience/bulkhead.d.ts +105 -0
- package/dist/resilience/bulkhead.d.ts.map +1 -0
- package/dist/resilience/bulkhead.js +206 -0
- package/dist/resilience/bulkhead.js.map +1 -0
- package/dist/resilience/circuit-breaker.d.ts +132 -0
- package/dist/resilience/circuit-breaker.d.ts.map +1 -0
- package/dist/resilience/circuit-breaker.js +233 -0
- package/dist/resilience/circuit-breaker.js.map +1 -0
- package/dist/resilience/index.d.ts +19 -0
- package/dist/resilience/index.d.ts.map +1 -0
- package/dist/resilience/index.js +19 -0
- package/dist/resilience/index.js.map +1 -0
- package/dist/resilience/rate-limiter.d.ts +168 -0
- package/dist/resilience/rate-limiter.d.ts.map +1 -0
- package/dist/resilience/rate-limiter.js +314 -0
- package/dist/resilience/rate-limiter.js.map +1 -0
- package/dist/resilience/retry.d.ts +91 -0
- package/dist/resilience/retry.d.ts.map +1 -0
- package/dist/resilience/retry.js +159 -0
- package/dist/resilience/retry.js.map +1 -0
- package/dist/security/index.d.ts +10 -0
- package/dist/security/index.d.ts.map +1 -0
- package/dist/security/index.js +12 -0
- package/dist/security/index.js.map +1 -0
- package/dist/security/input-validation.d.ts +73 -0
- package/dist/security/input-validation.d.ts.map +1 -0
- package/dist/security/input-validation.js +201 -0
- package/dist/security/input-validation.js.map +1 -0
- package/dist/security/secure-random.d.ts +92 -0
- package/dist/security/secure-random.d.ts.map +1 -0
- package/dist/security/secure-random.js +142 -0
- package/dist/security/secure-random.js.map +1 -0
- package/dist/types/agent.types.d.ts +137 -0
- package/dist/types/agent.types.d.ts.map +1 -0
- package/dist/types/agent.types.js +6 -0
- package/dist/types/agent.types.js.map +1 -0
- package/dist/types/index.d.ts +11 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +17 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/mcp.types.d.ts +266 -0
- package/dist/types/mcp.types.d.ts.map +1 -0
- package/dist/types/mcp.types.js +7 -0
- package/dist/types/mcp.types.js.map +1 -0
- package/dist/types/memory.types.d.ts +236 -0
- package/dist/types/memory.types.d.ts.map +1 -0
- package/dist/types/memory.types.js +7 -0
- package/dist/types/memory.types.js.map +1 -0
- package/dist/types/swarm.types.d.ts +186 -0
- package/dist/types/swarm.types.d.ts.map +1 -0
- package/dist/types/swarm.types.js +65 -0
- package/dist/types/swarm.types.js.map +1 -0
- package/dist/types/task.types.d.ts +178 -0
- package/dist/types/task.types.d.ts.map +1 -0
- package/dist/types/task.types.js +32 -0
- package/dist/types/task.types.js.map +1 -0
- package/dist/types.d.ts +197 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +21 -0
- package/dist/types.js.map +1 -0
- package/dist/utils/secure-logger.d.ts +69 -0
- package/dist/utils/secure-logger.d.ts.map +1 -0
- package/dist/utils/secure-logger.js +208 -0
- package/dist/utils/secure-logger.js.map +1 -0
- package/docs/EVENTS_IMPLEMENTATION_SUMMARY.md +388 -0
- package/docs/EVENTS_QUICK_REFERENCE.md +470 -0
- package/docs/EVENTS_README.md +352 -0
- package/package.json +34 -0
- package/src/core/config/defaults.ts +207 -0
- package/src/core/config/index.ts +15 -0
- package/src/core/config/loader.ts +271 -0
- package/src/core/config/schema.ts +188 -0
- package/src/core/config/validator.ts +209 -0
- package/src/core/event-bus.ts +236 -0
- package/src/core/index.ts +22 -0
- package/src/core/interfaces/agent.interface.ts +251 -0
- package/src/core/interfaces/coordinator.interface.ts +363 -0
- package/src/core/interfaces/event.interface.ts +267 -0
- package/src/core/interfaces/index.ts +19 -0
- package/src/core/interfaces/memory.interface.ts +332 -0
- package/src/core/interfaces/task.interface.ts +223 -0
- package/src/core/orchestrator/event-coordinator.ts +122 -0
- package/src/core/orchestrator/health-monitor.ts +214 -0
- package/src/core/orchestrator/index.ts +89 -0
- package/src/core/orchestrator/lifecycle-manager.ts +263 -0
- package/src/core/orchestrator/session-manager.ts +279 -0
- package/src/core/orchestrator/task-manager.ts +317 -0
- package/src/events/domain-events.ts +584 -0
- package/src/events/event-store.test.ts +387 -0
- package/src/events/event-store.ts +588 -0
- package/src/events/example-usage.ts +293 -0
- package/src/events/index.ts +90 -0
- package/src/events/projections.ts +561 -0
- package/src/events/state-reconstructor.ts +349 -0
- package/src/events.ts +367 -0
- package/src/hooks/INTEGRATION.md +658 -0
- package/src/hooks/README.md +532 -0
- package/src/hooks/example-usage.ts +499 -0
- package/src/hooks/executor.ts +379 -0
- package/src/hooks/hooks.test.ts +421 -0
- package/src/hooks/index.ts +131 -0
- package/src/hooks/registry.ts +333 -0
- package/src/hooks/safety/bash-safety.ts +604 -0
- package/src/hooks/safety/file-organization.ts +473 -0
- package/src/hooks/safety/git-commit.ts +623 -0
- package/src/hooks/safety/index.ts +46 -0
- package/src/hooks/session-hooks.ts +559 -0
- package/src/hooks/task-hooks.ts +513 -0
- package/src/hooks/types.ts +357 -0
- package/src/hooks/verify-exports.test.ts +125 -0
- package/src/index.ts +190 -0
- package/src/mcp/connection-pool.ts +438 -0
- package/src/mcp/index.ts +183 -0
- package/src/mcp/server.ts +774 -0
- package/src/mcp/session-manager.ts +428 -0
- package/src/mcp/tool-registry.ts +566 -0
- package/src/mcp/transport/http.ts +557 -0
- package/src/mcp/transport/index.ts +294 -0
- package/src/mcp/transport/stdio.ts +324 -0
- package/src/mcp/transport/websocket.ts +484 -0
- package/src/mcp/types.ts +565 -0
- package/src/plugin-interface.ts +663 -0
- package/src/plugin-loader.ts +638 -0
- package/src/plugin-registry.ts +604 -0
- package/src/plugins/index.ts +34 -0
- package/src/plugins/official/hive-mind-plugin.ts +330 -0
- package/src/plugins/official/index.ts +24 -0
- package/src/plugins/official/maestro-plugin.ts +508 -0
- package/src/plugins/types.ts +108 -0
- package/src/resilience/bulkhead.ts +277 -0
- package/src/resilience/circuit-breaker.ts +326 -0
- package/src/resilience/index.ts +26 -0
- package/src/resilience/rate-limiter.ts +420 -0
- package/src/resilience/retry.ts +224 -0
- package/src/security/index.ts +39 -0
- package/src/security/input-validation.ts +265 -0
- package/src/security/secure-random.ts +159 -0
- package/src/types/agent.types.ts +144 -0
- package/src/types/index.ts +22 -0
- package/src/types/mcp.types.ts +300 -0
- package/src/types/memory.types.ts +263 -0
- package/src/types/swarm.types.ts +255 -0
- package/src/types/task.types.ts +205 -0
- package/src/types.ts +367 -0
- package/src/utils/secure-logger.d.ts +69 -0
- package/src/utils/secure-logger.d.ts.map +1 -0
- package/src/utils/secure-logger.js +208 -0
- package/src/utils/secure-logger.js.map +1 -0
- package/src/utils/secure-logger.ts +257 -0
- package/tsconfig.json +9 -0
- package/tsconfig.tsbuildinfo +1 -0
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 MCP Session Manager
|
|
3
|
+
*
|
|
4
|
+
* Manages MCP sessions with:
|
|
5
|
+
* - Session lifecycle management
|
|
6
|
+
* - Authentication integration
|
|
7
|
+
* - Session timeout handling
|
|
8
|
+
* - Concurrent session support
|
|
9
|
+
* - Session metrics and monitoring
|
|
10
|
+
*
|
|
11
|
+
* Performance Targets:
|
|
12
|
+
* - Session creation: <5ms
|
|
13
|
+
* - Session lookup: <1ms
|
|
14
|
+
* - Session cleanup: <10ms
|
|
15
|
+
*/
|
|
16
|
+
import { EventEmitter } from 'events';
|
|
17
|
+
import { MCPSession, SessionState, SessionMetrics, MCPInitializeParams, TransportType, ILogger } from './types.js';
|
|
18
|
+
/**
|
|
19
|
+
* Session configuration
|
|
20
|
+
*/
|
|
21
|
+
export interface SessionConfig {
|
|
22
|
+
maxSessions?: number;
|
|
23
|
+
sessionTimeout?: number;
|
|
24
|
+
cleanupInterval?: number;
|
|
25
|
+
enableMetrics?: boolean;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Session Manager
|
|
29
|
+
*
|
|
30
|
+
* Handles creation, tracking, and cleanup of MCP sessions
|
|
31
|
+
*/
|
|
32
|
+
export declare class SessionManager extends EventEmitter {
|
|
33
|
+
private readonly logger;
|
|
34
|
+
private readonly sessions;
|
|
35
|
+
private readonly config;
|
|
36
|
+
private cleanupTimer?;
|
|
37
|
+
private sessionCounter;
|
|
38
|
+
private totalCreated;
|
|
39
|
+
private totalClosed;
|
|
40
|
+
private totalExpired;
|
|
41
|
+
constructor(logger: ILogger, config?: SessionConfig);
|
|
42
|
+
/**
|
|
43
|
+
* Create a new session
|
|
44
|
+
*/
|
|
45
|
+
createSession(transport: TransportType): MCPSession;
|
|
46
|
+
/**
|
|
47
|
+
* Initialize a session with client information
|
|
48
|
+
*/
|
|
49
|
+
initializeSession(sessionId: string, params: MCPInitializeParams): MCPSession | undefined;
|
|
50
|
+
/**
|
|
51
|
+
* Authenticate a session
|
|
52
|
+
*/
|
|
53
|
+
authenticateSession(sessionId: string): boolean;
|
|
54
|
+
/**
|
|
55
|
+
* Get a session by ID
|
|
56
|
+
*/
|
|
57
|
+
getSession(sessionId: string): MCPSession | undefined;
|
|
58
|
+
/**
|
|
59
|
+
* Check if session exists
|
|
60
|
+
*/
|
|
61
|
+
hasSession(sessionId: string): boolean;
|
|
62
|
+
/**
|
|
63
|
+
* Get all active sessions
|
|
64
|
+
*/
|
|
65
|
+
getActiveSessions(): MCPSession[];
|
|
66
|
+
/**
|
|
67
|
+
* Update session activity timestamp
|
|
68
|
+
*/
|
|
69
|
+
updateActivity(sessionId: string): boolean;
|
|
70
|
+
/**
|
|
71
|
+
* Set session state
|
|
72
|
+
*/
|
|
73
|
+
setState(sessionId: string, state: SessionState): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Set session metadata
|
|
76
|
+
*/
|
|
77
|
+
setMetadata(sessionId: string, key: string, value: unknown): boolean;
|
|
78
|
+
/**
|
|
79
|
+
* Get session metadata
|
|
80
|
+
*/
|
|
81
|
+
getMetadata(sessionId: string, key: string): unknown;
|
|
82
|
+
/**
|
|
83
|
+
* Close a session
|
|
84
|
+
*/
|
|
85
|
+
closeSession(sessionId: string, reason?: string): boolean;
|
|
86
|
+
/**
|
|
87
|
+
* Remove a session (alias for closeSession)
|
|
88
|
+
*/
|
|
89
|
+
removeSession(sessionId: string): boolean;
|
|
90
|
+
/**
|
|
91
|
+
* Get session metrics
|
|
92
|
+
*/
|
|
93
|
+
getSessionMetrics(): SessionMetrics;
|
|
94
|
+
/**
|
|
95
|
+
* Get detailed statistics
|
|
96
|
+
*/
|
|
97
|
+
getStats(): {
|
|
98
|
+
total: number;
|
|
99
|
+
byState: Record<SessionState, number>;
|
|
100
|
+
byTransport: Record<TransportType, number>;
|
|
101
|
+
totalCreated: number;
|
|
102
|
+
totalClosed: number;
|
|
103
|
+
totalExpired: number;
|
|
104
|
+
oldestSession?: Date;
|
|
105
|
+
newestSession?: Date;
|
|
106
|
+
};
|
|
107
|
+
/**
|
|
108
|
+
* Clean up expired sessions
|
|
109
|
+
*/
|
|
110
|
+
cleanupExpiredSessions(): number;
|
|
111
|
+
/**
|
|
112
|
+
* Start cleanup timer
|
|
113
|
+
*/
|
|
114
|
+
private startCleanupTimer;
|
|
115
|
+
/**
|
|
116
|
+
* Stop cleanup timer
|
|
117
|
+
*/
|
|
118
|
+
private stopCleanupTimer;
|
|
119
|
+
/**
|
|
120
|
+
* Generate a unique session ID
|
|
121
|
+
*/
|
|
122
|
+
private generateSessionId;
|
|
123
|
+
/**
|
|
124
|
+
* Clear all sessions
|
|
125
|
+
*/
|
|
126
|
+
clearAll(): void;
|
|
127
|
+
/**
|
|
128
|
+
* Destroy the session manager
|
|
129
|
+
*/
|
|
130
|
+
destroy(): void;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Create a session manager
|
|
134
|
+
*/
|
|
135
|
+
export declare function createSessionManager(logger: ILogger, config?: SessionConfig): SessionManager;
|
|
136
|
+
//# sourceMappingURL=session-manager.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/session-manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 MCP Session Manager
|
|
3
|
+
*
|
|
4
|
+
* Manages MCP sessions with:
|
|
5
|
+
* - Session lifecycle management
|
|
6
|
+
* - Authentication integration
|
|
7
|
+
* - Session timeout handling
|
|
8
|
+
* - Concurrent session support
|
|
9
|
+
* - Session metrics and monitoring
|
|
10
|
+
*
|
|
11
|
+
* Performance Targets:
|
|
12
|
+
* - Session creation: <5ms
|
|
13
|
+
* - Session lookup: <1ms
|
|
14
|
+
* - Session cleanup: <10ms
|
|
15
|
+
*/
|
|
16
|
+
import { EventEmitter } from 'events';
|
|
17
|
+
/**
|
|
18
|
+
* Default session configuration
|
|
19
|
+
*/
|
|
20
|
+
const DEFAULT_SESSION_CONFIG = {
|
|
21
|
+
maxSessions: 100,
|
|
22
|
+
sessionTimeout: 30 * 60 * 1000, // 30 minutes
|
|
23
|
+
cleanupInterval: 60 * 1000, // 1 minute
|
|
24
|
+
enableMetrics: true,
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Session Manager
|
|
28
|
+
*
|
|
29
|
+
* Handles creation, tracking, and cleanup of MCP sessions
|
|
30
|
+
*/
|
|
31
|
+
export class SessionManager extends EventEmitter {
|
|
32
|
+
logger;
|
|
33
|
+
sessions = new Map();
|
|
34
|
+
config;
|
|
35
|
+
cleanupTimer;
|
|
36
|
+
sessionCounter = 0;
|
|
37
|
+
// Statistics
|
|
38
|
+
totalCreated = 0;
|
|
39
|
+
totalClosed = 0;
|
|
40
|
+
totalExpired = 0;
|
|
41
|
+
constructor(logger, config = {}) {
|
|
42
|
+
super();
|
|
43
|
+
this.logger = logger;
|
|
44
|
+
this.config = { ...DEFAULT_SESSION_CONFIG, ...config };
|
|
45
|
+
this.startCleanupTimer();
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Create a new session
|
|
49
|
+
*/
|
|
50
|
+
createSession(transport) {
|
|
51
|
+
// Check max sessions
|
|
52
|
+
if (this.sessions.size >= this.config.maxSessions) {
|
|
53
|
+
throw new Error(`Maximum sessions (${this.config.maxSessions}) reached`);
|
|
54
|
+
}
|
|
55
|
+
const id = this.generateSessionId();
|
|
56
|
+
const now = new Date();
|
|
57
|
+
const session = {
|
|
58
|
+
id,
|
|
59
|
+
state: 'created',
|
|
60
|
+
transport,
|
|
61
|
+
createdAt: now,
|
|
62
|
+
lastActivityAt: now,
|
|
63
|
+
isInitialized: false,
|
|
64
|
+
isAuthenticated: false,
|
|
65
|
+
};
|
|
66
|
+
this.sessions.set(id, session);
|
|
67
|
+
this.totalCreated++;
|
|
68
|
+
this.logger.debug('Session created', { id, transport });
|
|
69
|
+
this.emit('session:created', session);
|
|
70
|
+
return session;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Initialize a session with client information
|
|
74
|
+
*/
|
|
75
|
+
initializeSession(sessionId, params) {
|
|
76
|
+
const session = this.sessions.get(sessionId);
|
|
77
|
+
if (!session) {
|
|
78
|
+
this.logger.warn('Session not found for initialization', { sessionId });
|
|
79
|
+
return undefined;
|
|
80
|
+
}
|
|
81
|
+
session.state = 'ready';
|
|
82
|
+
session.isInitialized = true;
|
|
83
|
+
session.clientInfo = params.clientInfo;
|
|
84
|
+
session.protocolVersion = params.protocolVersion;
|
|
85
|
+
session.capabilities = params.capabilities;
|
|
86
|
+
session.lastActivityAt = new Date();
|
|
87
|
+
this.logger.info('Session initialized', {
|
|
88
|
+
sessionId,
|
|
89
|
+
clientInfo: params.clientInfo,
|
|
90
|
+
protocolVersion: params.protocolVersion,
|
|
91
|
+
});
|
|
92
|
+
this.emit('session:initialized', session);
|
|
93
|
+
return session;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Authenticate a session
|
|
97
|
+
*/
|
|
98
|
+
authenticateSession(sessionId) {
|
|
99
|
+
const session = this.sessions.get(sessionId);
|
|
100
|
+
if (!session) {
|
|
101
|
+
return false;
|
|
102
|
+
}
|
|
103
|
+
session.isAuthenticated = true;
|
|
104
|
+
session.lastActivityAt = new Date();
|
|
105
|
+
this.logger.debug('Session authenticated', { sessionId });
|
|
106
|
+
this.emit('session:authenticated', session);
|
|
107
|
+
return true;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Get a session by ID
|
|
111
|
+
*/
|
|
112
|
+
getSession(sessionId) {
|
|
113
|
+
return this.sessions.get(sessionId);
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Check if session exists
|
|
117
|
+
*/
|
|
118
|
+
hasSession(sessionId) {
|
|
119
|
+
return this.sessions.has(sessionId);
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Get all active sessions
|
|
123
|
+
*/
|
|
124
|
+
getActiveSessions() {
|
|
125
|
+
return Array.from(this.sessions.values()).filter((s) => s.state === 'ready' || s.state === 'created' || s.state === 'initializing');
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* Update session activity timestamp
|
|
129
|
+
*/
|
|
130
|
+
updateActivity(sessionId) {
|
|
131
|
+
const session = this.sessions.get(sessionId);
|
|
132
|
+
if (!session) {
|
|
133
|
+
return false;
|
|
134
|
+
}
|
|
135
|
+
session.lastActivityAt = new Date();
|
|
136
|
+
return true;
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* Set session state
|
|
140
|
+
*/
|
|
141
|
+
setState(sessionId, state) {
|
|
142
|
+
const session = this.sessions.get(sessionId);
|
|
143
|
+
if (!session) {
|
|
144
|
+
return false;
|
|
145
|
+
}
|
|
146
|
+
const oldState = session.state;
|
|
147
|
+
session.state = state;
|
|
148
|
+
session.lastActivityAt = new Date();
|
|
149
|
+
this.logger.debug('Session state changed', {
|
|
150
|
+
sessionId,
|
|
151
|
+
oldState,
|
|
152
|
+
newState: state,
|
|
153
|
+
});
|
|
154
|
+
this.emit('session:stateChanged', { session, oldState, newState: state });
|
|
155
|
+
return true;
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Set session metadata
|
|
159
|
+
*/
|
|
160
|
+
setMetadata(sessionId, key, value) {
|
|
161
|
+
const session = this.sessions.get(sessionId);
|
|
162
|
+
if (!session) {
|
|
163
|
+
return false;
|
|
164
|
+
}
|
|
165
|
+
if (!session.metadata) {
|
|
166
|
+
session.metadata = {};
|
|
167
|
+
}
|
|
168
|
+
session.metadata[key] = value;
|
|
169
|
+
session.lastActivityAt = new Date();
|
|
170
|
+
return true;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Get session metadata
|
|
174
|
+
*/
|
|
175
|
+
getMetadata(sessionId, key) {
|
|
176
|
+
const session = this.sessions.get(sessionId);
|
|
177
|
+
return session?.metadata?.[key];
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
* Close a session
|
|
181
|
+
*/
|
|
182
|
+
closeSession(sessionId, reason) {
|
|
183
|
+
const session = this.sessions.get(sessionId);
|
|
184
|
+
if (!session) {
|
|
185
|
+
return false;
|
|
186
|
+
}
|
|
187
|
+
session.state = 'closed';
|
|
188
|
+
this.sessions.delete(sessionId);
|
|
189
|
+
this.totalClosed++;
|
|
190
|
+
this.logger.info('Session closed', { sessionId, reason });
|
|
191
|
+
this.emit('session:closed', { session, reason });
|
|
192
|
+
return true;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* Remove a session (alias for closeSession)
|
|
196
|
+
*/
|
|
197
|
+
removeSession(sessionId) {
|
|
198
|
+
return this.closeSession(sessionId);
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Get session metrics
|
|
202
|
+
*/
|
|
203
|
+
getSessionMetrics() {
|
|
204
|
+
let authenticated = 0;
|
|
205
|
+
let active = 0;
|
|
206
|
+
for (const session of this.sessions.values()) {
|
|
207
|
+
if (session.isAuthenticated)
|
|
208
|
+
authenticated++;
|
|
209
|
+
if (session.state === 'ready')
|
|
210
|
+
active++;
|
|
211
|
+
}
|
|
212
|
+
return {
|
|
213
|
+
total: this.sessions.size,
|
|
214
|
+
active,
|
|
215
|
+
authenticated,
|
|
216
|
+
expired: this.totalExpired,
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* Get detailed statistics
|
|
221
|
+
*/
|
|
222
|
+
getStats() {
|
|
223
|
+
const byState = {
|
|
224
|
+
created: 0,
|
|
225
|
+
initializing: 0,
|
|
226
|
+
ready: 0,
|
|
227
|
+
closing: 0,
|
|
228
|
+
closed: 0,
|
|
229
|
+
error: 0,
|
|
230
|
+
};
|
|
231
|
+
const byTransport = {
|
|
232
|
+
stdio: 0,
|
|
233
|
+
http: 0,
|
|
234
|
+
websocket: 0,
|
|
235
|
+
'in-process': 0,
|
|
236
|
+
};
|
|
237
|
+
let oldest;
|
|
238
|
+
let newest;
|
|
239
|
+
for (const session of this.sessions.values()) {
|
|
240
|
+
byState[session.state] = (byState[session.state] || 0) + 1;
|
|
241
|
+
byTransport[session.transport] = (byTransport[session.transport] || 0) + 1;
|
|
242
|
+
if (!oldest || session.createdAt < oldest) {
|
|
243
|
+
oldest = session.createdAt;
|
|
244
|
+
}
|
|
245
|
+
if (!newest || session.createdAt > newest) {
|
|
246
|
+
newest = session.createdAt;
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
return {
|
|
250
|
+
total: this.sessions.size,
|
|
251
|
+
byState: byState,
|
|
252
|
+
byTransport: byTransport,
|
|
253
|
+
totalCreated: this.totalCreated,
|
|
254
|
+
totalClosed: this.totalClosed,
|
|
255
|
+
totalExpired: this.totalExpired,
|
|
256
|
+
oldestSession: oldest,
|
|
257
|
+
newestSession: newest,
|
|
258
|
+
};
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* Clean up expired sessions
|
|
262
|
+
*/
|
|
263
|
+
cleanupExpiredSessions() {
|
|
264
|
+
const now = Date.now();
|
|
265
|
+
const expired = [];
|
|
266
|
+
for (const [id, session] of this.sessions) {
|
|
267
|
+
const inactiveTime = now - session.lastActivityAt.getTime();
|
|
268
|
+
if (inactiveTime > this.config.sessionTimeout) {
|
|
269
|
+
expired.push(id);
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
for (const id of expired) {
|
|
273
|
+
const session = this.sessions.get(id);
|
|
274
|
+
if (session) {
|
|
275
|
+
session.state = 'closed';
|
|
276
|
+
this.sessions.delete(id);
|
|
277
|
+
this.totalExpired++;
|
|
278
|
+
this.logger.info('Session expired', { sessionId: id });
|
|
279
|
+
this.emit('session:expired', session);
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
if (expired.length > 0) {
|
|
283
|
+
this.logger.info('Cleaned up expired sessions', { count: expired.length });
|
|
284
|
+
}
|
|
285
|
+
return expired.length;
|
|
286
|
+
}
|
|
287
|
+
/**
|
|
288
|
+
* Start cleanup timer
|
|
289
|
+
*/
|
|
290
|
+
startCleanupTimer() {
|
|
291
|
+
this.cleanupTimer = setInterval(() => {
|
|
292
|
+
this.cleanupExpiredSessions();
|
|
293
|
+
}, this.config.cleanupInterval);
|
|
294
|
+
}
|
|
295
|
+
/**
|
|
296
|
+
* Stop cleanup timer
|
|
297
|
+
*/
|
|
298
|
+
stopCleanupTimer() {
|
|
299
|
+
if (this.cleanupTimer) {
|
|
300
|
+
clearInterval(this.cleanupTimer);
|
|
301
|
+
this.cleanupTimer = undefined;
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
/**
|
|
305
|
+
* Generate a unique session ID
|
|
306
|
+
*/
|
|
307
|
+
generateSessionId() {
|
|
308
|
+
return `session-${++this.sessionCounter}-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
|
|
309
|
+
}
|
|
310
|
+
/**
|
|
311
|
+
* Clear all sessions
|
|
312
|
+
*/
|
|
313
|
+
clearAll() {
|
|
314
|
+
for (const id of this.sessions.keys()) {
|
|
315
|
+
this.closeSession(id, 'Session manager cleared');
|
|
316
|
+
}
|
|
317
|
+
this.logger.info('All sessions cleared');
|
|
318
|
+
}
|
|
319
|
+
/**
|
|
320
|
+
* Destroy the session manager
|
|
321
|
+
*/
|
|
322
|
+
destroy() {
|
|
323
|
+
this.stopCleanupTimer();
|
|
324
|
+
this.clearAll();
|
|
325
|
+
this.removeAllListeners();
|
|
326
|
+
this.logger.info('Session manager destroyed');
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* Create a session manager
|
|
331
|
+
*/
|
|
332
|
+
export function createSessionManager(logger, config) {
|
|
333
|
+
return new SessionManager(logger, config);
|
|
334
|
+
}
|
|
335
|
+
//# sourceMappingURL=session-manager.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/mcp/session-manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 MCP Tool Registry
|
|
3
|
+
*
|
|
4
|
+
* High-performance tool management with:
|
|
5
|
+
* - Fast O(1) lookup using Map
|
|
6
|
+
* - Category-based organization
|
|
7
|
+
* - Tool validation on registration
|
|
8
|
+
* - Dynamic registration/unregistration
|
|
9
|
+
* - Caching for frequently used tools
|
|
10
|
+
*
|
|
11
|
+
* Performance Targets:
|
|
12
|
+
* - Tool registration: <10ms
|
|
13
|
+
* - Tool lookup: <1ms
|
|
14
|
+
* - Tool validation: <5ms
|
|
15
|
+
*/
|
|
16
|
+
import { EventEmitter } from 'events';
|
|
17
|
+
import { MCPTool, JSONSchema, ToolHandler, ToolContext, ToolCallResult, ToolRegistrationOptions, ILogger } from './types.js';
|
|
18
|
+
/**
|
|
19
|
+
* Tool metadata for enhanced lookup
|
|
20
|
+
*/
|
|
21
|
+
interface ToolMetadata {
|
|
22
|
+
tool: MCPTool;
|
|
23
|
+
registeredAt: Date;
|
|
24
|
+
callCount: number;
|
|
25
|
+
lastCalled?: Date;
|
|
26
|
+
avgExecutionTime: number;
|
|
27
|
+
errorCount: number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Tool search options
|
|
31
|
+
*/
|
|
32
|
+
interface ToolSearchOptions {
|
|
33
|
+
category?: string;
|
|
34
|
+
tags?: string[];
|
|
35
|
+
deprecated?: boolean;
|
|
36
|
+
cacheable?: boolean;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Tool Registry
|
|
40
|
+
*
|
|
41
|
+
* Manages registration, lookup, and execution of MCP tools
|
|
42
|
+
*/
|
|
43
|
+
export declare class ToolRegistry extends EventEmitter {
|
|
44
|
+
private readonly logger;
|
|
45
|
+
private readonly tools;
|
|
46
|
+
private readonly categoryIndex;
|
|
47
|
+
private readonly tagIndex;
|
|
48
|
+
private defaultContext?;
|
|
49
|
+
private totalRegistrations;
|
|
50
|
+
private totalLookups;
|
|
51
|
+
private totalExecutions;
|
|
52
|
+
constructor(logger: ILogger);
|
|
53
|
+
/**
|
|
54
|
+
* Register a tool
|
|
55
|
+
*/
|
|
56
|
+
register(tool: MCPTool, options?: ToolRegistrationOptions): boolean;
|
|
57
|
+
/**
|
|
58
|
+
* Register multiple tools at once
|
|
59
|
+
*/
|
|
60
|
+
registerBatch(tools: MCPTool[], options?: ToolRegistrationOptions): {
|
|
61
|
+
registered: number;
|
|
62
|
+
failed: string[];
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* Unregister a tool
|
|
66
|
+
*/
|
|
67
|
+
unregister(name: string): boolean;
|
|
68
|
+
/**
|
|
69
|
+
* Get a tool by name
|
|
70
|
+
*/
|
|
71
|
+
getTool(name: string): MCPTool | undefined;
|
|
72
|
+
/**
|
|
73
|
+
* Check if a tool exists
|
|
74
|
+
*/
|
|
75
|
+
hasTool(name: string): boolean;
|
|
76
|
+
/**
|
|
77
|
+
* Get tool count
|
|
78
|
+
*/
|
|
79
|
+
getToolCount(): number;
|
|
80
|
+
/**
|
|
81
|
+
* Get all tool names
|
|
82
|
+
*/
|
|
83
|
+
getToolNames(): string[];
|
|
84
|
+
/**
|
|
85
|
+
* List all tools with metadata
|
|
86
|
+
*/
|
|
87
|
+
listTools(): Array<{
|
|
88
|
+
name: string;
|
|
89
|
+
description: string;
|
|
90
|
+
category?: string;
|
|
91
|
+
tags?: string[];
|
|
92
|
+
deprecated?: boolean;
|
|
93
|
+
}>;
|
|
94
|
+
/**
|
|
95
|
+
* Search tools by criteria
|
|
96
|
+
*/
|
|
97
|
+
search(options: ToolSearchOptions): MCPTool[];
|
|
98
|
+
/**
|
|
99
|
+
* Get tools by category
|
|
100
|
+
*/
|
|
101
|
+
getByCategory(category: string): MCPTool[];
|
|
102
|
+
/**
|
|
103
|
+
* Get tools by tag
|
|
104
|
+
*/
|
|
105
|
+
getByTag(tag: string): MCPTool[];
|
|
106
|
+
/**
|
|
107
|
+
* Get all categories
|
|
108
|
+
*/
|
|
109
|
+
getCategories(): string[];
|
|
110
|
+
/**
|
|
111
|
+
* Get all tags
|
|
112
|
+
*/
|
|
113
|
+
getTags(): string[];
|
|
114
|
+
/**
|
|
115
|
+
* Execute a tool
|
|
116
|
+
*/
|
|
117
|
+
execute(name: string, input: Record<string, unknown>, context?: ToolContext): Promise<ToolCallResult>;
|
|
118
|
+
/**
|
|
119
|
+
* Set default execution context
|
|
120
|
+
*/
|
|
121
|
+
setDefaultContext(context: ToolContext): void;
|
|
122
|
+
/**
|
|
123
|
+
* Get tool metadata
|
|
124
|
+
*/
|
|
125
|
+
getMetadata(name: string): ToolMetadata | undefined;
|
|
126
|
+
/**
|
|
127
|
+
* Get registry statistics
|
|
128
|
+
*/
|
|
129
|
+
getStats(): {
|
|
130
|
+
totalTools: number;
|
|
131
|
+
totalCategories: number;
|
|
132
|
+
totalTags: number;
|
|
133
|
+
totalRegistrations: number;
|
|
134
|
+
totalLookups: number;
|
|
135
|
+
totalExecutions: number;
|
|
136
|
+
topTools: Array<{
|
|
137
|
+
name: string;
|
|
138
|
+
calls: number;
|
|
139
|
+
}>;
|
|
140
|
+
};
|
|
141
|
+
/**
|
|
142
|
+
* Validate a tool definition
|
|
143
|
+
*/
|
|
144
|
+
validateTool(tool: MCPTool): {
|
|
145
|
+
valid: boolean;
|
|
146
|
+
errors: string[];
|
|
147
|
+
};
|
|
148
|
+
/**
|
|
149
|
+
* Validate JSON Schema
|
|
150
|
+
*/
|
|
151
|
+
private validateSchema;
|
|
152
|
+
/**
|
|
153
|
+
* Update average execution time
|
|
154
|
+
*/
|
|
155
|
+
private updateAverageExecutionTime;
|
|
156
|
+
/**
|
|
157
|
+
* Clear all tools
|
|
158
|
+
*/
|
|
159
|
+
clear(): void;
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Create a tool registry
|
|
163
|
+
*/
|
|
164
|
+
export declare function createToolRegistry(logger: ILogger): ToolRegistry;
|
|
165
|
+
/**
|
|
166
|
+
* Helper to create a tool definition
|
|
167
|
+
*/
|
|
168
|
+
export declare function defineTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, description: string, inputSchema: JSONSchema, handler: ToolHandler<TInput, TOutput>, options?: {
|
|
169
|
+
category?: string;
|
|
170
|
+
tags?: string[];
|
|
171
|
+
version?: string;
|
|
172
|
+
deprecated?: boolean;
|
|
173
|
+
cacheable?: boolean;
|
|
174
|
+
cacheTTL?: number;
|
|
175
|
+
timeout?: number;
|
|
176
|
+
}): MCPTool<TInput, TOutput>;
|
|
177
|
+
export {};
|
|
178
|
+
//# sourceMappingURL=tool-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"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"}
|