@octopi-agent/engine 0.70.7 → 0.90.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +201 -8
  23. package/dist/config.js +105 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -0,0 +1,184 @@
1
+ /**
2
+ * HITL decision cache (SEC-7 single model).
3
+ *
4
+ * Hosts only *express* a {@link HitlDecision}; the engine remembers
5
+ * `approve_session` / `approve_always` so the confirm hook is not re-entered.
6
+ * `deny` and one-shot `approve` are never cached.
7
+ *
8
+ * Scoping (narrow-only):
9
+ * - `approve_session` → per `sessionId` + tool/effect key
10
+ * - `approve_always` → per `agentId` + tool/effect key(agent 信任级不同则分桶)
11
+ * Missing scope id → degrade to one-shot (never over-grant).
12
+ */
13
+ function channelKey(channel, key) {
14
+ return `${channel}\0${key}`;
15
+ }
16
+ function sessionKey(channel, sessionId, key) {
17
+ return `${sessionId}\0${channelKey(channel, key)}`;
18
+ }
19
+ /** always is agent-scoped: different trust domains do not share grants */
20
+ function alwaysKey(agentId, channel, key) {
21
+ return `${agentId}\0${channelKey(channel, key)}`;
22
+ }
23
+ /**
24
+ * In-memory HITL approval cache.
25
+ *
26
+ * Session-scoped approvals are keyed by `sessionId` and expire after
27
+ * {@link HitlDecisionCache.sessionTtlMs}. Always-scoped approvals are keyed by
28
+ * `agentId` and live for the process lifetime (not persisted).
29
+ */
30
+ export class HitlDecisionCache {
31
+ /** Session-scope TTL in ms (default 24h) */
32
+ sessionTtlMs;
33
+ session = new Map();
34
+ always = new Map();
35
+ /** In-flight resolves, so concurrent same-key confirms share one ask() */
36
+ inflight = new Map();
37
+ /**
38
+ * @param sessionTtlMs - how long `approve_session` stays valid (default 24h)
39
+ */
40
+ constructor(sessionTtlMs = 24 * 60 * 60 * 1000) {
41
+ this.sessionTtlMs = sessionTtlMs;
42
+ }
43
+ /**
44
+ * Look up a remembered approval.
45
+ *
46
+ * @param channel - high_risk | effect
47
+ * @param key - tool name or effect kind
48
+ * @param options - sessionId (session scope) and/or agentId (always scope)
49
+ * @returns `'approve'` if cached, otherwise `null`
50
+ */
51
+ get(channel, key, options = {}) {
52
+ const { sessionId, agentId } = options;
53
+ if (agentId) {
54
+ const always = this.always.get(alwaysKey(agentId, channel, key));
55
+ if (always)
56
+ return always;
57
+ }
58
+ if (!sessionId)
59
+ return null;
60
+ const entry = this.session.get(sessionKey(channel, sessionId, key));
61
+ if (!entry)
62
+ return null;
63
+ if (entry.expiresAt < Date.now()) {
64
+ this.session.delete(sessionKey(channel, sessionId, key));
65
+ return null;
66
+ }
67
+ return entry.decision;
68
+ }
69
+ /**
70
+ * Remember an approval decision. Only `approve_session` / `approve_always`
71
+ * are stored; `deny` and one-shot `approve` are ignored.
72
+ *
73
+ * `approve_session` requires `sessionId`; `approve_always` requires `agentId`.
74
+ * Missing scope id → silently one-shot (fail-safe, never over-grant).
75
+ *
76
+ * @param decision - host decision
77
+ * @param channel - high_risk | effect
78
+ * @param key - tool name or effect kind
79
+ * @param options - sessionId and/or agentId
80
+ */
81
+ remember(decision, channel, key, options = {}) {
82
+ const { sessionId, agentId } = options;
83
+ if (decision === 'approve_always') {
84
+ if (!agentId)
85
+ return;
86
+ this.always.set(alwaysKey(agentId, channel, key), 'approve');
87
+ return;
88
+ }
89
+ if (decision === 'approve_session') {
90
+ if (!sessionId)
91
+ return;
92
+ this.session.set(sessionKey(channel, sessionId, key), {
93
+ decision: 'approve',
94
+ expiresAt: Date.now() + this.sessionTtlMs,
95
+ });
96
+ }
97
+ }
98
+ /**
99
+ * Drop session-scoped approvals for one session (always-scope kept).
100
+ *
101
+ * @param sessionId - session to clear
102
+ */
103
+ clearSession(sessionId) {
104
+ const prefix = `${sessionId}\0`;
105
+ for (const k of this.session.keys()) {
106
+ if (k.startsWith(prefix))
107
+ this.session.delete(k);
108
+ }
109
+ }
110
+ /** Drop always-scoped approvals for one agent. */
111
+ clearAgent(agentId) {
112
+ const prefix = `${agentId}\0`;
113
+ for (const k of this.always.keys()) {
114
+ if (k.startsWith(prefix))
115
+ this.always.delete(k);
116
+ }
117
+ }
118
+ /** Drop all cached approvals (tests / host reset). */
119
+ clear() {
120
+ this.session.clear();
121
+ this.always.clear();
122
+ this.inflight.clear();
123
+ }
124
+ /**
125
+ * Resolve through cache + host hook with in-flight de-dup.
126
+ * Concurrent callers for the same key share one `ask()`.
127
+ */
128
+ resolve(options) {
129
+ const inflightKey = options.sessionId
130
+ ? sessionKey(options.channel, options.sessionId, options.key)
131
+ : options.agentId
132
+ ? alwaysKey(options.agentId, options.channel, options.key)
133
+ : channelKey(options.channel, options.key);
134
+ const existing = this.inflight.get(inflightKey);
135
+ if (existing)
136
+ return existing;
137
+ const pending = this.resolveUncached(options).finally(() => {
138
+ this.inflight.delete(inflightKey);
139
+ });
140
+ this.inflight.set(inflightKey, pending);
141
+ return pending;
142
+ }
143
+ async resolveUncached(options) {
144
+ const cached = this.get(options.channel, options.key, {
145
+ sessionId: options.sessionId,
146
+ agentId: options.agentId,
147
+ });
148
+ if (cached === 'approve')
149
+ return true;
150
+ let decision;
151
+ try {
152
+ decision = await options.ask();
153
+ }
154
+ catch {
155
+ // 审批通道异常按拒绝处理(fail-safe);此处吞掉仅因「异常不改变不放行」结论
156
+ return false;
157
+ }
158
+ if (decision === 'approve' ||
159
+ decision === 'approve_session' ||
160
+ decision === 'approve_always') {
161
+ this.remember(decision, options.channel, options.key, {
162
+ sessionId: options.sessionId,
163
+ agentId: options.agentId,
164
+ });
165
+ return true;
166
+ }
167
+ return false;
168
+ }
169
+ }
170
+ /** Process-wide default cache (keys include sessionId / agentId). */
171
+ export const defaultHitlCache = new HitlDecisionCache();
172
+ /**
173
+ * Resolve a HITL confirm through cache + host hook (SEC-7).
174
+ *
175
+ * Fail-closed: missing hook, thrown error, or non-approve decision → false.
176
+ * Concurrent same-key callers share one host prompt (in-flight de-dup).
177
+ *
178
+ * @param options - cache, channel, key, sessionId, agentId, and the host ask callback
179
+ * @returns true only when the call is approved (cached or live)
180
+ */
181
+ export async function resolveHitlDecision(options) {
182
+ const cache = options.cache ?? defaultHitlCache;
183
+ return cache.resolve(options);
184
+ }
@@ -1,9 +1,9 @@
1
1
  /**
2
2
  * Human-in-the-Loop 领域 — 人机交互
3
3
  *
4
- * 职责:审批请求管理、审批策略、用户决策缓存。
5
- * 契约见 ./types.ts。
4
+ * 职责:确认决策缓存(session / always)+ 统一 resolve(SEC-7 单模型)。
5
+ * 强制面在 `confirmHighRisk` / `confirmEffect` 两条钩子,不在本目录另起生命周期。
6
6
  */
7
- export { ApprovalManager, createApprovalPolicy } from './approval-manager.js';
8
- export type { ApprovalManagerConfig } from './approval-manager.js';
9
- export type { ApprovalLevel, ApprovalRequest, ApprovalDecision, ApprovalProvider, ApprovalPolicy, } from './types.js';
7
+ export { HitlDecisionCache, defaultHitlCache, resolveHitlDecision, } from './decision-cache.js';
8
+ export type { HitlChannel, HitlCacheScope } from './decision-cache.js';
9
+ export type { HitlDecision } from './types.js';
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Human-in-the-Loop 领域 — 人机交互
3
3
  *
4
- * 职责:审批请求管理、审批策略、用户决策缓存。
5
- * 契约见 ./types.ts。
4
+ * 职责:确认决策缓存(session / always)+ 统一 resolve(SEC-7 单模型)。
5
+ * 强制面在 `confirmHighRisk` / `confirmEffect` 两条钩子,不在本目录另起生命周期。
6
6
  */
7
- export { ApprovalManager, createApprovalPolicy } from './approval-manager.js';
7
+ export { HitlDecisionCache, defaultHitlCache, resolveHitlDecision, } from './decision-cache.js';
@@ -1,66 +1,11 @@
1
1
  /**
2
- * Human-in-the-Loop 接口定义
2
+ * Human-in-the-Loop 接口定义(SEC-7 单模型)
3
3
  *
4
- * @layer harness/governance/human-in-the-loop — 审批契约。
5
- */
6
- import type { ToolCall } from '@octopi-agent/core/types/messages.js';
7
- /** 审批级别 */
8
- export type ApprovalLevel = 'auto' | 'confirm_high_risk' | 'confirm_all';
9
- /** 审批请求 */
10
- export interface ApprovalRequest {
11
- /** 请求 ID */
12
- id: string;
13
- /** 触发的工具调用 */
14
- toolCall: ToolCall;
15
- /** 风险评估结果 */
16
- riskLevel: 'low' | 'medium' | 'high' | 'critical' | 'unknown';
17
- /** 风险描述 */
18
- riskDescription: string;
19
- /** 操作描述(人类可读) */
20
- actionDescription: string;
21
- /** 创建时间 */
22
- createdAt: number;
23
- /** 超时时间(毫秒) */
24
- timeoutMs: number;
25
- }
26
- /** 审批决策 */
27
- export interface ApprovalDecision {
28
- /** 决策类型 */
29
- decision: 'approve' | 'deny' | 'approve_always' | 'approve_session';
30
- /** 决策理由 */
31
- reason?: string;
32
- /** 决策时间 */
33
- decidedAt: number;
34
- }
35
- /**
36
- * ApprovalProvider — 审批提供者接口
37
- *
38
- * 由 TUI/Gateway 实现,负责向用户展示审批请求并收集决策。
39
- * harness 层的 ApprovalManager 调用此接口。
40
- */
41
- export interface ApprovalProvider {
42
- /**
43
- * 请求用户审批
44
- *
45
- * @returns 审批决策(如果超时,返回 deny)
46
- */
47
- requestApproval(request: ApprovalRequest): Promise<ApprovalDecision>;
48
- /**
49
- * 检查是否支持交互式审批
50
- * (非交互环境如 CI/CD 中,返回 false)
51
- */
52
- isInteractive(): boolean;
53
- }
54
- /**
55
- * ApprovalPolicy — 审批策略接口
4
+ * @layer harness/governance/human-in-the-loop — 确认决策契约。
56
5
  *
57
- * 决定某个工具调用是否需要审批。
6
+ * 唯一强制面是 `confirmHighRisk` / `confirmEffect` 两条钩子(见 core);
7
+ * 决策统一为 `HitlDecision`,缓存见 `decision-cache.ts`。
8
+ * 不再保留独立 ApprovalManager / ApprovalProvider 生命周期。
58
9
  */
59
- export interface ApprovalPolicy {
60
- /**
61
- * 判断是否需要审批
62
- *
63
- * @returns true 表示需要审批,false 表示自动放行
64
- */
65
- requiresApproval(toolCall: ToolCall, riskLevel: string): boolean;
66
- }
10
+ export type { HitlDecision, } from '@octopi-agent/core/types/tools.js';
11
+ export type { HitlChannel, HitlCacheScope, } from './decision-cache.js';
@@ -1,6 +1,10 @@
1
1
  /**
2
- * Human-in-the-Loop 接口定义
2
+ * Human-in-the-Loop 接口定义(SEC-7 单模型)
3
3
  *
4
- * @layer harness/governance/human-in-the-loop — 审批契约。
4
+ * @layer harness/governance/human-in-the-loop — 确认决策契约。
5
+ *
6
+ * 唯一强制面是 `confirmHighRisk` / `confirmEffect` 两条钩子(见 core);
7
+ * 决策统一为 `HitlDecision`,缓存见 `decision-cache.ts`。
8
+ * 不再保留独立 ApprovalManager / ApprovalProvider 生命周期。
5
9
  */
6
10
  export {};
@@ -43,8 +43,16 @@ export declare class CapabilityEnforcer {
43
43
  checkToolAccess(pluginId: string, toolName: string): AccessDecision;
44
44
  /**
45
45
  * 检查 Plugin 是否有权访问路径
46
+ *
47
+ * @param pluginId Plugin 标识(须先 registerPlugin)
48
+ * @param path 待访问路径;`workspace` 语义下相对路径锚定 `opts.workspaceRoot`(不锚进程 cwd),`sandbox` 语义下要求绝对路径
49
+ * @param opts workspaceRoot:`filesystem: 'workspace'` 的包含判定根;缺省 fail-closed
50
+ * @returns 放行或拒绝(含原因)
51
+ * @remarks 字符串级判定:不做 realpath,符号链接逃逸 / TOCTOU 不在本检查覆盖范围
46
52
  */
47
- checkPathAccess(pluginId: string, path: string): AccessDecision;
53
+ checkPathAccess(pluginId: string, path: string, opts?: {
54
+ workspaceRoot?: string;
55
+ }): AccessDecision;
48
56
  /**
49
57
  * 检查 Plugin 是否有权访问网络
50
58
  */
@@ -5,7 +5,9 @@
5
5
  *
6
6
  * 通过 Agent 的 beforeToolCall 回调槽注入。
7
7
  */
8
+ import { resolve } from 'node:path';
8
9
  import { AgentEvents } from '../../shared/events/agent-event-map.js';
10
+ import { isAbsolutePath, isTempPath, startsWithPathPrefix } from './temp-path.js';
9
11
  // ── 信任级别 ──
10
12
  export var PluginTrustLevel;
11
13
  (function (PluginTrustLevel) {
@@ -76,8 +78,14 @@ export class CapabilityEnforcer {
76
78
  }
77
79
  /**
78
80
  * 检查 Plugin 是否有权访问路径
81
+ *
82
+ * @param pluginId Plugin 标识(须先 registerPlugin)
83
+ * @param path 待访问路径;`workspace` 语义下相对路径锚定 `opts.workspaceRoot`(不锚进程 cwd),`sandbox` 语义下要求绝对路径
84
+ * @param opts workspaceRoot:`filesystem: 'workspace'` 的包含判定根;缺省 fail-closed
85
+ * @returns 放行或拒绝(含原因)
86
+ * @remarks 字符串级判定:不做 realpath,符号链接逃逸 / TOCTOU 不在本检查覆盖范围
79
87
  */
80
- checkPathAccess(pluginId, path) {
88
+ checkPathAccess(pluginId, path, opts) {
81
89
  const entry = this.pluginCapabilities.get(pluginId);
82
90
  if (!entry)
83
91
  return { allowed: false, reason: `Plugin "${pluginId}" not registered` };
@@ -85,18 +93,33 @@ export class CapabilityEnforcer {
85
93
  switch (capabilities.filesystem) {
86
94
  case '*':
87
95
  return { allowed: true };
88
- case 'workspace':
89
- // 简单检查:路径不包含 ..
90
- if (path.includes('..')) {
91
- return { allowed: false, reason: 'Path traversal not allowed' };
96
+ case 'workspace': {
97
+ // 真实包含判定需要 workspace 根;根未知时 fail-closed(不装懂放行)
98
+ const root = opts?.workspaceRoot;
99
+ if (!root) {
100
+ return { allowed: false, reason: `Cannot verify "${path}": workspace root unknown` };
101
+ }
102
+ // 相对路径锚定 workspace root;resolve 折叠 `..`,防 `ws/../etc/passwd` 穿越
103
+ const resolvedRoot = resolve(root);
104
+ const resolvedPath = resolve(root, path);
105
+ // 段边界前缀匹配;Windows 风格路径大小写不敏感、分隔符归一(同 temp-path 匹配语义)
106
+ if (!startsWithPathPrefix(resolvedPath, resolvedRoot)) {
107
+ return { allowed: false, reason: `Path "${path}" outside workspace` };
92
108
  }
93
109
  return { allowed: true };
94
- case 'sandbox':
95
- // 只允许访问临时目录
96
- if (!path.startsWith('/tmp/') && !path.startsWith('/tmp/')) {
110
+ }
111
+ case 'sandbox': {
112
+ // 只允许临时目录(isTempPath 单一来源);相对路径无从锚定,fail-closed
113
+ if (!isAbsolutePath(path)) {
114
+ return { allowed: false, reason: `Path "${path}" must be absolute for sandbox access` };
115
+ }
116
+ // resolve 折叠 `..`,防 `/tmp/../etc/passwd` 穿越
117
+ const resolved = resolve(path);
118
+ if (!isTempPath(resolved)) {
97
119
  return { allowed: false, reason: `Path "${path}" outside sandbox` };
98
120
  }
99
121
  return { allowed: true };
122
+ }
100
123
  case 'none':
101
124
  return { allowed: false, reason: `Plugin "${pluginId}" has no filesystem access` };
102
125
  default:
@@ -6,6 +6,7 @@
6
6
  * 可测试、可审计、不可被 LLM 操控。
7
7
  */
8
8
  import { parseShellCommand, getRedirectTargets } from './shell-parser.js';
9
+ import { isAbsolutePath, isTempPath } from './temp-path.js';
9
10
  // ── 降级策略匹配 ──
10
11
  /**
11
12
  * 尝试为高风险命令生成安全替代方案
@@ -104,11 +105,8 @@ function checkSafeDelete(parsed) {
104
105
  if (targets.length === 0)
105
106
  continue;
106
107
  // 只对非 safe 路径建议 trash
107
- // 临时目录(/tmp/)已经是 safe,不需要降级
108
- const nonSafeTargets = targets.filter(t => {
109
- const normalized = t.replace(/^~\//, process.env.HOME + '/');
110
- return !normalized.startsWith('/tmp/') && !normalized.startsWith('/var/tmp/');
111
- });
108
+ // 临时目录已是 safe(isTempPath 单一来源:/tmp、/var/tmp 及别名、TMPDIR、Windows Temp),不需要降级
109
+ const nonSafeTargets = targets.filter((t) => !isTempPath(t));
112
110
  if (nonSafeTargets.length === 0)
113
111
  continue;
114
112
  return {
@@ -193,8 +191,8 @@ function checkSafeRedirect(parsed) {
193
191
  const targets = getRedirectTargets(parsed);
194
192
  for (const target of targets) {
195
193
  // 检查是否覆盖已有文件(这里无法确定文件是否存在,只对常见路径提供建议)
196
- if ((target.startsWith('/') && !target.startsWith('/tmp/')) ||
197
- /^[A-Za-z]:[\\/]/.test(target) && !/^[A-Za-z]:[\\/]Windows[\\/]Temp[\\/]/i.test(target)) {
194
+ // 绝对路径且非临时目录 → 建议备份(isTempPath 单一来源;判定面随清单统一而扩充,见 CHANGELOG v0.86.7)
195
+ if (isAbsolutePath(target) && !isTempPath(target)) {
198
196
  return {
199
197
  description: `重定向到 ${target},建议先备份`,
200
198
  steps: [
@@ -12,7 +12,7 @@
12
12
  */
13
13
  import type { ToolCall } from '@octopi-agent/core/types.js';
14
14
  import type { RiskDecision } from './risk-types.js';
15
- /** 仅测试用:环境变量变更后清空路径缓存 */
15
+ /** 仅测试用:环境变量变更后清空路径缓存(protected + temp 两侧) */
16
16
  export declare function resetSecurityPathCache(): void;
17
17
  /** 提权命令 — 通过 seg.isSudo 判断,此 Set 保留备用 */
18
18
  /**
@@ -13,19 +13,13 @@
13
13
  import { homedir } from 'node:os';
14
14
  import { resolve } from 'node:path';
15
15
  import { parseShellCommand, getRedirectTargets } from './shell-parser.js';
16
+ import { ensureTrailingSep, isAbsolutePath, isTempPath, resetTempPathCache, startsWithPathPrefix, } from './temp-path.js';
16
17
  // ── 路径分类 ──
17
18
  let cachedProtectedPaths = null;
18
- let cachedTempPrefixes = null;
19
- /** 仅测试用:环境变量变更后清空路径缓存 */
19
+ /** 仅测试用:环境变量变更后清空路径缓存(protected + temp 两侧) */
20
20
  export function resetSecurityPathCache() {
21
21
  cachedProtectedPaths = null;
22
- cachedTempPrefixes = null;
23
- }
24
- function ensureTrailingSep(p) {
25
- let n = p.replace(/\//g, '\\');
26
- if (!n.endsWith('\\'))
27
- n += '\\';
28
- return n;
22
+ resetTempPathCache();
29
23
  }
30
24
  /** 硬保护路径(不可逆损坏)—— 含动态 SystemRoot */
31
25
  function getProtectedPaths() {
@@ -57,82 +51,10 @@ const SAFE_PSEUDO_DEVICES = new Set([
57
51
  '/dev/null', '/dev/zero', '/dev/random', '/dev/urandom',
58
52
  '/dev/stdin', '/dev/stdout', '/dev/stderr', '/dev/tty',
59
53
  ]);
60
- /**
61
- * 临时目录前缀
62
- *
63
- * 必须在 PROTECTED 之前匹配:`C:\Windows\Temp` 虽在 `C:\Windows\` 下,
64
- * 但是可清空的临时区,应归 safe 而非 protected。
65
- */
66
- function getTempPrefixes() {
67
- if (cachedTempPrefixes)
68
- return cachedTempPrefixes;
69
- const prefixes = ['/tmp/', '/var/tmp/', '/private/var/tmp/'];
70
- const userTemp = process.env.TEMP ?? process.env.TMP ?? process.env.Tmp;
71
- if (userTemp) {
72
- prefixes.push(ensureTrailingSep(userTemp));
73
- }
74
- prefixes.push('C:\\Windows\\Temp\\');
75
- const systemRoot = process.env.SystemRoot ?? process.env.windir;
76
- if (systemRoot) {
77
- prefixes.push(ensureTrailingSep(systemRoot) + 'Temp\\');
78
- }
79
- // 用户 AppData Temp 回退(无 TEMP 环境变量时的静态路径)
80
- const userProfile = process.env.USERPROFILE ?? process.env.HOME;
81
- const home = userProfile ? userProfile.replace(/\//g, '\\') : homedir().replace(/\//g, '\\');
82
- if (home) {
83
- const base = home.endsWith('\\') ? home : home + '\\';
84
- prefixes.push(base + 'AppData\\Local\\Temp\\');
85
- prefixes.push(base + 'AppData\\Local\\Microsoft\\Windows\\Temp\\');
86
- }
87
- cachedTempPrefixes = prefixes;
88
- return prefixes;
89
- }
90
- /** Windows 风格路径:盘符或 UNC */
91
- function isWindowsStylePath(p) {
92
- return /^[A-Za-z]:[\\/]/.test(p) || /^[A-Za-z]:$/.test(p) || p.includes('\\') || p.startsWith('\\\\');
93
- }
94
54
  /** 盘符根:`C:` / `C:\` / `D:/` */
95
55
  function isDriveRoot(p) {
96
56
  return /^[A-Za-z]:[\\/]?$/i.test(p);
97
57
  }
98
- /** 绝对路径(POSIX + Windows 盘符/UNC),跨平台评估时用 */
99
- function isAbsolutePath(p) {
100
- return (p.startsWith('/') ||
101
- /^[A-Za-z]:[\\/]/.test(p) ||
102
- /^[A-Za-z]:$/.test(p) ||
103
- p.startsWith('\\\\'));
104
- }
105
- /** 去掉末尾分隔符(保留根 `/` 或 `C:\`) */
106
- function stripTrailingSep(p) {
107
- if (p.length > 1 && (p.endsWith('/') || p.endsWith('\\'))) {
108
- // `C:\` 保留
109
- if (/^[A-Za-z]:[\\/]$/.test(p))
110
- return p;
111
- return p.slice(0, -1);
112
- }
113
- return p;
114
- }
115
- /**
116
- * 路径前缀匹配(路径段边界,拒绝 project 前缀绕过 project-evil)
117
- *
118
- * 要求 path === base 或 path 以 base + 分隔符 开头。
119
- * Windows 风格路径大小写不敏感、分隔符归一为 `\`。
120
- */
121
- function startsWithPathPrefix(path, prefix) {
122
- const isWin = isWindowsStylePath(path) || isWindowsStylePath(prefix);
123
- if (isWin) {
124
- const p = stripTrailingSep(path.replace(/\//g, '\\')).toLowerCase();
125
- const b = stripTrailingSep(prefix.replace(/\//g, '\\')).toLowerCase();
126
- if (p === b)
127
- return true;
128
- return p.startsWith(b + '\\');
129
- }
130
- const p = stripTrailingSep(path);
131
- const b = stripTrailingSep(prefix);
132
- if (p === b)
133
- return true;
134
- return p.startsWith(b + '/');
135
- }
136
58
  /**
137
59
  * 路径段包含匹配:同时识别 `/` 与 `\`,要求段边界
138
60
  *
@@ -186,7 +108,7 @@ function classifyPath(path, cwd) {
186
108
  }
187
109
  // 临时目录 —— 必须在 PROTECTED 之前:
188
110
  // C:\Windows\Temp 落在 C:\Windows\ 前缀内,若先判 protected 则 TEMP 白名单成死代码
189
- if (getTempPrefixes().some(p => startsWithPathPrefix(normalized, p))) {
111
+ if (isTempPath(normalized)) {
190
112
  return 'safe';
191
113
  }
192
114
  // 系统保护路径
@@ -0,0 +1,41 @@
1
+ /**
2
+ * temp-path — 临时目录路径分类(单一来源)
3
+ *
4
+ * @layer harness/governance/security
5
+ *
6
+ * 三处消费方(risk-evaluator / degradation / capability-enforcer)共用同一份
7
+ * 临时目录清单与前缀匹配,防止各处手抄前缀清单再次漂移。
8
+ *
9
+ * 分类语义(纯字符串分类,不做 fs 探测):
10
+ * - POSIX 共享临时 `/tmp`、`/var/tmp` 及其 macOS 规范(realpath)双形态
11
+ * `/private/tmp`、`/private/var/tmp`——兼容性不押在 env 透传上(C4 拍板)
12
+ * - `os.tmpdir()` 实际值(反映 TMPDIR/TEMP/TMP 生效值,macOS 为 `/var/folders/…`)
13
+ * - 显式 `TMPDIR`/`TEMP`/`TMP`/`Tmp` 兜底
14
+ * - Windows 静态临时区(`C:\Windows\Temp`、SystemRoot Temp、用户 AppData Temp)
15
+ */
16
+ /** 仅测试用:环境变量变更后清空临时目录缓存 */
17
+ export declare function resetTempPathCache(): void;
18
+ /** Windows 风格路径:盘符或 UNC */
19
+ export declare function isWindowsStylePath(p: string): boolean;
20
+ /** 去掉末尾分隔符(保留根 `/` 或 `C:\`) */
21
+ export declare function stripTrailingSep(p: string): string;
22
+ /** 绝对路径(POSIX + Windows 盘符/UNC),跨平台评估时用 */
23
+ export declare function isAbsolutePath(p: string): boolean;
24
+ /** 补尾部分隔符(按路径自身风格选 `/` 或 `\`) */
25
+ export declare function ensureTrailingSep(p: string): string;
26
+ /**
27
+ * 路径前缀匹配(路径段边界,拒绝 project 前缀绕过 project-evil)
28
+ *
29
+ * 要求 path === base 或 path 以 base + 分隔符 开头。
30
+ * Windows 风格路径大小写不敏感、分隔符归一为 `\`。
31
+ */
32
+ export declare function startsWithPathPrefix(path: string, prefix: string): boolean;
33
+ /**
34
+ * 临时目录前缀清单
35
+ *
36
+ * 必须在 PROTECTED 之前匹配:`C:\Windows\Temp` 虽在 `C:\Windows\` 下,
37
+ * 但是可清空的临时区,应归 safe 而非 protected。
38
+ */
39
+ export declare function getTempPrefixes(): string[];
40
+ /** 临时目录判定(路径段边界,防 `/tmpdir` 假命中) */
41
+ export declare function isTempPath(path: string): boolean;