@octopi-agent/engine 0.97.15 → 0.102.10

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 (369) hide show
  1. package/dist/config-schema/agent.d.ts +37 -5
  2. package/dist/config-schema/agent.js +24 -4
  3. package/dist/config-schema/context.d.ts +6 -36
  4. package/dist/config-schema/context.js +4 -28
  5. package/dist/config-schema/engine.d.ts +61 -160
  6. package/dist/config-schema/engine.js +1 -5
  7. package/dist/config-schema/governance.d.ts +10 -1
  8. package/dist/config-schema/governance.js +38 -1
  9. package/dist/config-schema/models.d.ts +2 -8
  10. package/dist/config-schema/models.js +0 -2
  11. package/dist/config-schema/run.d.ts +2 -2
  12. package/dist/config-schema/run.js +2 -2
  13. package/dist/config-schema/shared.d.ts +0 -3
  14. package/dist/config-schema/shared.js +0 -2
  15. package/dist/config-schema/substrate.d.ts +14 -88
  16. package/dist/config-schema/substrate.js +22 -107
  17. package/dist/config.d.ts +45 -113
  18. package/dist/config.js +8 -2
  19. package/dist/harness/activation/dispatcher.js +7 -0
  20. package/dist/harness/activation/inbox.d.ts +3 -3
  21. package/dist/harness/activation/inbox.js +3 -3
  22. package/dist/harness/activation/runtime.js +13 -5
  23. package/dist/harness/activation/types.d.ts +2 -2
  24. package/dist/harness/agent/builder.d.ts +34 -2
  25. package/dist/harness/agent/builder.js +189 -58
  26. package/dist/harness/agent/config-bridge.js +9 -2
  27. package/dist/harness/agent/config-integrity.d.ts +66 -0
  28. package/dist/harness/agent/config-integrity.js +108 -2
  29. package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
  30. package/dist/harness/agent/wire-agent-builder.js +31 -7
  31. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  32. package/dist/harness/capabilities/document/factory.js +1 -0
  33. package/dist/harness/capabilities/document/port.js +6 -3
  34. package/dist/harness/capabilities/document/types.d.ts +5 -0
  35. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +2 -2
  36. package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
  37. package/dist/harness/collaboration/autonomous-subsystem/loader.js +4 -1
  38. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
  39. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +21 -4
  40. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  41. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  42. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  43. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  45. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.d.ts +40 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
  48. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
  50. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +12 -3
  52. package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
  53. package/dist/harness/collaboration/delegation/child-run.js +4 -4
  54. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  55. package/dist/harness/collaboration/delegation/index.js +1 -1
  56. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  57. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  58. package/dist/harness/collaboration/delegation/service.d.ts +2 -0
  59. package/dist/harness/collaboration/delegation/service.js +2 -1
  60. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  61. package/dist/harness/collaboration/delegation/store.js +2 -1
  62. package/dist/harness/collaboration/delegation/types.d.ts +23 -2
  63. package/dist/harness/collaboration/delegation/types.js +22 -0
  64. package/dist/harness/collaboration/delegation/wiring.js +11 -1
  65. package/dist/harness/context/budget-allocator.d.ts +26 -18
  66. package/dist/harness/context/budget-allocator.js +67 -32
  67. package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
  68. package/dist/harness/context/capabilities/compact/engine.js +169 -121
  69. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  70. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  71. package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
  72. package/dist/harness/context/capabilities/compact/index.js +4 -0
  73. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  74. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  75. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  76. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  77. package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
  78. package/dist/harness/context/capabilities/compact/types.js +11 -1
  79. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  80. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  81. package/dist/harness/context/capabilities/summary/port.js +0 -1
  82. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  83. package/dist/harness/context/capabilities/summary/resolver.js +4 -9
  84. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  85. package/dist/harness/context/capabilities/summary/types.d.ts +4 -7
  86. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  87. package/dist/harness/context/context-size-ledger.js +236 -0
  88. package/dist/harness/context/default-context-engine.d.ts +195 -119
  89. package/dist/harness/context/default-context-engine.js +1241 -743
  90. package/dist/harness/context/index.d.ts +2 -2
  91. package/dist/harness/context/index.js +1 -1
  92. package/dist/harness/context/layer-types.d.ts +15 -0
  93. package/dist/harness/context/layer-types.js +14 -1
  94. package/dist/harness/context/layers.d.ts +16 -19
  95. package/dist/harness/context/layers.js +42 -14
  96. package/dist/harness/context/message-selector.d.ts +10 -8
  97. package/dist/harness/context/message-selector.js +49 -27
  98. package/dist/harness/context/summarize.d.ts +3 -3
  99. package/dist/harness/context/summarize.js +11 -4
  100. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  101. package/dist/harness/context/system-prompt-assembler.js +3 -1
  102. package/dist/harness/context/token-constants.d.ts +8 -6
  103. package/dist/harness/context/token-constants.js +8 -7
  104. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  105. package/dist/harness/context/token-estimate-fns.js +85 -66
  106. package/dist/harness/context/token-estimator.d.ts +27 -12
  107. package/dist/harness/context/token-estimator.js +120 -66
  108. package/dist/harness/context/token-segments.d.ts +88 -0
  109. package/dist/harness/context/token-segments.js +103 -0
  110. package/dist/harness/context/tool-result-aging.d.ts +6 -1
  111. package/dist/harness/context/tool-result-aging.js +16 -5
  112. package/dist/harness/context/tool-result-body.js +2 -0
  113. package/dist/harness/context/transform/anchors.d.ts +66 -0
  114. package/dist/harness/context/transform/anchors.js +125 -0
  115. package/dist/harness/context/transform/fold.d.ts +56 -0
  116. package/dist/harness/context/transform/fold.js +135 -0
  117. package/dist/harness/context/transform/migrate.d.ts +41 -0
  118. package/dist/harness/context/transform/migrate.js +69 -0
  119. package/dist/harness/context/transform/types.d.ts +129 -0
  120. package/dist/harness/context/transform/types.js +19 -0
  121. package/dist/harness/context/turn-envelope.d.ts +6 -3
  122. package/dist/harness/context/types.d.ts +127 -117
  123. package/dist/harness/extension/execution-environment/effect-policy.d.ts +24 -2
  124. package/dist/harness/extension/execution-environment/effect-policy.js +30 -0
  125. package/dist/harness/extension/execution-environment/ops-audit.d.ts +7 -3
  126. package/dist/harness/extension/execution-environment/ops-audit.js +11 -12
  127. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  128. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  129. package/dist/harness/extension/execution-environment/undo-log.d.ts +6 -2
  130. package/dist/harness/extension/execution-environment/undo-log.js +31 -10
  131. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
  132. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  133. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  134. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  135. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  136. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  137. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  138. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  139. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  140. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  141. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  142. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  143. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  144. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  146. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  147. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  148. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  149. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  150. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  151. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  152. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  153. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  154. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  155. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  156. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  157. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
  159. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
  160. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
  161. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
  162. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  163. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  164. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  165. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  166. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  167. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  168. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
  169. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
  171. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
  172. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
  173. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
  174. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
  175. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  176. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  177. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  178. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  180. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +17 -24
  181. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
  182. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
  183. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
  186. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
  187. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
  188. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
  189. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
  190. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  192. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  193. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
  194. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  195. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  196. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  197. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  198. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  199. package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
  200. package/dist/harness/governance/security/default-risk-policy.js +1 -0
  201. package/dist/harness/governance/security/default-security-guard.js +9 -0
  202. package/dist/harness/governance/security/index.d.ts +1 -0
  203. package/dist/harness/governance/security/index.js +2 -0
  204. package/dist/harness/governance/security/risk-evaluator.js +13 -0
  205. package/dist/harness/governance/security/risk-types.d.ts +12 -0
  206. package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
  207. package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
  208. package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
  209. package/dist/harness/governance/security/shell-parser-shared.js +188 -0
  210. package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
  211. package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
  212. package/dist/harness/governance/security/shell-parser.d.ts +23 -10
  213. package/dist/harness/governance/security/shell-parser.js +37 -496
  214. package/dist/harness/governance/security/vendor/README.md +24 -0
  215. package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
  216. package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
  217. package/dist/harness/index.d.ts +12 -12
  218. package/dist/harness/index.js +7 -7
  219. package/dist/harness/knowledge/boot-config.d.ts +55 -0
  220. package/dist/harness/knowledge/boot-config.js +50 -0
  221. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  222. package/dist/harness/knowledge/client.d.ts +24 -2
  223. package/dist/harness/knowledge/client.js +19 -5
  224. package/dist/harness/knowledge/db.js +5 -0
  225. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  226. package/dist/harness/knowledge/describe-sample.js +58 -0
  227. package/dist/harness/knowledge/describe.d.ts +8 -0
  228. package/dist/harness/knowledge/describe.js +18 -2
  229. package/dist/harness/knowledge/engine-thread.js +6 -0
  230. package/dist/harness/knowledge/grounding.js +3 -1
  231. package/dist/harness/knowledge/http-app.js +35 -4
  232. package/dist/harness/knowledge/http-params.d.ts +18 -0
  233. package/dist/harness/knowledge/http-params.js +24 -0
  234. package/dist/harness/knowledge/index.d.ts +2 -0
  235. package/dist/harness/knowledge/index.js +1 -0
  236. package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
  237. package/dist/harness/knowledge/purge.js +5 -2
  238. package/dist/harness/knowledge/query-service.d.ts +13 -2
  239. package/dist/harness/knowledge/query-service.js +4 -2
  240. package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
  241. package/dist/harness/knowledge/query-worker-client.js +4 -2
  242. package/dist/harness/knowledge/query-worker.js +4 -2
  243. package/dist/harness/knowledge/read-http.js +5 -1
  244. package/dist/harness/knowledge/serve.d.ts +8 -7
  245. package/dist/harness/knowledge/serve.js +9 -0
  246. package/dist/harness/knowledge/source-store.js +26 -3
  247. package/dist/harness/knowledge/start-service-process.d.ts +15 -7
  248. package/dist/harness/knowledge/start-service-process.js +21 -9
  249. package/dist/harness/knowledge/types.d.ts +7 -0
  250. package/dist/harness/knowledge/writer-service.d.ts +37 -9
  251. package/dist/harness/knowledge/writer-service.js +120 -14
  252. package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
  253. package/dist/harness/knowledge/writer-worker-client.js +20 -2
  254. package/dist/harness/knowledge/writer-worker.js +9 -1
  255. package/dist/harness/memory/index.d.ts +6 -2
  256. package/dist/harness/memory/index.js +4 -1
  257. package/dist/harness/memory/memory-events.d.ts +25 -0
  258. package/dist/harness/memory/memory-events.js +38 -0
  259. package/dist/harness/memory/sqlite/agent-db.js +15 -0
  260. package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
  261. package/dist/harness/memory/sqlite/wisdom-store.js +86 -12
  262. package/dist/harness/memory/steward-policy.d.ts +3 -0
  263. package/dist/harness/memory/steward-policy.js +1 -1
  264. package/dist/harness/memory/types.d.ts +47 -7
  265. package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
  266. package/dist/harness/memory/wisdom-attribution.js +287 -0
  267. package/dist/harness/memory/wisdom-events.d.ts +37 -0
  268. package/dist/harness/memory/wisdom-events.js +61 -0
  269. package/dist/harness/memory/wisdom-formation.d.ts +31 -1
  270. package/dist/harness/memory/wisdom-formation.js +130 -33
  271. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  272. package/dist/harness/memory/wisdom-gates.js +59 -19
  273. package/dist/harness/memory/wisdom.d.ts +7 -2
  274. package/dist/harness/memory/wisdom.js +49 -2
  275. package/dist/harness/observability/observer/hub.js +25 -15
  276. package/dist/harness/observability/observer/types.d.ts +10 -6
  277. package/dist/harness/run/agent/agent.d.ts +40 -21
  278. package/dist/harness/run/agent/agent.js +66 -13
  279. package/dist/harness/run/agent/index.d.ts +1 -1
  280. package/dist/harness/run/budget/budget.d.ts +28 -10
  281. package/dist/harness/run/budget/budget.js +38 -15
  282. package/dist/harness/run/model/index.d.ts +3 -1
  283. package/dist/harness/run/model/index.js +2 -1
  284. package/dist/harness/run/model/resolver.d.ts +4 -1
  285. package/dist/harness/run/model/resolver.js +36 -2
  286. package/dist/harness/run/model/run-scope.d.ts +2 -0
  287. package/dist/harness/run/model/run-scope.js +7 -0
  288. package/dist/harness/run/model/types.d.ts +22 -5
  289. package/dist/harness/run/model/types.js +3 -2
  290. package/dist/harness/run/model/window-truth.d.ts +37 -0
  291. package/dist/harness/run/model/window-truth.js +39 -0
  292. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  293. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  294. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  295. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  296. package/dist/harness/run/reliability/run-agent.d.ts +10 -4
  297. package/dist/harness/run/reliability/run-agent.js +137 -53
  298. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  299. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  300. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  301. package/dist/harness/run/run-scope.d.ts +41 -4
  302. package/dist/harness/run/runner.d.ts +71 -31
  303. package/dist/harness/run/runner.js +368 -106
  304. package/dist/harness/session/attachments/index.d.ts +1 -0
  305. package/dist/harness/session/attachments/index.js +1 -0
  306. package/dist/harness/session/attachments/inject.d.ts +21 -10
  307. package/dist/harness/session/attachments/inject.js +76 -24
  308. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  309. package/dist/harness/session/attachments/recall-index.js +219 -0
  310. package/dist/harness/session/attachments/service.d.ts +21 -0
  311. package/dist/harness/session/attachments/service.js +258 -139
  312. package/dist/harness/session/attachments/types.d.ts +6 -0
  313. package/dist/harness/session/transform-store.d.ts +136 -0
  314. package/dist/harness/session/transform-store.js +302 -0
  315. package/dist/harness/session/types.d.ts +2 -2
  316. package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
  317. package/dist/harness/shared/events/agent-event-map.js +3 -2
  318. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  319. package/dist/harness/shared/paths/glob.d.ts +52 -0
  320. package/dist/harness/shared/paths/glob.js +218 -0
  321. package/dist/harness/shared/paths/index.d.ts +84 -0
  322. package/dist/harness/shared/paths/index.js +179 -0
  323. package/dist/harness/shared/types/agent-definition.d.ts +1 -2
  324. package/dist/index.d.ts +14 -17
  325. package/dist/index.js +7 -9
  326. package/dist/integration/observability/metrics.d.ts +6 -6
  327. package/dist/integration/observability/metrics.js +13 -13
  328. package/dist/integration/observability/observer-bridge.js +2 -2
  329. package/dist/integration/observability/trace-collector.d.ts +5 -5
  330. package/dist/integration/observability/trace-collector.js +34 -35
  331. package/dist/integration/observability/trace-events.d.ts +3 -3
  332. package/dist/integration/observability/trace-events.js +3 -3
  333. package/dist/integration/providers/anthropic.js +14 -1
  334. package/dist/integration/providers/openai.js +7 -1
  335. package/dist/integration/providers/usage.d.ts +1 -1
  336. package/dist/integration/providers/wire-dump.d.ts +1 -1
  337. package/dist/integration/storage/archive-manager.d.ts +6 -0
  338. package/dist/integration/storage/archive-manager.js +10 -0
  339. package/dist/integration/storage/jsonl.d.ts +1 -1
  340. package/dist/integration/storage/jsonl.js +18 -16
  341. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
  342. package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
  343. package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
  344. package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
  345. package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
  346. package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
  347. package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
  348. package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
  349. package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
  350. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  351. package/dist/subsystems/wisdom-steward/formation/config.yaml +13 -5
  352. package/dist/subsystems/wisdom-steward/formation/handler.js +39 -23
  353. package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
  354. package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
  355. package/package.json +16 -14
  356. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  357. package/dist/harness/context/hybrid-compressor.js +0 -159
  358. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  359. package/dist/harness/context/llm-summarizer.js +0 -249
  360. package/dist/harness/context/smart-router.d.ts +0 -75
  361. package/dist/harness/context/smart-router.js +0 -118
  362. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  363. package/dist/harness/context/truncate-compressor.js +0 -107
  364. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  365. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  366. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  367. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  368. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  369. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -4,6 +4,7 @@
4
4
  * @layer harness/memory — Context Intelligence 存储协议。
5
5
  * 实现:InMemory* / Sqlite*(AgentDatabase)。非 Kernel。
6
6
  */
7
+ import type { WisdomEvaluationConfig } from './wisdom-policy.js';
7
8
  /**
8
9
  * 记忆类型 — 蒸馏产物三类(见 docs/memory.md)
9
10
  *
@@ -205,7 +206,7 @@ export interface WisdomEntry {
205
206
  updatedAt: number;
206
207
  }
207
208
  /** 出生门控 reason */
208
- export type WisdomGateReason = 'ok' | 'empty_statement' | 'statement_too_long' | 'empty_problem_types' | 'empty_effect' | 'secret_like' | 'persona_overwrite' | 'insufficient_support' | 'duplicate_statement' | 'semantic_conflict' | 'capacity_admit_stop' | 'invalid_status' | 'invalid_origin' | 'invalid_kind' | 'missing_derived_from' | 'unknown_derived_id' | 'supersedes_target_missing';
209
+ export type WisdomGateReason = 'ok' | 'empty_statement' | 'statement_too_long' | 'empty_problem_types' | 'empty_effect' | 'secret_like' | 'persona_overwrite' | 'insufficient_support' | 'duplicate_statement' | 'semantic_conflict' | 'capacity_admit_stop' | 'invalid_status' | 'invalid_origin' | 'invalid_kind' | 'missing_derived_from' | 'unknown_derived_id' | 'supersedes_target_missing' | 'supersedes_target_invalid';
209
210
  export interface WisdomGateOutcome {
210
211
  ok: boolean;
211
212
  reason: WisdomGateReason;
@@ -243,14 +244,16 @@ export interface WisdomInjectQuery {
243
244
  coreMaxItems?: number;
244
245
  /** 场景条数硬顶 */
245
246
  scenarioMaxItems?: number;
246
- /** 是否包含 trial(默认 false) */
247
+ /** trial 轮转试用名额硬顶(默认 2——保证 trial 有机会积累 applied 以晋升;0 关闭轮转) */
248
+ trialMaxItems?: number;
249
+ /** 是否包含 trial(默认 true——trial 的意义就是被试用;显式 false 只注入已站稳条目) */
247
250
  includeTrial?: boolean;
248
251
  }
249
252
  export interface WisdomInjectPick {
250
253
  entry: WisdomEntry;
251
- /** core = 常备小核心;scenario = 本轮匹配 */
252
- bucket: 'core' | 'scenario';
253
- /** 场景匹配分(core 为 1) */
254
+ /** core = 常备小核心;scenario = 本轮匹配;trial = 轮转试用名额 */
255
+ bucket: 'core' | 'scenario' | 'trial';
256
+ /** 场景匹配分(core 为 1;trial 轮转为场景分,可为 0) */
254
257
  score: number;
255
258
  }
256
259
  export type WisdomOutcomeSignal = 'applied' | 'cited' | 'assisted' | 'contested' | 'ignored';
@@ -262,6 +265,30 @@ export interface WisdomOutcomeEvent {
262
265
  note?: string;
263
266
  ref?: string;
264
267
  }
268
+ /** 归因窗口中的一处引用摘录(判官强证据) */
269
+ export interface WisdomAttributionCitation {
270
+ wisdomId: string;
271
+ excerpt: string;
272
+ }
273
+ /** 归因窗口输入(run 收尾记账) */
274
+ export interface WisdomAttributionWindowInput {
275
+ sessionId: string;
276
+ agentId?: string;
277
+ /** 本轮任务/查询文本(判官 digest 证据) */
278
+ query: string;
279
+ /** run 收尾原因(completed/aborted/error…)——仅作判官上下文,不作判决 */
280
+ outcome: string;
281
+ /** 本轮注入的 wisdom id(装配 manifest sources) */
282
+ injectedIds: string[];
283
+ citations: WisdomAttributionCitation[];
284
+ }
285
+ /** 归因窗口:弱归因验证的记账单位(run 收尾 → 判官批量判决) */
286
+ export interface WisdomAttributionWindow extends WisdomAttributionWindowInput {
287
+ id: string;
288
+ createdAt: number;
289
+ /** 缺省 = 未判决 */
290
+ judgedAt?: number;
291
+ }
265
292
  export interface WisdomStats {
266
293
  total: number;
267
294
  byStatus: Record<WisdomStatus, number>;
@@ -292,10 +319,23 @@ export interface WisdomStore {
292
319
  by: string;
293
320
  reason: WisdomRetireReason | string;
294
321
  }): Promise<void>;
295
- /** 弱归因结局入账 */
296
- recordOutcomes(events: WisdomOutcomeEvent[]): Promise<void>;
322
+ /** 弱归因结局入账(含 confidence/状态迁移);config 缺省用默认评估参数 */
323
+ recordOutcomes(events: WisdomOutcomeEvent[], config?: WisdomEvaluationConfig): Promise<void>;
297
324
  /** 注入命中轻量入账(S1 applied);不跑 confidence 规划 */
298
325
  touchApplied(ids: string[]): Promise<void>;
326
+ /** 归因窗口:run 收尾记账;返回窗口 id */
327
+ recordAttributionWindow(input: WisdomAttributionWindowInput): Promise<string>;
328
+ /** 未判决窗口(判官取件;createdAt 升序;缺省上限 500,两实现一致) */
329
+ listPendingWindows(limit?: number): Promise<WisdomAttributionWindow[]>;
330
+ /**
331
+ * 标记窗口已判决(`judged_at IS NULL` 原子标记;先标记后发判决事件:宁丢勿重)。
332
+ *
333
+ * @returns 本次真正被标记的 id(已被他方标记的不在内——调用方只对返回集发
334
+ *判决事件,构成跨进程幂等)
335
+ */
336
+ markWindowsJudged(ids: string[], at?: number): Promise<string[]>;
337
+ /** 清理 judgedAt 早于 before 的旧窗口(保留期外) */
338
+ pruneWindows(before: number): Promise<void>;
299
339
  stats(): Promise<WisdomStats>;
300
340
  }
301
341
  /** 概念种类 — 基本层级偏置 */
@@ -0,0 +1,136 @@
1
+ /**
2
+ * Wisdom 归因窗口 — 弱归因验证的记账、取证与判官准备(arch/wisdom-layer-formation.md §7)
3
+ *
4
+ * 分工纪律:代码只做记账 / 取证 / 候选路由;`assisted` / `contested` 判决只出自
5
+ * LLM 判官(wisdom.steward.attribute,digest 批量判决);evaluate 只做入账与状态迁移。
6
+ * 禁止把「任务成功」当「这条有功」——结局标志位只是判官的上下文,不是判决。
7
+ *
8
+ * @module harness/memory/wisdom-attribution
9
+ */
10
+ import type { Message } from '@octopi-agent/core/types.js';
11
+ import type { WisdomAttributionCitation, WisdomAttributionWindow, WisdomEntry, WisdomOutcomeEvent, WisdomStore } from './types.js';
12
+ /** run 收尾记账输入(Runner 钩子) */
13
+ export interface WisdomRunWindowInfo {
14
+ sessionId: string;
15
+ agentId?: string;
16
+ /** run 收尾原因(completed/aborted/error…)——仅作判官上下文 */
17
+ outcome: string;
18
+ /** 本轮任务/查询文本 */
19
+ query: string;
20
+ /** 本轮注入的 wisdom id(装配 manifest sources) */
21
+ injectedIds: string[];
22
+ /** 本轮产出的 assistant 文本(引用摘录来源) */
23
+ assistantTexts: string[];
24
+ }
25
+ /** 判决候选(窗口 × 条目)及其路由 */
26
+ export interface AttributionCandidate {
27
+ window: WisdomAttributionWindow;
28
+ entry: WisdomEntry;
29
+ /** cited=显式引用;scenario=场景命中;sampled=core 常驻抽样(可选证据) */
30
+ route: 'cited' | 'scenario' | 'sampled';
31
+ }
32
+ /** 判官输出的单条判决(pair 为 digest 中的序号,从 1 起) */
33
+ export interface AttributionVerdict {
34
+ pair: number;
35
+ verdict: 'assisted' | 'contested' | 'unclear';
36
+ reason?: string;
37
+ }
38
+ /** 批次装箱结果(窗口原子:必判对整窗进或整窗退) */
39
+ export interface AttributionBatch {
40
+ /** 进 digest 的候选(必判在前,抽样在后) */
41
+ selected: AttributionCandidate[];
42
+ /** 预算不足被整窗推迟的窗口(保持 pending,下批再判) */
43
+ deferredWindowIds: string[];
44
+ /** 判无可判或抽样未中的窗口(按设计直接关闭,不产生事件) */
45
+ closableWindowIds: string[];
46
+ }
47
+ /**
48
+ * 收集本轮新增 assistant 文本(引用摘录来源)。
49
+ *
50
+ * @param messages - 会话消息(含历史 + 本轮新增)
51
+ * @param base - 本轮新增消息的起始下标(装配时抓取的 messages.length)
52
+ * @returns 本轮 assistant 纯文本(非空)
53
+ */
54
+ export declare function collectRunAssistantTexts(messages: Message[], base: number): string[];
55
+ /**
56
+ * 从 assistant 文本提取范式引用摘录。
57
+ *
58
+ * @param texts - 本轮 assistant 文本
59
+ * @param entries - 本轮注入的条目(id + statement)
60
+ * @returns 每条被引用条目一处摘录(id 字面命中,或 statement 整句/长前缀命中)
61
+ */
62
+ export declare function extractCitations(texts: string[], entries: Array<Pick<WisdomEntry, 'id' | 'statement'>>): WisdomAttributionCitation[];
63
+ /**
64
+ * run 收尾记账:取注入条目 → 提取引用摘录 → 落窗口。
65
+ *
66
+ * @param store - WisdomStore
67
+ * @param info - run 收尾信息
68
+ * @returns 窗口 id;本轮无注入时返回 null(不落窗口)
69
+ */
70
+ export declare function recordWisdomRunWindow(store: WisdomStore, info: WisdomRunWindowInfo): Promise<string | null>;
71
+ /**
72
+ * 候选路由:cited / scenario 命中必判;core 常驻只抽样。
73
+ *
74
+ * 注入时的命中可由 (entry, window.query) 确定性重算(同一 matcher、同一 query),
75
+ * 无需在窗口里冗余记录 bucket。终态条目(retired/superseded/candidate)不进候选。
76
+ *
77
+ * @param windows - 未判决窗口
78
+ * @param entries - 条目全集(含终态,内部过滤)
79
+ * @param options - sampleMax 抽样上限(缺省 2)
80
+ * @returns 判决候选(必判在前,抽样在后)
81
+ */
82
+ export declare function selectAttributionCandidates(windows: WisdomAttributionWindow[], entries: WisdomEntry[], options?: {
83
+ sampleMax?: number;
84
+ }): AttributionCandidate[];
85
+ /**
86
+ * 批次装箱(窗口原子):必判对整窗进或整窗退,被 maxPairs 裁掉的窗口保持 pending;
87
+ * 抽样对是可选证据,预算有余才带,未中即按设计丢弃(不悬挂)。
88
+ *
89
+ * @param windows - 未判决窗口
90
+ * @param entries - 条目全集
91
+ * @param options - sampleMax / maxPairs
92
+ * @returns 装箱结果(selected + deferred + closable)
93
+ */
94
+ export declare function planAttributionBatch(windows: WisdomAttributionWindow[], entries: WisdomEntry[], options?: {
95
+ sampleMax?: number;
96
+ maxPairs?: number;
97
+ }): AttributionBatch;
98
+ /**
99
+ * 构建判官 digest(每候选一小块)与 pair 序号映射。
100
+ *
101
+ * @param candidates - 判决候选
102
+ * @returns digest 文本 + P{n} → (windowId, wisdomId)
103
+ */
104
+ export declare function buildAttributionDigest(candidates: AttributionCandidate[]): {
105
+ text: string;
106
+ pairRefs: Array<{
107
+ windowId: string;
108
+ wisdomId: string;
109
+ }>;
110
+ };
111
+ /**
112
+ * 从 LLM 文本提取判决 JSON `{items: [{pair, verdict, reason}]}`。
113
+ *
114
+ * 覆盖率是硬契约:expectedPairs 中每个 pair **恰好一条**判决(unclear 也算判决,
115
+ * 必须显式给出);缺项、重复、越界、空 items 一律视为解析失败(null)——
116
+ * 半截/退化输出不得当业务结果,宁可整批失败重试也不静默吞窗口。
117
+ *
118
+ * @param text - LLM 输出
119
+ * @param expectedPairs - 期望的 pair 序号(1 起)
120
+ * @returns 解析结果或 null(覆盖率不符)
121
+ */
122
+ export declare function parseAttributionVerdicts(text: string, expectedPairs: number[]): {
123
+ items: AttributionVerdict[];
124
+ } | null;
125
+ /**
126
+ * 判决 → 弱归因结局事件(unclear 不入账——宁可不更新也不污染)。
127
+ *
128
+ * @param items - 判官判决(已过覆盖率校验)
129
+ * @param pairRefs - digest 序号映射
130
+ * @param now - 时间戳
131
+ * @returns assisted/contested 事件(ref=窗口 id)
132
+ */
133
+ export declare function verdictsToOutcomeEvents(items: AttributionVerdict[], pairRefs: Array<{
134
+ windowId: string;
135
+ wisdomId: string;
136
+ }>, now?: number): WisdomOutcomeEvent[];
@@ -0,0 +1,287 @@
1
+ /**
2
+ * Wisdom 归因窗口 — 弱归因验证的记账、取证与判官准备(arch/wisdom-layer-formation.md §7)
3
+ *
4
+ * 分工纪律:代码只做记账 / 取证 / 候选路由;`assisted` / `contested` 判决只出自
5
+ * LLM 判官(wisdom.steward.attribute,digest 批量判决);evaluate 只做入账与状态迁移。
6
+ * 禁止把「任务成功」当「这条有功」——结局标志位只是判官的上下文,不是判决。
7
+ *
8
+ * @module harness/memory/wisdom-attribution
9
+ */
10
+ import { messageText } from '../context/turn-envelope.js';
11
+ import { scenarioMatchDetail } from './wisdom-formation.js';
12
+ /** 引用摘录上下文半宽(命中点前后各取的字符数) */
13
+ const CITATION_EXCERPT_HALF = 160;
14
+ /** statement 命中的最短前缀长度(放宽引用识别:整句或长前缀皆算) */
15
+ const CITATION_STATEMENT_PREFIX_MIN = 12;
16
+ /**
17
+ * 收集本轮新增 assistant 文本(引用摘录来源)。
18
+ *
19
+ * @param messages - 会话消息(含历史 + 本轮新增)
20
+ * @param base - 本轮新增消息的起始下标(装配时抓取的 messages.length)
21
+ * @returns 本轮 assistant 纯文本(非空)
22
+ */
23
+ export function collectRunAssistantTexts(messages, base) {
24
+ return messages
25
+ .slice(Math.max(0, base))
26
+ .filter((m) => m.role === 'assistant')
27
+ .map((m) => messageText(m.content))
28
+ .filter((t) => t.trim().length > 0);
29
+ }
30
+ /**
31
+ * 从 assistant 文本提取范式引用摘录。
32
+ *
33
+ * @param texts - 本轮 assistant 文本
34
+ * @param entries - 本轮注入的条目(id + statement)
35
+ * @returns 每条被引用条目一处摘录(id 字面命中,或 statement 整句/长前缀命中)
36
+ */
37
+ export function extractCitations(texts, entries) {
38
+ const out = [];
39
+ for (const e of entries) {
40
+ for (const t of texts) {
41
+ const idIdx = t.indexOf(e.id);
42
+ // statement 命中放宽到长前缀(整句或 ≥12 字符前缀):允许部分引用
43
+ const stmtNeedle = e.statement.length >= CITATION_STATEMENT_PREFIX_MIN
44
+ ? e.statement
45
+ : e.statement.slice(0, CITATION_STATEMENT_PREFIX_MIN);
46
+ const stmtIdx = t.indexOf(stmtNeedle);
47
+ const idx = idIdx >= 0 ? idIdx : stmtIdx;
48
+ if (idx < 0)
49
+ continue;
50
+ const matchedLen = idIdx >= 0 ? e.id.length : stmtNeedle.length;
51
+ const start = Math.max(0, idx - CITATION_EXCERPT_HALF);
52
+ const end = Math.min(t.length, idx + matchedLen + CITATION_EXCERPT_HALF);
53
+ out.push({ wisdomId: e.id, excerpt: t.slice(start, end) });
54
+ break;
55
+ }
56
+ }
57
+ return out;
58
+ }
59
+ /**
60
+ * run 收尾记账:取注入条目 → 提取引用摘录 → 落窗口。
61
+ *
62
+ * @param store - WisdomStore
63
+ * @param info - run 收尾信息
64
+ * @returns 窗口 id;本轮无注入时返回 null(不落窗口)
65
+ */
66
+ export async function recordWisdomRunWindow(store, info) {
67
+ const ids = [...new Set(info.injectedIds)].filter(Boolean);
68
+ if (ids.length === 0)
69
+ return null;
70
+ const all = await store.listForGovern({ includeRetired: true });
71
+ const byId = new Map(all.map((e) => [e.id, e]));
72
+ const entries = ids
73
+ .map((id) => byId.get(id))
74
+ .filter((e) => e !== undefined);
75
+ if (entries.length === 0)
76
+ return null;
77
+ return store.recordAttributionWindow({
78
+ sessionId: info.sessionId,
79
+ agentId: info.agentId,
80
+ query: info.query,
81
+ outcome: info.outcome,
82
+ injectedIds: entries.map((e) => e.id),
83
+ citations: extractCitations(info.assistantTexts, entries),
84
+ });
85
+ }
86
+ /**
87
+ * 候选路由:cited / scenario 命中必判;core 常驻只抽样。
88
+ *
89
+ * 注入时的命中可由 (entry, window.query) 确定性重算(同一 matcher、同一 query),
90
+ * 无需在窗口里冗余记录 bucket。终态条目(retired/superseded/candidate)不进候选。
91
+ *
92
+ * @param windows - 未判决窗口
93
+ * @param entries - 条目全集(含终态,内部过滤)
94
+ * @param options - sampleMax 抽样上限(缺省 2)
95
+ * @returns 判决候选(必判在前,抽样在后)
96
+ */
97
+ export function selectAttributionCandidates(windows, entries, options) {
98
+ const byId = new Map(entries.map((e) => [e.id, e]));
99
+ const sampleMax = options?.sampleMax ?? 2;
100
+ const mandatory = [];
101
+ const sampled = [];
102
+ for (const w of windows) {
103
+ for (const id of w.injectedIds) {
104
+ const entry = byId.get(id);
105
+ if (!entry)
106
+ continue;
107
+ if (entry.status === 'retired' || entry.status === 'superseded' || entry.status === 'candidate') {
108
+ continue;
109
+ }
110
+ const cited = w.citations.some((c) => c.wisdomId === id);
111
+ const scenarioHit = scenarioMatchDetail(entry, w.query).score > 0;
112
+ if (cited)
113
+ mandatory.push({ window: w, entry, route: 'cited' });
114
+ else if (scenarioHit)
115
+ mandatory.push({ window: w, entry, route: 'scenario' });
116
+ else
117
+ sampled.push({ window: w, entry, route: 'sampled' });
118
+ }
119
+ }
120
+ return [...mandatory, ...sampled.slice(0, sampleMax)];
121
+ }
122
+ /**
123
+ * 批次装箱(窗口原子):必判对整窗进或整窗退,被 maxPairs 裁掉的窗口保持 pending;
124
+ * 抽样对是可选证据,预算有余才带,未中即按设计丢弃(不悬挂)。
125
+ *
126
+ * @param windows - 未判决窗口
127
+ * @param entries - 条目全集
128
+ * @param options - sampleMax / maxPairs
129
+ * @returns 装箱结果(selected + deferred + closable)
130
+ */
131
+ export function planAttributionBatch(windows, entries, options) {
132
+ const cands = selectAttributionCandidates(windows, entries, {
133
+ sampleMax: options?.sampleMax,
134
+ });
135
+ const byWindow = new Map();
136
+ for (const c of cands) {
137
+ const list = byWindow.get(c.window.id) ?? [];
138
+ list.push(c);
139
+ byWindow.set(c.window.id, list);
140
+ }
141
+ const budget = options?.maxPairs ?? 40;
142
+ const selected = [];
143
+ const deferredWindowIds = [];
144
+ const closableWindowIds = [];
145
+ for (const w of windows) {
146
+ const list = byWindow.get(w.id) ?? [];
147
+ const mandatory = list.filter((c) => c.route !== 'sampled');
148
+ const optional = list.filter((c) => c.route === 'sampled');
149
+ if (mandatory.length === 0) {
150
+ // 无必判对:抽样有余量就带上(带了就要判),没抽中按设计关闭
151
+ let took = false;
152
+ for (const o of optional) {
153
+ if (selected.length >= budget)
154
+ break;
155
+ selected.push(o);
156
+ took = true;
157
+ }
158
+ if (!took)
159
+ closableWindowIds.push(w.id);
160
+ continue;
161
+ }
162
+ if (selected.length + mandatory.length > budget) {
163
+ deferredWindowIds.push(w.id);
164
+ continue;
165
+ }
166
+ selected.push(...mandatory);
167
+ for (const o of optional) {
168
+ if (selected.length >= budget)
169
+ break;
170
+ selected.push(o);
171
+ }
172
+ }
173
+ return { selected, deferredWindowIds, closableWindowIds };
174
+ }
175
+ /**
176
+ * 构建判官 digest(每候选一小块)与 pair 序号映射。
177
+ *
178
+ * @param candidates - 判决候选
179
+ * @returns digest 文本 + P{n} → (windowId, wisdomId)
180
+ */
181
+ export function buildAttributionDigest(candidates) {
182
+ const pairRefs = [];
183
+ const blocks = [];
184
+ candidates.forEach((c, i) => {
185
+ pairRefs.push({ windowId: c.window.id, wisdomId: c.entry.id });
186
+ const excerpts = c.window.citations
187
+ .filter((x) => x.wisdomId === c.entry.id)
188
+ .slice(0, 2)
189
+ .map((x) => x.excerpt.slice(0, 400));
190
+ blocks.push([
191
+ `### P${i + 1} [${c.entry.id}]`,
192
+ `范式: ${c.entry.statement.slice(0, 240)}`,
193
+ `场景: ${c.entry.scenario.problemTypes.join('、') || '(无)'}` +
194
+ ` / 信号: ${(c.entry.scenario.signals ?? []).join('、') || '(无)'}`,
195
+ `任务: ${c.window.query.slice(0, 120) || '(无)'} | 结局: ${c.window.outcome} | 路由: ${c.route}`,
196
+ `引用摘录: ${excerpts.length ? excerpts.join('\n---\n') : '(无)'}`,
197
+ ].join('\n'));
198
+ });
199
+ return { text: blocks.join('\n\n'), pairRefs };
200
+ }
201
+ /**
202
+ * 从 LLM 文本提取判决 JSON `{items: [{pair, verdict, reason}]}`。
203
+ *
204
+ * 覆盖率是硬契约:expectedPairs 中每个 pair **恰好一条**判决(unclear 也算判决,
205
+ * 必须显式给出);缺项、重复、越界、空 items 一律视为解析失败(null)——
206
+ * 半截/退化输出不得当业务结果,宁可整批失败重试也不静默吞窗口。
207
+ *
208
+ * @param text - LLM 输出
209
+ * @param expectedPairs - 期望的 pair 序号(1 起)
210
+ * @returns 解析结果或 null(覆盖率不符)
211
+ */
212
+ export function parseAttributionVerdicts(text, expectedPairs) {
213
+ const start = text.indexOf('{');
214
+ if (start === -1)
215
+ return null;
216
+ const end = text.lastIndexOf('}');
217
+ if (end <= start)
218
+ return null;
219
+ let parsed;
220
+ try {
221
+ parsed = JSON.parse(text.slice(start, end + 1));
222
+ }
223
+ catch {
224
+ return null;
225
+ }
226
+ if (!Array.isArray(parsed.items))
227
+ return null;
228
+ const byPair = new Map();
229
+ for (const raw of parsed.items) {
230
+ const item = raw;
231
+ if (typeof item.pair !== 'number' || !Number.isInteger(item.pair) || item.pair < 1)
232
+ return null;
233
+ if (item.verdict !== 'assisted' && item.verdict !== 'contested' && item.verdict !== 'unclear') {
234
+ return null;
235
+ }
236
+ if (byPair.has(item.pair))
237
+ return null; // 重复 pair:冲突判决不可信
238
+ byPair.set(item.pair, {
239
+ pair: item.pair,
240
+ verdict: item.verdict,
241
+ reason: typeof item.reason === 'string' ? item.reason.slice(0, 300) : undefined,
242
+ });
243
+ }
244
+ // 覆盖率:期望 pair 每个恰好一条,不允许缺项/多项
245
+ if (byPair.size !== expectedPairs.length)
246
+ return null;
247
+ const items = [];
248
+ for (const pair of expectedPairs) {
249
+ const v = byPair.get(pair);
250
+ if (!v)
251
+ return null;
252
+ items.push(v);
253
+ }
254
+ return { items };
255
+ }
256
+ /**
257
+ * 判决 → 弱归因结局事件(unclear 不入账——宁可不更新也不污染)。
258
+ *
259
+ * @param items - 判官判决(已过覆盖率校验)
260
+ * @param pairRefs - digest 序号映射
261
+ * @param now - 时间戳
262
+ * @returns assisted/contested 事件(ref=窗口 id)
263
+ */
264
+ export function verdictsToOutcomeEvents(items, pairRefs, now = Date.now()) {
265
+ const seen = new Set();
266
+ const out = [];
267
+ for (const v of items) {
268
+ if (v.verdict === 'unclear')
269
+ continue;
270
+ const ref = pairRefs[v.pair - 1];
271
+ if (!ref)
272
+ continue;
273
+ // (windowId, wisdomId, signal) 幂等:同一次证据绝不重复入账
274
+ const key = `${ref.windowId}|${ref.wisdomId}|${v.verdict}`;
275
+ if (seen.has(key))
276
+ continue;
277
+ seen.add(key);
278
+ out.push({
279
+ wisdomId: ref.wisdomId,
280
+ signal: v.verdict,
281
+ at: now,
282
+ note: v.reason,
283
+ ref: ref.windowId,
284
+ });
285
+ }
286
+ return out;
287
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Wisdom 判决信号 — 判官产出的弱归因结局事件 → `wisdom.steward.evaluate.request`
3
+ *
4
+ * 消费方(sense.filter.events 订阅):wisdom.steward.evaluate(入账 + 状态迁移)。
5
+ * 事件类型必须真实存在于 EventBus;发射失败静默(不得阻断判官主流程,窗口已标记
6
+ * judged,宁丢勿重)。
7
+ *
8
+ * @module harness/memory/wisdom-events
9
+ */
10
+ import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
11
+ import type { WisdomOutcomeEvent } from './types.js';
12
+ /** 弱归因结局入账请求(判官批量判决产物) */
13
+ export declare const WISDOM_EVALUATE_REQUEST_EVENT = "wisdom.steward.evaluate.request";
14
+ /** 治理脉搏(govern 每轮完成;判官等维护动作挂此脉搏) */
15
+ export declare const WISDOM_GOVERNED_EVENT = "wisdom.steward.governed";
16
+ /**
17
+ * 发射治理脉搏信号。失败静默(不得阻断 govern 主流程)。
18
+ *
19
+ * @param events - EventBus
20
+ * @param payload - 载荷(可选 agentId/sessionId)
21
+ */
22
+ export declare function emitWisdomGoverned(events: EventBus | undefined, payload?: {
23
+ agentId?: string;
24
+ sessionId?: string;
25
+ }): void;
26
+ export interface WisdomEvaluateRequestPayload {
27
+ events: WisdomOutcomeEvent[];
28
+ agentId?: string;
29
+ sessionId?: string;
30
+ }
31
+ /**
32
+ * 发射弱归因结局入账请求。失败静默(不得阻断判官;窗口已 judged,宁丢勿重)。
33
+ *
34
+ * @param events - EventBus
35
+ * @param payload - 结局事件集
36
+ */
37
+ export declare function emitWisdomEvaluateRequest(events: EventBus | undefined, payload: WisdomEvaluateRequestPayload): void;
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Wisdom 判决信号 — 判官产出的弱归因结局事件 → `wisdom.steward.evaluate.request`
3
+ *
4
+ * 消费方(sense.filter.events 订阅):wisdom.steward.evaluate(入账 + 状态迁移)。
5
+ * 事件类型必须真实存在于 EventBus;发射失败静默(不得阻断判官主流程,窗口已标记
6
+ * judged,宁丢勿重)。
7
+ *
8
+ * @module harness/memory/wisdom-events
9
+ */
10
+ /** 弱归因结局入账请求(判官批量判决产物) */
11
+ export const WISDOM_EVALUATE_REQUEST_EVENT = 'wisdom.steward.evaluate.request';
12
+ /** 治理脉搏(govern 每轮完成;判官等维护动作挂此脉搏) */
13
+ export const WISDOM_GOVERNED_EVENT = 'wisdom.steward.governed';
14
+ /**
15
+ * 发射治理脉搏信号。失败静默(不得阻断 govern 主流程)。
16
+ *
17
+ * @param events - EventBus
18
+ * @param payload - 载荷(可选 agentId/sessionId)
19
+ */
20
+ export function emitWisdomGoverned(events, payload) {
21
+ if (!events)
22
+ return;
23
+ try {
24
+ events.emit({
25
+ type: WISDOM_GOVERNED_EVENT,
26
+ timestamp: Date.now(),
27
+ agentId: payload?.agentId,
28
+ sessionId: payload?.sessionId,
29
+ data: { at: Date.now() },
30
+ });
31
+ }
32
+ catch {
33
+ // 总线异常不得拖垮 govern
34
+ }
35
+ }
36
+ /**
37
+ * 发射弱归因结局入账请求。失败静默(不得阻断判官;窗口已 judged,宁丢勿重)。
38
+ *
39
+ * @param events - EventBus
40
+ * @param payload - 结局事件集
41
+ */
42
+ export function emitWisdomEvaluateRequest(events, payload) {
43
+ if (!events || payload.events.length === 0)
44
+ return;
45
+ try {
46
+ events.emit({
47
+ type: WISDOM_EVALUATE_REQUEST_EVENT,
48
+ timestamp: Date.now(),
49
+ agentId: payload.agentId,
50
+ sessionId: payload.sessionId,
51
+ data: {
52
+ events: payload.events,
53
+ agentId: payload.agentId,
54
+ sessionId: payload.sessionId,
55
+ },
56
+ });
57
+ }
58
+ catch {
59
+ // 总线异常不得拖垮判官;判决可由下轮窗口重新积累
60
+ }
61
+ }
@@ -24,6 +24,8 @@ export interface ParsedWisdomItem {
24
24
  conceptIds?: string[];
25
25
  exceptions?: string[];
26
26
  kind: WisdomKind;
27
+ /** 取代已有范式(LLM 对照库内已有范式后给出;指向被取代条目 id) */
28
+ supersedesId?: string;
27
29
  }
28
30
  export interface ParsedWisdomFormation {
29
31
  items: ParsedWisdomItem[];
@@ -71,6 +73,25 @@ export declare function formAndAdmit(llmText: string, store: WisdomStore, option
71
73
  results: AdmitWisdomResult[];
72
74
  droppedNotes: string[];
73
75
  }>;
76
+ /**
77
+ * 关键词/字面场景匹配分 + 全字面命中标记 + anti 排除标记。
78
+ *
79
+ * 匹配单位是**分段**(长描述句切短语后逐段匹配):任一段全字面命中记 2 分,
80
+ * 仅 2-gram 弱重叠记 1 分。fullHit = 存在长度 ≥3 的分段全字面命中——
81
+ * trial 的 scenario 入场券只认 fullHit(弱重叠不算,2 字通用词也不够格)。
82
+ *
83
+ * antiScenarios 是排除条件(误触发会静默丢范式),要求更强证据才触发:
84
+ * 整串命中,或长度 ≥3 的分段命中(2 字碎片歧义大,如「越权」不应压制修越权 bug 的任务)。
85
+ *
86
+ * @param entry - 条目
87
+ * @param text - 本轮查询/任务文本
88
+ * @returns score∈[0,1](无命中为 0);fullHit=problemTypes/signals ≥3 字分段全字面命中;excluded=anti 命中
89
+ */
90
+ export declare function scenarioMatchDetail(entry: WisdomEntry, text: string): {
91
+ score: number;
92
+ fullHit: boolean;
93
+ excluded: boolean;
94
+ };
74
95
  /**
75
96
  * 关键词/字面场景匹配分。
76
97
  *
@@ -79,17 +100,26 @@ export declare function formAndAdmit(llmText: string, store: WisdomStore, option
79
100
  * @returns [0,1];无命中为 0
80
101
  */
81
102
  export declare function scenarioMatchScore(entry: WisdomEntry, text: string): number;
103
+ /**
104
+ * core 桶资格:宽覆盖(多 problemTypes 或 strengthened/factory);
105
+ * trial 永不进 core——未验证的假设只走场景匹配命中,不常驻刷屏。
106
+ *
107
+ * @param entry - 条目(状态已过 usable 过滤或可独立断言)
108
+ * @returns 是否可进 core 桶
109
+ */
110
+ export declare function isCoreEligible(entry: Pick<WisdomEntry, 'status' | 'origin' | 'scenario'>): boolean;
82
111
  /**
83
112
  * 选择注入集:小核心 + 场景匹配。
84
113
  *
85
114
  * @param entries - 可注入条目(store 已滤状态)
86
115
  * @param text - 本轮文本
87
- * @param options - 条数硬顶
116
+ * @param options - 条数硬顶;trialMaxItems 缺省 2(trial 轮转保底曝光,打破晋升死锁);includeTrial 缺省 true(trial 的意义就是被试用)
88
117
  * @returns 排序后的注入选择
89
118
  */
90
119
  export declare function pickForInjection(entries: WisdomEntry[], text: string, options?: {
91
120
  coreMaxItems?: number;
92
121
  scenarioMaxItems?: number;
122
+ trialMaxItems?: number;
93
123
  includeTrial?: boolean;
94
124
  }): WisdomInjectPick[];
95
125
  /**