@octopi-agent/engine 0.65.0 → 0.86.38

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 (421) 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 +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  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 +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  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 +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  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 +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  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 +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -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/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  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/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -0,0 +1,554 @@
1
+ import { gateEffect } from '../../execution-environment/effect-policy.js';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { resolveToolPath, isUnderAttachmentRoot, isUnderSessionUndoRoot } from './platform.js';
5
+ import { detectEol, toEol } from './eol.js';
6
+ import { assertSafeRef, requireExecutable, runAllowlistedArgv, } from './allowlisted-run.js';
7
+ /**
8
+ * Nonexistent hooks dir (empty core.hooksPath is version-fragile: some gits
9
+ * treat it as `./` and still run cwd hooks).
10
+ */
11
+ function noHooksDir() {
12
+ return join(tmpdir(), 'octopi-nohooks');
13
+ }
14
+ /**
15
+ * Fixed git safety prefix. Command-line `-c` outranks local `.git/config`, so
16
+ * these neutralize repo-config RCE vectors (diff.external, gpg.program, …).
17
+ * `--no-optional-locks` avoids index lock fights. Never pass user `-c`.
18
+ */
19
+ function gitSafePrefix() {
20
+ const hooks = noHooksDir();
21
+ return [
22
+ '--no-optional-locks',
23
+ '-c', `core.hooksPath=${hooks}`,
24
+ '-c', 'core.fsmonitor=',
25
+ '-c', 'core.pager=cat',
26
+ '-c', 'diff.external=',
27
+ '-c', 'diff.tool=',
28
+ '-c', 'merge.tool=',
29
+ '-c', 'merge.prompt=false',
30
+ '-c', 'gpg.program=true',
31
+ '-c', 'commit.gpgsign=false',
32
+ '-c', 'core.sshCommand=',
33
+ '-c', 'core.askpass=',
34
+ '-c', 'credential.helper=',
35
+ '-c', 'core.attributesFile=',
36
+ '-c', 'core.excludesFile=',
37
+ ];
38
+ }
39
+ /**
40
+ * Isolate global/system gitconfig. Local `.git/config` is still read; dangerous
41
+ * keys there are overridden by the `-c` prefix above (command line wins).
42
+ * On Windows use `NUL`, elsewhere `/dev/null` — a missing file is also fine.
43
+ */
44
+ function gitIsolationEnv() {
45
+ const nullPath = process.platform === 'win32' ? 'NUL' : '/dev/null';
46
+ return {
47
+ GIT_CONFIG_NOSYSTEM: '1',
48
+ GIT_CONFIG_SYSTEM: nullPath,
49
+ GIT_CONFIG_GLOBAL: nullPath,
50
+ GIT_TERMINAL_PROMPT: '0',
51
+ GIT_OPTIONAL_LOCKS: '0',
52
+ GIT_ASKPASS: '',
53
+ SSH_ASKPASS: '',
54
+ };
55
+ }
56
+ function resolveCwd(context, raw) {
57
+ const cwd = raw ?? context?.cwd ?? process.cwd();
58
+ const abs = resolveToolPath(cwd, context?.cwd, {
59
+ allowRoots: context?.pathRoots,
60
+ containment: context?.pathContainment,
61
+ });
62
+ if (isUnderAttachmentRoot(abs, context?.attachmentRoots)) {
63
+ throw new Error('session attachments are read-only; cannot run git under attachments root');
64
+ }
65
+ if (isUnderSessionUndoRoot(abs, context?.undoRoots)) {
66
+ throw new Error('session undo ledger is protected; cannot run git under sessions undo dir');
67
+ }
68
+ return abs;
69
+ }
70
+ function assertPathSafe(raw, context, label) {
71
+ const abs = resolveToolPath(raw, context?.cwd, {
72
+ allowRoots: context?.pathRoots,
73
+ containment: context?.pathContainment,
74
+ });
75
+ if (isUnderAttachmentRoot(abs, context?.attachmentRoots)) {
76
+ throw new Error(`session attachments are read-only; cannot ${label} under attachments root`);
77
+ }
78
+ if (isUnderSessionUndoRoot(abs, context?.undoRoots)) {
79
+ throw new Error(`session undo ledger is protected; cannot ${label} under sessions undo dir`);
80
+ }
81
+ return abs;
82
+ }
83
+ /**
84
+ * Pathspec for git porcelain.
85
+ *
86
+ * Simple paths are L2-resolved (absolute + roots-checked). Glob/magic specs
87
+ * (src/*.ts, :(exclude)...) must stay relative - absolute-resolving them
88
+ * turns the pattern into a literal path and silently matches nothing. Those
89
+ * pass through after a .. / absolute / NUL ban; cwd is already L2-contained.
90
+ */
91
+ function toGitPathspec(raw, context, label) {
92
+ const isMagic = raw.startsWith(':(') || /[*?\[]/.test(raw);
93
+ if (!isMagic) {
94
+ return assertPathSafe(raw, context, label);
95
+ }
96
+ if (raw.startsWith('/') ||
97
+ raw.startsWith('\\\\') ||
98
+ (process.platform === 'win32' && /^[A-Za-z]:[\\/]/.test(raw))) {
99
+ throw new Error(`pathspec_glob_unsupported: absolute glob "${raw}" is not supported; use a relative glob (e.g. src/*.ts)`);
100
+ }
101
+ if (raw.split(/[\\/]/).some((seg) => seg === '..')) {
102
+ throw new Error(`pathspec_glob_forbidden: ".." is not allowed in glob pathspec "${raw}"`);
103
+ }
104
+ if (raw.includes('\0')) {
105
+ throw new Error(`pathspec_invalid: "${raw}" contains a NUL byte`);
106
+ }
107
+ return raw;
108
+ }
109
+ /**
110
+ * Discover filter.* drivers from repo/user config and pin them to `cat`.
111
+ * Command-line `-c` outranks local `.git/config`, so a malicious
112
+ * .gitattributes cannot run clean/smudge/process during `git add`.
113
+ */
114
+ async function filterNeutralizers(context, cwd) {
115
+ const git = requireExecutable('git');
116
+ const res = await runAllowlistedArgv({
117
+ executable: git,
118
+ args: [...gitSafePrefix(), 'config', '--name-only', '--get-regexp', '^filter\\.'],
119
+ cwd,
120
+ context,
121
+ env: gitIsolationEnv(),
122
+ journal: false,
123
+ });
124
+ if (res.exitCode !== 0)
125
+ return [];
126
+ const names = new Set();
127
+ for (const line of res.stdout.split(/\r?\n/)) {
128
+ const m = /^filter\.(.+)\.(clean|smudge|process)$/.exec(line.trim());
129
+ if (m && /^[A-Za-z0-9._-]+$/.test(m[1]))
130
+ names.add(m[1]);
131
+ }
132
+ const out = [];
133
+ for (const n of names) {
134
+ out.push('-c', `filter.${n}.clean=cat`, '-c', `filter.${n}.smudge=cat`, '-c', `filter.${n}.process=cat`);
135
+ }
136
+ return out;
137
+ }
138
+ async function runGit(context, cwd, args, options) {
139
+ const git = requireExecutable('git');
140
+ return runAllowlistedArgv({
141
+ executable: git,
142
+ args: [...gitSafePrefix(), ...(await filterNeutralizers(context, cwd)), ...args],
143
+ cwd,
144
+ context,
145
+ env: gitIsolationEnv(),
146
+ timeoutMs: options?.timeoutMs ?? 60_000,
147
+ journal: options?.journal ?? false,
148
+ });
149
+ }
150
+ function toText(result) {
151
+ return {
152
+ stdout: result.stdout,
153
+ stderr: result.stderr,
154
+ exitCode: result.exitCode,
155
+ durationMs: result.durationMs,
156
+ truncated: result.truncated,
157
+ terminated: result.terminated,
158
+ terminateReason: result.terminateReason,
159
+ isolation: result.isolation,
160
+ };
161
+ }
162
+ /** git_status 鈥?porcelain working tree status */
163
+ export function createGitStatusTool() {
164
+ return {
165
+ definition: {
166
+ name: 'git_status',
167
+ capabilities: ['vcs', 'fs-read'],
168
+ description: 'Show git working tree status (porcelain v1 + branch header). Prefer this over shell git status. Read-only.',
169
+ parameters: {
170
+ cwd: { type: 'string', description: 'Repository path (defaults to workspace cwd)' },
171
+ paths: {
172
+ type: 'array',
173
+ description: 'Optional pathspecs to limit the status',
174
+ items: { type: 'string', description: 'Path or pathspec' },
175
+ },
176
+ },
177
+ },
178
+ handler: async (args, context) => {
179
+ const cwd = resolveCwd(context, args.cwd);
180
+ const paths = Array.isArray(args.paths) ? args.paths : [];
181
+ const pathArgs = paths.length > 0 ? ['--', ...paths.map((p) => toGitPathspec(p, context, 'status'))] : [];
182
+ const result = await runGit(context, cwd, [
183
+ 'status',
184
+ '--porcelain=v1',
185
+ '--branch',
186
+ '--untracked-files=all',
187
+ ...pathArgs,
188
+ ]);
189
+ return { ...toText(result), cwd };
190
+ },
191
+ };
192
+ }
193
+ /** git_diff 鈥?unstaged / staged / vs-ref diff */
194
+ export function createGitDiffTool() {
195
+ return {
196
+ definition: {
197
+ name: 'git_diff',
198
+ capabilities: ['vcs', 'fs-read'],
199
+ description: 'Show a git diff. mode: unstaged (default) | staged | commit (vs a revision). Prefer this over shell git diff. Read-only.',
200
+ parameters: {
201
+ cwd: { type: 'string', description: 'Repository path' },
202
+ mode: {
203
+ type: 'string',
204
+ description: 'Diff mode',
205
+ enum: ['unstaged', 'staged', 'commit'],
206
+ default: 'unstaged',
207
+ },
208
+ revision: {
209
+ type: 'string',
210
+ description: 'Revision for mode=commit (e.g. HEAD~1, main)',
211
+ },
212
+ stat: { type: 'boolean', description: 'Show diffstat instead of full patch' },
213
+ paths: {
214
+ type: 'array',
215
+ description: 'Optional pathspecs',
216
+ items: { type: 'string', description: 'Path or pathspec' },
217
+ },
218
+ },
219
+ },
220
+ handler: async (args, context) => {
221
+ const cwd = resolveCwd(context, args.cwd);
222
+ const modeRaw = args.mode ?? 'unstaged';
223
+ if (!['unstaged', 'staged', 'commit'].includes(modeRaw)) {
224
+ throw new Error(`git_diff: unsupported mode "${modeRaw}" (use unstaged|staged|commit)`);
225
+ }
226
+ const mode = modeRaw;
227
+ const gitArgs = ['diff', '--no-color', '--no-ext-diff'];
228
+ if (mode === 'staged')
229
+ gitArgs.push('--cached');
230
+ if (mode === 'commit') {
231
+ const rev = assertSafeRef(String(args.revision ?? 'HEAD'), 'revision');
232
+ gitArgs.push(rev);
233
+ }
234
+ if (args.stat === true)
235
+ gitArgs.push('--stat');
236
+ const paths = Array.isArray(args.paths) ? args.paths : [];
237
+ if (paths.length > 0) {
238
+ gitArgs.push('--', ...paths.map((p) => toGitPathspec(p, context, 'diff')));
239
+ }
240
+ const result = await runGit(context, cwd, gitArgs, { timeoutMs: 120_000 });
241
+ return { ...toText(result), cwd, mode };
242
+ },
243
+ };
244
+ }
245
+ /** git_log 鈥?commit history */
246
+ export function createGitLogTool() {
247
+ return {
248
+ definition: {
249
+ name: 'git_log',
250
+ capabilities: ['vcs', 'fs-read'],
251
+ description: 'Show commit history (oneline by default). Prefer this over shell git log. Read-only.',
252
+ parameters: {
253
+ cwd: { type: 'string', description: 'Repository path' },
254
+ limit: {
255
+ type: 'number',
256
+ description: 'Max commits (default 20, max 200)',
257
+ minimum: 1,
258
+ maximum: 200,
259
+ },
260
+ revision: { type: 'string', description: 'Starting revision (default HEAD)' },
261
+ oneline: { type: 'boolean', description: 'Compact one-line format (default true)' },
262
+ paths: {
263
+ type: 'array',
264
+ description: 'Optional pathspecs',
265
+ items: { type: 'string', description: 'Path or pathspec' },
266
+ },
267
+ },
268
+ },
269
+ handler: async (args, context) => {
270
+ const cwd = resolveCwd(context, args.cwd);
271
+ const rawLimit = Number(args.limit);
272
+ const limit = Number.isFinite(rawLimit) ? Math.min(Math.max(Math.trunc(rawLimit), 1), 200) : 20;
273
+ const rev = assertSafeRef(String(args.revision ?? 'HEAD'), 'revision');
274
+ const oneline = args.oneline !== false;
275
+ const gitArgs = ['log', '--no-ext-diff', `--max-count=${limit}`];
276
+ if (oneline)
277
+ gitArgs.push('--oneline', '--decorate');
278
+ gitArgs.push(rev);
279
+ const paths = Array.isArray(args.paths) ? args.paths : [];
280
+ if (paths.length > 0) {
281
+ gitArgs.push('--', ...paths.map((p) => toGitPathspec(p, context, 'log')));
282
+ }
283
+ const result = await runGit(context, cwd, gitArgs);
284
+ return { ...toText(result), cwd, limit, revision: rev };
285
+ },
286
+ };
287
+ }
288
+ /** git_show 鈥?show a commit / tree / blob */
289
+ export function createGitShowTool() {
290
+ return {
291
+ definition: {
292
+ name: 'git_show',
293
+ capabilities: ['vcs', 'fs-read'],
294
+ description: 'Show a git object (commit, tag, or tree). Read-only.',
295
+ parameters: {
296
+ cwd: { type: 'string', description: 'Repository path' },
297
+ revision: { type: 'string', description: 'Revision to show (default HEAD)', default: 'HEAD' },
298
+ stat: { type: 'boolean', description: 'Show diffstat instead of full patch' },
299
+ },
300
+ },
301
+ handler: async (args, context) => {
302
+ const cwd = resolveCwd(context, args.cwd);
303
+ const rev = assertSafeRef(String(args.revision ?? 'HEAD'), 'revision');
304
+ const gitArgs = ['show', '--no-color', '--no-ext-diff'];
305
+ if (args.stat === true)
306
+ gitArgs.push('--stat');
307
+ gitArgs.push(rev);
308
+ const result = await runGit(context, cwd, gitArgs, { timeoutMs: 120_000 });
309
+ return { ...toText(result), cwd, revision: rev };
310
+ },
311
+ };
312
+ }
313
+ /** git_commit 鈥?add paths + commit (hooks disabled) */
314
+ export function createGitCommitTool() {
315
+ return {
316
+ definition: {
317
+ name: 'git_commit',
318
+ capabilities: ['vcs', 'fs-write'],
319
+ description: 'Stage paths and create a commit. Hooks and gpg signing disabled (--no-verify --no-gpg-sign); filters neutralized. Prefer this over shell git commit.',
320
+ parameters: {
321
+ cwd: { type: 'string', description: 'Repository path' },
322
+ message: { type: 'string', description: 'Commit message', required: true },
323
+ paths: {
324
+ type: 'array',
325
+ description: 'Paths to stage and commit (omit to commit already-staged changes)',
326
+ items: { type: 'string', description: 'Path' },
327
+ },
328
+ all: {
329
+ type: 'boolean',
330
+ description: 'Stage all tracked modifications (git add -A on given paths or repo)',
331
+ },
332
+ amend: { type: 'boolean', description: 'Amend the previous commit' },
333
+ eol: {
334
+ type: 'string',
335
+ description: 'EOL handling for staged text files: "normalize" (default; rewrite each staged file to the EOL convention of its HEAD blob before commit, avoiding whole-file line-ending churn) | "keep" (commit bytes as-is)',
336
+ enum: ['normalize', 'keep'],
337
+ },
338
+ },
339
+ },
340
+ handler: async (args, context) => {
341
+ const cwd = resolveCwd(context, args.cwd);
342
+ const message = String(args.message ?? '').trim();
343
+ if (!message)
344
+ throw new Error('git_commit: message is required');
345
+ await gateEffect({
346
+ kind: 'vcs',
347
+ operation: 'commit',
348
+ cwd,
349
+ description: `git commit: ${message.slice(0, 80)}`,
350
+ }, {
351
+ effects: context?.effectChannel ?? 'engine',
352
+ confirmEffect: context?.confirmEffect,
353
+ sessionId: context?.sessionId,
354
+ agentId: context?.agentId,
355
+ });
356
+ const paths = Array.isArray(args.paths) ? args.paths : [];
357
+ const resolvedPaths = paths.map((p) => toGitPathspec(p, context, 'commit'));
358
+ const useAll = args.all === true;
359
+ if (resolvedPaths.length > 0 || useAll) {
360
+ const addArgs = ['add'];
361
+ if (useAll)
362
+ addArgs.push('-A');
363
+ if (resolvedPaths.length > 0)
364
+ addArgs.push('--', ...resolvedPaths);
365
+ const addResult = await runGit(context, cwd, addArgs, { journal: true });
366
+ if (addResult.exitCode !== 0) {
367
+ return { ...toText(addResult), stage: 'add', cwd };
368
+ }
369
+ }
370
+ // EOL 归一:工具 git 隔离全局配置(autocrlf 不可见),worktree 的 CRLF 会被
371
+ // 原样入库,与 HEAD blob 的行尾约定相悖时产生整文件 churn。跟随 HEAD blob 的
372
+ // 行尾约定重写已暂存文本文件(新文件 / 删除 / 二进制 / 非 UTF-8 不动)。
373
+ const eolNormalized = [];
374
+ if (args.eol !== 'keep') {
375
+ const staged = await runGit(context, cwd, ['diff', '--cached', '--name-only', '-z', 'HEAD']);
376
+ if (staged.exitCode === 0) {
377
+ const { readFile, writeFile } = await import('node:fs/promises');
378
+ const { join: joinPath } = await import('node:path');
379
+ for (const rel of staged.stdout.split('\0').map((s) => s.trim()).filter(Boolean)) {
380
+ const abs = joinPath(cwd, rel);
381
+ const workBuf = await readFile(abs).catch(() => undefined);
382
+ if (!workBuf || workBuf.includes(0))
383
+ continue;
384
+ let workText;
385
+ try {
386
+ workText = new TextDecoder('utf-8', { fatal: true }).decode(workBuf);
387
+ }
388
+ catch {
389
+ continue;
390
+ }
391
+ const head = await runGit(context, cwd, ['show', `HEAD:${rel}`]);
392
+ if (head.exitCode !== 0)
393
+ continue;
394
+ const normalized = toEol(workText, detectEol(head.stdout));
395
+ if (normalized === workText)
396
+ continue;
397
+ await writeFile(abs, normalized);
398
+ await runGit(context, cwd, ['add', '--', rel]);
399
+ eolNormalized.push(rel);
400
+ }
401
+ }
402
+ }
403
+ const commitArgs = ['commit', '--no-verify', '--no-gpg-sign', '-m', message];
404
+ if (args.amend === true)
405
+ commitArgs.push('--amend');
406
+ if (resolvedPaths.length > 0) {
407
+ // Limit the commit to the given paths (working-tree state).
408
+ commitArgs.push('--', ...resolvedPaths);
409
+ }
410
+ const result = await runGit(context, cwd, commitArgs, {
411
+ journal: true,
412
+ timeoutMs: 60_000,
413
+ });
414
+ return { ...toText(result), stage: 'commit', cwd, message, eolNormalized };
415
+ },
416
+ };
417
+ }
418
+ /** git_branch 鈥?list / create / switch / delete */
419
+ export function createGitBranchTool() {
420
+ return {
421
+ definition: {
422
+ name: 'git_branch',
423
+ capabilities: ['vcs', 'fs-write'],
424
+ description: 'List, create, switch, or delete local branches. action: list (default) | create | switch | delete.',
425
+ parameters: {
426
+ cwd: { type: 'string', description: 'Repository path' },
427
+ action: {
428
+ type: 'string',
429
+ description: 'Branch action',
430
+ enum: ['list', 'create', 'switch', 'delete'],
431
+ default: 'list',
432
+ },
433
+ name: {
434
+ type: 'string',
435
+ description: 'Branch name (required for create/switch/delete)',
436
+ },
437
+ startPoint: {
438
+ type: 'string',
439
+ description: 'Start point for create (e.g. HEAD~1)',
440
+ },
441
+ },
442
+ },
443
+ handler: async (args, context) => {
444
+ const cwd = resolveCwd(context, args.cwd);
445
+ const action = args.action ?? 'list';
446
+ const name = args.name !== undefined ? assertSafeRef(String(args.name), 'branch') : undefined;
447
+ if (action === 'list') {
448
+ const result = await runGit(context, cwd, ['branch', '--list', '--verbose']);
449
+ return { ...toText(result), cwd, action };
450
+ }
451
+ if (!name)
452
+ throw new Error(`git_branch: name is required for action=${action}`);
453
+ await gateEffect({
454
+ kind: 'vcs',
455
+ operation: `branch.${action}`,
456
+ cwd,
457
+ description: `git branch ${action} ${name}`,
458
+ }, {
459
+ effects: context?.effectChannel ?? 'engine',
460
+ confirmEffect: context?.confirmEffect,
461
+ sessionId: context?.sessionId,
462
+ agentId: context?.agentId,
463
+ });
464
+ let gitArgs;
465
+ if (action === 'create') {
466
+ gitArgs = ['branch', name];
467
+ if (args.startPoint !== undefined) {
468
+ gitArgs.push(assertSafeRef(String(args.startPoint), 'startPoint'));
469
+ }
470
+ }
471
+ else if (action === 'switch') {
472
+ gitArgs = ['switch', name];
473
+ }
474
+ else if (action === 'delete') {
475
+ gitArgs = ['branch', '-d', name];
476
+ }
477
+ else {
478
+ throw new Error(`git_branch: unsupported action "${action}"`);
479
+ }
480
+ const result = await runGit(context, cwd, gitArgs, { journal: true });
481
+ return { ...toText(result), cwd, action, name };
482
+ },
483
+ };
484
+ }
485
+ /** git_restore 鈥?restore working tree / index paths */
486
+ export function createGitRestoreTool() {
487
+ return {
488
+ definition: {
489
+ name: 'git_restore',
490
+ capabilities: ['vcs', 'fs-write'],
491
+ description: 'Restore files from a source revision (or unstage them). Prefer this over shell git checkout/restore.',
492
+ parameters: {
493
+ cwd: { type: 'string', description: 'Repository path' },
494
+ paths: {
495
+ type: 'array',
496
+ description: 'Paths to restore',
497
+ items: { type: 'string', description: 'Path' },
498
+ required: true,
499
+ },
500
+ source: {
501
+ type: 'string',
502
+ description: 'Source revision (default: keep current index/worktree rules)',
503
+ },
504
+ staged: { type: 'boolean', description: 'Unstage paths (restore index only)' },
505
+ worktree: { type: 'boolean', description: 'Restore working tree (default true when not staged-only)' },
506
+ },
507
+ },
508
+ // 覆写工作树文件(index):所在 tool_call 批次整体串行,防与同路径写交错
509
+ executionMode: 'sequential',
510
+ handler: async (args, context) => {
511
+ const cwd = resolveCwd(context, args.cwd);
512
+ const paths = Array.isArray(args.paths) ? args.paths : [];
513
+ if (paths.length === 0)
514
+ throw new Error('git_restore: paths is required');
515
+ const resolvedPaths = paths.map((p) => toGitPathspec(p, context, 'restore'));
516
+ await gateEffect({
517
+ kind: 'vcs',
518
+ operation: 'restore',
519
+ cwd,
520
+ description: `git restore ${resolvedPaths.join(' ')}`,
521
+ }, {
522
+ effects: context?.effectChannel ?? 'engine',
523
+ confirmEffect: context?.confirmEffect,
524
+ sessionId: context?.sessionId,
525
+ agentId: context?.agentId,
526
+ });
527
+ const gitArgs = ['restore'];
528
+ if (args.staged === true)
529
+ gitArgs.push('--staged');
530
+ if (args.worktree !== false && args.staged !== true)
531
+ gitArgs.push('--worktree');
532
+ if (args.staged === true && args.worktree === true)
533
+ gitArgs.push('--worktree');
534
+ if (args.source !== undefined) {
535
+ gitArgs.push(`--source=${assertSafeRef(String(args.source), 'source')}`);
536
+ }
537
+ gitArgs.push('--', ...resolvedPaths);
538
+ const result = await runGit(context, cwd, gitArgs, { journal: true });
539
+ return { ...toText(result), cwd, paths: resolvedPaths };
540
+ },
541
+ };
542
+ }
543
+ /** All git_* tools (read + write). */
544
+ export function createGitTools() {
545
+ return [
546
+ createGitStatusTool(),
547
+ createGitDiffTool(),
548
+ createGitLogTool(),
549
+ createGitShowTool(),
550
+ createGitCommitTool(),
551
+ createGitBranchTool(),
552
+ createGitRestoreTool(),
553
+ ];
554
+ }
@@ -2,27 +2,31 @@
2
2
  * http_request 工具 — HTTP 请求
3
3
  *
4
4
  * 让 Agent 能够主动发起 HTTP 请求,调用 REST API、获取网页内容。
5
- * 使用 Node.js 20+ 内置 fetch,零额外依赖。
6
5
  *
7
- * 超长响应:经 capabilities SummaryPort 做 L2 软净化 + L1 硬顶(见 arch/summary-compact.md §3.6)。
6
+ * 出站:经 knowledge/network-guard SSRF 门(默认拒私网/环回/metadata;
7
+ * connect 时 lookup 再校验)。内网目标需 `network.allowPrivateNetwork` 显式开。
8
+ * 重定向每跳复验。shell `curl` 不经此路径(见 docs/KNOWN-ISSUES)。
8
9
  *
9
- * 安全注意事项:
10
- * - 生产环境应通过 ToolPolicy 限制可访问的域名
11
- * - 内网访问默认允许,可通过 security guard 拦截
10
+ * 超长响应:经 capabilities SummaryPort 做 L2 软净化 + L1 硬顶(见 arch/summary-compact.md §3.6)。
12
11
  */
13
12
  import type { RegisteredTool } from '@octopi-agent/core/types.js';
14
13
  import { type ToolSummarySupport } from '../../../context/capabilities/summary/index.js';
15
14
  import type { CredentialStore } from '../../../governance/credentials/store.js';
15
+ import { type NetworkGuardOptions } from '../../../knowledge/network-guard.js';
16
16
  export interface HttpRequestToolOptions {
17
17
  /** Summary L1/L2 支持;未提供时仅使用内置 L1 binding */
18
18
  summary?: ToolSummarySupport;
19
19
  /** 凭证库(credential 参数按名注入 header,模型不见明文) */
20
20
  credentials?: CredentialStore | null;
21
+ /** SSRF 门选项(allowPrivateNetwork / timeout / maxRedirects…) */
22
+ network?: NetworkGuardOptions;
23
+ /** 强制 credential_bindings(空绑定即拒);缺省随 store / Run 上下文 */
24
+ requireBindings?: boolean;
21
25
  }
22
26
  /**
23
27
  * 创建 http_request 工具
24
28
  *
25
- * @param options - 可选 SummaryPort / binding 配置注入
29
+ * @param options - 可选 SummaryPort / CredentialStore / network 门禁
26
30
  * @returns RegisteredTool
27
31
  */
28
32
  export declare function createHttpRequestTool(options?: HttpRequestToolOptions): RegisteredTool;