@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
@@ -1,80 +1,108 @@
1
1
  /**
2
- * Execution Environment 接口定义
2
+ * Execution Environment interface contracts
3
3
  *
4
- * @layer harness/extension/execution-environment — 执行环境契约。
4
+ * @layer harness/extension/execution-environment
5
5
  */
6
- /** 沙箱隔离级别 */
6
+ import type { ProcessIsolationProfile } from './process-isolation.js';
7
+ /** Legacy coarse isolation level (prefer ProcessIsolationProfile) */
7
8
  export type IsolationLevel = 'none' | 'process' | 'container';
8
- /** 沙箱配置 */
9
+ /** Sandbox config */
9
10
  export interface SandboxConfig {
10
- /** 隔离级别 */
11
- isolationLevel: IsolationLevel;
12
- /** 工作目录 */
11
+ /** Requested isolation level (legacy knob) */
12
+ isolationLevel?: IsolationLevel;
13
+ /** Working directory */
13
14
  cwd?: string;
14
- /** 环境变量 */
15
+ /**
16
+ * Explicit environment. Merged on top of the scrubbed allowlist.
17
+ * Never spreads `process.env` — secrets must not ride along.
18
+ */
15
19
  env?: Record<string, string>;
16
- /** 资源限制 */
20
+ /** Resource limits */
17
21
  limits?: ResourceLimits;
18
- /** 允许的网络访问(CIDR 或 hostname) */
19
- allowedNetwork?: string[];
20
- /** 允许的文件系统路径 */
21
- allowedPaths?: string[];
22
+ /**
23
+ * Network posture for jail backends (bwrap / Seatbelt).
24
+ * Default when omitted: `deny` (D4-c). `allowlist` is interface-only this release
25
+ * and is enforced as `deny` with an honest note.
26
+ */
27
+ networkPolicy?: 'open' | 'deny' | 'allowlist';
28
+ /**
29
+ * Absolute roots the jail may read/write (bind mounts / Seatbelt write-allow).
30
+ * Falls back to `[cwd]` when omitted. Not a substitute for L2 path policy.
31
+ */
32
+ allowRoots?: string[];
33
+ /**
34
+ * D7: when true (untrusted / L4-required), jail backend must actually apply.
35
+ * Setup failure throws instead of falling back to supervised spawn.
36
+ */
37
+ requireJail?: boolean;
38
+ /**
39
+ * Allow `$HOME` writes inside the jail (project/host only per 2b).
40
+ * tmpdir and, on POSIX, shared `/tmp` + `/var/tmp` are always writable (2a);
41
+ * tmp writes are not journaled (2c notReversed).
42
+ */
43
+ homeWrite?: boolean;
44
+ /** Run-level hook for execute-time degradation (falls back to isolation.notes). */
45
+ noteSecurityDegraded?: (reason: string) => void;
46
+ /** Abort in-flight execution */
47
+ signal?: AbortSignal;
22
48
  }
23
- /** 资源限制 */
49
+ /** Resource limits */
24
50
  export interface ResourceLimits {
25
- /** 最大执行时间(毫秒) */
51
+ /** Max wall time (ms) */
26
52
  timeoutMs?: number;
27
- /** 最大内存(字节) */
53
+ /** Max memory (bytes) */
28
54
  maxMemoryBytes?: number;
29
- /** 最大输出大小(字节) */
55
+ /** Max captured output (bytes) */
30
56
  maxOutputBytes?: number;
31
- /** 最大 CPU 时间(毫秒) */
57
+ /** Max CPU time (ms) */
32
58
  maxCpuTimeMs?: number;
33
59
  }
34
- /** 资源使用统计 */
60
+ /** Resource usage */
35
61
  export interface ResourceUsage {
36
- /** 实际执行时间(毫秒) */
62
+ /** Elapsed wall time (ms) */
37
63
  elapsedMs: number;
38
- /** 内存使用峰值(字节,-1 表示未知) */
64
+ /** Peak memory (bytes, -1 unknown) */
39
65
  peakMemoryBytes: number;
40
- /** CPU 时间(毫秒,-1 表示未知) */
66
+ /** CPU time (ms, -1 unknown) */
41
67
  cpuTimeMs: number;
42
- /** 输出大小(字节) */
68
+ /** Output size (bytes) */
43
69
  outputBytes: number;
44
70
  }
45
- /** 沙箱执行结果 */
71
+ /** Sandbox execution result */
46
72
  export interface SandboxResult {
47
- /** 退出码 */
73
+ /** Exit code */
48
74
  exitCode: number;
49
- /** 标准输出 */
75
+ /** stdout */
50
76
  stdout: string;
51
- /** 标准错误 */
77
+ /** stderr */
52
78
  stderr: string;
53
- /** 是否被沙箱终止(超时、OOM 等) */
79
+ /** Terminated by sandbox (timeout, OOM, output cap) */
54
80
  terminated: boolean;
55
- /** 终止原因 */
81
+ /** Terminate reason */
56
82
  terminateReason?: string;
57
- /** 资源使用统计 */
83
+ /** Resource usage */
58
84
  usage: ResourceUsage;
85
+ /** Honest isolation actually applied for this run */
86
+ isolation: ProcessIsolationProfile;
59
87
  }
60
88
  /**
61
- * SandboxProvider — 沙箱提供者接口
62
- *
63
- * 在隔离环境中执行命令。不同实现可以提供不同级别的隔离:
64
- * - none: 直接执行(开发模式)
65
- * - process: 进程级隔离(spawn + resource limits)
66
- * - container: 容器级隔离(Docker/firejail)
89
+ * SandboxProvider — execute commands under an isolation profile.
90
+ * Implementations must report real capabilities via `isolation` / `probe()`.
67
91
  */
68
92
  export interface SandboxProvider {
69
- /** 隔离级别 */
93
+ /** Legacy coarse level */
70
94
  readonly level: IsolationLevel;
95
+ /** Honest isolation profile for this provider */
96
+ probe(): Promise<ProcessIsolationProfile>;
71
97
  /**
72
- * 在沙箱中执行命令
98
+ * Execute a shell command line (platform shell) under isolation.
73
99
  */
74
100
  execute(command: string, config?: SandboxConfig): Promise<SandboxResult>;
75
101
  /**
76
- * 检查沙箱是否可用
102
+ * Execute an argv vector (preferred — no shell string parsing).
77
103
  */
104
+ executeArgv?(argv: string[], config?: SandboxConfig): Promise<SandboxResult>;
105
+ /** Whether this provider can run on the current host */
78
106
  isAvailable(): Promise<boolean>;
79
107
  }
80
108
  /** 工作区配置 */
@@ -1,6 +1,6 @@
1
1
  /**
2
- * Execution Environment 接口定义
2
+ * Execution Environment interface contracts
3
3
  *
4
- * @layer harness/extension/execution-environment — 执行环境契约。
4
+ * @layer harness/extension/execution-environment
5
5
  */
6
6
  export {};
@@ -0,0 +1,203 @@
1
+ /**
2
+ * Turn 文件 undo(ToolEffectPolicy L3)
3
+ *
4
+ * 即时生效 + 本轮 undo log:工具写立刻落盘,同时记录写前字节。
5
+ * 「编辑重发」discard 只逆放 agent 工具效应;用户手改保留。
6
+ * 落盘:`sessions/<sid>/undo/`(与 attachments 同级,不进 agent home / workspace)。
7
+ *
8
+ * 统一效应账本:可逆条目进 log.jsonl(有 before);不可逆只进 notReversed 结果。
9
+ * 见 arch/tool-effect-policy.md §5.6。
10
+ */
11
+ import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
12
+ import type { MemoryEffectJournal } from '@octopi-agent/core/types/tools.js';
13
+ import { TurnMemoryJournal, type DiscardMemoryEffectsResult, type MemoryEffectRestorer } from './memory-undo.js';
14
+ /** undo 目录布局 */
15
+ export interface SessionUndoPaths {
16
+ /** `sessions/<sid>/undo` */
17
+ root: string;
18
+ logPath: string;
19
+ blobsDir: string;
20
+ }
21
+ /**
22
+ * 解析会话 undo 目录
23
+ *
24
+ * @param sessionsDir - 通常 `OCTOPI_HOME/sessions`
25
+ * @param sessionId - 会话 id
26
+ * @returns 路径
27
+ */
28
+ export declare function resolveSessionUndoPaths(sessionsDir: string, sessionId: string): SessionUndoPaths;
29
+ /** 落盘条目(按路径 coalesce) */
30
+ export type FileUndoEntry = {
31
+ op: 'create';
32
+ path: string;
33
+ afterHash: string;
34
+ afterRef?: string;
35
+ } | {
36
+ op: 'overwrite';
37
+ path: string;
38
+ beforeRef: string;
39
+ afterHash: string;
40
+ afterRef?: string;
41
+ /** 最后工具效应为删除 */
42
+ agentDeleted?: boolean;
43
+ } | {
44
+ op: 'delete';
45
+ path: string;
46
+ beforeRef: string;
47
+ agentDeleted?: boolean;
48
+ };
49
+ export type DiscardConflictReason = 'merge_conflict' | 'binary_user_wins' | 'user_deleted' | 'user_recreated' | 'budget_truncated';
50
+ export type NotReversedReason = 'inventory_only' | 'budget_truncated' | 'no_roots' | 'shell_journal_off';
51
+ /** 不可逆效应(无 before / 未记账);宿主可见,不进 LLM 历史 */
52
+ export interface NotReversedEffects {
53
+ reason: NotReversedReason;
54
+ created?: string[];
55
+ modified?: string[];
56
+ deleted?: string[];
57
+ }
58
+ /** 编辑重发效应逆放结果(对外即 EditResendResult) */
59
+ export interface EditResendResult {
60
+ discarded: Array<{
61
+ path: string;
62
+ action: 'deleted' | 'restored';
63
+ }>;
64
+ keptUserEdits: Array<{
65
+ path: string;
66
+ reason: DiscardConflictReason;
67
+ }>;
68
+ /** 本 turn 不可逆效应(shell 等) */
69
+ notReversed?: NotReversedEffects;
70
+ /** undoLimit / 预算撞顶:回滚不完整 */
71
+ truncated?: boolean;
72
+ entries: number;
73
+ /** 记忆面逆放(P2) */
74
+ memory: DiscardMemoryEffectsResult;
75
+ }
76
+ export type DiscardFileEffectsResult = EditResendResult;
77
+ /** undo 配额(缺省不限;撞顶后停记 before,业务写继续) */
78
+ export interface UndoLimitConfig {
79
+ maxEntries?: number;
80
+ maxBlobBytes?: number;
81
+ }
82
+ /**
83
+ * undo 根是否属于「他人仍在运行的进程」。
84
+ *
85
+ * @param paths - 会话 undo 路径
86
+ * @returns owner pid 存活且非本进程 → true(清扫端应跳过);无 owner / 已死 → false
87
+ */
88
+ export declare function isForeignLiveUndoOwner(paths: SessionUndoPaths): Promise<boolean>;
89
+ /**
90
+ * 本轮文件 undo log — 实现 `ToolFileEffects`
91
+ */
92
+ export declare class TurnFileUndoLog implements ToolFileEffects {
93
+ private readonly paths;
94
+ private readonly entriesByPath;
95
+ private seq;
96
+ private sealed;
97
+ /** flush 串行:并行工具写盘不得丢条目 */
98
+ private flushChain;
99
+ private readonly limit?;
100
+ private blobBytes;
101
+ private limitHit;
102
+ /** 记忆面 journal(P2);与文件共用 undo 根 */
103
+ readonly memoryJournal: TurnMemoryJournal;
104
+ private constructor();
105
+ /** ToolExecutionContext.memoryEffects */
106
+ get memoryEffects(): MemoryEffectJournal;
107
+ /** undoLimit 是否已截断 */
108
+ get truncated(): boolean;
109
+ /**
110
+ * 开始本轮 undo。若已有残留 log(上一轮中止后继续对话),先 commit。
111
+ *
112
+ * @param options - sessionsDir + sessionId + 可选 undoLimit
113
+ * @returns 日志实例
114
+ */
115
+ static begin(options: {
116
+ sessionsDir: string;
117
+ sessionId: string;
118
+ undoLimit?: UndoLimitConfig;
119
+ }): Promise<TurnFileUndoLog>;
120
+ get root(): string;
121
+ get size(): number;
122
+ writeFile(path: string, data: string | Uint8Array): Promise<void>;
123
+ appendFile(path: string, data: string | Uint8Array): Promise<void>;
124
+ /** 删除前调用:记 before,discard 时恢复 */
125
+ recordDelete(path: string, before: string | Uint8Array): Promise<void>;
126
+ /** 标记新建(零 before);已存在条目则不覆盖 first before */
127
+ recordCreate(path: string, after?: string | Uint8Array): Promise<void>;
128
+ /** rename:delete(from) + create/overwrite(to) */
129
+ recordRename(from: string, to: string): Promise<void>;
130
+ /** 显式 before/after 覆盖(shell diff;磁盘已是 after 时不能用 writeFile 采 before) */
131
+ noteNotReversed(payload: {
132
+ reason: 'inventory_only' | 'budget_truncated' | 'no_roots' | 'shell_journal_off';
133
+ created?: string[];
134
+ modified?: string[];
135
+ deleted?: string[];
136
+ }): Promise<void>;
137
+ recordOverwrite(path: string, before: string | Uint8Array, after?: string | Uint8Array): Promise<void>;
138
+ private recordWrite;
139
+ /** @returns blob hash;超配额时 undefined(调用方标 truncated) */
140
+ private storeBlob;
141
+ /** limitHit 持久化,供 gateway/close 异进程 discard 读回 */
142
+ private persistTruncated;
143
+ private flushLog;
144
+ private doFlushLog;
145
+ /** 提交:丢弃 undo,效应保留 */
146
+ commit(): Promise<void>;
147
+ /** 逆放并销毁(编辑重发) */
148
+ discard(memoryRestorer?: MemoryEffectRestorer): Promise<DiscardFileEffectsResult>;
149
+ }
150
+ /**
151
+ * 未配置 sessionsDir 时的 fail-closed 写入口:拒绝落盘,禁止静默绕过 undo。
152
+ */
153
+ export declare function createUnconfiguredFileEffects(): ToolFileEffects;
154
+ /**
155
+ * 未配置 sessionsDir 时的记忆面 fail-closed 写入口。
156
+ */
157
+ export declare function createUnconfiguredMemoryEffects(): MemoryEffectJournal;
158
+ /**
159
+ * 提交某会话残留 undo(继续对话 / turn 自然结束)
160
+ *
161
+ * @param sessionsDir - sessions 目录
162
+ * @param sessionId - 会话 id
163
+ */
164
+ export declare function commitSessionFileUndo(sessionsDir: string, sessionId: string): Promise<void>;
165
+ /**
166
+ * 逆放某会话本轮文件效应(编辑重发)
167
+ *
168
+ * @param sessionsDir - sessions 目录
169
+ * @param sessionId - 会话 id
170
+ * @returns 逆放结果(宿主可见,不进 LLM 历史)
171
+ */
172
+ export declare function discardSessionFileUndo(sessionsDir: string, sessionId: string, memoryRestorer?: MemoryEffectRestorer): Promise<DiscardFileEffectsResult>;
173
+ /**
174
+ * 会话关闭/删除时处理残留 undo(commit=manual 才有意义;auto 下 turn 已 commit)。
175
+ *
176
+ * @param options - sessionsDir + sessionId + onClose 策略
177
+ * @returns 实际动作
178
+ */
179
+ export declare function resolveSessionUndoOnClose(options: {
180
+ sessionsDir: string;
181
+ sessionId: string;
182
+ onClose: 'commit' | 'discard';
183
+ memoryRestorer?: import('./memory-undo.js').MemoryEffectRestorer;
184
+ /** true 时跳过属于他人活跃进程的 undo(进程收尾扫描用;显式删除不应开启) */
185
+ skipLiveForeign?: boolean;
186
+ }): Promise<'committed' | 'discarded' | 'none'>;
187
+ /** 孤儿 undo 目录(崩溃/异常退出残留) */
188
+ export interface OrphanUndoDir {
189
+ sessionDirName: string;
190
+ undoRoot: string;
191
+ entries: number;
192
+ hasMemory: boolean;
193
+ hasNotReversed: boolean;
194
+ }
195
+ /**
196
+ * 扫描会话 undo 孤儿目录(doctor 兜底)。
197
+ *
198
+ * 正常路径下 commit/discard 会删除 `sessions/<sid>/undo`;仍存在的即残留。
199
+ *
200
+ * @param sessionsDir - `OCTOPI_HOME/sessions`
201
+ * @returns 孤儿列表
202
+ */
203
+ export declare function scanOrphanSessionUndo(sessionsDir: string): Promise<OrphanUndoDir[]>;