@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
@@ -6,7 +6,7 @@
6
6
  * 原则:原件 + .manifest.json 为权威;抽取/索引可重建。
7
7
  */
8
8
  import { createHash, randomUUID } from 'node:crypto';
9
- import { readFileSync } from 'node:fs';
9
+ import { readFileSync, statSync } from 'node:fs';
10
10
  import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
11
11
  import { join } from 'node:path';
12
12
  import { resolveSessionAttachmentsPaths } from './paths.js';
@@ -14,6 +14,20 @@ import { attachmentExtension, isPathInside, sanitizeAttachmentName } from './san
14
14
  import { classifyAttachmentKind, extractCompanionName, extractText, isPlainReadable, } from './extract.js';
15
15
  import { DEFAULT_ATTACHMENT_LIMITS, } from './types.js';
16
16
  import { isDocumentExtractError } from '../../capabilities/document/errors.js';
17
+ import { SessionAttachmentRecallIndex, attachmentExtractHash } from './recall-index.js';
18
+ /** 同一进程内跨 Service 实例的 Session 写临界区,避免多文件上传末写覆盖。 */
19
+ const sessionWriteTails = new Map();
20
+ function serializeSessionWrite(sessionId, operation) {
21
+ const previous = sessionWriteTails.get(sessionId) ?? Promise.resolve();
22
+ const current = previous.then(operation, operation);
23
+ const tail = current.then(() => undefined, () => undefined);
24
+ sessionWriteTails.set(sessionId, tail);
25
+ void tail.finally(() => {
26
+ if (sessionWriteTails.get(sessionId) === tail)
27
+ sessionWriteTails.delete(sessionId);
28
+ });
29
+ return current;
30
+ }
17
31
  export class SessionAttachmentService {
18
32
  sessionsDir;
19
33
  limits;
@@ -79,113 +93,195 @@ export class SessionAttachmentService {
79
93
  * @throws 超限 / 类型不允许
80
94
  */
81
95
  async save(sessionId, input) {
82
- const name = sanitizeAttachmentName(input.name);
83
- const ext = attachmentExtension(name);
84
- if (this.limits.allowedExtensions.length > 0 && ext && !this.limits.allowedExtensions.includes(ext)) {
85
- throw new Error(`file type not allowed: ${ext}`);
86
- }
87
- if (!ext && this.limits.allowedExtensions.length > 0) {
88
- throw new Error('file type not allowed: missing extension');
89
- }
90
- const data = Buffer.isBuffer(input.data)
91
- ? input.data
92
- : typeof input.data === 'string'
93
- ? Buffer.from(input.data, 'utf8')
94
- : Buffer.from(input.data);
95
- if (data.byteLength > this.limits.maxFileBytes) {
96
- throw new Error(`file exceeds maxFileBytes (${this.limits.maxFileBytes})`);
97
- }
98
- const manifest = this.readManifest(sessionId);
99
- const live = manifest.items.filter((i) => i.status !== 'promoted');
100
- if (live.length >= this.limits.maxFiles) {
101
- throw new Error(`too many attachments (max ${this.limits.maxFiles})`);
102
- }
103
- const total = live.reduce((s, i) => s + i.sizeBytes, 0) + data.byteLength;
104
- if (total > this.limits.maxTotalBytes) {
105
- throw new Error(`attachments exceed maxTotalBytes (${this.limits.maxTotalBytes})`);
106
- }
107
- const root = this.attachmentRoot(sessionId);
108
- await mkdir(root, { recursive: true });
109
- const uniqueName = this.uniqueName(live, name);
110
- const abs = join(root, uniqueName);
111
- if (!isPathInside(root, abs)) {
112
- throw new Error('invalid attachment path');
113
- }
114
- await writeFile(abs, data);
115
- const kind = classifyAttachmentKind(uniqueName);
116
- const contentHash = createHash('sha256').update(data).digest('hex');
117
- const item = {
118
- id: `att_${randomUUID().slice(0, 12)}`,
119
- name: uniqueName,
120
- mime: input.mime ?? guessMime(uniqueName),
121
- sizeBytes: data.byteLength,
122
- contentHash: `sha256:${contentHash}`,
123
- path: uniqueName,
124
- status: 'ready',
125
- kind,
126
- createdAt: Date.now(),
127
- };
128
- if (isPlainReadable(kind, uniqueName)) {
129
- item.extractPath = uniqueName;
130
- const extracted = extractText(data, uniqueName, kind);
131
- if (extracted) {
132
- item.status = 'parsed';
133
- item.parse = { ok: true, chars: extracted.chars };
96
+ return serializeSessionWrite(sessionId, async () => {
97
+ const name = sanitizeAttachmentName(input.name);
98
+ const ext = attachmentExtension(name);
99
+ if (this.limits.allowedExtensions.length > 0 && ext && !this.limits.allowedExtensions.includes(ext)) {
100
+ throw new Error(`file type not allowed: ${ext}`);
134
101
  }
135
- else {
136
- item.status = 'parse_failed';
137
- item.parse = { ok: false, error: 'binary content in text extension' };
102
+ if (!ext && this.limits.allowedExtensions.length > 0) {
103
+ throw new Error('file type not allowed: missing extension');
138
104
  }
139
- }
140
- else if (kind === 'document' && this.documentPort) {
141
- const companion = extractCompanionName(uniqueName);
142
- item.extractPath = companion;
143
- try {
144
- const result = await this.documentPort.extract({
145
- data: new Uint8Array(data),
146
- name: uniqueName,
147
- });
148
- const absExtract = join(root, companion);
149
- if (!isPathInside(root, absExtract)) {
150
- throw new Error('invalid extract path');
151
- }
152
- await writeFile(absExtract, result.markdown);
153
- item.status = 'parsed';
154
- item.parse = { ok: true, chars: result.markdown.length };
105
+ const data = Buffer.isBuffer(input.data)
106
+ ? input.data
107
+ : typeof input.data === 'string'
108
+ ? Buffer.from(input.data, 'utf8')
109
+ : Buffer.from(input.data);
110
+ if (data.byteLength > this.limits.maxFileBytes) {
111
+ throw new Error(`file exceeds maxFileBytes (${this.limits.maxFileBytes})`);
112
+ }
113
+ const manifest = this.readManifest(sessionId);
114
+ const live = manifest.items.filter((i) => i.status !== 'promoted');
115
+ if (live.length >= this.limits.maxFiles) {
116
+ throw new Error(`too many attachments (max ${this.limits.maxFiles})`);
117
+ }
118
+ const total = live.reduce((s, i) => s + i.sizeBytes, 0) + data.byteLength;
119
+ if (total > this.limits.maxTotalBytes) {
120
+ throw new Error(`attachments exceed maxTotalBytes (${this.limits.maxTotalBytes})`);
155
121
  }
156
- catch (err) {
157
- item.status = 'parse_failed';
158
- if (isDocumentExtractError(err)) {
159
- item.parse = {
160
- ok: false,
161
- error: `${err.code}${err.requires ? ` (requires: ${err.requires.join(',')})` : ''}`,
162
- };
122
+ const root = this.attachmentRoot(sessionId);
123
+ await mkdir(root, { recursive: true });
124
+ const uniqueName = this.uniqueName(live, name);
125
+ const abs = join(root, uniqueName);
126
+ if (!isPathInside(root, abs)) {
127
+ throw new Error('invalid attachment path');
128
+ }
129
+ await writeFile(abs, data);
130
+ const kind = classifyAttachmentKind(uniqueName);
131
+ const contentHash = createHash('sha256').update(data).digest('hex');
132
+ const item = {
133
+ id: `att_${randomUUID().slice(0, 12)}`,
134
+ name: uniqueName,
135
+ mime: input.mime ?? guessMime(uniqueName),
136
+ sizeBytes: data.byteLength,
137
+ contentHash: `sha256:${contentHash}`,
138
+ path: uniqueName,
139
+ status: 'ready',
140
+ kind,
141
+ createdAt: Date.now(),
142
+ };
143
+ if (isPlainReadable(kind, uniqueName)) {
144
+ item.extractPath = uniqueName;
145
+ const extracted = extractText(data, uniqueName, kind);
146
+ if (extracted) {
147
+ item.status = 'parsed';
148
+ item.parse = { ok: true, chars: extracted.chars };
163
149
  }
164
150
  else {
165
- item.parse = {
166
- ok: false,
167
- error: err instanceof Error ? err.message : String(err),
168
- };
151
+ item.status = 'parse_failed';
152
+ item.parse = { ok: false, error: 'binary content in text extension' };
153
+ }
154
+ }
155
+ else if (kind === 'document' && this.documentPort) {
156
+ const companion = extractCompanionName(uniqueName);
157
+ item.extractPath = companion;
158
+ try {
159
+ const result = await this.documentPort.extract({
160
+ data: new Uint8Array(data),
161
+ name: uniqueName,
162
+ });
163
+ const absExtract = join(root, companion);
164
+ if (!isPathInside(root, absExtract)) {
165
+ throw new Error('invalid extract path');
166
+ }
167
+ await writeFile(absExtract, result.markdown);
168
+ item.status = 'parsed';
169
+ item.parse = { ok: true, chars: result.markdown.length };
170
+ }
171
+ catch (err) {
172
+ item.status = 'parse_failed';
173
+ if (isDocumentExtractError(err)) {
174
+ item.parse = {
175
+ ok: false,
176
+ error: `${err.code}${err.requires ? ` (requires: ${err.requires.join(',')})` : ''}`,
177
+ };
178
+ }
179
+ else {
180
+ item.parse = {
181
+ ok: false,
182
+ error: err instanceof Error ? err.message : String(err),
183
+ };
184
+ }
169
185
  }
170
186
  }
187
+ else if (kind === 'image') {
188
+ item.status = 'ready';
189
+ }
190
+ else if (kind === 'document') {
191
+ item.status = 'ready';
192
+ item.parse = {
193
+ ok: false,
194
+ error: 'document extract disabled (no DocumentPort)',
195
+ };
196
+ }
197
+ else {
198
+ item.status = 'ready';
199
+ item.parse = { ok: false, error: 'no extractor for this type (see OP adapter)' };
200
+ }
201
+ manifest.items.push(item);
202
+ await this.indexSavedAttachment(sessionId, item);
203
+ await this.writeManifest(sessionId, manifest);
204
+ return item;
205
+ });
206
+ }
207
+ /**
208
+ * 上传解析成功后默认建立 Session 私有关键词投影,不注册 Knowledge source。
209
+ * 索引是可重建降级面:失败不影响原件与抽取文本的保存。
210
+ */
211
+ async indexSavedAttachment(sessionId, item) {
212
+ if (!item.extractPath || !item.parse?.ok)
213
+ return;
214
+ const root = this.attachmentRoot(sessionId);
215
+ const rel = item.extractPath;
216
+ const abs = join(root, rel);
217
+ if (!isPathInside(root, abs))
218
+ return;
219
+ try {
220
+ const text = readFileSync(abs, 'utf8');
221
+ await new SessionAttachmentRecallIndex(root).upsert(item, text, item.path);
222
+ const stat = statSync(abs);
223
+ Object.assign(item.parse, {
224
+ extractHash: attachmentExtractHash(item, text),
225
+ extractBytes: stat.size,
226
+ extractMtimeMs: stat.mtimeMs,
227
+ extractCtimeMs: stat.ctimeMs,
228
+ });
171
229
  }
172
- else if (kind === 'image') {
173
- item.status = 'ready';
230
+ catch {
231
+ // 投影失败仅使本轮召回走 structure_tools,不损失附件读取能力。
174
232
  }
175
- else if (kind === 'document') {
176
- item.status = 'ready';
177
- item.parse = {
178
- ok: false,
179
- error: 'document extract disabled (no DocumentPort)',
180
- };
233
+ }
234
+ /**
235
+ * 查询本轮附件的本地关键词召回;索引不可用由调用方回退 structure_tools。
236
+ *
237
+ * @param sessionId - 会话 id
238
+ * @param query - 局部检索焦点
239
+ * @param attachmentIds - 本轮已授权的附件范围
240
+ * @param limit - 全局 top-k
241
+ */
242
+ async recall(sessionId, query, attachmentIds, limit) {
243
+ const attachments = attachmentIds
244
+ .map((id) => this.get(sessionId, id))
245
+ .filter((a) => a != null && a.status !== 'promoted');
246
+ try {
247
+ return await new SessionAttachmentRecallIndex(this.attachmentRoot(sessionId))
248
+ .search(query, attachments, limit);
181
249
  }
182
- else {
183
- item.status = 'ready';
184
- item.parse = { ok: false, error: 'no extractor for this type (see OP adapter)' };
250
+ catch {
251
+ // 缺失/损坏/陈旧索引:与零命中区分,统一由注入层回退 structure_tools。
252
+ return null;
185
253
  }
186
- manifest.items.push(item);
187
- await this.writeManifest(sessionId, manifest);
188
- return item;
254
+ }
255
+ /**
256
+ * 从 manifest + 完整抽取文本重建本地投影;全部读取成功后才替换旧投影。
257
+ * 普通发送不调用此重路径,索引不可用时仍按 structure_tools 降级。
258
+ *
259
+ * @param sessionId - 会话 id
260
+ */
261
+ async rebuildRecall(sessionId) {
262
+ return serializeSessionWrite(sessionId, async () => {
263
+ const manifest = this.readManifest(sessionId);
264
+ const items = manifest.items
265
+ .filter((a) => a.status !== 'promoted' && a.extractPath && a.parse?.ok)
266
+ .map((attachment) => {
267
+ const text = this.readExtractedText(sessionId, attachment.id);
268
+ const stat = statSync(join(this.attachmentRoot(sessionId), attachment.extractPath));
269
+ return { attachment, text, stat, sourcePath: attachment.path };
270
+ });
271
+ if (items.some((item) => item.text == null)) {
272
+ throw new Error('attachment extract unavailable; recall index was not replaced');
273
+ }
274
+ await new SessionAttachmentRecallIndex(this.attachmentRoot(sessionId)).rebuild(items.map((item) => ({ ...item, text: item.text })));
275
+ for (const { attachment, text, stat } of items) {
276
+ Object.assign(attachment.parse, {
277
+ extractHash: attachmentExtractHash(attachment, text),
278
+ extractBytes: stat.size,
279
+ extractMtimeMs: stat.mtimeMs,
280
+ extractCtimeMs: stat.ctimeMs,
281
+ });
282
+ }
283
+ await this.writeManifest(sessionId, manifest);
284
+ });
189
285
  }
190
286
  /**
191
287
  * 删除附件(原件 + 伴生 + manifest 条目)
@@ -194,29 +290,37 @@ export class SessionAttachmentService {
194
290
  * @param attachmentId - 附件 id
195
291
  */
196
292
  async delete(sessionId, attachmentId) {
197
- const manifest = this.readManifest(sessionId);
198
- const idx = manifest.items.findIndex((i) => i.id === attachmentId);
199
- if (idx < 0)
200
- return false;
201
- const item = manifest.items[idx];
202
- if (item.status === 'promoted') {
203
- throw new Error('attachment already promoted; delete from project source');
204
- }
205
- const root = this.attachmentRoot(sessionId);
206
- const absFile = join(root, item.path);
207
- if (!isPathInside(root, absFile)) {
208
- throw new Error('invalid attachment path in manifest');
209
- }
210
- await safeUnlink(absFile);
211
- if (item.extractPath && item.extractPath !== item.path) {
212
- const absExtract = join(root, item.extractPath);
213
- if (isPathInside(root, absExtract)) {
214
- await safeUnlink(absExtract);
293
+ return serializeSessionWrite(sessionId, async () => {
294
+ const manifest = this.readManifest(sessionId);
295
+ const idx = manifest.items.findIndex((i) => i.id === attachmentId);
296
+ if (idx < 0)
297
+ return false;
298
+ const item = manifest.items[idx];
299
+ if (item.status === 'promoted') {
300
+ throw new Error('attachment already promoted; delete from project source');
215
301
  }
216
- }
217
- manifest.items.splice(idx, 1);
218
- await this.writeManifest(sessionId, manifest);
219
- return true;
302
+ const root = this.attachmentRoot(sessionId);
303
+ const absFile = join(root, item.path);
304
+ if (!isPathInside(root, absFile)) {
305
+ throw new Error('invalid attachment path in manifest');
306
+ }
307
+ await safeUnlink(absFile);
308
+ if (item.extractPath && item.extractPath !== item.path) {
309
+ const absExtract = join(root, item.extractPath);
310
+ if (isPathInside(root, absExtract)) {
311
+ await safeUnlink(absExtract);
312
+ }
313
+ }
314
+ manifest.items.splice(idx, 1);
315
+ try {
316
+ await new SessionAttachmentRecallIndex(root).remove(attachmentId);
317
+ }
318
+ catch {
319
+ // 索引缺失/损坏时已不可召回;原件与登记删除仍须完成。
320
+ }
321
+ await this.writeManifest(sessionId, manifest);
322
+ return true;
323
+ });
220
324
  }
221
325
  /**
222
326
  * 会话删除 / 归档清理:移除整个附件目录
@@ -224,8 +328,10 @@ export class SessionAttachmentService {
224
328
  * @param sessionId - 会话 id
225
329
  */
226
330
  async deleteAll(sessionId) {
227
- const root = this.attachmentRoot(sessionId);
228
- await rm(root, { recursive: true, force: true });
331
+ return serializeSessionWrite(sessionId, async () => {
332
+ const root = this.attachmentRoot(sessionId);
333
+ await rm(root, { recursive: true, force: true });
334
+ });
229
335
  }
230
336
  /**
231
337
  * 标记已绑定可检索 source
@@ -235,13 +341,15 @@ export class SessionAttachmentService {
235
341
  * @param sourceId - Knowledge source id
236
342
  */
237
343
  async markSearchable(sessionId, attachmentId, sourceId) {
238
- const manifest = this.readManifest(sessionId);
239
- const item = manifest.items.find((i) => i.id === attachmentId);
240
- if (!item)
241
- throw new Error(`attachment not found: ${attachmentId}`);
242
- item.searchableSourceId = sourceId;
243
- await this.writeManifest(sessionId, manifest);
244
- return item;
344
+ return serializeSessionWrite(sessionId, async () => {
345
+ const manifest = this.readManifest(sessionId);
346
+ const item = manifest.items.find((i) => i.id === attachmentId);
347
+ if (!item)
348
+ throw new Error(`attachment not found: ${attachmentId}`);
349
+ item.searchableSourceId = sourceId;
350
+ await this.writeManifest(sessionId, manifest);
351
+ return item;
352
+ });
245
353
  }
246
354
  /**
247
355
  * 标记已归入项目(文件移出后调用)
@@ -251,14 +359,22 @@ export class SessionAttachmentService {
251
359
  * @param info - 项目信息
252
360
  */
253
361
  async markPromoted(sessionId, attachmentId, info) {
254
- const manifest = this.readManifest(sessionId);
255
- const item = manifest.items.find((i) => i.id === attachmentId);
256
- if (!item)
257
- throw new Error(`attachment not found: ${attachmentId}`);
258
- item.status = 'promoted';
259
- item.promoted = { ...info, at: Date.now() };
260
- await this.writeManifest(sessionId, manifest);
261
- return item;
362
+ return serializeSessionWrite(sessionId, async () => {
363
+ const manifest = this.readManifest(sessionId);
364
+ const item = manifest.items.find((i) => i.id === attachmentId);
365
+ if (!item)
366
+ throw new Error(`attachment not found: ${attachmentId}`);
367
+ item.status = 'promoted';
368
+ item.promoted = { ...info, at: Date.now() };
369
+ try {
370
+ await new SessionAttachmentRecallIndex(this.attachmentRoot(sessionId)).remove(attachmentId);
371
+ }
372
+ catch {
373
+ // 可重建投影清理失败不阻断权威 promote 状态迁移。
374
+ }
375
+ await this.writeManifest(sessionId, manifest);
376
+ return item;
377
+ });
262
378
  }
263
379
  /**
264
380
  * 绝对路径(工具 / promote 用)
@@ -320,14 +436,17 @@ export class SessionAttachmentService {
320
436
  const parsed = JSON.parse(raw);
321
437
  return { sessionId, version: 1, items: parsed.items ?? [] };
322
438
  }
323
- catch {
324
- return { sessionId, version: 1, items: [] };
439
+ catch (err) {
440
+ if (err.code === 'ENOENT') {
441
+ return { sessionId, version: 1, items: [] };
442
+ }
443
+ throw err;
325
444
  }
326
445
  }
327
446
  async writeManifest(sessionId, manifest) {
328
447
  const { root, manifestPath } = resolveSessionAttachmentsPaths(this.sessionsDir, sessionId);
329
448
  await mkdir(root, { recursive: true });
330
- const tmp = `${manifestPath}.${process.pid}.tmp`;
449
+ const tmp = `${manifestPath}.${process.pid}.${randomUUID()}.tmp`;
331
450
  await writeFile(tmp, JSON.stringify(manifest, null, 2));
332
451
  await rename(tmp, manifestPath);
333
452
  }
@@ -9,6 +9,12 @@ export interface AttachmentParseInfo {
9
9
  ok: boolean;
10
10
  chars?: number;
11
11
  error?: string;
12
+ /** sha256(originalHash + NUL + fullExtractText),由解析/索引构建写入 */
13
+ extractHash?: string;
14
+ /** 抽取文件建索引时的大小与 mtime/ctime;代次变化才重读全文验 hash */
15
+ extractBytes?: number;
16
+ extractMtimeMs?: number;
17
+ extractCtimeMs?: number;
12
18
  }
13
19
  /** 单条会话附件(manifest 条目) */
14
20
  export interface SessionAttachment {
@@ -6,6 +6,7 @@
6
6
  *
7
7
  * @layer harness/session — Session 域纯内存默认实现(非生产落盘后端)。
8
8
  */
9
+ import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
9
10
  import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
10
11
  function toIndexPick(s) {
11
12
  return {
@@ -44,7 +45,13 @@ export class InMemorySessionStore {
44
45
  metadata.titleSource = freshTitle.titleSource;
45
46
  metadata.titleUpdatedAt = freshTitle.titleUpdatedAt;
46
47
  }
47
- this.sessions.set(sessionId, { ...data, id: sessionId, metadata });
48
+ // spawnBy 只增不清(与 JsonlSessionStore.save 同口径):陈旧整包 save 不得抹掉委派关联(D7)
49
+ this.sessions.set(sessionId, {
50
+ ...data,
51
+ id: sessionId,
52
+ metadata,
53
+ spawnBy: data.spawnBy ?? prev?.spawnBy,
54
+ });
48
55
  }
49
56
  async updateMetadata(sessionId, mutate) {
50
57
  const prev = this.sessions.get(sessionId);
@@ -74,8 +81,11 @@ export class InMemorySessionStore {
74
81
  const values = Array.from(this.sessions.values());
75
82
  return values
76
83
  .filter((s) => (filter?.agentId ? sessionMatchesAgent(toIndexPick(s), filter.agentId) : true))
84
+ // 历史缺省视作 DEFAULT_TENANT_ID(与 JsonlSessionStore.list 同规则,共享常量保证)
85
+ .filter((s) => (filter?.tenantId ? (s.tenantId ?? DEFAULT_TENANT_ID) === filter.tenantId : true))
77
86
  .map((s) => ({
78
87
  ...s.meta,
88
+ tenantId: s.tenantId,
79
89
  primaryAgentId: s.primaryAgentId ?? s.meta.primaryAgentId,
80
90
  preferredAgentId: s.preferredAgentId ?? s.meta.preferredAgentId,
81
91
  participantAgentIds: toIndexPick(s).participantAgentIds,
@@ -83,6 +93,8 @@ export class InMemorySessionStore {
83
93
  pinnedAt: typeof s.metadata?.pinnedAt === 'number' && Number.isFinite(s.metadata.pinnedAt)
84
94
  ? s.metadata.pinnedAt
85
95
  : s.meta.pinnedAt,
96
+ // 与 JsonlSessionStore.buildIndexEntry 同规则:委派来源投影(D7)
97
+ spawnBy: s.spawnBy,
86
98
  // 与 JsonlSessionStore.buildIndexEntry 同规则:标题权威在 metadata 三键(无旧数据回退)
87
99
  ...readTitleState(s.metadata),
88
100
  }));
@@ -71,9 +71,14 @@ export declare class SessionScheduleService {
71
71
  private coalesceSeen;
72
72
  constructor(options?: SessionScheduleServiceOptions);
73
73
  /**
74
- * 打开/建库并重臂 active 作业。幂等。
74
+ * 打开/建库。幂等(先开者语义为准)。
75
+ *
76
+ * @param options - `arm: false` = 只开 store 不重臂/不起 tick(执行面用:§5.4
77
+ * 触发面唯一在 gateway,run 节点若重臂会把到期作业经空 wakeup 静默消费)
75
78
  */
76
- open(): Promise<void>;
79
+ open(options?: {
80
+ arm?: boolean;
81
+ }): Promise<void>;
77
82
  /** 兜底扫描:防 timer 丢失(P1) */
78
83
  private startTick;
79
84
  /**
@@ -163,6 +168,9 @@ export declare class SessionScheduleService {
163
168
  */
164
169
  purgeSession(sessionId: string): number;
165
170
  private disarm;
171
+ /** store-only 模式(执行面,open({arm:false})):不点火/不起 tick/不自消费——
172
+ * set/update/resume 经本口也不得 arm(否则到期作业被空 wakeup 静默消费)。 */
173
+ private armEnabled;
166
174
  private arm;
167
175
  private rearmAll;
168
176
  /** 测试/手动触发(穿冷却语义:仅 active) */
@@ -69,13 +69,19 @@ export class SessionScheduleService {
69
69
  this.notify = options.notify;
70
70
  }
71
71
  /**
72
- * 打开/建库并重臂 active 作业。幂等。
72
+ * 打开/建库。幂等(先开者语义为准)。
73
+ *
74
+ * @param options - `arm: false` = 只开 store 不重臂/不起 tick(执行面用:§5.4
75
+ * 触发面唯一在 gateway,run 节点若重臂会把到期作业经空 wakeup 静默消费)
73
76
  */
74
- async open() {
77
+ async open(options) {
75
78
  if (this.opened)
76
79
  return;
77
80
  this.store = await SessionScheduleStore.create(this.options);
78
81
  this.opened = true;
82
+ this.armEnabled = options?.arm !== false;
83
+ if (!this.armEnabled)
84
+ return;
79
85
  this.rearmAll();
80
86
  this.startTick();
81
87
  }
@@ -460,7 +466,12 @@ export class SessionScheduleService {
460
466
  }
461
467
  this.firing.delete(id);
462
468
  }
469
+ /** store-only 模式(执行面,open({arm:false})):不点火/不起 tick/不自消费——
470
+ * set/update/resume 经本口也不得 arm(否则到期作业被空 wakeup 静默消费)。 */
471
+ armEnabled = true;
463
472
  arm(schedule) {
473
+ if (!this.armEnabled)
474
+ return;
464
475
  if (schedule.status !== 'active')
465
476
  return;
466
477
  this.disarm(schedule.id);
@@ -50,6 +50,18 @@ export function createTaskListTool(service) {
50
50
  },
51
51
  },
52
52
  },
53
+ /**
54
+ * 结果老化:**整体丢弃**,只留「调用发生过」的最小标记。
55
+ *
56
+ * 依据:任务状态在本请求里已有**活读**副本——`renderSessionTasksInjection(session.tasks)`
57
+ * 每次 run 起点注入 `<session_tasks>`(未完成 goal 的 id / status / description /
58
+ * 步骤进度 / 进展备注)。所以旧的 task_list 结果不是信息补充,而是**同一信息的
59
+ * 过期副本**;而 task_list 是本地查询、零网络成本,重查比读副本更准。
60
+ *
61
+ * 不给「计数摘要」:计数器没有时态标记,40 条消息后会被读成当前事实;
62
+ * 活注入写的是「当前会话未完成任务」,时态明确。
63
+ */
64
+ ageResult: () => '[stale task_list] call task_list again for current tasks',
53
65
  handler: async (args, context) => {
54
66
  const status = args.status;
55
67
  const parentId = args.parent_id;