@yyc3/ai-family-kernel 0.0.0-stage → 2.52.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 +313 -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,270 @@
1
+ /**
2
+ * 轻量指标注册器(metrics-registry)——「09-可观测性」基础设施(v2.7.0,P0 数据面)。
3
+ * 职责:以**零运行时依赖**实现 Prometheus 三大基础指标(Counter / Gauge / Histogram),
4
+ * 并按 Prometheus 文本 exposition 格式渲染(# HELP / # TYPE / 样本行)。
5
+ * 边界:只做指标存储与渲染;指标语义与埋点归 family-metrics,HTTP 暴露归 metrics-server。
6
+ *
7
+ * 设计约束(对齐仓库零依赖原则):
8
+ * - 不引入 prom-client;哈希/标签/分桶全部内置;
9
+ * - 渲染确定性:指标按注册顺序、同类标签按 key 字典序输出,便于 diff 与快照测试;
10
+ * - Histogram 输出 `_bucket{le=...}` / `_sum` / `_count`,直接兼容 histogram_quantile()。
11
+ */
12
+ /** 默认直方图分桶(秒级:任务时长 / 检索耗时通用)。 */
13
+ export const DEFAULT_BUCKETS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
14
+ /** 数值渲染(NaN / ±Inf 用 Prometheus 合法字面量)。 */
15
+ function formatNumber(value) {
16
+ if (Number.isNaN(value))
17
+ return 'NaN';
18
+ if (value === Number.POSITIVE_INFINITY)
19
+ return '+Inf';
20
+ if (value === Number.NEGATIVE_INFINITY)
21
+ return '-Inf';
22
+ return String(value);
23
+ }
24
+ /** 标签转义(\\ → \\\\,换行 → \\n,引号 → \\")。 */
25
+ function escapeLabel(value) {
26
+ return value.replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/"/g, '\\"');
27
+ }
28
+ /** 标签序列化为确定性键(按 key 字典序)。 */
29
+ function labelKey(labels) {
30
+ return Object.keys(labels)
31
+ .sort()
32
+ .map((k) => `${k}="${escapeLabel(labels[k])}"`)
33
+ .join(',');
34
+ }
35
+ /** 渲染 `{...}` 后缀(无标签返回空串)。 */
36
+ function renderLabelSuffix(key) {
37
+ return key ? `{${key}}` : '';
38
+ }
39
+ /** Counter(单调递增)。 */
40
+ export class Counter {
41
+ descriptor;
42
+ values = new Map();
43
+ constructor(descriptor) {
44
+ this.descriptor = descriptor;
45
+ }
46
+ /** 递增(默认 +1)。 */
47
+ inc(labels = {}, value = 1) {
48
+ const key = labelKey(labels);
49
+ const cur = this.values.get(key);
50
+ if (cur)
51
+ cur.value += value;
52
+ else
53
+ this.values.set(key, { labels, value });
54
+ }
55
+ /** 当前值。 */
56
+ value(labels = {}) {
57
+ return this.values.get(labelKey(labels))?.value ?? 0;
58
+ }
59
+ /** 渲染样本行(不含 HELP/TYPE)。 */
60
+ render() {
61
+ return [...this.values.entries()]
62
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
63
+ .map(([key, s]) => `${this.descriptor.name}${renderLabelSuffix(key)} ${formatNumber(s.value)}`);
64
+ }
65
+ /** 全部序列(供聚合/调试)。 */
66
+ series() {
67
+ return [...this.values.values()].map((s) => ({ labels: s.labels, key: labelKey(s.labels) }));
68
+ }
69
+ }
70
+ /** Gauge(可增可减可设)。 */
71
+ export class Gauge {
72
+ descriptor;
73
+ values = new Map();
74
+ constructor(descriptor) {
75
+ this.descriptor = descriptor;
76
+ }
77
+ set(value, labels = {}) {
78
+ this.values.set(labelKey(labels), { labels, value });
79
+ }
80
+ inc(labels = {}, value = 1) {
81
+ const key = labelKey(labels);
82
+ const cur = this.values.get(key);
83
+ if (cur)
84
+ cur.value += value;
85
+ else
86
+ this.values.set(key, { labels, value });
87
+ }
88
+ dec(labels = {}, value = 1) {
89
+ this.inc(labels, -value);
90
+ }
91
+ value(labels = {}) {
92
+ return this.values.get(labelKey(labels))?.value ?? 0;
93
+ }
94
+ render() {
95
+ return [...this.values.entries()]
96
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
97
+ .map(([key, s]) => `${this.descriptor.name}${renderLabelSuffix(key)} ${formatNumber(s.value)}`);
98
+ }
99
+ }
100
+ /** Histogram(累积分桶 + 总和 + 计数 + 可选 exemplar)。 */
101
+ export class Histogram {
102
+ descriptor;
103
+ buckets;
104
+ values = new Map();
105
+ exemplarEnabled;
106
+ maxPerBucket;
107
+ ttlMs;
108
+ onDrop;
109
+ constructor(descriptor, buckets = DEFAULT_BUCKETS, exemplars = {}) {
110
+ this.descriptor = descriptor;
111
+ // 上界去重升序,保证累积语义正确
112
+ this.buckets = [...new Set(buckets)].sort((a, b) => a - b);
113
+ this.exemplarEnabled = exemplars.enabled === true;
114
+ this.maxPerBucket = Math.max(1, exemplars.maxPerBucket ?? 1);
115
+ this.ttlMs = Math.max(0, exemplars.ttlMs ?? 60_000);
116
+ this.onDrop = exemplars.onDrop;
117
+ }
118
+ /** exemplar 是否启用(供协议协商与测试)。 */
119
+ get exemplarsEnabled() {
120
+ return this.exemplarEnabled;
121
+ }
122
+ /**
123
+ * 观测一个值(秒)。
124
+ * 第三参仅在 exemplar 启用时生效;未启用时完全忽略,保证默认输出不变。
125
+ */
126
+ observe(value, labels = {}, exemplar) {
127
+ if (!Number.isFinite(value))
128
+ return;
129
+ const key = labelKey(labels);
130
+ let s = this.values.get(key);
131
+ if (!s) {
132
+ s = { labels, counts: new Array(this.buckets.length).fill(0), sum: 0, count: 0, exemplars: new Map() };
133
+ this.values.set(key, s);
134
+ }
135
+ s.sum += value;
136
+ s.count += 1;
137
+ for (let i = 0; i < this.buckets.length; i += 1) {
138
+ if (value <= this.buckets[i])
139
+ s.counts[i] += 1;
140
+ }
141
+ if (!this.exemplarEnabled || !exemplar)
142
+ return;
143
+ const idx = this.bucketIndex(value);
144
+ const now = Date.now();
145
+ const items = s.exemplars.get(idx) ?? [];
146
+ // 惰性清理过期项
147
+ const alive = items.filter((it) => now - it.at <= this.ttlMs);
148
+ alive.push({ ex: exemplar, at: now });
149
+ // 超出上限:保留最新,丢弃最旧并计数
150
+ while (alive.length > this.maxPerBucket) {
151
+ alive.shift();
152
+ this.onDrop?.();
153
+ }
154
+ s.exemplars.set(idx, alive);
155
+ }
156
+ /** 观测总数。 */
157
+ count(labels = {}) {
158
+ return this.values.get(labelKey(labels))?.count ?? 0;
159
+ }
160
+ /** 观测总和。 */
161
+ sum(labels = {}) {
162
+ return this.values.get(labelKey(labels))?.sum ?? 0;
163
+ }
164
+ /** 渲染样本行(累积分桶 + +Inf + _sum + _count)。 */
165
+ render() {
166
+ const out = [];
167
+ for (const [key, s] of [...this.values.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
168
+ const prefix = s.labels;
169
+ for (let i = 0; i < this.buckets.length; i += 1) {
170
+ const labels = { ...prefix, le: formatNumber(this.buckets[i]) };
171
+ out.push(`${this.descriptor.name}_bucket${renderLabelSuffix(labelKey(labels))} ${formatNumber(s.counts[i])}`);
172
+ }
173
+ out.push(`${this.descriptor.name}_bucket${renderLabelSuffix(labelKey({ ...prefix, le: '+Inf' }))} ${formatNumber(s.count)}`);
174
+ out.push(`${this.descriptor.name}_sum${renderLabelSuffix(key)} ${formatNumber(s.sum)}`);
175
+ out.push(`${this.descriptor.name}_count${renderLabelSuffix(key)} ${formatNumber(s.count)}`);
176
+ }
177
+ return out;
178
+ }
179
+ /**
180
+ * 渲染 OpenMetrics 样本行:在落点桶后附 exemplar。
181
+ * 格式:`<bucket> <count> # {trace_id="..."} <value> <ts秒>`
182
+ */
183
+ renderOpenMetrics() {
184
+ const out = [];
185
+ for (const [key, s] of [...this.values.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
186
+ const prefix = s.labels;
187
+ for (let i = 0; i < this.buckets.length; i += 1) {
188
+ const labels = { ...prefix, le: formatNumber(this.buckets[i]) };
189
+ out.push(`${this.descriptor.name}_bucket${renderLabelSuffix(labelKey(labels))} ${formatNumber(s.counts[i])}${this.exemplarSuffix(i, s)}`);
190
+ }
191
+ const infLabels = { ...prefix, le: '+Inf' };
192
+ out.push(`${this.descriptor.name}_bucket${renderLabelSuffix(labelKey(infLabels))} ${formatNumber(s.count)}${this.exemplarSuffix(this.buckets.length, s)}`);
193
+ out.push(`${this.descriptor.name}_sum${renderLabelSuffix(key)} ${formatNumber(s.sum)}`);
194
+ out.push(`${this.descriptor.name}_count${renderLabelSuffix(key)} ${formatNumber(s.count)}`);
195
+ }
196
+ return out;
197
+ }
198
+ /** 值 → 落点桶索引(超出最大上界归入 +Inf 桶)。 */
199
+ bucketIndex(value) {
200
+ for (let i = 0; i < this.buckets.length; i += 1) {
201
+ if (value <= this.buckets[i])
202
+ return i;
203
+ }
204
+ return this.buckets.length;
205
+ }
206
+ /** 单个桶的 exemplar 后缀(取最新存活项;过期项在此惰性清理)。 */
207
+ exemplarSuffix(idx, s) {
208
+ const items = s.exemplars.get(idx);
209
+ if (!items || items.length === 0)
210
+ return '';
211
+ const now = Date.now();
212
+ const alive = items.filter((it) => now - it.at <= this.ttlMs);
213
+ if (alive.length === 0) {
214
+ s.exemplars.delete(idx);
215
+ return '';
216
+ }
217
+ const last = alive[alive.length - 1];
218
+ const labels = labelKey(last.ex.labels ?? {});
219
+ return ` # {${labels}} ${formatNumber(last.ex.value)} ${(last.ex.timestampMs / 1000).toFixed(3)}`;
220
+ }
221
+ }
222
+ /** 指标注册器:持有全部指标并渲染完整 exposition 文本。 */
223
+ export class MetricsRegistry {
224
+ metrics = [];
225
+ counter(name, help) {
226
+ const metric = new Counter({ name, help, type: 'counter' });
227
+ this.metrics.push(metric);
228
+ return metric;
229
+ }
230
+ gauge(name, help) {
231
+ const metric = new Gauge({ name, help, type: 'gauge' });
232
+ this.metrics.push(metric);
233
+ return metric;
234
+ }
235
+ histogram(name, help, buckets, exemplars) {
236
+ const metric = new Histogram({ name, help, type: 'histogram' }, buckets, exemplars);
237
+ this.metrics.push(metric);
238
+ return metric;
239
+ }
240
+ /** 是否存在启用 exemplar 的直方图(供协议协商)。 */
241
+ get exemplarsEnabled() {
242
+ return this.metrics.some((m) => m instanceof Histogram && m.exemplarsEnabled);
243
+ }
244
+ /** 渲染 Prometheus 文本 exposition(末尾带换行,符合 exposition 规范)。 */
245
+ render() {
246
+ const lines = [];
247
+ for (const metric of this.metrics) {
248
+ const { name, help, type } = metric.descriptor;
249
+ lines.push(`# HELP ${name} ${help}`);
250
+ lines.push(`# TYPE ${name} ${type}`);
251
+ lines.push(...metric.render());
252
+ }
253
+ return `${lines.join('\n')}\n`;
254
+ }
255
+ /**
256
+ * 渲染 OpenMetrics 1.0(末尾以 `# EOF` 结束)。
257
+ * 直方图在落点桶后附 exemplar;Counter/Gauge 输出与 0.0.4 一致。
258
+ */
259
+ renderOpenMetrics() {
260
+ const lines = [];
261
+ for (const metric of this.metrics) {
262
+ const { name, help, type } = metric.descriptor;
263
+ lines.push(`# HELP ${name} ${help}`);
264
+ lines.push(`# TYPE ${name} ${type}`);
265
+ lines.push(...(metric instanceof Histogram ? metric.renderOpenMetrics() : metric.render()));
266
+ }
267
+ lines.push('# EOF');
268
+ return `${lines.join('\n')}\n`;
269
+ }
270
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * 指标暴露服务(metrics-server)——「09-可观测性」HTTP 端点(v2.7.0,P0 数据面)。
3
+ * 职责:零依赖 node:http 暴露 `GET /metrics`(Prometheus 文本 exposition)与 `GET /healthz`。
4
+ * 边界:只做暴露;指标语义归 family-metrics,抓取与告警归 Prometheus。
5
+ *
6
+ * v2.7.1(验收 L3 闭环):
7
+ * - 默认绑定 127.0.0.1(回环),跨机抓取须显式 host='0.0.0.0' 并配置 authToken;
8
+ * - authToken 启用后 `/metrics` 走 Bearer 鉴权(常量时间比较),`/healthz` 保持免鉴权。
9
+ *
10
+ * 设计约束:
11
+ * - 零依赖(不引入 express / prom-client),node:http 原生;
12
+ * - 端口传 0 时由系统分配(测试/多实例场景),句柄回传实际端口;
13
+ * - 响应头 Content-Type 遵循 Prometheus 文本协议版本 0.0.4。
14
+ */
15
+ /** 启动选项。 */
16
+ export interface MetricsServerOptions {
17
+ /** 指标集:render 为 0.0.4;renderOpenMetrics 提供 OpenMetrics 1.0(可选)。 */
18
+ readonly metrics: {
19
+ render(): string;
20
+ renderOpenMetrics?(): string;
21
+ };
22
+ /** 监听端口,默认 9464;0 表示系统随机分配。 */
23
+ readonly port?: number;
24
+ /**
25
+ * 监听地址,默认 127.0.0.1(仅回环,L3 最小暴露原则)。
26
+ * 容器内被 Prometheus 跨机抓取时显式传 '0.0.0.0',并同时配置 authToken。
27
+ */
28
+ readonly host?: string;
29
+ /**
30
+ * Bearer 令牌(可选):设置后 `/metrics` 需 `Authorization: Bearer <token>`,
31
+ * 缺失或不匹配返回 401;`/healthz` 保持免鉴权(供存活探针)。
32
+ */
33
+ readonly authToken?: string;
34
+ }
35
+ /** 运行句柄。 */
36
+ export interface MetricsServerHandle {
37
+ readonly port: number;
38
+ readonly url: string;
39
+ close(): Promise<void>;
40
+ }
41
+ /**
42
+ * 启动指标暴露服务。
43
+ * 路由:GET /metrics → 文本指标(配置 authToken 时需 Bearer 鉴权);GET /healthz → "ok";其余 404。
44
+ */
45
+ export declare function startMetricsServer(options: MetricsServerOptions): Promise<MetricsServerHandle>;
@@ -0,0 +1,86 @@
1
+ // @ts-nocheck
2
+ /**
3
+ * 指标暴露服务(metrics-server)——「09-可观测性」HTTP 端点(v2.7.0,P0 数据面)。
4
+ * 职责:零依赖 node:http 暴露 `GET /metrics`(Prometheus 文本 exposition)与 `GET /healthz`。
5
+ * 边界:只做暴露;指标语义归 family-metrics,抓取与告警归 Prometheus。
6
+ *
7
+ * v2.7.1(验收 L3 闭环):
8
+ * - 默认绑定 127.0.0.1(回环),跨机抓取须显式 host='0.0.0.0' 并配置 authToken;
9
+ * - authToken 启用后 `/metrics` 走 Bearer 鉴权(常量时间比较),`/healthz` 保持免鉴权。
10
+ *
11
+ * 设计约束:
12
+ * - 零依赖(不引入 express / prom-client),node:http 原生;
13
+ * - 端口传 0 时由系统分配(测试/多实例场景),句柄回传实际端口;
14
+ * - 响应头 Content-Type 遵循 Prometheus 文本协议版本 0.0.4。
15
+ */
16
+ import http from 'node:http';
17
+ import { timingSafeEqual } from 'node:crypto';
18
+ /** 常量时间比较(避免令牌长度/前缀时序侧信道)。 */
19
+ function tokenMatches(expected, actual) {
20
+ if (typeof actual !== 'string')
21
+ return false;
22
+ const a = Buffer.from(expected, 'utf8');
23
+ const b = Buffer.from(actual, 'utf8');
24
+ if (a.length !== b.length)
25
+ return false;
26
+ return timingSafeEqual(a, b);
27
+ }
28
+ /**
29
+ * 启动指标暴露服务。
30
+ * 路由:GET /metrics → 文本指标(配置 authToken 时需 Bearer 鉴权);GET /healthz → "ok";其余 404。
31
+ */
32
+ export async function startMetricsServer(options) {
33
+ const port = options.port ?? 9464;
34
+ const host = options.host ?? '127.0.0.1';
35
+ const authToken = options.authToken;
36
+ const server = http.createServer((req, res) => {
37
+ if (req.method !== 'GET') {
38
+ res.writeHead(405, { 'Content-Type': 'text/plain; charset=utf-8' });
39
+ res.end('method not allowed');
40
+ return;
41
+ }
42
+ if (req.url === '/metrics') {
43
+ if (authToken) {
44
+ const header = req.headers.authorization;
45
+ const provided = typeof header === 'string' && header.startsWith('Bearer ') ? header.slice(7) : '';
46
+ if (!tokenMatches(authToken, provided)) {
47
+ res.writeHead(401, {
48
+ 'Content-Type': 'text/plain; charset=utf-8',
49
+ 'WWW-Authenticate': 'Bearer realm="yyc3-metrics"',
50
+ });
51
+ res.end('unauthorized');
52
+ return;
53
+ }
54
+ }
55
+ // L7:按 Accept 协商 OpenMetrics 1.0(未提供 renderOpenMetrics 时保持 0.0.4)
56
+ const accept = String(req.headers.accept ?? '');
57
+ if (accept.includes('application/openmetrics-text') && typeof options.metrics.renderOpenMetrics === 'function') {
58
+ res.writeHead(200, { 'Content-Type': 'application/openmetrics-text; version=1.0.0; charset=utf-8' });
59
+ res.end(options.metrics.renderOpenMetrics());
60
+ return;
61
+ }
62
+ res.writeHead(200, { 'Content-Type': 'text/plain; version=0.0.4; charset=utf-8' });
63
+ res.end(options.metrics.render());
64
+ return;
65
+ }
66
+ if (req.url === '/healthz') {
67
+ res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
68
+ res.end('ok');
69
+ return;
70
+ }
71
+ res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
72
+ res.end('not found');
73
+ });
74
+ await new Promise((resolve, reject) => {
75
+ server.once('error', reject);
76
+ server.listen(port, host, resolve);
77
+ });
78
+ const actualPort = server.address().port;
79
+ return {
80
+ port: actualPort,
81
+ url: `http://${host === '0.0.0.0' ? '127.0.0.1' : host}:${actualPort}`,
82
+ close: () => new Promise((resolve, reject) => {
83
+ server.close((err) => (err ? reject(err) : resolve()));
84
+ }),
85
+ };
86
+ }
@@ -0,0 +1,79 @@
1
+ /**
2
+ * 能力包准入治理(P4-T3 · allowlist)—— 默认 observe,enforce 需显式开关。
3
+ *
4
+ * 职责(演进指导 §4.3 · M13 判据):
5
+ * - 准入清单(插件 id 白名单)由部署侧注入,内核不做 IO;
6
+ * - 未准入包被调用时**必定**写入 ComplianceAudit(不可篡改审计链);
7
+ * - observe(默认):放行但留痕,只观察不阻断;
8
+ * - enforce(显式开关):拒绝调用并计数(rejectedCount)。
9
+ *
10
+ * 边界:仅做准入判定与审计留痕;执行仍由既有运行时承接
11
+ * (红线:不做动态 import() / 远程安装 / vm 沙箱)。
12
+ */
13
+ import { ComplianceAudit } from '../06-治理中心/compliance-audit/compliance-audit.js';
14
+ import type { PluginManifest } from './catalog.js';
15
+ /** 准入模式:observe 只记审计;enforce 拒绝。 */
16
+ export declare const ADMISSION_MODES: readonly ["observe", "enforce"];
17
+ export type AdmissionMode = (typeof ADMISSION_MODES)[number];
18
+ /** 默认准入模式——observe(enforce 必须显式声明)。 */
19
+ export declare const DEFAULT_ADMISSION_MODE: AdmissionMode;
20
+ /** 准入策略标识(写入审计记录的 policyId / policyVersion)。 */
21
+ export declare const ADMISSION_POLICY_ID = "capability-allowlist";
22
+ export declare const ADMISSION_POLICY_VERSION = "1.0.0";
23
+ /** 未声明 action 时的默认动作。 */
24
+ export declare const DEFAULT_ADMISSION_ACTION = "capability.invoke";
25
+ /** 准入治理配置(部署侧注入)。 */
26
+ export interface AdmissionConfig {
27
+ /** 准入清单(插件 id)。 */
28
+ readonly allowed: readonly string[];
29
+ /** 准入模式;缺省 observe(enforce 需显式传入)。 */
30
+ readonly mode?: AdmissionMode;
31
+ /** 审计链(缺省自建内存链;可注入共享链)。 */
32
+ readonly audit?: ComplianceAudit;
33
+ }
34
+ /** 一次能力包调用(准入判定入参)。 */
35
+ export interface AdmissionRequest {
36
+ readonly pluginId: string;
37
+ readonly traceId: string;
38
+ readonly actor: string;
39
+ readonly action?: string;
40
+ readonly resource?: string;
41
+ }
42
+ /** 准入判定结果。 */
43
+ export interface AdmissionDecision {
44
+ /** 是否放行本次调用(observe 下未准入仍放行)。 */
45
+ readonly admitted: boolean;
46
+ readonly mode: AdmissionMode;
47
+ readonly pluginId: string;
48
+ readonly reason: string;
49
+ /** 是否写入审计链(仅未准入调用留痕)。 */
50
+ readonly audited: boolean;
51
+ }
52
+ /**
53
+ * 能力包准入清单:allowlist + observe/enforce 判定。
54
+ * 未准入调用一律写审计;enforce 下额外拒绝并计数。
55
+ */
56
+ export declare class CapabilityAllowlist {
57
+ private readonly allowed;
58
+ private readonly mode;
59
+ private readonly audit;
60
+ private rejected;
61
+ private observed;
62
+ constructor(config: AdmissionConfig);
63
+ /** 生效准入模式。 */
64
+ get admissionMode(): AdmissionMode;
65
+ /** enforce 下被拒绝的调用次数。 */
66
+ get rejectedCount(): number;
67
+ /** observe 下放行但留痕的调用次数。 */
68
+ get observedCount(): number;
69
+ /** 审计链快照(只读)。 */
70
+ get auditRecords(): readonly import("../06-\u6CBB\u7406\u4E2D\u5FC3/types.js").AuditRecord[];
71
+ /** 插件是否在准入清单内。 */
72
+ isAllowed(pluginId: string): boolean;
73
+ /** 审计链完整性校验(篡改即断链)。 */
74
+ verifyAudit(): boolean;
75
+ /** 一次能力包调用的准入判定(未准入必定写审计)。 */
76
+ admit(request: AdmissionRequest): AdmissionDecision;
77
+ /** 按准入清单过滤(未准入不可见——供 tools/list 等可见性场景复用)。 */
78
+ filterAllowed(manifests: readonly PluginManifest[]): readonly PluginManifest[];
79
+ }
@@ -0,0 +1,122 @@
1
+ /**
2
+ * 能力包准入治理(P4-T3 · allowlist)—— 默认 observe,enforce 需显式开关。
3
+ *
4
+ * 职责(演进指导 §4.3 · M13 判据):
5
+ * - 准入清单(插件 id 白名单)由部署侧注入,内核不做 IO;
6
+ * - 未准入包被调用时**必定**写入 ComplianceAudit(不可篡改审计链);
7
+ * - observe(默认):放行但留痕,只观察不阻断;
8
+ * - enforce(显式开关):拒绝调用并计数(rejectedCount)。
9
+ *
10
+ * 边界:仅做准入判定与审计留痕;执行仍由既有运行时承接
11
+ * (红线:不做动态 import() / 远程安装 / vm 沙箱)。
12
+ */
13
+ import { ComplianceAudit } from '../06-治理中心/compliance-audit/compliance-audit.js';
14
+ /** 准入模式:observe 只记审计;enforce 拒绝。 */
15
+ export const ADMISSION_MODES = ['observe', 'enforce'];
16
+ /** 默认准入模式——observe(enforce 必须显式声明)。 */
17
+ export const DEFAULT_ADMISSION_MODE = 'observe';
18
+ /** 准入策略标识(写入审计记录的 policyId / policyVersion)。 */
19
+ export const ADMISSION_POLICY_ID = 'capability-allowlist';
20
+ export const ADMISSION_POLICY_VERSION = '1.0.0';
21
+ /** 未声明 action 时的默认动作。 */
22
+ export const DEFAULT_ADMISSION_ACTION = 'capability.invoke';
23
+ /**
24
+ * 能力包准入清单:allowlist + observe/enforce 判定。
25
+ * 未准入调用一律写审计;enforce 下额外拒绝并计数。
26
+ */
27
+ export class CapabilityAllowlist {
28
+ allowed;
29
+ mode;
30
+ audit;
31
+ rejected = 0;
32
+ observed = 0;
33
+ constructor(config) {
34
+ const mode = config.mode ?? DEFAULT_ADMISSION_MODE;
35
+ if (!ADMISSION_MODES.includes(mode)) {
36
+ throw new Error(`准入模式非法:${String(mode)}(仅 observe / enforce)`);
37
+ }
38
+ this.allowed = new Set(config.allowed);
39
+ this.mode = mode;
40
+ this.audit = config.audit ?? new ComplianceAudit();
41
+ }
42
+ /** 生效准入模式。 */
43
+ get admissionMode() {
44
+ return this.mode;
45
+ }
46
+ /** enforce 下被拒绝的调用次数。 */
47
+ get rejectedCount() {
48
+ return this.rejected;
49
+ }
50
+ /** observe 下放行但留痕的调用次数。 */
51
+ get observedCount() {
52
+ return this.observed;
53
+ }
54
+ /** 审计链快照(只读)。 */
55
+ get auditRecords() {
56
+ return this.audit.list();
57
+ }
58
+ /** 插件是否在准入清单内。 */
59
+ isAllowed(pluginId) {
60
+ return this.allowed.has(pluginId);
61
+ }
62
+ /** 审计链完整性校验(篡改即断链)。 */
63
+ verifyAudit() {
64
+ return this.audit.verify();
65
+ }
66
+ /** 一次能力包调用的准入判定(未准入必定写审计)。 */
67
+ admit(request) {
68
+ if (this.isAllowed(request.pluginId)) {
69
+ return {
70
+ admitted: true,
71
+ mode: this.mode,
72
+ pluginId: request.pluginId,
73
+ reason: '已在准入清单',
74
+ audited: false,
75
+ };
76
+ }
77
+ const enforced = this.mode === 'enforce';
78
+ const decision = enforced
79
+ ? {
80
+ decision: 'deny',
81
+ policyId: ADMISSION_POLICY_ID,
82
+ policyVersion: ADMISSION_POLICY_VERSION,
83
+ reason: `未准入能力包(enforce 拒绝):${request.pluginId}`,
84
+ obligations: ['拒绝调用'],
85
+ }
86
+ : {
87
+ decision: 'allow-with-audit',
88
+ policyId: ADMISSION_POLICY_ID,
89
+ policyVersion: ADMISSION_POLICY_VERSION,
90
+ reason: `未准入能力包(observe 放行留痕):${request.pluginId}`,
91
+ obligations: ['记录审计'],
92
+ };
93
+ this.audit.append({
94
+ traceId: request.traceId,
95
+ actor: request.actor,
96
+ action: request.action ?? DEFAULT_ADMISSION_ACTION,
97
+ resource: request.resource ?? request.pluginId,
98
+ }, decision);
99
+ if (enforced) {
100
+ this.rejected += 1;
101
+ return {
102
+ admitted: false,
103
+ mode: this.mode,
104
+ pluginId: request.pluginId,
105
+ reason: decision.reason,
106
+ audited: true,
107
+ };
108
+ }
109
+ this.observed += 1;
110
+ return {
111
+ admitted: true,
112
+ mode: this.mode,
113
+ pluginId: request.pluginId,
114
+ reason: decision.reason,
115
+ audited: true,
116
+ };
117
+ }
118
+ /** 按准入清单过滤(未准入不可见——供 tools/list 等可见性场景复用)。 */
119
+ filterAllowed(manifests) {
120
+ return manifests.filter((m) => this.isAllowed(m.id));
121
+ }
122
+ }
@@ -0,0 +1,67 @@
1
+ /**
2
+ * 能力注册中心(P4-T2 · 静态注册中心)—— scope 解析与合并,纯函数、零网络。
3
+ *
4
+ * 职责(ADR D4「静态清单 + 门禁可验证」):
5
+ * - 接收 builtin / local 两组已解析的能力包清单(解析由部署侧完成,内核不做 IO);
6
+ * - 确定性合并:同 id local 覆盖 builtin;组内同 id 后者覆盖前者;
7
+ * - 展开注册能力(contents refs)并保持 (type, ref) 稳定排序;
8
+ * - 提供只读查询:清单、覆盖关系、能力归属。
9
+ *
10
+ * 红线:不 import family-agents;不做动态 import();不做远程安装;插件 = 静态清单。
11
+ */
12
+ /** 能力包分发域:builtin 随版本分发;local 部署侧覆盖。 */
13
+ export type PluginScope = 'builtin' | 'local';
14
+ /** contents.type 白名单(P4-T1 格式契约)。 */
15
+ export declare const PLUGIN_CONTENT_TYPES: readonly ["skills", "mcp-servers", "policies", "prompts"];
16
+ export type PluginContentType = (typeof PLUGIN_CONTENT_TYPES)[number];
17
+ /** 能力包内的一组内容声明。 */
18
+ export interface PluginContent {
19
+ type: PluginContentType;
20
+ refs: readonly string[];
21
+ }
22
+ /** 完整性声明(算法与摘要见 integrity.ts)。 */
23
+ export interface PluginIntegrity {
24
+ algorithm: string;
25
+ digest: string;
26
+ }
27
+ /** 能力包清单(plugin.yaml 解析后的形态)。 */
28
+ export interface PluginManifest {
29
+ id: string;
30
+ version: string;
31
+ scope: PluginScope;
32
+ description?: string;
33
+ contents?: readonly PluginContent[];
34
+ integrity?: PluginIntegrity;
35
+ targets?: {
36
+ agents?: readonly string[];
37
+ };
38
+ }
39
+ /** 展开后的注册能力归属。 */
40
+ export interface CatalogCapability {
41
+ type: PluginContentType;
42
+ ref: string;
43
+ /** 提供该能力的插件 id。 */
44
+ pluginId: string;
45
+ /** 生效清单的 scope。 */
46
+ scope: PluginScope;
47
+ }
48
+ /** 注册中心快照(合并与展开的确定性结果)。 */
49
+ export interface CapabilityCatalogSnapshot {
50
+ /** 生效清单(按 id 升序)。 */
51
+ plugins: readonly PluginManifest[];
52
+ /** 被 local 覆盖的 builtin id(升序)。 */
53
+ overriddenIds: readonly string[];
54
+ /** 展开的注册能力(按 type 字典序 → ref 字典序 → pluginId 升序)。 */
55
+ capabilities: readonly CatalogCapability[];
56
+ }
57
+ /**
58
+ * 合并 builtin / local 两组清单并展开能力。
59
+ * 覆盖顺序确定且可测:组内数组序后者胜;跨层 local 必覆盖 builtin。
60
+ */
61
+ export declare function buildCapabilityCatalog(builtin: readonly PluginManifest[], local: readonly PluginManifest[]): CapabilityCatalogSnapshot;
62
+ /** 查询生效清单。 */
63
+ export declare function findPlugin(snapshot: CapabilityCatalogSnapshot, id: string): PluginManifest | undefined;
64
+ /** 按类型过滤注册能力。 */
65
+ export declare function capabilitiesOfType(snapshot: CapabilityCatalogSnapshot, type: PluginContentType): readonly CatalogCapability[];
66
+ /** 注册能力是否存在(含归属)。 */
67
+ export declare function hasCapability(snapshot: CapabilityCatalogSnapshot, type: PluginContentType, ref: string): boolean;