@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
@@ -0,0 +1,50 @@
1
+ /**
2
+ * assemble-global-tools — 全局工具面装配单源(daemon 与 run 节点共用)。
3
+ *
4
+ * 面分割(arch/service-topology.md §4/§10):工具(tool)面随执行节点——生产执行在
5
+ * run 实例进程内,工具必须在该进程构建(gateway 侧 `globalTools: []` 不是缺省而是无面)。
6
+ * 本工厂把原 daemon 内联装配(summary L1/L2 端口 → session 历史端口 → 凭证库 →
7
+ * web search → createToolSet)抽为共用单源,daemon 与 run-serve-child 各带一套调用点。
8
+ *
9
+ * 失败降级形态随原装配冻结(每块 try/catch + 显式 warn:L1-only / scan-only / 无凭证),
10
+ * 降级是「真实尝试失败后」的兜底,不是占位返回。
11
+ */
12
+ import type { RegisteredTool } from '@octopi-agent/core/types.js';
13
+ import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
14
+ import type { SessionHistoryOptions } from '../../harness/session/history/index.js';
15
+ import type { ToolSetConfig } from '../../harness/extension/plugin-ecosystem/tools/tool-set.js';
16
+ import type { AskUserCallback } from '../../harness/extension/plugin-ecosystem/tools/ask-user.js';
17
+ export interface GlobalToolSetContext {
18
+ /** LLM provider 注册表(summary 压缩模型面;fallback = 首个注册值) */
19
+ providers: Map<string, ModelProvider>;
20
+ /** session_search / session_read 历史端口依赖(store 必填;index 缺省 = scan-only) */
21
+ sessionHistory: SessionHistoryOptions;
22
+ /** DocumentPort(gateway 共享实例 / run 节点自建);null = document_* 不注册 */
23
+ documentPort: NonNullable<ToolSetConfig['documentPort']> | null;
24
+ /** ask_user 桥(daemon: gateway.askUser;run 节点: 跨通道配对) */
25
+ askUser: AskUserCallback;
26
+ /** OCTOPI_HOME(凭证库位置) */
27
+ octopiHome: string;
28
+ /** octopi.json summary 块(形状透传;内部按原装配收窄) */
29
+ summary?: unknown;
30
+ /** octopi.json models.level(summary 档位表) */
31
+ levelMap?: unknown;
32
+ /** octopi.json webSearch 块 */
33
+ webSearch?: Parameters<typeof import('../web-search/factory.js').resolveWebSearchProviders>[0];
34
+ /**
35
+ * octopi.json browser 块(缺省 = 默认开,engine auto)。
36
+ * 显式 `enabled: false` 不注册 browser_*;未实现引擎 fail-loud 拒装配。
37
+ */
38
+ browser?: Parameters<typeof import('../browser/index.js').createBrowserService>[0];
39
+ /** credentials.requireBindings */
40
+ requireCredentialBindings?: boolean;
41
+ /** security.network.allowPrivateNetwork */
42
+ allowPrivateNetwork?: boolean;
43
+ }
44
+ /**
45
+ * 装配全局工具面。
46
+ *
47
+ * @param ctx - 装配依赖(provider/store/端口/配置块)
48
+ * @returns 全局工具清单(builtin + extensions,形态同 createToolSet().all)
49
+ */
50
+ export declare function assembleGlobalTools(ctx: GlobalToolSetContext): Promise<RegisteredTool[]>;
@@ -0,0 +1,137 @@
1
+ /**
2
+ * assemble-global-tools — 全局工具面装配单源(daemon 与 run 节点共用)。
3
+ *
4
+ * 面分割(arch/service-topology.md §4/§10):工具(tool)面随执行节点——生产执行在
5
+ * run 实例进程内,工具必须在该进程构建(gateway 侧 `globalTools: []` 不是缺省而是无面)。
6
+ * 本工厂把原 daemon 内联装配(summary L1/L2 端口 → session 历史端口 → 凭证库 →
7
+ * web search → createToolSet)抽为共用单源,daemon 与 run-serve-child 各带一套调用点。
8
+ *
9
+ * 失败降级形态随原装配冻结(每块 try/catch + 显式 warn:L1-only / scan-only / 无凭证),
10
+ * 降级是「真实尝试失败后」的兜底,不是占位返回。
11
+ */
12
+ import { join } from 'node:path';
13
+ import { resolveSummaryToolBindings } from '../../harness/context/capabilities/summary/tool-bindings.js';
14
+ /**
15
+ * 装配全局工具面。
16
+ *
17
+ * @param ctx - 装配依赖(provider/store/端口/配置块)
18
+ * @returns 全局工具清单(builtin + extensions,形态同 createToolSet().all)
19
+ */
20
+ export async function assembleGlobalTools(ctx) {
21
+ // ── Summary L1/L2 端口(http_request / file_read 压缩) ──
22
+ let summarySupport;
23
+ try {
24
+ const { createSummaryPort, createToolSummarySupport, createMemorySummaryCache } = await import('../../harness/context/capabilities/summary/index.js');
25
+ const fallbackProvider = [...ctx.providers.values()][0];
26
+ if (fallbackProvider) {
27
+ const summaryCfg = ctx.summary;
28
+ const toolsCfg = summaryCfg?.tools;
29
+ let cache;
30
+ let cacheEnabled = false;
31
+ if (summaryCfg?.cache?.enabled) {
32
+ cache = createMemorySummaryCache({
33
+ maxEntries: summaryCfg.cache.maxEntries,
34
+ defaultTtlMs: summaryCfg.cache.ttlMs,
35
+ });
36
+ cacheEnabled = true;
37
+ }
38
+ const portOptions = {
39
+ providers: ctx.providers,
40
+ levelMap: ctx.levelMap,
41
+ fallbackProvider,
42
+ model: summaryCfg?.model,
43
+ modelLevel: summaryCfg?.modelLevel,
44
+ gate: summaryCfg?.gate,
45
+ defaultInputBudgetTokens: summaryCfg?.defaultInputBudgetTokens,
46
+ safetyMarginTokens: summaryCfg?.safetyMarginTokens,
47
+ oversizedStrategy: summaryCfg?.oversizedStrategy,
48
+ policyOverrides: summaryCfg?.policies,
49
+ cache,
50
+ cacheEnabled,
51
+ cacheTtlMs: summaryCfg?.cache?.ttlMs,
52
+ maxReturnCharsDefault: toolsCfg?.maxReturnChars,
53
+ toolBindings: resolveSummaryToolBindings(toolsCfg),
54
+ };
55
+ const port = createSummaryPort(portOptions);
56
+ summarySupport = createToolSummarySupport(port, portOptions);
57
+ }
58
+ }
59
+ catch (err) {
60
+ // 降级 = L1-only tools(真实尝试失败);显式 warn 不静默
61
+ console.warn(`[tools] summary capability wiring failed (L1-only tools): ${err instanceof Error ? err.message : String(err)}`);
62
+ }
63
+ // ── session_search / session_read(Information 历史检索) ──
64
+ let sessionHistory;
65
+ try {
66
+ const { createSessionHistoryPort } = await import('../../harness/session/history/index.js');
67
+ sessionHistory = createSessionHistoryPort(ctx.sessionHistory);
68
+ }
69
+ catch (err) {
70
+ console.warn(`[tools] session history tools unavailable: ${err instanceof Error ? err.message : String(err)}`);
71
+ }
72
+ // ── SEC-3c: named credentials(http_request.credential) ──
73
+ let credentialStore = null;
74
+ try {
75
+ const { CredentialStore } = await import('../../harness/governance/credentials/store.js');
76
+ credentialStore = await CredentialStore.openDefault(ctx.octopiHome, {
77
+ requireBindings: ctx.requireCredentialBindings ?? false,
78
+ });
79
+ }
80
+ catch (err) {
81
+ console.warn(`[tools] CredentialStore unavailable: ${err instanceof Error ? err.message : String(err)}`);
82
+ }
83
+ // ── web_search(未配置不注册) ──
84
+ let webSearch;
85
+ if (ctx.webSearch?.providers && Object.keys(ctx.webSearch.providers).length > 0) {
86
+ const { resolveWebSearchProviders, createWebSearchWithFallback } = await import('../web-search/factory.js');
87
+ const resolved = resolveWebSearchProviders(ctx.webSearch);
88
+ if (resolved.primary) {
89
+ webSearch = {
90
+ provider: createWebSearchWithFallback(resolved.primary, resolved.fallbacks),
91
+ defaultLimit: resolved.defaultLimit,
92
+ timeoutMs: resolved.timeoutMs,
93
+ };
94
+ }
95
+ }
96
+ // ── browser_*(默认开;enabled:false 显式关闭;未实现引擎 fail-loud 不 try/catch) ──
97
+ let browser;
98
+ if (ctx.browser?.enabled !== false) {
99
+ const { createBrowserService } = await import('../browser/index.js');
100
+ const browserCfg = ctx.browser ?? {};
101
+ if (browserCfg.profiles?.persist && !browserCfg.profiles.defaultProfile) {
102
+ // persist 无 defaultProfile = 没有任何会话带 profileId:配置静默不生效,必须出声(评审 F20)
103
+ console.warn('[tools] browser.profiles.persist is set without defaultProfile — no session will archive/restore state');
104
+ }
105
+ browser = {
106
+ service: createBrowserService(browserCfg),
107
+ options: {
108
+ engine: browserCfg.engine,
109
+ timeoutMs: browserCfg.timeoutMs,
110
+ snapshotMaxChars: browserCfg.snapshotMaxChars,
111
+ confirm: browserCfg.confirm,
112
+ stealth: browserCfg.stealth,
113
+ profiles: browserCfg.profiles,
114
+ // profile 存储按运行时 home 归位(OCTOPI_HOME/browser-profiles,不进 agent home)
115
+ profileDir: join(ctx.octopiHome, 'browser-profiles'),
116
+ urlPolicy: {
117
+ allow: browserCfg.network?.domains?.allow,
118
+ deny: browserCfg.network?.domains?.deny,
119
+ },
120
+ allowPrivateNetwork: browserCfg.network?.allowPrivateNetwork ?? ctx.allowPrivateNetwork ?? false,
121
+ },
122
+ };
123
+ }
124
+ const { createToolSet } = await import('../../harness/extension/plugin-ecosystem/tools/tool-set.js');
125
+ const { all } = createToolSet({
126
+ webSearch,
127
+ browser,
128
+ summary: summarySupport,
129
+ sessionHistory,
130
+ documentPort: ctx.documentPort,
131
+ credentials: credentialStore,
132
+ network: { allowPrivateNetwork: ctx.allowPrivateNetwork ?? false },
133
+ requireCredentialBindings: ctx.requireCredentialBindings ?? false,
134
+ askUser: ctx.askUser,
135
+ });
136
+ return all;
137
+ }
package/dist/paths.d.ts CHANGED
@@ -31,3 +31,21 @@ export declare const OCTOPI_HOME_ENV = "OCTOPI_HOME";
31
31
  * @returns 绝对路径
32
32
  */
33
33
  export declare function getOctopiHome(): string;
34
+ /**
35
+ * agent home 物化路径(§4:`agents/<agentId>/`,registry 标注 tenantId)。
36
+ *
37
+ * @param octopiHome - OCTOPI_HOME 绝对路径
38
+ * @param agentId - agent id(registry 管理的为 UUID;配置 agent 为配置 id)
39
+ * @returns agent home 目录
40
+ */
41
+ export declare function agentHomeDir(octopiHome: string, agentId: string): string;
42
+ /**
43
+ * agent workspace 物化路径(§4:`workspace/<tenantId>/<agentId>/` 路径前缀隔离)。
44
+ * 显式配置的 `agents[].workspace` 优先于本派生(§5 渐进迁移:存量配置不搬家)。
45
+ *
46
+ * @param octopiHome - OCTOPI_HOME 绝对路径
47
+ * @param tenantId - 归属租户;缺省 `DEFAULT_TENANT_ID`(存量/未接身份层)
48
+ * @param agentId - agent id
49
+ * @returns agent workspace 目录
50
+ */
51
+ export declare function agentWorkspaceDir(octopiHome: string, tenantId: string | undefined, agentId: string): string;
package/dist/paths.js CHANGED
@@ -7,6 +7,7 @@
7
7
  */
8
8
  import { isAbsolute, join, resolve } from 'node:path';
9
9
  import { homedir } from 'node:os';
10
+ import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
10
11
  /**
11
12
  * 展开 `~` 前缀为用户主目录(Windows/Linux/macOS 通用)。
12
13
  * 接受 `~`、`~/rest`、`~\rest`(Windows 形态,剩余分隔符归一为 `/` 后按平台 join);
@@ -57,3 +58,38 @@ export const OCTOPI_HOME_ENV = 'OCTOPI_HOME';
57
58
  export function getOctopiHome() {
58
59
  return resolve(process.env[OCTOPI_HOME_ENV] ?? DEFAULT_OCTOPI_HOME);
59
60
  }
61
+ // ── 家当路径派生(arch/multi-tenancy.md §4 隔离矩阵的单一来源) ──
62
+ /** 路径段守卫:目录名不得为空 / 含分隔符 / 含 `..`(containment 安全判定点) */
63
+ function assertPathSegment(segment, label) {
64
+ if (!segment ||
65
+ segment === '.' ||
66
+ segment === '..' ||
67
+ segment.includes('/') ||
68
+ segment.includes('\\') ||
69
+ segment.includes('\0')) {
70
+ throw new Error(`invalid ${label} path segment: ${JSON.stringify(segment)}`);
71
+ }
72
+ return segment;
73
+ }
74
+ /**
75
+ * agent home 物化路径(§4:`agents/<agentId>/`,registry 标注 tenantId)。
76
+ *
77
+ * @param octopiHome - OCTOPI_HOME 绝对路径
78
+ * @param agentId - agent id(registry 管理的为 UUID;配置 agent 为配置 id)
79
+ * @returns agent home 目录
80
+ */
81
+ export function agentHomeDir(octopiHome, agentId) {
82
+ return join(octopiHome, 'agents', assertPathSegment(agentId, 'agent id'));
83
+ }
84
+ /**
85
+ * agent workspace 物化路径(§4:`workspace/<tenantId>/<agentId>/` 路径前缀隔离)。
86
+ * 显式配置的 `agents[].workspace` 优先于本派生(§5 渐进迁移:存量配置不搬家)。
87
+ *
88
+ * @param octopiHome - OCTOPI_HOME 绝对路径
89
+ * @param tenantId - 归属租户;缺省 `DEFAULT_TENANT_ID`(存量/未接身份层)
90
+ * @param agentId - agent id
91
+ * @returns agent workspace 目录
92
+ */
93
+ export function agentWorkspaceDir(octopiHome, tenantId, agentId) {
94
+ return join(octopiHome, 'workspace', assertPathSegment(tenantId ?? DEFAULT_TENANT_ID, 'tenant id'), assertPathSegment(agentId, 'agent id'));
95
+ }
@@ -40,7 +40,7 @@ lifecycle:
40
40
  maxDurationMs: 120000
41
41
 
42
42
  runtimeInject:
43
- requires: ['conceptGraphStore']
43
+ requires: ['conceptGraphStore', 'sessionStore']
44
44
 
45
45
  observability:
46
46
  eventPrefix: cognition.steward.conceptualize
@@ -50,3 +50,5 @@ metadata:
50
50
  maxNodesPerProposition: 6
51
51
  maxEdgesPerProposition: 12
52
52
  maxTokens: 8192
53
+ contextWindowMessages: 2
54
+ contextSliceMaxChars: 4000
@@ -8,8 +8,10 @@ import { readFileSync } from 'node:fs';
8
8
  import { dirname, join } from 'node:path';
9
9
  import { fileURLToPath } from 'node:url';
10
10
  import { DEP_LLM_PORT, DEP_SUBSYSTEM_PROMPT, chatForCompleteOutput, } from '@octopi-agent/engine/harness/collaboration/autonomous-subsystem/index.js';
11
- import { conceptualizeAndAdmit, parseConceptualizerJson, } from '../../../harness/memory/conceptualizer.js';
11
+ import { conceptualizeAndAdmit, hasSufficientContext, parseConceptualizerJson, } from '../../../harness/memory/conceptualizer.js';
12
+ import { DEFAULT_CONTEXT_SLICE_MAX_CHARS, DEFAULT_CONTEXT_WINDOW_MESSAGES, extractContextSlice, } from '../../../harness/memory/context-slice.js';
12
13
  const DEP_CONCEPT_GRAPH = 'conceptGraphStore';
14
+ const DEP_SESSION_STORE = 'sessionStore';
13
15
  const DEP_CONFIG = '__subsystem_config__';
14
16
  function resolveSubsystemPrompt(deps, llmPort) {
15
17
  const fromDeps = deps?.[DEP_SUBSYSTEM_PROMPT];
@@ -37,6 +39,55 @@ function failOutput(message, reason) {
37
39
  signals: [{ action: 'alert', reason: message, data: { reason } }],
38
40
  };
39
41
  }
42
+ /** 配置正整数校验:非法值(NaN/负数/小数/非 number)回退缺省 */
43
+ function positiveInt(value, fallback) {
44
+ return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : fallback;
45
+ }
46
+ /**
47
+ * contextSlice 缺省回补:sessionStore.load(sessionId) → evidence 锚定 ±N 窗口。
48
+ *
49
+ * 失败分层:sessionStore 未注入是装配故障(throw,与 conceptGraphStore 同语义);
50
+ * load 抛错/形状不符转显式 `session_load_failed`——吞掉的只是单会话读取异常
51
+ * (不得拖垮概念化派发),但必须显式归因,不得伪装成数据问题;
52
+ * 会话缺失或 evidence 无锚点返回空 slice,由调用方按 `no_context_slice` 归因。
53
+ */
54
+ async function backfillContextSliceFromSession(deps, opts) {
55
+ if (!opts.sessionId.trim() || !opts.evidence.trim())
56
+ return { slice: '' };
57
+ const sessionStore = deps?.[DEP_SESSION_STORE];
58
+ if (!sessionStore) {
59
+ throw new Error('cognition.steward.conceptualize: sessionStore not injected (contextSlice backfill)');
60
+ }
61
+ if (typeof sessionStore.load !== 'function') {
62
+ return { fail: 'session_load_failed', detail: 'sessionStore.load missing' };
63
+ }
64
+ try {
65
+ const session = await sessionStore.load(opts.sessionId);
66
+ if (session == null)
67
+ return { slice: '' };
68
+ if (!Array.isArray(session.messages)) {
69
+ return {
70
+ fail: 'session_load_failed',
71
+ detail: `session ${opts.sessionId} messages malformed`,
72
+ };
73
+ }
74
+ return {
75
+ slice: extractContextSlice({
76
+ messages: session.messages,
77
+ evidence: opts.evidence,
78
+ windowMessages: opts.windowMessages,
79
+ maxChars: opts.maxChars,
80
+ }),
81
+ };
82
+ }
83
+ catch (err) {
84
+ // 只吞单会话读取异常并转显式失败;其余路径(缺依赖/坏形状)各有归因,不会落到这里
85
+ return {
86
+ fail: 'session_load_failed',
87
+ detail: `session ${opts.sessionId} load failed: ${err instanceof Error ? err.message : String(err)}`,
88
+ };
89
+ }
90
+ }
40
91
  async function handler(input, deps) {
41
92
  const store = deps?.[DEP_CONCEPT_GRAPH];
42
93
  if (!store) {
@@ -50,14 +101,33 @@ async function handler(input, deps) {
50
101
  const proposition = String(payload.proposition ?? '').trim();
51
102
  const memoryId = String(payload.memoryId ?? '');
52
103
  const evidence = String(payload.evidence ?? '');
53
- const contextSlice = String(payload.contextSlice ?? payload.context_slice ?? '');
54
104
  const memoryType = String(payload.memoryType ?? payload.type ?? 'fact');
55
105
  const memoryStatus = payload.memoryStatus ?? undefined;
56
106
  if (!proposition || !memoryId) {
57
107
  return failOutput('missing proposition/memoryId', 'bad_payload');
58
108
  }
59
- if (!contextSlice.trim() && !evidence.trim()) {
60
- return failOutput('no context slice', 'no_context_slice');
109
+ const config = deps?.[DEP_CONFIG] ?? {};
110
+ const windowMessages = positiveInt(config.contextWindowMessages, DEFAULT_CONTEXT_WINDOW_MESSAGES);
111
+ const maxChars = positiveInt(config.contextSliceMaxChars, DEFAULT_CONTEXT_SLICE_MAX_CHARS);
112
+ // contextSlice 缺省从 session 补齐(输入包契约,arch/cognition-graph-formation.md D1)
113
+ const rawSlice = payload.contextSlice ?? payload.context_slice;
114
+ const providedSlice = typeof rawSlice === 'string' ? rawSlice : '';
115
+ let contextSlice = providedSlice;
116
+ if (!contextSlice.trim()) {
117
+ const backfill = await backfillContextSliceFromSession(deps, {
118
+ sessionId: String(payload.sessionId ?? ''),
119
+ evidence,
120
+ windowMessages,
121
+ maxChars,
122
+ });
123
+ if ('fail' in backfill) {
124
+ return failOutput(backfill.detail, backfill.fail);
125
+ }
126
+ contextSlice = backfill.slice;
127
+ }
128
+ // 与 admit 门同一判定(hasSufficientContext),且前置到 LLM 之前:无语境不烧 LLM
129
+ if (!hasSufficientContext({ contextSlice })) {
130
+ return failOutput('no context slice (evidence anchor not found in session)', 'no_context_slice');
61
131
  }
62
132
  const systemPrompt = resolveSubsystemPrompt(deps, llmPort);
63
133
  const userText = [
@@ -68,7 +138,6 @@ async function handler(input, deps) {
68
138
  ].join('\n');
69
139
  // maxTokens 只是生成配额(LLM 传参):截断(finish=length)或解析失败都放大配额重试
70
140
  // 一次,仍失败显式上报——业务完整性优先,禁止静默半截结果
71
- const config = deps?.[DEP_CONFIG] ?? {};
72
141
  const outcome = await chatForCompleteOutput(llmPort, {
73
142
  systemPrompt: systemPrompt || undefined,
74
143
  messages: [{ role: 'user', content: userText }],
@@ -1,6 +1,7 @@
1
1
  # Cognition Steward Consolidate
2
2
 
3
- 确定性巩固批:衰减 → merge_candidates 裁决钩子 → 晋升 → GC。
3
+ 巩固批:legacy 候选保守 keep_split → merge_llm_adjudication(kind≠ / embedding_band 候选 LLM 裁决 merge/keep_split/drop,≤10/批)→ 衰减 → 晋升 → GC。
4
4
 
5
- 不调用 LLM(候选裁决由外部/管理面 resolveMerge);不写 Memory/Wisdom。
5
+ LLM 仅用于合并裁决(`chatForCompleteOutput` 完整性语义,失败 fail-loud);Memory 只读(命题摘要为裁决输入);不写 Memory/Wisdom。
6
+ 未实现步骤见 handler SKIPPED_STEPS(causal_candidate 转正 / counter_evidence / Wisdom 信号 / anchor:missing GC)。
6
7
  本文仅作认知指令占位(think.implementation=code)。
@@ -4,7 +4,14 @@ description: 概念图巩固:衰减、晋升、GC、容量检查(事件+TTL
4
4
 
5
5
  sense:
6
6
  source: schedule
7
+ # 24h 节拍 + 重启首跳兜底:interval 计时器随进程重启清零(PulseScheduler 无 catch-up,
8
+ # OP-9R 记账),部署重启周期 < 24h 时纯 interval 会被饿死——runOnStart 保证每次启动必跑一轮
7
9
  interval: 86400000
10
+ runOnStart: true
11
+ # 首跳序 2/5:晚 10 分钟——吃 memory.govern 的合并产物(支撑累加/晋升);
12
+ # 顺序的真正保证是 governed 事件边(事件先到会先跑,与本首跳双跑时第二次空转、无 LLM 成本),
13
+ # 本首跳是事件丢失时的保底
14
+ startupDelayMs: 600000
8
15
  filter:
9
16
  condition: "true"
10
17
  events: ['cognition.consolidate.request', 'session.ended', 'memory.steward.governed']
@@ -37,10 +44,10 @@ session:
37
44
 
38
45
  lifecycle:
39
46
  maxConcurrent: 1
40
- maxDurationMs: 15000
47
+ maxDurationMs: 60000
41
48
 
42
49
  runtimeInject:
43
- requires: ['conceptGraphStore']
50
+ requires: ['conceptGraphStore', 'memoryStore']
44
51
 
45
52
  observability:
46
53
  eventPrefix: cognition.steward.consolidate
@@ -52,3 +59,5 @@ metadata:
52
59
  warnEdges: 20000
53
60
  stopNodes: 10000
54
61
  stopEdges: 40000
62
+ adjudicateMaxBatch: 10
63
+ adjudicateMaxTokens: 8192
@@ -1,11 +1,14 @@
1
1
  /**
2
2
  * cognition.steward.consolidate — 概念图巩固批
3
3
  *
4
- * 本轮实现:衰减 → 指纹冲突 keep_split → 按支撑晋升 → 容量水位。
5
- * 未实现步骤(LLM 合并裁决 / causal_candidate 转正 / Wisdom 信号 / anchor:missing GC)
4
+ * 实现:legacy 候选保守 keep_split → merge_llm_adjudication(kind≠ / embedding_band 交 LLM 裁决)
5
+ * → 衰减 → 按支撑晋升 → 容量水位。
6
+ * 未实现步骤(causal_candidate 转正 / counter_evidence / Wisdom 信号 / anchor:missing GC)
6
7
  * 显式记入 skipped,不得假装完成规格 §7.2 全部步骤。
7
8
  *
8
- * 只写 ConceptGraphStore;不写 Memory / Wisdom。
9
+ * 失败语义(显式降级):裁决子步失败不吞并确定性巩固——decay/promote/capacity 照常执行,
10
+ * act.status=failed + error 点名 + 计数全量可见(禁静默半执行)。
11
+ * 只写 ConceptGraphStore;Memory 只读(裁决输入的命题摘要);不写 Wisdom。
9
12
  */
10
13
  import type { SubsystemInput, SubsystemOutput, InjectedDependencies } from '@octopi-agent/engine/harness/collaboration/autonomous-subsystem/types.js';
11
14
  declare function handler(_input: SubsystemInput, deps?: InjectedDependencies): Promise<SubsystemOutput>;