@octopi-agent/engine 0.98.4 → 0.121.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 (493) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -21,6 +21,14 @@ export interface AgentRuntimeConfig {
21
21
  expectedMaxConcurrentRuns?: number;
22
22
  coalesceBufferLimit?: number;
23
23
  };
24
+ /**
25
+ * trigger 的 lease_held 延迟重投(协调面「唤醒」原语):
26
+ * maxAttempts 缺省 3、delayMs 缺省 2000;human 同样重投(拒可见 + 补达,2026-11-14 插话修复②)。
27
+ */
28
+ wakeupRetry?: {
29
+ maxAttempts?: number;
30
+ delayMs?: number;
31
+ };
24
32
  }
25
33
  export declare class AgentRuntime {
26
34
  private readonly events?;
@@ -32,6 +40,10 @@ export declare class AgentRuntime {
32
40
  private readonly activeRuns;
33
41
  private readonly listeners;
34
42
  private readonly expectedMaxConcurrentRuns?;
43
+ private readonly wakeupRetryMax;
44
+ private readonly wakeupRetryDelayMs;
45
+ private readonly wakeupAttempts;
46
+ private readonly wakeupScheduled;
35
47
  private started;
36
48
  constructor(config?: AgentRuntimeConfig);
37
49
  get running(): boolean;
@@ -75,6 +87,27 @@ export declare class AgentRuntime {
75
87
  * @param options.onDelivery - 活跃 Run 接收即回执(早于 Run 结束)
76
88
  */
77
89
  dispatch(trigger: Trigger, options?: import('./types.js').DispatchOptions): Promise<DispatchResult | FanoutDispatchResult>;
90
+ /**
91
+ * 唤醒/重试语义收口(协调面「唤醒」原语的跨进程补齐,B):
92
+ * trigger 被 run 层直拒(RUN_LEASE_HELD_MARKER——同会话并发 run 闸;产生点在
93
+ * 执行前,消息未入上下文)时,按原 Trigger 定向重投至少一次到达。重投走
94
+ * **dispatchToTarget(per-target)**:fan-out 场景只补失败目标,不给已送达
95
+ * 目标重复投递。human 同样重投(宁可重投不可静默丢):本次 'failed' 原样回到
96
+ * 用户可见面(拒可见),重投成功则补达,渠道回复路由由随行的 onEvent/onDelivery
97
+ * 闭包续上(gateway 侧晚到回复按 retryScheduled 标记开启)。
98
+ *
99
+ * @param trigger - 原 Trigger(唤醒凭证)
100
+ * @param target - 失败的路由目标(重投定向)
101
+ * @param result - dispatch 结果
102
+ * @param onEvent - 原派发的事件闭包(重投续用;human 渠道回复路由依赖它)
103
+ * @param onDelivery - 原派发的投递回执闭包(重投续用)
104
+ * @returns 原结果透传 + retryScheduled 标记(重投在后台进行,不吞本次失败)
105
+ */
106
+ private finalizeDelivery;
107
+ /** 延迟重投(per-target 定向;attempts 上限后 TRIGGER_DROPPED 落账;同键单飞防重复排程)
108
+ * @returns 是否排程成功(false = 预算耗尽已落账 dropped)
109
+ */
110
+ private scheduleWakeupRetry;
78
111
  /**
79
112
  * 路由目标的活跃 inbox 接收(human 与 delegation signal 共用)。
80
113
  * 仅 message / agent_signal 可接续;其余类型与带附件/换模型输入走完整新 Run。
@@ -7,6 +7,7 @@
7
7
  * 设计:arch/agent-runtime.md
8
8
  */
9
9
  import { CoalesceBuffer } from './coalesce.js';
10
+ import { RUN_LEASE_HELD_MARKER } from './run-protocol.js';
10
11
  import { buildRunRequest, compileMessages, resolveSessionId } from './compiler.js';
11
12
  import { ExplicitRouter } from './router.js';
12
13
  import { RuntimeEvents } from './types.js';
@@ -35,11 +36,17 @@ export class AgentRuntime {
35
36
  activeRuns = new Map();
36
37
  listeners = new Set();
37
38
  expectedMaxConcurrentRuns;
39
+ wakeupRetryMax;
40
+ wakeupRetryDelayMs;
41
+ wakeupAttempts = new Map();
42
+ wakeupScheduled = new Set();
38
43
  started = false;
39
44
  constructor(config = {}) {
40
45
  this.events = config.events;
41
46
  this.router = config.router ?? new ExplicitRouter();
42
47
  this.expectedMaxConcurrentRuns = config.admission?.expectedMaxConcurrentRuns;
48
+ this.wakeupRetryMax = config.wakeupRetry?.maxAttempts ?? 3;
49
+ this.wakeupRetryDelayMs = config.wakeupRetry?.delayMs ?? 2000;
43
50
  this.coalesce = new CoalesceBuffer({
44
51
  defaultWindowMs: config.defaultCoalesceMs,
45
52
  maxEntries: config.admission?.coalesceBufferLimit ?? config.coalesceBufferLimit ?? 256,
@@ -249,11 +256,66 @@ export class AgentRuntime {
249
256
  }
250
257
  return { status: 'skipped', reason: 'no_agent' };
251
258
  }
259
+ /**
260
+ * 唤醒/重试语义收口(协调面「唤醒」原语的跨进程补齐,B):
261
+ * trigger 被 run 层直拒(RUN_LEASE_HELD_MARKER——同会话并发 run 闸;产生点在
262
+ * 执行前,消息未入上下文)时,按原 Trigger 定向重投至少一次到达。重投走
263
+ * **dispatchToTarget(per-target)**:fan-out 场景只补失败目标,不给已送达
264
+ * 目标重复投递。human 同样重投(宁可重投不可静默丢):本次 'failed' 原样回到
265
+ * 用户可见面(拒可见),重投成功则补达,渠道回复路由由随行的 onEvent/onDelivery
266
+ * 闭包续上(gateway 侧晚到回复按 retryScheduled 标记开启)。
267
+ *
268
+ * @param trigger - 原 Trigger(唤醒凭证)
269
+ * @param target - 失败的路由目标(重投定向)
270
+ * @param result - dispatch 结果
271
+ * @param onEvent - 原派发的事件闭包(重投续用;human 渠道回复路由依赖它)
272
+ * @param onDelivery - 原派发的投递回执闭包(重投续用)
273
+ * @returns 原结果透传 + retryScheduled 标记(重投在后台进行,不吞本次失败)
274
+ */
275
+ finalizeDelivery(trigger, target, result, onEvent, onDelivery) {
276
+ const key = `${trigger.id}:${target.agentId}`;
277
+ if (result.status === 'failed' && result.error.includes(RUN_LEASE_HELD_MARKER)) {
278
+ const scheduled = this.scheduleWakeupRetry(trigger, target, onEvent, onDelivery);
279
+ return { ...result, retryScheduled: scheduled };
280
+ }
281
+ if (result.status === 'ran' || result.status === 'accepted') {
282
+ this.wakeupAttempts.delete(key);
283
+ }
284
+ return result;
285
+ }
286
+ /** 延迟重投(per-target 定向;attempts 上限后 TRIGGER_DROPPED 落账;同键单飞防重复排程)
287
+ * @returns 是否排程成功(false = 预算耗尽已落账 dropped)
288
+ */
289
+ scheduleWakeupRetry(trigger, target, onEvent, onDelivery) {
290
+ const key = `${trigger.id}:${target.agentId}`;
291
+ if (this.wakeupScheduled.has(key))
292
+ return true; // 已排程:不重复排(同键单飞)
293
+ const attempts = this.wakeupAttempts.get(key) ?? 0;
294
+ if (attempts >= this.wakeupRetryMax) {
295
+ this.wakeupAttempts.delete(key);
296
+ this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
297
+ triggerRef: toTriggerRef(trigger),
298
+ triggerId: trigger.id,
299
+ reason: RUN_LEASE_HELD_MARKER,
300
+ });
301
+ return false;
302
+ }
303
+ this.wakeupAttempts.set(key, attempts + 1);
304
+ this.wakeupScheduled.add(key);
305
+ setTimeout(() => {
306
+ this.wakeupScheduled.delete(key);
307
+ void this.dispatchToTarget(trigger, target, { onEvent, onDelivery }).catch(() => {
308
+ // 重投自身的调度失败由下一轮 finalize/DROPPED 落账;这里不吞错——
309
+ // 仅避免 unhandled rejection(dispatch 内部已 fail-loud 事件化)。
310
+ });
311
+ }, this.wakeupRetryDelayMs);
312
+ return true;
313
+ }
252
314
  /**
253
315
  * 路由目标的活跃 inbox 接收(human 与 delegation signal 共用)。
254
316
  * 仅 message / agent_signal 可接续;其余类型与带附件/换模型输入走完整新 Run。
255
317
  */
256
- offerToTarget(trigger, target, sessionId, onEvent) {
318
+ async offerToTarget(trigger, target, sessionId, onEvent) {
257
319
  if (!target.dispatcher.inbox)
258
320
  return 'dispatched';
259
321
  if (trigger.type !== 'message' && trigger.type !== 'agent_signal')
@@ -261,27 +323,40 @@ export class AgentRuntime {
261
323
  const [compiledMessage] = compileMessages([trigger]);
262
324
  const human = trigger.type === 'message' && trigger.payload.kind === 'user_message';
263
325
  const delegationId = trigger.metadata?.delegationId;
264
- return target.dispatcher.inbox.offer({
265
- agentId: target.agentId,
266
- sessionId,
267
- entryId: delegationId ?? trigger.id,
268
- triggerType: trigger.type,
269
- human,
270
- modelOverride: trigger.metadata?.modelOverride,
271
- modelProvider: trigger.metadata?.modelProvider,
272
- trigger,
273
- onEvent,
274
- message: compiledMessage,
275
- onAdmitted: (delivery) => {
276
- this.emitRuntime(RuntimeEvents.INBOX_ADMITTED, {
277
- triggerId: trigger.id,
278
- agentId: target.agentId,
279
- sessionId,
280
- delegationId,
281
- delivery,
282
- });
283
- },
284
- });
326
+ try {
327
+ return await target.dispatcher.inbox.offer({
328
+ agentId: target.agentId,
329
+ sessionId,
330
+ entryId: delegationId ?? trigger.id,
331
+ triggerType: trigger.type,
332
+ human,
333
+ modelOverride: trigger.metadata?.modelOverride,
334
+ modelProvider: trigger.metadata?.modelProvider,
335
+ trigger,
336
+ onEvent,
337
+ message: compiledMessage,
338
+ onAdmitted: (delivery) => {
339
+ try {
340
+ this.emitRuntime(RuntimeEvents.INBOX_ADMITTED, {
341
+ triggerId: trigger.id,
342
+ agentId: target.agentId,
343
+ sessionId,
344
+ delegationId,
345
+ delivery,
346
+ });
347
+ }
348
+ catch {
349
+ // 观测事件不得影响投递语义(admitted 后抛错会被外层 fail-open 翻成
350
+ // 'dispatched' = 双投)——通知是尽力而为面
351
+ }
352
+ },
353
+ });
354
+ }
355
+ catch {
356
+ // 协调面「插话」fail-open(语义权威点):offer 通道失败不吞消息,
357
+ // 一律回到 'dispatched' 由调用方照常 dispatch 新 Run 送达。
358
+ return 'dispatched';
359
+ }
285
360
  }
286
361
  async dispatchToTarget(trigger, target, options) {
287
362
  const agent = this.agents.get(target.agentId);
@@ -294,12 +369,25 @@ export class AgentRuntime {
294
369
  });
295
370
  // 单一 offer 点:活跃 Run 接收 = 不再开新 Run(原 Trigger 不 dispatch,
296
371
  // Run 关闭未消费时由 inbox 按原 Trigger 重投)
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' };
372
+ const offerResult = await this.offerToTarget(trigger, agent, sessionId, options?.onEvent);
373
+ if (offerResult === 'continued' || offerResult === 'duplicate') {
374
+ if (offerResult === 'continued') {
375
+ options?.onDelivery?.('continued');
376
+ // 插话送达即本周期成功:清重投计数(否则残留计数会让下一轮冲突提前耗尽)
377
+ this.wakeupAttempts.delete(`${trigger.id}:${agent.agentId}`);
378
+ }
379
+ // duplicate(同 id 已受理/已入上下文)不回执 continued、不抑制调用方同步回复:
380
+ // at-least-once 重投的去重出口——重复投递不重复执行也不重复回答(回答由
381
+ // 首次受理的那条路由负责),但也不冒充「已续接」误导调用方晚到回复闭包。
382
+ return {
383
+ status: 'accepted',
384
+ agentId: agent.agentId,
385
+ sessionId,
386
+ delivery: offerResult,
387
+ };
301
388
  }
302
389
  options?.onDelivery?.('run');
390
+ const finalize = (result) => this.finalizeDelivery(trigger, agent, result, options?.onEvent, options?.onDelivery);
303
391
  if (trigger.coalesceKey) {
304
392
  this.emitRuntime(RuntimeEvents.RUN_SCHEDULED, {
305
393
  triggerId: trigger.id,
@@ -315,11 +403,11 @@ export class AgentRuntime {
315
403
  onFlush: (triggers, onEvent) => this.executeTriggers(agent, triggers, sessionId, onEvent ?? options?.onEvent),
316
404
  });
317
405
  if (result.kind === 'no_key' || result.kind === 'buffer_full') {
318
- return this.executeTriggers(agent, [trigger], sessionId, options?.onEvent);
406
+ return finalize(await this.executeTriggers(agent, [trigger], sessionId, options?.onEvent));
319
407
  }
320
- return result.done;
408
+ return finalize(await result.done);
321
409
  }
322
- return this.executeTriggers(agent, [trigger], sessionId, options?.onEvent);
410
+ return finalize(await this.executeTriggers(agent, [trigger], sessionId, options?.onEvent));
323
411
  }
324
412
  async executeTriggers(agent, triggers, sessionId, onEvent) {
325
413
  if (!this.started) {
@@ -327,10 +415,21 @@ export class AgentRuntime {
327
415
  }
328
416
  // I6:schedule 点火以 timer 主体入审计(arch/session-schedules.md)
329
417
  const isScheduleWake = triggers.some((t) => t.type === 'schedule');
418
+ // Channel/user triggers carry their real sender as the Run principal so Hook
419
+ // audit attribution reflects who actually asked; host-internal triggers keep
420
+ // no actor rather than inventing one.
421
+ const senderId = isScheduleWake
422
+ ? undefined
423
+ : triggers
424
+ .map((t) => ('source' in t.payload ? t.payload.source?.senderId : undefined))
425
+ .find((id) => typeof id === 'string' && id.length > 0);
426
+ // §9.1-6:触发源租户(渠道锚等)随 Trigger 传播 → run principal 归属
427
+ const tenantId = triggers.map((t) => t.tenantId).find((id) => typeof id === 'string' && id.length > 0);
330
428
  const request = buildRunRequest(agent, triggers, sessionId, {
331
- actorType: isScheduleWake ? 'timer' : undefined,
332
- actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : undefined,
429
+ actorType: isScheduleWake ? 'timer' : senderId ? 'user' : undefined,
430
+ actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : senderId,
333
431
  intent: isScheduleWake ? 'schedule_wake' : undefined,
432
+ ...(tenantId === undefined ? {} : { tenantId }),
334
433
  });
335
434
  const controller = new AbortController();
336
435
  const run = {
@@ -5,6 +5,7 @@
5
5
  */
6
6
  import type { Message } from '@octopi-agent/core/types.js';
7
7
  import type { AgentEvent } from '@octopi-agent/core/primitives/event-bus.js';
8
+ import type { SessionRights } from '../governance/session-acl/types.js';
8
9
  export type TriggerType = 'message' | 'schedule' | 'event' | 'escalate' | 'agent_signal' | 'manual';
9
10
  export type TriggerPayload = {
10
11
  kind: 'user_message';
@@ -26,6 +27,8 @@ export interface Trigger {
26
27
  agentId?: string;
27
28
  toAgents?: string[];
28
29
  sessionId?: string;
30
+ /** 触发源归属租户(§9.1-6:渠道锚/租户会话创建方);合入 run principal,缺省锚 agent 归属 */
31
+ tenantId?: string;
29
32
  /** 来源端时间戳;缺省用 dispatch 时刻 */
30
33
  timestamp?: number;
31
34
  payload: TriggerPayload;
@@ -75,6 +78,13 @@ export interface RunRequest {
75
78
  modelOverride?: string;
76
79
  /** modelOverride 为裸名时的 provider */
77
80
  modelProvider?: string;
81
+ /**
82
+ * per-run systemPrompt 覆盖(委派子 run:模板 persona + 编排指令,delegation §9.4)。
83
+ * 显式值覆盖挂载默认;缺省沿用挂载体 defaults。
84
+ */
85
+ systemPrompt?: string;
86
+ /** per-run 权利天花板(D3:只能收紧不能放宽;Runner 与模板天花板取交集) */
87
+ rightsCeiling?: SessionRights;
78
88
  /** Principal / Intent 字段位(宪法 I6);宿主填充,引擎不做权限 NLU */
79
89
  actorId?: string;
80
90
  actorType?: 'host' | 'user' | 'agent' | 'service' | 'timer' | 'subsystem';
@@ -97,7 +107,8 @@ export interface RunDispatcher {
97
107
  execute(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
98
108
  /** 可选:活跃 Run 接续;缺省保持原 Trigger 排队语义。 */
99
109
  inbox?: {
100
- offer(signal: import('./inbox.js').SessionInboxSignal): import('./inbox.js').InboxOfferResult;
110
+ /** 本地 SessionInbox 同步返回;跨进程代理返回 Promise(远程 inboxOffer op)。 */
111
+ offer(signal: import('./inbox.js').SessionInboxSignal): import('./inbox.js').InboxOfferResult | Promise<import('./inbox.js').InboxOfferResult>;
101
112
  };
102
113
  }
103
114
  /** dispatch 调用方选项 */
@@ -105,7 +116,7 @@ export interface DispatchOptions {
105
116
  /** Run 事件流转发(频道回复捕获等);不变量 #6 */
106
117
  onEvent?: (event: AgentEvent) => void;
107
118
  /** 活跃 Run 接收即回执(早于 Run 结束);run = 走新 Run。 */
108
- onDelivery?: (delivery: 'steered' | 'run') => void;
119
+ onDelivery?: (delivery: 'continued' | 'run') => void;
109
120
  }
110
121
  export interface RouteTarget {
111
122
  agentId: string;
@@ -143,13 +154,19 @@ export type DispatchResult = {
143
154
  status: 'accepted';
144
155
  agentId: string;
145
156
  sessionId: string;
146
- delivery: 'steered';
157
+ /**
158
+ * continued = 活跃 Run 接收续接;duplicate = 同 id 已受理/已入上下文
159
+ * (at-least-once 重投的去重出口),不重复执行、不重复回答。
160
+ */
161
+ delivery: 'continued' | 'duplicate';
147
162
  } | {
148
163
  status: 'skipped';
149
164
  reason: 'no_agent' | 'filtered' | 'runtime_stopped' | 'aborted';
150
165
  } | {
151
166
  status: 'failed';
152
167
  error: string;
168
+ /** lease_held 延迟重投已排程:本次拒可见,回答稍后经随行 onEvent 补达 */
169
+ retryScheduled?: boolean;
153
170
  };
154
171
  /** fan-out 聚合结果(toAgents 长度 > 1 时由 dispatch 返回) */
155
172
  export type FanoutDispatchResult = {
@@ -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[];
@@ -138,6 +139,14 @@ export interface AgentBuildResult {
138
139
  registerTools: (tools: RegisteredTool[]) => void;
139
140
  /** ContextEngine 实例(手动压缩入口) */
140
141
  contextEngine?: import('../context/types.js').ContextEngine;
142
+ /**
143
+ * 脉搏注册表(P0c A′):本 agent 声明的全部周期任务(key 已带 agentId 前缀、实例内唯一)。
144
+ * run 宿主聚合为实例级 PulseSpec 自述给 gateway 脉搏调度器;fire 为进程内驱动入口。
145
+ */
146
+ pulses: Array<{
147
+ spec: import('../activation/run-protocol.js').PulseSpec;
148
+ fire: () => Promise<unknown>;
149
+ }>;
141
150
  contextHealth: (agentId?: string) => Promise<import('../context/layer-health.js').ContextLayerHealth>;
142
151
  }
143
152
  /** 缺省子系统搜索并加载 spec(供 build 自动发现与 serve 启动日志共用) */
@@ -158,7 +167,9 @@ export declare class AgentBuilder {
158
167
  private _toolBus;
159
168
  private _contextEngine?;
160
169
  private _summarize?;
161
- /** 最新的 context 压力信息(由 convertToLlm 更新) */
170
+ /** 按 session 键控的 context 压力(由 convertToLlm 更新;共享 Agent 下并发会话不串号) */
171
+ private _contextPressureBySession;
172
+ /** 兜底:无 sessionId 的调用方(仅 advisory 用途;并发下可能串号,不得用于持久化) */
162
173
  private _lastContextPressure?;
163
174
  /** 为 true 时禁止自动挂默认 summarize(测试/特殊场景) */
164
175
  private _disableAutoSummarize;
@@ -179,6 +190,8 @@ export declare class AgentBuilder {
179
190
  private _systemPrompt?;
180
191
  /** Skill 目录(SKILL.md);build 时 discover 并注入 system prompt 索引 */
181
192
  private _skillDirectory?;
193
+ /** Skill id allowlist(agents[].skills);未设置 = 全部启用 */
194
+ private _skillAllowlist?;
182
195
  private _skillManager?;
183
196
  /** 记忆检索(注入 system prompt MemoryLayer) */
184
197
  private _memoryStore?;
@@ -198,7 +211,7 @@ export declare class AgentBuilder {
198
211
  private _knowledgeGrounding?;
199
212
  /** 智慧(注入 system prompt WisdomLayer) */
200
213
  private _wisdomStore?;
201
- /** Wisdom 注入策略(wisdom.injection:core/scenario 上限 + trialVisible) */
214
+ /** Wisdom 注入策略(wisdom.injection:core/scenario/trial 上限 + trialVisible) */
202
215
  private _wisdomInjection?;
203
216
  /** 认知图谱(注入 system prompt CognitionLayer) */
204
217
  private _cognitionStore?;
@@ -240,6 +253,10 @@ export declare class AgentBuilder {
240
253
  private _agentHome?;
241
254
  /** 逻辑 agentId(观测 / 子系统审计用) */
242
255
  private _agentId?;
256
+ /** 归属租户(arch/multi-tenancy.md §4):audit 打标 / 家当派生域;缺省 = DEFAULT_TENANT_ID 语义 */
257
+ private _tenantId?;
258
+ /** Deferred until build so .pluginTools() and .agentId() order is immaterial. */
259
+ private _pluginToolRecords;
243
260
  /** 设置模型提供者 */
244
261
  model(provider: ModelProvider): this;
245
262
  model(name: string): this;
@@ -249,6 +266,11 @@ export declare class AgentBuilder {
249
266
  * 覆盖注册(显式)。用于热更新/替换同名工具,不可默默发生。
250
267
  */
251
268
  toolReplace(tool: RegisteredTool): this;
269
+ /**
270
+ * Mount host-owned plugin contributions into this Agent's ToolBus projection.
271
+ * Authorization is applied by ToolBus/RunScope; mounting is not Tool exposure.
272
+ */
273
+ pluginTools(records: readonly import('../extension/plugin-ecosystem/plugins/contribution-registry.js').PluginToolRecord[]): this;
252
274
  /** 批量注册:逐个 try/catch,避免一个工具失败拖垮整表 */
253
275
  tools(...tools: RegisteredTool[]): this;
254
276
  private _contextProvider;
@@ -309,6 +331,14 @@ export declare class AgentBuilder {
309
331
  * `~` 形态在此展开(与 workspace / agentHome 同规,幂等)。
310
332
  */
311
333
  skillDirectory(dir: string): this;
334
+ /**
335
+ * Skill 启用清单(agents[].skills):discover 只保留列出的 skill id。
336
+ * 不调用或传 undefined = 目录内全部启用。
337
+ *
338
+ * @param ids - 允许的 skill id 列表(SKILL.md 目录名)
339
+ * @returns this
340
+ */
341
+ skillAllowlist(ids: string[] | undefined): this;
312
342
  /** 直接注入 SkillManager(跳过目录 discover) */
313
343
  skills(manager: import('../extension/plugin-ecosystem/skills/types.js').SkillManager): this;
314
344
  /** 注入 MemoryStore(每轮按 query 召回进 system prompt) */
@@ -360,6 +390,7 @@ export declare class AgentBuilder {
360
390
  wisdomInjection(cfg: {
361
391
  coreMaxItems?: number;
362
392
  scenarioMaxItems?: number;
393
+ trialMaxItems?: number;
363
394
  trialVisible?: boolean;
364
395
  }): this;
365
396
  /** 注入 ConceptGraphStore(spreadingActivate 召回概念子图,进 system prompt CognitionLayer) */
@@ -453,6 +484,8 @@ export declare class AgentBuilder {
453
484
  agentHome(dir: string): this;
454
485
  /** 逻辑 agentId(extract pending 扫描 / 观测) */
455
486
  agentId(id: string): this;
487
+ /** 归属租户(audit 打标 / 家当派生域;arch/multi-tenancy.md §4) */
488
+ tenantId(id: string): this;
456
489
  /** 直接设置 systemPrompt(优先于 persona 目录) */
457
490
  systemPrompt(prompt: string): this;
458
491
  /** 设置 Session 存储 */