@octopi-agent/engine 0.70.7 → 0.90.11

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 (390) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +201 -8
  23. package/dist/config.js +105 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -28,6 +28,7 @@ export class LocalKnowledgeWriteService {
28
28
  indexStore: this.index,
29
29
  documentConfig: deps.documentConfig ?? null,
30
30
  embeddingProvider: embed?.enabled === false ? null : (deps.embeddingProvider ?? null),
31
+ credentials: deps.credentials ?? null,
31
32
  ...(embed?.embedBatch != null ? { embedBatch: embed.embedBatch } : {}),
32
33
  ...(embed?.embedMinIntervalMs != null ? { embedMinIntervalMs: embed.embedMinIntervalMs } : {}),
33
34
  ...(embed?.embedConcurrency != null ? { embedConcurrency: embed.embedConcurrency } : {}),
@@ -50,19 +51,19 @@ export class LocalKnowledgeWriteService {
50
51
  async upsertPrincipal(identity, agentId, body) {
51
52
  const now = Date.now();
52
53
  this.db.raw
53
- .prepare(`INSERT INTO knowledge_principals
54
- (tenant_id, gateway_id, local_agent_id, display_name, status, last_seen_at, created_at, updated_at)
55
- VALUES (?, ?, ?, ?, ?, ?, ?, ?)
56
- ON CONFLICT(tenant_id, gateway_id, local_agent_id) DO UPDATE SET
57
- display_name = COALESCE(excluded.display_name, knowledge_principals.display_name),
58
- status = excluded.status,
59
- last_seen_at = excluded.last_seen_at,
54
+ .prepare(`INSERT INTO knowledge_principals
55
+ (tenant_id, gateway_id, local_agent_id, display_name, status, last_seen_at, created_at, updated_at)
56
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)
57
+ ON CONFLICT(tenant_id, gateway_id, local_agent_id) DO UPDATE SET
58
+ display_name = COALESCE(excluded.display_name, knowledge_principals.display_name),
59
+ status = excluded.status,
60
+ last_seen_at = excluded.last_seen_at,
60
61
  updated_at = excluded.updated_at`)
61
62
  .run(identity.tenantId, identity.gatewayId, agentId, body.displayName ?? null, body.status ?? 'active', now, now, now);
62
63
  }
63
64
  async ensurePrincipal(identity, agentId, autoRegister) {
64
65
  const row = this.db.raw
65
- .prepare(`SELECT status FROM knowledge_principals
66
+ .prepare(`SELECT status FROM knowledge_principals
66
67
  WHERE tenant_id = ? AND gateway_id = ? AND local_agent_id = ?`)
67
68
  .get(identity.tenantId, identity.gatewayId, agentId);
68
69
  if (row)
@@ -79,7 +80,7 @@ export class LocalKnowledgeWriteService {
79
80
  // 不得按 gateway 预过滤后再比较——那是永不失败的空检查。
80
81
  // 同名 principal 可挂多 gateway(复合 PK);仅当**另一 gateway 已登记**时拒绝。
81
82
  const rows = this.db.raw
82
- .prepare(`SELECT gateway_id FROM knowledge_principals
83
+ .prepare(`SELECT gateway_id FROM knowledge_principals
83
84
  WHERE tenant_id = ? AND local_agent_id = ?`)
84
85
  .all(identity.tenantId, agentId);
85
86
  const foreign = rows.find((r) => r.gateway_id !== identity.gatewayId);
@@ -89,7 +90,7 @@ export class LocalKnowledgeWriteService {
89
90
  }
90
91
  async createProject(identity, input) {
91
92
  const existing = this.db.raw
92
- .prepare(`SELECT registered_by FROM knowledge_projects
93
+ .prepare(`SELECT registered_by FROM knowledge_projects
93
94
  WHERE tenant_id = ? AND project_key = ?`)
94
95
  .get(identity.tenantId, input.projectKey);
95
96
  if (existing?.registered_by && existing.registered_by !== identity.gatewayId) {
@@ -103,7 +104,7 @@ export class LocalKnowledgeWriteService {
103
104
  });
104
105
  const visibility = input.visibility === 'public' ? 'public' : 'private';
105
106
  this.db.raw
106
- .prepare(`UPDATE knowledge_projects SET registered_by = ?, visibility = ?
107
+ .prepare(`UPDATE knowledge_projects SET registered_by = ?, visibility = ?
107
108
  WHERE tenant_id = ? AND project_key = ?`)
108
109
  .run(identity.gatewayId, visibility, identity.tenantId, input.projectKey);
109
110
  return {
@@ -115,7 +116,7 @@ export class LocalKnowledgeWriteService {
115
116
  }
116
117
  async removeProject(identity, projectKey) {
117
118
  const row = this.db.raw
118
- .prepare(`SELECT registered_by FROM knowledge_projects
119
+ .prepare(`SELECT registered_by FROM knowledge_projects
119
120
  WHERE tenant_id = ? AND project_key = ?`)
120
121
  .get(identity.tenantId, projectKey);
121
122
  if (row?.registered_by && row.registered_by !== identity.gatewayId) {
@@ -142,7 +143,7 @@ export class LocalKnowledgeWriteService {
142
143
  delete input.tenant_id;
143
144
  const src = this.sources.register(input);
144
145
  this.db.raw
145
- .prepare(`UPDATE knowledge_sources SET registered_by = ?, visibility = ?, tenant_id = ?
146
+ .prepare(`UPDATE knowledge_sources SET registered_by = ?, visibility = ?, tenant_id = ?
146
147
  WHERE id = ?`)
147
148
  .run(identity.gatewayId, typeof input.visibility === 'string' ? input.visibility : 'private', identity.tenantId, src.id);
148
149
  void this.ingest.ingestSource(src.id, { full: true }).catch((e) => {
@@ -7,6 +7,7 @@
7
7
  */
8
8
  import { createHash } from 'node:crypto';
9
9
  import { getTextContent } from '@octopi-agent/core/types.js';
10
+ import { isHumanSpeech } from '../context/layer-types.js';
10
11
  export const DEFAULT_PREFILTER = {
11
12
  minUserTurns: 2,
12
13
  minTotalChars: 200,
@@ -76,7 +77,8 @@ export function measureSessionDensity(messages) {
76
77
  const ts = typeof m.timestamp === 'number' ? m.timestamp : 0;
77
78
  if (ts > lastTs)
78
79
  lastTs = ts;
79
- if (m.role === 'user')
80
+ // 引擎载体(turn_end/runStopped…)也是 role=user,不计真实用户轮
81
+ if (isHumanSpeech(m))
80
82
  userTurns++;
81
83
  if (m.role === 'assistant')
82
84
  assistantTurns++;
@@ -2,7 +2,7 @@
2
2
  * BackfillTrigger — 补录脉搏协调器
3
3
  *
4
4
  * 时机:
5
- * - 硬收敛(session → recent / /new / idle reset)立即评估并 emit
5
+ * - 硬收敛(session → recent / `/new`)立即评估并 emit
6
6
  * - 空闲漂移(默认 20min)软收敛
7
7
  * - 覆盖差扫描(默认 6h)兜底
8
8
  *
@@ -60,7 +60,7 @@ export declare class BackfillTrigger {
60
60
  noteActivity(sessionId: string, agentId?: string, at?: number): void;
61
61
  /**
62
62
  * 硬收敛:立即评估并 emit(穿透意图是「这段干完了」)
63
- * 可传入 session 快照,避免 reset 清空 messages 后读到空库。
63
+ * 可传入 session 快照;`/new` 后旧会话仍可读,事件快照与 store 并存。
64
64
  */
65
65
  requestHardConverge(input: {
66
66
  sessionId: string;
@@ -2,7 +2,7 @@
2
2
  * BackfillTrigger — 补录脉搏协调器
3
3
  *
4
4
  * 时机:
5
- * - 硬收敛(session → recent / /new / idle reset)立即评估并 emit
5
+ * - 硬收敛(session → recent / `/new`)立即评估并 emit
6
6
  * - 空闲漂移(默认 20min)软收敛
7
7
  * - 覆盖差扫描(默认 6h)兜底
8
8
  *
@@ -61,7 +61,7 @@ export class BackfillTrigger {
61
61
  void this.requestHardConverge({
62
62
  sessionId,
63
63
  agentId,
64
- // idle reset 场景 messages 即将被清空:优先用事件携带的快照
64
+ // 事件可带 sessionText 快照;store.messages 不会因 lifecycle 收敛被清空
65
65
  sessionText: typeof data.sessionText === 'string' ? data.sessionText : undefined,
66
66
  trigger: 'hard_converge',
67
67
  });
@@ -104,7 +104,7 @@ export class BackfillTrigger {
104
104
  }
105
105
  /**
106
106
  * 硬收敛:立即评估并 emit(穿透意图是「这段干完了」)
107
- * 可传入 session 快照,避免 reset 清空 messages 后读到空库。
107
+ * 可传入 session 快照;`/new` 后旧会话仍可读,事件快照与 store 并存。
108
108
  */
109
109
  async requestHardConverge(input) {
110
110
  return this.evaluateAndEmit({
@@ -177,7 +177,7 @@ export class BackfillTrigger {
177
177
  session = undefined;
178
178
  }
179
179
  }
180
- // 快照优先:idle reset / `/new` 会在 store.messages 清空后才可见,
180
+ // 事件快照优先;store.messages 仍保留全量 Discourse
181
181
  // 此时必须用事件里的 sessionText,不得退回空密度。
182
182
  const snapshot = input.sessionText?.trim() ? input.sessionText : undefined;
183
183
  const sessionText = snapshot ?? (session ? this.renderSessionText(session) : undefined);
@@ -43,5 +43,6 @@ export { provisionalConfidence, injectFilter, searchFilter, profileToConfidenceC
43
43
  export type { ChannelPriors, ConfidenceProfileConfig, MemoryProfileName, ProvisionalInput, ProvisionalResult } from './confidence.js';
44
44
  export { evaluateGates, mapLegacyType } from './gates.js';
45
45
  export type { GateCandidate, GateConfig, GateOutcome, GateRejectReason } from './gates.js';
46
+ export { formatMemoryClock, formatMemoryTimeSuffix, parseAsOf } from './time-format.js';
46
47
  export { admitCandidates, applySoftDeletes, planSoftDeletes, applyBoosts, planBoosts, planPromotionCandidates, resolvePolicy, DEFAULT_SOFT_DELETE_POLICY, MAX_ENTRIES_PER_SOURCE, } from './steward-policy.js';
47
48
  export type { SoftDeletePolicyConfig, StewardCandidate, GovernPlanItem, BoostPlanItem, AdmitResult, } from './steward-policy.js';
@@ -34,5 +34,6 @@ export { BackfillTrigger, BACKFILL_REQUEST_EVENT } from './backfill-trigger.js';
34
34
  // ── 置信度与门控 ──
35
35
  export { provisionalConfidence, injectFilter, searchFilter, profileToConfidenceConfig, hasQuoteEvidence, DEFAULT_CHANNEL_PRIORS, } from './confidence.js';
36
36
  export { evaluateGates, mapLegacyType } from './gates.js';
37
+ export { formatMemoryClock, formatMemoryTimeSuffix, parseAsOf } from './time-format.js';
37
38
  // ── Steward 共享策略(subsystem 从 @octopi-agent/engine 引用) ──
38
39
  export { admitCandidates, applySoftDeletes, planSoftDeletes, applyBoosts, planBoosts, planPromotionCandidates, resolvePolicy, DEFAULT_SOFT_DELETE_POLICY, MAX_ENTRIES_PER_SOURCE, } from './steward-policy.js';
@@ -83,6 +83,7 @@ export class AgentDatabase {
83
83
  ["anchors", "TEXT NOT NULL DEFAULT '[]'"],
84
84
  ['evidence', 'TEXT'],
85
85
  ['reinforced_at', 'INTEGER'],
86
+ ['as_of', 'INTEGER'],
86
87
  ['deleted', 'INTEGER NOT NULL DEFAULT 0'],
87
88
  ['deleted_at', 'INTEGER'],
88
89
  ['deleted_by', 'TEXT'],
@@ -193,6 +194,7 @@ export class AgentDatabase {
193
194
  anchors TEXT NOT NULL DEFAULT '[]',
194
195
  evidence TEXT,
195
196
  reinforced_at INTEGER,
197
+ as_of INTEGER,
196
198
  deleted INTEGER NOT NULL DEFAULT 0,
197
199
  deleted_at INTEGER,
198
200
  deleted_by TEXT,
@@ -79,6 +79,7 @@ export declare class SqliteMemoryStore implements MemoryStore {
79
79
  winnerId?: string;
80
80
  }): Promise<void>;
81
81
  undelete(id: string): Promise<void>;
82
+ importEntry(entry: MemoryEntry): Promise<void>;
82
83
  listForGovern(filter?: {
83
84
  includeDeleted?: boolean;
84
85
  }): Promise<MemoryEntry[]>;
@@ -90,9 +90,9 @@ export class SqliteMemoryStore {
90
90
  INSERT INTO memories (
91
91
  id, type, content, source, confidence, importance,
92
92
  access_count, last_accessed_at, created_at, decay_factor, tags, embedding,
93
- status, channel, future_use, anchors, evidence, deleted
94
- ) VALUES (?, ?, ?, ?, ?, ?, 0, ?, ?, 1.0, ?, ?, ?, ?, ?, ?, ?, 0)
95
- `).run(id, mapLegacyType(entry.type), entry.content, entry.source, entry.confidence, entry.importance, now, now, JSON.stringify(entry.tags ?? []), embeddingStr, entry.status ?? 'active', entry.channel ?? 'model_inference', entry.futureUse ?? null, JSON.stringify(entry.anchors ?? []), entry.evidence ?? null);
93
+ status, channel, future_use, anchors, evidence, deleted, as_of
94
+ ) VALUES (?, ?, ?, ?, ?, ?, 0, ?, ?, 1.0, ?, ?, ?, ?, ?, ?, ?, 0, ?)
95
+ `).run(id, mapLegacyType(entry.type), entry.content, entry.source, entry.confidence, entry.importance, now, now, JSON.stringify(entry.tags ?? []), embeddingStr, entry.status ?? 'active', entry.channel ?? 'model_inference', entry.futureUse ?? null, JSON.stringify(entry.anchors ?? []), entry.evidence ?? null, entry.asOf ?? null);
96
96
  if (embeddingStr && this.vecReady) {
97
97
  try {
98
98
  const vec = parseEmbedding(embeddingStr);
@@ -207,7 +207,7 @@ export class SqliteMemoryStore {
207
207
  const vis = this.visibilityWhere(query);
208
208
  const cap = this.candidateCap;
209
209
  const minSim = query.minSimilarity ?? this.defaultMinSimilarity;
210
- let sql = `SELECT id, type, content, source, confidence, importance, access_count, last_accessed_at, created_at, decay_factor, tags, embedding, status, channel, future_use, anchors, evidence, deleted, deleted_at, deleted_by, deleted_reason, deleted_meta, reinforced_at
210
+ let sql = `SELECT id, type, content, source, confidence, importance, access_count, last_accessed_at, created_at, decay_factor, tags, embedding, status, channel, future_use, anchors, evidence, deleted, deleted_at, deleted_by, deleted_reason, deleted_meta, reinforced_at, as_of
211
211
  FROM memories WHERE embedding IS NOT NULL${vis.sql}`;
212
212
  const params = [...vis.params];
213
213
  if (query.type) {
@@ -460,6 +460,8 @@ export class SqliteMemoryStore {
460
460
  set('evidence', patch.evidence);
461
461
  if (patch.reinforcedAt !== undefined)
462
462
  set('reinforced_at', patch.reinforcedAt);
463
+ if (patch.asOf !== undefined)
464
+ set('as_of', patch.asOf);
463
465
  if (patch.deleted !== undefined)
464
466
  set('deleted', patch.deleted ? 1 : 0);
465
467
  if (patch.deletedAt !== undefined)
@@ -524,6 +526,13 @@ export class SqliteMemoryStore {
524
526
  WHERE id = ?
525
527
  `).run(id);
526
528
  }
529
+ async importEntry(entry) {
530
+ this.db.raw.prepare(`INSERT OR REPLACE INTO memories (
531
+ id, type, content, source, confidence, importance,
532
+ access_count, last_accessed_at, created_at, decay_factor, tags, embedding,
533
+ status, channel, future_use, anchors, evidence, deleted, as_of
534
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(entry.id, mapLegacyType(entry.type), entry.content, entry.source, entry.confidence, entry.importance, entry.accessCount ?? 0, entry.lastAccessedAt ?? Date.now(), entry.createdAt ?? Date.now(), entry.decayFactor ?? 1, JSON.stringify(entry.tags ?? []), null, entry.status ?? 'active', entry.channel ?? 'model_inference', entry.futureUse ?? null, JSON.stringify(entry.anchors ?? []), entry.evidence ?? null, entry.deleted ? 1 : 0, entry.asOf ?? null);
535
+ }
527
536
  async listForGovern(filter) {
528
537
  const sql = filter?.includeDeleted
529
538
  ? 'SELECT * FROM memories'
@@ -588,6 +597,7 @@ export class SqliteMemoryStore {
588
597
  anchors: row.anchors ? JSON.parse(row.anchors) : [],
589
598
  evidence: row.evidence ?? undefined,
590
599
  reinforcedAt: row.reinforced_at ?? undefined,
600
+ asOf: row.as_of ?? undefined,
591
601
  deleted: !!row.deleted,
592
602
  deletedAt: row.deleted_at ?? undefined,
593
603
  deletedBy: row.deleted_by ?? undefined,
@@ -45,10 +45,10 @@ export class SqliteWisdomStore {
45
45
  .run(id, now, prev.id);
46
46
  }
47
47
  this.db.raw
48
- .prepare(`INSERT INTO wisdom (
49
- id, statement, rationale, scenario_json, effect_json, status, confidence, priority,
50
- derived_from_json, exceptions_json, counterevidence_json, outcomes_json,
51
- origin, kind, superseded_by, created_at, updated_at
48
+ .prepare(`INSERT INTO wisdom (
49
+ id, statement, rationale, scenario_json, effect_json, status, confidence, priority,
50
+ derived_from_json, exceptions_json, counterevidence_json, outcomes_json,
51
+ origin, kind, superseded_by, created_at, updated_at
52
52
  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
53
53
  .run(id, input.statement.trim(), input.rationale?.trim() || null, JSON.stringify(input.scenario), JSON.stringify(input.effect), status, clamp01(input.confidence ?? defaultConfidence(status, input.origin ?? 'distilled')), input.priority ?? defaultPriority(status, input.origin ?? 'distilled'), JSON.stringify(input.derivedFrom), JSON.stringify(input.exceptions ?? []), JSON.stringify([]), JSON.stringify(emptyOutcomes()), input.origin ?? 'distilled', input.kind, null, now, now);
54
54
  return {
@@ -93,11 +93,11 @@ export class SqliteWisdomStore {
93
93
  outcomes: { ...current.outcomes, ...(patch.outcomes ?? {}) },
94
94
  };
95
95
  this.db.raw
96
- .prepare(`UPDATE wisdom SET
97
- statement = ?, rationale = ?, scenario_json = ?, effect_json = ?,
98
- status = ?, confidence = ?, priority = ?, derived_from_json = ?,
99
- exceptions_json = ?, counterevidence_json = ?, outcomes_json = ?,
100
- origin = ?, kind = ?, superseded_by = ?, updated_at = ?
96
+ .prepare(`UPDATE wisdom SET
97
+ statement = ?, rationale = ?, scenario_json = ?, effect_json = ?,
98
+ status = ?, confidence = ?, priority = ?, derived_from_json = ?,
99
+ exceptions_json = ?, counterevidence_json = ?, outcomes_json = ?,
100
+ origin = ?, kind = ?, superseded_by = ?, updated_at = ?
101
101
  WHERE id = ?`)
102
102
  .run(merged.statement, merged.rationale ?? null, JSON.stringify(merged.scenario), JSON.stringify(merged.effect), merged.status, clamp01(merged.confidence), merged.priority, JSON.stringify(merged.derivedFrom), JSON.stringify(merged.exceptions ?? []), JSON.stringify(merged.counterevidence ?? []), JSON.stringify(merged.outcomes), merged.origin, merged.kind, merged.supersededBy ?? null, merged.updatedAt, id);
103
103
  }
@@ -18,6 +18,7 @@ export declare class InMemoryMemoryStore implements MemoryStore {
18
18
  winnerId?: string;
19
19
  }): Promise<void>;
20
20
  undelete(id: string): Promise<void>;
21
+ importEntry(entry: MemoryEntry): Promise<void>;
21
22
  listForGovern(filter?: {
22
23
  includeDeleted?: boolean;
23
24
  }): Promise<MemoryEntry[]>;
@@ -150,6 +150,9 @@ export class InMemoryMemoryStore {
150
150
  entry.deletedReason = undefined;
151
151
  entry.deletedMeta = undefined;
152
152
  }
153
+ async importEntry(entry) {
154
+ this.entries.set(entry.id, { ...entry });
155
+ }
153
156
  async listForGovern(filter) {
154
157
  return Array.from(this.entries.values()).filter((e) => filter?.includeDeleted || !e.deleted);
155
158
  }
@@ -0,0 +1,28 @@
1
+ /**
2
+ * 记忆时间戳的 LLM 可读格式 — 与 Runtime `Current datetime` 同为本地墙上时钟
3
+ */
4
+ /**
5
+ * 格式化 epoch ms 为 `YYYY-MM-DD HH:mm`(本地时区)
6
+ *
7
+ * @param ms - epoch 毫秒
8
+ * @returns 本地时钟字符串(分钟精度)
9
+ */
10
+ export declare function formatMemoryClock(ms: number): string;
11
+ /**
12
+ * 解析 memory_store 的 as_of 入参(epoch ms / 数字串 / 可被 Date.parse 的日期串)
13
+ *
14
+ * @param raw - 工具入参
15
+ * @returns epoch ms;缺省返回 undefined
16
+ * @throws 无法解析为时刻时抛出
17
+ */
18
+ export declare function parseAsOf(raw: unknown): number | undefined;
19
+ /**
20
+ * 召回条目的时间后缀 — 显式标注 recorded / as of
21
+ *
22
+ * @param entry - 含 createdAt 与可选 asOf 的条目
23
+ * @returns 以 ` · ` 开头的时间后缀;createdAt 缺失时返回空串
24
+ */
25
+ export declare function formatMemoryTimeSuffix(entry: {
26
+ createdAt?: number;
27
+ asOf?: number;
28
+ }): string;
@@ -0,0 +1,52 @@
1
+ /**
2
+ * 记忆时间戳的 LLM 可读格式 — 与 Runtime `Current datetime` 同为本地墙上时钟
3
+ */
4
+ /**
5
+ * 格式化 epoch ms 为 `YYYY-MM-DD HH:mm`(本地时区)
6
+ *
7
+ * @param ms - epoch 毫秒
8
+ * @returns 本地时钟字符串(分钟精度)
9
+ */
10
+ export function formatMemoryClock(ms) {
11
+ const d = new Date(ms);
12
+ const pad = (n) => String(n).padStart(2, '0');
13
+ return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
14
+ }
15
+ /**
16
+ * 解析 memory_store 的 as_of 入参(epoch ms / 数字串 / 可被 Date.parse 的日期串)
17
+ *
18
+ * @param raw - 工具入参
19
+ * @returns epoch ms;缺省返回 undefined
20
+ * @throws 无法解析为时刻时抛出
21
+ */
22
+ export function parseAsOf(raw) {
23
+ if (raw == null || raw === '')
24
+ return undefined;
25
+ if (typeof raw === 'number' && Number.isFinite(raw))
26
+ return raw;
27
+ const s = String(raw).trim();
28
+ if (!s)
29
+ return undefined;
30
+ if (/^\d+$/.test(s))
31
+ return Number(s);
32
+ const t = Date.parse(s);
33
+ if (!Number.isFinite(t)) {
34
+ throw new Error(`invalid_as_of: ${s} is not a date (use YYYY-MM-DD or epoch ms)`);
35
+ }
36
+ return t;
37
+ }
38
+ /**
39
+ * 召回条目的时间后缀 — 显式标注 recorded / as of
40
+ *
41
+ * @param entry - 含 createdAt 与可选 asOf 的条目
42
+ * @returns 以 ` · ` 开头的时间后缀;createdAt 缺失时返回空串
43
+ */
44
+ export function formatMemoryTimeSuffix(entry) {
45
+ if (entry.createdAt == null)
46
+ return '';
47
+ const recorded = formatMemoryClock(entry.createdAt);
48
+ if (entry.asOf != null) {
49
+ return ` · as of ${formatMemoryClock(entry.asOf)} · recorded ${recorded}`;
50
+ }
51
+ return ` · recorded ${recorded}`;
52
+ }
@@ -44,6 +44,11 @@ export interface MemoryEntry {
44
44
  evidence?: string;
45
45
  /** 最近强化时间 */
46
46
  reinforcedAt?: number;
47
+ /**
48
+ * 命题成立时刻(as-of)— 与 createdAt(入库时刻)区分。
49
+ * 时效敏感 fact 用:「3 月时版本是 1.2」≠「3 月写入了当前版本是 1.2」。
50
+ */
51
+ asOf?: number;
47
52
  /** 软删除 */
48
53
  deleted?: boolean;
49
54
  deletedAt?: number;
@@ -101,6 +106,11 @@ export interface MemoryStore {
101
106
  winnerId?: string;
102
107
  }): Promise<void>;
103
108
  undelete(id: string): Promise<void>;
109
+ /**
110
+ * 按原 id 恢复整行(L3 undo / 硬删除逆放)。
111
+ * 与 store() 不同:不重新生成 id。
112
+ */
113
+ importEntry(entry: MemoryEntry): Promise<void>;
104
114
  /** 治理批量读取 */
105
115
  listForGovern(filter?: {
106
116
  includeDeleted?: boolean;
@@ -487,6 +497,8 @@ export interface MemoryWriteSlot {
487
497
  channel: MemoryChannel;
488
498
  importance?: number;
489
499
  tags?: string[];
500
+ /** 命题成立时刻(epoch ms);时效敏感 fact 建议写入 */
501
+ asOf?: number;
490
502
  }
491
503
  /** 门控/置信度可调用的 store 入参 */
492
504
  export type MemoryStoreInput = Omit<MemoryEntry, 'id' | 'accessCount' | 'lastAccessedAt' | 'createdAt' | 'decayFactor'>;
@@ -5,7 +5,7 @@
5
5
  * 为 Web/测试提供「当前/最近 Run」可检视现场。
6
6
  * 观测失败 fail-open,不打断业务路径。
7
7
  */
8
- import { resolveObserverConfig, buildRunMessagesDiff, summarizeLlmMessages, } from './types.js';
8
+ import { resolveObserverConfig, attributeRunMessage, buildRunMessagesDiff, summarizeLlmMessages, } from './types.js';
9
9
  import { buildRunMessagesSnapshot, buildRunScopeView } from './run-snapshot.js';
10
10
  import { buildContextLayersSnapshot } from '../../context/layer-snapshot.js';
11
11
  const SECURITY_EVENT_TYPES = new Set([
@@ -67,6 +67,7 @@ const TIMELINE_TYPES = new Set([
67
67
  'sensitive_data.detected',
68
68
  'security.blocked',
69
69
  'security.behavior_blocked',
70
+ 'run.timing',
70
71
  ]);
71
72
  let runSeq = 0;
72
73
  /** Hub 兜底:scope 未带 runId 时使用(生产路径应由 Runner/createRunId 提供) */
@@ -271,6 +272,11 @@ export class ObserverHub {
271
272
  return {
272
273
  index,
273
274
  role: (m.role || 'unknown'),
275
+ // 归因与 summary.byKind 同源(attributeRunMessage),LLM 视图条目与汇总口径一致
276
+ attribution: attributeRunMessage({
277
+ role: m.role,
278
+ content: (m.content ?? ''),
279
+ }),
274
280
  content: text,
275
281
  contentChars: text.length,
276
282
  contentPreview: text.slice(0, 200),
@@ -378,6 +384,18 @@ export class ObserverHub {
378
384
  record.updatedAt = Date.now();
379
385
  // 继续落入 timeline(若启用)
380
386
  }
387
+ if (event.type === 'tool.effect.ledger') {
388
+ const d = (event.data ?? {});
389
+ const nr = d.notReversed;
390
+ record.toolEffect.undo = {
391
+ entries: Number(d.entries ?? 0),
392
+ truncated: d.truncated === true,
393
+ notReversedReason: nr?.reason,
394
+ notReversedPaths: (nr?.created?.length ?? 0) + (nr?.modified?.length ?? 0) + (nr?.deleted?.length ?? 0),
395
+ };
396
+ record.updatedAt = Date.now();
397
+ return;
398
+ }
381
399
  // memory / tool.effect:从 tool.exec.end 投影
382
400
  if (event.type === 'tool.exec.end' &&
383
401
  (this.config.channels.memory || this.config.channels['tool.effect'])) {
@@ -432,7 +450,19 @@ export class ObserverHub {
432
450
  record.timeline.push(node);
433
451
  const max = this.config.retention.timelineEvents;
434
452
  if (record.timeline.length > max) {
435
- record.timeline.splice(0, record.timeline.length - max);
453
+ // 淘汰优先保留 run.timing(wait/build/run 分段是 run 级指标,不能随事件淘汰丢)
454
+ const excess = record.timeline.length - max;
455
+ let removed = 0;
456
+ for (let i = 0; i < record.timeline.length && removed < excess; i++) {
457
+ if (record.timeline[i].type !== 'run.timing') {
458
+ record.timeline.splice(i, 1);
459
+ i--;
460
+ removed++;
461
+ }
462
+ }
463
+ // 全是 run.timing 时按老规矩从头裁
464
+ if (removed < excess)
465
+ record.timeline.splice(0, excess - removed);
436
466
  }
437
467
  }
438
468
  const life = record.lifecycle;
@@ -604,6 +634,7 @@ export class ObserverHub {
604
634
  elapsedMs: record.guardMetrics?.elapsedMs ?? 0,
605
635
  consecutiveErrors: record.guardMetrics?.consecutiveErrors ?? 0,
606
636
  consecutiveSameTool: record.guardMetrics?.consecutiveSameTool ?? 0,
637
+ consecutiveIdenticalFailures: record.guardMetrics?.consecutiveIdenticalFailures ?? 0,
607
638
  noopStreak: record.guardMetrics?.noopStreak ?? 0,
608
639
  hasProgress: record.guardMetrics?.hasProgress ?? true,
609
640
  uniqueTools: record.guardMetrics?.uniqueTools ?? [],
@@ -624,6 +655,7 @@ export class ObserverHub {
624
655
  elapsedMs: record.lifecycle.durationMs ?? 0,
625
656
  consecutiveErrors: record.guardMetrics?.consecutiveErrors ?? 0,
626
657
  consecutiveSameTool: record.guardMetrics?.consecutiveSameTool ?? 0,
658
+ consecutiveIdenticalFailures: record.guardMetrics?.consecutiveIdenticalFailures ?? 0,
627
659
  noopStreak: record.guardMetrics?.noopStreak ?? 0,
628
660
  hasProgress: record.guardMetrics?.hasProgress ?? true,
629
661
  uniqueTools: record.guardMetrics?.uniqueTools ?? [],
@@ -642,6 +674,7 @@ export class ObserverHub {
642
674
  elapsedMs: record.guardMetrics?.elapsedMs ?? 0,
643
675
  consecutiveErrors: record.guardMetrics?.consecutiveErrors ?? 0,
644
676
  consecutiveSameTool: record.guardMetrics?.consecutiveSameTool ?? 0,
677
+ consecutiveIdenticalFailures: record.guardMetrics?.consecutiveIdenticalFailures ?? 0,
645
678
  noopStreak: record.guardMetrics?.noopStreak ?? 0,
646
679
  hasProgress: record.guardMetrics?.hasProgress ?? false,
647
680
  uniqueTools: record.guardMetrics?.uniqueTools ?? [],
@@ -660,6 +693,7 @@ export class ObserverHub {
660
693
  elapsedMs: record.guardMetrics?.elapsedMs ?? 0,
661
694
  consecutiveErrors: record.guardMetrics?.consecutiveErrors ?? 0,
662
695
  consecutiveSameTool: record.guardMetrics?.consecutiveSameTool ?? 0,
696
+ consecutiveIdenticalFailures: record.guardMetrics?.consecutiveIdenticalFailures ?? 0,
663
697
  noopStreak: record.guardMetrics?.noopStreak ?? 0,
664
698
  hasProgress: record.guardMetrics?.hasProgress ?? true,
665
699
  uniqueTools: record.guardMetrics?.uniqueTools ?? [],
@@ -786,6 +820,7 @@ export class ObserverHub {
786
820
  ? {
787
821
  ...record.toolEffect,
788
822
  tools: record.toolEffect.tools.map((t) => ({ ...t })),
823
+ undo: record.toolEffect.undo ? { ...record.toolEffect.undo } : undefined,
789
824
  notes: record.toolEffect.notes ? [...record.toolEffect.notes] : undefined,
790
825
  }
791
826
  : undefined,
@@ -893,6 +928,21 @@ function stripLayerPayload(snapshot, payload) {
893
928
  }
894
929
  function toTimelineNode(event) {
895
930
  const data = (event.data ?? {});
931
+ // F3 计时段:turn.end 带 llmTiming(LLM 调用计时);run.timing 带 wait/build/run_end 分段
932
+ const timing = data.llmTiming ??
933
+ (event.type === 'run.timing'
934
+ ? {
935
+ stage: data.stage,
936
+ waitMs: data.waitMs,
937
+ buildMs: data.buildMs,
938
+ durMs: data.durMs,
939
+ loopEnd: data.loopEnd,
940
+ stopReason: data.stopReason,
941
+ msgs: data.msgs,
942
+ sysChars: data.sysChars,
943
+ groundingTokens: data.groundingTokens,
944
+ }
945
+ : undefined);
896
946
  return {
897
947
  type: event.type,
898
948
  timestamp: event.timestamp,
@@ -903,5 +953,6 @@ function toTimelineNode(event) {
903
953
  durationMs: typeof data.durationMs === 'number' ? data.durationMs : undefined,
904
954
  reason: (data.reason ?? data.fallbackError),
905
955
  usage: data.usage,
956
+ timing,
906
957
  };
907
958
  }
@@ -1,4 +1,4 @@
1
- export { DEFAULT_OBSERVER_CONFIG, resolveObserverConfig, isChannelEnabled, shouldCaptureMessageFullText, summarizeMessages, summarizeLlmMessages, buildRunMessagesDiff, isHiddenFromChat, attachFullContent, cloneMessages, } from './types.js';
2
- export type { ObserverChannelId, ObserverConfig, ObserverLevel, ResolvedObserverConfig, RunGuardMetricsView, RunLifecycleView, RunMemoryActivityView, RunMessageView, RunMessagesDiff, RunMessagesPhase, RunMessagesSnapshot, RunMessagesSummary, RunMessagesView, RunObservatorySnapshot, RunScopeView, RunSecurityEventView, RunTimelineEventView, RunToolEffectView, RunToolRuntimeView, } from './types.js';
1
+ export { DEFAULT_OBSERVER_CONFIG, resolveObserverConfig, isChannelEnabled, shouldCaptureMessageFullText, summarizeMessages, summarizeLlmMessages, attributeRunMessage, buildRunMessagesDiff, isHiddenFromChat, attachFullContent, cloneMessages, } from './types.js';
2
+ export type { ObserverChannelId, ObserverConfig, ObserverLevel, ResolvedObserverConfig, RunGuardMetricsView, RunLifecycleView, RunMemoryActivityView, RunMessageAttribution, RunMessageView, RunMessagesDiff, RunMessagesPhase, RunMessagesSnapshot, RunMessagesSummary, RunMessagesView, RunObservatorySnapshot, RunScopeView, RunSecurityEventView, RunTimelineEventView, RunToolEffectView, RunToolRuntimeView, } from './types.js';
3
3
  export { buildRunScopeView, buildRunMessagesSnapshot } from './run-snapshot.js';
4
4
  export { ObserverHub } from './hub.js';
@@ -1,3 +1,3 @@
1
- export { DEFAULT_OBSERVER_CONFIG, resolveObserverConfig, isChannelEnabled, shouldCaptureMessageFullText, summarizeMessages, summarizeLlmMessages, buildRunMessagesDiff, isHiddenFromChat, attachFullContent, cloneMessages, } from './types.js';
1
+ export { DEFAULT_OBSERVER_CONFIG, resolveObserverConfig, isChannelEnabled, shouldCaptureMessageFullText, summarizeMessages, summarizeLlmMessages, attributeRunMessage, buildRunMessagesDiff, isHiddenFromChat, attachFullContent, cloneMessages, } from './types.js';
2
2
  export { buildRunScopeView, buildRunMessagesSnapshot } from './run-snapshot.js';
3
3
  export { ObserverHub } from './hub.js';