@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
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * 提供框架默认的纯工具实现(零外部依赖,所有环境可用):
5
5
  * - shell: 执行 shell 命令
6
- * - file_read / file_write / file_list: 文件读写列目录
6
+ * - file_read / file_write / file_list / file_delete: 文件读写删列目录
7
7
  * - file_edit: 结构化文件编辑(局部替换)
8
8
  * - file_search: 跨文件内容搜索
9
9
  * - http_request: HTTP 请求
@@ -13,23 +13,28 @@
13
13
  *
14
14
  * 安全注意事项:
15
15
  * - shell 工具可以执行任意命令,生产环境应限制命令白名单
16
- * - file_read/file_write/file_edit 应限制可访问的目录范围
16
+ * - file_read/file_write/file_edit/file_delete 应限制可访问的目录范围
17
17
  * - http_request 应限制可访问的域名
18
18
  * - 建议在 ToolPolicy 的 deny 列表中禁用不需要的工具
19
19
  */
20
+ import { gateEffect } from '../../execution-environment/effect-policy.js';
20
21
  import { createFileEditTool } from './file-edit.js';
22
+ import { detectEol, toEol } from './eol.js';
21
23
  import { createFileSearchTool } from './file-search.js';
24
+ import { createFileOpsTools } from './file-ops.js';
25
+ import { createGitTools } from './git-tools.js';
26
+ import { createPackageTools } from './package-tools.js';
22
27
  import { createHttpRequestTool } from './http.js';
23
28
  import { createEnvInfoTool } from './env-info.js';
24
29
  import { createDocumentProbeTool, createDocumentReadTool } from './document-tools.js';
25
- import { defaultPathEnv, isUnderAttachmentRoot, resolvePlatformShell, resolveReadableToolPath, resolveToolPath, } from './platform.js';
30
+ import { isUnderSessionUndoRoot, defaultPathEnv, isPathUnderRoots, isUnderAttachmentRoot, resolvePlatformShell, resolveReadableToolPath, resolveToolPath, } from './platform.js';
26
31
  /**
27
32
  * Shell 工具 — 执行 shell 命令
28
33
  *
29
34
  * 参数:
30
35
  * - command (string, required): 要执行的 shell 命令
31
36
  * - cwd (string, optional): 工作目录
32
- * - timeout (number, optional): 超时时间(毫秒,默认 30000)
37
+ * - timeout (number, optional): 超时时间(毫秒,默认 60000)
33
38
  *
34
39
  * 返回:
35
40
  * - stdout: 标准输出
@@ -48,7 +53,8 @@ export function createShellTool(options) {
48
53
  return {
49
54
  definition: {
50
55
  name: 'shell',
51
- description: `LAST RESORT shell. Prefer a dedicated tool when one covers the job (file_read/file_list/file_write/file_edit/file_search/env_info and any task-specific tools). Use shell only when: no dedicated tool covers the operation, the dedicated tool is unavailable, or it still fails after a correct retry (wrong path/args → fix and retry the tool first). Never use shell instead of a working dedicated tool. Detected shell: ${shell.label}. ${syntaxHint}`,
56
+ capabilities: ['exec'],
57
+ description: `LAST RESORT shell. Prefer a dedicated tool when one covers the job (file_read/file_list/file_write/file_edit/file_delete/file_mkdir/file_rename/file_copy/file_stat/file_rmdir/file_search/env_info/git_status/git_diff/git_log/git_show/git_commit/git_branch/git_restore/package_edit/project_run/package_install and any task-specific tools). Use shell only when: no dedicated tool covers the operation, the dedicated tool is unavailable, or it still fails after a correct retry (wrong path/args → fix and retry the tool first). Never use shell instead of a working dedicated tool. Detected shell: ${shell.label}. ${syntaxHint}`,
52
58
  parameters: {
53
59
  command: {
54
60
  type: 'string',
@@ -61,84 +67,145 @@ export function createShellTool(options) {
61
67
  },
62
68
  timeout: {
63
69
  type: 'number',
64
- description: 'Timeout in milliseconds (default: 30000)',
70
+ description: 'Timeout in milliseconds (default: 60000)',
65
71
  },
66
72
  },
67
- timeoutMs: 60_000,
73
+ // D1: tool-bus outer watchdog ceiling; ProcessSandbox enforces the real kill.
74
+ timeoutMs: 600_000,
68
75
  },
69
76
  handler: async (args, context) => {
70
77
  const command = args.command;
71
78
  const cwd = args.cwd ?? context?.cwd ?? process.cwd();
72
- const timeout = args.timeout ?? 30_000;
73
- const { spawn } = await import('node:child_process');
79
+ await gateEffect({ kind: 'shell', command: args.command, cwd: typeof cwd === 'string' ? cwd : undefined }, {
80
+ effects: context?.effectChannel ?? 'engine',
81
+ confirmEffect: context?.confirmEffect,
82
+ shellEscape: context?.shellEscape,
83
+ });
84
+ // D1-a: ProcessSandbox owns child timeout/tree-kill; tool-bus is outer watchdog.
85
+ const requestedTimeout = Number(args.timeout);
86
+ const sandboxTimeoutMs = Number.isFinite(requestedTimeout) && requestedTimeout > 0
87
+ ? Math.min(Math.floor(requestedTimeout), 598_000)
88
+ : 60_000;
89
+ // §5.6 shell 账本:roots 内 snapshot → 同一 undo log
90
+ const journalMode = context?.shellJournal ?? 'snapshot';
91
+ const journalRoots = (context?.pathRoots ?? []).filter(Boolean);
92
+ let shellBefore;
93
+ let notReversedPayload;
94
+ if (journalMode === 'snapshot') {
95
+ if (journalRoots.length === 0) {
96
+ notReversedPayload = { reason: 'no_roots' };
97
+ }
98
+ else {
99
+ const sj = await import('../../execution-environment/shell-journal.js');
100
+ shellBefore = await sj.snapshotShellRoots({
101
+ roots: journalRoots,
102
+ limit: context?.shellJournalLimit,
103
+ });
104
+ }
105
+ }
106
+ else {
107
+ notReversedPayload = { reason: 'shell_journal_off' };
108
+ }
74
109
  const resolvedShell = resolvePlatformShell();
75
- return new Promise((resolve, reject) => {
76
- const startTime = Date.now();
77
- const child = spawn(resolvedShell.executable, [...resolvedShell.args, command], {
78
- cwd: resolveToolPath(cwd, context?.cwd),
79
- timeout,
80
- env: { ...process.env, PATH: defaultPathEnv() },
81
- windowsHide: true,
82
- });
83
- let stdout = '';
84
- let stderr = '';
85
- child.stdout.on('data', (data) => {
86
- stdout += data.toString();
87
- });
88
- child.stderr.on('data', (data) => {
89
- stderr += data.toString();
90
- });
91
- child.on('close', async (code) => {
92
- const durationMs = Date.now() - startTime;
93
- try {
94
- const { applyToolOutputGate, resolveSupportBinding } = await import('../../../context/capabilities/summary/index.js');
95
- const support = options?.summary;
96
- const binding = resolveSupportBinding('shell', support, 8000);
97
- const applied = await applyToolOutputGate({
98
- tool: 'shell',
99
- rawBody: stdout,
100
- support: { ...support, binding },
101
- truncateHint: 'Re-run with a narrower command, or redirect large output to a file and file_read it.',
102
- });
103
- const stderrApplied = await applyToolOutputGate({
104
- tool: 'shell',
105
- rawBody: stderr,
106
- support: { ...support, binding: { ...binding, maxReturnChars: Math.min(binding.maxReturnChars, 4000) } },
107
- truncateHint: 'stderr truncated.',
108
- });
109
- resolve({
110
- stdout: applied.body,
111
- stderr: stderrApplied.body,
112
- exitCode: code,
113
- durationMs,
114
- truncated: applied.bodyTruncated || stderrApplied.bodyTruncated,
115
- rawStdoutLength: applied.rawLength,
116
- shell: {
117
- kind: resolvedShell.kind,
118
- executable: resolvedShell.executable,
119
- },
110
+ const resolvedCwd = resolveToolPath(cwd, context?.cwd, {
111
+ allowRoots: context?.pathRoots,
112
+ containment: context?.pathContainment,
113
+ });
114
+ // D2-a: always ProcessSandbox (jail backend when probed, else supervised).
115
+ const { createProcessSandbox } = await import('../../execution-environment/sandbox.js');
116
+ const sandbox = await createProcessSandbox({
117
+ forceEnvKeys: ['PATH'],
118
+ });
119
+ const sandboxResult = await sandbox.executeArgv([resolvedShell.executable, ...resolvedShell.args, command], {
120
+ cwd: resolvedCwd,
121
+ env: { PATH: defaultPathEnv() },
122
+ allowRoots: [resolvedCwd, ...(context?.pathRoots ?? []).filter(Boolean)],
123
+ networkPolicy: context?.networkPolicy ?? 'deny',
124
+ requireJail: context?.requireJail,
125
+ homeWrite: context?.homeWrite,
126
+ noteSecurityDegraded: context?.noteSecurityDegraded,
127
+ signal: context?.abortSignal,
128
+ limits: {
129
+ timeoutMs: sandboxTimeoutMs,
130
+ maxOutputBytes: 16 * 1024 * 1024,
131
+ },
132
+ });
133
+ try {
134
+ // §5.6:after diff 入账本 / 不可逆清单
135
+ try {
136
+ const sj = await import('../../execution-environment/shell-journal.js');
137
+ const effects = context?.fileEffects;
138
+ if (shellBefore && effects) {
139
+ const afterCap = await sj.captureShellInventory({
140
+ roots: journalRoots,
141
+ limit: context?.shellJournalLimit,
120
142
  });
143
+ const diff = await sj.journalShellDiff(effects, shellBefore.capture, afterCap, shellBefore.store);
144
+ if (shellBefore.capture.truncated ||
145
+ afterCap.truncated ||
146
+ diff.notInventable.length > 0) {
147
+ await effects.noteNotReversed({
148
+ reason: 'budget_truncated',
149
+ created: diff.notInventable,
150
+ });
151
+ }
121
152
  }
122
- catch {
123
- // summary 模块不可用时的 L1 替代:裸 slice 硬顶,避免超大结果进主会话
124
- resolve({
125
- stdout: stdout.slice(0, 8000),
126
- stderr: stderr.slice(0, 4000),
127
- exitCode: code,
128
- durationMs,
129
- truncated: stdout.length > 8000 || stderr.length > 4000,
130
- rawStdoutLength: stdout.length,
131
- shell: {
132
- kind: resolvedShell.kind,
133
- executable: resolvedShell.executable,
134
- },
135
- });
153
+ else if (notReversedPayload && effects) {
154
+ await effects.noteNotReversed(notReversedPayload);
136
155
  }
156
+ }
157
+ catch {
158
+ // 记账失败不阻断 shell 业务结果
159
+ }
160
+ const { applyToolOutputGate, resolveSupportBinding } = await import('../../../context/capabilities/summary/index.js');
161
+ const support = options?.summary;
162
+ const binding = resolveSupportBinding('shell', support, 8000);
163
+ const applied = await applyToolOutputGate({
164
+ tool: 'shell',
165
+ rawBody: sandboxResult.stdout,
166
+ support: { ...support, binding },
167
+ truncateHint: 'Re-run with a narrower command, or redirect large output to a file and file_read it.',
137
168
  });
138
- child.on('error', (err) => {
139
- reject(new Error(`Shell execution failed (${resolvedShell.label}): ${err.message}`));
169
+ const stderrApplied = await applyToolOutputGate({
170
+ tool: 'shell',
171
+ rawBody: sandboxResult.stderr,
172
+ support: { ...support, binding: { ...binding, maxReturnChars: Math.min(binding.maxReturnChars, 4000) } },
173
+ truncateHint: 'stderr truncated.',
140
174
  });
141
- });
175
+ return {
176
+ stdout: applied.body,
177
+ stderr: stderrApplied.body,
178
+ exitCode: sandboxResult.exitCode,
179
+ durationMs: sandboxResult.usage.elapsedMs,
180
+ truncated: applied.bodyTruncated || stderrApplied.bodyTruncated,
181
+ rawStdoutLength: applied.rawLength,
182
+ terminated: sandboxResult.terminated,
183
+ terminateReason: sandboxResult.terminateReason,
184
+ isolation: sandboxResult.isolation,
185
+ shell: {
186
+ kind: resolvedShell.kind,
187
+ executable: resolvedShell.executable,
188
+ },
189
+ };
190
+ }
191
+ catch {
192
+ // summary 模块不可用时的 L1 替代:裸 slice 硬顶,避免超大结果进主会话
193
+ return {
194
+ stdout: sandboxResult.stdout.slice(0, 8000),
195
+ stderr: sandboxResult.stderr.slice(0, 4000),
196
+ exitCode: sandboxResult.exitCode,
197
+ durationMs: sandboxResult.usage.elapsedMs,
198
+ truncated: sandboxResult.stdout.length > 8000 || sandboxResult.stderr.length > 4000,
199
+ rawStdoutLength: sandboxResult.stdout.length,
200
+ terminated: sandboxResult.terminated,
201
+ terminateReason: sandboxResult.terminateReason,
202
+ isolation: sandboxResult.isolation,
203
+ shell: {
204
+ kind: resolvedShell.kind,
205
+ executable: resolvedShell.executable,
206
+ },
207
+ };
208
+ }
142
209
  },
143
210
  };
144
211
  }
@@ -167,6 +234,7 @@ export function createFileReadTool(options) {
167
234
  return {
168
235
  definition: {
169
236
  name: 'file_read',
237
+ capabilities: ['fs-read'],
170
238
  description: 'Read the contents of a file. Supports text files. Use offset and limit for large files.',
171
239
  parameters: {
172
240
  path: {
@@ -207,7 +275,10 @@ export function createFileReadTool(options) {
207
275
  const pathModule = await import('node:path');
208
276
  const rawPath = args.path;
209
277
  const cwd = context?.cwd ?? process.cwd();
210
- const path = resolveReadableToolPath(rawPath, cwd, context?.attachmentRoots);
278
+ const path = resolveReadableToolPath(rawPath, cwd, context?.attachmentRoots, {
279
+ allowRoots: context?.pathRoots,
280
+ containment: context?.pathContainment,
281
+ });
211
282
  const offset = args.offset ?? 1;
212
283
  const limit = args.limit ?? 2000;
213
284
  try {
@@ -265,7 +336,8 @@ export function createFileWriteTool() {
265
336
  return {
266
337
  definition: {
267
338
  name: 'file_write',
268
- description: 'Write content to a file. Creates the file if it doesn\'t exist, overwrites if it does. Use append mode to add to existing files.',
339
+ capabilities: ['fs-write'],
340
+ description: 'Write content to a file. Creates the file if it doesn\'t exist, overwrites if it does. Use append mode to add to existing files. A full overwrite has NO merge semantics: never build content from stale reads and never assume parallel writes to the same path merge — later sequential writes silently lose earlier changes.',
269
341
  parameters: {
270
342
  path: {
271
343
  type: 'string',
@@ -283,25 +355,52 @@ export function createFileWriteTool() {
283
355
  },
284
356
  },
285
357
  },
358
+ // 整文件覆写无合并语义:所在 tool_call 批次整体串行,防同路径并行写互相抹掉
359
+ executionMode: 'sequential',
286
360
  handler: async (args, context) => {
287
- const { writeFile, appendFile, mkdir } = await import('node:fs/promises');
361
+ const { mkdir } = await import('node:fs/promises');
288
362
  const { dirname } = await import('node:path');
289
363
  const rawPath = args.path;
290
364
  const cwd = context?.cwd ?? process.cwd();
291
- const path = resolveToolPath(rawPath, cwd);
365
+ const path = resolveToolPath(rawPath, cwd, {
366
+ allowRoots: context?.pathRoots,
367
+ containment: context?.pathContainment,
368
+ });
292
369
  if (isUnderAttachmentRoot(path, context?.attachmentRoots)) {
293
370
  throw new Error('session attachments are read-only; cannot write to attachments root');
294
371
  }
295
- const content = args.content;
372
+ if (isUnderSessionUndoRoot(path, context?.undoRoots)) {
373
+ throw new Error('session undo ledger is protected; cannot write to sessions undo dir');
374
+ }
375
+ let content = args.content;
296
376
  const append = args.append ?? false;
377
+ await gateEffect({
378
+ kind: 'file.write',
379
+ path,
380
+ mode: append ? 'append' : 'overwrite',
381
+ transactional: isPathUnderRoots(path, context?.pathRoots ?? []),
382
+ }, {
383
+ effects: context?.effectChannel ?? 'engine',
384
+ confirmEffect: context?.confirmEffect,
385
+ });
297
386
  try {
298
387
  // 确保父目录存在
299
388
  await mkdir(dirname(path), { recursive: true });
389
+ // 行尾跟随:覆写/追加已有文件时把内容换算成该文件主导行尾(新建文件保持原样)
390
+ const { readFile } = await import('node:fs/promises');
391
+ const existing = await readFile(path, 'utf8').catch(() => undefined);
392
+ if (existing !== undefined) {
393
+ content = toEol(content, detectEol(existing));
394
+ }
395
+ const effects = context.fileEffects;
396
+ if (!effects) {
397
+ throw new Error('file_effects_not_configured: file_write requires ToolExecutionContext.fileEffects');
398
+ }
300
399
  if (append) {
301
- await appendFile(path, content);
400
+ await effects.appendFile(path, content);
302
401
  }
303
402
  else {
304
- await writeFile(path, content);
403
+ await effects.writeFile(path, content);
305
404
  }
306
405
  return {
307
406
  path,
@@ -315,6 +414,90 @@ export function createFileWriteTool() {
315
414
  },
316
415
  };
317
416
  }
417
+ /**
418
+ * File Delete 工具 — 删除单个文件(不可删目录)
419
+ *
420
+ * 参数:
421
+ * - path (string, required): 文件路径
422
+ *
423
+ * 走 ToolFileEffects.recordDelete:记 before,编辑重发可恢复。
424
+ */
425
+ export function createFileDeleteTool() {
426
+ return {
427
+ definition: {
428
+ name: 'file_delete',
429
+ capabilities: ['fs-write'],
430
+ description: 'Delete a single file (not a directory). Use this instead of shell rm for files under allowed roots. The delete is journaled and can be undone on edit-resend.',
431
+ parameters: {
432
+ path: {
433
+ type: 'string',
434
+ description: 'Path to the file to delete',
435
+ required: true,
436
+ },
437
+ },
438
+ },
439
+ // fs 写工具:所在 tool_call 批次整体串行
440
+ executionMode: 'sequential',
441
+ handler: async (args, context) => {
442
+ const { readFile, rm, stat } = await import('node:fs/promises');
443
+ const rawPath = args.path;
444
+ const cwd = context?.cwd ?? process.cwd();
445
+ const path = resolveToolPath(rawPath, cwd, {
446
+ allowRoots: context?.pathRoots,
447
+ containment: context?.pathContainment,
448
+ });
449
+ if (isUnderAttachmentRoot(path, context?.attachmentRoots)) {
450
+ throw new Error('session attachments are read-only; cannot delete from attachments root');
451
+ }
452
+ if (isUnderSessionUndoRoot(path, context?.undoRoots)) {
453
+ throw new Error('session undo ledger is protected; cannot delete from sessions undo dir');
454
+ }
455
+ let st;
456
+ try {
457
+ st = await stat(path);
458
+ }
459
+ catch {
460
+ throw new Error(`File not found: ${path}`);
461
+ }
462
+ if (st.isDirectory()) {
463
+ throw new Error(`file_delete targets a directory: ${path}. Delete files one by one, or use shell only if policy allows.`);
464
+ }
465
+ await gateEffect({
466
+ kind: 'file.write',
467
+ path,
468
+ mode: 'overwrite',
469
+ transactional: isPathUnderRoots(path, context?.pathRoots ?? []),
470
+ }, {
471
+ effects: context?.effectChannel ?? 'engine',
472
+ confirmEffect: context?.confirmEffect,
473
+ });
474
+ const effects = context?.fileEffects;
475
+ if (!effects) {
476
+ throw new Error('file_effects_not_configured: file_delete requires ToolExecutionContext.fileEffects');
477
+ }
478
+ let before;
479
+ try {
480
+ before = await readFile(path);
481
+ }
482
+ catch (error) {
483
+ throw new Error(`Failed to read file before delete "${path}": ${error instanceof Error ? error.message : String(error)}`);
484
+ }
485
+ try {
486
+ await effects.recordDelete(path, before);
487
+ await rm(path, { force: true });
488
+ }
489
+ catch (error) {
490
+ throw new Error(`Failed to delete file "${path}": ${error instanceof Error ? error.message : String(error)}`);
491
+ }
492
+ return {
493
+ path,
494
+ deleted: true,
495
+ bytes: before.byteLength,
496
+ reversible: true,
497
+ };
498
+ },
499
+ };
500
+ }
318
501
  /**
319
502
  * 编译 file_list.pattern:优先 glob(`*.md`),否则正则。
320
503
  * `new RegExp('*.md')` 会抛 Nothing to repeat,模型常写 glob。
@@ -383,6 +566,7 @@ export function createFileListTool(options) {
383
566
  return {
384
567
  definition: {
385
568
  name: 'file_list',
569
+ capabilities: ['fs-read'],
386
570
  description: 'List files and directories. Relative paths resolve against the workspace cwd (see Runtime Workspace anchor) — not the disk root. path defaults to workspace. When pattern is set, recursive defaults to true so files in subdirectories (e.g. docs/) are found. Skips node_modules/.git. Output is capped.',
387
571
  parameters: {
388
572
  path: {
@@ -412,7 +596,10 @@ export function createFileListTool(options) {
412
596
  const { join, relative } = await import('node:path');
413
597
  const rawPath = args.path ?? '.';
414
598
  const cwd = context?.cwd ?? process.cwd();
415
- const basePath = resolveReadableToolPath(rawPath, cwd, context?.attachmentRoots);
599
+ const basePath = resolveReadableToolPath(rawPath, cwd, context?.attachmentRoots, {
600
+ allowRoots: context?.pathRoots,
601
+ containment: context?.pathContainment,
602
+ });
416
603
  // 找文件意图(带 pattern)默认递归;显式 recursive:false 仍只列本层
417
604
  const hasPattern = Boolean(args.pattern?.trim());
418
605
  const recursive = args.recursive === undefined && hasPattern
@@ -562,8 +749,12 @@ export function getBuiltinTools(options) {
562
749
  createFileReadTool({ summary: options?.summary }),
563
750
  createFileListTool({ summary: options?.summary }),
564
751
  createFileWriteTool(),
752
+ createFileDeleteTool(),
565
753
  createFileEditTool(),
566
- createFileSearchTool(),
754
+ createFileSearchTool({ summary: options?.summary }),
755
+ ...createFileOpsTools(),
756
+ ...createGitTools(),
757
+ ...createPackageTools(),
567
758
  ...(options?.documentPort
568
759
  ? [
569
760
  createDocumentReadTool({
@@ -573,7 +764,12 @@ export function getBuiltinTools(options) {
573
764
  createDocumentProbeTool({ documentPort: options.documentPort }),
574
765
  ]
575
766
  : []),
576
- createHttpRequestTool({ summary: options?.summary }),
767
+ createHttpRequestTool({
768
+ summary: options?.summary,
769
+ credentials: options?.credentials,
770
+ network: options?.network,
771
+ requireBindings: options?.requireCredentialBindings,
772
+ }),
577
773
  createEnvInfoTool(),
578
774
  createShellTool({ summary: options?.summary }),
579
775
  ];
@@ -0,0 +1,31 @@
1
+ /**
2
+ * delegate_* 工具 — 经 DelegateService 委派任务给子 agent
3
+ *
4
+ * @layer harness/extension/plugin-ecosystem/tools
5
+ * 设计权威:`arch/delegation.md` §7 / §14。
6
+ *
7
+ * **非阻塞**(§7):`delegate_dispatch` 立即返回 `delegationId`,不等子 Run 结束。
8
+ * 结果回收走 `delegate_get`(poll)或 notify 通道(P3)。
9
+ *
10
+ * 工具与 `DelegateService` 分离:服务可被嵌入方直接用,不经 LLM 工具面。
11
+ */
12
+ import type { RegisteredTool } from '@octopi-agent/core/types.js';
13
+ import type { DelegateService } from '../../../collaboration/delegation/service.js';
14
+ /** 创建 delegate_* 工具集 */
15
+ export declare function createDelegationTools(service: DelegateService): RegisteredTool[];
16
+ /**
17
+ * `delegate_dispatch` — 非阻塞派发委派
18
+ */
19
+ export declare function createDelegateDispatchTool(service: DelegateService): RegisteredTool;
20
+ /**
21
+ * `delegate_list` — 列出委派单(poll 通道 / 全景)
22
+ */
23
+ export declare function createDelegateListTool(service: DelegateService): RegisteredTool;
24
+ /**
25
+ * `delegate_get` — 取委派单详情 / 结果
26
+ */
27
+ export declare function createDelegateGetTool(service: DelegateService): RegisteredTool;
28
+ /**
29
+ * `delegate_cancel` — 取消委派
30
+ */
31
+ export declare function createDelegateCancelTool(service: DelegateService): RegisteredTool;