@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,111 @@
1
+ /** How an entry is rendered/grouped in UI surfaces. */
2
+ export type GitStatusGroup = 'conflicted' | 'staged' | 'unstaged' | 'untracked';
3
+ /** Record kind behind an entry. */
4
+ export type GitStatusKind = 'changed' | 'renamed' | 'copied' | 'untracked' | 'conflicted';
5
+ /**
6
+ * One display row. A partially-staged file (`1 MM …`) yields TWO rows — one in
7
+ * `staged`, one in `unstaged` — matching `git status` section semantics; its
8
+ * x/y pair is repeated on each row so the UI can show the real codes.
9
+ */
10
+ export interface GitStatusEntry {
11
+ kind: GitStatusKind;
12
+ group: GitStatusGroup;
13
+ /** Staged status char ('.' = unchanged in the index). */
14
+ x: string;
15
+ /** Unstaged status char ('.' = unchanged in the worktree). */
16
+ y: string;
17
+ path: string;
18
+ /** Rename/copy source path (record type 2 only). */
19
+ origPath?: string;
20
+ }
21
+ /** Branch header block from `# branch.*` records. */
22
+ export interface GitStatusBranch {
23
+ /** HEAD oid; null before the first commit (`(initial)`). */
24
+ oid: string | null;
25
+ /** Branch name; null when detached (`(detached)`). */
26
+ head: string | null;
27
+ detached: boolean;
28
+ /** True when the repo has no commits yet. */
29
+ initial: boolean;
30
+ /** Upstream ref name; null when no upstream is configured. */
31
+ upstream: string | null;
32
+ /** Commits ahead of upstream; null without upstream. */
33
+ ahead: number | null;
34
+ /** Commits behind upstream; null without upstream. */
35
+ behind: number | null;
36
+ }
37
+ /** Full-precision counts (computed over all rows, not just returned entries). */
38
+ export interface GitStatusCounts {
39
+ conflicted: number;
40
+ staged: number;
41
+ unstaged: number;
42
+ untracked: number;
43
+ }
44
+ /** Parsed body of a status snapshot (no repo resolution). */
45
+ export interface GitStatusSnapshotBody {
46
+ /** null when the stream carried no `# branch.*` headers at all. */
47
+ branch: GitStatusBranch | null;
48
+ counts: GitStatusCounts;
49
+ entries: GitStatusEntry[];
50
+ /** True when entries were capped by maxEntries; counts stay full. */
51
+ truncated: boolean;
52
+ /** Records that matched a known type but failed to parse (format drift). */
53
+ skippedRecords: number;
54
+ }
55
+ /** Full snapshot for one directory. */
56
+ export interface GitStatusSnapshot extends GitStatusSnapshotBody {
57
+ /** False when the directory is not inside any git work tree. */
58
+ isRepo: boolean;
59
+ /** Work-tree top level (`git rev-parse --show-toplevel`); null when not a repo. */
60
+ repoRoot: string | null;
61
+ /** ISO timestamp taken after the status read completed. */
62
+ generatedAt: string;
63
+ }
64
+ export interface GitStatusSnapshotOptions {
65
+ /** Max entries returned (counts stay full). Default 500. */
66
+ maxEntries?: number;
67
+ /**
68
+ * Untracked granularity. 'normal' (default) collapses untracked directories,
69
+ * 'all' lists every untracked file (parity with the git_status tool).
70
+ */
71
+ untracked?: 'normal' | 'all';
72
+ /**
73
+ * Hard-jail demand (untrusted parity with the git_* tools): a jail backend is
74
+ * always used when available — this flag turns jail-setup failure into a hard
75
+ * error instead of the supervised fallback (fail-open → fail-closed). Derive
76
+ * it via effect-policy's `requiresJail(resolvedPolicy)`.
77
+ */
78
+ requireJail?: boolean;
79
+ /**
80
+ * Roots visible inside the process jail (`context.pathRoots`). A jailed read
81
+ * only sees `cwd` without them — on bwrap (namespace binds listed roots only)
82
+ * a repo whose `.git` sits above `cwd` would silently look like isRepo:false.
83
+ * Pass the caller's allow-root set (the fence set).
84
+ */
85
+ jailRoots?: string[];
86
+ }
87
+ /**
88
+ * Parse `git status --porcelain=v2 -z [--branch]` output.
89
+ *
90
+ * Record grammar (NUL-separated): `# key value` headers; `1 XY sub mH mI mW hH
91
+ * hI path`; `2 XY sub mH mI mW hH hI Xscore path` + separate origPath field;
92
+ * `u XY sub m1 m2 m3 mW h1 h2 h3 path`; `? path`; `! path` (skipped — we never
93
+ * pass --ignored). Paths are raw bytes decoded as UTF-8; no quoting in -z mode.
94
+ *
95
+ * @param raw - NUL-separated porcelain v2 stream
96
+ * @param options - maxEntries / untracked granularity (untracked only affects readers)
97
+ * @returns branch block (null without headers), full counts, capped entries,
98
+ * skippedRecords for known-type records that failed to parse
99
+ */
100
+ export declare function parsePorcelainV2(raw: string, options?: GitStatusSnapshotOptions): GitStatusSnapshotBody;
101
+ /**
102
+ * Read a structured git status snapshot for `cwd`.
103
+ *
104
+ * @param cwd - repository (or subdirectory) path; caller has contained it
105
+ * @param options - maxEntries / untracked granularity
106
+ * @returns isRepo=false when cwd is not inside a git work tree (a state, not an
107
+ * error); throws `git_status_failed: …` on real git failures, on
108
+ * output-cap kills (never partial-as-success), and `git_not_found: …`
109
+ * when git is not on PATH
110
+ */
111
+ export declare function readGitStatusSnapshot(cwd: string, options?: GitStatusSnapshotOptions): Promise<GitStatusSnapshot>;
@@ -0,0 +1,197 @@
1
+ import { runGit } from './git-runner.js';
2
+ const DEFAULT_MAX_ENTRIES = 500;
3
+ const EMPTY_COUNTS = () => ({
4
+ conflicted: 0,
5
+ staged: 0,
6
+ unstaged: 0,
7
+ untracked: 0,
8
+ });
9
+ /** Group render order: conflicts first, then staged, unstaged, untracked. */
10
+ const GROUP_RANK = {
11
+ conflicted: 0,
12
+ staged: 1,
13
+ unstaged: 2,
14
+ untracked: 3,
15
+ };
16
+ /**
17
+ * Parse `git status --porcelain=v2 -z [--branch]` output.
18
+ *
19
+ * Record grammar (NUL-separated): `# key value` headers; `1 XY sub mH mI mW hH
20
+ * hI path`; `2 XY sub mH mI mW hH hI Xscore path` + separate origPath field;
21
+ * `u XY sub m1 m2 m3 mW h1 h2 h3 path`; `? path`; `! path` (skipped — we never
22
+ * pass --ignored). Paths are raw bytes decoded as UTF-8; no quoting in -z mode.
23
+ *
24
+ * @param raw - NUL-separated porcelain v2 stream
25
+ * @param options - maxEntries / untracked granularity (untracked only affects readers)
26
+ * @returns branch block (null without headers), full counts, capped entries,
27
+ * skippedRecords for known-type records that failed to parse
28
+ */
29
+ export function parsePorcelainV2(raw, options) {
30
+ const maxEntries = Math.max(1, options?.maxEntries ?? DEFAULT_MAX_ENTRIES);
31
+ const branch = {
32
+ oid: null,
33
+ head: null,
34
+ detached: false,
35
+ initial: false,
36
+ upstream: null,
37
+ ahead: null,
38
+ behind: null,
39
+ };
40
+ let sawBranchHeader = false;
41
+ let skippedRecords = 0;
42
+ const rows = [];
43
+ const counts = EMPTY_COUNTS();
44
+ const pushRow = (entry, idx) => {
45
+ counts[entry.group] += 1;
46
+ rows.push({ entry, idx });
47
+ };
48
+ const tokens = raw.split('\0');
49
+ for (let i = 0; i < tokens.length; i += 1) {
50
+ const tok = tokens[i];
51
+ if (!tok)
52
+ continue;
53
+ if (tok.startsWith('# ')) {
54
+ sawBranchHeader = true;
55
+ const rest = tok.slice(2);
56
+ if (rest.startsWith('branch.oid ')) {
57
+ const v = rest.slice('branch.oid '.length);
58
+ branch.initial = v === '(initial)';
59
+ branch.oid = branch.initial ? null : v;
60
+ }
61
+ else if (rest.startsWith('branch.head ')) {
62
+ const v = rest.slice('branch.head '.length);
63
+ branch.detached = v === '(detached)';
64
+ branch.head = branch.detached ? null : v;
65
+ }
66
+ else if (rest.startsWith('branch.upstream ')) {
67
+ branch.upstream = rest.slice('branch.upstream '.length);
68
+ }
69
+ else if (rest.startsWith('branch.ab ')) {
70
+ const m = /^\+(-?\d+) -(-?\d+)$/.exec(rest.slice('branch.ab '.length));
71
+ if (m) {
72
+ branch.ahead = Number(m[1]);
73
+ branch.behind = Number(m[2]);
74
+ }
75
+ }
76
+ continue;
77
+ }
78
+ const kindCh = tok[0];
79
+ if (kindCh === '1') {
80
+ const m = /^1 (\S)(\S) (\S+) (\S+) (\S+) (\S+) (\S+) (\S+) ([\s\S]*)$/.exec(tok);
81
+ if (!m) {
82
+ skippedRecords += 1;
83
+ continue;
84
+ }
85
+ const base = { kind: 'changed', x: m[1], y: m[2], path: m[9] };
86
+ if (base.x !== '.')
87
+ pushRow({ ...base, group: 'staged' }, i);
88
+ if (base.y !== '.' || base.x === '.')
89
+ pushRow({ ...base, group: 'unstaged' }, i);
90
+ }
91
+ else if (kindCh === '2') {
92
+ const m = /^2 (\S)(\S) (\S+) (\S+) (\S+) (\S+) (\S+) (\S+) ([A-Z][0-9]*) ([\s\S]*)$/.exec(tok);
93
+ if (!m) {
94
+ skippedRecords += 1;
95
+ continue;
96
+ }
97
+ const origPath = tokens[i + 1] ?? '';
98
+ if (origPath)
99
+ i += 1;
100
+ const base = {
101
+ kind: (m[9].startsWith('R') ? 'renamed' : 'copied'),
102
+ x: m[1],
103
+ y: m[2],
104
+ path: m[10],
105
+ ...(origPath ? { origPath } : {}),
106
+ };
107
+ if (base.x !== '.')
108
+ pushRow({ ...base, group: 'staged' }, i);
109
+ if (base.y !== '.' || base.x === '.')
110
+ pushRow({ ...base, group: 'unstaged' }, i);
111
+ }
112
+ else if (kindCh === 'u') {
113
+ // u <XY> <sub> <m1> <m2> <m3> <mW> <h1> <h2> <h3> <path> — sub + 7 modes/hashes
114
+ const m = /^u (\S)(\S) (\S+) (\S+) (\S+) (\S+) (\S+) (\S+) (\S+) (\S+) ([\s\S]*)$/.exec(tok);
115
+ if (!m) {
116
+ skippedRecords += 1;
117
+ continue;
118
+ }
119
+ pushRow({ kind: 'conflicted', group: 'conflicted', x: m[1], y: m[2], path: m[11] }, i);
120
+ }
121
+ else if (kindCh === '?') {
122
+ pushRow({ kind: 'untracked', group: 'untracked', x: '?', y: '?', path: tok.slice(2) }, i);
123
+ }
124
+ else if (kindCh !== '!') {
125
+ // Unknown record type: count it so format drift never looks like "clean".
126
+ skippedRecords += 1;
127
+ }
128
+ // '!' (ignored) records are skipped by design: readers never pass --ignored.
129
+ }
130
+ // Stable group order (conflicted → staged → unstaged → untracked); git's own
131
+ // path order is preserved inside a group.
132
+ const sorted = rows
133
+ .sort((a, b) => GROUP_RANK[a.entry.group] - GROUP_RANK[b.entry.group] || a.idx - b.idx)
134
+ .map((s) => s.entry);
135
+ return {
136
+ branch: sawBranchHeader ? branch : null,
137
+ counts,
138
+ entries: sorted.slice(0, maxEntries),
139
+ truncated: sorted.length > maxEntries,
140
+ skippedRecords,
141
+ };
142
+ }
143
+ /**
144
+ * Read a structured git status snapshot for `cwd`.
145
+ *
146
+ * @param cwd - repository (or subdirectory) path; caller has contained it
147
+ * @param options - maxEntries / untracked granularity
148
+ * @returns isRepo=false when cwd is not inside a git work tree (a state, not an
149
+ * error); throws `git_status_failed: …` on real git failures, on
150
+ * output-cap kills (never partial-as-success), and `git_not_found: …`
151
+ * when git is not on PATH
152
+ */
153
+ export async function readGitStatusSnapshot(cwd, options) {
154
+ const untracked = options?.untracked ?? 'normal';
155
+ // 最小上下文:只带 jail 诉求与 jail 根(快照本就 context-free——journal=false、
156
+ // 网络默认 deny)。pathRoots 决定 jail 内可见根(allowRoots = [cwd, ...pathRoots])。
157
+ const context = options?.requireJail || options?.jailRoots?.length
158
+ ? {
159
+ ...(options?.requireJail ? { requireJail: true } : {}),
160
+ ...(options?.jailRoots?.length ? { pathRoots: options.jailRoots } : {}),
161
+ }
162
+ : undefined;
163
+ const top = await runGit(context, cwd, ['rev-parse', '--show-toplevel'], {
164
+ journal: false,
165
+ applyOutputGate: false,
166
+ timeoutMs: 15_000,
167
+ });
168
+ if (top.exitCode !== 0) {
169
+ if (/not a git repository/i.test(top.stderr)) {
170
+ return {
171
+ isRepo: false,
172
+ repoRoot: null,
173
+ branch: null,
174
+ counts: EMPTY_COUNTS(),
175
+ entries: [],
176
+ truncated: false,
177
+ skippedRecords: 0,
178
+ generatedAt: new Date().toISOString(),
179
+ };
180
+ }
181
+ throw new Error(`git_status_failed: ${top.stderr.trim().slice(0, 200) || `rev-parse exited ${top.exitCode}`}`);
182
+ }
183
+ const st = await runGit(context, cwd, ['status', '--porcelain=v2', '-z', '--branch', `--untracked-files=${untracked}`], { journal: false, applyOutputGate: false, timeoutMs: 30_000 });
184
+ // A killed/truncated stream would parse as a partial record set — surface it
185
+ // as a failure instead of a plausible-looking clean/partial status.
186
+ if (st.exitCode !== 0 || st.truncated || st.terminated) {
187
+ throw new Error(`git_status_failed: ${st.terminateReason ??
188
+ st.stderr.trim().slice(0, 200) ??
189
+ `status exited ${st.exitCode}`}`);
190
+ }
191
+ return {
192
+ isRepo: true,
193
+ repoRoot: top.stdout.trim(),
194
+ ...parsePorcelainV2(st.stdout, options),
195
+ generatedAt: new Date().toISOString(),
196
+ };
197
+ }
@@ -0,0 +1,27 @@
1
+ /**
2
+ * git_* dedicated tools — local VCS porcelain without a shell.
3
+ *
4
+ * Spawn `git` with a fixed argv allowlist (never a command string). Isolation:
5
+ * nonexistent `core.hooksPath`, `--no-verify`/`--no-gpg-sign` on commit,
6
+ * `--no-ext-diff`, command-line `-c` overrides (diff.external/gpg/pager/ssh),
7
+ * `GIT_CONFIG_GLOBAL/SYSTEM` at NUL//dev/null, and filter.* pinned to `cat`.
8
+ * User `-c`/alias flags are rejected. Capability tag is `vcs` (allowed on reduced surface) so
9
+ * workspace/untrusted agents can still status/diff/commit without `shell`.
10
+ */
11
+ import type { RegisteredTool } from '@octopi-agent/core/types.js';
12
+ /** git_status — porcelain working tree status */
13
+ export declare function createGitStatusTool(): RegisteredTool;
14
+ /** git_diff — unstaged / staged / vs-ref diff */
15
+ export declare function createGitDiffTool(): RegisteredTool;
16
+ /** git_log — commit history */
17
+ export declare function createGitLogTool(): RegisteredTool;
18
+ /** git_show — show a commit / tree / blob */
19
+ export declare function createGitShowTool(): RegisteredTool;
20
+ /** git_commit — add paths + commit (hooks disabled) */
21
+ export declare function createGitCommitTool(): RegisteredTool;
22
+ /** git_branch — list / create / switch / delete */
23
+ export declare function createGitBranchTool(): RegisteredTool;
24
+ /** git_restore — restore working tree / index paths */
25
+ export declare function createGitRestoreTool(): RegisteredTool;
26
+ /** All git_* tools (read + write). */
27
+ export declare function createGitTools(): RegisteredTool[];