@octopi-agent/engine 0.70.7 → 0.90.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +201 -8
  23. package/dist/config.js +105 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -9,6 +9,7 @@
9
9
  * @module harness/run/run-scope
10
10
  */
11
11
  import type { Message } from '@octopi-agent/core/types.js';
12
+ import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
12
13
  import type { ToolIsolationMode } from '../extension/execution-environment/isolation.js';
13
14
  /** 工具执行时可见的 Run 运行时上下文 */
14
15
  export interface RunToolRuntime {
@@ -21,6 +22,57 @@ export interface RunToolRuntime {
21
22
  isolation?: ToolIsolationMode;
22
23
  /** 只读会话附件根(OP-15);不改变 toolIsolation 语义 */
23
24
  attachmentRoots?: string[];
25
+ /** 本轮文件效应写入口(L3 undo;ToolEffectPolicy) */
26
+ fileEffects: ToolFileEffects;
27
+ /** 本轮记忆面 journal(L3 P2) */
28
+ memoryEffects: import("@octopi-agent/core/types/tools.js").MemoryEffectJournal;
29
+ /** L2 允许根 */
30
+ pathRoots?: string[];
31
+ /** Session undo roots that file tools must not write (D6-a) */
32
+ undoRoots?: string[];
33
+ /** Jail network posture for shell/exec */
34
+ networkPolicy?: 'open' | 'deny' | 'allowlist';
35
+ /** Credential binding strict mode (SEC-3c); untrusted / config */
36
+ requireCredentialBindings?: boolean;
37
+ /** D7 require jail */
38
+ requireJail?: boolean;
39
+ /** jail $HOME write (project/host) */
40
+ homeWrite?: boolean;
41
+ /** Run-level securityDegraded hook */
42
+ noteSecurityDegraded?: (reason: string) => void;
43
+ /** L2 级别 */
44
+ pathContainment?: "strict" | "soft" | "none";
45
+ confirmEffect?: import("@octopi-agent/core/types/tools.js").ToolExecutionContext["confirmEffect"];
46
+ effectChannel?: "engine" | "host-gate";
47
+ /** L1 processLimits(false = 不强制 timeoutMs 看门狗) */
48
+ processLimits?: boolean;
49
+ /** shell 工具策略(gateEffect;deny=拒绝 shell) */
50
+ shellEscape?: "deny" | "confirm" | "allow";
51
+ /** shell 记账深度 */
52
+ shellJournal?: "snapshot" | "off";
53
+ shellJournalLimit?: {
54
+ maxFiles?: number;
55
+ maxBytes?: number;
56
+ maxFileSize?: number;
57
+ };
58
+ /** SEC-2 session participant tool surface (per-run; not on shared harness) */
59
+ sessionToolRights?: {
60
+ allow?: string[];
61
+ deny?: string[];
62
+ denyCapabilities?: string[];
63
+ };
64
+ /**
65
+ * 本 Run 的 effective session rights(E6 计算结果)。
66
+ *
67
+ * 供工具层读取以实现 D3「权限随调用传播」——委派时把**父的有效权限**
68
+ * 作为天花板传给子,子只能在父的权限内行事,不得借委派提权。
69
+ */
70
+ sessionRights?: import('../governance/session-acl/types.js').EffectiveSessionRights;
71
+ /** SEC-2 static agent tool policy (agents[].tools) */
72
+ agentToolPolicy?: {
73
+ allow?: string[];
74
+ deny?: string[];
75
+ };
24
76
  }
25
77
  /** 一次 Run 的作用域身份(I1) */
26
78
  export interface RunScope {
@@ -2,9 +2,10 @@
2
2
  * SessionAwareRunner — Session 感知的运行器
3
3
  *
4
4
  * Harness 层组件。在 Agent.run()(自带 reliability)之上管理 Session 生命周期:
5
- * - 消息持久化
5
+ * - 消息持久化(Discourse 追加日志;不因 idle/跨日清空)
6
6
  * - Session 锁(同一 session 同时只有一个运行)
7
- * - Daily reset / Idle reset
7
+ * - 上下文租约(`idleExpiryMs` opt-in:只截 LLM 默认窗口)
8
+ * - 中止轮标记(`abortedTurn`,供 UI 编辑重发)
8
9
  * - 并发控制
9
10
  *
10
11
  * Agent 是 Harness 运行时门面;不要再手拼 runAgentWithReliability。
@@ -22,12 +23,13 @@ import { type ToolIsolationMode } from '../extension/execution-environment/isola
22
23
  import { type SessionLease } from './concurrency/session-lease.js';
23
24
  /** 运行器配置 */
24
25
  export interface SessionAwareRunnerConfig {
25
- /** Session 过期时间(毫秒,默认 24 小时) */
26
- sessionExpiryMs?: number;
27
- /** 空闲过期时间(毫秒,默认 2 小时) */
26
+ /**
27
+ * 上下文租约(毫秒)。**显式配置才生效**;缺省 / 0 = 关闭。
28
+ *
29
+ * 闲置超过本值后,下一轮 LLM 默认消息窗口从租约点截断(Discourse 全量保留)。
30
+ * 需要旧内容时走 session_search / session_read。与 memory 冷沉淀解耦。
31
+ */
28
32
  idleExpiryMs?: number;
29
- /** 是否启用 daily reset */
30
- enableDailyReset?: boolean;
31
33
  /**
32
34
  * 并发 session 门控(可选)
33
35
  *
@@ -42,6 +44,12 @@ export interface SessionAwareRunnerConfig {
42
44
  * 与 task_* 工具共用同一实例。
43
45
  */
44
46
  sessionTaskService?: SessionTaskService;
47
+ /**
48
+ * 会话日程服务(Agent 自发起定时)
49
+ *
50
+ * handle() 每轮注入未闭合 schedule;与 schedule_* 工具共用同一实例。
51
+ */
52
+ sessionScheduleService?: import('../session/schedules/service.js').SessionScheduleService;
45
53
  /**
46
54
  * 解析 run 级模型快照(Gateway 注入;每 run 调用一次)
47
55
  *
@@ -79,13 +87,23 @@ export interface SessionAwareRunnerConfig {
79
87
  * 来自 AgentDefinition.maxSessionRights;authorizeRun 时取交集。
80
88
  */
81
89
  agentMaxSessionRights?: import('../governance/session-acl/types.js').SessionRights;
90
+ /**
91
+ * Agent 静态工具策略(agents[].tools allow/deny)。
92
+ * 与 sessionToolRights 求交;deny 优先(SEC-2)。
93
+ */
94
+ agentToolPolicy?: import('@octopi-agent/core/types.js').ToolPolicy;
82
95
  /** 产品 Observer 通道(Run 现场快照;缺省不采集) */
83
96
  observerHub?: import('../observability/observer/hub.js').ObserverHub;
84
97
  /**
85
- * 会话附件根基路径(OP-15)。通常 `OCTOPI_HOME/sessions`。
86
- * 设置后 RunScope.toolRuntime.attachmentRoots = `<base>/<sid>/attachments`(只读)。
98
+ * 会话数据根目录(`OCTOPI_HOME/sessions`)。附件根 = `<sessionsDir>/<sid>/attachments`;
99
+ * turn 文件 undo = `<sessionsDir>/<sid>/undo`(ToolEffectPolicy L3)。
87
100
  */
88
- sessionAttachmentsBaseDir?: string;
101
+ sessionsDir?: string;
102
+ /** ToolEffectPolicy(P3);展开后驱动 toolIsolation / L2 */
103
+ effectPolicy?: import("../extension/execution-environment/effect-policy.js").EffectPolicyConfig;
104
+ /** credentials.requireBindings(SEC-3c):无绑定凭证不可 resolve */
105
+ requireCredentialBindings?: boolean;
106
+ confirmEffect?: import("../extension/execution-environment/effect-policy.js").ConfirmEffect;
89
107
  /** 附件注入参数(knowledge.attachments.inject;缺省用内建默认) */
90
108
  sessionAttachmentInject?: {
91
109
  fullTextMaxChars?: number;
@@ -121,6 +139,13 @@ export interface RunConfig {
121
139
  agentRevision?: string;
122
140
  contextWindow?: number;
123
141
  injectedContext?: string;
142
+ /**
143
+ * 本 Run 的权利天花板(`arch/delegation.md` D3:只能收紧不能放宽)。
144
+ *
145
+ * 与 Runner 的 `agentMaxSessionRights` **取交集**后进 `authorizeRun`;
146
+ * 委派子 Run 用它传 `DelegateRequest.rightsCeiling`。
147
+ */
148
+ rightsCeiling?: import('../governance/session-acl/types.js').SessionRights;
124
149
  }
125
150
  /**
126
151
  * 适配 HarnessLoopEvent → AgentEvent(向后兼容)
@@ -146,11 +171,40 @@ export declare function adaptLoopEvent(event: HarnessLoopEvent, meta: {
146
171
  assistantContent: string;
147
172
  lastUserContent?: string;
148
173
  stopReason?: string;
174
+ /** 引擎为何终止(人类可读);收口落一条 runStopped 消息,禁止静默停止 */
175
+ stopMessage?: string;
176
+ /** 判定细节(规则名/指标),供审计与日志 */
177
+ stopDetail?: string;
178
+ /**
179
+ * loop 的 `agent_end.reason`(completed / should_stop / aborted / error)。
180
+ *
181
+ * 是否真的「提前停止」只能看这里:`security_blocked` 单次拦截后 run 会继续,
182
+ * 只看它会把正常完成的 run 误报成停止。
183
+ */
184
+ loopEndReason?: string;
149
185
  }): import('@octopi-agent/core/primitives/event-bus.js').AgentEvent | null;
150
186
  /**
151
187
  * SessionAwareRunner
152
188
  */
153
189
  export declare class SessionAwareRunner {
190
+ /** 本 Runner 生效的 L2 级别(由 effectPolicy 展开) */
191
+ private effectPathContainment;
192
+ private effectChannel;
193
+ private effectAllowRoots;
194
+ /** Effective effectPolicy.mode (for Runtime injection / UI) */
195
+ private effectMode;
196
+ private effectCommitManual;
197
+ /** store 缺 syncMessages 通道时只 warn 一次 */
198
+ private warnedMissingSync;
199
+ private effectProcessLimits;
200
+ private effectNetwork;
201
+ private effectRequireJail;
202
+ private effectRequireCredentialBindings;
203
+ private effectHomeWrite;
204
+ private effectShellEscape;
205
+ private effectShellJournal;
206
+ private effectShellJournalLimit?;
207
+ private effectUndoLimit?;
154
208
  private agent;
155
209
  private harness;
156
210
  private store;
@@ -175,7 +229,7 @@ export declare class SessionAwareRunner {
175
229
  private lastCleanPersonaPrompt?;
176
230
  /** 按层契约组装 system prompt(persona + runtime);未设置时退回字符串拼接 */
177
231
  private systemPromptAssembler?;
178
- /** 会话重置时清理 Assembler 层缓存 */
232
+ /** Assembler 层缓存清理钩子(可选接线;与 contextDetachIndex 无关) */
179
233
  private systemPromptAssemblerClear?;
180
234
  /** turn 级 Knowledge grounding(可选;arch/knowledge-layer.md §4.4) */
181
235
  private groundingAssembler?;
@@ -240,6 +294,10 @@ export declare class SessionAwareRunner {
240
294
  *
241
295
  * 每轮在 persona resolve 与 injectedContext 计算完成后调用,
242
296
  * 替代原先的字符串拼接。未设置时保持旧路径(兼容)。
297
+ *
298
+ * E8 契约:`injectedContext` 保持合并形态(兼容旧 assembler,零能力丢失);
299
+ * 拆分字段 `volatileContext`(易变份→快照)与 `runtimeAnchors`(稳定份→system)同时传入,
300
+ * 默认 assembler 优先用拆分字段;降级/无 assembler 路径同样产出快照(E8 形态不破)。
243
301
  */
244
302
  setSystemPromptAssembler(assembler: (input: {
245
303
  sessionId: string;
@@ -247,11 +305,17 @@ export declare class SessionAwareRunner {
247
305
  messages: Message[];
248
306
  persona: string;
249
307
  injectedContext?: string;
308
+ /** E8:易变注入份(datetime/tasks/guidance);优先于 injectedContext */
309
+ volatileContext?: string;
310
+ /** E8:稳定运行时锚点(留 system prompt) */
311
+ runtimeAnchors?: string;
250
312
  contextWindow?: number;
251
313
  topicHints?: string;
252
314
  signal?: AbortSignal;
253
315
  }) => Promise<{
254
316
  systemPrompt: string;
317
+ /** E8:本轮易变快照(消息尾部插槽送达) */
318
+ runtimeSnapshot?: string;
255
319
  manifest?: import('../context/layer-types.js').AssembleManifest;
256
320
  }>, clearSession?: (sessionId: string) => void): void;
257
321
  /**
@@ -313,6 +377,8 @@ export declare class SessionAwareRunner {
313
377
  tokensBefore: number;
314
378
  tokensAfter?: number;
315
379
  summary?: string;
380
+ /** 摘要覆盖终点(tailStart,不含) */
381
+ coveredMessageCount?: number;
316
382
  }>;
317
383
  summarize?: (messages: import('@octopi-agent/core/interfaces/model-provider.js').LLMMessage[], opts?: {
318
384
  maxTokens?: number;
@@ -334,6 +400,12 @@ export declare class SessionAwareRunner {
334
400
  * 分布式:注入 DistributedSessionLease;勿假设 in-process 锁全局有效(E7)。
335
401
  */
336
402
  private acquireLock;
403
+ /**
404
+ * SEC-2: strip tools by agent ToolPolicy ∩ sessionToolRights (narrow-only).
405
+ * Listing filter; beforeToolCall repeats the same check as defense-in-depth.
406
+ * Rights are passed per-run (harness is shared across concurrent sessions).
407
+ */
408
+ private filterToolsForSessionRights;
337
409
  /**
338
410
  * 创建新 Session
339
411
  *
@@ -341,6 +413,35 @@ export declare class SessionAwareRunner {
341
413
  * 存储主键 = sessionId;agentId 只作归属/参与投影。
342
414
  */
343
415
  private createSession;
416
+ /**
417
+ * 补闭上一 turn(崩溃/中止后无 turn_end 时 write-once 追加)。
418
+ * 新 turn 禁止在 open 未闭时叠加。
419
+ */
420
+ private ensurePreviousTurnClosed;
421
+ /**
422
+ * user 消息一次定形为 `<turn_start>…</turn_start>`(write-once)。
423
+ * @param userMessage - 本 turn 用户消息对象(session.messages 中的同一引用)
424
+ * @param turnId - 会话内单调 turn id
425
+ * @param turnContextXml - `<turn_context>…</turn_context>` 整段
426
+ * @throws 若已定形(禁止二次改写)
427
+ */
428
+ private bakeTurnStart;
429
+ /** 追加 turn 闭标(write-once;同 id 重复 → throw) */
430
+ private appendTurnEnd;
431
+ /**
432
+ * Run 进行中转录增量落盘:把 durable 口径的历史对齐到存储。
433
+ *
434
+ * 口径与收尾合并一致(ephemeral 运行期消息不落历史);调用方契约:
435
+ * turn_start 定形之后才可同步(bake 原地改写 user 消息)。尽力而为——
436
+ * 失败不中断 Run(收尾整包 save 是权威写),store 无 syncMessages 时跳过。
437
+ *
438
+ * @param sessionId - 会话 id
439
+ * @param agentId - 本 Run 身份(assistant/tool 归因,首次同步前补齐)
440
+ * @param keptPrefix - 上下文租约点之前的 Discourse 前缀(与收尾 keptPrefix 同源)
441
+ * @param runMessages - 本 Run 视图消息(含 ephemeral,此处过滤)
442
+ * @returns 是否成功对齐(false 时调用方不得推进已同步计数,待下个事件重试)
443
+ */
444
+ private persistRunMessages;
344
445
  /** 旧路径:persona + injectedContext 字符串拼接;结果返回给 runContext,不写共享 Agent */
345
446
  private concatSystemPrompt;
346
447
  /**
@@ -352,12 +453,12 @@ export declare class SessionAwareRunner {
352
453
  /**
353
454
  * 检查 Session 是否需要重置
354
455
  */
355
- private checkSessionReset;
356
456
  /**
357
- * 将 session 生命周期落到 recent + endedAt,并广播事件。
358
- * 状态在 SessionData.lifecycle;由后续 save 持久化(meta 索引投影)。
359
- * 不写 memoryExtraction(进度归 memory.steward);事件仍带 extractionStatus 供 Sense 感知。
457
+ * 上下文租约(opt-in):闲置超时后仅记录截断点,供 LLM 默认窗口裁剪。
458
+ *
459
+ * 不删 Discourse、不碰 compact/memory。冷沉淀归 memory.steward 的 idle 扫描。
460
+ * 在 push 本轮 input 之前调用,保证新消息落在租约点之后。
360
461
  */
361
- private markSessionRecent;
462
+ private applyContextLease;
362
463
  }
363
464
  export {};