@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
@@ -0,0 +1,358 @@
1
+ /**
2
+ * ToolEffectPolicy P3 — 运行模式预设与有效策略
3
+ *
4
+ * 命名模式(workspace / project / host / untrusted)展开为正交旋钮。
5
+ * 见 arch/tool-effect-policy.md §7。
6
+ */
7
+ import { isAbsolute, resolve } from 'node:path';
8
+ import { expandHomePath } from '../../../paths.js';
9
+ import { deniesReducedSurface, resolveToolCapabilities, } from './tool-capabilities.js';
10
+ import { assessL4ProcessMinimum, } from './process-isolation.js';
11
+ import { resolveHitlDecision } from '../../governance/human-in-the-loop/decision-cache.js';
12
+ import { getRunSessionId, getRunScope } from '../../run/run-scope.js';
13
+ /**
14
+ * Engine default when `effectPolicy.mode` is omitted (secure-by-default).
15
+ * Scaffold/`octopi init` / `octopi.example.json` set `mode: "host"` explicitly
16
+ * so evaluation gets full capability; embedders who omit `mode` get `workspace`.
17
+ * See `docs/process-isolation.md`.
18
+ */
19
+ export const DEFAULT_EFFECT_RUN_MODE = 'workspace';
20
+ const MODE_DEFAULTS = {
21
+ workspace: {
22
+ mode: 'workspace',
23
+ toolIsolation: 'session-subdir',
24
+ pathContainment: 'strict',
25
+ // 无 L4 时无法「只禁越界」:deny = 拒绝 shell 工具(fail-closed)
26
+ shellEscape: 'deny',
27
+ network: 'deny',
28
+ processLimits: true,
29
+ commit: 'auto',
30
+ onClose: 'commit',
31
+ effects: 'engine',
32
+ shellJournal: 'snapshot',
33
+ },
34
+ project: {
35
+ mode: 'project',
36
+ toolIsolation: 'session-subdir',
37
+ pathContainment: 'strict',
38
+ // 编码 agent 必须有 shell;文件侧靠 L2,shell FS 越界待 L4
39
+ shellEscape: 'allow',
40
+ network: 'open',
41
+ processLimits: true,
42
+ commit: 'auto',
43
+ onClose: 'commit',
44
+ effects: 'engine',
45
+ shellJournal: 'snapshot',
46
+ },
47
+ host: {
48
+ mode: 'host',
49
+ toolIsolation: 'none',
50
+ pathContainment: 'none',
51
+ shellEscape: 'allow',
52
+ network: 'open',
53
+ processLimits: true,
54
+ commit: 'auto',
55
+ onClose: 'commit',
56
+ effects: 'engine',
57
+ shellJournal: 'snapshot',
58
+ },
59
+ untrusted: {
60
+ mode: 'untrusted',
61
+ toolIsolation: 'session-subdir',
62
+ pathContainment: 'strict',
63
+ shellEscape: 'deny',
64
+ network: 'deny',
65
+ processLimits: true,
66
+ commit: 'auto',
67
+ onClose: 'discard',
68
+ effects: 'engine',
69
+ shellJournal: 'snapshot',
70
+ },
71
+ };
72
+ /**
73
+ * Whether the resolved policy demands a process jail (untrusted that survived
74
+ * untrusted admission). Single predicate shared by the run path (runner) and
75
+ * host-side read surfaces (WebUI git status endpoint) so the isolation level
76
+ * never drifts between them.
77
+ *
78
+ * @param eff - resolved effective policy
79
+ * @returns true when untrusted was requested and remains effective
80
+ */
81
+ export function requiresJail(eff) {
82
+ return eff.requestedMode === 'untrusted' && eff.mode === 'untrusted';
83
+ }
84
+ /**
85
+ * 展开 effectPolicy 为有效策略
86
+ *
87
+ * @param config - 用户配置(mode 可省略,缺省 `DEFAULT_EFFECT_RUN_MODE`)
88
+ * @param baseWorkspace - 工具基路径(agent.workspace / RunConfig.cwd)
89
+ * @returns 有效策略
90
+ */
91
+ /**
92
+ * Expand effectPolicy into an effective policy.
93
+ *
94
+ * `untrusted` requires an L4 process profile. When the host cannot offer it:
95
+ * - `untrustedAdmission: 'refuse'` (default) throws
96
+ * - `untrustedAdmission: 'degrade'` renames effectiveMode to workspace,
97
+ * sets toolSurface=reduced, and records securityDegraded[] (never silent)
98
+ *
99
+ * @param config - user config (mode optional)
100
+ * @param baseWorkspace - tool base path
101
+ * @param isolation - probed process isolation (optional; treated as supervised if absent)
102
+ * @returns effective policy with requested vs effective mode
103
+ * @throws Error when untrusted is refused
104
+ */
105
+ export function resolveEffectiveEffectPolicy(config, baseWorkspace, isolation) {
106
+ // `~` 前缀收口展开(Windows/Linux/macOS 通用):下游 allowRoots / tool cwd 只见
107
+ // 绝对路径;配置层(ConfigPathSchema)已先拒相对路径。顺序固定「trim → expand」,
108
+ // 库调用面传入带空白的 ` ~/x` 同样归一。
109
+ config = {
110
+ ...config,
111
+ ...(config.transactionRoots
112
+ ? { transactionRoots: config.transactionRoots.map((r) => expandHomePath(r.trim())) }
113
+ : {}),
114
+ };
115
+ baseWorkspace =
116
+ baseWorkspace !== undefined ? expandHomePath(baseWorkspace.trim()) : baseWorkspace;
117
+ const requestedMode = config.mode ?? DEFAULT_EFFECT_RUN_MODE;
118
+ const untrustedAdmission = config.untrustedAdmission ?? 'refuse';
119
+ let mode = requestedMode;
120
+ let toolSurface = 'full';
121
+ const securityDegraded = [];
122
+ if (requestedMode === 'untrusted') {
123
+ const profile = isolation;
124
+ const l4 = profile ? assessL4ProcessMinimum(profile) : { ok: false, missing: ['processTree'] };
125
+ if (!l4.ok) {
126
+ if (untrustedAdmission === 'refuse') {
127
+ throw new Error(`untrusted_refused: L4 process jail unavailable (missing: ${l4.missing.join(', ')}). ` +
128
+ `Install bwrap/sandbox-exec or set effectPolicy.untrustedAdmission=degrade.`);
129
+ }
130
+ // degrade: rename + strip power, do not keep the untrusted label
131
+ mode = 'workspace';
132
+ toolSurface = 'reduced';
133
+ securityDegraded.push('no_process_jail');
134
+ if (profile?.filesystem === 'none' || profile?.filesystem === 'cwd-pin') {
135
+ securityDegraded.push('filesystem_not_jailed');
136
+ }
137
+ if (profile?.privilege === 'same')
138
+ securityDegraded.push('privilege_same');
139
+ if (profile?.envHygiene === 'inherit')
140
+ securityDegraded.push('env_inherit');
141
+ }
142
+ // Declare open egress whenever the host cannot close it — not only when
143
+ // effective mode is still named untrusted (degrade renames mode first).
144
+ if (isolation?.network === 'open') {
145
+ securityDegraded.push('network_open');
146
+ }
147
+ }
148
+ // Path jail is part of the untrusted promise; never loosen it from config.
149
+ const d = MODE_DEFAULTS[mode];
150
+ const pathContainment = requestedMode === 'untrusted'
151
+ ? 'strict'
152
+ : (config.pathContainment ?? d.pathContainment);
153
+ // untrusted intent residue: keep discard-on-close even when effectiveMode renames
154
+ const onClose = config.onClose ??
155
+ (requestedMode === 'untrusted' ? MODE_DEFAULTS.untrusted.onClose : d.onClose);
156
+ const extra = (config.transactionRoots ?? []).map((p) => p.trim()).filter(Boolean);
157
+ const allowRoots = [...(baseWorkspace?.trim() ? [baseWorkspace.trim()] : []), ...extra];
158
+ return {
159
+ requestedMode,
160
+ mode,
161
+ untrustedAdmission,
162
+ toolSurface,
163
+ securityDegraded,
164
+ toolIsolation: config.toolIsolation ?? d.toolIsolation,
165
+ pathContainment,
166
+ // degraded untrusted must not leave shell allow as a hole
167
+ shellEscape: toolSurface === 'reduced' ? 'deny' : (config.shellEscape ?? d.shellEscape),
168
+ // untrusted product promise: egress deny is not a config knob (like pathContainment)
169
+ network: requestedMode === 'untrusted' || toolSurface === 'reduced'
170
+ ? 'deny'
171
+ : (config.network ?? d.network),
172
+ processLimits: config.processLimits ?? d.processLimits,
173
+ commit: config.commit ?? d.commit,
174
+ onClose,
175
+ effects: config.effects ?? d.effects,
176
+ allowRoots,
177
+ transactionRoots: [
178
+ 'workspace',
179
+ 'memory',
180
+ ...extra.map(() => 'host'),
181
+ ],
182
+ undoLimit: config.undoLimit,
183
+ shellJournal: config.shellJournal ?? 'snapshot',
184
+ shellJournalLimit: config.shellJournalLimit,
185
+ };
186
+ }
187
+ /**
188
+ * Whether a tool is on the reduced surface (untrusted degrade).
189
+ * Reduced keeps content tools inside L2; strips egress and code-exec power.
190
+ *
191
+ * @param toolName - registered tool name
192
+ * @param surface - full or reduced
193
+ * @returns whether the tool may run
194
+ */
195
+ export function isToolAllowedOnSurface(toolName, surface, capabilities) {
196
+ if (surface === 'full')
197
+ return true;
198
+ // D5-a: capability tags, not names. Unknown on reduced = reject (unknown-reject).
199
+ const caps = resolveToolCapabilities(toolName, capabilities);
200
+ if (caps === null)
201
+ return false;
202
+ return !deniesReducedSurface(caps);
203
+ }
204
+ /**
205
+ * L2:路径是否落在 allowRoots 内
206
+ *
207
+ * @param resolved - 已 resolve 的绝对路径
208
+ * @param allowRoots - 允许根
209
+ * @param containment - 级别;none 一律放行;soft 仅用于审计(由调用方记日志)
210
+ * @returns 是否允许
211
+ */
212
+ export function isPathAllowed(resolved, allowRoots, containment) {
213
+ if (containment === 'none')
214
+ return true;
215
+ if (allowRoots.length === 0)
216
+ return containment !== 'strict';
217
+ const norm = (p) => p.replace(/\\/g, '/').replace(/\/+$/, '');
218
+ const win = process.platform === 'win32';
219
+ const target = win ? norm(resolved).toLowerCase() : norm(resolved);
220
+ return allowRoots.some((root) => {
221
+ const r = win ? norm(root).toLowerCase() : norm(root);
222
+ return target === r || target.startsWith(r + '/');
223
+ });
224
+ }
225
+ /**
226
+ * 效应闸(P4):事务内自动放行;host-gate 交给宿主;engine 通道按内置策略。
227
+ *
228
+ * @param intent - 效应意图
229
+ * @param options - 通道与回调
230
+ * @throws Error 当拒绝执行时
231
+ */
232
+ export async function gateEffect(intent, options) {
233
+ // 可事务化(可 undo)→ 自动
234
+ if (intent.kind === 'memory.write' && intent.transactional)
235
+ return;
236
+ if (intent.kind === 'file.write' && intent.transactional)
237
+ return;
238
+ if (intent.kind === 'shell') {
239
+ const esc = options.shellEscape ?? 'allow';
240
+ // deny:无 L4 无法只禁越界,必须拒绝 shell(fail-closed,保策略语义)
241
+ if (esc === 'deny') {
242
+ throw new Error('shell_denied: shellEscape=deny (cannot contain shell escapes until L4; use mode=project|host or shellEscape=allow|confirm)');
243
+ }
244
+ // confirm:必须走 host-gate
245
+ if (esc === 'confirm' && options.effects !== 'host-gate') {
246
+ throw new Error('shell_confirm_required: shellEscape=confirm requires effectPolicy.effects=host-gate + confirmEffect');
247
+ }
248
+ }
249
+ // `runner` / `vcs` are dedicated allowlisted tools, not arbitrary shell.
250
+ // shellEscape gates the shell tool only — workspace stays capable of git/project scripts.
251
+ if (options.effects !== 'host-gate') {
252
+ // engine 通道:路径牢笼由 L2 承担;shell 已在上方按 shellEscape 处理
253
+ return;
254
+ }
255
+ // host-gate:非事务效应交给宿主(自动放行 / 宿主 UI / 策略引擎)
256
+ const decide = options.confirmEffect;
257
+ if (!decide) {
258
+ throw new Error('confirm_effect_missing: effectPolicy.effects=host-gate requires confirmEffect callback');
259
+ }
260
+ // SEC-7:HitlDecision + 引擎缓存;失败路径 fail-closed
261
+ const allowed = await resolveHitlDecision({
262
+ cache: options.hitlCache,
263
+ channel: 'effect',
264
+ key: intent.kind,
265
+ sessionId: options.sessionId ?? getRunSessionId(),
266
+ agentId: options.agentId ?? getRunScope()?.agentId,
267
+ ask: () => decide(intent),
268
+ });
269
+ if (!allowed) {
270
+ throw new Error(`effect_denied: ${intent.kind}`);
271
+ }
272
+ }
273
+ const EFFECT_OVERRIDES_META_KEY = 'effectOverrides';
274
+ /**
275
+ * Parse `session.metadata.effectOverrides` safely (read path).
276
+ *
277
+ * Invalid entries are **skipped**, not thrown: a poisoned/corrupt metadata bag
278
+ * must not abort run start. Strict validation belongs on the write API
279
+ * (`normalizeTransactionRoots`).
280
+ *
281
+ * @param metadata - session metadata bag
282
+ * @returns valid absolute roots only (empty when absent/invalid)
283
+ */
284
+ export function readSessionEffectOverrides(metadata) {
285
+ const raw = metadata?.[EFFECT_OVERRIDES_META_KEY];
286
+ if (!raw || typeof raw !== 'object')
287
+ return {};
288
+ const bag = raw;
289
+ const list = bag.transactionRoots;
290
+ if (!Array.isArray(list))
291
+ return {};
292
+ const out = [];
293
+ const seen = new Set();
294
+ for (const item of list) {
295
+ if (typeof item !== 'string')
296
+ continue;
297
+ const t = item.trim();
298
+ if (!t || !isAbsolute(t))
299
+ continue;
300
+ const abs = resolve(t);
301
+ const key = process.platform === 'win32' ? abs.toLowerCase() : abs;
302
+ if (seen.has(key))
303
+ continue;
304
+ seen.add(key);
305
+ out.push(abs);
306
+ }
307
+ return { transactionRoots: out };
308
+ }
309
+ /**
310
+ * Normalize and validate transaction root paths (absolute, non-empty).
311
+ *
312
+ * @param paths - raw paths
313
+ * @returns absolute normalized unique paths
314
+ * @throws Error when a path is empty or not absolute
315
+ */
316
+ export function normalizeTransactionRoots(paths) {
317
+ const out = [];
318
+ const seen = new Set();
319
+ for (const raw of paths) {
320
+ const t = typeof raw === 'string' ? raw.trim() : '';
321
+ if (!t)
322
+ throw new Error('effect_root_empty: path must be a non-empty string');
323
+ // Require caller-supplied absolute paths (do not silently join cwd)
324
+ if (!isAbsolute(t)) {
325
+ throw new Error(`effect_root_not_absolute: ${t}`);
326
+ }
327
+ const abs = resolve(t);
328
+ const key = process.platform === 'win32' ? abs.toLowerCase() : abs;
329
+ if (seen.has(key))
330
+ continue;
331
+ seen.add(key);
332
+ out.push(abs);
333
+ }
334
+ return out;
335
+ }
336
+ /**
337
+ * Append session roots to base allowRoots (dedupe; base wins on conflicts).
338
+ *
339
+ * @param baseRoots - roots from effectPolicy / workspace
340
+ * @param extraRoots - session temporary roots
341
+ * @returns combined unique list
342
+ */
343
+ export function mergeTransactionRoots(baseRoots, extraRoots) {
344
+ const out = [...baseRoots];
345
+ const seen = new Set(out.map((p) => (process.platform === 'win32' ? p.toLowerCase() : p)));
346
+ for (const p of extraRoots ?? []) {
347
+ const key = process.platform === 'win32' ? p.toLowerCase() : p;
348
+ if (seen.has(key))
349
+ continue;
350
+ seen.add(key);
351
+ out.push(p);
352
+ }
353
+ return out;
354
+ }
355
+ /**
356
+ * Metadata key used on SessionData.metadata / SessionStore.updateMetadata.
357
+ */
358
+ export const SESSION_EFFECT_OVERRIDES_KEY = EFFECT_OVERRIDES_META_KEY;
@@ -1,10 +1,26 @@
1
1
  /**
2
2
  * Execution Environment 领域 — 执行环境
3
3
  *
4
- * 职责:沙箱管理、工作区生命周期、文件操作、资源限制。
4
+ * 职责:沙箱管理、工作区生命周期、文件操作、资源限制、turn 文件 undo(L3)。
5
5
  * 契约见 ./types.ts。
6
6
  */
7
- export { ProcessSandbox } from './sandbox.js';
7
+ export { ProcessSandbox, createProcessSandbox, assessL4ProcessMinimum, supervisedSpawnProfile, } from './sandbox.js';
8
+ export { probeProcessIsolation, scrubEnv, killProcessTree, L4_PROCESS_MINIMUM, } from './process-isolation.js';
9
+ export type { ProcessIsolationProfile, IsolationBackend, ProcessTreeIsolation, FilesystemIsolation, ResourceIsolation, NetworkIsolation, PrivilegeIsolation, EnvHygiene, L4ProcessAssessment, } from './process-isolation.js';
8
10
  export { FileWorkspace } from './workspace.js';
9
11
  export type { FileWorkspaceConfig } from './workspace.js';
12
+ export { DEFAULT_TOOL_ISOLATION, resolveToolIsolationCwd, safeSessionDirSegment, looksLikeAbsoluteSessionPath, } from './isolation.js';
13
+ export type { ToolIsolationMode, ResolveToolIsolationCwdInput, ResolveToolIsolationCwdResult, } from './isolation.js';
14
+ export { TurnFileUndoLog, commitSessionFileUndo, discardSessionFileUndo, resolveSessionUndoPaths, resolveSessionUndoOnClose, } from './undo-log.js';
15
+ export type { SessionUndoPaths, FileUndoEntry, DiscardFileEffectsResult, DiscardConflictReason, } from './undo-log.js';
16
+ export { isProbablyText, reverseAgentOverwrite, merge3Lines } from './undo-merge.js';
17
+ export { snapshotShellRoots, captureShellInventory, diffShellInventory, journalShellDiff, writeNotReversed, } from './shell-journal.js';
18
+ export { resolveEffectiveEffectPolicy, requiresJail, isPathAllowed, isToolAllowedOnSurface, gateEffect, DEFAULT_EFFECT_RUN_MODE, readSessionEffectOverrides, normalizeTransactionRoots, mergeTransactionRoots, SESSION_EFFECT_OVERRIDES_KEY, } from './effect-policy.js';
19
+ export type { UntrustedAdmission, ToolSurface, SecurityDegradation, EffectiveEffectPolicy, SessionEffectOverrides, } from './effect-policy.js';
20
+ export { runWithToolLimits, resolveToolTimeoutMs, ToolTimeoutError, } from './resource-limits.js';
21
+ export type { ToolRunLimits } from './resource-limits.js';
22
+ export { TurnMemoryJournal, JournaledMemoryStore, createMemoryRestorer, discardMemoryUndo, } from './memory-undo.js';
23
+ export type { MemoryUndoEntry, MemoryEffectRestorer, DiscardMemoryEffectsResult, } from './memory-undo.js';
10
24
  export type { IsolationLevel, SandboxConfig, ResourceLimits, ResourceUsage, SandboxResult, SandboxProvider, WorkspaceConfig, WorkspaceSnapshot, Workspace, SearchOptions, FileMatch, } from './types.js';
25
+ export { resolveToolCapabilities, deniesReducedSurface, BUILTIN_TOOL_CAPABILITIES, REDUCED_DENIED_CAPABILITIES, } from './tool-capabilities.js';
26
+ export type { ToolCapability } from './tool-capabilities.js';
@@ -1,8 +1,17 @@
1
1
  /**
2
2
  * Execution Environment 领域 — 执行环境
3
3
  *
4
- * 职责:沙箱管理、工作区生命周期、文件操作、资源限制。
4
+ * 职责:沙箱管理、工作区生命周期、文件操作、资源限制、turn 文件 undo(L3)。
5
5
  * 契约见 ./types.ts。
6
6
  */
7
- export { ProcessSandbox } from './sandbox.js';
7
+ export { ProcessSandbox, createProcessSandbox, assessL4ProcessMinimum, supervisedSpawnProfile, } from './sandbox.js';
8
+ export { probeProcessIsolation, scrubEnv, killProcessTree, L4_PROCESS_MINIMUM, } from './process-isolation.js';
8
9
  export { FileWorkspace } from './workspace.js';
10
+ export { DEFAULT_TOOL_ISOLATION, resolveToolIsolationCwd, safeSessionDirSegment, looksLikeAbsoluteSessionPath, } from './isolation.js';
11
+ export { TurnFileUndoLog, commitSessionFileUndo, discardSessionFileUndo, resolveSessionUndoPaths, resolveSessionUndoOnClose, } from './undo-log.js';
12
+ export { isProbablyText, reverseAgentOverwrite, merge3Lines } from './undo-merge.js';
13
+ export { snapshotShellRoots, captureShellInventory, diffShellInventory, journalShellDiff, writeNotReversed, } from './shell-journal.js';
14
+ export { resolveEffectiveEffectPolicy, requiresJail, isPathAllowed, isToolAllowedOnSurface, gateEffect, DEFAULT_EFFECT_RUN_MODE, readSessionEffectOverrides, normalizeTransactionRoots, mergeTransactionRoots, SESSION_EFFECT_OVERRIDES_KEY, } from './effect-policy.js';
15
+ export { runWithToolLimits, resolveToolTimeoutMs, ToolTimeoutError, } from './resource-limits.js';
16
+ export { TurnMemoryJournal, JournaledMemoryStore, createMemoryRestorer, discardMemoryUndo, } from './memory-undo.js';
17
+ export { resolveToolCapabilities, deniesReducedSurface, BUILTIN_TOOL_CAPABILITIES, REDUCED_DENIED_CAPABILITIES, } from './tool-capabilities.js';
@@ -5,6 +5,7 @@
5
5
  * 本模块解析「本 Run 的 toolRuntime.cwd」,不引入分布式文件锁。
6
6
  */
7
7
  import { isAbsolute, join, resolve, sep } from 'node:path';
8
+ import { expandHomePath } from '../../../paths.js';
8
9
  import { toSessionFileName } from '@octopi-agent/core/session-filename.js';
9
10
  /**
10
11
  * 缺省隔离模式。
@@ -35,7 +36,10 @@ export function safeSessionDirSegment(sessionId) {
35
36
  * @returns 工具 cwd 与生效模式
36
37
  */
37
38
  export function resolveToolIsolationCwd(input) {
38
- const base = input.baseCwd?.trim() ? input.baseCwd.trim() : undefined;
39
+ // `~` 形态在此展开(trim → expand):toolRuntime.cwd 必须与 eff.allowRoots
40
+ // (resolveEffectiveEffectPolicy 同源展开)一致,否则 strict 匹配失败、
41
+ // session-subdir 会 mkdir 出字面 `~` 目录(留观② P1-1)。
42
+ const base = input.baseCwd?.trim() ? expandHomePath(input.baseCwd.trim()) : undefined;
39
43
  const mode = input.mode;
40
44
  if (mode === 'session-subdir' && base) {
41
45
  const segment = safeSessionDirSegment(input.sessionId);
@@ -0,0 +1,101 @@
1
+ /**
2
+ * Turn 记忆面 undo(ToolEffectPolicy L3 P2)
3
+ *
4
+ * 与文件 undo 同目录(`sessions/<sid>/undo/memory.jsonl`)。
5
+ * 只覆盖 **本轮 run 作用域内** 经 store 写口的效应;steward 异步写不进 journal。
6
+ * knowledge 不在此列(非事务)。
7
+ */
8
+ import type { MemoryEffectDomain, MemoryEffectJournal } from '@octopi-agent/core/types/tools.js';
9
+ import type { MemoryEntry, MemoryStore } from '../../memory/types.js';
10
+ /** 记忆面 undo 条目 */
11
+ export type MemoryUndoEntry = {
12
+ op: 'insert';
13
+ domain: MemoryEffectDomain;
14
+ id: string;
15
+ } | {
16
+ op: 'update';
17
+ domain: MemoryEffectDomain;
18
+ id: string;
19
+ before: unknown;
20
+ } | {
21
+ op: 'delete';
22
+ domain: MemoryEffectDomain;
23
+ id: string;
24
+ before: unknown;
25
+ };
26
+ /** 记忆面逆放执行器(由 store 提供) */
27
+ export interface MemoryEffectRestorer {
28
+ /** 逆放 insert:按 id 删除 */
29
+ deleteById(domain: MemoryEffectDomain, id: string): Promise<void>;
30
+ /** 逆放 update/delete:恢复 before 整行(同 id) */
31
+ restoreRow(domain: MemoryEffectDomain, id: string, before: unknown): Promise<void>;
32
+ }
33
+ export interface DiscardMemoryEffectsResult {
34
+ reversed: Array<{
35
+ domain: MemoryEffectDomain;
36
+ id: string;
37
+ op: MemoryUndoEntry['op'];
38
+ }>;
39
+ failed: Array<{
40
+ domain: MemoryEffectDomain;
41
+ id: string;
42
+ reason: string;
43
+ }>;
44
+ entries: number;
45
+ }
46
+ /** 本轮记忆 journal 写入端 */
47
+ export declare class TurnMemoryJournal implements MemoryEffectJournal {
48
+ private readonly entries;
49
+ private sealed;
50
+ private readonly logPath;
51
+ private flushChain;
52
+ constructor(undoRoot: string);
53
+ get size(): number;
54
+ recordInsert(domain: MemoryEffectDomain, id: string): Promise<void>;
55
+ recordUpdate(domain: MemoryEffectDomain, id: string, before: unknown): Promise<void>;
56
+ recordDelete(domain: MemoryEffectDomain, id: string, before: unknown): Promise<void>;
57
+ private append;
58
+ private flush;
59
+ private doFlush;
60
+ seal(): void;
61
+ }
62
+ /**
63
+ * 逆放记忆效应(编辑重发)。按记录逆序执行。
64
+ *
65
+ * @param undoRoot - `sessions/<sid>/undo`
66
+ * @param restorer - store 逆放器;缺失时全部记 failed
67
+ * @returns 逆放结果
68
+ */
69
+ export declare function discardMemoryUndo(undoRoot: string, restorer?: MemoryEffectRestorer): Promise<DiscardMemoryEffectsResult>;
70
+ /**
71
+ * MemoryStore 装饰器:写口记 journal(RunScope ALS 提供)。
72
+ * 无活跃 journal 时写入照常(steward / turn 外),不记 undo。
73
+ */
74
+ export declare class JournaledMemoryStore implements MemoryStore {
75
+ private readonly inner;
76
+ private readonly journalSource;
77
+ readonly name: string;
78
+ constructor(inner: MemoryStore, journalSource: () => MemoryEffectJournal | undefined);
79
+ store(entry: Omit<MemoryEntry, 'id' | 'accessCount' | 'lastAccessedAt' | 'createdAt' | 'decayFactor'>): Promise<string>;
80
+ retrieve: MemoryStore['retrieve'];
81
+ get(id: string): Promise<MemoryEntry | null>;
82
+ update(id: string, patch: Partial<MemoryEntry>): Promise<void>;
83
+ delete(id: string): Promise<void>;
84
+ softDelete(id: string, meta: {
85
+ by: string;
86
+ reason: string;
87
+ winnerId?: string;
88
+ }): Promise<void>;
89
+ undelete(id: string): Promise<void>;
90
+ importEntry(entry: MemoryEntry): Promise<void>;
91
+ listForGovern: MemoryStore['listForGovern'];
92
+ decay: MemoryStore['decay'];
93
+ stats: MemoryStore['stats'];
94
+ }
95
+ /**
96
+ * 由 MemoryStore 实现 restorer(编辑重发逆放)。
97
+ *
98
+ * @param store - 记忆 store
99
+ * @returns restorer
100
+ */
101
+ export declare function createMemoryRestorer(store: MemoryStore): MemoryEffectRestorer;