agentic-qe 3.2.3 → 3.3.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.
- package/.claude/agents/v3/qe-accessibility-auditor.md +90 -0
- package/README.md +43 -5
- package/package.json +3 -2
- package/scripts/cloud-db-config.json +37 -0
- package/scripts/cloud-db-connect.sh +37 -0
- package/scripts/cloud-db-tunnel.sh +23 -0
- package/v3/CHANGELOG.md +165 -0
- package/v3/README.md +59 -1
- package/v3/assets/agents/v3/qe-accessibility-auditor.md +90 -0
- package/v3/dist/adapters/claude-flow/index.d.ts +54 -0
- package/v3/dist/adapters/claude-flow/index.d.ts.map +1 -0
- package/v3/dist/adapters/claude-flow/index.js +79 -0
- package/v3/dist/adapters/claude-flow/index.js.map +1 -0
- package/v3/dist/adapters/claude-flow/model-router-bridge.d.ts +70 -0
- package/v3/dist/adapters/claude-flow/model-router-bridge.d.ts.map +1 -0
- package/v3/dist/adapters/claude-flow/model-router-bridge.js +203 -0
- package/v3/dist/adapters/claude-flow/model-router-bridge.js.map +1 -0
- package/v3/dist/adapters/claude-flow/pretrain-bridge.d.ts +73 -0
- package/v3/dist/adapters/claude-flow/pretrain-bridge.d.ts.map +1 -0
- package/v3/dist/adapters/claude-flow/pretrain-bridge.js +276 -0
- package/v3/dist/adapters/claude-flow/pretrain-bridge.js.map +1 -0
- package/v3/dist/adapters/claude-flow/trajectory-bridge.d.ts +70 -0
- package/v3/dist/adapters/claude-flow/trajectory-bridge.d.ts.map +1 -0
- package/v3/dist/adapters/claude-flow/trajectory-bridge.js +205 -0
- package/v3/dist/adapters/claude-flow/trajectory-bridge.js.map +1 -0
- package/v3/dist/adapters/claude-flow/types.d.ts +99 -0
- package/v3/dist/adapters/claude-flow/types.d.ts.map +1 -0
- package/v3/dist/adapters/claude-flow/types.js +6 -0
- package/v3/dist/adapters/claude-flow/types.js.map +1 -0
- package/v3/dist/causal-discovery/causal-graph.d.ts +80 -1
- package/v3/dist/causal-discovery/causal-graph.d.ts.map +1 -1
- package/v3/dist/causal-discovery/causal-graph.js +111 -1
- package/v3/dist/causal-discovery/causal-graph.js.map +1 -1
- package/v3/dist/cli/bundle.js +11612 -4929
- package/v3/dist/cli/commands/claude-flow-setup.d.ts +82 -0
- package/v3/dist/cli/commands/claude-flow-setup.d.ts.map +1 -0
- package/v3/dist/cli/commands/claude-flow-setup.js +334 -0
- package/v3/dist/cli/commands/claude-flow-setup.js.map +1 -0
- package/v3/dist/cli/commands/hooks.d.ts +2 -0
- package/v3/dist/cli/commands/hooks.d.ts.map +1 -1
- package/v3/dist/cli/commands/hooks.js +13 -2
- package/v3/dist/cli/commands/hooks.js.map +1 -1
- package/v3/dist/cli/commands/init.d.ts +19 -0
- package/v3/dist/cli/commands/init.d.ts.map +1 -0
- package/v3/dist/cli/commands/init.js +345 -0
- package/v3/dist/cli/commands/init.js.map +1 -0
- package/v3/dist/cli/index.js +110 -2
- package/v3/dist/cli/index.js.map +1 -1
- package/v3/dist/coordination/mincut/interfaces.d.ts +8 -2
- package/v3/dist/coordination/mincut/interfaces.d.ts.map +1 -1
- package/v3/dist/coordination/mincut/interfaces.js.map +1 -1
- package/v3/dist/coordination/mincut/mincut-health-monitor.d.ts +5 -0
- package/v3/dist/coordination/mincut/mincut-health-monitor.d.ts.map +1 -1
- package/v3/dist/coordination/mincut/mincut-health-monitor.js +22 -4
- package/v3/dist/coordination/mincut/mincut-health-monitor.js.map +1 -1
- package/v3/dist/coordination/mincut/queen-integration.d.ts +4 -0
- package/v3/dist/coordination/mincut/queen-integration.d.ts.map +1 -1
- package/v3/dist/coordination/mincut/queen-integration.js +14 -1
- package/v3/dist/coordination/mincut/queen-integration.js.map +1 -1
- package/v3/dist/coordination/queen-coordinator.d.ts +5 -0
- package/v3/dist/coordination/queen-coordinator.d.ts.map +1 -1
- package/v3/dist/coordination/queen-coordinator.js +45 -7
- package/v3/dist/coordination/queen-coordinator.js.map +1 -1
- package/v3/dist/domains/learning-optimization/coordinator.d.ts +5 -0
- package/v3/dist/domains/learning-optimization/coordinator.d.ts.map +1 -1
- package/v3/dist/domains/learning-optimization/coordinator.js +79 -0
- package/v3/dist/domains/learning-optimization/coordinator.js.map +1 -1
- package/v3/dist/domains/test-generation/coherence-gate.d.ts +245 -0
- package/v3/dist/domains/test-generation/coherence-gate.d.ts.map +1 -0
- package/v3/dist/domains/test-generation/coherence-gate.js +454 -0
- package/v3/dist/domains/test-generation/coherence-gate.js.map +1 -0
- package/v3/dist/domains/test-generation/coordinator.d.ts +32 -1
- package/v3/dist/domains/test-generation/coordinator.d.ts.map +1 -1
- package/v3/dist/domains/test-generation/coordinator.js +70 -1
- package/v3/dist/domains/test-generation/coordinator.js.map +1 -1
- package/v3/dist/domains/test-generation/index.d.ts +1 -0
- package/v3/dist/domains/test-generation/index.d.ts.map +1 -1
- package/v3/dist/domains/test-generation/index.js +4 -0
- package/v3/dist/domains/test-generation/index.js.map +1 -1
- package/v3/dist/domains/test-generation/services/index.d.ts +1 -0
- package/v3/dist/domains/test-generation/services/index.d.ts.map +1 -1
- package/v3/dist/domains/test-generation/services/index.js +2 -0
- package/v3/dist/domains/test-generation/services/index.js.map +1 -1
- package/v3/dist/domains/visual-accessibility/index.d.ts +2 -1
- package/v3/dist/domains/visual-accessibility/index.d.ts.map +1 -1
- package/v3/dist/domains/visual-accessibility/index.js +1 -0
- package/v3/dist/domains/visual-accessibility/index.js.map +1 -1
- package/v3/dist/domains/visual-accessibility/interfaces.d.ts +131 -0
- package/v3/dist/domains/visual-accessibility/interfaces.d.ts.map +1 -1
- package/v3/dist/domains/visual-accessibility/plugin.d.ts +26 -0
- package/v3/dist/domains/visual-accessibility/plugin.d.ts.map +1 -1
- package/v3/dist/domains/visual-accessibility/plugin.js +151 -0
- package/v3/dist/domains/visual-accessibility/plugin.js.map +1 -1
- package/v3/dist/domains/visual-accessibility/services/accessibility-tester.d.ts +42 -1
- package/v3/dist/domains/visual-accessibility/services/accessibility-tester.d.ts.map +1 -1
- package/v3/dist/domains/visual-accessibility/services/accessibility-tester.js +69 -0
- package/v3/dist/domains/visual-accessibility/services/accessibility-tester.js.map +1 -1
- package/v3/dist/domains/visual-accessibility/services/eu-compliance.d.ts +138 -0
- package/v3/dist/domains/visual-accessibility/services/eu-compliance.d.ts.map +1 -0
- package/v3/dist/domains/visual-accessibility/services/eu-compliance.js +830 -0
- package/v3/dist/domains/visual-accessibility/services/eu-compliance.js.map +1 -0
- package/v3/dist/domains/visual-accessibility/services/index.d.ts +1 -0
- package/v3/dist/domains/visual-accessibility/services/index.d.ts.map +1 -1
- package/v3/dist/domains/visual-accessibility/services/index.js +1 -0
- package/v3/dist/domains/visual-accessibility/services/index.js.map +1 -1
- package/v3/dist/init/enhancements/claude-flow-adapter.d.ts +84 -0
- package/v3/dist/init/enhancements/claude-flow-adapter.d.ts.map +1 -0
- package/v3/dist/init/enhancements/claude-flow-adapter.js +250 -0
- package/v3/dist/init/enhancements/claude-flow-adapter.js.map +1 -0
- package/v3/dist/init/enhancements/detector.d.ts +10 -0
- package/v3/dist/init/enhancements/detector.d.ts.map +1 -0
- package/v3/dist/init/enhancements/detector.js +87 -0
- package/v3/dist/init/enhancements/detector.js.map +1 -0
- package/v3/dist/init/enhancements/index.d.ts +13 -0
- package/v3/dist/init/enhancements/index.d.ts.map +1 -0
- package/v3/dist/init/enhancements/index.js +25 -0
- package/v3/dist/init/enhancements/index.js.map +1 -0
- package/v3/dist/init/enhancements/types.d.ts +93 -0
- package/v3/dist/init/enhancements/types.d.ts.map +1 -0
- package/v3/dist/init/enhancements/types.js +6 -0
- package/v3/dist/init/enhancements/types.js.map +1 -0
- package/v3/dist/init/index.d.ts +8 -0
- package/v3/dist/init/index.d.ts.map +1 -1
- package/v3/dist/init/index.js +4 -0
- package/v3/dist/init/index.js.map +1 -1
- package/v3/dist/init/migration/config-migrator.d.ts +31 -0
- package/v3/dist/init/migration/config-migrator.d.ts.map +1 -0
- package/v3/dist/init/migration/config-migrator.js +133 -0
- package/v3/dist/init/migration/config-migrator.js.map +1 -0
- package/v3/dist/init/migration/data-migrator.d.ts +72 -0
- package/v3/dist/init/migration/data-migrator.d.ts.map +1 -0
- package/v3/dist/init/migration/data-migrator.js +233 -0
- package/v3/dist/init/migration/data-migrator.js.map +1 -0
- package/v3/dist/init/migration/detector.d.ts +44 -0
- package/v3/dist/init/migration/detector.d.ts.map +1 -0
- package/v3/dist/init/migration/detector.js +106 -0
- package/v3/dist/init/migration/detector.js.map +1 -0
- package/v3/dist/init/migration/index.d.ts +8 -0
- package/v3/dist/init/migration/index.d.ts.map +1 -0
- package/v3/dist/init/migration/index.js +8 -0
- package/v3/dist/init/migration/index.js.map +1 -0
- package/v3/dist/init/orchestrator.d.ts +68 -0
- package/v3/dist/init/orchestrator.d.ts.map +1 -0
- package/v3/dist/init/orchestrator.js +239 -0
- package/v3/dist/init/orchestrator.js.map +1 -0
- package/v3/dist/init/phases/01-detection.d.ts +30 -0
- package/v3/dist/init/phases/01-detection.d.ts.map +1 -0
- package/v3/dist/init/phases/01-detection.js +143 -0
- package/v3/dist/init/phases/01-detection.js.map +1 -0
- package/v3/dist/init/phases/02-analysis.d.ts +18 -0
- package/v3/dist/init/phases/02-analysis.d.ts.map +1 -0
- package/v3/dist/init/phases/02-analysis.js +28 -0
- package/v3/dist/init/phases/02-analysis.js.map +1 -0
- package/v3/dist/init/phases/03-configuration.d.ts +26 -0
- package/v3/dist/init/phases/03-configuration.d.ts.map +1 -0
- package/v3/dist/init/phases/03-configuration.js +98 -0
- package/v3/dist/init/phases/03-configuration.js.map +1 -0
- package/v3/dist/init/phases/04-database.d.ts +22 -0
- package/v3/dist/init/phases/04-database.d.ts.map +1 -0
- package/v3/dist/init/phases/04-database.js +88 -0
- package/v3/dist/init/phases/04-database.js.map +1 -0
- package/v3/dist/init/phases/05-learning.d.ts +28 -0
- package/v3/dist/init/phases/05-learning.d.ts.map +1 -0
- package/v3/dist/init/phases/05-learning.js +98 -0
- package/v3/dist/init/phases/05-learning.js.map +1 -0
- package/v3/dist/init/phases/06-code-intelligence.d.ts +33 -0
- package/v3/dist/init/phases/06-code-intelligence.d.ts.map +1 -0
- package/v3/dist/init/phases/06-code-intelligence.js +115 -0
- package/v3/dist/init/phases/06-code-intelligence.js.map +1 -0
- package/v3/dist/init/phases/07-hooks.d.ts +27 -0
- package/v3/dist/init/phases/07-hooks.d.ts.map +1 -0
- package/v3/dist/init/phases/07-hooks.js +209 -0
- package/v3/dist/init/phases/07-hooks.js.map +1 -0
- package/v3/dist/init/phases/08-mcp.d.ts +22 -0
- package/v3/dist/init/phases/08-mcp.d.ts.map +1 -0
- package/v3/dist/init/phases/08-mcp.js +62 -0
- package/v3/dist/init/phases/08-mcp.js.map +1 -0
- package/v3/dist/init/phases/09-assets.d.ts +23 -0
- package/v3/dist/init/phases/09-assets.d.ts.map +1 -0
- package/v3/dist/init/phases/09-assets.js +82 -0
- package/v3/dist/init/phases/09-assets.js.map +1 -0
- package/v3/dist/init/phases/10-workers.d.ts +23 -0
- package/v3/dist/init/phases/10-workers.d.ts.map +1 -0
- package/v3/dist/init/phases/10-workers.js +111 -0
- package/v3/dist/init/phases/10-workers.js.map +1 -0
- package/v3/dist/init/phases/11-claude-md.d.ts +26 -0
- package/v3/dist/init/phases/11-claude-md.d.ts.map +1 -0
- package/v3/dist/init/phases/11-claude-md.js +121 -0
- package/v3/dist/init/phases/11-claude-md.js.map +1 -0
- package/v3/dist/init/phases/12-verification.d.ts +38 -0
- package/v3/dist/init/phases/12-verification.d.ts.map +1 -0
- package/v3/dist/init/phases/12-verification.js +187 -0
- package/v3/dist/init/phases/12-verification.js.map +1 -0
- package/v3/dist/init/phases/index.d.ts +46 -0
- package/v3/dist/init/phases/index.d.ts.map +1 -0
- package/v3/dist/init/phases/index.js +64 -0
- package/v3/dist/init/phases/index.js.map +1 -0
- package/v3/dist/init/phases/phase-interface.d.ts +193 -0
- package/v3/dist/init/phases/phase-interface.d.ts.map +1 -0
- package/v3/dist/init/phases/phase-interface.js +119 -0
- package/v3/dist/init/phases/phase-interface.js.map +1 -0
- package/v3/dist/integrations/coherence/coherence-service.d.ts +323 -0
- package/v3/dist/integrations/coherence/coherence-service.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/coherence-service.js +799 -0
- package/v3/dist/integrations/coherence/coherence-service.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/category-adapter.d.ts +170 -0
- package/v3/dist/integrations/coherence/engines/category-adapter.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/category-adapter.js +403 -0
- package/v3/dist/integrations/coherence/engines/category-adapter.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/causal-adapter.d.ts +159 -0
- package/v3/dist/integrations/coherence/engines/causal-adapter.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/causal-adapter.js +348 -0
- package/v3/dist/integrations/coherence/engines/causal-adapter.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/cohomology-adapter.d.ts +174 -0
- package/v3/dist/integrations/coherence/engines/cohomology-adapter.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/cohomology-adapter.js +401 -0
- package/v3/dist/integrations/coherence/engines/cohomology-adapter.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/homotopy-adapter.d.ts +201 -0
- package/v3/dist/integrations/coherence/engines/homotopy-adapter.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/homotopy-adapter.js +324 -0
- package/v3/dist/integrations/coherence/engines/homotopy-adapter.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/index.d.ts +20 -0
- package/v3/dist/integrations/coherence/engines/index.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/index.js +26 -0
- package/v3/dist/integrations/coherence/engines/index.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/spectral-adapter.d.ts +193 -0
- package/v3/dist/integrations/coherence/engines/spectral-adapter.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/spectral-adapter.js +476 -0
- package/v3/dist/integrations/coherence/engines/spectral-adapter.js.map +1 -0
- package/v3/dist/integrations/coherence/engines/witness-adapter.d.ts +175 -0
- package/v3/dist/integrations/coherence/engines/witness-adapter.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/engines/witness-adapter.js +377 -0
- package/v3/dist/integrations/coherence/engines/witness-adapter.js.map +1 -0
- package/v3/dist/integrations/coherence/index.d.ts +84 -0
- package/v3/dist/integrations/coherence/index.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/index.js +114 -0
- package/v3/dist/integrations/coherence/index.js.map +1 -0
- package/v3/dist/integrations/coherence/threshold-tuner.d.ts +396 -0
- package/v3/dist/integrations/coherence/threshold-tuner.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/threshold-tuner.js +538 -0
- package/v3/dist/integrations/coherence/threshold-tuner.js.map +1 -0
- package/v3/dist/integrations/coherence/types.d.ts +879 -0
- package/v3/dist/integrations/coherence/types.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/types.js +134 -0
- package/v3/dist/integrations/coherence/types.js.map +1 -0
- package/v3/dist/integrations/coherence/wasm-loader.d.ts +351 -0
- package/v3/dist/integrations/coherence/wasm-loader.d.ts.map +1 -0
- package/v3/dist/integrations/coherence/wasm-loader.js +842 -0
- package/v3/dist/integrations/coherence/wasm-loader.js.map +1 -0
- package/v3/dist/integrations/embeddings/index/HNSWIndex.d.ts.map +1 -1
- package/v3/dist/integrations/embeddings/index/HNSWIndex.js +4 -1
- package/v3/dist/integrations/embeddings/index/HNSWIndex.js.map +1 -1
- package/v3/dist/kernel/interfaces.d.ts +8 -1
- package/v3/dist/kernel/interfaces.d.ts.map +1 -1
- package/v3/dist/learning/aqe-learning-engine.d.ts +272 -0
- package/v3/dist/learning/aqe-learning-engine.d.ts.map +1 -0
- package/v3/dist/learning/aqe-learning-engine.js +708 -0
- package/v3/dist/learning/aqe-learning-engine.js.map +1 -0
- package/v3/dist/learning/causal-verifier.d.ts +244 -0
- package/v3/dist/learning/causal-verifier.d.ts.map +1 -0
- package/v3/dist/learning/causal-verifier.js +300 -0
- package/v3/dist/learning/causal-verifier.js.map +1 -0
- package/v3/dist/learning/experience-capture.d.ts +266 -0
- package/v3/dist/learning/experience-capture.d.ts.map +1 -0
- package/v3/dist/learning/experience-capture.js +647 -0
- package/v3/dist/learning/experience-capture.js.map +1 -0
- package/v3/dist/learning/index.d.ts +8 -0
- package/v3/dist/learning/index.d.ts.map +1 -1
- package/v3/dist/learning/index.js +16 -0
- package/v3/dist/learning/index.js.map +1 -1
- package/v3/dist/learning/memory-auditor.d.ts +235 -0
- package/v3/dist/learning/memory-auditor.d.ts.map +1 -0
- package/v3/dist/learning/memory-auditor.js +478 -0
- package/v3/dist/learning/memory-auditor.js.map +1 -0
- package/v3/dist/learning/pattern-store.d.ts.map +1 -1
- package/v3/dist/learning/pattern-store.js +27 -6
- package/v3/dist/learning/pattern-store.js.map +1 -1
- package/v3/dist/learning/qe-patterns.d.ts +15 -1
- package/v3/dist/learning/qe-patterns.d.ts.map +1 -1
- package/v3/dist/learning/qe-patterns.js +26 -5
- package/v3/dist/learning/qe-patterns.js.map +1 -1
- package/v3/dist/learning/qe-reasoning-bank.d.ts +38 -2
- package/v3/dist/learning/qe-reasoning-bank.d.ts.map +1 -1
- package/v3/dist/learning/qe-reasoning-bank.js +86 -4
- package/v3/dist/learning/qe-reasoning-bank.js.map +1 -1
- package/v3/dist/learning/real-qe-reasoning-bank.d.ts +32 -2
- package/v3/dist/learning/real-qe-reasoning-bank.d.ts.map +1 -1
- package/v3/dist/learning/real-qe-reasoning-bank.js +61 -6
- package/v3/dist/learning/real-qe-reasoning-bank.js.map +1 -1
- package/v3/dist/mcp/bundle.js +6303 -266
- package/v3/dist/mcp/tools/coherence/audit.d.ts +107 -0
- package/v3/dist/mcp/tools/coherence/audit.d.ts.map +1 -0
- package/v3/dist/mcp/tools/coherence/audit.js +236 -0
- package/v3/dist/mcp/tools/coherence/audit.js.map +1 -0
- package/v3/dist/mcp/tools/coherence/check.d.ts +106 -0
- package/v3/dist/mcp/tools/coherence/check.d.ts.map +1 -0
- package/v3/dist/mcp/tools/coherence/check.js +205 -0
- package/v3/dist/mcp/tools/coherence/check.js.map +1 -0
- package/v3/dist/mcp/tools/coherence/collapse.d.ts +123 -0
- package/v3/dist/mcp/tools/coherence/collapse.d.ts.map +1 -0
- package/v3/dist/mcp/tools/coherence/collapse.js +279 -0
- package/v3/dist/mcp/tools/coherence/collapse.js.map +1 -0
- package/v3/dist/mcp/tools/coherence/consensus.d.ts +100 -0
- package/v3/dist/mcp/tools/coherence/consensus.d.ts.map +1 -0
- package/v3/dist/mcp/tools/coherence/consensus.js +201 -0
- package/v3/dist/mcp/tools/coherence/consensus.js.map +1 -0
- package/v3/dist/mcp/tools/coherence/index.d.ts +31 -0
- package/v3/dist/mcp/tools/coherence/index.d.ts.map +1 -0
- package/v3/dist/mcp/tools/coherence/index.js +42 -0
- package/v3/dist/mcp/tools/coherence/index.js.map +1 -0
- package/v3/dist/mcp/tools/index.d.ts +6 -1
- package/v3/dist/mcp/tools/index.d.ts.map +1 -1
- package/v3/dist/mcp/tools/index.js +9 -1
- package/v3/dist/mcp/tools/index.js.map +1 -1
- package/v3/dist/mcp/tools/mincut/index.d.ts +1 -1
- package/v3/dist/mcp/tools/mincut/index.d.ts.map +1 -1
- package/v3/dist/mcp/tools/mincut/index.js.map +1 -1
- package/v3/dist/mcp/tools/registry.d.ts +4 -0
- package/v3/dist/mcp/tools/registry.d.ts.map +1 -1
- package/v3/dist/mcp/tools/registry.js +5 -0
- package/v3/dist/mcp/tools/registry.js.map +1 -1
- package/v3/dist/mcp/types.d.ts +1 -1
- package/v3/dist/mcp/types.d.ts.map +1 -1
- package/v3/dist/strange-loop/belief-reconciler.d.ts +357 -0
- package/v3/dist/strange-loop/belief-reconciler.d.ts.map +1 -0
- package/v3/dist/strange-loop/belief-reconciler.js +696 -0
- package/v3/dist/strange-loop/belief-reconciler.js.map +1 -0
- package/v3/dist/strange-loop/index.d.ts +1 -0
- package/v3/dist/strange-loop/index.d.ts.map +1 -1
- package/v3/dist/strange-loop/index.js +2 -0
- package/v3/dist/strange-loop/index.js.map +1 -1
- package/v3/dist/strange-loop/strange-loop.d.ts +177 -5
- package/v3/dist/strange-loop/strange-loop.d.ts.map +1 -1
- package/v3/dist/strange-loop/strange-loop.js +452 -9
- package/v3/dist/strange-loop/strange-loop.js.map +1 -1
- package/v3/dist/strange-loop/types.d.ts +205 -1
- package/v3/dist/strange-loop/types.d.ts.map +1 -1
- package/v3/dist/strange-loop/types.js +5 -0
- package/v3/dist/strange-loop/types.js.map +1 -1
- package/v3/package.json +5 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../../src/mcp/tools/coherence/check.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agentic QE v3 - Coherence Predict Collapse MCP Tool
|
|
3
|
+
* ADR-052: Phase 4 Action A4.1
|
|
4
|
+
*
|
|
5
|
+
* qe/coherence/collapse - Predict swarm collapse risk
|
|
6
|
+
*
|
|
7
|
+
* Uses the CoherenceService's spectral analysis to predict potential
|
|
8
|
+
* swarm collapse before it happens, enabling proactive mitigation.
|
|
9
|
+
*/
|
|
10
|
+
import { MCPToolBase, MCPToolConfig, MCPToolContext } from '../base.js';
|
|
11
|
+
import { ToolResult } from '../../types.js';
|
|
12
|
+
/**
|
|
13
|
+
* Parameters for collapse prediction
|
|
14
|
+
*/
|
|
15
|
+
export interface CoherenceCollapseParams {
|
|
16
|
+
/** Current swarm state - simplified input format */
|
|
17
|
+
swarmState: {
|
|
18
|
+
/** Agent health information */
|
|
19
|
+
agents: Array<{
|
|
20
|
+
agentId: string;
|
|
21
|
+
agentType?: string;
|
|
22
|
+
health: number;
|
|
23
|
+
errorCount?: number;
|
|
24
|
+
successRate?: number;
|
|
25
|
+
}>;
|
|
26
|
+
/** Total active tasks */
|
|
27
|
+
activeTasks: number;
|
|
28
|
+
/** Pending tasks */
|
|
29
|
+
pendingTasks: number;
|
|
30
|
+
/** System-wide error rate (0-1) */
|
|
31
|
+
errorRate: number;
|
|
32
|
+
/** Resource utilization (0-1) */
|
|
33
|
+
utilization: number;
|
|
34
|
+
};
|
|
35
|
+
/** Risk threshold for warning (0-1, default: 0.5) */
|
|
36
|
+
riskThreshold?: number;
|
|
37
|
+
/** Index signature for Record<string, unknown> compatibility */
|
|
38
|
+
[key: string]: unknown;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Result of collapse prediction
|
|
42
|
+
*/
|
|
43
|
+
export interface CoherenceCollapseResult {
|
|
44
|
+
/** Overall collapse risk (0-1, higher = more risk) */
|
|
45
|
+
risk: number;
|
|
46
|
+
/** Whether the swarm is at significant risk */
|
|
47
|
+
isAtRisk: boolean;
|
|
48
|
+
/** Risk level category */
|
|
49
|
+
riskLevel: 'low' | 'medium' | 'high' | 'critical';
|
|
50
|
+
/** Fiedler value (spectral gap - lower = more vulnerable) */
|
|
51
|
+
fiedlerValue: number;
|
|
52
|
+
/** Whether collapse is imminent */
|
|
53
|
+
collapseImminent: boolean;
|
|
54
|
+
/** Agents most vulnerable to failure */
|
|
55
|
+
weakVertices: string[];
|
|
56
|
+
/** Recommendations for mitigation */
|
|
57
|
+
recommendations: string[];
|
|
58
|
+
/** Execution time in milliseconds */
|
|
59
|
+
executionTimeMs: number;
|
|
60
|
+
/** Whether fallback logic was used */
|
|
61
|
+
usedFallback: boolean;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Coherence Predict Collapse Tool
|
|
65
|
+
*
|
|
66
|
+
* Uses Prime Radiant's spectral analysis to predict swarm collapse risk
|
|
67
|
+
* before it happens, enabling proactive mitigation.
|
|
68
|
+
*
|
|
69
|
+
* @example
|
|
70
|
+
* ```typescript
|
|
71
|
+
* const result = await tool.invoke({
|
|
72
|
+
* swarmState: {
|
|
73
|
+
* agents: [
|
|
74
|
+
* { agentId: 'agent-1', health: 0.9, errorCount: 2 },
|
|
75
|
+
* { agentId: 'agent-2', health: 0.7, errorCount: 5 },
|
|
76
|
+
* ],
|
|
77
|
+
* activeTasks: 10,
|
|
78
|
+
* pendingTasks: 3,
|
|
79
|
+
* errorRate: 0.05,
|
|
80
|
+
* utilization: 0.6,
|
|
81
|
+
* },
|
|
82
|
+
* riskThreshold: 0.6,
|
|
83
|
+
* });
|
|
84
|
+
*
|
|
85
|
+
* if (result.data.isAtRisk) {
|
|
86
|
+
* console.log('Collapse risk detected:', result.data.riskLevel);
|
|
87
|
+
* console.log('Recommendations:', result.data.recommendations);
|
|
88
|
+
* }
|
|
89
|
+
* ```
|
|
90
|
+
*/
|
|
91
|
+
export declare class CoherenceCollapseTool extends MCPToolBase<CoherenceCollapseParams, CoherenceCollapseResult> {
|
|
92
|
+
readonly config: MCPToolConfig;
|
|
93
|
+
private coherenceService;
|
|
94
|
+
/**
|
|
95
|
+
* Get or create the CoherenceService instance
|
|
96
|
+
*/
|
|
97
|
+
private getService;
|
|
98
|
+
/**
|
|
99
|
+
* Reset instance cache (called when fleet is disposed)
|
|
100
|
+
*/
|
|
101
|
+
resetInstanceCache(): void;
|
|
102
|
+
/**
|
|
103
|
+
* Execute collapse prediction
|
|
104
|
+
*/
|
|
105
|
+
execute(params: CoherenceCollapseParams, context: MCPToolContext): Promise<ToolResult<CoherenceCollapseResult>>;
|
|
106
|
+
/**
|
|
107
|
+
* Categorize risk level
|
|
108
|
+
*/
|
|
109
|
+
private categorizeRisk;
|
|
110
|
+
/**
|
|
111
|
+
* Generate additional recommendations based on context
|
|
112
|
+
*/
|
|
113
|
+
private generateAdditionalRecommendations;
|
|
114
|
+
/**
|
|
115
|
+
* Heuristic analysis fallback when WASM is unavailable
|
|
116
|
+
*/
|
|
117
|
+
private heuristicAnalysis;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Create a CoherenceCollapseTool instance
|
|
121
|
+
*/
|
|
122
|
+
export declare function createCoherenceCollapseTool(): CoherenceCollapseTool;
|
|
123
|
+
//# sourceMappingURL=collapse.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collapse.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/coherence/collapse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgB5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,UAAU,EAAE;QACV,+BAA+B;QAC/B,MAAM,EAAE,KAAK,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;QACH,yBAAyB;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,mCAAmC;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,iCAAiC;QACjC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,qBAAsB,SAAQ,WAAW,CACpD,uBAAuB,EACvB,uBAAuB,CACxB;IACC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAS5B;IAEF,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;OAEG;YACW,UAAU;IAOxB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IA0G/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,iCAAiC;IA6CzC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA4D1B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE"}
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agentic QE v3 - Coherence Predict Collapse MCP Tool
|
|
3
|
+
* ADR-052: Phase 4 Action A4.1
|
|
4
|
+
*
|
|
5
|
+
* qe/coherence/collapse - Predict swarm collapse risk
|
|
6
|
+
*
|
|
7
|
+
* Uses the CoherenceService's spectral analysis to predict potential
|
|
8
|
+
* swarm collapse before it happens, enabling proactive mitigation.
|
|
9
|
+
*/
|
|
10
|
+
import { MCPToolBase, } from '../base.js';
|
|
11
|
+
import { createCoherenceService, wasmLoader, } from '../../../integrations/coherence/index.js';
|
|
12
|
+
// ============================================================================
|
|
13
|
+
// Schema
|
|
14
|
+
// ============================================================================
|
|
15
|
+
const COHERENCE_COLLAPSE_SCHEMA = {
|
|
16
|
+
type: 'object',
|
|
17
|
+
properties: {
|
|
18
|
+
swarmState: {
|
|
19
|
+
type: 'object',
|
|
20
|
+
description: 'Current state of the swarm including agents and task info',
|
|
21
|
+
},
|
|
22
|
+
riskThreshold: {
|
|
23
|
+
type: 'number',
|
|
24
|
+
description: 'Risk threshold for warning (0-1, default: 0.5)',
|
|
25
|
+
default: 0.5,
|
|
26
|
+
minimum: 0,
|
|
27
|
+
maximum: 1,
|
|
28
|
+
},
|
|
29
|
+
},
|
|
30
|
+
required: ['swarmState'],
|
|
31
|
+
};
|
|
32
|
+
// ============================================================================
|
|
33
|
+
// Tool Implementation
|
|
34
|
+
// ============================================================================
|
|
35
|
+
/**
|
|
36
|
+
* Coherence Predict Collapse Tool
|
|
37
|
+
*
|
|
38
|
+
* Uses Prime Radiant's spectral analysis to predict swarm collapse risk
|
|
39
|
+
* before it happens, enabling proactive mitigation.
|
|
40
|
+
*
|
|
41
|
+
* @example
|
|
42
|
+
* ```typescript
|
|
43
|
+
* const result = await tool.invoke({
|
|
44
|
+
* swarmState: {
|
|
45
|
+
* agents: [
|
|
46
|
+
* { agentId: 'agent-1', health: 0.9, errorCount: 2 },
|
|
47
|
+
* { agentId: 'agent-2', health: 0.7, errorCount: 5 },
|
|
48
|
+
* ],
|
|
49
|
+
* activeTasks: 10,
|
|
50
|
+
* pendingTasks: 3,
|
|
51
|
+
* errorRate: 0.05,
|
|
52
|
+
* utilization: 0.6,
|
|
53
|
+
* },
|
|
54
|
+
* riskThreshold: 0.6,
|
|
55
|
+
* });
|
|
56
|
+
*
|
|
57
|
+
* if (result.data.isAtRisk) {
|
|
58
|
+
* console.log('Collapse risk detected:', result.data.riskLevel);
|
|
59
|
+
* console.log('Recommendations:', result.data.recommendations);
|
|
60
|
+
* }
|
|
61
|
+
* ```
|
|
62
|
+
*/
|
|
63
|
+
export class CoherenceCollapseTool extends MCPToolBase {
|
|
64
|
+
config = {
|
|
65
|
+
name: 'qe/coherence/collapse',
|
|
66
|
+
description: 'Predict swarm collapse risk using spectral analysis. ' +
|
|
67
|
+
'Identifies vulnerable vertices and provides mitigation recommendations.',
|
|
68
|
+
domain: 'learning-optimization',
|
|
69
|
+
schema: COHERENCE_COLLAPSE_SCHEMA,
|
|
70
|
+
streaming: false,
|
|
71
|
+
timeout: 30000,
|
|
72
|
+
};
|
|
73
|
+
coherenceService = null;
|
|
74
|
+
/**
|
|
75
|
+
* Get or create the CoherenceService instance
|
|
76
|
+
*/
|
|
77
|
+
async getService() {
|
|
78
|
+
if (!this.coherenceService) {
|
|
79
|
+
this.coherenceService = await createCoherenceService(wasmLoader);
|
|
80
|
+
}
|
|
81
|
+
return this.coherenceService;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Reset instance cache (called when fleet is disposed)
|
|
85
|
+
*/
|
|
86
|
+
resetInstanceCache() {
|
|
87
|
+
if (this.coherenceService) {
|
|
88
|
+
this.coherenceService.dispose();
|
|
89
|
+
this.coherenceService = null;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Execute collapse prediction
|
|
94
|
+
*/
|
|
95
|
+
async execute(params, context) {
|
|
96
|
+
const startTime = Date.now();
|
|
97
|
+
const { swarmState, riskThreshold = 0.5 } = params;
|
|
98
|
+
// Validate swarm state
|
|
99
|
+
if (!swarmState) {
|
|
100
|
+
return {
|
|
101
|
+
success: false,
|
|
102
|
+
error: 'swarmState is required',
|
|
103
|
+
};
|
|
104
|
+
}
|
|
105
|
+
if (!swarmState.agents || swarmState.agents.length < 1) {
|
|
106
|
+
return {
|
|
107
|
+
success: false,
|
|
108
|
+
error: 'At least one agent is required in swarmState',
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
try {
|
|
112
|
+
// Get service
|
|
113
|
+
const service = await this.getService();
|
|
114
|
+
// Convert to SwarmState format expected by the service
|
|
115
|
+
const state = {
|
|
116
|
+
agents: swarmState.agents.map((a) => ({
|
|
117
|
+
agentId: a.agentId,
|
|
118
|
+
agentType: (a.agentType || 'worker'),
|
|
119
|
+
health: a.health,
|
|
120
|
+
beliefs: [],
|
|
121
|
+
lastActivity: new Date(),
|
|
122
|
+
errorCount: a.errorCount ?? 0,
|
|
123
|
+
successRate: a.successRate ?? 1.0,
|
|
124
|
+
})),
|
|
125
|
+
activeTasks: swarmState.activeTasks,
|
|
126
|
+
pendingTasks: swarmState.pendingTasks,
|
|
127
|
+
errorRate: swarmState.errorRate,
|
|
128
|
+
utilization: swarmState.utilization,
|
|
129
|
+
timestamp: new Date(),
|
|
130
|
+
};
|
|
131
|
+
// Predict collapse using spectral analysis
|
|
132
|
+
const result = await service.predictCollapse(state);
|
|
133
|
+
// Determine risk level
|
|
134
|
+
const riskLevel = this.categorizeRisk(result.risk);
|
|
135
|
+
// Generate enhanced recommendations
|
|
136
|
+
const recommendations = [
|
|
137
|
+
...result.recommendations,
|
|
138
|
+
...this.generateAdditionalRecommendations(result, swarmState),
|
|
139
|
+
];
|
|
140
|
+
const executionTimeMs = Date.now() - startTime;
|
|
141
|
+
this.markAsRealData();
|
|
142
|
+
return {
|
|
143
|
+
success: true,
|
|
144
|
+
data: {
|
|
145
|
+
risk: result.risk,
|
|
146
|
+
isAtRisk: result.risk >= riskThreshold,
|
|
147
|
+
riskLevel,
|
|
148
|
+
fiedlerValue: result.fiedlerValue,
|
|
149
|
+
collapseImminent: result.collapseImminent,
|
|
150
|
+
weakVertices: result.weakVertices,
|
|
151
|
+
recommendations,
|
|
152
|
+
executionTimeMs,
|
|
153
|
+
usedFallback: result.usedFallback,
|
|
154
|
+
},
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
catch (error) {
|
|
158
|
+
// Check if WASM is unavailable - provide heuristic fallback
|
|
159
|
+
if (error instanceof Error &&
|
|
160
|
+
error.message.includes('WASM')) {
|
|
161
|
+
const fallbackResult = this.heuristicAnalysis(swarmState, riskThreshold);
|
|
162
|
+
this.markAsDemoData(context, 'WASM module unavailable');
|
|
163
|
+
return {
|
|
164
|
+
success: true,
|
|
165
|
+
data: {
|
|
166
|
+
...fallbackResult,
|
|
167
|
+
recommendations: [
|
|
168
|
+
'Running in fallback mode (heuristic analysis)',
|
|
169
|
+
'Install prime-radiant-advanced-wasm for spectral collapse prediction',
|
|
170
|
+
...fallbackResult.recommendations,
|
|
171
|
+
],
|
|
172
|
+
usedFallback: true,
|
|
173
|
+
executionTimeMs: Date.now() - startTime,
|
|
174
|
+
},
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
return {
|
|
178
|
+
success: false,
|
|
179
|
+
error: error instanceof Error ? error.message : String(error),
|
|
180
|
+
};
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Categorize risk level
|
|
185
|
+
*/
|
|
186
|
+
categorizeRisk(risk) {
|
|
187
|
+
if (risk < 0.25)
|
|
188
|
+
return 'low';
|
|
189
|
+
if (risk < 0.5)
|
|
190
|
+
return 'medium';
|
|
191
|
+
if (risk < 0.75)
|
|
192
|
+
return 'high';
|
|
193
|
+
return 'critical';
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Generate additional recommendations based on context
|
|
197
|
+
*/
|
|
198
|
+
generateAdditionalRecommendations(result, state) {
|
|
199
|
+
const recommendations = [];
|
|
200
|
+
// High error rate
|
|
201
|
+
if (state.errorRate > 0.1) {
|
|
202
|
+
recommendations.push(`High system error rate (${(state.errorRate * 100).toFixed(1)}%) - investigate root causes`);
|
|
203
|
+
}
|
|
204
|
+
// High utilization
|
|
205
|
+
if (state.utilization > 0.85) {
|
|
206
|
+
recommendations.push(`High resource utilization (${(state.utilization * 100).toFixed(1)}%) - consider scaling`);
|
|
207
|
+
}
|
|
208
|
+
// Task backlog
|
|
209
|
+
if (state.pendingTasks > state.activeTasks * 2) {
|
|
210
|
+
recommendations.push(`Large task backlog (${state.pendingTasks} pending) - may need more agents`);
|
|
211
|
+
}
|
|
212
|
+
// Unhealthy agents
|
|
213
|
+
const unhealthyAgents = state.agents.filter((a) => a.health < 0.5);
|
|
214
|
+
if (unhealthyAgents.length > 0) {
|
|
215
|
+
recommendations.push(`${unhealthyAgents.length} agent(s) with low health - consider replacement`);
|
|
216
|
+
}
|
|
217
|
+
// Critical risk
|
|
218
|
+
if (result.risk >= 0.75) {
|
|
219
|
+
recommendations.unshift('⚠️ CRITICAL: Immediate action required to prevent collapse');
|
|
220
|
+
}
|
|
221
|
+
return recommendations;
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Heuristic analysis fallback when WASM is unavailable
|
|
225
|
+
*/
|
|
226
|
+
heuristicAnalysis(state, riskThreshold) {
|
|
227
|
+
let risk = 0;
|
|
228
|
+
const recommendations = [];
|
|
229
|
+
const weakVertices = [];
|
|
230
|
+
// Factor: Average agent health
|
|
231
|
+
const avgHealth = state.agents.reduce((sum, a) => sum + a.health, 0) / state.agents.length;
|
|
232
|
+
risk += (1 - avgHealth) * 0.3;
|
|
233
|
+
// Factor: Error rate
|
|
234
|
+
risk += Math.min(0.25, state.errorRate * 2.5);
|
|
235
|
+
// Factor: Utilization
|
|
236
|
+
if (state.utilization > 0.7) {
|
|
237
|
+
risk += (state.utilization - 0.7) * 0.5;
|
|
238
|
+
}
|
|
239
|
+
// Factor: Task pressure
|
|
240
|
+
const taskPressure = state.pendingTasks / Math.max(1, state.activeTasks);
|
|
241
|
+
if (taskPressure > 1) {
|
|
242
|
+
risk += Math.min(0.2, (taskPressure - 1) * 0.1);
|
|
243
|
+
}
|
|
244
|
+
// Identify weak agents
|
|
245
|
+
for (const agent of state.agents) {
|
|
246
|
+
if (agent.health < 0.5 || (agent.errorCount ?? 0) > 5) {
|
|
247
|
+
weakVertices.push(agent.agentId);
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
risk = Math.min(1, risk);
|
|
251
|
+
// Generate recommendations
|
|
252
|
+
if (risk >= riskThreshold) {
|
|
253
|
+
recommendations.push('Consider reducing task load');
|
|
254
|
+
recommendations.push('Monitor agent health closely');
|
|
255
|
+
}
|
|
256
|
+
if (weakVertices.length > 0) {
|
|
257
|
+
recommendations.push(`Reinforce weak agents: ${weakVertices.join(', ')}`);
|
|
258
|
+
}
|
|
259
|
+
if (risk < 0.25) {
|
|
260
|
+
recommendations.push('Swarm appears stable - continue normal operations');
|
|
261
|
+
}
|
|
262
|
+
return {
|
|
263
|
+
risk,
|
|
264
|
+
isAtRisk: risk >= riskThreshold,
|
|
265
|
+
riskLevel: this.categorizeRisk(risk),
|
|
266
|
+
fiedlerValue: 0, // Can't compute without spectral analysis
|
|
267
|
+
collapseImminent: risk >= 0.75,
|
|
268
|
+
weakVertices,
|
|
269
|
+
recommendations,
|
|
270
|
+
};
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* Create a CoherenceCollapseTool instance
|
|
275
|
+
*/
|
|
276
|
+
export function createCoherenceCollapseTool() {
|
|
277
|
+
return new CoherenceCollapseTool();
|
|
278
|
+
}
|
|
279
|
+
//# sourceMappingURL=collapse.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collapse.js","sourceRoot":"","sources":["../../../../src/mcp/tools/coherence/collapse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,GAIZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,sBAAsB,EACtB,UAAU,GAKX,MAAM,0CAA0C,CAAC;AA4DlD,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,yBAAyB,GAAkB;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2DAA2D;SACzE;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;YAC7D,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;SACX;KACF;IACD,QAAQ,EAAE,CAAC,YAAY,CAAC;CACzB,CAAC;AAEF,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAG1C;IACU,MAAM,GAAkB;QAC/B,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,uDAAuD;YACvD,yEAAyE;QAC3E,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,yBAAyB;QACjC,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,KAAK;KACf,CAAC;IAEM,gBAAgB,GAA4B,IAAI,CAAC;IAEzD;;OAEG;IACK,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,MAAM,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,MAA+B,EAC/B,OAAuB;QAEvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;QAEnD,uBAAuB;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB;aAChC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,8CAA8C;aACtD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,cAAc;YACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAExC,uDAAuD;YACvD,MAAM,KAAK,GAAe;gBACxB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC;oBACjD,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAc;oBACjD,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,EAAc;oBACvB,YAAY,EAAE,IAAI,IAAI,EAAE;oBACxB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;oBAC7B,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,GAAG;iBAClC,CAAC,CAAC;gBACH,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC;YAEF,2CAA2C;YAC3C,MAAM,MAAM,GAAiB,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAElE,uBAAuB;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEnD,oCAAoC;YACpC,MAAM,eAAe,GAAG;gBACtB,GAAG,MAAM,CAAC,eAAe;gBACzB,GAAG,IAAI,CAAC,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC;aAC9D,CAAC;YAEF,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAE/C,IAAI,CAAC,cAAc,EAAE,CAAC;YAEtB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,aAAa;oBACtC,SAAS;oBACT,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;oBACzC,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,eAAe;oBACf,eAAe;oBACf,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4DAA4D;YAC5D,IACE,KAAK,YAAY,KAAK;gBACtB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC9B,CAAC;gBACD,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAC3C,UAAU,EACV,aAAa,CACd,CAAC;gBAEF,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;gBAExD,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,GAAG,cAAc;wBACjB,eAAe,EAAE;4BACf,+CAA+C;4BAC/C,sEAAsE;4BACtE,GAAG,cAAc,CAAC,eAAe;yBAClC;wBACD,YAAY,EAAE,IAAI;wBAClB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACxC;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAY;QACjC,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,IAAI,GAAG,GAAG;YAAE,OAAO,QAAQ,CAAC;QAChC,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,MAAM,CAAC;QAC/B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,iCAAiC,CACvC,MAAoB,EACpB,KAA4C;QAE5C,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,kBAAkB;QAClB,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YAC1B,eAAe,CAAC,IAAI,CAClB,2BAA2B,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAC5F,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,IAAI,KAAK,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;YAC7B,eAAe,CAAC,IAAI,CAClB,8BAA8B,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAC1F,CAAC;QACJ,CAAC;QAED,eAAe;QACf,IAAI,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YAC/C,eAAe,CAAC,IAAI,CAClB,uBAAuB,KAAK,CAAC,YAAY,kCAAkC,CAC5E,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACnE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,eAAe,CAAC,IAAI,CAClB,GAAG,eAAe,CAAC,MAAM,kDAAkD,CAC5E,CAAC;QACJ,CAAC;QAED,gBAAgB;QAChB,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,eAAe,CAAC,OAAO,CACrB,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,KAA4C,EAC5C,aAAqB;QAErB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,+BAA+B;QAC/B,MAAM,SAAS,GACb,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3E,IAAI,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;QAE9B,qBAAqB;QACrB,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAE9C,sBAAsB;QACtB,IAAI,KAAK,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,CAAC;QAED,wBAAwB;QACxB,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACzE,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,uBAAuB;QACvB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAEzB,2BAA2B;QAC3B,IAAI,IAAI,IAAI,aAAa,EAAE,CAAC;YAC1B,eAAe,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YACpD,eAAe,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,eAAe,CAAC,IAAI,CAAC,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,eAAe,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,IAAI,IAAI,aAAa;YAC/B,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;YACpC,YAAY,EAAE,CAAC,EAAE,0CAA0C;YAC3D,gBAAgB,EAAE,IAAI,IAAI,IAAI;YAC9B,YAAY;YACZ,eAAe;SAChB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,qBAAqB,EAAE,CAAC;AACrC,CAAC"}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agentic QE v3 - Coherence Verify Consensus MCP Tool
|
|
3
|
+
* ADR-052: Phase 4 Action A4.1
|
|
4
|
+
*
|
|
5
|
+
* qe/coherence/consensus - Verify multi-agent consensus mathematically
|
|
6
|
+
*
|
|
7
|
+
* Uses the CoherenceService's spectral analysis to detect false consensus
|
|
8
|
+
* (agents appearing to agree while actually having different beliefs).
|
|
9
|
+
*/
|
|
10
|
+
import { MCPToolBase, MCPToolConfig, MCPToolContext } from '../base.js';
|
|
11
|
+
import { ToolResult } from '../../types.js';
|
|
12
|
+
/**
|
|
13
|
+
* Parameters for consensus verification
|
|
14
|
+
*/
|
|
15
|
+
export interface CoherenceConsensusParams {
|
|
16
|
+
/** Array of agent votes to verify */
|
|
17
|
+
votes: Array<{
|
|
18
|
+
/** Agent identifier */
|
|
19
|
+
agentId: string;
|
|
20
|
+
/** Agent type */
|
|
21
|
+
agentType?: string;
|
|
22
|
+
/** The agent's verdict/decision (string, number, or boolean) */
|
|
23
|
+
verdict: string | number | boolean;
|
|
24
|
+
/** Confidence in the verdict (0-1) */
|
|
25
|
+
confidence: number;
|
|
26
|
+
/** Optional reasoning text */
|
|
27
|
+
reasoning?: string;
|
|
28
|
+
}>;
|
|
29
|
+
/** Minimum confidence threshold (0-1, default: 0.5) */
|
|
30
|
+
confidenceThreshold?: number;
|
|
31
|
+
/** Index signature for Record<string, unknown> compatibility */
|
|
32
|
+
[key: string]: unknown;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Result of consensus verification
|
|
36
|
+
*/
|
|
37
|
+
export interface CoherenceConsensusResult {
|
|
38
|
+
/** Whether consensus is mathematically valid */
|
|
39
|
+
isValid: boolean;
|
|
40
|
+
/** Whether this is a false consensus (appears unified but isn't) */
|
|
41
|
+
isFalseConsensus: boolean;
|
|
42
|
+
/** Confidence in the consensus */
|
|
43
|
+
confidence: number;
|
|
44
|
+
/** Fiedler value from spectral analysis (indicates connectivity) */
|
|
45
|
+
fiedlerValue: number;
|
|
46
|
+
/** Risk of consensus collapsing (0-1) */
|
|
47
|
+
collapseRisk: number;
|
|
48
|
+
/** Recommendation for next steps */
|
|
49
|
+
recommendation: string;
|
|
50
|
+
/** Whether fallback logic was used */
|
|
51
|
+
usedFallback: boolean;
|
|
52
|
+
/** Execution time in milliseconds */
|
|
53
|
+
executionTimeMs: number;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Coherence Verify Consensus Tool
|
|
57
|
+
*
|
|
58
|
+
* Uses Prime Radiant's spectral analysis to mathematically verify
|
|
59
|
+
* multi-agent consensus, detecting false consensus situations.
|
|
60
|
+
*
|
|
61
|
+
* @example
|
|
62
|
+
* ```typescript
|
|
63
|
+
* const result = await tool.invoke({
|
|
64
|
+
* votes: [
|
|
65
|
+
* { agentId: 'agent-1', verdict: 'pass', confidence: 0.9 },
|
|
66
|
+
* { agentId: 'agent-2', verdict: 'pass', confidence: 0.85 },
|
|
67
|
+
* { agentId: 'agent-3', verdict: 'fail', confidence: 0.6 },
|
|
68
|
+
* ],
|
|
69
|
+
* });
|
|
70
|
+
*
|
|
71
|
+
* if (result.data.isFalseConsensus) {
|
|
72
|
+
* console.log('False consensus detected - spawn independent reviewer');
|
|
73
|
+
* }
|
|
74
|
+
* ```
|
|
75
|
+
*/
|
|
76
|
+
export declare class CoherenceConsensusTool extends MCPToolBase<CoherenceConsensusParams, CoherenceConsensusResult> {
|
|
77
|
+
readonly config: MCPToolConfig;
|
|
78
|
+
private coherenceService;
|
|
79
|
+
/**
|
|
80
|
+
* Get or create the CoherenceService instance
|
|
81
|
+
*/
|
|
82
|
+
private getService;
|
|
83
|
+
/**
|
|
84
|
+
* Reset instance cache (called when fleet is disposed)
|
|
85
|
+
*/
|
|
86
|
+
resetInstanceCache(): void;
|
|
87
|
+
/**
|
|
88
|
+
* Execute consensus verification
|
|
89
|
+
*/
|
|
90
|
+
execute(params: CoherenceConsensusParams, context: MCPToolContext): Promise<ToolResult<CoherenceConsensusResult>>;
|
|
91
|
+
/**
|
|
92
|
+
* Simple majority analysis fallback
|
|
93
|
+
*/
|
|
94
|
+
private simpleMajorityAnalysis;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Create a CoherenceConsensusTool instance
|
|
98
|
+
*/
|
|
99
|
+
export declare function createCoherenceConsensusTool(): CoherenceConsensusTool;
|
|
100
|
+
//# sourceMappingURL=consensus.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consensus.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/coherence/consensus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAc5C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,KAAK,EAAE,KAAK,CAAC;QACX,uBAAuB;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gEAAgE;QAChE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QACnC,sCAAsC;QACtC,UAAU,EAAE,MAAM,CAAC;QACnB,8BAA8B;QAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB;AA4BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,sBAAuB,SAAQ,WAAW,CACrD,wBAAwB,EACxB,wBAAwB,CACzB;IACC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAS5B;IAEF,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;OAEG;YACW,UAAU;IAOxB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,wBAAwB,EAChC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;IAgGhD;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA+B/B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,sBAAsB,CAErE"}
|