@octopi-agent/engine 0.98.4 → 0.121.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (493) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -25,6 +25,11 @@ export interface ArchiveManagerOptions {
25
25
  forceArchiveDays?: number;
26
26
  /** 可选 EventBus:归档成功后 emit session.ended */
27
27
  events?: EventBus;
28
+ /** Optional Host observation after archive export and hot-store deletion. */
29
+ onSessionArchived?: (event: {
30
+ sessionId: string;
31
+ agentId: string;
32
+ }) => void | Promise<void>;
28
33
  }
29
34
  export declare class SessionArchiveManager {
30
35
  private store;
@@ -33,6 +38,7 @@ export declare class SessionArchiveManager {
33
38
  private archiveRetentionMs;
34
39
  private forceArchiveMs;
35
40
  private events?;
41
+ private onSessionArchived?;
36
42
  /**
37
43
  * @param store - SessionStore(契约级;不绑具体后端)
38
44
  * @param options - 归档目录与保留策略
@@ -54,14 +60,26 @@ export declare class SessionArchiveManager {
54
60
  private appendToArchive;
55
61
  /**
56
62
  * 查询归档中的 session
63
+ *
64
+ * @param sessionId - 会话 id
65
+ * @param opts - 租户收口(§9.1-2,T4b):带 tenantId 时越域视为不存在(不泄漏存在性)
57
66
  */
58
- queryArchive(sessionId: string): Promise<SessionData | null>;
67
+ queryArchive(sessionId: string, opts?: {
68
+ tenantId?: string;
69
+ }): Promise<SessionData | null>;
59
70
  /**
60
71
  * 列出归档中的 session 元数据
72
+ *
73
+ * @param filter - agentId / tenantId(§9.1-2,T4b):带 tenantId 时只列本域;
74
+ * 兼容旧签名(string = agentId)——绝不静默放宽语义(评审 MIN-3)
61
75
  */
62
- listArchived(agentId?: string): Promise<Array<{
76
+ listArchived(filter?: string | {
77
+ agentId?: string;
78
+ tenantId?: string;
79
+ }): Promise<Array<{
63
80
  sessionId: string;
64
81
  agentId: string;
82
+ tenantId?: string;
65
83
  archivedAt: number;
66
84
  }>>;
67
85
  /**
@@ -11,10 +11,12 @@
11
11
  *
12
12
  * @module
13
13
  */
14
- import { mkdir, readdir, stat, unlink, readFile, writeFile } from 'node:fs/promises';
14
+ import { mkdir, readdir, stat, unlink, readFile } from 'node:fs/promises';
15
15
  import { gzip, gunzip } from 'node:zlib';
16
16
  import { promisify } from 'node:util';
17
17
  import { join } from 'node:path';
18
+ import { atomicWriteFile } from './atomic-tmp.js';
19
+ import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
18
20
  import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
19
21
  export class SessionArchiveManager {
20
22
  store;
@@ -23,6 +25,7 @@ export class SessionArchiveManager {
23
25
  archiveRetentionMs;
24
26
  forceArchiveMs;
25
27
  events;
28
+ onSessionArchived;
26
29
  /**
27
30
  * @param store - SessionStore(契约级;不绑具体后端)
28
31
  * @param options - 归档目录与保留策略
@@ -34,6 +37,7 @@ export class SessionArchiveManager {
34
37
  this.archiveRetentionMs = (options.archiveRetentionDays ?? 180) * 24 * 60 * 60 * 1000;
35
38
  this.forceArchiveMs = (options.forceArchiveDays ?? 90) * 24 * 60 * 60 * 1000;
36
39
  this.events = options.events;
40
+ this.onSessionArchived = options.onSessionArchived;
37
41
  }
38
42
  /**
39
43
  * 执行归档流程
@@ -93,6 +97,14 @@ export class SessionArchiveManager {
93
97
  sessionId: session.id,
94
98
  data: { reason: 'archived' },
95
99
  });
100
+ if (this.onSessionArchived) {
101
+ try {
102
+ await this.onSessionArchived({ sessionId: session.id, agentId: session.agentId });
103
+ }
104
+ catch {
105
+ // Observation cannot undo a completed archive; its adapter records the failure.
106
+ }
107
+ }
96
108
  }
97
109
  /**
98
110
  * 追加一条记录到压缩归档文件(temp + rename,避免截断式写坏当月冷备)
@@ -110,15 +122,18 @@ export class SessionArchiveManager {
110
122
  }
111
123
  const newContent = existing + line;
112
124
  const compressed = await this.compress(Buffer.from(newContent, 'utf-8'));
113
- const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
114
- await writeFile(tmpPath, compressed);
115
- const { rename } = await import('node:fs/promises');
116
- await rename(tmpPath, filePath);
125
+ // tmp+rename 原子落位(读侧不见半截)。已知局限(评审 del-3c3fcfeb MIN-3):
126
+ // existing+line 的读改写无并发串行,同文件并发追加会丢行——当前 runArchive
127
+ // 顺序执行无触发点;启用归档调度前必须按文件路径串行化(arch/open-problems.md)。
128
+ await atomicWriteFile(filePath, compressed);
117
129
  }
118
130
  /**
119
131
  * 查询归档中的 session
132
+ *
133
+ * @param sessionId - 会话 id
134
+ * @param opts - 租户收口(§9.1-2,T4b):带 tenantId 时越域视为不存在(不泄漏存在性)
120
135
  */
121
- async queryArchive(sessionId) {
136
+ async queryArchive(sessionId, opts) {
122
137
  const files = await this.listArchiveFiles();
123
138
  for (const file of files) {
124
139
  try {
@@ -128,6 +143,9 @@ export class SessionArchiveManager {
128
143
  for (const line of lines) {
129
144
  const entry = JSON.parse(line);
130
145
  if (entry.sessionId === sessionId) {
146
+ if (opts?.tenantId !== undefined && (entry.data.meta?.tenantId ?? DEFAULT_TENANT_ID) !== opts.tenantId) {
147
+ return null;
148
+ }
131
149
  return entry.data;
132
150
  }
133
151
  }
@@ -140,8 +158,12 @@ export class SessionArchiveManager {
140
158
  }
141
159
  /**
142
160
  * 列出归档中的 session 元数据
161
+ *
162
+ * @param filter - agentId / tenantId(§9.1-2,T4b):带 tenantId 时只列本域;
163
+ * 兼容旧签名(string = agentId)——绝不静默放宽语义(评审 MIN-3)
143
164
  */
144
- async listArchived(agentId) {
165
+ async listArchived(filter) {
166
+ const normalized = typeof filter === 'string' ? { agentId: filter } : (filter ?? {});
145
167
  const files = await this.listArchiveFiles();
146
168
  const results = [];
147
169
  for (const file of files) {
@@ -152,10 +174,14 @@ export class SessionArchiveManager {
152
174
  for (const line of lines) {
153
175
  const entry = JSON.parse(line);
154
176
  const pick = toIndexPick(entry.data);
155
- if (!agentId || sessionMatchesAgent(pick, agentId)) {
177
+ const entryTenant = entry.data.meta?.tenantId ?? DEFAULT_TENANT_ID;
178
+ if (normalized.tenantId !== undefined && entryTenant !== normalized.tenantId)
179
+ continue;
180
+ if (!normalized.agentId || sessionMatchesAgent(pick, normalized.agentId)) {
156
181
  results.push({
157
182
  sessionId: entry.sessionId,
158
183
  agentId: entry.data.agentId,
184
+ tenantId: entryTenant,
159
185
  archivedAt: entry.archivedAt,
160
186
  });
161
187
  }
@@ -0,0 +1,12 @@
1
+ export declare function atomicTmpPath(target: string): string;
2
+ /**
3
+ * tmp+rename 原子整文件写:读侧任何时刻只见旧版或新版,绝不见半截。
4
+ *
5
+ * (T5 演练实锤 2026-11-14:截断式 writeFile 并发读曾 254/320 次读到空转录,
6
+ * load→save 放大链路会把转录永久清空。)
7
+ *
8
+ * @param target - 目标文件路径
9
+ * @param content - 整文件内容
10
+ * @returns 写入完成(rename 落位)的 Promise
11
+ */
12
+ export declare function atomicWriteFile(target: string, content: string | Buffer): Promise<void>;
@@ -0,0 +1,36 @@
1
+ import { writeFile, rename } from 'node:fs/promises';
2
+ /**
3
+ * 原子写 tmp 路径命名(按「写操作」唯一)。
4
+ *
5
+ * tmp+rename 原子写的前提:tmp 名在同一目标上绝不复用。仅 pid+毫秒 不够——
6
+ * 同毫秒双写共用 tmp 名:先到者 rename 走 tmp,后到者 rename ENOENT;更糟时
7
+ * 后到者 writeFile 的半截被 rename 进目标(静默损坏)。T5 演练实锤 2026-11-14
8
+ * (sessions.json 元索引同毫秒双写)。
9
+ *
10
+ * 前提声明:唯一性成立域是**单机**(pid 不撞);多机共享同一 OCTOPI_HOME(P2
11
+ * 拓扑)时补 random 段兜底。进程内另以单调序号断言同 ms 不复用。
12
+ *
13
+ * @param target - 目标文件路径
14
+ * @returns 该次写操作专属的 tmp 路径(pid + 毫秒 + 进程内单调序号 + 随机段)
15
+ */
16
+ let seq = 0;
17
+ export function atomicTmpPath(target) {
18
+ seq += 1;
19
+ const rand = Math.random().toString(36).slice(2, 8);
20
+ return `${target}.${process.pid}.${Date.now()}.${seq}.${rand}.tmp`;
21
+ }
22
+ /**
23
+ * tmp+rename 原子整文件写:读侧任何时刻只见旧版或新版,绝不见半截。
24
+ *
25
+ * (T5 演练实锤 2026-11-14:截断式 writeFile 并发读曾 254/320 次读到空转录,
26
+ * load→save 放大链路会把转录永久清空。)
27
+ *
28
+ * @param target - 目标文件路径
29
+ * @param content - 整文件内容
30
+ * @returns 写入完成(rename 落位)的 Promise
31
+ */
32
+ export async function atomicWriteFile(target, content) {
33
+ const tmpPath = atomicTmpPath(target);
34
+ await writeFile(tmpPath, content);
35
+ await rename(tmpPath, target);
36
+ }
@@ -5,7 +5,7 @@
5
5
  * <sessionsDir>/
6
6
  * sessions.json ← 所有 session 的元数据索引(键 = sessionId;含 lifecycle 投影)
7
7
  * <sessionId>.jsonl ← 对话记录(JSONL;save 整聚合快照写回,非磁盘 append-only)
8
- * <sessionId>.state.json ← 附带状态(tasks / turns / metadata / 模型 2 字段)
8
+ * <sessionId>.state.json ← 附带状态(tasks / steps / metadata / 模型 2 字段)
9
9
  *
10
10
  * 主键 = sessionId;文件名一律 `toSessionFileName`(跨平台安全)。
11
11
  * 可选 `index`:可重建检索投影(失败不阻断权威写)。禁止把 index 当权威。
@@ -69,6 +69,15 @@ export declare class JsonlSessionStore implements SessionStore<SessionData> {
69
69
  * 整包 save 是常态动作,对齐即自愈。
70
70
  */
71
71
  syncMessages(sessionId: string, messages: readonly unknown[]): Promise<void>;
72
+ /**
73
+ * spawnBy 投影 backfill(每实例一次):升级前落盘的会话其索引条目缺 `spawnBy`
74
+ * (权威值在 state.json),历史隐藏子会话 / 父子归组依赖该投影。
75
+ * 只补缺失条目,幂等;失败不阻断 list(显式降级 = 子会话暂在历史露出),
76
+ * warn 后清缓存待下次 list 重试,不静默吞。
77
+ */
78
+ private spawnLinkBackfill?;
79
+ private ensureSpawnLinkBackfill;
80
+ private backfillSpawnLinks;
72
81
  list(filter?: SessionListFilter): Promise<SessionMeta[]>;
73
82
  /**
74
83
  * 按会话事实 lifecycle 过滤(索引投影;缺省视为 active)。
@@ -5,14 +5,16 @@
5
5
  * <sessionsDir>/
6
6
  * sessions.json ← 所有 session 的元数据索引(键 = sessionId;含 lifecycle 投影)
7
7
  * <sessionId>.jsonl ← 对话记录(JSONL;save 整聚合快照写回,非磁盘 append-only)
8
- * <sessionId>.state.json ← 附带状态(tasks / turns / metadata / 模型 2 字段)
8
+ * <sessionId>.state.json ← 附带状态(tasks / steps / metadata / 模型 2 字段)
9
9
  *
10
10
  * 主键 = sessionId;文件名一律 `toSessionFileName`(跨平台安全)。
11
11
  * 可选 `index`:可重建检索投影(失败不阻断权威写)。禁止把 index 当权威。
12
12
  * `sessions.json` parse 失败会拒绝写回,避免清空 meta。
13
13
  */
14
- import { access, mkdir, readFile, writeFile, unlink, rename, appendFile, stat } from 'node:fs/promises';
14
+ import { access, mkdir, readFile, unlink, appendFile, stat } from 'node:fs/promises';
15
15
  import { join } from 'node:path';
16
+ import { atomicWriteFile } from './atomic-tmp.js';
17
+ import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
16
18
  import { toSessionFileName } from '@octopi-agent/core/session-filename.js';
17
19
  import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
18
20
  async function fileExists(path) {
@@ -45,22 +47,46 @@ function isRefPrefix(synced, incoming) {
45
47
  return true;
46
48
  }
47
49
  /**
48
- * 历史 state.json 的 turns[].input(全量历史快照)已废弃:读取即剥,
50
+ * 历史 state.json 的 turns[].input(全量历史快照;turns 为账本旧字段名)已废弃:读取即剥,turns 整键读入 steps,
49
51
  * 下次 save 自然瘦身。输入正文的唯一权威是 messages JSONL(Discourse)。
50
52
  *
51
53
  * 读取端宽松、写入端严格:legacy 账本可能缺 inputCount(旧格式无此字段),
52
54
  * rest spread 保全其余键,仅类型层面放宽;新写入的账本必含 inputCount。
53
55
  */
54
- function slimTurns(turns) {
55
- if (!Array.isArray(turns))
56
+ function slimSteps(steps) {
57
+ if (!Array.isArray(steps))
56
58
  return [];
57
- return turns.flatMap((t) => {
59
+ return steps.flatMap((t) => {
58
60
  if (!t || typeof t !== 'object')
59
61
  return [];
60
62
  const { input: _dropped, ...rest } = t;
61
63
  return [rest];
62
64
  });
63
65
  }
66
+ /**
67
+ * `sessions.json` 元索引 read-modify-write 串行队列,按 meta 文件路径在**进程内**
68
+ * 共享(模块级:同进程多 store 实例也互斥——daemon 同进程就有双实例)。
69
+ *
70
+ * T5 演练实锤 2026-11-14:元索引是全店共享文件,per-session 的 withWriteLock 挡不住
71
+ * 跨 session 并发 read-modify-write——读旧写旧丢条目,且截断直写曾让并发 delete 6ms
72
+ * 即损坏整份元索引(评审 del-3c3fcfeb MAJ-1/2)。锁序恒为 session 锁 → meta 锁;
73
+ * meta 锁内不取任何 session 锁,无死锁环。回归锚 tests/session-store-write-race.test.ts。
74
+ *
75
+ * 已知边界(勿当已闭):**跨进程**窗口仍在——gateway 与 run-serve 子进程同写一份
76
+ * sessions.json,本锁不跨进程;收口走 P2-1 session-serve 或 flock,登记
77
+ * arch/multi-tenancy.md §9.1-14。
78
+ *
79
+ * @param metaPath - 元索引文件路径(锁键)
80
+ * @param fn - 元索引 RMW 整段(read → mutate → write)
81
+ * @returns fn 的结果
82
+ */
83
+ const metaWriteQueues = new Map();
84
+ function withMetaLock(metaPath, fn) {
85
+ const prev = metaWriteQueues.get(metaPath) ?? Promise.resolve();
86
+ const run = prev.then(fn, fn);
87
+ metaWriteQueues.set(metaPath, run.then(() => undefined, () => undefined));
88
+ return run;
89
+ }
64
90
  export class JsonlSessionStore {
65
91
  sessionsDir;
66
92
  index;
@@ -102,7 +128,7 @@ export class JsonlSessionStore {
102
128
  return null;
103
129
  try {
104
130
  const parsed = JSON.parse(await readFile(statePath, 'utf-8'));
105
- return { ...parsed, turns: slimTurns(parsed?.turns) };
131
+ return { ...parsed, steps: slimSteps(parsed?.steps ?? parsed?.turns) };
106
132
  }
107
133
  catch {
108
134
  return null;
@@ -132,9 +158,7 @@ export class JsonlSessionStore {
132
158
  }
133
159
  async writeMetaIndex(index) {
134
160
  await mkdir(this.sessionsDir, { recursive: true });
135
- const tmpPath = `${this.metaFile()}.${process.pid}.${Date.now()}.tmp`;
136
- await writeFile(tmpPath, JSON.stringify(index, null, 2));
137
- await rename(tmpPath, this.metaFile());
161
+ await atomicWriteFile(this.metaFile(), JSON.stringify(index, null, 2));
138
162
  }
139
163
  buildIndexEntry(data) {
140
164
  const participantAgentIds = data.meta.participantAgentIds ??
@@ -142,6 +166,8 @@ export class JsonlSessionStore {
142
166
  const lifecycle = data.lifecycle?.lifecycle ?? data.meta.lifecycle ?? 'active';
143
167
  return {
144
168
  ...data.meta,
169
+ // 投影取值单一来源:SessionData.tenantId ?? meta.tenantId(legacy);显式放 spread 后
170
+ tenantId: data.tenantId ?? data.meta.tenantId,
145
171
  id: data.id,
146
172
  agentId: data.agentId || data.meta.agentId,
147
173
  primaryAgentId: data.primaryAgentId ?? data.meta.primaryAgentId,
@@ -153,6 +179,9 @@ export class JsonlSessionStore {
153
179
  // 置顶是用户数据:权威在 metadata.pinnedAt(受 save 浅合并保护,
154
180
  // 长驻 run 对象的整包 save 抹不掉);meta.pinnedAt 仅作旧数据回退
155
181
  pinnedAt: readPinnedAt(data.metadata?.pinnedAt) ?? readPinnedAt(data.meta.pinnedAt),
182
+ // 委派来源投影(D7):历史隐藏子会话 / 父子归组(右栏"子会话")依赖本字段;
183
+ // 权威在 state.json 的 spawnBy(存量条目由 ensureSpawnLinkBackfill 补投影)
184
+ spawnBy: data.spawnBy,
156
185
  // 标题是用户数据:权威在 metadata 三键(同 pinnedAt 通道,save 按 titleUpdatedAt 仲裁);
157
186
  // 投影必须覆盖 ...data.meta 展开带出的陈旧 meta.title,不做旧数据回退
158
187
  ...readTitleState(data.metadata),
@@ -177,7 +206,7 @@ export class JsonlSessionStore {
177
206
  if (resolved.state) {
178
207
  try {
179
208
  const parsed = JSON.parse(await readFile(resolved.state, 'utf-8'));
180
- state = { ...parsed, turns: slimTurns(parsed?.turns) };
209
+ state = { ...parsed, steps: slimSteps(parsed?.steps ?? parsed?.turns) };
181
210
  }
182
211
  catch { /* corrupt state, ignore */ }
183
212
  }
@@ -192,6 +221,7 @@ export class JsonlSessionStore {
192
221
  : undefined);
193
222
  return {
194
223
  id: sessionId,
224
+ tenantId: state.tenantId ?? meta?.tenantId,
195
225
  agentId,
196
226
  primaryAgentId: state.primaryAgentId ?? meta?.primaryAgentId ?? agentId,
197
227
  preferredAgentId: state.preferredAgentId ?? meta?.preferredAgentId,
@@ -214,38 +244,43 @@ export class JsonlSessionStore {
214
244
  updatedAt: Date.now(),
215
245
  },
216
246
  messages,
217
- turns: state.turns ?? [],
247
+ steps: state.steps ?? [],
218
248
  metadata: state.metadata ?? {},
219
249
  tasks: state.tasks ?? [],
220
250
  };
221
251
  }
222
252
  async removeSessionFiles(sessionId) {
253
+ // 元索引先摘(meta RMW 归锁 + 原子写)、数据文件后删(MAJ-1,评审 del-3c3fcfeb):
254
+ // 旧序「先删文件、后截断写回索引」曾让并发 delete 6ms 即损坏整份元索引,且读旧
255
+ // 写回会复活/吞掉他人条目。新序 crash 只会留孤儿文件(磁盘清理兜底),不留幽灵
256
+ // 条目。摘除失败如实上抛:吞错只会把「delete 假成功」和「索引损坏」都藏起来。
257
+ const metaPath = this.metaFile();
258
+ if (await fileExists(metaPath)) {
259
+ await withMetaLock(metaPath, async () => {
260
+ const allMeta = await this.readMetaIndex();
261
+ delete allMeta[sessionId];
262
+ await this.writeMetaIndex(allMeta);
263
+ });
264
+ }
223
265
  for (const p of [this.sessionFile(sessionId), this.sessionStateFile(sessionId)]) {
224
266
  if (await fileExists(p)) {
225
267
  await unlink(p);
226
268
  }
227
269
  }
228
- // OP-15:会话附件目录随 session 删除清理
270
+ // OP-15:会话附件目录随 session 删除清理;转换记录同理(F6:摘要正文含用户内容)
229
271
  try {
230
272
  const { rm } = await import('node:fs/promises');
231
273
  const { join } = await import('node:path');
232
274
  const { toSessionFileName } = await import('@octopi-agent/core/session-filename.js');
233
- await rm(join(this.sessionsDir, toSessionFileName(sessionId), 'attachments'), {
234
- recursive: true,
235
- force: true,
236
- });
275
+ for (const dir of ['attachments', 'transform']) {
276
+ await rm(join(this.sessionsDir, toSessionFileName(sessionId), dir), {
277
+ recursive: true,
278
+ force: true,
279
+ });
280
+ }
237
281
  }
238
282
  catch {
239
- // 附件清理失败不阻断 session 删除;残留由磁盘清理兜底
240
- }
241
- const metaPath = this.metaFile();
242
- if (await fileExists(metaPath)) {
243
- try {
244
- const allMeta = await this.readMetaIndex();
245
- delete allMeta[sessionId];
246
- await writeFile(metaPath, JSON.stringify(allMeta, null, 2));
247
- }
248
- catch { /* ignore */ }
283
+ // 附件/转换记录清理失败不阻断 session 删除;残留由磁盘清理兜底
249
284
  }
250
285
  }
251
286
  async load(sessionId) {
@@ -266,7 +301,9 @@ export class JsonlSessionStore {
266
301
  // 写数据文件在前,索引在后:crash 时索引最多缺条目(load 仍能直接读文件),
267
302
  // 不会出现索引有但数据没写完的不一致
268
303
  const jsonl = data.messages.map(msg => JSON.stringify(msg)).join('\n') + '\n';
269
- await writeFile(this.sessionFile(sessionId), jsonl);
304
+ // tmp+rename 原子写(MAJ-2,评审 del-3c3fcfeb):截断直写曾让并发 load 读到
305
+ // 0 条消息(实测 254/320),load→save 放大链路会把转录永久清空
306
+ await atomicWriteFile(this.sessionFile(sessionId), jsonl);
270
307
  // 全量重写后同步增量缓存(防止下一次 syncMessages 误判漂移)
271
308
  this.noteSyncCache(sessionId, Buffer.byteLength(jsonl, 'utf-8'), data.messages.slice());
272
309
  // metadata 浅合并:长驻 run 对象上的陈旧/空 metadata 不得抹掉
@@ -289,26 +326,38 @@ export class JsonlSessionStore {
289
326
  metadata.titleSource = fresh.titleSource;
290
327
  metadata.titleUpdatedAt = fresh.titleUpdatedAt;
291
328
  }
292
- await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
329
+ await atomicWriteFile(this.sessionStateFile(sessionId), JSON.stringify({
330
+ // 字段集必须与 updateMetadata() 的 state 重写保持一致:漏写即静默清字段
331
+ tenantId: data.tenantId ?? data.meta.tenantId,
293
332
  agentId: data.agentId,
294
333
  primaryAgentId: data.primaryAgentId ?? data.agentId,
295
334
  preferredAgentId: data.preferredAgentId,
296
335
  switchAudit: data.switchAudit ?? [],
297
- spawnBy: data.spawnBy,
336
+ // spawnBy 只增不清:陈旧整包 save(从零构造 SessionData)不得抹掉委派关联(D7),
337
+ // 与 metadata 浅合并 / 标题仲裁同哲学;删关联不做(子会话归属是审计链)
338
+ spawnBy: data.spawnBy ?? prevState?.spawnBy,
298
339
  participants: data.participants ?? [],
299
340
  contextDetachIndex: data.contextDetachIndex,
300
341
  contextCompact: data.contextCompact,
301
342
  contextCompacts: data.contextCompacts,
302
343
  lifecycle: data.lifecycle,
303
344
  tasks: data.tasks ?? [],
304
- turns: data.turns ?? [],
345
+ steps: data.steps ?? [],
305
346
  metadata,
306
347
  }, null, 2));
307
348
  // 索引携带 lifecycle 投影:list 过滤 / 归档扫描不必打开 state
308
- // 索引最后更新:数据就绪才写入
309
- const index = await this.readMetaIndex();
310
- index[sessionId] = this.buildIndexEntry({ ...data, id: sessionId, metadata });
311
- await this.writeMetaIndex(index);
349
+ // 索引最后更新:数据就绪才写入(meta RMW 进程内串行,见模块级 withMetaLock)
350
+ await withMetaLock(this.metaFile(), async () => {
351
+ const index = await this.readMetaIndex();
352
+ index[sessionId] = this.buildIndexEntry({
353
+ ...data,
354
+ id: sessionId,
355
+ metadata,
356
+ // 与 state 写同口径:陈旧整包 save 不得抹掉委派关联投影
357
+ spawnBy: data.spawnBy ?? prevState?.spawnBy,
358
+ });
359
+ await this.writeMetaIndex(index);
360
+ });
312
361
  // 可搜投影(失败不阻断;权威已落盘,可 rebuild)
313
362
  if (this.index) {
314
363
  try {
@@ -337,10 +386,12 @@ export class JsonlSessionStore {
337
386
  const replaced = mutate(meta);
338
387
  const metadata = replaced === undefined ? meta : replaced;
339
388
  await mkdir(this.sessionsDir, { recursive: true });
340
- await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
389
+ await atomicWriteFile(this.sessionStateFile(sessionId), JSON.stringify({
390
+ tenantId: prev?.tenantId,
341
391
  agentId: prev?.agentId,
342
392
  // 字段集必须与 save() 的 state 重写保持一致:漏写即静默清字段
343
- //(contextDetachIndex 曾被漏掉——updateMetadata 后租约截断点归零,续跑全量灌窗)
393
+ //(contextDetachIndex 曾被漏掉——updateMetadata 后租约截断点归零,续跑全量灌窗;
394
+ // tenantId 曾被漏掉——load→save 一轮往返把租户会话擦进 default 桶)
344
395
  primaryAgentId: prev?.primaryAgentId ?? prev?.agentId,
345
396
  preferredAgentId: prev?.preferredAgentId,
346
397
  switchAudit: prev?.switchAudit ?? [],
@@ -351,23 +402,27 @@ export class JsonlSessionStore {
351
402
  contextCompacts: prev?.contextCompacts,
352
403
  lifecycle: prev?.lifecycle,
353
404
  tasks: prev?.tasks ?? [],
354
- turns: prev?.turns ?? [],
405
+ steps: prev?.steps ?? [],
355
406
  metadata,
356
407
  }, null, 2));
357
408
  try {
358
- const index = await this.readMetaIndex();
359
- const entry = index[sessionId];
360
- if (entry) {
361
- index[sessionId] = {
362
- ...entry,
363
- // pinnedAt 投影与 buildIndexEntry 同规则(置顶/取消即时可见于 list)
364
- pinnedAt: readPinnedAt(metadata.pinnedAt),
365
- // 标题投影同规则(rename / 自动标题即时可见于 list)
366
- ...readTitleState(metadata),
367
- updatedAt: Date.now(),
368
- };
369
- await this.writeMetaIndex(index);
370
- }
409
+ await withMetaLock(this.metaFile(), async () => {
410
+ const index = await this.readMetaIndex();
411
+ const entry = index[sessionId];
412
+ if (entry) {
413
+ index[sessionId] = {
414
+ ...entry,
415
+ // pinnedAt 投影与 buildIndexEntry 同规则(置顶/取消即时可见于 list)
416
+ pinnedAt: readPinnedAt(metadata.pinnedAt),
417
+ // 委派关联投影同规则(MIN-5:只经历 updateMetadata 的会话也补投影)
418
+ spawnBy: entry.spawnBy ?? prev?.spawnBy,
419
+ // 标题投影同规则(rename / 自动标题即时可见于 list)
420
+ ...readTitleState(metadata),
421
+ updatedAt: Date.now(),
422
+ };
423
+ await this.writeMetaIndex(index);
424
+ }
425
+ });
371
426
  }
372
427
  catch {
373
428
  // 索引投影可重建;metadata 权威已落盘
@@ -408,14 +463,60 @@ export class JsonlSessionStore {
408
463
  }
409
464
  // 整文件对齐走 tmp+rename:读侧(浏览器刷新 load)不得撞见写半截的转录
410
465
  const jsonl = messages.map((m) => JSON.stringify(m)).join('\n') + '\n';
411
- const tmpPath = `${path}.${process.pid}.${Date.now()}.tmp`;
412
- await writeFile(tmpPath, jsonl);
413
- await rename(tmpPath, path);
466
+ await atomicWriteFile(path, jsonl);
414
467
  this.noteSyncCache(sessionId, Buffer.byteLength(jsonl, 'utf-8'), messages.slice());
415
468
  });
416
469
  }
470
+ /**
471
+ * spawnBy 投影 backfill(每实例一次):升级前落盘的会话其索引条目缺 `spawnBy`
472
+ * (权威值在 state.json),历史隐藏子会话 / 父子归组依赖该投影。
473
+ * 只补缺失条目,幂等;失败不阻断 list(显式降级 = 子会话暂在历史露出),
474
+ * warn 后清缓存待下次 list 重试,不静默吞。
475
+ */
476
+ spawnLinkBackfill;
477
+ ensureSpawnLinkBackfill() {
478
+ this.spawnLinkBackfill ??= this.backfillSpawnLinks().then(() => undefined, (err) => {
479
+ this.spawnLinkBackfill = undefined;
480
+ console.warn(`[JsonlSessionStore] spawnBy backfill failed: ${err instanceof Error ? err.message : String(err)}`);
481
+ });
482
+ return this.spawnLinkBackfill;
483
+ }
484
+ async backfillSpawnLinks() {
485
+ const snapshot = await this.readMetaIndex();
486
+ const missing = Object.values(snapshot).filter((e) => !e.spawnBy);
487
+ if (missing.length === 0)
488
+ return;
489
+ // state 读取放锁外(只读;state 原子写保证不读到半截);meta 锁内只做短 RMW 补写
490
+ const patches = new Map();
491
+ for (const entry of missing) {
492
+ const spawnBy = (await this.readStateData(entry.id))?.spawnBy;
493
+ if (spawnBy)
494
+ patches.set(entry.id, spawnBy);
495
+ }
496
+ if (patches.size === 0)
497
+ return;
498
+ await withMetaLock(this.metaFile(), async () => {
499
+ const index = await this.readMetaIndex();
500
+ let changed = false;
501
+ for (const [id, spawnBy] of patches) {
502
+ const entry = index[id];
503
+ if (entry && !entry.spawnBy) {
504
+ entry.spawnBy = spawnBy;
505
+ changed = true;
506
+ }
507
+ }
508
+ if (changed)
509
+ await this.writeMetaIndex(index);
510
+ });
511
+ }
417
512
  async list(filter) {
513
+ await this.ensureSpawnLinkBackfill();
418
514
  let entries = Object.values(await this.readMetaIndex());
515
+ if (filter?.tenantId) {
516
+ const tenantId = filter.tenantId;
517
+ // 历史缺省视作 'default'(multi-tenancy §5 渐进迁移)
518
+ entries = entries.filter((e) => (e.tenantId ?? DEFAULT_TENANT_ID) === tenantId);
519
+ }
419
520
  if (filter?.agentId) {
420
521
  const agentId = filter.agentId;
421
522
  entries = entries.filter((e) => sessionMatchesAgent(e, agentId));
@@ -21,6 +21,11 @@ export declare function createSqliteSessionIndex(options: {
21
21
  wal?: boolean;
22
22
  /** 默认自动探测 FTS5;false 则只用 LIKE */
23
23
  fts?: boolean;
24
+ /**
25
+ * 只读打开(P1-1a / MAJ-6):不写 WAL、不做 DDL(schema 归写者门面首建)——
26
+ * run 侧 prefilter 消费用本模式,保证 sessions.index.db 单写者纪律。
27
+ */
28
+ readOnly?: boolean;
24
29
  }): Promise<SessionIndexBackend>;
25
30
  /**
26
31
  * 从 JsonlSessionStore 全量重建投影。
@@ -57,8 +57,13 @@ export async function createSqliteSessionIndex(options) {
57
57
  catch {
58
58
  throw new Error(`SqliteSessionIndex requires Node.js >= 24 built-in "node:sqlite". Current process.version=${process.version}`);
59
59
  }
60
- const index = new SqliteSessionIndex(DatabaseSyncCtor, options.dbPath, options.wal !== false, options.fts !== false);
61
- await index.ensureSchema();
60
+ const index = new SqliteSessionIndex(DatabaseSyncCtor, options.dbPath, options.readOnly === true ? false : options.wal !== false, options.fts !== false, options.readOnly === true);
61
+ if (options.readOnly === true) {
62
+ await index.probeFtsReadOnly();
63
+ }
64
+ else {
65
+ await index.ensureSchema();
66
+ }
62
67
  return index;
63
68
  }
64
69
  /** FTS5 字面量:双引号包裹,内部引号翻倍 */
@@ -72,16 +77,32 @@ class SqliteSessionIndex {
72
77
  db;
73
78
  wantFts;
74
79
  fts = false;
75
- constructor(Ctor, dbPath, wal, wantFts) {
76
- this.db = new Ctor(dbPath, { timeout: 5000, enableForeignKeyConstraints: false });
80
+ readOnly;
81
+ constructor(Ctor, dbPath, wal, wantFts, readOnly = false) {
82
+ this.db = new Ctor(dbPath, {
83
+ timeout: 5000,
84
+ enableForeignKeyConstraints: false,
85
+ ...(readOnly ? { readOnly: true } : {}),
86
+ });
77
87
  if (wal)
78
88
  this.db.exec('PRAGMA journal_mode = WAL');
79
89
  this.wantFts = wantFts;
90
+ this.readOnly = readOnly;
91
+ }
92
+ /** 只读模式的 FTS 探测(不建表;缺表 = 纯 LIKE) */
93
+ async probeFtsReadOnly() {
94
+ const row = this.db
95
+ .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='messages_fts'")
96
+ .get();
97
+ this.fts = this.wantFts && row !== undefined;
80
98
  }
81
99
  get ftsEnabled() {
82
100
  return this.fts;
83
101
  }
84
102
  async ensureSchema() {
103
+ if (this.readOnly) {
104
+ throw new Error('SqliteSessionIndex: ensureSchema refused on readOnly handle (schema belongs to the writer facade)');
105
+ }
85
106
  this.db.exec(`
86
107
  CREATE TABLE IF NOT EXISTS index_meta (
87
108
  key TEXT PRIMARY KEY,