@octopi-agent/engine 0.90.11 → 0.98.4

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 (246) hide show
  1. package/dist/config-admin/agent-presets.d.ts +70 -0
  2. package/dist/config-admin/agent-presets.js +243 -0
  3. package/dist/config-admin/discover.d.ts +30 -0
  4. package/dist/config-admin/discover.js +48 -0
  5. package/dist/config-admin/env.d.ts +22 -0
  6. package/dist/config-admin/env.js +41 -0
  7. package/dist/config-admin/index.d.ts +20 -0
  8. package/dist/config-admin/index.js +15 -0
  9. package/dist/config-admin/model-presets.d.ts +75 -0
  10. package/dist/config-admin/model-presets.js +249 -0
  11. package/dist/config-admin/name-guard.d.ts +14 -0
  12. package/dist/config-admin/name-guard.js +24 -0
  13. package/dist/config-admin/patch.d.ts +56 -0
  14. package/dist/config-admin/patch.js +201 -0
  15. package/dist/config-admin/port.d.ts +68 -0
  16. package/dist/config-admin/port.js +21 -0
  17. package/dist/config-admin/redact.d.ts +39 -0
  18. package/dist/config-admin/redact.js +42 -0
  19. package/dist/config-schema/agent.d.ts +45 -1
  20. package/dist/config-schema/context.d.ts +6 -1
  21. package/dist/config-schema/context.js +8 -0
  22. package/dist/config-schema/engine.d.ts +110 -4
  23. package/dist/config-schema/governance.d.ts +45 -1
  24. package/dist/config-schema/governance.js +187 -0
  25. package/dist/config-schema/models.d.ts +5 -2
  26. package/dist/config-schema/models.js +4 -1
  27. package/dist/config-schema/observability.d.ts +9 -0
  28. package/dist/config-schema/observability.js +29 -0
  29. package/dist/config-schema/run.d.ts +3 -0
  30. package/dist/config-schema/run.js +14 -0
  31. package/dist/config.d.ts +29 -4
  32. package/dist/config.js +15 -4
  33. package/dist/harness/activation/dispatcher.d.ts +8 -2
  34. package/dist/harness/activation/dispatcher.js +33 -5
  35. package/dist/harness/activation/inbox.d.ts +87 -0
  36. package/dist/harness/activation/inbox.js +169 -0
  37. package/dist/harness/activation/runtime.d.ts +9 -8
  38. package/dist/harness/activation/runtime.js +100 -8
  39. package/dist/harness/activation/types.d.ts +19 -0
  40. package/dist/harness/activation/types.js +2 -0
  41. package/dist/harness/agent/builder.d.ts +26 -1
  42. package/dist/harness/agent/builder.js +85 -37
  43. package/dist/harness/agent/config-bridge.d.ts +5 -0
  44. package/dist/harness/agent/config-bridge.js +3 -0
  45. package/dist/harness/agent/config-integrity.d.ts +138 -0
  46. package/dist/harness/agent/config-integrity.js +235 -0
  47. package/dist/harness/agent/wire-agent-builder.js +7 -1
  48. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +2 -2
  49. package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/loader.js +3 -0
  51. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +19 -2
  52. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.d.ts +40 -0
  53. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
  54. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -1
  55. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
  56. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
  58. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +9 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +21 -5
  60. package/dist/harness/collaboration/delegation/notifier.js +4 -3
  61. package/dist/harness/collaboration/delegation/service.js +2 -3
  62. package/dist/harness/collaboration/delegation/wiring.js +6 -5
  63. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.d.ts +1 -1
  64. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.js +1 -1
  65. package/dist/harness/context/capabilities/compact/engine.d.ts +30 -0
  66. package/dist/harness/context/capabilities/compact/engine.js +198 -46
  67. package/dist/harness/context/capabilities/compact/handover.d.ts +78 -0
  68. package/dist/harness/context/capabilities/compact/handover.js +107 -0
  69. package/dist/harness/context/capabilities/compact/index.d.ts +3 -1
  70. package/dist/harness/context/capabilities/compact/index.js +2 -1
  71. package/dist/harness/context/capabilities/compact/types.d.ts +30 -1
  72. package/dist/harness/context/capabilities/summary/executor.js +2 -1
  73. package/dist/harness/context/capabilities/summary/policies.js +8 -5
  74. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  75. package/dist/harness/context/capabilities/summary/resolver.js +4 -4
  76. package/dist/harness/context/capabilities/summary/types.d.ts +2 -2
  77. package/dist/harness/context/constitution/default-agents.md +11 -10
  78. package/dist/harness/context/default-context-engine.d.ts +34 -4
  79. package/dist/harness/context/default-context-engine.js +194 -49
  80. package/dist/harness/context/hybrid-compressor.js +6 -0
  81. package/dist/harness/context/layers.d.ts +2 -4
  82. package/dist/harness/context/layers.js +9 -11
  83. package/dist/harness/context/llm-summarizer.d.ts +2 -8
  84. package/dist/harness/context/llm-summarizer.js +69 -91
  85. package/dist/harness/context/message-selector.js +4 -3
  86. package/dist/harness/context/summarize.d.ts +3 -1
  87. package/dist/harness/context/summarize.js +9 -4
  88. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  89. package/dist/harness/context/system-prompt-assembler.js +1 -0
  90. package/dist/harness/context/truncate-compressor.js +7 -0
  91. package/dist/harness/context/turn-envelope.d.ts +3 -2
  92. package/dist/harness/context/turn-envelope.js +3 -2
  93. package/dist/harness/context/types.d.ts +33 -1
  94. package/dist/harness/extension/execution-environment/dangerous-commands.d.ts +28 -0
  95. package/dist/harness/extension/execution-environment/dangerous-commands.js +129 -0
  96. package/dist/harness/extension/execution-environment/effect-policy.d.ts +149 -8
  97. package/dist/harness/extension/execution-environment/effect-policy.js +274 -19
  98. package/dist/harness/extension/execution-environment/index.d.ts +4 -2
  99. package/dist/harness/extension/execution-environment/index.js +2 -1
  100. package/dist/harness/extension/execution-environment/kill-switch.d.ts +34 -0
  101. package/dist/harness/extension/execution-environment/kill-switch.js +46 -0
  102. package/dist/harness/extension/execution-environment/ops-audit.d.ts +204 -0
  103. package/dist/harness/extension/execution-environment/ops-audit.js +337 -0
  104. package/dist/harness/extension/execution-environment/privileged-exec.d.ts +158 -0
  105. package/dist/harness/extension/execution-environment/privileged-exec.js +418 -0
  106. package/dist/harness/extension/execution-environment/process-info.d.ts +180 -0
  107. package/dist/harness/extension/execution-environment/process-info.js +466 -0
  108. package/dist/harness/extension/execution-environment/process-isolation.d.ts +7 -0
  109. package/dist/harness/extension/execution-environment/process-isolation.js +9 -0
  110. package/dist/harness/extension/execution-environment/sandbox.d.ts +109 -0
  111. package/dist/harness/extension/execution-environment/sandbox.js +228 -21
  112. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +1 -1
  113. package/dist/harness/extension/execution-environment/tool-capabilities.js +6 -0
  114. package/dist/harness/extension/execution-environment/types.d.ts +19 -0
  115. package/dist/harness/extension/execution-environment/undo-log.d.ts +6 -2
  116. package/dist/harness/extension/execution-environment/undo-log.js +31 -10
  117. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +5 -0
  118. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +33 -0
  119. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +4 -5
  120. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +5 -15
  121. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +3 -0
  122. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +70 -26
  123. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
  124. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
  125. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
  126. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
  127. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
  128. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  129. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  130. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
  131. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
  132. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
  133. package/dist/harness/extension/plugin-ecosystem/tools/privileged-tool.d.ts +43 -0
  134. package/dist/harness/extension/plugin-ecosystem/tools/privileged-tool.js +350 -0
  135. package/dist/harness/extension/plugin-ecosystem/tools/process-tools.d.ts +30 -0
  136. package/dist/harness/extension/plugin-ecosystem/tools/process-tools.js +137 -0
  137. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +54 -4
  138. package/dist/harness/governance/human-in-the-loop/decision-cache.js +42 -16
  139. package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
  140. package/dist/harness/governance/security/default-risk-policy.js +1 -0
  141. package/dist/harness/governance/security/default-security-guard.js +9 -0
  142. package/dist/harness/governance/security/index.d.ts +1 -0
  143. package/dist/harness/governance/security/index.js +2 -0
  144. package/dist/harness/governance/security/risk-evaluator.js +13 -0
  145. package/dist/harness/governance/security/risk-types.d.ts +12 -0
  146. package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
  147. package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
  148. package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
  149. package/dist/harness/governance/security/shell-parser-shared.js +188 -0
  150. package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
  151. package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
  152. package/dist/harness/governance/security/shell-parser.d.ts +23 -10
  153. package/dist/harness/governance/security/shell-parser.js +37 -496
  154. package/dist/harness/governance/security/temp-path.d.ts +9 -0
  155. package/dist/harness/governance/security/temp-path.js +13 -2
  156. package/dist/harness/governance/security/vendor/README.md +24 -0
  157. package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
  158. package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
  159. package/dist/harness/governance/session-acl/seed-roles.js +14 -0
  160. package/dist/harness/index.d.ts +2 -0
  161. package/dist/harness/index.js +2 -0
  162. package/dist/harness/knowledge/fts.js +1 -2
  163. package/dist/harness/knowledge/index-store.js +59 -9
  164. package/dist/harness/memory/index.d.ts +6 -2
  165. package/dist/harness/memory/index.js +4 -1
  166. package/dist/harness/memory/memory-events.d.ts +25 -0
  167. package/dist/harness/memory/memory-events.js +38 -0
  168. package/dist/harness/memory/sqlite/agent-db.js +15 -0
  169. package/dist/harness/memory/sqlite/keyword-search.d.ts +1 -0
  170. package/dist/harness/memory/sqlite/keyword-search.js +4 -3
  171. package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
  172. package/dist/harness/memory/sqlite/wisdom-store.js +51 -2
  173. package/dist/harness/memory/steward-policy.d.ts +3 -0
  174. package/dist/harness/memory/steward-policy.js +1 -1
  175. package/dist/harness/memory/types.d.ts +41 -3
  176. package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
  177. package/dist/harness/memory/wisdom-attribution.js +287 -0
  178. package/dist/harness/memory/wisdom-events.d.ts +37 -0
  179. package/dist/harness/memory/wisdom-events.js +61 -0
  180. package/dist/harness/memory/wisdom-formation.d.ts +20 -1
  181. package/dist/harness/memory/wisdom-formation.js +55 -21
  182. package/dist/harness/memory/wisdom.d.ts +7 -2
  183. package/dist/harness/memory/wisdom.js +40 -2
  184. package/dist/harness/observability/observer/hub.js +8 -0
  185. package/dist/harness/observability/observer/run-snapshot.js +1 -0
  186. package/dist/harness/observability/observer/types.d.ts +4 -0
  187. package/dist/harness/run/agent/agent.d.ts +7 -0
  188. package/dist/harness/run/agent/agent.js +23 -1
  189. package/dist/harness/run/reliability/fallback-provider.d.ts +117 -5
  190. package/dist/harness/run/reliability/fallback-provider.js +262 -22
  191. package/dist/harness/run/reliability/harness-events.d.ts +24 -1
  192. package/dist/harness/run/reliability/model-error-policy.d.ts +32 -0
  193. package/dist/harness/run/reliability/model-error-policy.js +42 -0
  194. package/dist/harness/run/reliability/provider-wrapper.js +29 -2
  195. package/dist/harness/run/reliability/refusal-guard.d.ts +20 -0
  196. package/dist/harness/run/reliability/refusal-guard.js +102 -0
  197. package/dist/harness/run/reliability/run-agent.js +231 -33
  198. package/dist/harness/run/run-guard/default-run-guard.js +1 -1
  199. package/dist/harness/run/run-scope.d.ts +35 -0
  200. package/dist/harness/run/runner.d.ts +141 -2
  201. package/dist/harness/run/runner.js +592 -42
  202. package/dist/harness/session/attachments/llm-intent.js +2 -1
  203. package/dist/harness/session/tasks/render.d.ts +4 -1
  204. package/dist/harness/session/tasks/render.js +10 -7
  205. package/dist/harness/shared/events/agent-event-map.d.ts +66 -0
  206. package/dist/harness/shared/events/agent-event-map.js +5 -0
  207. package/dist/harness/shared/paths/glob.d.ts +52 -0
  208. package/dist/harness/shared/paths/glob.js +218 -0
  209. package/dist/harness/shared/paths/index.d.ts +84 -0
  210. package/dist/harness/shared/paths/index.js +179 -0
  211. package/dist/index.d.ts +3 -3
  212. package/dist/index.js +2 -2
  213. package/dist/integration/agent-runtime/channel-message-source.js +19 -1
  214. package/dist/integration/index.d.ts +2 -0
  215. package/dist/integration/index.js +1 -0
  216. package/dist/integration/observability/loop-watchdog.d.ts +56 -0
  217. package/dist/integration/observability/loop-watchdog.js +177 -0
  218. package/dist/integration/observability/metrics.d.ts +3 -0
  219. package/dist/integration/observability/metrics.js +18 -7
  220. package/dist/integration/providers/anthropic.d.ts +23 -0
  221. package/dist/integration/providers/anthropic.js +97 -12
  222. package/dist/integration/providers/fetch-timeout.d.ts +42 -0
  223. package/dist/integration/providers/fetch-timeout.js +51 -0
  224. package/dist/integration/providers/openai.d.ts +10 -0
  225. package/dist/integration/providers/openai.js +58 -11
  226. package/dist/integration/providers/provider-diagnostics.d.ts +80 -0
  227. package/dist/integration/providers/provider-diagnostics.js +89 -0
  228. package/dist/integration/providers/timeout-coherence.d.ts +52 -0
  229. package/dist/integration/providers/timeout-coherence.js +68 -0
  230. package/dist/integration/providers/wire-dump.d.ts +62 -0
  231. package/dist/integration/providers/wire-dump.js +111 -2
  232. package/dist/integration/storage/jsonl.js +4 -1
  233. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
  234. package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
  235. package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
  236. package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
  237. package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
  238. package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
  239. package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
  240. package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
  241. package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
  242. package/dist/subsystems/wisdom-steward/formation/config.yaml +12 -5
  243. package/dist/subsystems/wisdom-steward/formation/handler.js +12 -18
  244. package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
  245. package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
  246. package/package.json +8 -2
@@ -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
+ }
@@ -71,6 +71,17 @@ export declare function formAndAdmit(llmText: string, store: WisdomStore, option
71
71
  results: AdmitWisdomResult[];
72
72
  droppedNotes: string[];
73
73
  }>;
74
+ /**
75
+ * 关键词/字面场景匹配分 + 全字面命中标记。
76
+ *
77
+ * @param entry - 条目
78
+ * @param text - 本轮查询/任务文本
79
+ * @returns score∈[0,1](无命中为 0);fullHit=problemTypes/signals 任一词全字面命中
80
+ */
81
+ export declare function scenarioMatchDetail(entry: WisdomEntry, text: string): {
82
+ score: number;
83
+ fullHit: boolean;
84
+ };
74
85
  /**
75
86
  * 关键词/字面场景匹配分。
76
87
  *
@@ -79,12 +90,20 @@ export declare function formAndAdmit(llmText: string, store: WisdomStore, option
79
90
  * @returns [0,1];无命中为 0
80
91
  */
81
92
  export declare function scenarioMatchScore(entry: WisdomEntry, text: string): number;
93
+ /**
94
+ * core 桶资格:宽覆盖(多 problemTypes 或 strengthened/factory);
95
+ * trial 永不进 core——未验证的假设只走场景匹配命中,不常驻刷屏。
96
+ *
97
+ * @param entry - 条目(状态已过 usable 过滤或可独立断言)
98
+ * @returns 是否可进 core 桶
99
+ */
100
+ export declare function isCoreEligible(entry: Pick<WisdomEntry, 'status' | 'origin' | 'scenario'>): boolean;
82
101
  /**
83
102
  * 选择注入集:小核心 + 场景匹配。
84
103
  *
85
104
  * @param entries - 可注入条目(store 已滤状态)
86
105
  * @param text - 本轮文本
87
- * @param options - 条数硬顶
106
+ * @param options - 条数硬顶;includeTrial 缺省 true(trial 的意义就是被试用)
88
107
  * @returns 排序后的注入选择
89
108
  */
90
109
  export declare function pickForInjection(entries: WisdomEntry[], text: string, options?: {