@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
package/dist/config.d.ts CHANGED
@@ -72,7 +72,7 @@ export interface AgentConfig {
72
72
  rightsCeiling?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionRights;
73
73
  /** 委派预算上限(请求预算与此取交集) */
74
74
  budget?: {
75
- maxTurns?: number;
75
+ maxSteps?: number;
76
76
  maxTokens?: number;
77
77
  timeoutMs?: number;
78
78
  };
@@ -125,20 +125,18 @@ export interface KnowledgeRuntimeConfig {
125
125
  includePriorUserTurns?: number;
126
126
  skipIfUserTokensBelow?: number;
127
127
  };
128
- index?: {
129
- embedding?: boolean;
130
- hybridKeyword?: boolean;
128
+ /** Phase B 向量化(v0.98.11 起取代 index.phaseB / index.embedding / index.embedSecretPolicy) */
129
+ embed?: {
130
+ /** false = 纯关键词索引(不外发 embed);缺省 true */
131
+ enabled?: boolean;
132
+ embedBatch?: number;
133
+ embedMinIntervalMs?: number;
134
+ embedConcurrency?: number;
131
135
  /** embedding 外发前敏感形态策略(默认 redact) */
132
136
  embedSecretPolicy?: 'allow' | 'redact' | 'skip';
133
- phaseA?: {
134
- concurrency?: number;
135
- debounceMs?: number;
136
- };
137
- phaseB?: {
138
- embedBatch?: number;
139
- concurrency?: number;
140
- ratePerMin?: number;
141
- };
137
+ };
138
+ index?: {
139
+ hybridKeyword?: boolean;
142
140
  queue?: {
143
141
  maxDepth?: number;
144
142
  };
@@ -172,6 +170,8 @@ export interface KnowledgeRuntimeConfig {
172
170
  };
173
171
  load?: {
174
172
  parseConcurrency?: number;
173
+ /** fs watch debounce ms(默认 800;原 index.phaseA.debounceMs) */
174
+ debounceMs?: number;
175
175
  diskWatermarkAlert?: boolean;
176
176
  };
177
177
  promotion?: {
@@ -187,22 +187,13 @@ export interface KnowledgeRuntimeConfig {
187
187
  maxFileBytes?: number;
188
188
  maxTotalBytes?: number;
189
189
  allowedExtensions?: string[];
190
- parse?: {
191
- extract?: boolean;
192
- keywordIndex?: boolean;
193
- embedding?: 'off' | 'lazy' | 'on-upload';
194
- };
195
190
  inject?: {
196
191
  fullTextMaxChars?: number;
197
192
  recallTopK?: number;
198
- inventory?: boolean;
199
193
  intent?: 'llm' | 'off';
200
194
  intentTimeoutMs?: number;
201
195
  emptyMessagePrompt?: string;
202
196
  };
203
- tools?: {
204
- attachmentsRootReadOnly?: boolean;
205
- };
206
197
  };
207
198
  }
208
199
  /** 单个 web search provider slot */
@@ -261,8 +252,15 @@ export interface SessionConfig {
261
252
  export interface PluginConfig {
262
253
  /** Plugin 目录扫描路径 */
263
254
  loadPaths?: string[];
264
- /** 单个 plugin 的配置(plugin id → config) */
265
- configs?: Record<string, Record<string, unknown>>;
255
+ /** 宿主允许的插件 ID;未配置 = 不限制 */
256
+ allowList?: string[];
257
+ /** 宿主明确阻止的插件 ID,优先于其他启用决策 */
258
+ blockList?: string[];
259
+ /** 插件启停与业务配置;单纯存在 config 不代表启用 */
260
+ entries?: Record<string, {
261
+ enabled?: boolean;
262
+ config?: Record<string, unknown>;
263
+ }>;
266
264
  }
267
265
  /**
268
266
  * 监听 host 配置值
@@ -319,7 +317,7 @@ export interface ChannelConfig {
319
317
  *
320
318
  * 见 arch/budget-redesign.md:
321
319
  * - 默认 **无** nominal token hard(Σ nominalTotalTokens 不作为出厂熔断)
322
- * - P0:仅 wall-clock 安全阀 + 可显式 iteration/tool 上限
320
+ * - P0:仅 wall-clock 安全阀 + 可显式 steps/tool 上限
323
321
  * - P2:控制梯配置(wrap-up 策略)
324
322
  * - P3:扩展 usd / uncached 等 opt-in 单位;键名仅 budgetPolicy(无 budget)
325
323
  */
@@ -327,13 +325,13 @@ export interface BudgetPolicyJsonConfig {
327
325
  /** 安全阀:最大运行时间毫秒(默认 6h) */
328
326
  maxWallClockMs?: number;
329
327
  /** 最大迭代次数。仅显式设置时硬停 */
330
- maxIterations?: number;
328
+ maxSteps?: number;
331
329
  /** 最大工具调用次数。仅显式设置时硬停 */
332
330
  maxToolCalls?: number;
333
331
  /** Policy 触达时的行为:'stop' 立即停止 | 'wrap_up_then_stop' 先总结再停止(默认) */
334
332
  onPolicyHit?: 'stop' | 'wrap_up_then_stop';
335
333
  /** wrap-up 窗口的轮次数(默认 3) */
336
- wrapUpTurns?: number;
334
+ wrapUpSteps?: number;
337
335
  /** context 轴 wrap-up 触发阈值比例(默认 0.85) */
338
336
  contextWrapUpRatio?: number;
339
337
  /** 预算单位配置(仅显式配置才启用 hard) */
@@ -461,6 +459,13 @@ export interface ContextEngineConfig {
461
459
  protectFirstN?: number;
462
460
  /** 尾部保护消息数(默认 20) */
463
461
  protectLastN?: number;
462
+ /**
463
+ * turn 内活跃窗口条数(默认 50):工具活动进行中(isMidTurn)时主动压缩选段的
464
+ * tail 扩大到 max(protectLastN, 本值),进行中的工具步骤/证据/推理链不进选段。
465
+ * 2026-11-07 方案 E 修订:取代「turn 内禁 LLM 摘要」。条数上限,token 密集的
466
+ * 短 turn 仍有已知限制(见 CHANGELOG v0.102.2 已接受风险)。
467
+ */
468
+ midTurnProtectLastN?: number;
464
469
  /** 摘要软目标预算(P1c 缺省 clamp(2%, 2k, 8k)):可配置 ratioPct/minTokens/maxTokens */
465
470
  summaryBudget?: {
466
471
  ratioPct?: number;
@@ -471,7 +476,8 @@ export interface ContextEngineConfig {
471
476
  * 窗口比例线:消息 token / messagesBudget 超过该比例时,
472
477
  * 在硬溢出前先主动压缩(默认 0.6)。
473
478
  * `0` = **禁止发起新的**路径 A 压缩(不只禁 LLM;目标线/窗口比例线同闸);**不**丢弃已有
474
- * `previousSummary` 粘滞视图(粘滞重建仍生效)。turn 内(工具活动中)本就不打 LLM。
479
+ * `previousSummary` 粘滞视图(粘滞重建仍生效)。turn 内(工具活动中)同样打 LLM
480
+ * (2026-11-07 方案 E 修订),活动记录由 `midTurnProtectLastN` 活跃窗口保护。
475
481
  */
476
482
  proactiveCompactRatio?: number;
477
483
  /**
@@ -479,6 +485,12 @@ export interface ContextEngineConfig {
479
485
  * 冷却期内优先缓存重建,降低单 turn 双摘要。
480
486
  */
481
487
  proactiveCooldownMs?: number;
488
+ /**
489
+ * 单次摘要 LLM 调用预算 ms(默认 300000;0 = 不设预算,只受 provider 超时约束)。
490
+ * 超时即中止摘要请求并按 onSummarizeFail 降级——防止 provider 挂死时 UI 全程假等。
491
+ * 中断不续做:下一轮重新发起压缩即可。
492
+ */
493
+ summarizeTimeoutMs?: number;
482
494
  /**
483
495
  * 历史工具结果批量冻结老化(F1-B2):当前 run 永不老化、近 rawWindow 条跨轮原文、
484
496
  * 更旧按 freezeBatch 成批降级为结构化指针(视图级、write-once、禁渐进)。
@@ -513,10 +525,6 @@ export interface ContextEngineConfig {
513
525
  minOutputReserve?: number;
514
526
  /** 输出预留最大值(默认 8000) */
515
527
  maxOutputReserve?: number;
516
- /** 是否启用 LLM 摘要(默认 true) */
517
- enableLLMSummary?: boolean;
518
- /** 摘要模型(可选,使用主模型) */
519
- summaryModel?: string;
520
528
  }
521
529
  /**
522
530
  * 公用能力 summary 配置(harness/context/capabilities)
@@ -543,21 +551,10 @@ export interface SummaryCapabilityConfig {
543
551
  } & Record<string, unknown>;
544
552
  cache?: {
545
553
  enabled?: boolean;
546
- backend?: 'memory' | 'file';
547
554
  ttlMs?: number;
548
555
  maxEntries?: number;
549
- dir?: string;
550
556
  };
551
557
  }
552
- /**
553
- * 公用能力 compact 缺省配置
554
- */
555
- export interface CompactCapabilityConfig {
556
- defaultProtectHead?: number;
557
- defaultProtectTail?: number;
558
- defaultTargetTokens?: number;
559
- defaultMode?: 'structure_only' | 'summary_only' | 'head_tail_only' | 'auto';
560
- }
561
558
  /**
562
559
  * 公用能力 documents(DocumentPort 读抽取)
563
560
  */
@@ -577,19 +574,6 @@ export interface DocumentsCapabilityConfig {
577
574
  timeoutMs?: number;
578
575
  maxInputBytes?: number;
579
576
  };
580
- markitdown?: {
581
- enabled?: boolean;
582
- command?: string;
583
- };
584
- enhanced?: {
585
- enabled?: boolean;
586
- provider?: 'mineru' | 'azure-di' | 'azure-cu' | string;
587
- endpoint?: string | null;
588
- command?: string | null;
589
- authRef?: string | null;
590
- timeoutMs?: number;
591
- preferOn?: string[];
592
- };
593
577
  }
594
578
  /**
595
579
  * system prompt 层装配器配置(七层 ContextAssembler)
@@ -649,8 +633,6 @@ export interface ModelDefinition {
649
633
  provider: string;
650
634
  /** 模型名称 */
651
635
  model: string;
652
- /** 温度 */
653
- temperature?: number;
654
636
  /** 最大 token 数 */
655
637
  maxTokens?: number;
656
638
  /** 上下文窗口大小 */
@@ -767,8 +749,6 @@ export interface EmbeddingModelConfig {
767
749
  }
768
750
  /** 新格式的 models 配置 */
769
751
  export interface ModelsConfig {
770
- /** 合并模式:merge=与 builtin 合并,replace=完全替代 */
771
- mode?: 'merge' | 'replace';
772
752
  /** Provider 映射(key = provider 名称) */
773
753
  providers: Record<string, ModelProviderConfig>;
774
754
  /** 模型级别映射(子系统通过级别名引用具体模型) */
@@ -836,19 +816,13 @@ export interface HarnessConfig {
836
816
  contextEngine?: ContextEngineConfig;
837
817
  /** 公用能力 summary(harness/context/capabilities) */
838
818
  summary?: SummaryCapabilityConfig;
839
- /** 公用能力 compact 缺省 */
840
- compact?: CompactCapabilityConfig;
841
819
  /** 公用能力 documents(DocumentPort 读抽取) */
842
820
  documents?: DocumentsCapabilityConfig;
843
- /** system prompt 七层装配器配置 */
844
- contextAssembler?: ContextAssemblerConfig;
845
- /** context 域扩展:全局宪法等 */
821
+ /** system prompt 七层装配器 / 全局宪法(唯一声明面:context 域;v0.98.11 起顶层简写已删除) */
846
822
  context?: {
847
823
  constitution?: ConstitutionConfig;
848
824
  contextAssembler?: ContextAssemblerConfig;
849
825
  };
850
- /** 全局宪法(顶层简写,等价 context.constitution) */
851
- constitution?: ConstitutionConfig;
852
826
  /** Memory 写入/置信度策略 */
853
827
  memory?: {
854
828
  profile?: 'personal_assistant' | 'embedded_interactive' | 'embedded_headless';
@@ -895,16 +869,10 @@ export interface HarnessConfig {
895
869
  maxLength?: Partial<Record<'fact' | 'method' | 'norm', number>>;
896
870
  };
897
871
  };
898
- /** Cognition 概念图谱(arch/cognition-graph-formation.md) */
872
+ /** Cognition 概念图谱(arch/cognition-graph-formation.md);steward 调参面在子系统 config.yaml metadata.config */
899
873
  cognition?: {
900
874
  enabled?: boolean;
901
- conceptualize?: {
902
- onMemoryWrite?: boolean;
903
- maxNodesPerProposition?: number;
904
- maxEdgesPerProposition?: number;
905
- };
906
875
  relations?: {
907
- requireCue?: boolean;
908
876
  causesMinIndependentMemories?: number;
909
877
  };
910
878
  identity?: {
@@ -912,59 +880,23 @@ export interface HarnessConfig {
912
880
  candidateBandHi?: number;
913
881
  };
914
882
  capacity?: {
915
- warnNodes?: number;
916
- warnEdges?: number;
917
883
  stopNodes?: number;
918
884
  stopEdges?: number;
919
885
  };
920
- retrieval?: {
921
- depth?: number;
922
- delta?: number;
923
- tau?: number;
924
- limit?: number;
925
- };
926
- consolidation?: {
927
- debounceMinutes?: number;
928
- ttlHours?: number;
929
- };
930
886
  };
931
- /** Wisdom 判断范式(arch/wisdom-layer-formation.md) */
887
+ /** Wisdom 判断范式(arch/wisdom-layer-formation.md);steward 调参面在子系统 config.yaml metadata.config */
932
888
  wisdom?: {
933
889
  enabled?: boolean;
934
890
  capacity?: {
935
- softCap?: number;
936
891
  hardCap?: number;
937
892
  };
938
- formation?: {
939
- enabled?: boolean;
940
- dryRun?: boolean;
941
- ttlHours?: number;
942
- minMemorySupport?: number;
943
- minClusterSize?: number;
944
- minPromotionStack?: number;
945
- maxItemsPerRun?: number;
946
- maxEvidenceChars?: number;
947
- };
948
- evaluation?: {
949
- dryRun?: boolean;
950
- windowHours?: number;
951
- minAppliesForActive?: number;
952
- contestRate?: number;
953
- counterevidenceWeight?: number;
954
- strengthenMinApplies?: number;
955
- };
956
893
  injection?: {
957
894
  coreMaxItems?: number;
958
- coreMaxTokens?: number;
959
895
  scenarioMaxItems?: number;
896
+ /** trial 轮转试用名额(缺省 2;0 = 关闭轮转) */
897
+ trialMaxItems?: number;
960
898
  trialVisible?: boolean;
961
899
  };
962
- govern?: {
963
- dryRun?: boolean;
964
- zeroApplyIdleMs?: number;
965
- priorityDecayStep?: number;
966
- priorityFloor?: number;
967
- };
968
900
  };
969
901
  /** Knowledge 检索/召回(全局缺省;agents[].knowledge.recall 可覆盖) */
970
902
  knowledge?: KnowledgeRuntimeConfig;
package/dist/config.js CHANGED
@@ -145,7 +145,6 @@ function resolveFallbackModels(fallbacks, models, defaults, depth = 0) {
145
145
  return {
146
146
  provider: m.provider,
147
147
  model: m.model,
148
- temperature: m.temperature,
149
148
  maxTokens: m.maxTokens,
150
149
  contextWindow: m.contextWindow ?? defaults?.contextWindow,
151
150
  fallbackModels: resolveFallbackModels(m.fallbackModels, models, defaults, depth + 1),
@@ -195,7 +194,14 @@ export async function createWireDumpSinkFromConfig(cfg) {
195
194
  */
196
195
  export async function createProviderFromConfig(name, pc, options) {
197
196
  const apiType = pc.api === 'anthropic-messages' ? 'anthropic' : 'openai';
198
- const models = pc.models.map(m => ({ name: m.name ?? m.id, contextWindow: m.contextWindow, maxOutputTokens: m.maxTokens, temperature: m.temperature }));
197
+ const models = pc.models.map(m => ({
198
+ name: m.name ?? m.id,
199
+ contextWindow: m.contextWindow,
200
+ maxOutputTokens: m.maxTokens,
201
+ temperature: m.temperature,
202
+ reasoning: m.reasoning,
203
+ input: m.input,
204
+ }));
199
205
  const defaultModel = pc.models[0]?.name ?? pc.models[0]?.id;
200
206
  let decorate = (inner) => inner;
201
207
  if (options?.wireDump) {
@@ -27,6 +27,13 @@ export class SessionRunnerDispatcher {
27
27
  sessionId: req.sessionId,
28
28
  model: req.modelOverride,
29
29
  modelProvider: req.modelProvider,
30
+ ...(req.actorId === undefined && req.actorType === undefined && req.tenantId === undefined ? {} : {
31
+ principal: {
32
+ ...(req.actorId === undefined ? {} : { actorId: req.actorId }),
33
+ ...(req.actorType === undefined ? {} : { actorType: req.actorType }),
34
+ ...(req.tenantId === undefined ? {} : { tenantId: req.tenantId }),
35
+ },
36
+ }),
30
37
  };
31
38
  const entries = req.triggers.map((trigger, index) => ({
32
39
  id: trigger.id,
@@ -9,7 +9,7 @@
9
9
  import type { AgentEvent } from '@octopi-agent/core/primitives/event-bus.js';
10
10
  import type { Message } from '@octopi-agent/core/types.js';
11
11
  import type { Trigger } from './types.js';
12
- export type InboxOfferResult = 'steered' | 'dispatched' | 'duplicate';
12
+ export type InboxOfferResult = 'continued' | 'dispatched' | 'duplicate';
13
13
  export interface SessionInboxSignal {
14
14
  agentId: string;
15
15
  sessionId: string;
@@ -26,7 +26,7 @@ export interface SessionInboxSignal {
26
26
  trigger?: Trigger;
27
27
  /** 调用方的收尾通道(频道回复捕获等);消费时由 Runner 转发事件。 */
28
28
  onEvent?: (event: AgentEvent) => void;
29
- onAdmitted?: (delivery: 'steered') => void;
29
+ onAdmitted?: (delivery: 'continued') => void;
30
30
  }
31
31
  export interface SessionInboxEntry {
32
32
  readonly id: string;
@@ -71,7 +71,7 @@ export declare class SessionInbox {
71
71
  private readonly unacked;
72
72
  constructor(redispatch: (entry: SessionInboxEntry) => void | Promise<unknown>, idLimit?: number);
73
73
  /**
74
- * 有兼容的活跃接收端才接收(返回 steered);否则调用方继续原 Trigger。
74
+ * 有兼容的活跃接收端才接收(返回 continued);否则调用方继续原 Trigger。
75
75
  * duplicate = 同 id 已被接收或已入上下文,不得再次执行。
76
76
  * 兼容性:显式换模型(≠ 活跃 Run 模型)/ 带附件输入不接续,走完整新 Run。
77
77
  */
@@ -31,7 +31,7 @@ export class SessionInbox {
31
31
  this.idLimit = idLimit;
32
32
  }
33
33
  /**
34
- * 有兼容的活跃接收端才接收(返回 steered);否则调用方继续原 Trigger。
34
+ * 有兼容的活跃接收端才接收(返回 continued);否则调用方继续原 Trigger。
35
35
  * duplicate = 同 id 已被接收或已入上下文,不得再次执行。
36
36
  * 兼容性:显式换模型(≠ 活跃 Run 模型)/ 带附件输入不接续,走完整新 Run。
37
37
  */
@@ -61,8 +61,8 @@ export class SessionInbox {
61
61
  };
62
62
  this.owned.add(id);
63
63
  active.state.pending.push(entry);
64
- signal.onAdmitted?.('steered');
65
- return 'steered';
64
+ signal.onAdmitted?.('continued');
65
+ return 'continued';
66
66
  }
67
67
  /** 仅 Runner 持锁后调用;同 (agent, session) 同时只有一个接收端。 */
68
68
  open(sessionId, agentId, runId, entries, runModel) {
@@ -295,9 +295,9 @@ export class AgentRuntime {
295
295
  // 单一 offer 点:活跃 Run 接收 = 不再开新 Run(原 Trigger 不 dispatch,
296
296
  // Run 关闭未消费时由 inbox 按原 Trigger 重投)
297
297
  const offerResult = this.offerToTarget(trigger, agent, sessionId, options?.onEvent);
298
- if (offerResult === 'steered' || offerResult === 'duplicate') {
299
- options?.onDelivery?.('steered');
300
- return { status: 'accepted', agentId: agent.agentId, sessionId, delivery: 'steered' };
298
+ if (offerResult === 'continued' || offerResult === 'duplicate') {
299
+ options?.onDelivery?.('continued');
300
+ return { status: 'accepted', agentId: agent.agentId, sessionId, delivery: 'continued' };
301
301
  }
302
302
  options?.onDelivery?.('run');
303
303
  if (trigger.coalesceKey) {
@@ -327,9 +327,17 @@ export class AgentRuntime {
327
327
  }
328
328
  // I6:schedule 点火以 timer 主体入审计(arch/session-schedules.md)
329
329
  const isScheduleWake = triggers.some((t) => t.type === 'schedule');
330
+ // Channel/user triggers carry their real sender as the Run principal so Hook
331
+ // audit attribution reflects who actually asked; host-internal triggers keep
332
+ // no actor rather than inventing one.
333
+ const senderId = isScheduleWake
334
+ ? undefined
335
+ : triggers
336
+ .map((t) => ('source' in t.payload ? t.payload.source?.senderId : undefined))
337
+ .find((id) => typeof id === 'string' && id.length > 0);
330
338
  const request = buildRunRequest(agent, triggers, sessionId, {
331
- actorType: isScheduleWake ? 'timer' : undefined,
332
- actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : undefined,
339
+ actorType: isScheduleWake ? 'timer' : senderId ? 'user' : undefined,
340
+ actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : senderId,
333
341
  intent: isScheduleWake ? 'schedule_wake' : undefined,
334
342
  });
335
343
  const controller = new AbortController();
@@ -105,7 +105,7 @@ export interface DispatchOptions {
105
105
  /** Run 事件流转发(频道回复捕获等);不变量 #6 */
106
106
  onEvent?: (event: AgentEvent) => void;
107
107
  /** 活跃 Run 接收即回执(早于 Run 结束);run = 走新 Run。 */
108
- onDelivery?: (delivery: 'steered' | 'run') => void;
108
+ onDelivery?: (delivery: 'continued' | 'run') => void;
109
109
  }
110
110
  export interface RouteTarget {
111
111
  agentId: string;
@@ -143,7 +143,7 @@ export type DispatchResult = {
143
143
  status: 'accepted';
144
144
  agentId: string;
145
145
  sessionId: string;
146
- delivery: 'steered';
146
+ delivery: 'continued';
147
147
  } | {
148
148
  status: 'skipped';
149
149
  reason: 'no_agent' | 'filtered' | 'runtime_stopped' | 'aborted';
@@ -9,7 +9,7 @@
9
9
  * .model('gpt-5.5')
10
10
  * .persona('./personas/my-agent')
11
11
  * .tool(myTool)
12
- * .budget({ maxIterations: 15 })
12
+ * .budget({ maxSteps: 15 })
13
13
  * .build();
14
14
  * ```
15
15
  */
@@ -45,6 +45,7 @@ export interface ToolContextProvider {
45
45
  sessionId: string;
46
46
  agentId: string;
47
47
  runId?: string;
48
+ agentToolPolicy?: import('@octopi-agent/core/types.js').ToolPolicy;
48
49
  messages: import('@octopi-agent/core/types.js').Message[];
49
50
  cwd?: string;
50
51
  attachmentRoots?: string[];
@@ -52,6 +53,9 @@ export interface ToolContextProvider {
52
53
  memoryEffects: import('@octopi-agent/core/types/tools.js').MemoryEffectJournal;
53
54
  pathRoots?: string[];
54
55
  pathContainment?: 'strict' | 'soft' | 'none';
56
+ /** 拒绝最终组件为符号链接的文件读写(来自 effectPolicy.refuseFinalSymlink) */
57
+ refuseFinalSymlink?: boolean;
58
+ pathDenylist?: readonly string[];
55
59
  confirmEffect?: import('@octopi-agent/core/types/tools.js').ToolExecutionContext['confirmEffect'];
56
60
  effectChannel?: 'engine' | 'host-gate';
57
61
  /** 提权策略(ops P3/P4,resolved;与 core ToolExecutionContext 同源) */
@@ -155,7 +159,9 @@ export declare class AgentBuilder {
155
159
  private _toolBus;
156
160
  private _contextEngine?;
157
161
  private _summarize?;
158
- /** 最新的 context 压力信息(由 convertToLlm 更新) */
162
+ /** 按 session 键控的 context 压力(由 convertToLlm 更新;共享 Agent 下并发会话不串号) */
163
+ private _contextPressureBySession;
164
+ /** 兜底:无 sessionId 的调用方(仅 advisory 用途;并发下可能串号,不得用于持久化) */
159
165
  private _lastContextPressure?;
160
166
  /** 为 true 时禁止自动挂默认 summarize(测试/特殊场景) */
161
167
  private _disableAutoSummarize;
@@ -176,6 +182,8 @@ export declare class AgentBuilder {
176
182
  private _systemPrompt?;
177
183
  /** Skill 目录(SKILL.md);build 时 discover 并注入 system prompt 索引 */
178
184
  private _skillDirectory?;
185
+ /** Skill id allowlist(agents[].skills);未设置 = 全部启用 */
186
+ private _skillAllowlist?;
179
187
  private _skillManager?;
180
188
  /** 记忆检索(注入 system prompt MemoryLayer) */
181
189
  private _memoryStore?;
@@ -195,6 +203,8 @@ export declare class AgentBuilder {
195
203
  private _knowledgeGrounding?;
196
204
  /** 智慧(注入 system prompt WisdomLayer) */
197
205
  private _wisdomStore?;
206
+ /** Wisdom 注入策略(wisdom.injection:core/scenario/trial 上限 + trialVisible) */
207
+ private _wisdomInjection?;
198
208
  /** 认知图谱(注入 system prompt CognitionLayer) */
199
209
  private _cognitionStore?;
200
210
  /** system prompt 装配器调参 */
@@ -235,6 +245,8 @@ export declare class AgentBuilder {
235
245
  private _agentHome?;
236
246
  /** 逻辑 agentId(观测 / 子系统审计用) */
237
247
  private _agentId?;
248
+ /** Deferred until build so .pluginTools() and .agentId() order is immaterial. */
249
+ private _pluginToolRecords;
238
250
  /** 设置模型提供者 */
239
251
  model(provider: ModelProvider): this;
240
252
  model(name: string): this;
@@ -244,6 +256,11 @@ export declare class AgentBuilder {
244
256
  * 覆盖注册(显式)。用于热更新/替换同名工具,不可默默发生。
245
257
  */
246
258
  toolReplace(tool: RegisteredTool): this;
259
+ /**
260
+ * Mount host-owned plugin contributions into this Agent's ToolBus projection.
261
+ * Authorization is applied by ToolBus/RunScope; mounting is not Tool exposure.
262
+ */
263
+ pluginTools(records: readonly import('../extension/plugin-ecosystem/plugins/contribution-registry.js').PluginToolRecord[]): this;
247
264
  /** 批量注册:逐个 try/catch,避免一个工具失败拖垮整表 */
248
265
  tools(...tools: RegisteredTool[]): this;
249
266
  private _contextProvider;
@@ -304,6 +321,14 @@ export declare class AgentBuilder {
304
321
  * `~` 形态在此展开(与 workspace / agentHome 同规,幂等)。
305
322
  */
306
323
  skillDirectory(dir: string): this;
324
+ /**
325
+ * Skill 启用清单(agents[].skills):discover 只保留列出的 skill id。
326
+ * 不调用或传 undefined = 目录内全部启用。
327
+ *
328
+ * @param ids - 允许的 skill id 列表(SKILL.md 目录名)
329
+ * @returns this
330
+ */
331
+ skillAllowlist(ids: string[] | undefined): this;
307
332
  /** 直接注入 SkillManager(跳过目录 discover) */
308
333
  skills(manager: import('../extension/plugin-ecosystem/skills/types.js').SkillManager): this;
309
334
  /** 注入 MemoryStore(每轮按 query 召回进 system prompt) */
@@ -351,6 +376,13 @@ export declare class AgentBuilder {
351
376
  }): this;
352
377
  /** 注入 WisdomStore(半静态思维范式,进 system prompt WisdomLayer) */
353
378
  wisdomStore(store: import('../memory/types.js').WisdomStore): this;
379
+ /** 注入策略(wisdom.injection.*:coreMaxItems/scenarioMaxItems/trialVisible) */
380
+ wisdomInjection(cfg: {
381
+ coreMaxItems?: number;
382
+ scenarioMaxItems?: number;
383
+ trialMaxItems?: number;
384
+ trialVisible?: boolean;
385
+ }): this;
354
386
  /** 注入 ConceptGraphStore(spreadingActivate 召回概念子图,进 system prompt CognitionLayer) */
355
387
  cognitionStore(store: import('../memory/types.js').ConceptGraphStore): this;
356
388
  /**