@octopi-agent/engine 0.97.15 → 0.102.10

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 (369) hide show
  1. package/dist/config-schema/agent.d.ts +37 -5
  2. package/dist/config-schema/agent.js +24 -4
  3. package/dist/config-schema/context.d.ts +6 -36
  4. package/dist/config-schema/context.js +4 -28
  5. package/dist/config-schema/engine.d.ts +61 -160
  6. package/dist/config-schema/engine.js +1 -5
  7. package/dist/config-schema/governance.d.ts +10 -1
  8. package/dist/config-schema/governance.js +38 -1
  9. package/dist/config-schema/models.d.ts +2 -8
  10. package/dist/config-schema/models.js +0 -2
  11. package/dist/config-schema/run.d.ts +2 -2
  12. package/dist/config-schema/run.js +2 -2
  13. package/dist/config-schema/shared.d.ts +0 -3
  14. package/dist/config-schema/shared.js +0 -2
  15. package/dist/config-schema/substrate.d.ts +14 -88
  16. package/dist/config-schema/substrate.js +22 -107
  17. package/dist/config.d.ts +45 -113
  18. package/dist/config.js +8 -2
  19. package/dist/harness/activation/dispatcher.js +7 -0
  20. package/dist/harness/activation/inbox.d.ts +3 -3
  21. package/dist/harness/activation/inbox.js +3 -3
  22. package/dist/harness/activation/runtime.js +13 -5
  23. package/dist/harness/activation/types.d.ts +2 -2
  24. package/dist/harness/agent/builder.d.ts +34 -2
  25. package/dist/harness/agent/builder.js +189 -58
  26. package/dist/harness/agent/config-bridge.js +9 -2
  27. package/dist/harness/agent/config-integrity.d.ts +66 -0
  28. package/dist/harness/agent/config-integrity.js +108 -2
  29. package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
  30. package/dist/harness/agent/wire-agent-builder.js +31 -7
  31. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  32. package/dist/harness/capabilities/document/factory.js +1 -0
  33. package/dist/harness/capabilities/document/port.js +6 -3
  34. package/dist/harness/capabilities/document/types.d.ts +5 -0
  35. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +2 -2
  36. package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
  37. package/dist/harness/collaboration/autonomous-subsystem/loader.js +4 -1
  38. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
  39. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +21 -4
  40. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  41. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  42. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  43. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  45. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.d.ts +40 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
  48. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
  50. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +12 -3
  52. package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
  53. package/dist/harness/collaboration/delegation/child-run.js +4 -4
  54. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  55. package/dist/harness/collaboration/delegation/index.js +1 -1
  56. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  57. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  58. package/dist/harness/collaboration/delegation/service.d.ts +2 -0
  59. package/dist/harness/collaboration/delegation/service.js +2 -1
  60. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  61. package/dist/harness/collaboration/delegation/store.js +2 -1
  62. package/dist/harness/collaboration/delegation/types.d.ts +23 -2
  63. package/dist/harness/collaboration/delegation/types.js +22 -0
  64. package/dist/harness/collaboration/delegation/wiring.js +11 -1
  65. package/dist/harness/context/budget-allocator.d.ts +26 -18
  66. package/dist/harness/context/budget-allocator.js +67 -32
  67. package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
  68. package/dist/harness/context/capabilities/compact/engine.js +169 -121
  69. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  70. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  71. package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
  72. package/dist/harness/context/capabilities/compact/index.js +4 -0
  73. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  74. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  75. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  76. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  77. package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
  78. package/dist/harness/context/capabilities/compact/types.js +11 -1
  79. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  80. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  81. package/dist/harness/context/capabilities/summary/port.js +0 -1
  82. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  83. package/dist/harness/context/capabilities/summary/resolver.js +4 -9
  84. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  85. package/dist/harness/context/capabilities/summary/types.d.ts +4 -7
  86. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  87. package/dist/harness/context/context-size-ledger.js +236 -0
  88. package/dist/harness/context/default-context-engine.d.ts +195 -119
  89. package/dist/harness/context/default-context-engine.js +1241 -743
  90. package/dist/harness/context/index.d.ts +2 -2
  91. package/dist/harness/context/index.js +1 -1
  92. package/dist/harness/context/layer-types.d.ts +15 -0
  93. package/dist/harness/context/layer-types.js +14 -1
  94. package/dist/harness/context/layers.d.ts +16 -19
  95. package/dist/harness/context/layers.js +42 -14
  96. package/dist/harness/context/message-selector.d.ts +10 -8
  97. package/dist/harness/context/message-selector.js +49 -27
  98. package/dist/harness/context/summarize.d.ts +3 -3
  99. package/dist/harness/context/summarize.js +11 -4
  100. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  101. package/dist/harness/context/system-prompt-assembler.js +3 -1
  102. package/dist/harness/context/token-constants.d.ts +8 -6
  103. package/dist/harness/context/token-constants.js +8 -7
  104. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  105. package/dist/harness/context/token-estimate-fns.js +85 -66
  106. package/dist/harness/context/token-estimator.d.ts +27 -12
  107. package/dist/harness/context/token-estimator.js +120 -66
  108. package/dist/harness/context/token-segments.d.ts +88 -0
  109. package/dist/harness/context/token-segments.js +103 -0
  110. package/dist/harness/context/tool-result-aging.d.ts +6 -1
  111. package/dist/harness/context/tool-result-aging.js +16 -5
  112. package/dist/harness/context/tool-result-body.js +2 -0
  113. package/dist/harness/context/transform/anchors.d.ts +66 -0
  114. package/dist/harness/context/transform/anchors.js +125 -0
  115. package/dist/harness/context/transform/fold.d.ts +56 -0
  116. package/dist/harness/context/transform/fold.js +135 -0
  117. package/dist/harness/context/transform/migrate.d.ts +41 -0
  118. package/dist/harness/context/transform/migrate.js +69 -0
  119. package/dist/harness/context/transform/types.d.ts +129 -0
  120. package/dist/harness/context/transform/types.js +19 -0
  121. package/dist/harness/context/turn-envelope.d.ts +6 -3
  122. package/dist/harness/context/types.d.ts +127 -117
  123. package/dist/harness/extension/execution-environment/effect-policy.d.ts +24 -2
  124. package/dist/harness/extension/execution-environment/effect-policy.js +30 -0
  125. package/dist/harness/extension/execution-environment/ops-audit.d.ts +7 -3
  126. package/dist/harness/extension/execution-environment/ops-audit.js +11 -12
  127. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  128. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  129. package/dist/harness/extension/execution-environment/undo-log.d.ts +6 -2
  130. package/dist/harness/extension/execution-environment/undo-log.js +31 -10
  131. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
  132. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  133. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  134. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  135. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  136. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  137. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  138. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  139. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  140. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  141. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  142. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  143. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  144. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  146. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  147. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  148. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  149. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  150. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  151. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  152. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  153. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  154. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  155. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  156. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  157. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
  159. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
  160. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
  161. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
  162. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  163. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  164. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  165. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  166. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  167. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  168. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
  169. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
  171. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
  172. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
  173. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
  174. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
  175. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  176. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  177. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  178. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  180. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +17 -24
  181. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
  182. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
  183. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
  186. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
  187. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
  188. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
  189. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
  190. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  192. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  193. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
  194. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  195. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  196. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  197. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  198. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  199. package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
  200. package/dist/harness/governance/security/default-risk-policy.js +1 -0
  201. package/dist/harness/governance/security/default-security-guard.js +9 -0
  202. package/dist/harness/governance/security/index.d.ts +1 -0
  203. package/dist/harness/governance/security/index.js +2 -0
  204. package/dist/harness/governance/security/risk-evaluator.js +13 -0
  205. package/dist/harness/governance/security/risk-types.d.ts +12 -0
  206. package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
  207. package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
  208. package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
  209. package/dist/harness/governance/security/shell-parser-shared.js +188 -0
  210. package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
  211. package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
  212. package/dist/harness/governance/security/shell-parser.d.ts +23 -10
  213. package/dist/harness/governance/security/shell-parser.js +37 -496
  214. package/dist/harness/governance/security/vendor/README.md +24 -0
  215. package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
  216. package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
  217. package/dist/harness/index.d.ts +12 -12
  218. package/dist/harness/index.js +7 -7
  219. package/dist/harness/knowledge/boot-config.d.ts +55 -0
  220. package/dist/harness/knowledge/boot-config.js +50 -0
  221. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  222. package/dist/harness/knowledge/client.d.ts +24 -2
  223. package/dist/harness/knowledge/client.js +19 -5
  224. package/dist/harness/knowledge/db.js +5 -0
  225. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  226. package/dist/harness/knowledge/describe-sample.js +58 -0
  227. package/dist/harness/knowledge/describe.d.ts +8 -0
  228. package/dist/harness/knowledge/describe.js +18 -2
  229. package/dist/harness/knowledge/engine-thread.js +6 -0
  230. package/dist/harness/knowledge/grounding.js +3 -1
  231. package/dist/harness/knowledge/http-app.js +35 -4
  232. package/dist/harness/knowledge/http-params.d.ts +18 -0
  233. package/dist/harness/knowledge/http-params.js +24 -0
  234. package/dist/harness/knowledge/index.d.ts +2 -0
  235. package/dist/harness/knowledge/index.js +1 -0
  236. package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
  237. package/dist/harness/knowledge/purge.js +5 -2
  238. package/dist/harness/knowledge/query-service.d.ts +13 -2
  239. package/dist/harness/knowledge/query-service.js +4 -2
  240. package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
  241. package/dist/harness/knowledge/query-worker-client.js +4 -2
  242. package/dist/harness/knowledge/query-worker.js +4 -2
  243. package/dist/harness/knowledge/read-http.js +5 -1
  244. package/dist/harness/knowledge/serve.d.ts +8 -7
  245. package/dist/harness/knowledge/serve.js +9 -0
  246. package/dist/harness/knowledge/source-store.js +26 -3
  247. package/dist/harness/knowledge/start-service-process.d.ts +15 -7
  248. package/dist/harness/knowledge/start-service-process.js +21 -9
  249. package/dist/harness/knowledge/types.d.ts +7 -0
  250. package/dist/harness/knowledge/writer-service.d.ts +37 -9
  251. package/dist/harness/knowledge/writer-service.js +120 -14
  252. package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
  253. package/dist/harness/knowledge/writer-worker-client.js +20 -2
  254. package/dist/harness/knowledge/writer-worker.js +9 -1
  255. package/dist/harness/memory/index.d.ts +6 -2
  256. package/dist/harness/memory/index.js +4 -1
  257. package/dist/harness/memory/memory-events.d.ts +25 -0
  258. package/dist/harness/memory/memory-events.js +38 -0
  259. package/dist/harness/memory/sqlite/agent-db.js +15 -0
  260. package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
  261. package/dist/harness/memory/sqlite/wisdom-store.js +86 -12
  262. package/dist/harness/memory/steward-policy.d.ts +3 -0
  263. package/dist/harness/memory/steward-policy.js +1 -1
  264. package/dist/harness/memory/types.d.ts +47 -7
  265. package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
  266. package/dist/harness/memory/wisdom-attribution.js +287 -0
  267. package/dist/harness/memory/wisdom-events.d.ts +37 -0
  268. package/dist/harness/memory/wisdom-events.js +61 -0
  269. package/dist/harness/memory/wisdom-formation.d.ts +31 -1
  270. package/dist/harness/memory/wisdom-formation.js +130 -33
  271. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  272. package/dist/harness/memory/wisdom-gates.js +59 -19
  273. package/dist/harness/memory/wisdom.d.ts +7 -2
  274. package/dist/harness/memory/wisdom.js +49 -2
  275. package/dist/harness/observability/observer/hub.js +25 -15
  276. package/dist/harness/observability/observer/types.d.ts +10 -6
  277. package/dist/harness/run/agent/agent.d.ts +40 -21
  278. package/dist/harness/run/agent/agent.js +66 -13
  279. package/dist/harness/run/agent/index.d.ts +1 -1
  280. package/dist/harness/run/budget/budget.d.ts +28 -10
  281. package/dist/harness/run/budget/budget.js +38 -15
  282. package/dist/harness/run/model/index.d.ts +3 -1
  283. package/dist/harness/run/model/index.js +2 -1
  284. package/dist/harness/run/model/resolver.d.ts +4 -1
  285. package/dist/harness/run/model/resolver.js +36 -2
  286. package/dist/harness/run/model/run-scope.d.ts +2 -0
  287. package/dist/harness/run/model/run-scope.js +7 -0
  288. package/dist/harness/run/model/types.d.ts +22 -5
  289. package/dist/harness/run/model/types.js +3 -2
  290. package/dist/harness/run/model/window-truth.d.ts +37 -0
  291. package/dist/harness/run/model/window-truth.js +39 -0
  292. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  293. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  294. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  295. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  296. package/dist/harness/run/reliability/run-agent.d.ts +10 -4
  297. package/dist/harness/run/reliability/run-agent.js +137 -53
  298. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  299. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  300. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  301. package/dist/harness/run/run-scope.d.ts +41 -4
  302. package/dist/harness/run/runner.d.ts +71 -31
  303. package/dist/harness/run/runner.js +368 -106
  304. package/dist/harness/session/attachments/index.d.ts +1 -0
  305. package/dist/harness/session/attachments/index.js +1 -0
  306. package/dist/harness/session/attachments/inject.d.ts +21 -10
  307. package/dist/harness/session/attachments/inject.js +76 -24
  308. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  309. package/dist/harness/session/attachments/recall-index.js +219 -0
  310. package/dist/harness/session/attachments/service.d.ts +21 -0
  311. package/dist/harness/session/attachments/service.js +258 -139
  312. package/dist/harness/session/attachments/types.d.ts +6 -0
  313. package/dist/harness/session/transform-store.d.ts +136 -0
  314. package/dist/harness/session/transform-store.js +302 -0
  315. package/dist/harness/session/types.d.ts +2 -2
  316. package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
  317. package/dist/harness/shared/events/agent-event-map.js +3 -2
  318. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  319. package/dist/harness/shared/paths/glob.d.ts +52 -0
  320. package/dist/harness/shared/paths/glob.js +218 -0
  321. package/dist/harness/shared/paths/index.d.ts +84 -0
  322. package/dist/harness/shared/paths/index.js +179 -0
  323. package/dist/harness/shared/types/agent-definition.d.ts +1 -2
  324. package/dist/index.d.ts +14 -17
  325. package/dist/index.js +7 -9
  326. package/dist/integration/observability/metrics.d.ts +6 -6
  327. package/dist/integration/observability/metrics.js +13 -13
  328. package/dist/integration/observability/observer-bridge.js +2 -2
  329. package/dist/integration/observability/trace-collector.d.ts +5 -5
  330. package/dist/integration/observability/trace-collector.js +34 -35
  331. package/dist/integration/observability/trace-events.d.ts +3 -3
  332. package/dist/integration/observability/trace-events.js +3 -3
  333. package/dist/integration/providers/anthropic.js +14 -1
  334. package/dist/integration/providers/openai.js +7 -1
  335. package/dist/integration/providers/usage.d.ts +1 -1
  336. package/dist/integration/providers/wire-dump.d.ts +1 -1
  337. package/dist/integration/storage/archive-manager.d.ts +6 -0
  338. package/dist/integration/storage/archive-manager.js +10 -0
  339. package/dist/integration/storage/jsonl.d.ts +1 -1
  340. package/dist/integration/storage/jsonl.js +18 -16
  341. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
  342. package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
  343. package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
  344. package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
  345. package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
  346. package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
  347. package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
  348. package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
  349. package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
  350. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  351. package/dist/subsystems/wisdom-steward/formation/config.yaml +13 -5
  352. package/dist/subsystems/wisdom-steward/formation/handler.js +39 -23
  353. package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
  354. package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
  355. package/package.json +16 -14
  356. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  357. package/dist/harness/context/hybrid-compressor.js +0 -159
  358. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  359. package/dist/harness/context/llm-summarizer.js +0 -249
  360. package/dist/harness/context/smart-router.d.ts +0 -75
  361. package/dist/harness/context/smart-router.js +0 -118
  362. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  363. package/dist/harness/context/truncate-compressor.js +0 -107
  364. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  365. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  366. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  367. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  368. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  369. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -0,0 +1,302 @@
1
+ /**
2
+ * Transform record store — durable ledger for compaction products.
3
+ *
4
+ * Layout (same base as turn-undo, sibling of `undo/` and `attachments/`):
5
+ *
6
+ * ```
7
+ * sessions/<sid>/transform/
8
+ * <agent-file>.jsonl # append-only entries: {kind:'record'|'revoke', ...}
9
+ * blobs/<sha256> # content-addressed replacement texts
10
+ * ```
11
+ *
12
+ * Durability contract: blobs are written (atomic tmp+rename, skip-if-exists)
13
+ * **before** their record line is appended — a line is never readable without
14
+ * its blob. Revocations are append-only lines; the ledger folds them at load.
15
+ * Appends are serialized per (sessionId, agentId) inside the store (review F5:
16
+ * seq assignment must not race), and load returns records sorted by seq.
17
+ *
18
+ * ⚠️ This must NOT live under `sessions/<sid>/undo/` — that directory is
19
+ * deleted wholesale on turn-undo commit/discard.
20
+ *
21
+ * @module harness/session/transform-store
22
+ */
23
+ import { createHash } from 'node:crypto';
24
+ import { appendFile, cp, mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
25
+ import { join } from 'node:path';
26
+ import { toSessionFileName } from '@octopi-agent/core/session-filename.js';
27
+ /**
28
+ * 解析会话 transform 目录
29
+ *
30
+ * @param sessionsDir - 通常 `OCTOPI_HOME/sessions`
31
+ * @param sessionId - 会话 id
32
+ * @returns 路径
33
+ */
34
+ export function resolveSessionTransformPaths(sessionsDir, sessionId) {
35
+ const root = join(sessionsDir, toSessionFileName(sessionId), 'transform');
36
+ return { root, blobsDir: join(root, 'blobs') };
37
+ }
38
+ /**
39
+ * 复制会话 transform 账本(session fork 用)。
40
+ *
41
+ * 源缺失/复制失败返回 false——调用方降级路径是旧快照迁移(拷贝的 legacy 快照在
42
+ * 目标端一次性转换),不是静默成功。
43
+ *
44
+ * @param sessionsDir - `OCTOPI_HOME/sessions`
45
+ * @param fromSessionId - 源会话
46
+ * @param toSessionId - 目标会话
47
+ * @returns 是否完整复制
48
+ */
49
+ export async function copySessionTransformDir(sessionsDir, fromSessionId, toSessionId) {
50
+ const from = resolveSessionTransformPaths(sessionsDir, fromSessionId).root;
51
+ const to = resolveSessionTransformPaths(sessionsDir, toSessionId).root;
52
+ const st = await stat(from).catch(() => undefined);
53
+ if (!st)
54
+ return false;
55
+ try {
56
+ await mkdir(to, { recursive: true });
57
+ await cp(from, to, { recursive: true, force: true });
58
+ return true;
59
+ }
60
+ catch {
61
+ return false;
62
+ }
63
+ }
64
+ /**
65
+ * 删除会话 transform 账本(会话删除清理;摘要正文含用户内容,不得遗留)。
66
+ *
67
+ * @param sessionsDir - `OCTOPI_HOME/sessions`
68
+ * @param sessionId - 会话 id
69
+ * @returns void
70
+ */
71
+ export async function removeSessionTransformDir(sessionsDir, sessionId) {
72
+ await rm(resolveSessionTransformPaths(sessionsDir, sessionId).root, {
73
+ recursive: true,
74
+ force: true,
75
+ });
76
+ }
77
+ /**
78
+ * 扫描 transform 孤儿目录(doctor 兜底)。
79
+ *
80
+ * 与 undo 不同:transform 账本**设计上常驻**(记录是持久事实),孤儿判据是
81
+ * 「会话 jsonl 已不存在而 transform/ 仍在」(删除清理之外的残留)。
82
+ *
83
+ * @param sessionsDir - `OCTOPI_HOME/sessions`
84
+ * @returns 孤儿列表
85
+ */
86
+ export async function scanOrphanSessionTransform(sessionsDir) {
87
+ const { readdir } = await import('node:fs/promises');
88
+ const names = await readdir(sessionsDir, { withFileTypes: true }).catch(() => []);
89
+ const out = [];
90
+ for (const ent of names) {
91
+ if (!ent.isDirectory())
92
+ continue;
93
+ const transformRoot = join(sessionsDir, ent.name, 'transform');
94
+ const st = await stat(transformRoot).catch(() => undefined);
95
+ if (!st)
96
+ continue;
97
+ const sessionFile = join(sessionsDir, `${ent.name}.jsonl`);
98
+ if (await stat(sessionFile).catch(() => undefined))
99
+ continue; // 会话仍在:正常账本
100
+ let ledgerFiles = 0;
101
+ let blobFiles = 0;
102
+ try {
103
+ const items = await readdir(transformRoot, { withFileTypes: true });
104
+ ledgerFiles = items.filter((i) => i.isFile() && i.name.endsWith('.jsonl')).length;
105
+ }
106
+ catch { /* 视为 0 */ }
107
+ try {
108
+ blobFiles = (await readdir(join(transformRoot, 'blobs'))).length;
109
+ }
110
+ catch { /* 视为 0 */ }
111
+ out.push({ sessionDirName: ent.name, transformRoot, ledgerFiles, blobFiles });
112
+ }
113
+ return out;
114
+ }
115
+ /** Per-agent ledger file name (record lines also carry agentId — load filters by it). */
116
+ function agentLedgerFile(root, agentId) {
117
+ return join(root, `${agentId === '' ? '_' : encodeURIComponent(agentId)}.jsonl`);
118
+ }
119
+ /** sha256 hex of replacement text */
120
+ function blobHash(text) {
121
+ return createHash('sha256').update(text, 'utf8').digest('hex');
122
+ }
123
+ /**
124
+ * JSONL file-backed transform store (durable).
125
+ */
126
+ export class JsonlTransformStore {
127
+ sessionsDir;
128
+ /** per (sessionId, agentId) append chain(F5:seq 分配互斥) */
129
+ appendChains = new Map();
130
+ /**
131
+ * @param options - sessionsDir (`OCTOPI_HOME/sessions`)
132
+ */
133
+ constructor(options) {
134
+ this.sessionsDir = options.sessionsDir;
135
+ }
136
+ /**
137
+ * Load the ledger for (sessionId, agentId), blobs hydrated into `text`,
138
+ * records sorted by seq(fold 的 later-seq-wins 依赖序)。
139
+ *
140
+ * @param sessionId - session id
141
+ * @param agentId - agent id
142
+ * @returns ledger (empty when none)
143
+ */
144
+ async load(sessionId, agentId) {
145
+ const { root, blobsDir } = resolveSessionTransformPaths(this.sessionsDir, sessionId);
146
+ const raw = await readFile(agentLedgerFile(root, agentId), 'utf8').catch(() => undefined);
147
+ if (raw === undefined)
148
+ return { records: [] };
149
+ const records = [];
150
+ const revokeTargets = new Set();
151
+ let hadEntries = false;
152
+ for (const line of raw.split('\n')) {
153
+ if (!line.trim())
154
+ continue;
155
+ hadEntries = true;
156
+ let entry;
157
+ try {
158
+ entry = JSON.parse(line);
159
+ }
160
+ catch {
161
+ // 损坏行跳过并保留其余账本:append-only 流的尾行可能被崩溃撕裂;
162
+ // 跳过是降级(少一段覆盖→原文可见),不是成功假象。完整校验在红线测试。
163
+ continue;
164
+ }
165
+ if (entry.kind === 'revoke') {
166
+ revokeTargets.add(entry.targetSeq);
167
+ continue;
168
+ }
169
+ if (entry.record.agentId !== agentId)
170
+ continue;
171
+ const record = { ...entry.record, revoked: false };
172
+ if (record.blobRef) {
173
+ const text = await readFile(join(blobsDir, record.blobRef.replace(/^sha256:/, '')), 'utf8').catch(() => undefined);
174
+ if (text === undefined) {
175
+ // blob 丢失(外部清扫):记录不生效(占位无文可渲染)——原文回可见是
176
+ // 降级方向(宁胖不丢),但不得静默(F7):如实告警。
177
+ console.warn(`[transform] session=${sessionId} agent=${agentId} record seq=${record.seq}: blob ${record.blobRef} missing; record dropped (raw text stays visible)`);
178
+ continue;
179
+ }
180
+ record.text = text;
181
+ }
182
+ records.push(record);
183
+ }
184
+ for (const record of records) {
185
+ if (revokeTargets.has(record.seq))
186
+ record.revoked = true;
187
+ }
188
+ // 文件序 → seq 序(跨进程交错写也可能倒置;fold 的 later-seq-wins 依赖它)
189
+ records.sort((a, b) => a.seq - b.seq);
190
+ return { records, hadEntries };
191
+ }
192
+ /**
193
+ * Durably append records and/or revocations (serialized per key — seq safe).
194
+ *
195
+ * @param sessionId - session id
196
+ * @param agentId - agent id
197
+ * @param records - new records (seq assigned here)
198
+ * @param revokeSeqs - seqs to revoke
199
+ * @returns appended records with seq assigned
200
+ */
201
+ async append(sessionId, agentId, records, revokeSeqs) {
202
+ const key = `${sessionId}\u0000${agentId}`;
203
+ const prev = this.appendChains.get(key) ?? Promise.resolve();
204
+ const task = prev.then(() => this.appendInternal(sessionId, agentId, records, revokeSeqs));
205
+ this.appendChains.set(key, task.catch(() => undefined));
206
+ return task;
207
+ }
208
+ async appendInternal(sessionId, agentId, records, revokeSeqs) {
209
+ const { root, blobsDir } = resolveSessionTransformPaths(this.sessionsDir, sessionId);
210
+ await mkdir(blobsDir, { recursive: true });
211
+ const existing = await this.load(sessionId, agentId);
212
+ let nextSeq = existing.records.reduce((n, r) => Math.max(n, r.seq), 0) + 1;
213
+ const at = Date.now();
214
+ const out = [];
215
+ const lines = [];
216
+ for (const rec of records) {
217
+ const seq = nextSeq++;
218
+ let blobRef;
219
+ if (rec.text !== undefined) {
220
+ const hash = blobHash(rec.text);
221
+ blobRef = `sha256:${hash}`;
222
+ await writeBlobIfAbsent(join(blobsDir, hash), rec.text);
223
+ }
224
+ const record = { ...rec, seq, blobRef, revoked: false };
225
+ out.push(record);
226
+ const { text: _text, revoked: _revoked, ...persisted } = record;
227
+ lines.push(JSON.stringify({ kind: 'record', record: persisted }));
228
+ }
229
+ for (const targetSeq of revokeSeqs ?? []) {
230
+ lines.push(JSON.stringify({ kind: 'revoke', seq: nextSeq++, targetSeq, at }));
231
+ }
232
+ if (lines.length > 0) {
233
+ await appendFile(agentLedgerFile(root, agentId), `${lines.join('\n')}\n`, 'utf8');
234
+ }
235
+ return out;
236
+ }
237
+ }
238
+ /** 内容寻址 blob:不存在才写(tmp+rename 原子替换,防半截文件) */
239
+ async function writeBlobIfAbsent(path, text) {
240
+ const st = await stat(path).catch(() => undefined);
241
+ if (st)
242
+ return;
243
+ const tmp = `${path}.${process.pid}.${Date.now()}.tmp`;
244
+ await writeFile(tmp, text, 'utf8');
245
+ await rename(tmp, path);
246
+ }
247
+ let warnedInMemoryDurability = false;
248
+ /**
249
+ * In-memory transform store (standalone engines / tests). Same append semantics,
250
+ * no durability — permanence holds across assemblies within the process only.
251
+ * First append logs a one-time durability warning (review F4: degradation must
252
+ * not be silent).
253
+ */
254
+ export class InMemoryTransformStore {
255
+ ledgers = new Map();
256
+ key(sessionId, agentId) {
257
+ return `${sessionId}\u0000${agentId}`;
258
+ }
259
+ /**
260
+ * Load the ledger for (sessionId, agentId).
261
+ *
262
+ * @param sessionId - session id
263
+ * @param agentId - agent id
264
+ * @returns ledger
265
+ */
266
+ async load(sessionId, agentId) {
267
+ const entry = this.ledgers.get(this.key(sessionId, agentId));
268
+ return { records: entry ? entry.records.map((r) => ({ ...r })) : [] };
269
+ }
270
+ /**
271
+ * Append records and/or revocations in memory.
272
+ *
273
+ * @param sessionId - session id
274
+ * @param agentId - agent id
275
+ * @param records - new records
276
+ * @param revokeSeqs - seqs to revoke
277
+ * @returns appended records
278
+ */
279
+ async append(sessionId, agentId, records, revokeSeqs) {
280
+ if (records.length > 0 && !warnedInMemoryDurability) {
281
+ warnedInMemoryDurability = true;
282
+ console.warn('[transform] in-memory transform store: compaction products are process-local and will not survive restarts (inject JsonlTransformStore for durability)');
283
+ }
284
+ const key = this.key(sessionId, agentId);
285
+ const entry = this.ledgers.get(key) ?? { records: [], seq: 0 };
286
+ const out = [];
287
+ for (const rec of records) {
288
+ entry.seq += 1;
289
+ const record = { ...rec, seq: entry.seq, blobRef: undefined, revoked: false };
290
+ entry.records.push(record);
291
+ out.push({ ...record });
292
+ }
293
+ for (const targetSeq of revokeSeqs ?? []) {
294
+ entry.seq += 1;
295
+ const target = entry.records.find((r) => r.seq === targetSeq);
296
+ if (target)
297
+ target.revoked = true;
298
+ }
299
+ this.ledgers.set(key, entry);
300
+ return out;
301
+ }
302
+ }
@@ -4,7 +4,7 @@
4
4
  * @layer harness — Session 的具体结构和生命周期管理类型。
5
5
  * Core 层的 SessionStore 接口是泛型的,不引用此文件。
6
6
  */
7
- import type { Message, Turn, SessionMeta } from '@octopi-agent/core/types.js';
7
+ import type { Message, Step, SessionMeta } from '@octopi-agent/core/types.js';
8
8
  import type { SessionTask } from './tasks/types.js';
9
9
  import type { ContextCompactSnapshot } from '../context/types.js';
10
10
  import type { SessionParticipant } from '../governance/session-acl/types.js';
@@ -90,7 +90,7 @@ export interface SessionData {
90
90
  spawnBy?: SessionSpawnLink;
91
91
  meta: SessionMeta;
92
92
  messages: Message[];
93
- turns: Turn[];
93
+ steps: Step[];
94
94
  metadata: Record<string, unknown>;
95
95
  lifecycle?: SessionLifecycleMeta;
96
96
  /**
@@ -32,11 +32,11 @@ export interface AgentEventMap {
32
32
  delayMs: number;
33
33
  error: string;
34
34
  };
35
- 'iteration.start': Record<string, never>;
35
+ 'step.start': Record<string, never>;
36
36
  'llm.usage': {
37
- usage: import('@octopi-agent/core/types/turn.js').TokenUsage;
37
+ usage: import('@octopi-agent/core/types/step.js').TokenUsage;
38
38
  };
39
- 'turn.end': {
39
+ 'step.end': {
40
40
  /** 本次调用的正文;error=true 时 = 中断前的部分流出(不是回答,不得当回复外发) */
41
41
  content?: string;
42
42
  userText?: string;
@@ -46,10 +46,15 @@ export interface AgentEventMap {
46
46
  stopped?: boolean;
47
47
  /** 本次 LLM 调用失败(只出现在重试中途;彻底失败走 agent_end reason='error') */
48
48
  error?: boolean;
49
- usage?: import('@octopi-agent/core/types/turn.js').TokenUsage;
49
+ usage?: import('@octopi-agent/core/types/step.js').TokenUsage;
50
50
  /** F3 LLM 计时摘要(loop turn_end 透传;Run 页签耗时区消费) */
51
51
  llmTiming?: import('@octopi-agent/core/loop/types.js').LoopLLMTiming;
52
- contextTokens?: number;
52
+ /** 上下文用量三量纲(P0-C 单源分账):provider 实测(usage/stale 写入);无实测不写不猜 */
53
+ promptTokensActual?: number;
54
+ /** 请求视图估算(校准后,最近一次 assemble 口径;estimate 写入,压缩后清空待下轮重算) */
55
+ viewTokensEst?: number;
56
+ /** 全量原文估算(仅 Run 页签展示,不进决策/主显示) */
57
+ rawTokens?: number;
53
58
  contextWindow?: number;
54
59
  };
55
60
  'tool.exec.start': {
@@ -111,7 +116,7 @@ export interface AgentEventMap {
111
116
  stopReason?: string;
112
117
  };
113
118
  'budget.exceeded': {
114
- reason: 'wall_clock' | 'iteration' | 'tool_calls';
119
+ reason: 'wall_clock' | 'steps' | 'tool_calls';
115
120
  report?: unknown;
116
121
  };
117
122
  'run_guard.stopped': {
@@ -175,26 +180,53 @@ export interface AgentEventMap {
175
180
  'persona.resolve.failed': {
176
181
  error: string;
177
182
  };
178
- /** 上下文压缩开始(主动摘要 / 硬溢出;UI 可显示进行中) */
183
+ /** 上下文压缩开始(主动摘要 / 硬溢出 / 手动;UI 可显示进行中) */
179
184
  'context.compact.start': {
180
- reason: 'proactive' | 'overflow';
185
+ reason: 'proactive' | 'overflow' | 'manual';
181
186
  tokensBefore?: number;
182
187
  threshold?: number;
183
188
  };
184
189
  /** 上下文压缩结束 */
185
190
  'context.compact.end': {
186
- reason: 'proactive' | 'overflow';
191
+ reason: 'proactive' | 'overflow' | 'manual';
187
192
  tokensBefore?: number;
188
193
  tokensAfter?: number;
189
194
  durationMs?: number;
190
195
  cached?: boolean;
196
+ /** true=中止收尾(本轮作废、零写入)——不是「压缩完成」,UI 不得显示 compacted */
197
+ cancelled?: boolean;
191
198
  };
192
- /** 上下文压缩失败(引擎已回退截断,本轮继续) */
199
+ /** 上下文压缩受阻(failed=压缩失败已回退截断;denied=before_compaction 策略拒绝,非故障) */
193
200
  'context.compact.error': {
194
- reason?: 'proactive' | 'overflow';
201
+ reason?: 'proactive' | 'overflow' | 'manual';
195
202
  error: string;
203
+ kind?: 'denied' | 'failed';
196
204
  durationMs?: number;
197
205
  };
206
+ /**
207
+ * overflow 症状告警(P3 红线 7):守门人触发 = 罕见异常信号,每次触发打告警。
208
+ * proactive_failed=A 类(前馈溢出,proactive 失效症状);config_drift/config_missing=F 类实证;
209
+ * structural_over_budget=D 类(保护段超限);window_mismatch=F 类归因未定(收缩兜底)。
210
+ */
211
+ 'context.overflow.alert': {
212
+ symptom: 'proactive_failed' | 'config_drift' | 'config_missing' | 'structural_over_budget' | 'window_mismatch';
213
+ message: string;
214
+ estimatedTokens?: number;
215
+ contextWindow?: number;
216
+ trigger?: 'T1' | 'T2' | 'T3';
217
+ };
218
+ /** 摘要请求进行中(P3):请求已发出、等 provider 返回——UI 据此显示「已发出 N 条 / 预算 Ms」而非只显示「进行中」 */
219
+ 'context.compact.progress': {
220
+ reason?: 'proactive' | 'overflow' | 'manual';
221
+ /** 当前阶段(当前只有 summarize:请求已发出、等 provider 返回) */
222
+ phase: 'summarize';
223
+ /** 摘要请求体量(JSON 字符数)——事故里就是它从 ~150KB 涨到 2.13MB */
224
+ requestChars?: number;
225
+ /** 摘要请求消息条数 */
226
+ requestMessages?: number;
227
+ /** 本次调用的单次预算(ms);缺失 = 不设预算 */
228
+ timeoutMs?: number;
229
+ };
198
230
  /** 摘要请求 cache-miss 旁路/穷尽可观测(F22):no_prefix=无同形前缀,window_guard=前缀放不下改文本化旁路,window_exhausted=最终失败 */
199
231
  'context.compact.summarize_fallback': {
200
232
  reason?: 'proactive' | 'overflow';
@@ -337,8 +369,8 @@ export declare const AgentEvents: {
337
369
  readonly ENGINE_END: "engine.end";
338
370
  readonly ENGINE_ERROR: "engine.error";
339
371
  readonly ENGINE_MODEL_RETRY: "engine.model_retry";
340
- readonly ITERATION_START: "iteration.start";
341
- readonly TURN_END: "turn.end";
372
+ readonly STEP_START: "step.start";
373
+ readonly STEP_END: "step.end";
342
374
  /** Runner 收口计时(F3 转正) */
343
375
  readonly RUN_TIMING: "run.timing";
344
376
  readonly TOOL_EXEC_START: "tool.exec.start";
@@ -357,6 +389,7 @@ export declare const AgentEvents: {
357
389
  readonly SESSION_UPDATED: "session.updated";
358
390
  readonly PERSONA_RESOLVE_FAILED: "persona.resolve.failed";
359
391
  readonly CONTEXT_COMPACT_START: "context.compact.start";
392
+ readonly CONTEXT_COMPACT_PROGRESS: "context.compact.progress";
360
393
  readonly CONTEXT_COMPACT_END: "context.compact.end";
361
394
  readonly CONTEXT_COMPACT_ERROR: "context.compact.error";
362
395
  readonly CONTEXT_LAYERS_ASSEMBLED: "context.layers.assembled";
@@ -19,8 +19,8 @@ export const AgentEvents = {
19
19
  ENGINE_END: 'engine.end',
20
20
  ENGINE_ERROR: 'engine.error',
21
21
  ENGINE_MODEL_RETRY: 'engine.model_retry',
22
- ITERATION_START: 'iteration.start',
23
- TURN_END: 'turn.end',
22
+ STEP_START: 'step.start',
23
+ STEP_END: 'step.end',
24
24
  /** Runner 收口计时(F3 转正) */
25
25
  RUN_TIMING: 'run.timing',
26
26
  TOOL_EXEC_START: 'tool.exec.start',
@@ -39,6 +39,7 @@ export const AgentEvents = {
39
39
  SESSION_UPDATED: 'session.updated',
40
40
  PERSONA_RESOLVE_FAILED: 'persona.resolve.failed',
41
41
  CONTEXT_COMPACT_START: 'context.compact.start',
42
+ CONTEXT_COMPACT_PROGRESS: 'context.compact.progress',
42
43
  CONTEXT_COMPACT_END: 'context.compact.end',
43
44
  CONTEXT_COMPACT_ERROR: 'context.compact.error',
44
45
  CONTEXT_LAYERS_ASSEMBLED: 'context.layers.assembled',
@@ -8,7 +8,7 @@ import type { ToolCall } from '@octopi-agent/core/types.js';
8
8
  import type { TokenUsage } from '@octopi-agent/core/types.js';
9
9
  import type { ClassifiedError, ErrorReason } from '@octopi-agent/core/interfaces/error-strategy.js';
10
10
  export type { ErrorReason, ClassifiedError };
11
- export type LoopEndReason = 'completed' | 'max_turns' | 'budget_exhausted' | 'plugin_stop' | 'interrupted' | 'error';
11
+ export type LoopEndReason = 'completed' | 'max_steps' | 'budget_exhausted' | 'plugin_stop' | 'interrupted' | 'error';
12
12
  export type AgentEventDetail = {
13
13
  type: 'loop_start';
14
14
  sessionId: string;
@@ -17,12 +17,12 @@ export type AgentEventDetail = {
17
17
  reason: LoopEndReason;
18
18
  response?: string;
19
19
  } | {
20
- type: 'turn_start';
21
- turnId: string;
22
- turnIndex: number;
20
+ type: 'step_start';
21
+ stepId: string;
22
+ stepIndex: number;
23
23
  } | {
24
- type: 'turn_end';
25
- turnId: string;
24
+ type: 'step_end';
25
+ stepId: string;
26
26
  shouldContinue: boolean;
27
27
  phase?: 'pre_tools' | 'final';
28
28
  } | {
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Path glob compilation — shared by tool glob filters and path denylists.
3
+ *
4
+ * Semantics follow rg/git so that `file_search`'s `glob` argument and
5
+ * `effectPolicy.pathDenylist` cannot drift apart:
6
+ * - `**` crosses directories; `*` and `?` do not cross `/`
7
+ * - a pattern without `/` (for example `*.md`) matches at any depth
8
+ * - `{a,b}` alternatives are supported, including nesting
9
+ */
10
+ /**
11
+ * Compile a path glob into a regular expression over root-relative paths.
12
+ *
13
+ * @param glob - glob pattern
14
+ * @returns anchored, case-insensitive matcher for a root-relative path
15
+ */
16
+ export declare function globToPathRegex(glob: string): RegExp;
17
+ /**
18
+ * Normalize a deny pattern into the path dialect the matcher speaks.
19
+ *
20
+ * Windows deployments write separators the way their shell does, so `\` is
21
+ * always a separator here. That makes an escaped literal (`.git\**` meaning
22
+ * "a file literally named `.git*`") impossible to express — acceptable, since a
23
+ * separator is what every real denylist entry means.
24
+ *
25
+ * @param pattern - raw deny pattern from configuration
26
+ * @returns pattern using `/` separators
27
+ */
28
+ export declare function normalizeDenyPattern(pattern: string): string;
29
+ /**
30
+ * Reject deny patterns that can never match a root-relative path.
31
+ *
32
+ * A pattern that silently matches nothing is worse than a startup error: the
33
+ * deployment keeps believing it is protected. Shapes rejected here are all
34
+ * spellings that look meaningful but cannot match (`/x` anchors outside the
35
+ * root, `x/` never matches a resolved file, `../x` has no candidate).
36
+ *
37
+ * @param pattern - raw deny pattern from configuration
38
+ */
39
+ export declare function validateDenyPattern(pattern: string): void;
40
+ /**
41
+ * Whether a root-relative path matches any denylist pattern.
42
+ *
43
+ * Both the full relative path and the file name are tested, so `.env*` and
44
+ * `.git/**` can coexist without the caller deciding which form a pattern means.
45
+ * Invalid patterns are the caller's mistake and throw: silently ignoring a
46
+ * typo'd security pattern would leave the deployment believing it is protected.
47
+ *
48
+ * @param relativePath - path relative to the containing root, using `/`
49
+ * @param patterns - denylist globs
50
+ * @returns true when any pattern matches
51
+ */
52
+ export declare function matchesDenyPattern(relativePath: string, patterns: readonly string[]): boolean;