@yyc3/ai-family-kernel 0.0.0-stage → 2.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (298) hide show
  1. package/README.md +11 -2
  2. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/index.d.ts +24 -0
  3. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/index.js +24 -0
  4. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-1-foundation/foundation-capability.d.ts +16 -0
  5. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-1-foundation/foundation-capability.js +29 -0
  6. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-1-foundation/index.d.ts +4 -0
  7. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-1-foundation/index.js +4 -0
  8. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-2-bole/bole-capability.d.ts +16 -0
  9. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-2-bole/bole-capability.js +29 -0
  10. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-2-bole/index.d.ts +4 -0
  11. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-2-bole/index.js +4 -0
  12. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-3-prophet/index.d.ts +4 -0
  13. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-3-prophet/index.js +4 -0
  14. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-3-prophet/prophet-capability.d.ts +16 -0
  15. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-3-prophet/prophet-capability.js +29 -0
  16. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-4-thinker/index.d.ts +4 -0
  17. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-4-thinker/index.js +4 -0
  18. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-4-thinker/thinker-capability.d.ts +16 -0
  19. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-4-thinker/thinker-capability.js +29 -0
  20. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-5-navigator/index.d.ts +4 -0
  21. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-5-navigator/index.js +4 -0
  22. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-5-navigator/navigator-capability.d.ts +16 -0
  23. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-5-navigator/navigator-capability.js +29 -0
  24. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-6-creative/creative-capability.d.ts +16 -0
  25. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-6-creative/creative-capability.js +29 -0
  26. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-6-creative/index.d.ts +4 -0
  27. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-6-creative/index.js +4 -0
  28. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-7-master/index.d.ts +4 -0
  29. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-7-master/index.js +4 -0
  30. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-7-master/master-capability.d.ts +16 -0
  31. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-7-master/master-capability.js +29 -0
  32. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-8-guardian/guardian-capability.d.ts +16 -0
  33. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-8-guardian/guardian-capability.js +29 -0
  34. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-8-guardian/index.d.ts +4 -0
  35. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-8-guardian/index.js +4 -0
  36. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-9-meta-oracle/index.d.ts +4 -0
  37. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-9-meta-oracle/index.js +4 -0
  38. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-9-meta-oracle/meta-oracle-capability.d.ts +17 -0
  39. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-9-meta-oracle/meta-oracle-capability.js +30 -0
  40. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-registry.d.ts +34 -0
  41. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/layer-registry.js +76 -0
  42. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/types.d.ts +49 -0
  43. package/dist/src/01-/344/271/235/345/261/202/346/236/266/346/236/204/345/210/206/345/261/202/345/272/225/345/272/247/types.js +33 -0
  44. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/index.d.ts +7 -0
  45. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/index.js +7 -0
  46. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/orchestrator.d.ts +47 -0
  47. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/orchestrator.js +59 -0
  48. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/task-decomposer.d.ts +21 -0
  49. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/task-decomposer.js +72 -0
  50. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/confidence-calibrator.d.ts +31 -0
  51. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/confidence-calibrator.js +39 -0
  52. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/consistency-metrics.d.ts +45 -0
  53. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/consistency-metrics.js +44 -0
  54. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/cross-validator.d.ts +44 -0
  55. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/cross-validator.js +69 -0
  56. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/gateway.d.ts +64 -0
  57. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/gateway.js +96 -0
  58. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/ground-truth-checker.d.ts +33 -0
  59. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/ground-truth-checker.js +74 -0
  60. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/index.d.ts +12 -0
  61. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/index.js +12 -0
  62. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/oracle-registry.d.ts +18 -0
  63. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/cloud-pivot-orchestrator/verification-gateway/oracle-registry.js +26 -0
  64. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/dashu-self-healing/index.d.ts +5 -0
  65. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/dashu-self-healing/index.js +5 -0
  66. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/dashu-self-healing/self-healing-controller.d.ts +33 -0
  67. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/dashu-self-healing/self-healing-controller.js +68 -0
  68. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-communication-bus/event-bus.d.ts +99 -0
  69. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-communication-bus/event-bus.js +178 -0
  70. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-communication-bus/index.d.ts +7 -0
  71. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-communication-bus/index.js +7 -0
  72. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-communication-bus/trajectory-bridge.d.ts +57 -0
  73. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-communication-bus/trajectory-bridge.js +72 -0
  74. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-phone-system/index.d.ts +4 -0
  75. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-phone-system/index.js +4 -0
  76. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-phone-system/phone-system.d.ts +46 -0
  77. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/family-phone-system/phone-system.js +85 -0
  78. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/global-status-center/index.d.ts +4 -0
  79. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/global-status-center/index.js +4 -0
  80. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/global-status-center/status-center.d.ts +27 -0
  81. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/global-status-center/status-center.js +57 -0
  82. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/index.d.ts +21 -0
  83. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/index.js +21 -0
  84. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/bus-mcp-codec.d.ts +29 -0
  85. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/bus-mcp-codec.js +84 -0
  86. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/index.d.ts +31 -0
  87. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/index.js +28 -0
  88. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/server/index.d.ts +5 -0
  89. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/server/index.js +5 -0
  90. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/server/protocol.d.ts +80 -0
  91. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/server/protocol.js +148 -0
  92. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/stdio-transport.d.ts +47 -0
  93. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/stdio-transport.js +178 -0
  94. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/types.d.ts +63 -0
  95. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/mcp-adapter/types.js +7 -0
  96. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/types.d.ts +167 -0
  97. package/dist/src/02-/344/272/221/346/236/242/346/240/270/345/277/203/345/274/225/346/223/216/types.js +23 -0
  98. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/index.d.ts +7 -0
  99. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/index.js +7 -0
  100. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/outcome-labeler.d.ts +34 -0
  101. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/outcome-labeler.js +38 -0
  102. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/pattern-extractor.d.ts +64 -0
  103. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/pattern-extractor.js +94 -0
  104. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/trajectory-collector.d.ts +39 -0
  105. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/experience-reflow/trajectory-collector.js +36 -0
  106. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/index.d.ts +23 -0
  107. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/index.js +23 -0
  108. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/index.d.ts +7 -0
  109. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/index.js +7 -0
  110. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/preference-tracker.d.ts +32 -0
  111. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/preference-tracker.js +49 -0
  112. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/rule-evolution.d.ts +41 -0
  113. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/rule-evolution.js +60 -0
  114. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/semantic-diff.d.ts +32 -0
  115. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/knowledge-update/semantic-diff.js +69 -0
  116. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-loop.d.ts +146 -0
  117. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-loop.js +171 -0
  118. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-scheduler/budget-allocator.d.ts +29 -0
  119. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-scheduler/budget-allocator.js +58 -0
  120. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-scheduler/index.d.ts +6 -0
  121. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-scheduler/index.js +6 -0
  122. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-scheduler/priority-queue.d.ts +22 -0
  123. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/learning-scheduler/priority-queue.js +34 -0
  124. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/param-adaptation.d.ts +59 -0
  125. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/param-adaptation.js +55 -0
  126. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/index.d.ts +12 -0
  127. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/index.js +12 -0
  128. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-eval.d.ts +77 -0
  129. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-eval.js +110 -0
  130. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-executor.d.ts +51 -0
  131. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-executor.js +63 -0
  132. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-id.d.ts +32 -0
  133. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-id.js +54 -0
  134. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-index.d.ts +29 -0
  135. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-index.js +32 -0
  136. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-merger.d.ts +26 -0
  137. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-merger.js +65 -0
  138. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-pruner.d.ts +31 -0
  139. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-pruner.js +35 -0
  140. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-store-file.d.ts +33 -0
  141. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-store-file.js +76 -0
  142. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-versioner.d.ts +33 -0
  143. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/skill-consolidation/skill-versioner.js +63 -0
  144. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/forgetting-detector.d.ts +31 -0
  145. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/forgetting-detector.js +26 -0
  146. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/index.d.ts +7 -0
  147. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/index.js +7 -0
  148. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/regression-tester.d.ts +30 -0
  149. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/regression-tester.js +48 -0
  150. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/rollback-controller.d.ts +19 -0
  151. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/stability-guard/rollback-controller.js +19 -0
  152. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/types.d.ts +137 -0
  153. package/dist/src/05-/346/214/201/347/273/255/345/255/246/344/271/240/345/274/225/346/223/216/types.js +22 -0
  154. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/compliance-audit/compliance-audit.d.ts +20 -0
  155. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/compliance-audit/compliance-audit.js +83 -0
  156. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/compliance-audit/index.d.ts +4 -0
  157. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/compliance-audit/index.js +4 -0
  158. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/index.d.ts +18 -0
  159. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/index.js +18 -0
  160. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/index.d.ts +6 -0
  161. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/index.js +6 -0
  162. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/policy-bus.d.ts +39 -0
  163. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/policy-bus.js +73 -0
  164. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/policy-registry.d.ts +19 -0
  165. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/policy-registry.js +44 -0
  166. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/security-policies.d.ts +54 -0
  167. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/policy-registry/security-policies.js +80 -0
  168. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/quality-governance/index.d.ts +4 -0
  169. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/quality-governance/index.js +4 -0
  170. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/quality-governance/quality-governance.d.ts +23 -0
  171. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/quality-governance/quality-governance.js +38 -0
  172. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/security-governance/index.d.ts +4 -0
  173. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/security-governance/index.js +4 -0
  174. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/security-governance/security-governance.d.ts +24 -0
  175. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/security-governance/security-governance.js +29 -0
  176. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/types.d.ts +77 -0
  177. package/dist/src/06-/346/262/273/347/220/206/344/270/255/345/277/203/types.js +17 -0
  178. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/consistency-repair/consistency-repair.d.ts +25 -0
  179. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/consistency-repair/consistency-repair.js +66 -0
  180. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/consistency-repair/index.d.ts +4 -0
  181. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/consistency-repair/index.js +4 -0
  182. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/degradation-controller/degradation-controller.d.ts +50 -0
  183. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/degradation-controller/degradation-controller.js +90 -0
  184. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/degradation-controller/index.d.ts +4 -0
  185. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/degradation-controller/index.js +4 -0
  186. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/fault-detector/fault-detector.d.ts +42 -0
  187. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/fault-detector/fault-detector.js +55 -0
  188. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/fault-detector/index.d.ts +4 -0
  189. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/fault-detector/index.js +4 -0
  190. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/index.d.ts +19 -0
  191. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/index.js +19 -0
  192. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/rollback-controller/index.d.ts +4 -0
  193. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/rollback-controller/index.js +4 -0
  194. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/rollback-controller/rollback-controller.d.ts +36 -0
  195. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/rollback-controller/rollback-controller.js +71 -0
  196. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/types.d.ts +73 -0
  197. package/dist/src/07-/350/207/252/346/204/210/344/270/255/345/277/203/types.js +63 -0
  198. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/index.d.ts +5 -0
  199. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/index.js +5 -0
  200. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/mcp-server-assembly.d.ts +48 -0
  201. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/mcp-server-assembly.js +53 -0
  202. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/runtime-assembly.d.ts +175 -0
  203. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/runtime-assembly.js +249 -0
  204. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/runtime-entry.d.ts +68 -0
  205. package/dist/src/08-/347/263/273/347/273/237/350/243/205/351/205/215/runtime-entry.js +86 -0
  206. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/capability-instrumentation.d.ts +53 -0
  207. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/capability-instrumentation.js +85 -0
  208. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/collaboration-instrumentation.d.ts +56 -0
  209. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/collaboration-instrumentation.js +100 -0
  210. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/family-metrics.d.ts +172 -0
  211. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/family-metrics.js +314 -0
  212. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/index.d.ts +8 -0
  213. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/index.js +8 -0
  214. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/metrics-registry.d.ts +123 -0
  215. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/metrics-registry.js +270 -0
  216. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/metrics-server.d.ts +45 -0
  217. package/dist/src/09-/345/217/257/350/247/202/346/265/213/346/200/247/metrics-server.js +86 -0
  218. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/allowlist.d.ts +79 -0
  219. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/allowlist.js +122 -0
  220. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/catalog.d.ts +67 -0
  221. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/catalog.js +71 -0
  222. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/index.d.ts +14 -0
  223. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/index.js +10 -0
  224. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/integrity.d.ts +44 -0
  225. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/integrity.js +99 -0
  226. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/plugin-loader.d.ts +39 -0
  227. package/dist/src/10-/350/203/275/345/212/233/346/263/250/345/206/214/344/270/255/345/277/203/plugin-loader.js +89 -0
  228. package/dist/src/a2a-adapter/card-discovery.d.ts +40 -0
  229. package/dist/src/a2a-adapter/card-discovery.js +47 -0
  230. package/dist/src/a2a-adapter/index.d.ts +7 -0
  231. package/dist/src/a2a-adapter/index.js +7 -0
  232. package/dist/src/a2a-adapter/task-delegate.d.ts +85 -0
  233. package/dist/src/a2a-adapter/task-delegate.js +94 -0
  234. package/dist/src/index.d.ts +10 -0
  235. package/dist/src/index.js +10 -0
  236. package/dist/vendor/memory-framework/episodic-store/episode-indexer.d.ts +30 -0
  237. package/dist/vendor/memory-framework/episodic-store/episode-indexer.js +45 -0
  238. package/dist/vendor/memory-framework/episodic-store/index.d.ts +30 -0
  239. package/dist/vendor/memory-framework/episodic-store/index.js +45 -0
  240. package/dist/vendor/memory-framework/episodic-store/retrieval-adapter.d.ts +20 -0
  241. package/dist/vendor/memory-framework/episodic-store/retrieval-adapter.js +29 -0
  242. package/dist/vendor/memory-framework/episodic-store/trajectory-logger.d.ts +36 -0
  243. package/dist/vendor/memory-framework/episodic-store/trajectory-logger.js +32 -0
  244. package/dist/vendor/memory-framework/index.d.ts +19 -0
  245. package/dist/vendor/memory-framework/index.js +19 -0
  246. package/dist/vendor/memory-framework/memory-orchestrator/consistency-checker.d.ts +20 -0
  247. package/dist/vendor/memory-framework/memory-orchestrator/consistency-checker.js +41 -0
  248. package/dist/vendor/memory-framework/memory-orchestrator/index.d.ts +55 -0
  249. package/dist/vendor/memory-framework/memory-orchestrator/index.js +185 -0
  250. package/dist/vendor/memory-framework/memory-orchestrator/retrieval-router.d.ts +21 -0
  251. package/dist/vendor/memory-framework/memory-orchestrator/retrieval-router.js +37 -0
  252. package/dist/vendor/memory-framework/procedural-memory/guardrail-registry.d.ts +34 -0
  253. package/dist/vendor/memory-framework/procedural-memory/guardrail-registry.js +22 -0
  254. package/dist/vendor/memory-framework/procedural-memory/index.d.ts +31 -0
  255. package/dist/vendor/memory-framework/procedural-memory/index.js +34 -0
  256. package/dist/vendor/memory-framework/procedural-memory/prompt-rule-extractor.d.ts +95 -0
  257. package/dist/vendor/memory-framework/procedural-memory/prompt-rule-extractor.js +160 -0
  258. package/dist/vendor/memory-framework/procedural-memory/skill-registry.d.ts +115 -0
  259. package/dist/vendor/memory-framework/procedural-memory/skill-registry.js +165 -0
  260. package/dist/vendor/memory-framework/procedural-memory/workflow-patterns.d.ts +36 -0
  261. package/dist/vendor/memory-framework/procedural-memory/workflow-patterns.js +22 -0
  262. package/dist/vendor/memory-framework/semantic-graph/entity-resolver.d.ts +26 -0
  263. package/dist/vendor/memory-framework/semantic-graph/entity-resolver.js +61 -0
  264. package/dist/vendor/memory-framework/semantic-graph/index.d.ts +23 -0
  265. package/dist/vendor/memory-framework/semantic-graph/index.js +25 -0
  266. package/dist/vendor/memory-framework/semantic-graph/knowledge-graph.d.ts +50 -0
  267. package/dist/vendor/memory-framework/semantic-graph/knowledge-graph.js +44 -0
  268. package/dist/vendor/memory-framework/sensory-buffer/index.d.ts +41 -0
  269. package/dist/vendor/memory-framework/sensory-buffer/index.js +70 -0
  270. package/dist/vendor/memory-framework/types.d.ts +192 -0
  271. package/dist/vendor/memory-framework/types.js +42 -0
  272. package/dist/vendor/memory-framework/working-context/attention-scorer.d.ts +39 -0
  273. package/dist/vendor/memory-framework/working-context/attention-scorer.js +45 -0
  274. package/dist/vendor/memory-framework/working-context/context-window.d.ts +33 -0
  275. package/dist/vendor/memory-framework/working-context/context-window.js +35 -0
  276. package/dist/vendor/memory-framework/working-context/index.d.ts +30 -0
  277. package/dist/vendor/memory-framework/working-context/index.js +44 -0
  278. package/dist/vendor/memory-framework/write-policy/consolidation.d.ts +37 -0
  279. package/dist/vendor/memory-framework/write-policy/consolidation.js +50 -0
  280. package/dist/vendor/memory-framework/write-policy/forgetting-policy.d.ts +28 -0
  281. package/dist/vendor/memory-framework/write-policy/forgetting-policy.js +31 -0
  282. package/dist/vendor/memory-framework/write-policy/index.d.ts +40 -0
  283. package/dist/vendor/memory-framework/write-policy/index.js +50 -0
  284. package/dist/vendor/memory-framework/write-policy/salience-scorer.d.ts +41 -0
  285. package/dist/vendor/memory-framework/write-policy/salience-scorer.js +70 -0
  286. package/dist/vendor/self-judge-kit/assumption-tracker.d.ts +31 -0
  287. package/dist/vendor/self-judge-kit/assumption-tracker.js +45 -0
  288. package/dist/vendor/self-judge-kit/confidence-scorer.d.ts +46 -0
  289. package/dist/vendor/self-judge-kit/confidence-scorer.js +60 -0
  290. package/dist/vendor/self-judge-kit/deviation-detector.d.ts +23 -0
  291. package/dist/vendor/self-judge-kit/deviation-detector.js +55 -0
  292. package/dist/vendor/self-judge-kit/escalation-policy.d.ts +17 -0
  293. package/dist/vendor/self-judge-kit/escalation-policy.js +45 -0
  294. package/dist/vendor/self-judge-kit/index.d.ts +46 -0
  295. package/dist/vendor/self-judge-kit/index.js +79 -0
  296. package/dist/vendor/self-judge-kit/types.d.ts +87 -0
  297. package/dist/vendor/self-judge-kit/types.js +18 -0
  298. package/package.json +41 -4
@@ -0,0 +1,69 @@
1
+ /**
2
+ * cross-validator(跨家人交叉验证)——verification-gateway 子模块。
3
+ * 职责:请独立家人(如语枢·万物)复核,按共识率聚合为交叉验证意见。
4
+ * 边界:只产出交叉验证意见(供 escalation 路径 cross-validate);
5
+ * 最终裁决归天枢 / 人类确认。
6
+ *
7
+ * v2.3.0(Phase B 最小闭环):支持注册可插拔复核人——
8
+ * `(signal, request) => ReviewerOpinion`;无复核人时 **fail-safe 不默认成功**。
9
+ * TODO(infra): 复核人函数替换为经 family-communication-bus 的异步独立复核。
10
+ */
11
+ /** 跨家人交叉验证器。 */
12
+ export class CrossValidator {
13
+ reviewers = new Map();
14
+ /** 注册复核人(同 id 重复注册以最后为准)。 */
15
+ registerReviewer(id, reviewer) {
16
+ this.reviewers.set(id, reviewer);
17
+ }
18
+ /** 已注册复核人 id 清单。 */
19
+ reviewerIds() {
20
+ return [...this.reviewers.keys()];
21
+ }
22
+ /**
23
+ * 请独立家人复核,按多数共识聚合:
24
+ * - 共识率 ≥ 0.5 且至少 1 票同意 → verified=true;
25
+ * - 多数反对 → verified=false(vConf=多数派平均置信度);
26
+ * - 无复核人 → verified=false(fail-safe,不默认成功)。
27
+ */
28
+ async crossValidate(input) {
29
+ if (this.reviewers.size === 0) {
30
+ return {
31
+ traceId: input.request.traceId,
32
+ verified: false,
33
+ sources: [],
34
+ confidence: 0.3,
35
+ detail: '无可用复核人(fail-safe:不默认成功)',
36
+ };
37
+ }
38
+ const opinions = [];
39
+ for (const [id, reviewer] of this.reviewers) {
40
+ opinions.push({ id, opinion: reviewer(input.signal, input.request) });
41
+ }
42
+ const agree = opinions.filter((o) => o.opinion.agrees);
43
+ const consensus = agree.length / opinions.length;
44
+ if (agree.length > 0 && consensus >= 0.5) {
45
+ const conf = avg(agree.map((o) => o.opinion.confidence));
46
+ return {
47
+ traceId: input.request.traceId,
48
+ verified: true,
49
+ sources: agree.map((o) => o.id),
50
+ confidence: round2(conf),
51
+ detail: `交叉验证共识 ${(consensus * 100).toFixed(0)}%(${agree.length}/${opinions.length} 同意)`,
52
+ };
53
+ }
54
+ const against = opinions.filter((o) => !o.opinion.agrees);
55
+ return {
56
+ traceId: input.request.traceId,
57
+ verified: false,
58
+ sources: against.map((o) => o.id),
59
+ confidence: round2(avg(against.map((o) => o.opinion.confidence))),
60
+ detail: `交叉验证多数反对(同意率 ${(consensus * 100).toFixed(0)}%)`,
61
+ };
62
+ }
63
+ }
64
+ function avg(xs) {
65
+ return xs.length === 0 ? 0 : xs.reduce((a, b) => a + b, 0) / xs.length;
66
+ }
67
+ function round2(x) {
68
+ return Math.round(x * 100) / 100;
69
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ * verification-gateway(自评-外验闭环门面)——Phase B 最小闭环。
3
+ * 流程(§5.2 / §5.6):
4
+ * self-judge 信号 → ground-truth-checker 真值比对
5
+ * →(自评升级或真值未证实时)cross-validator 交叉验证
6
+ * → 合成有效裁定 → confidence-calibrator 校准
7
+ * → ConsistencyTracker 记录一致率/校准误差/海市蜃楼。
8
+ *
9
+ * ⚠️ 红线:外验未证实 → finalEscalation 强制 human-confirm,
10
+ * 绝不允许低置信自评(或自评过高被驳)直接流往下游。
11
+ */
12
+ import type { JudgmentSignal } from '../../../../vendor/self-judge-kit/index.js';
13
+ import type { VerificationRequest, VerificationResult } from '../../types.js';
14
+ import { ConfidenceCalibrator, type CalibrationResult } from './confidence-calibrator.js';
15
+ import { ConsistencyTracker } from './consistency-metrics.js';
16
+ import { CrossValidator } from './cross-validator.js';
17
+ import { GroundTruthChecker } from './ground-truth-checker.js';
18
+ /** 一次闭环裁定的完整记录(可审计)。 */
19
+ export interface AdjudicationRecord {
20
+ readonly traceId: string;
21
+ readonly agent: string;
22
+ /** 原始自评信号。 */
23
+ readonly self: JudgmentSignal;
24
+ /** 真值校验结果。 */
25
+ readonly groundTruth: VerificationResult;
26
+ /** 交叉验证结果(未触发则 undefined)。 */
27
+ readonly cross?: VerificationResult;
28
+ /** 合成后的有效裁定(真值 ∧ 交叉)。 */
29
+ readonly effective: VerificationResult;
30
+ /** 校准结果。 */
31
+ readonly calibration: CalibrationResult;
32
+ /** 最终置信度 = 校准后置信度。 */
33
+ readonly finalConfidence: number;
34
+ /** 最终升级决策。 */
35
+ readonly finalEscalation: 'none' | 'cross-validate' | 'human-confirm';
36
+ /** 海市蜃楼嫌疑:自评未升级却被真值驳斥。 */
37
+ readonly mirageSuspected: boolean;
38
+ }
39
+ /** 闭环门面构造依赖(均可注入替换,缺省自建)。 */
40
+ export interface VerificationGatewayOptions {
41
+ readonly groundTruth?: GroundTruthChecker;
42
+ readonly crossValidator?: CrossValidator;
43
+ readonly calibrator?: ConfidenceCalibrator;
44
+ readonly tracker?: ConsistencyTracker;
45
+ }
46
+ /** 自评-外验闭环网关。 */
47
+ export declare class VerificationGateway {
48
+ private readonly groundTruth;
49
+ private readonly crossValidator;
50
+ private readonly calibrator;
51
+ private readonly tracker;
52
+ constructor(options?: VerificationGatewayOptions);
53
+ /** 暴露指标追踪器(供观测平台拉取快照)。 */
54
+ get metrics(): ConsistencyTracker;
55
+ /** 暴露子组件(供部署侧注册探针/复核人)。 */
56
+ get oracles(): GroundTruthChecker;
57
+ get reviewers(): CrossValidator;
58
+ /**
59
+ * 裁定一次自评信号(Phase B 闭环主入口)。
60
+ * @param signal 自评信号(由各位家人 self-judge 模块产出)
61
+ * @param request 待校验主张(如 "intent:analysis"、"quality:passed")
62
+ */
63
+ adjudicate(signal: JudgmentSignal, request: VerificationRequest): Promise<AdjudicationRecord>;
64
+ }
@@ -0,0 +1,96 @@
1
+ /**
2
+ * verification-gateway(自评-外验闭环门面)——Phase B 最小闭环。
3
+ * 流程(§5.2 / §5.6):
4
+ * self-judge 信号 → ground-truth-checker 真值比对
5
+ * →(自评升级或真值未证实时)cross-validator 交叉验证
6
+ * → 合成有效裁定 → confidence-calibrator 校准
7
+ * → ConsistencyTracker 记录一致率/校准误差/海市蜃楼。
8
+ *
9
+ * ⚠️ 红线:外验未证实 → finalEscalation 强制 human-confirm,
10
+ * 绝不允许低置信自评(或自评过高被驳)直接流往下游。
11
+ */
12
+ import { ConfidenceCalibrator } from './confidence-calibrator.js';
13
+ import { ConsistencyTracker } from './consistency-metrics.js';
14
+ import { CrossValidator } from './cross-validator.js';
15
+ import { GroundTruthChecker } from './ground-truth-checker.js';
16
+ /** 自评-外验闭环网关。 */
17
+ export class VerificationGateway {
18
+ groundTruth;
19
+ crossValidator;
20
+ calibrator;
21
+ tracker;
22
+ constructor(options = {}) {
23
+ this.groundTruth = options.groundTruth ?? new GroundTruthChecker();
24
+ this.crossValidator = options.crossValidator ?? new CrossValidator();
25
+ this.calibrator = options.calibrator ?? new ConfidenceCalibrator();
26
+ this.tracker = options.tracker ?? new ConsistencyTracker();
27
+ }
28
+ /** 暴露指标追踪器(供观测平台拉取快照)。 */
29
+ get metrics() {
30
+ return this.tracker;
31
+ }
32
+ /** 暴露子组件(供部署侧注册探针/复核人)。 */
33
+ get oracles() {
34
+ return this.groundTruth;
35
+ }
36
+ get reviewers() {
37
+ return this.crossValidator;
38
+ }
39
+ /**
40
+ * 裁定一次自评信号(Phase B 闭环主入口)。
41
+ * @param signal 自评信号(由各位家人 self-judge 模块产出)
42
+ * @param request 待校验主张(如 "intent:analysis"、"quality:passed")
43
+ */
44
+ async adjudicate(signal, request) {
45
+ // 1) 真值比对(世界状态优先于任何自评)
46
+ const groundTruth = await this.groundTruth.check(request);
47
+ // 2) 交叉验证:自评请求升级 或 真值未证实时触发
48
+ let cross;
49
+ if (signal.escalation === 'cross-validate' || !groundTruth.verified) {
50
+ cross = await this.crossValidator.crossValidate({ request, signal });
51
+ }
52
+ // 3) 合成有效裁定:真值与交叉验证必须同时支持
53
+ const effective = merge(groundTruth, cross);
54
+ // 4) 校准
55
+ const calibration = this.calibrator.calibrate(signal, effective);
56
+ // 5) 最终升级决策(红线:外验未证实 → 强制 human-confirm)
57
+ const mirageSuspected = signal.escalation === 'none' && !effective.verified;
58
+ const finalEscalation = signal.escalation === 'human-confirm' || !effective.verified
59
+ ? 'human-confirm'
60
+ : signal.escalation;
61
+ // 6) 指标记录
62
+ this.tracker.record({
63
+ selfEscalation: signal.escalation,
64
+ selfConfidence: signal.confidence,
65
+ calibratedConfidence: calibration.confidence,
66
+ verified: effective.verified,
67
+ });
68
+ return {
69
+ traceId: request.traceId,
70
+ agent: signal.agent,
71
+ self: signal,
72
+ groundTruth,
73
+ cross,
74
+ effective,
75
+ calibration,
76
+ finalConfidence: calibration.confidence,
77
+ finalEscalation,
78
+ mirageSuspected,
79
+ };
80
+ }
81
+ }
82
+ /** 合成真值与交叉验证:两者都须支持;置信度取保守加权。 */
83
+ function merge(gt, cross) {
84
+ if (!cross)
85
+ return gt;
86
+ const verified = gt.verified && cross.verified;
87
+ // 保守合成:裁定置信 = min(gt.vConf, cross.vConf);驳斥方优先表达
88
+ const confidence = verified ? Math.min(gt.confidence, cross.confidence) : Math.max(gt.confidence, cross.confidence);
89
+ return {
90
+ traceId: gt.traceId,
91
+ verified,
92
+ sources: [...gt.sources, ...cross.sources],
93
+ confidence,
94
+ detail: `真值[${gt.verified}] ∧ 交叉[${cross.verified}]:${verified ? '双通道支持' : '存在未支持通道'}`,
95
+ };
96
+ }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * ground-truth-checker(真实世界状态校验)——verification-gateway 子模块。
3
+ * 职责:校验主张是否与**外部世界真实状态**一致,防「进展海市蜃楼」。
4
+ * 边界:只做真值比对;置信度校准归 confidence-calibrator,裁决归天枢 / 人类。
5
+ *
6
+ * v2.3.0(Phase B 最小闭环):支持注册可插拔探针(probe)——
7
+ * 每个真值源可挂载 `(claim) => boolean | null` 探针函数,
8
+ * null 表示该源对此主张无意见;全部无意见时 **不默认成功**(verified=false)。
9
+ * TODO(infra): 探针接入真实 oracle 连接(只读 DB / 外部 API / 人工确认工单)。
10
+ */
11
+ import { OracleRegistry } from './oracle-registry.js';
12
+ import type { VerificationRequest, VerificationResult } from '../../types.js';
13
+ /** 真值探针:返回 true=证实 / false=驳斥 / null=无意见。 */
14
+ export type TruthProbe = (claim: string) => boolean | null;
15
+ /** 真实世界状态校验器。 */
16
+ export declare class GroundTruthChecker {
17
+ private readonly registry;
18
+ private readonly probes;
19
+ constructor(registry?: OracleRegistry);
20
+ /** 为指定真值源挂载探针(同 id 重复注册以最后为准)。 */
21
+ registerProbe(oracleId: string, probe: TruthProbe): void;
22
+ /** 已挂载探针的真值源 id 清单。 */
23
+ probedSources(): readonly string[];
24
+ /**
25
+ * 校验主张是否与真实世界状态一致。
26
+ * 裁定规则(保守,防海市蜃楼):
27
+ * - 至少一个源证实 且 无任何源驳斥 → verified=true,vConf 随证实源数 0.75→0.9;
28
+ * - 存在驳斥 → verified=false,vConf=0.8(驳斥置信度,供校准器强衰减);
29
+ * - 无源命中/无意见 → verified=false(不默认成功)。
30
+ * 注:VerificationResult.confidence 语义为「对该裁定本身的置信度」。
31
+ */
32
+ check(request: VerificationRequest): Promise<VerificationResult>;
33
+ }
@@ -0,0 +1,74 @@
1
+ /**
2
+ * ground-truth-checker(真实世界状态校验)——verification-gateway 子模块。
3
+ * 职责:校验主张是否与**外部世界真实状态**一致,防「进展海市蜃楼」。
4
+ * 边界:只做真值比对;置信度校准归 confidence-calibrator,裁决归天枢 / 人类。
5
+ *
6
+ * v2.3.0(Phase B 最小闭环):支持注册可插拔探针(probe)——
7
+ * 每个真值源可挂载 `(claim) => boolean | null` 探针函数,
8
+ * null 表示该源对此主张无意见;全部无意见时 **不默认成功**(verified=false)。
9
+ * TODO(infra): 探针接入真实 oracle 连接(只读 DB / 外部 API / 人工确认工单)。
10
+ */
11
+ import { OracleRegistry } from './oracle-registry.js';
12
+ /** 真实世界状态校验器。 */
13
+ export class GroundTruthChecker {
14
+ registry;
15
+ probes = new Map();
16
+ constructor(registry) {
17
+ this.registry = registry ?? new OracleRegistry();
18
+ }
19
+ /** 为指定真值源挂载探针(同 id 重复注册以最后为准)。 */
20
+ registerProbe(oracleId, probe) {
21
+ this.probes.set(oracleId, probe);
22
+ }
23
+ /** 已挂载探针的真值源 id 清单。 */
24
+ probedSources() {
25
+ return [...this.probes.keys()];
26
+ }
27
+ /**
28
+ * 校验主张是否与真实世界状态一致。
29
+ * 裁定规则(保守,防海市蜃楼):
30
+ * - 至少一个源证实 且 无任何源驳斥 → verified=true,vConf 随证实源数 0.75→0.9;
31
+ * - 存在驳斥 → verified=false,vConf=0.8(驳斥置信度,供校准器强衰减);
32
+ * - 无源命中/无意见 → verified=false(不默认成功)。
33
+ * 注:VerificationResult.confidence 语义为「对该裁定本身的置信度」。
34
+ */
35
+ async check(request) {
36
+ const sources = this.registry.resolve(request.claim).filter((s) => this.probes.has(s.id));
37
+ const verdicts = [];
38
+ for (const source of sources) {
39
+ const probe = this.probes.get(source.id);
40
+ const v = probe(request.claim);
41
+ if (v !== null)
42
+ verdicts.push({ id: source.id, value: v });
43
+ }
44
+ if (verdicts.length === 0) {
45
+ return {
46
+ traceId: request.traceId,
47
+ verified: false,
48
+ sources: sources.map((s) => s.id),
49
+ confidence: 0.4,
50
+ detail: '无可探真值源命中:不默认成功(防海市蜃楼)',
51
+ };
52
+ }
53
+ const yes = verdicts.filter((v) => v.value);
54
+ const refuted = verdicts.length - yes.length;
55
+ if (yes.length > 0 && refuted === 0) {
56
+ // 证实:单源 0.75,多源每 +1 上调 0.05,封顶 0.9
57
+ const vConf = Math.min(0.75 + 0.05 * (yes.length - 1), 0.9);
58
+ return {
59
+ traceId: request.traceId,
60
+ verified: true,
61
+ sources: yes.map((v) => v.id),
62
+ confidence: vConf,
63
+ detail: `${yes.length} 个真值源证实,0 驳斥`,
64
+ };
65
+ }
66
+ return {
67
+ traceId: request.traceId,
68
+ verified: false,
69
+ sources: verdicts.map((v) => v.id),
70
+ confidence: 0.8,
71
+ detail: `${refuted} 个真值源驳斥(证实现实状态与主张不一致)`,
72
+ };
73
+ }
74
+ }
@@ -0,0 +1,12 @@
1
+ /**
2
+ * verification-gateway(自评-外验闭环 / 外部真值校验)入口(barrel)。
3
+ * 依据 §5.2 / §5.6:自评必须经外部真值校验,否则不生效(防「进展海市蜃楼」)。
4
+ * 组件:oracle-registry / ground-truth-checker / cross-validator /
5
+ * confidence-calibrator / consistency-metrics / gateway(闭环门面)。
6
+ */
7
+ export * from './oracle-registry.js';
8
+ export * from './ground-truth-checker.js';
9
+ export * from './cross-validator.js';
10
+ export * from './confidence-calibrator.js';
11
+ export * from './consistency-metrics.js';
12
+ export * from './gateway.js';
@@ -0,0 +1,12 @@
1
+ /**
2
+ * verification-gateway(自评-外验闭环 / 外部真值校验)入口(barrel)。
3
+ * 依据 §5.2 / §5.6:自评必须经外部真值校验,否则不生效(防「进展海市蜃楼」)。
4
+ * 组件:oracle-registry / ground-truth-checker / cross-validator /
5
+ * confidence-calibrator / consistency-metrics / gateway(闭环门面)。
6
+ */
7
+ export * from './oracle-registry.js';
8
+ export * from './ground-truth-checker.js';
9
+ export * from './cross-validator.js';
10
+ export * from './confidence-calibrator.js';
11
+ export * from './consistency-metrics.js';
12
+ export * from './gateway.js';
@@ -0,0 +1,18 @@
1
+ /**
2
+ * oracle-registry(外部真值源注册表)——verification-gateway 子模块。
3
+ * 职责:登记数据库 / API / 人工确认三类外部真值源,供 ground-truth-checker 路由。
4
+ * 边界:只登记与路由;实际比对归 ground-truth-checker,校准归 confidence-calibrator。
5
+ *
6
+ * TODO(infra): 接入真实 oracle 连接(只读 DB / 外部 API / 人工确认工单)。
7
+ */
8
+ import type { OracleSource } from '../../types.js';
9
+ /** 外部真值源注册表。 */
10
+ export declare class OracleRegistry {
11
+ private readonly sources;
12
+ /** 登记一个真值源。 */
13
+ register(source: OracleSource): void;
14
+ /** 列出全部真值源。 */
15
+ list(): readonly OracleSource[];
16
+ /** 按待校验主张推荐匹配的真值源。 */
17
+ resolve(claim: string): readonly OracleSource[];
18
+ }
@@ -0,0 +1,26 @@
1
+ /**
2
+ * oracle-registry(外部真值源注册表)——verification-gateway 子模块。
3
+ * 职责:登记数据库 / API / 人工确认三类外部真值源,供 ground-truth-checker 路由。
4
+ * 边界:只登记与路由;实际比对归 ground-truth-checker,校准归 confidence-calibrator。
5
+ *
6
+ * TODO(infra): 接入真实 oracle 连接(只读 DB / 外部 API / 人工确认工单)。
7
+ */
8
+ /** 外部真值源注册表。 */
9
+ export class OracleRegistry {
10
+ sources = new Map();
11
+ /** 登记一个真值源。 */
12
+ register(source) {
13
+ // TODO(infra): 校验 kind 合法性并探活
14
+ this.sources.set(source.id, source);
15
+ }
16
+ /** 列出全部真值源。 */
17
+ list() {
18
+ return [...this.sources.values()];
19
+ }
20
+ /** 按待校验主张推荐匹配的真值源。 */
21
+ resolve(claim) {
22
+ // TODO(infra): 按 claim 类型路由到匹配的 oracle(DB / API / 人工)
23
+ void claim;
24
+ return this.list();
25
+ }
26
+ }
@@ -0,0 +1,5 @@
1
+ /**
2
+ * dashu-self-healing(大枢自愈控制器)入口(barrel)。
3
+ * 对接 `architecture-kernel/07-自愈中心`。
4
+ */
5
+ export * from './self-healing-controller.js';
@@ -0,0 +1,5 @@
1
+ /**
2
+ * dashu-self-healing(大枢自愈控制器)入口(barrel)。
3
+ * 对接 `architecture-kernel/07-自愈中心`。
4
+ */
5
+ export * from './self-healing-controller.js';
@@ -0,0 +1,33 @@
1
+ /**
2
+ * 大枢自愈控制器(dashu-self-healing)—— K8s 扩缩容 / Pod 重建 / 降级 / 回滚。
3
+ * 语义(M26 由桩转实):
4
+ * - 注入式 `InfraActuator` 端口承载**基础设施执行**(K8s API / 服务网格由部署侧
5
+ * 实现——内核零网络、不绑 K8s SDK);controller 负责:动作计时(RTO 实测)、
6
+ * 状态归一(actuator 成功 → healed,失败 → failed 如实上报,**不再假 healed**)、
7
+ * RTO/RPO 契约判定(契约经构造注入,未注入不判 contractMet=false);
8
+ * - actuator 异常同样归一为 failed(detail 带错误信息),不向调用方抛出
9
+ * (自愈结果即接口——与 07 中心 outcome 语义一致)。
10
+ * 边界:本控制器负责**基础设施层**自愈动作下发;对接 `architecture-kernel/07-自愈中心`
11
+ * (动作/结果的类型契约来自该中心)。策略判定归治理中心,业务补偿归各家人。
12
+ */
13
+ import type { HealingAction, HealingOutcome, RtoRpoContract } from '../../07-自愈中心/types.js';
14
+ /** 基础设施执行器端口(部署侧实现:K8s API / 服务网格 / 容器运行时)。 */
15
+ export interface InfraActuator {
16
+ /** 下发动作;resolve = 执行成功,reject/throw = 执行失败(controller 归一 outcome)。 */
17
+ apply(action: HealingAction): Promise<{
18
+ detail?: string;
19
+ rpoSeconds?: number;
20
+ }>;
21
+ }
22
+ /** 大枢自愈控制器(基础设施层)。 */
23
+ export declare class DashuSelfHealingController {
24
+ private readonly actuator?;
25
+ private readonly contract?;
26
+ /**
27
+ * @param actuator 基础设施执行器(未注入时 apply 如实返回 failed——无执行通道)
28
+ * @param contract RTO/RPO 契约(未注入时 contractMet 恒 false 且 rtoSeconds 仍实测)
29
+ */
30
+ constructor(actuator?: InfraActuator | undefined, contract?: RtoRpoContract | undefined);
31
+ /** 下发基础设施自愈动作:计时执行 → 状态/契约归一(不抛出)。 */
32
+ apply(action: HealingAction): Promise<HealingOutcome>;
33
+ }
@@ -0,0 +1,68 @@
1
+ /**
2
+ * 大枢自愈控制器(dashu-self-healing)—— K8s 扩缩容 / Pod 重建 / 降级 / 回滚。
3
+ * 语义(M26 由桩转实):
4
+ * - 注入式 `InfraActuator` 端口承载**基础设施执行**(K8s API / 服务网格由部署侧
5
+ * 实现——内核零网络、不绑 K8s SDK);controller 负责:动作计时(RTO 实测)、
6
+ * 状态归一(actuator 成功 → healed,失败 → failed 如实上报,**不再假 healed**)、
7
+ * RTO/RPO 契约判定(契约经构造注入,未注入不判 contractMet=false);
8
+ * - actuator 异常同样归一为 failed(detail 带错误信息),不向调用方抛出
9
+ * (自愈结果即接口——与 07 中心 outcome 语义一致)。
10
+ * 边界:本控制器负责**基础设施层**自愈动作下发;对接 `architecture-kernel/07-自愈中心`
11
+ * (动作/结果的类型契约来自该中心)。策略判定归治理中心,业务补偿归各家人。
12
+ */
13
+ /** 大枢自愈控制器(基础设施层)。 */
14
+ export class DashuSelfHealingController {
15
+ actuator;
16
+ contract;
17
+ /**
18
+ * @param actuator 基础设施执行器(未注入时 apply 如实返回 failed——无执行通道)
19
+ * @param contract RTO/RPO 契约(未注入时 contractMet 恒 false 且 rtoSeconds 仍实测)
20
+ */
21
+ constructor(actuator, contract) {
22
+ this.actuator = actuator;
23
+ this.contract = contract;
24
+ }
25
+ /** 下发基础设施自愈动作:计时执行 → 状态/契约归一(不抛出)。 */
26
+ async apply(action) {
27
+ const startedAt = Date.now();
28
+ if (!this.actuator) {
29
+ return {
30
+ faultId: action.faultId,
31
+ actionId: action.id,
32
+ layer: action.layer,
33
+ status: 'failed',
34
+ contractMet: false,
35
+ at: Date.now(),
36
+ detail: '未注入 InfraActuator(基础设施执行通道未装配)',
37
+ };
38
+ }
39
+ try {
40
+ const result = await this.actuator.apply(action);
41
+ const rtoSeconds = (Date.now() - startedAt) / 1000;
42
+ const contractMet = this.contract ? rtoSeconds <= this.contract.rtoSeconds : false;
43
+ return {
44
+ faultId: action.faultId,
45
+ actionId: action.id,
46
+ layer: action.layer,
47
+ status: 'healed',
48
+ contractMet,
49
+ rtoSeconds,
50
+ ...(result.rpoSeconds !== undefined ? { rpoSeconds: result.rpoSeconds } : {}),
51
+ at: Date.now(),
52
+ detail: result.detail ?? `${action.kind}@${action.target} 已下发`,
53
+ };
54
+ }
55
+ catch (error) {
56
+ return {
57
+ faultId: action.faultId,
58
+ actionId: action.id,
59
+ layer: action.layer,
60
+ status: 'failed',
61
+ contractMet: false,
62
+ rtoSeconds: (Date.now() - startedAt) / 1000,
63
+ at: Date.now(),
64
+ detail: `actuator 执行失败:${error instanceof Error ? error.message : String(error)}`,
65
+ };
66
+ }
67
+ }
68
+ }
@@ -0,0 +1,99 @@
1
+ /**
2
+ * 家族通信总线(family-communication-bus)—— 事件驱动消息总线。
3
+ * 职责:点对点 / 广播投递、链路追踪(traceId 贯穿)、重试与死信(DLQ)、MCP 适配器。
4
+ * 幂等键 = traceId + agentId + seq(§6.2 幂等与去重)。
5
+ * 边界:家族**内部**事件路由;MCP 为**对外**模型/工具接入标准(适配器关系,非同一物)。
6
+ *
7
+ * 死信语义(第 3 层「总线」自愈,见 07-自愈中心 §5.5):
8
+ * - 单个处理器失败只影响自身,不阻断同主题其它处理器(故障隔离);
9
+ * - 最多尝试 `maxAttempts` 次(含首次),带指数退避;
10
+ * - 重试耗尽后写入 DLQ,并回调 `onDeadLetter` 供自愈中心消费;
11
+ * - DLQ 为有界 FIFO(`dlqCapacity`),超限淘汰最旧记录。
12
+ *
13
+ * MCP 适配(P1-T3):
14
+ * - 适配器只做编解码(McpAdapter),传输由 mcp-adapter/stdio-transport 提供;
15
+ * - 出站:`encodeForMcp` 取编码结果,由调用方写入传输;
16
+ * - 入站:`ingestMcp` 解码后发布;解码失败的事件以合成事件形式进入 DLQ
17
+ * (topic=`mcp.undecodable`),不向调用方抛出,避免打断传输循环。
18
+ *
19
+ * TODO(infra): 接入消息中间件(Kafka / NATS)。
20
+ */
21
+ import type { BusEvent, IdempotencyKey, McpAdapter } from '../types.js';
22
+ /** 事件处理器。 */
23
+ export type EventHandler = (event: BusEvent) => void | Promise<void>;
24
+ /** 死信记录(重试耗尽后的事件快照)。 */
25
+ export interface DeadLetter {
26
+ /** 幂等键(traceId:agentId:seq)。 */
27
+ readonly id: string;
28
+ /** 投递目标主题。 */
29
+ readonly topic: string;
30
+ /** 原始事件(供自愈中心重放/审计)。 */
31
+ readonly event: BusEvent;
32
+ /** 实际尝试次数。 */
33
+ readonly attempts: number;
34
+ /** 末次错误摘要。 */
35
+ readonly error: string;
36
+ /** 入队时间(毫秒,由 `now()` 提供)。 */
37
+ readonly at: number;
38
+ }
39
+ /** 总线运行选项。 */
40
+ export interface EventBusOptions {
41
+ /** 最大尝试次数(含首次),默认 3。 */
42
+ readonly maxAttempts?: number;
43
+ /** 首次退避毫秒数;0 表示不等待,后续按 2 的幂递增,默认 0。 */
44
+ readonly retryDelayMs?: number;
45
+ /** DLQ 容量上限,默认 100,超限淘汰最旧。 */
46
+ readonly dlqCapacity?: number;
47
+ /** 时钟注入(测试可确定性断言 `at`),默认 `Date.now`。 */
48
+ readonly now?: () => number;
49
+ /** 死信回调(对接 07-自愈中心的 dead-letter 动作)。 */
50
+ readonly onDeadLetter?: (letter: DeadLetter) => void;
51
+ }
52
+ /** 家族通信总线。 */
53
+ export declare class EventBus {
54
+ private readonly handlers;
55
+ private readonly seen;
56
+ private readonly deadQueue;
57
+ private readonly mcpAdapters;
58
+ private mcpUndecodableSeq;
59
+ private readonly maxAttempts;
60
+ private readonly retryDelayMs;
61
+ private readonly dlqCapacity;
62
+ private readonly now;
63
+ private readonly onDeadLetter?;
64
+ constructor(options?: EventBusOptions);
65
+ /** 构造幂等键(traceId + agentId + seq)。 */
66
+ static idempotencyKey(key: IdempotencyKey): string;
67
+ /** 订阅主题。 */
68
+ subscribe(topic: string, handler: EventHandler): void;
69
+ /**
70
+ * 发布事件(按 event.mode 点对点 / 广播)。幂等去重,重复事件丢弃。
71
+ * 处理器失败按 `maxAttempts` 重试;耗尽后进入 DLQ,不向发布方抛出。
72
+ * 注意:进入 DLQ 的事件幂等键已被占用,重新 `publish` 同键事件不会重放;
73
+ * 重放由自愈中心通过 `onDeadLetter` 拿到 `letter.event` 后自行决定。
74
+ */
75
+ publish(event: BusEvent): Promise<void>;
76
+ /** 死信快照(只读副本,不清空)。 */
77
+ deadLetters(): readonly DeadLetter[];
78
+ /** 取出并清空死信(交给自愈中心批处理的典型用法)。 */
79
+ drainDeadLetters(): readonly DeadLetter[];
80
+ /** 注册 MCP 适配器(对外模型/工具接入)。重复 id 视为装配错误。 */
81
+ registerMcpAdapter(adapter: McpAdapter): void;
82
+ /** 已注册的适配器 id(装配自检用)。 */
83
+ mcpAdapterIds(): readonly string[];
84
+ /** 出站编码:BusEvent → 对外 MCP 消息。未注册或编码失败即抛出。 */
85
+ encodeForMcp(adapterId: string, event: BusEvent): unknown;
86
+ /**
87
+ * 入站投递:解码 MCP 消息并发布到总线。
88
+ * 解码失败不抛出,而是以合成事件写入 DLQ(topic=`mcp.undecodable`),
89
+ * 保证传输层的消息循环不因单条脏数据中断。
90
+ * @returns 成功时返回解码后的事件;失败返回 undefined。
91
+ */
92
+ ingestMcp(adapterId: string, raw: unknown): Promise<BusEvent | undefined>;
93
+ /** 单处理器投递:失败重试,耗尽后拉入 DLQ。 */
94
+ private deliver;
95
+ /** 指数退避:retryDelayMs × 2^(attempt-1);为 0 时不同步等待。 */
96
+ private backoffMs;
97
+ /** 入队死信(有界 FIFO)并回调自愈中心。 */
98
+ private pushDeadLetter;
99
+ }