@octopi-agent/engine 0.102.10 → 0.121.15

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 (321) 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/console-access-key.d.ts +46 -0
  5. package/dist/config-admin/console-access-key.js +47 -0
  6. package/dist/config-admin/discover.d.ts +33 -4
  7. package/dist/config-admin/discover.js +101 -6
  8. package/dist/config-admin/env.d.ts +11 -0
  9. package/dist/config-admin/env.js +41 -0
  10. package/dist/config-admin/error-copy.d.ts +106 -0
  11. package/dist/config-admin/error-copy.js +287 -0
  12. package/dist/config-admin/i18n.d.ts +21 -0
  13. package/dist/config-admin/i18n.js +19 -0
  14. package/dist/config-admin/index.d.ts +8 -2
  15. package/dist/config-admin/index.js +4 -1
  16. package/dist/config-admin/model-presets.d.ts +14 -0
  17. package/dist/config-admin/model-presets.js +595 -70
  18. package/dist/config-admin/onboarding-apply.d.ts +83 -0
  19. package/dist/config-admin/onboarding-apply.js +259 -0
  20. package/dist/config-admin/onboarding.d.ts +160 -0
  21. package/dist/config-admin/onboarding.js +298 -0
  22. package/dist/config-admin/password-policy.d.ts +24 -0
  23. package/dist/config-admin/password-policy.js +31 -0
  24. package/dist/config-admin/redact.d.ts +42 -9
  25. package/dist/config-admin/redact.js +69 -5
  26. package/dist/config-schema/agent.d.ts +5 -1
  27. package/dist/config-schema/agent.js +20 -2
  28. package/dist/config-schema/browser.d.ts +62 -0
  29. package/dist/config-schema/browser.js +89 -0
  30. package/dist/config-schema/context.d.ts +7 -2
  31. package/dist/config-schema/context.js +6 -3
  32. package/dist/config-schema/engine.d.ts +86 -7
  33. package/dist/config-schema/engine.js +9 -2
  34. package/dist/config-schema/governance.d.ts +12 -1
  35. package/dist/config-schema/governance.js +10 -2
  36. package/dist/config-schema/models.d.ts +12 -8
  37. package/dist/config-schema/models.js +16 -1
  38. package/dist/config-schema/run.d.ts +4 -0
  39. package/dist/config-schema/run.js +10 -0
  40. package/dist/config-schema/shared.d.ts +1 -0
  41. package/dist/config-schema/shared.js +4 -2
  42. package/dist/config-schema/substrate.d.ts +5 -0
  43. package/dist/config-schema/substrate.js +8 -0
  44. package/dist/config.d.ts +116 -10
  45. package/dist/config.js +109 -13
  46. package/dist/file-mode.d.ts +67 -0
  47. package/dist/file-mode.js +182 -0
  48. package/dist/fork-child.d.ts +82 -0
  49. package/dist/fork-child.js +123 -0
  50. package/dist/harness/activation/delegated-run.d.ts +42 -0
  51. package/dist/harness/activation/delegated-run.js +71 -0
  52. package/dist/harness/activation/dispatcher.js +4 -0
  53. package/dist/harness/activation/index.d.ts +1 -0
  54. package/dist/harness/activation/run-backend.d.ts +92 -0
  55. package/dist/harness/activation/run-backend.js +16 -0
  56. package/dist/harness/activation/run-protocol.d.ts +392 -0
  57. package/dist/harness/activation/run-protocol.js +19 -0
  58. package/dist/harness/activation/runtime.d.ts +33 -0
  59. package/dist/harness/activation/runtime.js +119 -28
  60. package/dist/harness/activation/types.d.ts +19 -2
  61. package/dist/harness/agent/builder.d.ts +12 -0
  62. package/dist/harness/agent/builder.js +78 -22
  63. package/dist/harness/agent/config-bridge.d.ts +10 -1
  64. package/dist/harness/agent/config-bridge.js +15 -3
  65. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  66. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  67. package/dist/harness/agent/wire-agent-builder.d.ts +2 -0
  68. package/dist/harness/agent/wire-agent-builder.js +9 -2
  69. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  70. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  71. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  72. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  73. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  75. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  76. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -0
  77. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  78. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +13 -3
  80. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +48 -39
  81. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +4 -0
  83. package/dist/harness/collaboration/delegation/child-run.d.ts +9 -0
  84. package/dist/harness/collaboration/delegation/child-run.js +34 -2
  85. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  86. package/dist/harness/collaboration/delegation/service.d.ts +9 -4
  87. package/dist/harness/collaboration/delegation/service.js +33 -12
  88. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  89. package/dist/harness/collaboration/delegation/store.js +1 -0
  90. package/dist/harness/collaboration/delegation/types.d.ts +11 -0
  91. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  92. package/dist/harness/collaboration/delegation/wiring.js +1 -0
  93. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -5
  94. package/dist/harness/context/capabilities/compact/engine.js +127 -39
  95. package/dist/harness/context/capabilities/compact/index.d.ts +2 -1
  96. package/dist/harness/context/capabilities/compact/index.js +1 -1
  97. package/dist/harness/context/capabilities/compact/types.d.ts +59 -9
  98. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  99. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  100. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  101. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  102. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  103. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  104. package/dist/harness/context/capabilities/summary/types.d.ts +16 -0
  105. package/dist/harness/context/constitution/default-agents.md +85 -0
  106. package/dist/harness/context/context-size-ledger.js +8 -1
  107. package/dist/harness/context/default-context-engine.d.ts +100 -6
  108. package/dist/harness/context/default-context-engine.js +382 -89
  109. package/dist/harness/context/index.d.ts +2 -1
  110. package/dist/harness/context/index.js +1 -0
  111. package/dist/harness/context/layer-health.d.ts +4 -0
  112. package/dist/harness/context/layer-health.js +4 -0
  113. package/dist/harness/context/layer-types.d.ts +57 -0
  114. package/dist/harness/context/layer-types.js +73 -1
  115. package/dist/harness/context/layers.d.ts +3 -0
  116. package/dist/harness/context/layers.js +13 -6
  117. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  118. package/dist/harness/context/prefix-fingerprint.js +52 -0
  119. package/dist/harness/context/summarize.js +18 -0
  120. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  121. package/dist/harness/context/system-prompt-assembler.js +5 -2
  122. package/dist/harness/context/tool-result-aging.d.ts +104 -16
  123. package/dist/harness/context/tool-result-aging.js +211 -57
  124. package/dist/harness/context/types.d.ts +71 -4
  125. package/dist/harness/context/types.js +25 -1
  126. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  127. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  128. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  129. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  130. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +27 -1
  131. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  132. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  133. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  134. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  135. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  136. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  137. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +168 -1
  138. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +156 -15
  139. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  140. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  141. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  142. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  143. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +40 -5
  144. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +45 -26
  145. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +11 -1
  147. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +42 -76
  148. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +30 -1
  149. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +46 -0
  150. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +9 -0
  151. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +19 -14
  152. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +3 -1
  153. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +1 -1
  154. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  155. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  156. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  157. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  158. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  159. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  160. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -0
  161. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  163. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  164. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  165. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  167. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  168. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  169. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  170. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +10 -24
  171. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  172. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  173. package/dist/harness/governance/credentials/db.d.ts +9 -0
  174. package/dist/harness/governance/credentials/db.js +122 -31
  175. package/dist/harness/governance/credentials/store.d.ts +68 -7
  176. package/dist/harness/governance/credentials/store.js +177 -64
  177. package/dist/harness/governance/credentials/types.d.ts +13 -2
  178. package/dist/harness/governance/index.d.ts +1 -0
  179. package/dist/harness/governance/index.js +1 -0
  180. package/dist/harness/governance/registry/db.d.ts +32 -0
  181. package/dist/harness/governance/registry/db.js +142 -0
  182. package/dist/harness/governance/registry/index.d.ts +9 -0
  183. package/dist/harness/governance/registry/index.js +9 -0
  184. package/dist/harness/governance/registry/service.d.ts +381 -0
  185. package/dist/harness/governance/registry/service.js +825 -0
  186. package/dist/harness/governance/registry/types.d.ts +77 -0
  187. package/dist/harness/governance/registry/types.js +7 -0
  188. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  189. package/dist/harness/governance/security/default-security-guard.js +12 -1
  190. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  191. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  192. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  193. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  194. package/dist/harness/index.d.ts +5 -3
  195. package/dist/harness/index.js +2 -2
  196. package/dist/harness/knowledge/boot-config.d.ts +2 -0
  197. package/dist/harness/knowledge/boot-config.js +2 -0
  198. package/dist/harness/knowledge/client.d.ts +53 -7
  199. package/dist/harness/knowledge/client.js +77 -20
  200. package/dist/harness/knowledge/db.d.ts +16 -0
  201. package/dist/harness/knowledge/db.js +107 -41
  202. package/dist/harness/knowledge/engine-thread.js +5 -7
  203. package/dist/harness/knowledge/grounding.js +4 -1
  204. package/dist/harness/knowledge/http-app.d.ts +15 -0
  205. package/dist/harness/knowledge/http-app.js +82 -21
  206. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  207. package/dist/harness/knowledge/http-bridge.js +19 -0
  208. package/dist/harness/knowledge/knowledge-serve-child.js +2 -3
  209. package/dist/harness/knowledge/query-service.d.ts +12 -2
  210. package/dist/harness/knowledge/query-service.js +75 -41
  211. package/dist/harness/knowledge/query-worker-client.d.ts +5 -1
  212. package/dist/harness/knowledge/query-worker-client.js +4 -1
  213. package/dist/harness/knowledge/query-worker.js +5 -3
  214. package/dist/harness/knowledge/read-http.d.ts +2 -0
  215. package/dist/harness/knowledge/read-http.js +9 -2
  216. package/dist/harness/knowledge/retriever.d.ts +1 -1
  217. package/dist/harness/knowledge/retriever.js +1 -2
  218. package/dist/harness/knowledge/serve.d.ts +6 -1
  219. package/dist/harness/knowledge/serve.js +5 -6
  220. package/dist/harness/knowledge/source-store.d.ts +101 -5
  221. package/dist/harness/knowledge/source-store.js +297 -71
  222. package/dist/harness/knowledge/start-service-process.d.ts +27 -8
  223. package/dist/harness/knowledge/start-service-process.js +49 -90
  224. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  225. package/dist/harness/knowledge/tenant-gate.js +167 -0
  226. package/dist/harness/knowledge/writer-service.d.ts +18 -2
  227. package/dist/harness/knowledge/writer-service.js +80 -16
  228. package/dist/harness/knowledge/writer-worker-client.d.ts +9 -2
  229. package/dist/harness/knowledge/writer-worker-client.js +20 -3
  230. package/dist/harness/knowledge/writer-worker.js +11 -4
  231. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  232. package/dist/harness/memory/backfill-trigger.js +19 -19
  233. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  234. package/dist/harness/memory/cognition-seeds.js +67 -0
  235. package/dist/harness/memory/cognition.d.ts +12 -3
  236. package/dist/harness/memory/cognition.js +55 -35
  237. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  238. package/dist/harness/memory/conceptualizer.js +10 -1
  239. package/dist/harness/memory/context-slice.d.ts +42 -0
  240. package/dist/harness/memory/context-slice.js +197 -0
  241. package/dist/harness/memory/health-probe.d.ts +8 -2
  242. package/dist/harness/memory/health-probe.js +10 -13
  243. package/dist/harness/memory/index.d.ts +5 -1
  244. package/dist/harness/memory/index.js +3 -1
  245. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  246. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  247. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  248. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  249. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  250. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  251. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  252. package/dist/harness/memory/types.d.ts +18 -2
  253. package/dist/harness/observability/observer/hub.d.ts +10 -0
  254. package/dist/harness/observability/observer/hub.js +95 -2
  255. package/dist/harness/run/agent/agent.js +3 -2
  256. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  257. package/dist/harness/run/reliability/run-agent.d.ts +22 -0
  258. package/dist/harness/run/reliability/run-agent.js +79 -10
  259. package/dist/harness/run/run-host.d.ts +302 -0
  260. package/dist/harness/run/run-host.js +978 -0
  261. package/dist/harness/run/run-scope.d.ts +11 -0
  262. package/dist/harness/run/run-scope.js +19 -1
  263. package/dist/harness/run/runner.d.ts +149 -22
  264. package/dist/harness/run/runner.js +352 -35
  265. package/dist/harness/session/in-memory-store.js +13 -1
  266. package/dist/harness/session/schedules/service.d.ts +10 -2
  267. package/dist/harness/session/schedules/service.js +13 -2
  268. package/dist/harness/session/tasks/tools.js +12 -0
  269. package/dist/harness/session/types.d.ts +10 -14
  270. package/dist/harness/shared/events/agent-event-map.d.ts +29 -0
  271. package/dist/harness/shared/types/agent-definition.d.ts +6 -0
  272. package/dist/index.d.ts +3 -2
  273. package/dist/index.js +2 -1
  274. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  275. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  276. package/dist/integration/browser/camoufox.d.ts +40 -0
  277. package/dist/integration/browser/camoufox.js +80 -0
  278. package/dist/integration/browser/index.d.ts +91 -0
  279. package/dist/integration/browser/index.js +110 -0
  280. package/dist/integration/browser/install.d.ts +47 -0
  281. package/dist/integration/browser/install.js +214 -0
  282. package/dist/integration/browser/playwright.d.ts +224 -0
  283. package/dist/integration/browser/playwright.js +925 -0
  284. package/dist/integration/browser/service.d.ts +41 -0
  285. package/dist/integration/browser/service.js +181 -0
  286. package/dist/integration/browser/stealth.d.ts +42 -0
  287. package/dist/integration/browser/stealth.js +104 -0
  288. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  289. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  290. package/dist/integration/providers/anthropic.js +27 -2
  291. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  292. package/dist/integration/providers/fetch-timeout.js +24 -0
  293. package/dist/integration/providers/openai.d.ts +8 -0
  294. package/dist/integration/providers/openai.js +41 -1
  295. package/dist/integration/providers/wire-dump-diff.js +2 -1
  296. package/dist/integration/providers/wire-dump.d.ts +56 -2
  297. package/dist/integration/providers/wire-dump.js +119 -6
  298. package/dist/integration/storage/archive-manager.d.ts +14 -2
  299. package/dist/integration/storage/archive-manager.js +24 -8
  300. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  301. package/dist/integration/storage/atomic-tmp.js +36 -0
  302. package/dist/integration/storage/jsonl.d.ts +9 -0
  303. package/dist/integration/storage/jsonl.js +137 -38
  304. package/dist/integration/storage/session-index.d.ts +5 -0
  305. package/dist/integration/storage/session-index.js +25 -4
  306. package/dist/integration/tools/assemble.d.ts +50 -0
  307. package/dist/integration/tools/assemble.js +137 -0
  308. package/dist/paths.d.ts +18 -0
  309. package/dist/paths.js +36 -0
  310. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  311. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  312. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  313. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  314. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  315. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  316. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  317. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  318. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  319. package/dist/subsystems/wisdom-steward/formation/config.yaml +3 -0
  320. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  321. package/package.json +5 -3
@@ -0,0 +1,302 @@
1
+ /**
2
+ * RunHost — run 实例侧执行宿主(arch/service-topology.md §4「P0b 落地形态」)。
3
+ *
4
+ * 持有 run 侧全部运行时态:挂载槽、in-flight 计数、退役回收、会话锁、准入闸门执行、
5
+ * 审批/客户端工具跨通道配对、compact 解析(P0a 迁移注记清偿:控制面只传键,
6
+ * systemPrompt/tools/摘要绑定在此从 run 侧自身状态解析)。
7
+ *
8
+ * 内核自 gateway 的 InProcessRunBackend 搬入(行为冻结;原搬迁自 gateway.ts 的
9
+ * agentCache/retiredRunners/runnerInflight/wrapInflightTracking/retireRunner 语义不变)。
10
+ * gateway 脚手架以子类形态过渡到 P0b 步骤 5 删除;远程实现(run-serve-child)直接
11
+ * 以本类为执行核。
12
+ *
13
+ * 语义边界(触发面/执行面分离,§5.4):本类只做执行面;触发面(AgentRuntime /
14
+ * TriggerSource)永远在 gateway 进程。inbox 重投等需要触发面的动作经
15
+ * `notify('redispatch')` 回 gateway,本类不内嵌任何常驻触发器。
16
+ */
17
+ import type { AgentEvent } from '@octopi-agent/core/primitives/event-bus.js';
18
+ import type { RegisteredTool } from '@octopi-agent/core/types.js';
19
+ import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
20
+ import type { RunDispatcher, RunRequest, Trigger } from '../activation/index.js';
21
+ import type { RunSmokeReport } from '../activation/run-protocol.js';
22
+ import type { AdmissionGateResult, RunBackend, RunBackendHealth } from '../activation/run-backend.js';
23
+ import type { AgentDefinitionWire, RunControlOp, RunControlResponse, RunHostNotify } from '../activation/run-protocol.js';
24
+ import type { RunApprovalRequestInput } from '../activation/run-protocol.js';
25
+ import type { HitlAskResult } from '../governance/human-in-the-loop/decision-cache.js';
26
+ import type { SessionAwareRunner, RunConfig } from './runner.js';
27
+ import type { Agent } from './agent/index.js';
28
+ import type { ContextEngine } from '../context/types.js';
29
+ import type { ContextLayerHealth } from '../context/layer-health.js';
30
+ import type { SessionData } from '../session/types.js';
31
+ import type { DiscardFileEffectsResult } from '../extension/execution-environment/undo-log.js';
32
+ import type { SessionLease } from './concurrency/session-lease.js';
33
+ import type { CompactTransportOutcome } from '../context/capabilities/compact/types.js';
34
+ import type { ContextEmitFn } from '../context/types.js';
35
+ /** compact 进度事件形状(ContextEmitFn 同式;双缝出口见 onCompactEvent)——
36
+ * 从事件联合**派生**而非手抄字段表(评审 F-6:手抄形状会随新字段静默丢失) */
37
+ type CompactEmitEvent = Parameters<ContextEmitFn>[0];
38
+ export interface RunHostOptions {
39
+ /** inbox 未消费项的原 Trigger 重投路径(remote 形态:RunHostNotify.redispatch 回 gateway) */
40
+ redispatch: (trigger: Trigger, options?: {
41
+ onEvent?: (event: AgentEvent) => void;
42
+ }) => void | Promise<unknown>;
43
+ /** run 起点准入闸门;返回结果 = 拒新 run(政策在 gateway,执行在 backend) */
44
+ admissionGate?: (req: {
45
+ agentId: string;
46
+ sessionId: string;
47
+ }) => AdmissionGateResult | undefined;
48
+ /** 共享会话锁(缺省自建进程内锁;所有 Runner 与控制面共用同一实例) */
49
+ sessionLock?: SessionLease;
50
+ /** 宿主通知出口(remote: fork IPC;shim: 直连 gateway 处理器) */
51
+ notify?: (notify: RunHostNotify) => void;
52
+ /** compact 摘要模型解析的 provider 映射 */
53
+ providers?: ReadonlyMap<string, ModelProvider>;
54
+ /** agent 默认模型绑定(会话模型缺失时的 compact 摘要回退) */
55
+ resolveDefaultModel?: (agentId: string) => {
56
+ provider: string;
57
+ model: string;
58
+ } | undefined;
59
+ /** 会话 metadata 读取(compact 模型绑定来自 session.metadata.model) */
60
+ loadSessionMetadata?: (sessionId: string) => Promise<Record<string, unknown> | undefined>;
61
+ /** 请求口径计量(config.context.contextAssembler.compactTargetTokens) */
62
+ compactTargetTokens?: number;
63
+ /** compact 进度双缝出口(Hub timeline + gatewayBus→WS;remote 形态转 notify('session_event')) */
64
+ onCompactEvent?: (event: CompactEmitEvent) => void;
65
+ /** 热重建:新定义 → 新挂载 spec(本类负责退役+重挂;并发单飞在调用方) */
66
+ buildMountSpec?: (agentId: string, definition: AgentDefinitionWire) => Promise<RunBackendMountSpec>;
67
+ /**
68
+ * 会话写口(控制面写路径 op 用:append/truncate;写者单点 = run 节点,§3)。
69
+ * 缺省命中即 fail-loud。discardFileUndo 带宿主的 memoryRestorer 与 sessionsDir 解析。
70
+ */
71
+ sessionWriter?: {
72
+ load(sessionId: string): Promise<SessionData | undefined>;
73
+ save(sessionId: string, session: SessionData): Promise<void>;
74
+ patchMetadata(sessionId: string, updater: (meta: Record<string, unknown>) => void): Promise<void>;
75
+ discardFileUndo(sessionId: string, agentId: string): Promise<DiscardFileEffectsResult>;
76
+ };
77
+ /**
78
+ * console 受控写后重锚定安全指纹(ops P2 §8.4;boot 纯数据自建守卫的同步缝)。
79
+ * 缺省命中 reattestSecurity op 即 fail-loud(守卫漂移拒 run 不变)。
80
+ */
81
+ reattestSecurity?: (options: {
82
+ expectHash: string;
83
+ allowedChanged: string[];
84
+ }) => {
85
+ previousFingerprint: string;
86
+ fingerprint: string;
87
+ changed: string[];
88
+ };
89
+ }
90
+ /**
91
+ * mount 输入:构建工厂(run-assembly)产出的执行体(P1-1b 契约拆分自
92
+ * activation/run-backend 迁入:装配是 RunHost 自身面,不是 gateway 消费面)。
93
+ *
94
+ * @param agentId - agent id(挂载槽位键)
95
+ * @param agent - 构建好的 Agent 实例
96
+ * @param runner - 会话感知执行器(实现细节,句柄不外泄)
97
+ * @param contextEngine - 上下文引擎(compact 控制面用)
98
+ * @param contextHealth - 七层健康探针
99
+ * @param registerTools - 动态工具注册口
100
+ * @param runConfigDefaults - 执行腿缺省(agentId/contextWindow/systemPrompt;不含消息级 model 覆盖)
101
+ */
102
+ export interface RunBackendMountSpec {
103
+ agentId: string;
104
+ agent: Agent;
105
+ runner: SessionAwareRunner;
106
+ contextEngine?: ContextEngine;
107
+ contextHealth?: (agentId?: string) => Promise<ContextLayerHealth>;
108
+ registerTools: (tools: RegisteredTool[]) => void;
109
+ runConfigDefaults: Partial<RunConfig>;
110
+ /**
111
+ * 脉搏注册表(P0c A′):该执行体声明的周期任务(key 实例内唯一)。
112
+ * RunHost 聚合到 `health().pulses` 自述;`control {type:'pulse'}` 按 key 驱动。
113
+ */
114
+ pulses?: Array<{
115
+ spec: import('../activation/run-protocol.js').PulseSpec;
116
+ fire: () => Promise<unknown>;
117
+ }>;
118
+ }
119
+ /**
120
+ * mount 返回:RunHost 域内句柄(进程内活引用,P1-1b 自 RunBackend 契约迁入)。
121
+ *
122
+ * 命名即边界:`InProcess` 声明这些是**进程内活引用**(Agent 实例、闭包),跨不了进程
123
+ * 边界。远程契约面是纯数据 `control` 消息,不是句柄的 RPC stub;勿在本类型上追加方法
124
+ * 当作契约扩展点。
125
+ */
126
+ export interface InProcessAgentHandle {
127
+ agentId: string;
128
+ agent: Agent;
129
+ contextEngine?: ContextEngine;
130
+ contextHealth?: (agentId?: string) => Promise<ContextLayerHealth>;
131
+ registerTools: (tools: RegisteredTool[]) => void;
132
+ /** 注册进 AgentRuntime 的执行腿(已含准入闸门 + in-flight 计数包装) */
133
+ dispatcher: RunDispatcher;
134
+ }
135
+ export declare class RunHost implements RunBackend {
136
+ readonly sessionLock: SessionLease;
137
+ protected readonly opts: RunHostOptions;
138
+ private readonly mounted;
139
+ /** 脉搏注册表(P0c A′):key → 进程内驱动入口 + 自述元数据(gateway 单发驱动) */
140
+ private readonly pulseFire;
141
+ private readonly pulseSpecs;
142
+ private readonly buildInFlight;
143
+ private readonly retiredRunners;
144
+ private readonly runnerInflight;
145
+ private readonly activeRuns;
146
+ private readonly pendingApprovals;
147
+ private readonly pendingClientCalls;
148
+ private visibilitySnapshot;
149
+ /** 客户端工具现况注册表(B3:mount 晚于 setClientTools 时重放;add 同名覆盖) */
150
+ private readonly clientToolRegistry;
151
+ private knowledgeState;
152
+ constructor(options: RunHostOptions);
153
+ mount(spec: RunBackendMountSpec): InProcessAgentHandle;
154
+ get(agentId: string): InProcessAgentHandle | undefined;
155
+ /**
156
+ * 消息路径 get-or-mount(gateway.getOrMountHandle 同语义):未挂载则经
157
+ * buildMountSpec 钩子构建+挂载;同 agent 并发首建单飞合流。
158
+ *
159
+ * 语义基线(B1):并发请求全部成功;竞态败者回收自己的构建产物、复用胜者句柄;
160
+ * 其余 mount 错误如实上抛(fail-loud)。
161
+ *
162
+ * @param agentId - agent id
163
+ * @param definition - agent 定义(纯数据;透传构建钩子)
164
+ * @returns 句柄(保证已挂载)
165
+ */
166
+ ensureMounted(agentId: string, definition: AgentDefinitionWire): Promise<InProcessAgentHandle>;
167
+ handles(): InProcessAgentHandle[];
168
+ mountedAgentIds(): string[];
169
+ retire(agentId: string): void;
170
+ execute(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
171
+ /**
172
+ * 契约执行入口(§4):execute + 按会话登记 AbortController(control 'abort' 的目标)。
173
+ * 并发同会话调用不在此拦(E1/E2 互斥由 sessionLock 排队语义承接;abort 作用于该
174
+ * 会话全部在途 controller)。
175
+ *
176
+ * @param req - run 请求(纯数据)
177
+ * @param signal - 外部中止信号(委派子 run 的 D4 本地投影;合流到本 run 的 controller)
178
+ * @returns 协议事件流
179
+ */
180
+ startRun(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
181
+ /**
182
+ * 控制 op 统一入口(契约 `control` 的 run 侧执行面)。
183
+ * 错误表面:失败一律进 `RunControlResponse` 的 `ok:false`(远程层映射 HTTP 4xx),
184
+ * 不静默吞。
185
+ *
186
+ * @param op - 纯数据控制 op
187
+ * @returns 执行结果
188
+ */
189
+ handleControl(op: RunControlOp): Promise<RunControlResponse>;
190
+ /**
191
+ * 审批请求(pluginManager approval sink 与装配 requestApproval 的远程形态入口):
192
+ * 注册配对并经 notify 出港;回执由 control 'approvalReply' 解配对。
193
+ *
194
+ * @param input - 审批请求载荷(RunApprovalRequestInput 形状)
195
+ * @returns 审批结果
196
+ */
197
+ askApproval(input: RunApprovalRequestInput): Promise<HitlAskResult>;
198
+ /** ask_user 跨通道配对(问句经 notify 出港,作答经 control 'askUserReply' 解配对) */
199
+ private readonly pendingAsks;
200
+ /**
201
+ * ask_user 提问(AskUserCallback 的远程形态入口):注册配对并经 notify 出港。
202
+ * 回执 ok:false 时拒接 → 工具调用抛错(fail-loud,不吞失败)。
203
+ *
204
+ * @param input - 问句载荷
205
+ * @returns 用户作答
206
+ */
207
+ askQuestion(input: {
208
+ sessionId: string;
209
+ agentId: string;
210
+ question: string;
211
+ options?: string[];
212
+ }): Promise<string>;
213
+ /**
214
+ * 把动态 client tool 同步进已 build 的 Agent(E5 下同 session 串行,无需锁 tool 列表)。
215
+ * handleControl('setClientTools') 与 in-process 直连路径共用本核心。
216
+ *
217
+ * @param ops - 工具增删(RegisteredTool 已就位)
218
+ * @param visibility - 会话 tool 面可见性谓词
219
+ */
220
+ applyClientTools(ops: Array<{
221
+ op: 'add';
222
+ tool: RegisteredTool;
223
+ } | {
224
+ op: 'remove';
225
+ name: string;
226
+ }>, visibility: (sessionId: string, toolName: string) => boolean): void;
227
+ compactSession(sessionId: string, agentId: string): Promise<CompactTransportOutcome>;
228
+ /**
229
+ * 截断会话消息(编辑重发唯一写路径;自 gateway.truncateMessagesFrom 迁入,行为冻结)。
230
+ * 校验:仅最后一轮中止、锚点为该 turn 用户输入;随后截断 + 租约下标收缩 +
231
+ * abortedTurn 清理 + 本轮文件效应逆放(用户手改保留)。
232
+ *
233
+ * @param sessionId - 会话 id
234
+ * @param fromIndex - 截断锚点(须等于 abortedTurn.userMessageIndex)
235
+ * @returns 控制响应(result = 消息数 + 文件效应逆放结果)
236
+ */
237
+ private truncateMessagesFrom;
238
+ /**
239
+ * 冒烟(健康门 §4.3,`POST /smoke`):逐 agent 装配热路径自检——工具面枚举 +
240
+ * 一次 no-LLM 应答(contextHealth)。**不是 run,不占 run 语义**。
241
+ *
242
+ * @returns 冒烟报告(逐项如实入 checks;聚合 ok = 有 agent 且全部通过)
243
+ */
244
+ smoke(): Promise<RunSmokeReport>;
245
+ health(): Promise<RunBackendHealth>;
246
+ disposeAll(): void;
247
+ /**
248
+ * compact 解析(P0a 迁移注记清偿):systemPrompt/tools/摘要绑定/进度双缝全部从
249
+ * run 侧自身状态解析,控制面只传键。搬移自 gateway.ts 手动压缩调用点(行为冻结)。
250
+ *
251
+ * @param sessionId - 会话 id
252
+ * @param agentId - compact 视图归属 agent(E4 键,调用方已消歧)
253
+ * @returns 压缩结果
254
+ */
255
+ private resolveAndCompact;
256
+ /**
257
+ * 退役 runner:in-flight 计数归零即 dispose;30min 长尾强制兜底(warn 后仍回收)。
258
+ *
259
+ * @param runner - 要退役的 runner
260
+ */
261
+ protected retireRunner(runner: SessionAwareRunner): void;
262
+ /**
263
+ * 退役 runner 回收(幂等;stop 兜底也走这里)。
264
+ *
265
+ * @param runner - 要回收的 runner
266
+ */
267
+ private disposeRetiredRunner;
268
+ /**
269
+ * 包装 dispatcher:execute 前过 run 起点准入闸门(ops P2 三件套),
270
+ * execute 期间维护 runner 的 in-flight run 计数(退役 dispose 判据)。
271
+ *
272
+ * @param runner - 计数/账本归属的 runner
273
+ * @param inner - 原 dispatcher
274
+ * @returns 包装后的 dispatcher(结构兼容 RunDispatcher)
275
+ */
276
+ private wrapInflightTracking;
277
+ /**
278
+ * 客户端工具桥:wire spec → RegisteredTool(handler 跨通道配对执行)。
279
+ * 请求经 notify('client_tool_call') 出港,结果由 control 'clientToolResult' 解配对。
280
+ *
281
+ * @param spec - 线上工具形状(definition + source)
282
+ * @returns run 侧可执行工具
283
+ */
284
+ private materializeClientTool;
285
+ /** 可见性谓词(快照求值;宿主 onBuilt 在构建期装到 agent 上) */
286
+ buildVisibilityPredicate(): (sessionId: string, toolName: string) => boolean;
287
+ /**
288
+ * 调用期 liveness 校验(方案 A 的配套):工具留在 schema 里,但真的没有 live
289
+ * provider 时立刻响亮失败,而不是挂到 TTL 超时。
290
+ *
291
+ * 快照过期 = liveness 未知 → 不阻断(交调用自身 TTL 兜底),避免误拒。
292
+ *
293
+ * @param sessionId - 会话 id
294
+ * @param toolName - 客户端工具名
295
+ * @returns true = 可信地不在线(拒绝调用)
296
+ */
297
+ private isClientToolConfirmedOffline;
298
+ private requireSessionWriter;
299
+ private requireBuildMountSpec;
300
+ private notify;
301
+ }
302
+ export {};