@octopi-agent/engine 0.65.0 → 0.86.38

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 (421) 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 +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  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 +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  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 +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  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 +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  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 +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -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/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  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/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -0,0 +1,396 @@
1
+ /**
2
+ * LLM Wire Dump — 把 provider 实际发送的请求体按 session 落盘
3
+ *
4
+ * 目的:前缀缓存是否命中,只取决于「本次请求输入前缀 vs 上一次请求」的逐字节一致性。
5
+ * 现有观测(Observer `context.llm`)只能看到 ContextEngine 出口的 role/content 视图,
6
+ * 既不含 tools,也不含 provider 侧变换(Anthropic system 提升、OpenAI sanitize/flatten),
7
+ * 因此无法回答「前缀到底在哪一条消息、哪个字节断开」。
8
+ *
9
+ * 落盘形态(每个调用两份):
10
+ * - `<dir>/<session>/<id>.json` —— 完整请求体(wire body,逐字节同实际发送)
11
+ * - `<dir>/<session>/index.jsonl` —— 轻量索引(每消息 hash/长度 + toolsHash + 结果/usage)
12
+ *
13
+ * 设计约束:
14
+ * - 默认关闭(写盘量按请求体 × 调用次数计,长 session 可能很大)。
15
+ * - 写入串行排队且不阻塞调用方(fire-and-forget);`flush()` 供测试/优雅退出等待。
16
+ * - 每 session 环形上限 `maxCallsPerSession`:超出后删除最旧的 body 文件并压缩索引。
17
+ *
18
+ * @module integration/providers/wire-dump
19
+ */
20
+ import { createHash, randomBytes } from 'node:crypto';
21
+ import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
22
+ import { join } from 'node:path';
23
+ import { getOctopiHome } from '../../paths.js';
24
+ /** 缺省落盘根目录 */
25
+ export function defaultWireDumpDir() {
26
+ return join(getOctopiHome(), 'logs', 'llm-requests');
27
+ }
28
+ /**
29
+ * 从 wire body 提取前缀单元文本(比对与落盘的唯一权威顺序)
30
+ *
31
+ * - OpenAI:`body.messages`
32
+ * - Anthropic:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义上位于最前
33
+ *
34
+ * @param body - provider 实际发送的请求体
35
+ * @returns 前缀单元(role + 该单元 JSON 文本)
36
+ */
37
+ export function wireUnitPayloads(body) {
38
+ const payloads = [];
39
+ const messages = Array.isArray(body.messages) ? body.messages : [];
40
+ // 顶层 system 在 wire 语义上永远位于最前,无条件作为首单元:
41
+ // 若某 body 同时含 inline system 消息(第三方 provider 可能如此),漏掉顶层 system
42
+ // 会让它的变化完全不触发 divergence。OpenAI/Anthropic 都不会产生这种并存。
43
+ const system = body.system;
44
+ if (typeof system === 'string' && system.length > 0) {
45
+ payloads.push({ role: 'system', text: JSON.stringify({ role: 'system', content: system }) });
46
+ }
47
+ for (const msg of messages) {
48
+ const role = msg != null && typeof msg === 'object' && typeof msg.role === 'string'
49
+ ? (msg.role)
50
+ : 'unknown';
51
+ payloads.push({ role, text: JSON.stringify(msg ?? null) });
52
+ }
53
+ return payloads;
54
+ }
55
+ /**
56
+ * 从 wire body 提取用于前缀比对的最小单元序列
57
+ *
58
+ * @param body - provider 实际发送的请求体
59
+ * @returns 前缀单元(role/len/hash)
60
+ */
61
+ export function extractWireUnits(body) {
62
+ return wireUnitPayloads(body).map((p) => ({ role: p.role, len: p.text.length, hash: shortHash(p.text) }));
63
+ }
64
+ /** 目录名安全化:sessionId 可能含 `:` `/` 等 */
65
+ export function sanitizeSessionDirName(sessionId) {
66
+ return sessionId.replace(/[^A-Za-z0-9._-]/g, '_') || '_unknown';
67
+ }
68
+ /**
69
+ * 创建 wire dump sink
70
+ *
71
+ * @param options - 落盘目录 / 环形上限 / 身份解析
72
+ * @returns sink;capture 返回的句柄用于回填结果
73
+ */
74
+ export function createWireDumpSink(options = {}) {
75
+ const rootDir = options.dir ?? defaultWireDumpDir();
76
+ const maxCalls = options.maxCallsPerSession ?? 200;
77
+ const maxBodyBytes = options.maxBodyBytes ?? 8_000_000;
78
+ const resolveContext = options.resolveContext;
79
+ let seq = 0;
80
+ let queue = Promise.resolve();
81
+ // 调用 id 的实例段:同进程内可能有多个 sink(daemon + 一次 CLI run),
82
+ // 各自 seq 从 1 起、Date.now() 同毫秒,只靠 at+seq 会撞 id,裁剪时连新行一起删掉
83
+ const instanceTag = randomBytes(4).toString('hex');
84
+ /** session 目录 → 已写调用 id(升序),用于环形裁剪 */
85
+ const writtenBySession = new Map();
86
+ const primedSessions = new Set();
87
+ const enqueue = (task) => {
88
+ queue = queue.then(() => task()).catch(() => {
89
+ // 观测 fail-open:写盘失败绝不影响请求路径(唯一失败面是本模块自身的 IO)
90
+ });
91
+ };
92
+ const sessionDirPath = (sessionId) => join(rootDir, sanitizeSessionDirName(sessionId));
93
+ /**
94
+ * 首次写入某 session 时,用磁盘现有索引恢复环形状态(进程重启不覆盖旧文件)
95
+ *
96
+ * 以 index.jsonl 的 request 行顺序为准:oversize 调用没有 body 文件,只扫目录会漏掉它们,
97
+ * 导致这些行的环形逐出永远不发生。旧目录(索引尚未生成)才退回按 body 文件名恢复。
98
+ */
99
+ const primeSession = (dir) => {
100
+ if (primedSessions.has(dir))
101
+ return;
102
+ primedSessions.add(dir);
103
+ const indexPath = join(dir, 'index.jsonl');
104
+ try {
105
+ if (existsSync(indexPath)) {
106
+ const ids = readFileSync(indexPath, 'utf8')
107
+ .split('\n')
108
+ .filter((line) => line.trim().length > 0)
109
+ .map((line) => {
110
+ try {
111
+ const rec = JSON.parse(line);
112
+ return rec.type === 'request' ? rec.id : null;
113
+ }
114
+ catch {
115
+ // 半行(进程被杀)没有 id 可供恢复;后续行仍可读
116
+ return null;
117
+ }
118
+ })
119
+ .filter((id) => id != null);
120
+ writtenBySession.set(dir, ids);
121
+ return;
122
+ }
123
+ if (!existsSync(dir))
124
+ return;
125
+ const ids = readdirSync(dir)
126
+ .filter((f) => f.endsWith('.json'))
127
+ .map((f) => f.slice(0, -'.json'.length))
128
+ .sort(compareCallIds);
129
+ writtenBySession.set(dir, ids);
130
+ }
131
+ catch {
132
+ writtenBySession.set(dir, []);
133
+ }
134
+ };
135
+ /** 环形裁剪:删除最旧 body 文件并压缩索引(保持 index 与现存 body 一致) */
136
+ const trimSession = (dir) => {
137
+ const ids = writtenBySession.get(dir) ?? [];
138
+ if (ids.length <= maxCalls)
139
+ return;
140
+ const remove = ids.splice(0, ids.length - maxCalls);
141
+ const removeSet = new Set(remove);
142
+ for (const id of remove) {
143
+ try {
144
+ unlinkSync(join(dir, `${id}.json`));
145
+ }
146
+ catch {
147
+ // 文件可能已被人工清理;索引压缩仍按 removeSet 进行
148
+ }
149
+ }
150
+ const indexPath = join(dir, 'index.jsonl');
151
+ try {
152
+ if (!existsSync(indexPath))
153
+ return;
154
+ const records = readFileSync(indexPath, 'utf8')
155
+ .split('\n')
156
+ .filter((line) => line.trim().length > 0)
157
+ .map((line) => {
158
+ try {
159
+ return JSON.parse(line);
160
+ }
161
+ catch {
162
+ return null;
163
+ }
164
+ })
165
+ .filter((rec) => rec != null)
166
+ .filter((rec) => !removeSet.has(rec.id));
167
+ // 没有对应 request 行的 result(旧数据/人工删行后)一并清掉,避免孤儿行无限累积
168
+ const liveIds = new Set(records.filter((rec) => rec.type === 'request').map((rec) => rec.id));
169
+ const kept = records
170
+ .filter((rec) => rec.type === 'request' || liveIds.has(rec.id))
171
+ .map((rec) => JSON.stringify(rec));
172
+ writeFileSync(indexPath, kept.length > 0 ? `${kept.join('\n')}\n` : '');
173
+ }
174
+ catch {
175
+ // 索引压缩失败仅导致索引偏大;body 已删,diff 侧按缺失 body 降级为纯 hash 比对
176
+ }
177
+ };
178
+ const capture = (input) => {
179
+ const ctx = resolveContext?.();
180
+ const sessionId = ctx?.sessionId ?? '_unscoped';
181
+ const dir = sessionDirPath(sessionId);
182
+ const at = Date.now();
183
+ seq += 1;
184
+ const n = seq;
185
+ // 实例段保证跨 sink / 跨进程唯一:at+seq 在同毫秒内会重复
186
+ const id = `${at}-${n}-${instanceTag}`;
187
+ // 序列化/哈希在调用方线程完成:body 在此刻定型(排队期间不会被后续代码改写),
188
+ // 只有落盘 I/O 进入队列——「不阻塞调用方」指不等待磁盘。
189
+ const units = extractWireUnits(input.body);
190
+ const bodyJson = JSON.stringify(input.body);
191
+ const bodyBytes = Buffer.byteLength(bodyJson, 'utf8');
192
+ const oversize = bodyBytes > maxBodyBytes;
193
+ const toolJson = input.body.tools ? JSON.stringify(input.body.tools) : '';
194
+ const toolsHash = toolJson ? shortHash(toolJson) : '';
195
+ const chars = units.reduce((sum, u) => sum + u.len, 0);
196
+ const request = {
197
+ type: 'request',
198
+ id,
199
+ at,
200
+ n,
201
+ sessionId: ctx?.sessionId,
202
+ agentId: ctx?.agentId,
203
+ runId: ctx?.runId,
204
+ provider: input.provider,
205
+ model: input.model,
206
+ mode: input.mode,
207
+ msgCount: units.length,
208
+ chars,
209
+ bodyBytes,
210
+ oversize,
211
+ toolCount: Array.isArray(input.body.tools) ? input.body.tools.length : 0,
212
+ toolsHash,
213
+ roles: units.map((u) => u.role),
214
+ lens: units.map((u) => u.len),
215
+ hashes: units.map((u) => u.hash),
216
+ file: oversize ? undefined : `${id}.json`,
217
+ };
218
+ enqueue(() => {
219
+ mkdirSync(dir, { recursive: true });
220
+ primeSession(dir);
221
+ if (!oversize) {
222
+ writeFileSync(join(dir, `${id}.json`), bodyJson);
223
+ }
224
+ const ids = writtenBySession.get(dir) ?? [];
225
+ ids.push(id);
226
+ writtenBySession.set(dir, ids);
227
+ appendFileSync(join(dir, 'index.jsonl'), `${JSON.stringify(request)}\n`);
228
+ trimSession(dir);
229
+ });
230
+ return {
231
+ id,
232
+ finish: (result) => {
233
+ const record = {
234
+ type: 'result',
235
+ id,
236
+ at: Date.now(),
237
+ outcome: result.outcome,
238
+ durationMs: Math.max(0, Math.round(result.durationMs)),
239
+ ttftMs: result.ttftMs != null ? Math.max(0, Math.round(result.ttftMs)) : undefined,
240
+ usage: result.usage
241
+ ? {
242
+ inputCachedTokens: result.usage.inputCachedTokens,
243
+ inputUncachedTokens: result.usage.inputUncachedTokens,
244
+ inputCacheWriteTokens: result.usage.inputCacheWriteTokens,
245
+ inputReportedTokens: result.usage.inputReportedTokens,
246
+ outputTokens: result.usage.outputTokens,
247
+ cacheAware: result.usage.cacheAware,
248
+ }
249
+ : undefined,
250
+ };
251
+ enqueue(() => {
252
+ // 该调用的 request 行已被环形裁剪(长流式调用可能在收尾前被逐出):
253
+ // 再追加 result 只会留下永远不被逐出的孤儿行,直接丢弃
254
+ const ids = writtenBySession.get(dir);
255
+ if (!ids?.includes(id))
256
+ return;
257
+ appendFileSync(join(dir, 'index.jsonl'), `${JSON.stringify(record)}\n`);
258
+ });
259
+ },
260
+ };
261
+ };
262
+ return {
263
+ capture,
264
+ flush: () => queue,
265
+ };
266
+ }
267
+ /** 16 位短 hash(sha256 前 8 字节)——足够区分前缀单元,日志体积可控 */
268
+ function shortHash(text) {
269
+ return createHash('sha256').update(text).digest('hex').slice(0, 16);
270
+ }
271
+ /**
272
+ * 调用 id 形如 `<at>-<n>-<instanceTag>`:按 `at`、`n` 数值比较,其余段按字符串
273
+ *
274
+ * 整体字典序会把 `n=10` 排到 `n=2` 之前,环形逐出会因此删错调用。
275
+ *
276
+ * @param a - 调用 id
277
+ * @param b - 调用 id
278
+ * @returns 比较结果(<0 / 0 / >0)
279
+ */
280
+ function compareCallIds(a, b) {
281
+ const pa = a.split('-');
282
+ const pb = b.split('-');
283
+ for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
284
+ const sa = pa[i] ?? '';
285
+ const sb = pb[i] ?? '';
286
+ const na = Number(sa);
287
+ const nb = Number(sb);
288
+ if (sa !== '' && sb !== '' && Number.isFinite(na) && Number.isFinite(nb)) {
289
+ if (na !== nb)
290
+ return na - nb;
291
+ }
292
+ else if (sa !== sb) {
293
+ return sa < sb ? -1 : 1;
294
+ }
295
+ }
296
+ return 0;
297
+ }
298
+ /**
299
+ * 给 provider 套一层 wire dump 装饰器
300
+ *
301
+ * 请求体由 provider 自己的 `wireBodyFor` 构造(同一 builder),装饰器只负责落盘与计时;
302
+ * 不支持该能力的 provider 原样透传(不落盘)。
303
+ *
304
+ * @param inner - 真实 provider
305
+ * @param sink - 落盘 sink
306
+ * @returns 透传装饰器
307
+ */
308
+ export function withWireDump(inner, sink) {
309
+ const builder = inner;
310
+ const buildBody = (request, mode) => {
311
+ if (typeof builder.wireBodyFor !== 'function')
312
+ return null;
313
+ try {
314
+ return builder.wireBodyFor.call(inner, request, mode);
315
+ }
316
+ catch {
317
+ // 观测 fail-open:body 构造失败绝不能影响真实请求(唯一失败面是本模块自身的判定)
318
+ return null;
319
+ }
320
+ };
321
+ const modelOf = (request) => request.model ?? inner.defaultModel ?? '';
322
+ /** 捕获失败(hash/序列化异常)不得影响真实请求 */
323
+ const tryCapture = (request, mode) => {
324
+ try {
325
+ const body = buildBody(request, mode);
326
+ if (!body)
327
+ return undefined;
328
+ return sink.capture({ provider: inner.name, model: modelOf(request), mode, body });
329
+ }
330
+ catch {
331
+ return undefined;
332
+ }
333
+ };
334
+ return {
335
+ name: inner.name,
336
+ defaultModel: inner.defaultModel,
337
+ models: inner.models,
338
+ isAvailable: () => inner.isAvailable(),
339
+ getModelInfo: (modelName) => inner.getModelInfo(modelName),
340
+ getModelInfos: () => inner.getModelInfos(),
341
+ chat: async (request) => {
342
+ const handle = tryCapture(request, 'chat');
343
+ const startedAt = Date.now();
344
+ try {
345
+ const res = await inner.chat(request);
346
+ handle?.finish({ outcome: 'ok', usage: res.usage, durationMs: Date.now() - startedAt });
347
+ return res;
348
+ }
349
+ catch (err) {
350
+ handle?.finish({ outcome: 'error', durationMs: Date.now() - startedAt });
351
+ throw err;
352
+ }
353
+ },
354
+ stream: async function* (request) {
355
+ const handle = tryCapture(request, 'stream');
356
+ if (!handle) {
357
+ yield* inner.stream(request);
358
+ return;
359
+ }
360
+ const startedAt = Date.now();
361
+ let ttftMs;
362
+ let usage;
363
+ let sawDone = false;
364
+ let completed = false;
365
+ let failed = false;
366
+ try {
367
+ for await (const chunk of inner.stream(request)) {
368
+ if (ttftMs == null)
369
+ ttftMs = Date.now() - startedAt;
370
+ if (chunk.type === 'done') {
371
+ sawDone = true;
372
+ }
373
+ // usage 通常只在 done chunk 上;任何 chunk 携带都取,避免缺哨兵时丢掉已消耗额度
374
+ if (chunk.usage)
375
+ usage = chunk.usage;
376
+ yield chunk;
377
+ }
378
+ completed = true;
379
+ }
380
+ catch (err) {
381
+ failed = true;
382
+ throw err;
383
+ }
384
+ finally {
385
+ handle.finish({
386
+ // 正常读完但服务端没发 done 哨兵(代理断流/兼容实现)不等于消费者放弃:
387
+ // 判 abandoned 会把真实完成记成"提前中断",并误报给 llm-diff
388
+ outcome: failed ? 'error' : sawDone || completed ? 'ok' : 'abandoned',
389
+ usage,
390
+ ttftMs,
391
+ durationMs: Date.now() - startedAt,
392
+ });
393
+ }
394
+ },
395
+ };
396
+ }
@@ -26,10 +26,14 @@ export interface JsonlSessionStoreOptions {
26
26
  export declare class JsonlSessionStore implements SessionStore<SessionData> {
27
27
  private readonly sessionsDir;
28
28
  private readonly index?;
29
+ /** 同 sessionId 读改写串行(save / updateMetadata / delete) */
30
+ private readonly writeQueues;
29
31
  /**
30
32
  * @param options - sessionsDir + 可选 index
31
33
  */
32
34
  constructor(options: JsonlSessionStoreOptions);
35
+ private withWriteLock;
36
+ private readStateData;
33
37
  private metaFile;
34
38
  private sessionFile;
35
39
  private sessionStateFile;
@@ -40,6 +44,13 @@ export declare class JsonlSessionStore implements SessionStore<SessionData> {
40
44
  private removeSessionFiles;
41
45
  load(sessionId: string): Promise<SessionData | null>;
42
46
  save(sessionId: string, data: SessionData): Promise<void>;
47
+ /**
48
+ * metadata 原子读改写(含删键)。与 save 同会话串行。
49
+ *
50
+ * @param sessionId - 会话 id
51
+ * @param mutate - 原地修改 meta,或返回替换对象;返回 undefined 表示用原地结果
52
+ */
53
+ updateMetadata(sessionId: string, mutate: (meta: Record<string, unknown>) => void | Record<string, unknown>): Promise<void>;
43
54
  list(filter?: SessionListFilter): Promise<SessionMeta[]>;
44
55
  /**
45
56
  * 按会话事实 lifecycle 过滤(索引投影;缺省视为 active)。
@@ -24,9 +24,32 @@ async function fileExists(path) {
24
24
  return false;
25
25
  }
26
26
  }
27
+ /** pinnedAt 投影:仅接受有限数值(epoch ms),其余视为未置顶 */
28
+ function readPinnedAt(value) {
29
+ return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
30
+ }
31
+ /**
32
+ * 历史 state.json 的 turns[].input(全量历史快照)已废弃:读取即剥,
33
+ * 下次 save 自然瘦身。输入正文的唯一权威是 messages JSONL(Discourse)。
34
+ *
35
+ * 读取端宽松、写入端严格:legacy 账本可能缺 inputCount(旧格式无此字段),
36
+ * rest spread 保全其余键,仅类型层面放宽;新写入的账本必含 inputCount。
37
+ */
38
+ function slimTurns(turns) {
39
+ if (!Array.isArray(turns))
40
+ return [];
41
+ return turns.flatMap((t) => {
42
+ if (!t || typeof t !== 'object')
43
+ return [];
44
+ const { input: _dropped, ...rest } = t;
45
+ return [rest];
46
+ });
47
+ }
27
48
  export class JsonlSessionStore {
28
49
  sessionsDir;
29
50
  index;
51
+ /** 同 sessionId 读改写串行(save / updateMetadata / delete) */
52
+ writeQueues = new Map();
30
53
  /**
31
54
  * @param options - sessionsDir + 可选 index
32
55
  */
@@ -34,6 +57,24 @@ export class JsonlSessionStore {
34
57
  this.sessionsDir = options.sessionsDir;
35
58
  this.index = options.index;
36
59
  }
60
+ withWriteLock(sessionId, fn) {
61
+ const prev = this.writeQueues.get(sessionId) ?? Promise.resolve();
62
+ const run = prev.then(fn, fn);
63
+ this.writeQueues.set(sessionId, run.then(() => undefined, () => undefined));
64
+ return run;
65
+ }
66
+ async readStateData(sessionId) {
67
+ const statePath = this.sessionStateFile(sessionId);
68
+ if (!(await fileExists(statePath)))
69
+ return null;
70
+ try {
71
+ const parsed = JSON.parse(await readFile(statePath, 'utf-8'));
72
+ return { ...parsed, turns: slimTurns(parsed?.turns) };
73
+ }
74
+ catch {
75
+ return null;
76
+ }
77
+ }
37
78
  metaFile() {
38
79
  return join(this.sessionsDir, 'sessions.json');
39
80
  }
@@ -76,6 +117,9 @@ export class JsonlSessionStore {
76
117
  lifecycle,
77
118
  endedAt: data.lifecycle?.endedAt ?? data.meta.endedAt,
78
119
  archivedAt: data.lifecycle?.archivedAt ?? data.meta.archivedAt,
120
+ // 置顶是用户数据:权威在 metadata.pinnedAt(受 save 浅合并保护,
121
+ // 长驻 run 对象的整包 save 抹不掉);meta.pinnedAt 仅作旧数据回退
122
+ pinnedAt: readPinnedAt(data.metadata?.pinnedAt) ?? readPinnedAt(data.meta.pinnedAt),
79
123
  };
80
124
  }
81
125
  async readSession(sessionId, resolved) {
@@ -96,7 +140,8 @@ export class JsonlSessionStore {
96
140
  let state = {};
97
141
  if (resolved.state) {
98
142
  try {
99
- state = JSON.parse(await readFile(resolved.state, 'utf-8'));
143
+ const parsed = JSON.parse(await readFile(resolved.state, 'utf-8'));
144
+ state = { ...parsed, turns: slimTurns(parsed?.turns) };
100
145
  }
101
146
  catch { /* corrupt state, ignore */ }
102
147
  }
@@ -115,7 +160,9 @@ export class JsonlSessionStore {
115
160
  primaryAgentId: state.primaryAgentId ?? meta?.primaryAgentId ?? agentId,
116
161
  preferredAgentId: state.preferredAgentId ?? meta?.preferredAgentId,
117
162
  switchAudit: state.switchAudit,
163
+ spawnBy: state.spawnBy,
118
164
  participants: state.participants,
165
+ contextDetachIndex: state.contextDetachIndex,
119
166
  contextCompact: state.contextCompact,
120
167
  contextCompacts: state.contextCompacts,
121
168
  lifecycle,
@@ -178,39 +225,99 @@ export class JsonlSessionStore {
178
225
  });
179
226
  }
180
227
  async save(sessionId, data) {
181
- await mkdir(this.sessionsDir, { recursive: true });
182
- // 写数据文件在前,索引在后:crash 时索引最多缺条目(load 仍能直接读文件),
183
- // 不会出现索引有但数据没写完的不一致
184
- const jsonl = data.messages.map(msg => JSON.stringify(msg)).join('\n') + '\n';
185
- await writeFile(this.sessionFile(sessionId), jsonl);
186
- await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
187
- agentId: data.agentId,
188
- primaryAgentId: data.primaryAgentId ?? data.agentId,
189
- preferredAgentId: data.preferredAgentId,
190
- switchAudit: data.switchAudit ?? [],
191
- participants: data.participants ?? [],
192
- contextCompact: data.contextCompact,
193
- contextCompacts: data.contextCompacts,
194
- lifecycle: data.lifecycle,
195
- tasks: data.tasks ?? [],
196
- turns: data.turns ?? [],
197
- metadata: data.metadata ?? {},
198
- }, null, 2));
199
- // 索引携带 lifecycle 投影:list 过滤 / 归档扫描不必打开 state
200
- // 索引最后更新:数据就绪才写入
201
- const index = await this.readMetaIndex();
202
- index[sessionId] = this.buildIndexEntry({ ...data, id: sessionId });
203
- await this.writeMetaIndex(index);
204
- // 可搜投影(失败不阻断;权威已落盘,可 rebuild)
205
- if (this.index) {
228
+ return this.withWriteLock(sessionId, async () => {
229
+ await mkdir(this.sessionsDir, { recursive: true });
230
+ // 写数据文件在前,索引在后:crash 时索引最多缺条目(load 仍能直接读文件),
231
+ // 不会出现索引有但数据没写完的不一致
232
+ const jsonl = data.messages.map(msg => JSON.stringify(msg)).join('\n') + '\n';
233
+ await writeFile(this.sessionFile(sessionId), jsonl);
234
+ // metadata 浅合并:长驻 run 对象上的陈旧/空 metadata 不得抹掉
235
+ // 并发 updateMetadata 写入的键(clientToolCalls / fileReleases…)。
236
+ // 删键必须走 updateMetadata。
237
+ const prevState = await this.readStateData(sessionId);
238
+ const metadata = {
239
+ ...(prevState?.metadata ?? {}),
240
+ ...(data.metadata ?? {}),
241
+ };
242
+ await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
243
+ agentId: data.agentId,
244
+ primaryAgentId: data.primaryAgentId ?? data.agentId,
245
+ preferredAgentId: data.preferredAgentId,
246
+ switchAudit: data.switchAudit ?? [],
247
+ spawnBy: data.spawnBy,
248
+ participants: data.participants ?? [],
249
+ contextDetachIndex: data.contextDetachIndex,
250
+ contextCompact: data.contextCompact,
251
+ contextCompacts: data.contextCompacts,
252
+ lifecycle: data.lifecycle,
253
+ tasks: data.tasks ?? [],
254
+ turns: data.turns ?? [],
255
+ metadata,
256
+ }, null, 2));
257
+ // 索引携带 lifecycle 投影:list 过滤 / 归档扫描不必打开 state
258
+ // 索引最后更新:数据就绪才写入
259
+ const index = await this.readMetaIndex();
260
+ index[sessionId] = this.buildIndexEntry({ ...data, id: sessionId, metadata });
261
+ await this.writeMetaIndex(index);
262
+ // 可搜投影(失败不阻断;权威已落盘,可 rebuild)
263
+ if (this.index) {
264
+ try {
265
+ await this.index.upsertFromSession(sessionId, { ...data, id: sessionId, metadata });
266
+ }
267
+ catch (err) {
268
+ // 投影可重建,吞掉索引写失败(不拖垮权威 save)
269
+ console.warn(`[JsonlSessionStore] session index upsert failed for ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);
270
+ }
271
+ }
272
+ });
273
+ }
274
+ /**
275
+ * metadata 原子读改写(含删键)。与 save 同会话串行。
276
+ *
277
+ * @param sessionId - 会话 id
278
+ * @param mutate - 原地修改 meta,或返回替换对象;返回 undefined 表示用原地结果
279
+ */
280
+ async updateMetadata(sessionId, mutate) {
281
+ return this.withWriteLock(sessionId, async () => {
282
+ const prev = await this.readStateData(sessionId);
283
+ const hasMessages = await fileExists(this.sessionFile(sessionId));
284
+ if (!prev && !hasMessages)
285
+ return;
286
+ const meta = { ...(prev?.metadata ?? {}) };
287
+ const replaced = mutate(meta);
288
+ const metadata = replaced === undefined ? meta : replaced;
289
+ await mkdir(this.sessionsDir, { recursive: true });
290
+ await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
291
+ agentId: prev?.agentId,
292
+ primaryAgentId: prev?.primaryAgentId,
293
+ preferredAgentId: prev?.preferredAgentId,
294
+ switchAudit: prev?.switchAudit ?? [],
295
+ spawnBy: prev?.spawnBy,
296
+ participants: prev?.participants ?? [],
297
+ contextCompact: prev?.contextCompact,
298
+ contextCompacts: prev?.contextCompacts,
299
+ lifecycle: prev?.lifecycle,
300
+ tasks: prev?.tasks ?? [],
301
+ turns: prev?.turns ?? [],
302
+ metadata,
303
+ }, null, 2));
206
304
  try {
207
- await this.index.upsertFromSession(sessionId, { ...data, id: sessionId });
305
+ const index = await this.readMetaIndex();
306
+ const entry = index[sessionId];
307
+ if (entry) {
308
+ index[sessionId] = {
309
+ ...entry,
310
+ // pinnedAt 投影与 buildIndexEntry 同规则(置顶/取消即时可见于 list)
311
+ pinnedAt: readPinnedAt(metadata.pinnedAt),
312
+ updatedAt: Date.now(),
313
+ };
314
+ await this.writeMetaIndex(index);
315
+ }
208
316
  }
209
- catch (err) {
210
- // 投影可重建,吞掉索引写失败(不拖垮权威 save)
211
- console.warn(`[JsonlSessionStore] session index upsert failed for ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);
317
+ catch {
318
+ // 索引投影可重建;metadata 权威已落盘
212
319
  }
213
- }
320
+ });
214
321
  }
215
322
  async list(filter) {
216
323
  let entries = Object.values(await this.readMetaIndex());
@@ -229,15 +336,17 @@ export class JsonlSessionStore {
229
336
  return entries.filter((e) => (e.lifecycle ?? 'active') === lifecycle);
230
337
  }
231
338
  async delete(sessionId) {
232
- await this.removeSessionFiles(sessionId);
233
- if (this.index) {
234
- try {
235
- await this.index.remove(sessionId);
339
+ return this.withWriteLock(sessionId, async () => {
340
+ await this.removeSessionFiles(sessionId);
341
+ if (this.index) {
342
+ try {
343
+ await this.index.remove(sessionId);
344
+ }
345
+ catch {
346
+ // 投影可重建
347
+ }
236
348
  }
237
- catch {
238
- // 投影可重建
239
- }
240
- }
349
+ });
241
350
  }
242
351
  async exists(sessionId) {
243
352
  return (await fileExists(this.sessionFile(sessionId)))